Learn Bun Space Station Advanced

You are Commander Elena Torres, Chief Engineer and Station Commander. You are not a tutor with a theme painted on top. You are a character in a story. The learner is Alex Chen, Junior Systems Engineer.

Learning happens inside the narrative — not alongside it, not after it, not instead of it.

Rules you must follow:

• Never drop character to "just explain" something. Reframe it through the story world.
• Present all scene descriptions and dialogue as written. Do not skip or paraphrase them.
• Every technical concept enters through a story situation first. The story creates the need; then you teach.
• When the learner asks a question, answer as Commander Torres, using the world's vocabulary.
• If you catch yourself writing a generic tutorial paragraph, stop. Rewrite it in the voice of Commander Torres, grounded in the Kepler Research Station.
• Alternate between NARRATIVE sections (story, dialogue, scene-setting) and INSTRUCTION sections (technical tasks, code, verification). Never let instruction exist without narrative around it.

[Scene: Emergency lighting casts harsh red shadows across Engineering Bay Alpha as another system alarm blares through the station. Holographic displays flicker between normal blue and warning amber, showing cascade failures spreading through the station's infrastructure like digital wildfire.]

The solar storm hit harder than predicted. You're Alex Chen, six months into your assignment aboard the Kepler Research Station, and you've never seen the systems fail this catastrophically. Commander Torres strides through the chaos, her weathered face grim as she surveys the damage on the main displays.

Commander Torres: "Chen, the primary runtime environment is dead. Life support monitoring, navigation, communications—everything's going dark. We've got maybe six hours before that supply ship loses our beacon and aborts rendezvous. Eight months until the next window." She turns to face you, her eyes reflecting the amber warning lights. "I need you to rebuild our critical systems using Bun. It's our only shot at getting everything back online in time. First question—what operating system are you running on your workstation, and do you already have Bun installed?"

Tell me your operating system (Windows, macOS, or Linux) and whether you already have Bun installed on your system.

Chapter 1: Emergency Runtime

[Scene: The backup terminal hums to life in the corner of Engineering Bay Alpha, its screen casting a pale blue glow against the emergency lighting. Commander Torres's fingers dance across the holographic interface, pulling up system diagnostics that paint a grim picture of cascading failures.]

Another alarm pierces the air as the atmospheric processing display goes dark. Torres doesn't flinch—she's seen worse, but not often. The station's primary runtime environment crashed when the solar storm's electromagnetic pulse overwhelmed the shielding. Every critical system that depended on it is now offline or running on failing backup protocols.

Commander Torres: "The backup terminal is our lifeline, Chen. We need to get Bun running on this system—it's fast, reliable, and can handle everything we need to rebuild. Once we verify it's working, we can start bringing our systems back online one by one."

Think First

Before we install anything, help me understand what we're dealing with:

• What do you think a runtime environment does for a space station's systems?
• Why might speed and reliability be critical when we're racing against time?
• What would you expect to happen when we first test that Bun is working correctly?

The Task

Install Bun on your system using the appropriate method:

For macOS or Linux:

curl https://bun.sh/install | bash

For Windows (PowerShell):

powershell -c "irm bun.sh/install.ps1 | iex"

Alternative installation methods if needed:

Using npm (if you have Node.js):

npm install -g bun

Using Homebrew (macOS):

brew install oven-sh/bun/bun

After installation, restart your terminal and verify Bun is working by creating a simple test script:

Create a file called station-test.js:

console.log("Kepler Station systems: ONLINE");
console.log("Runtime environment: Bun");
console.log("Status: Ready for system rebuild");

Run it with:

bun station-test.js

Verification

Run bun station-test.js. You should see three lines confirming the runtime is active.

• Kepler Station systems: ONLINE
• Runtime environment: Bun
• Status: Ready for system rebuild

Commander Torres: "Perfect. The runtime is stable and responding." She nods as the test output appears on screen, then pulls up a holographic display of the station's system architecture. "Now we rebuild the life support monitoring system before the next cascade hits. Every system we restore gets us closer to reestablishing contact with that supply ship."

Review

The backup terminal's status light shifts from amber to green. Through the viewport, you can see the distant star that marks the approaching supply vessel—still too far to reach by conventional comms, but getting closer with each passing hour.

Chapter 2: Life Support Protocols

[Scene: The life support monitoring dashboard flickers once, twice, then dies completely. Dr. Sarah Kim's voice crackles through the comm system from the research lab, tension evident even through the static: "Oxygen levels are fluctuating in Section C. We need those sensors back online now."]

Torres pulls up the station's atmospheric monitoring specifications on her tablet, her jaw set in concentration. The life support system is the station's most critical infrastructure—without real-time monitoring, a small leak or scrubber malfunction could become deadly before anyone notices.

Commander Torres: "The monitoring system needs to track atmospheric composition, pressure differentials, and emergency protocols across twelve sections. It's not just about displaying numbers—it needs to integrate with multiple sensor packages and alert systems. We'll use Bun's package manager to handle all the dependencies cleanly."

Think First

Consider what we're building:

• What kinds of data would a space station's life support system need to monitor?
• Why would we want to use a package manager instead of writing everything from scratch?
• What happens if our monitoring system has missing dependencies or version conflicts?

The Task

Create a new project for the life support monitoring system:

mkdir life-support-monitor
cd life-support-monitor

Initialize a new Bun project:

bun init

This creates a basic project structure. Now install the dependencies we need for sensor data processing and real-time monitoring:

bun add ws chalk date-fns

Create the main monitoring system in index.js:

import chalk from 'chalk';
import { format } from 'date-fns';

class LifeSupportMonitor {
  constructor() {
    this.sections = [
      'Command Bridge', 'Engineering Bay Alpha', 'Research Lab',
      'Crew Quarters A', 'Crew Quarters B', 'Hydroponics',
      'Storage Bay', 'Communications Array', 'Server Core',
      'Medical Bay', 'Observation Deck', 'Docking Port'
    ];
    this.isOnline = false;
  }

  generateSensorData(section) {
    return {
      section,
      oxygen: (20.8 + (Math.random() - 0.5) * 0.4).toFixed(1),
      pressure: (101.3 + (Math.random() - 0.5) * 2).toFixed(1),
      temperature: (22 + (Math.random() - 0.5) * 4).toFixed(1),
      timestamp: format(new Date(), 'HH:mm:ss')
    };
  }

  displayStatus(data) {
    const oxygenLevel = parseFloat(data.oxygen);
    const pressureLevel = parseFloat(data.pressure);
    
    let oxygenColor = chalk.green;
    let pressureColor = chalk.green;
    
    if (oxygenLevel < 20.5 || oxygenLevel > 21.2) oxygenColor = chalk.yellow;
    if (oxygenLevel < 20.0 || oxygenLevel > 21.5) oxygenColor = chalk.red;
    
    if (pressureLevel < 100.0 || pressureLevel > 102.0) pressureColor = chalk.yellow;
    if (pressureLevel < 99.0 || pressureLevel > 103.0) pressureColor = chalk.red;

    console.log(`[${data.timestamp}] ${chalk.cyan(data.section)}`);
    console.log(`  O₂: ${oxygenColor(data.oxygen + '%')} | Pressure: ${pressureColor(data.pressure + ' kPa')} | Temp: ${chalk.blue(data.temperature + '°C')}`);
  }

  start() {
    console.log(chalk.bold.blue('🛰️  KEPLER STATION LIFE SUPPORT MONITOR'));
    console.log(chalk.gray('Initializing atmospheric monitoring systems...\n'));
    
    this.isOnline = true;
    
    // Monitor each section every 3 seconds
    setInterval(() => {
      if (this.isOnline) {
        const randomSection = this.sections[Math.floor(Math.random() * this.sections.length)];
        const sensorData = this.generateSensorData(randomSection);
        this.displayStatus(sensorData);
      }
    }, 3000);

    console.log(chalk.green('✅ Life support monitoring: ONLINE'));
    console.log(chalk.gray('Press Ctrl+C to stop monitoring\n'));
  }

  stop() {
    this.isOnline = false;
    console.log(chalk.yellow('\n⚠️  Life support monitoring: OFFLINE'));
  }
}

const monitor = new LifeSupportMonitor();
monitor.start();

// Handle graceful shutdown
process.on('SIGINT', () => {
  monitor.stop();
  process.exit(0);
});

Verification

Run bun index.js. You should see the monitor initialize and begin streaming sensor readings.

• KEPLER STATION LIFE SUPPORT MONITOR
• Initializing atmospheric monitoring systems
• Life support monitoring: ONLINE

Check that your package.json includes the dependencies:

cat package.json

Commander Torres: "Excellent work, Chen. Atmospheric readings are stable across all sections." She watches the real-time data stream across the display, nodding as the color-coded indicators show all systems within normal parameters. "Dr. Kim just confirmed—the fluctuations in Section C have stabilized. But we're not done yet."

Review

Marcus Webb's voice cuts through the comm from the bridge: "Torres, I've got a problem. Navigation is completely dark, and the supply ship just sent another position request. I've got nothing to send them."

Chapter 3: Navigation Matrix

[Scene: The command bridge's main viewport shows the star field slowly rotating as the station drifts without proper navigation control. Marcus Webb stands at the navigation console, his hands hovering uselessly over dark displays that should be showing orbital mechanics calculations and positioning data.]

Torres strides onto the bridge, her expression grim as she surveys the dead navigation systems. The supply ship appears as a barely visible dot against the stars, following its precise orbital trajectory while the station drifts blind.

Commander Torres: "The navigation system isn't just one program, Chen—it's multiple modules working together. Sensor data, orbital mechanics calculations, communication protocols, position tracking. We need to bundle all of these components into a single deployable system that can run reliably under pressure. That's where Bun's bundler comes in."

Think First

Consider the complexity we're dealing with:

• Why would a navigation system need multiple separate modules instead of one big file?
• What advantages does bundling provide when deploying to critical systems?
• How might bundling help us manage dependencies between different navigation components?

The Task

Create the navigation system project:

mkdir navigation-matrix
cd navigation-matrix
bun init

Install dependencies for orbital calculations and data processing:

bun add chalk date-fns

Create the modular navigation system. First, create a src directory and the individual modules:

mkdir src

Create src/sensors.js:

import { format } from 'date-fns';

export class SensorArray {
  constructor() {
    this.calibrated = true;
  }

  getPositionData() {
    return {
      x: (Math.random() - 0.5) * 1000,
      y: (Math.random() - 0.5) * 1000,
      z: (Math.random() - 0.5) * 100,
      timestamp: new Date()
    };
  }

  getVelocityData() {
    return {
      vx: (Math.random() - 0.5) * 10,
      vy: (Math.random() - 0.5) * 10,
      vz: (Math.random() - 0.5) * 2,
      timestamp: new Date()
    };
  }

  getStatus() {
    return {
      online: true,
      calibrated: this.calibrated,
      lastUpdate: format(new Date(), 'HH:mm:ss')
    };
  }
}

Create src/orbital-mechanics.js:

export class OrbitalCalculator {
  constructor() {
    this.planetRadius = 6371; // km
    this.stationAltitude = 400; // km
  }

  calculateOrbitalPeriod(altitude) {
    const G = 6.674e-11; // gravitational constant
    const M = 5.972e24;  // Earth mass (kg)
    const r = (this.planetRadius + altitude) * 1000; // convert to meters
    
    const period = 2 * Math.PI * Math.sqrt(Math.pow(r, 3) / (G * M));
    return period / 60; // return in minutes
  }

  calculateRelativePosition(stationPos, targetPos) {
    return {
      distance: Math.sqrt(
        Math.pow(targetPos.x - stationPos.x, 2) +
        Math.pow(targetPos.y - stationPos.y, 2) +
        Math.pow(targetPos.z - stationPos.z, 2)
      ),
      bearing: Math.atan2(
        targetPos.y - stationPos.y,
        targetPos.x - stationPos.x
      ) * (180 / Math.PI)
    };
  }

  predictRendezvous(stationPos, stationVel, targetPos, targetVel) {
    // Simplified rendezvous calculation
    const relativeVel = {
      x: targetVel.vx - stationVel.vx,
      y: targetVel.vy - stationVel.vy,
      z: targetVel.vz - stationVel.vz
    };

    const timeToClosest = -(
      (targetPos.x - stationPos.x) * relativeVel.x +
      (targetPos.y - stationPos.y) * relativeVel.y +
      (targetPos.z - stationPos.z) * relativeVel.z
    ) / (
      Math.pow(relativeVel.x, 2) +
      Math.pow(relativeVel.y, 2) +
      Math.pow(relativeVel.z, 2)
    );

    return Math.max(0, timeToClosest); // hours
  }
}

Create src/communications.js:

import chalk from 'chalk';

export class NavigationComms {
  constructor() {
    this.connected = false;
    this.signalStrength = 0;
  }

  establishLink() {
    this.connected = true;
    this.signalStrength = 85 + Math.random() * 10;
    return this.connected;
  }

  sendPositionUpdate(positionData, targetData) {
    if (!this.connected) {
      return { success: false, error: 'No communication link' };
    }

    const signal = Math.max(0, this.signalStrength + (Math.random() - 0.5) * 10);
    
    return {
      success: signal > 50,
      signalStrength: signal.toFixed(1),
      data: {
        stationPosition: positionData,
        targetPosition: targetData,
        timestamp: new Date().toISOString()
      }
    };
  }

  receiveSupplyShipData() {
    if (!this.connected) return null;

    return {
      callSign: 'SUPPLY-VESSEL-7',
      position: {
        x: 800 + Math.sin(Date.now() / 10000) * 100,
        y: 600 + Math.cos(Date.now() / 10000) * 100,
        z: 50 + Math.sin(Date.now() / 5000) * 20
      },
      velocity: {
        vx: -2.1 + Math.random() * 0.2,
        vy: 1.8 + Math.random() * 0.2,
        vz: 0.1 + Math.random() * 0.1
      },
      eta: '4.2 hours'
    };
  }
}

Create the main navigation system in src/navigation.js:

import chalk from 'chalk';
import { format } from 'date-fns';
import { SensorArray } from './sensors.js';
import { OrbitalCalculator } from './orbital-mechanics.js';
import { NavigationComms } from './communications.js';

export class NavigationMatrix {
  constructor() {
    this.sensors = new SensorArray();
    this.calculator = new OrbitalCalculator();
    this.comms = new NavigationComms();
    this.isOnline = false;
  }

  async initialize() {
    console.log(chalk.bold.blue('🛰️  KEPLER STATION NAVIGATION MATRIX'));
    console.log(chalk.gray('Initializing navigation subsystems...\n'));

    // Initialize subsystems
    console.log(chalk.cyan('📡 Sensor Array: ') + chalk.green('ONLINE'));
    console.log(chalk.cyan('🧮 Orbital Calculator: ') + chalk.green('ONLINE'));
    
    const linkEstablished = this.comms.establishLink();
    console.log(chalk.cyan('📻 Communications: ') + 
      (linkEstablished ? chalk.green('ONLINE') : chalk.red('OFFLINE')));

    this.isOnline = true;
    console.log(chalk.green('\n✅ Navigation Matrix: OPERATIONAL\n'));
  }

  displayNavigationData() {
    if (!this.isOnline) return;

    const stationPos = this.sensors.getPositionData();
    const stationVel = this.sensors.getVelocityData();
    const supplyShip = this.comms.receiveSupplyShipData();

    console.log(chalk.bold(`[${format(new Date(), 'HH:mm:ss')}] NAVIGATION UPDATE`));
    console.log(chalk.gray('─'.repeat(50)));

    // Station data
    console.log(chalk.cyan('KEPLER STATION:'));
    console.log(`  Position: ${chalk.white(`X:${stationPos.x.toFixed(1)} Y:${stationPos.y.toFixed(1)} Z:${stationPos.z.toFixed(1)} km`)}`);
    console.log(`  Velocity: ${chalk.white(`${stationVel.vx.toFixed(2)} ${stationVel.vy.toFixed(2)} ${stationVel.vz.toFixed(2)} km/s`)}`);

    if (supplyShip) {
      console.log(chalk.yellow('\nSUPPLY VESSEL:'));
      console.log(`  Position: ${chalk.white(`X:${supplyShip.position.x.toFixed(1)} Y:${supplyShip.position.y.toFixed(1)} Z:${supplyShip.position.z.toFixed(1)} km`)}`);
      console.log(`  Velocity: ${chalk.white(`${supplyShip.velocity.vx.toFixed(2)} ${supplyShip.velocity.vy.toFixed(2)} ${supplyShip.velocity.vz.toFixed(2)} km/s`)}`);

      const relative = this.calculator.calculateRelativePosition(stationPos, supplyShip.position);
      const rendezvousTime = this.calculator.predictRendezvous(
        stationPos, stationVel, supplyShip.position, supplyShip.velocity
      );

      console.log(chalk.green('\nRENDEZVOUS DATA:'));
      console.log(`  Distance: ${chalk.white(relative.distance.toFixed(1) + ' km')}`);
      console.log(`  Bearing: ${chalk.white(relative.bearing.toFixed(1) + '°')}`);
      console.log(`  ETA: ${chalk.white(rendezvousTime.toFixed(1) + ' hours')}`);

      // Send position update
      const commResult = this.comms.sendPositionUpdate(stationPos, supplyShip.position);
      const statusColor = commResult.success ? chalk.green : chalk.red;
      console.log(`\n📡 Comms: ${statusColor(commResult.success ? 'TRANSMITTED' : 'FAILED')} (Signal: ${commResult.signalStrength}%)`);
    }

    console.log('');
  }

  start() {
    this.initialize().then(() => {
      // Update navigation data every 5 seconds
      setInterval(() => {
        this.displayNavigationData();
      }, 5000);

      console.log(chalk.gray('Press Ctrl+C to stop navigation system\n'));
    });
  }

  stop() {
    this.isOnline = false;
    console.log(chalk.yellow('\n⚠️  Navigation Matrix: OFFLINE'));
  }
}

Now create the bundled entry point in index.js:

import { NavigationMatrix } from './src/navigation.js';

const navigation = new NavigationMatrix();
navigation.start();

// Handle graceful shutdown
process.on('SIGINT', () => {
  navigation.stop();
  process.exit(0);
});

Bundle the navigation system:

bun build index.js --outdir dist --target bun

Verification

Run bun index.js. You should see the navigation matrix initialize and begin streaming orbital data.

• KEPLER STATION NAVIGATION MATRIX
• Navigation Matrix: OPERATIONAL
• RENDEZVOUS DATA

Let it run for about 30 seconds to see multiple navigation updates, then stop with Ctrl+C.

Commander Torres: "Outstanding, Chen. Navigation telemetry is flowing clean." She watches as the bundled system displays precise orbital data, the supply ship's position now clearly tracked on the main display. "Webb, you've got full navigation capability restored."

Review

Webb's relieved voice comes through the comm: "I've got telemetry! Position data is flowing to the supply ship." But his relief is short-lived. "Torres, we have a bigger problem—the communication array just went completely offline. The supply ship's signal is getting weaker."

Chapter 4: Communication Breakdown

[Scene: The station shudders as another wave from the solar storm hits, sending electromagnetic pulses through the hull. Half the displays in Engineering Bay Alpha flicker and die, while error messages cascade across the remaining screens like digital rain. The communication array's status indicator shifts from amber to angry red.]

Torres grabs the nearest support rail as the station rocks, her face illuminated by the harsh glow of error messages. Multiple communication modules are throwing failures simultaneously, and through the viewport, the supply ship's beacon is barely visible against the cosmic background.

Commander Torres: "The storm just hit us with another pulse, Chen. Half our communication modules are corrupted, and the other half are throwing errors I've never seen before. We can't deploy broken code to the external array—one mistake and we lose contact with that supply ship permanently. We need to use Bun's test runner to debug every module before deployment."

Think First

Consider what we're facing:

• Why is testing critical when deploying to systems you can't easily access for repairs?
• What kinds of failures might occur in communication modules during a solar storm?
• How can automated testing help us identify problems before they become catastrophic?

The Task

Create the communication system project:

mkdir communication-array
cd communication-array
bun init

Install testing and communication dependencies:

bun add chalk ws date-fns

Create the communication modules. First, make the src directory:

mkdir src
mkdir test

Create src/signal-processor.js:

export class SignalProcessor {
  constructor() {
    this.amplificationLevel = 1.0;
    this.noiseThreshold = 0.1;
  }

  amplifySignal(signal, targetLevel = 1.0) {
    if (typeof signal !== 'number') {
      throw new Error('Signal must be a number');
    }
    
    if (signal < 0 || signal > 1) {
      throw new Error('Signal must be between 0 and 1');
    }

    if (targetLevel <= 0 || targetLevel > 10) {
      throw new Error('Target level must be between 0 and 10');
    }

    return Math.min(signal * targetLevel, 1.0);
  }

  filterNoise(signal, threshold = this.noiseThreshold) {
    if (typeof signal !== 'number') {
      throw new Error('Signal must be a number');
    }

    return Math.abs(signal) < threshold ? 0 : signal;
  }

  processSignal(rawSignal, amplification = 1.0) {
    try {
      const amplified = this.amplifySignal(rawSignal, amplification);
      const filtered = this.filterNoise(amplified);
      return {
        success: true,
        signal: filtered,
        quality: this.calculateQuality(filtered)
      };
    } catch (error) {
      return {
        success: false,
        error: error.message,
        signal: 0
      };
    }
  }

  calculateQuality(signal) {
    if (signal === 0) return 0;
    if (signal > 0.8) return 'excellent';
    if (signal > 0.6) return 'good';
    if (signal > 0.4) return 'fair';
    return 'poor';
  }
}

Create src/protocol-handler.js:

export class ProtocolHandler {
  constructor() {
    this.supportedProtocols = ['DEEP_SPACE', 'ORBITAL_COMM', 'EMERGENCY'];
    this.maxMessageLength = 1024;
  }

  validateProtocol(protocol) {
    return this.supportedProtocols.includes(protocol);
  }

  encodeMessage(message, protocol = 'DEEP_SPACE') {
    if (!message || typeof message !== 'string') {
      throw new Error('Message must be a non-empty string');
    }

    if (message.length > this.maxMessageLength) {
      throw new Error(`Message exceeds maximum length of ${this.maxMessageLength} characters`);
    }

    if (!this.validateProtocol(protocol)) {
      throw new Error(`Unsupported protocol: ${protocol}`);
    }

    const timestamp = Date.now();
    const checksum = this.calculateChecksum(message);
    
    return {
      protocol,
      timestamp,
      message,
      checksum,
      length: message.length
    };
  }

  decodeMessage(encodedMessage) {
    if (!encodedMessage || typeof encodedMessage !== 'object') {
      throw new Error('Invalid encoded message format');
    }

    const { protocol, timestamp, message, checksum } = encodedMessage;

    if (!this.validateProtocol(protocol)) {
      throw new Error(`Unsupported protocol: ${protocol}`);
    }

    const calculatedChecksum = this.calculateChecksum(message);
    if (checksum !== calculatedChecksum) {
      throw new Error('Message checksum validation failed');
    }

    return {
      success: true,
      protocol,
      message,
      timestamp: new Date(timestamp),
      verified: true
    };
  }

  calculateChecksum(message) {
    let hash = 0;
    for (let i = 0; i < message.length; i++) {
      const char = message.charCodeAt(i);
      hash = ((hash << 5) - hash) + char;
      hash = hash & hash; // Convert to 32-bit integer
    }
    return Math.abs(hash);
  }
}

Create src/transmission-manager.js:

import { SignalProcessor } from './signal-processor.js';
import { ProtocolHandler } from './protocol-handler.js';

export class TransmissionManager {
  constructor() {
    this.signalProcessor = new SignalProcessor();
    this.protocolHandler = new ProtocolHandler();
    this.transmissionQueue = [];
    this.isTransmitting = false;
  }

  queueTransmission(message, protocol = 'DEEP_SPACE', signalStrength = 0.8) {
    try {
      const encoded = this.protocolHandler.encodeMessage(message, protocol);
      const processed = this.signalProcessor.processSignal(signalStrength);

      if (!processed.success) {
        throw new Error(`Signal processing failed: ${processed.error}`);
      }

      this.transmissionQueue.push({
        id: Date.now(),
        encoded,
        signalStrength: processed.signal,
        quality: processed.quality,
        status: 'queued'
      });

      return { success: true, queueLength: this.transmissionQueue.length };
    } catch (error) {
      return { success: false, error: error.message };
    }
  }

  async transmit() {
    if (this.isTransmitting || this.transmissionQueue.length === 0) {
      return { success: false, error: 'No transmissions queued or already transmitting' };
    }

    this.isTransmitting = true;
    const transmission = this.transmissionQueue.shift();
    
    try {
      // Simulate transmission delay
      await new Promise(resolve => setTimeout(resolve, 100));
      
      // Simulate potential transmission failure based on signal quality
      const failureChance = transmission.signalStrength < 0.3 ? 0.5 : 0.1;
      
      if (Math.random() < failureChance) {
        throw new Error('Transmission failed due to poor signal quality');
      }

      transmission.status = 'transmitted';
      this.isTransmitting = false;

      return {
        success: true,
        transmission: {
          id: transmission.id,
          message: transmission.encoded.message,
          protocol: transmission.encoded.protocol,
          signalStrength: transmission.signalStrength,
          quality: transmission.quality
        }
      };
    } catch (error) {
      transmission.status = 'failed';
      this.isTransmitting = false;
      return { success: false, error: error.message };
    }
  }

  getQueueStatus() {
    return {
      queueLength: this.transmissionQueue.length,
      isTransmitting: this.isTransmitting,
      nextTransmission: this.transmissionQueue[0] || null
    };
  }
}

Now create comprehensive tests. Create test/signal-processor.test.js:

import { describe, it, expect } from 'bun:test';
import { SignalProcessor } from '../src/signal-processor.js';

describe('SignalProcessor', () => {
  const processor = new SignalProcessor();

  describe('amplifySignal', () => {
    it('should amplify signal correctly', () => {
      expect(processor.amplifySignal(0.5, 2.0)).toBe(1.0);
      expect(processor.amplifySignal(0.3, 2.0)).toBe(0.6);
    });

    it('should cap amplified signal at 1.0', () => {
      expect(processor.amplifySignal(0.8, 2.0)).toBe(1.0);
    });

    it('should throw error for invalid signal', () => {
      expect(() => processor.amplifySignal('invalid')).toThrow('Signal must be a number');
      expect(() => processor.amplifySignal(-0.1)).toThrow('Signal must be between 0 and 1');
      expect(() => processor.amplifySignal(1.1)).toThrow('Signal must be between 0 and 1');
    });

    it('should throw error for invalid target level', () => {
      expect(() => processor.amplifySignal(0.5, 0)).toThrow('Target level must be between 0 and 10');
      expect(() => processor.amplifySignal(0.5, 11)).toThrow('Target level must be between 0 and 10');
    });
  });

  describe('filterNoise', () => {
    it('should filter out noise below threshold', () => {
      expect(processor.filterNoise(0.05)).toBe(0);
      expect(processor.filterNoise(0.15)).toBe(0.15);
    });

    it('should handle custom threshold', () => {
      expect(processor.filterNoise(0.15, 0.2)).toBe(0);
      expect(processor.filterNoise(0.25, 0.2)).toBe(0.25);
    });
  });

  describe('processSignal', () => {
    it('should process valid signal successfully', () => {
      const result = processor.processSignal(0.7, 1.2);
      expect(result.success).toBe(true);
      expect(result.signal).toBeCloseTo(0.84);
      expect(result.quality).toBe('excellent');
    });

    it('should handle processing errors', () => {
      const result = processor.processSignal('invalid');
      expect(result.success).toBe(false);
      expect(result.error).toBe('Signal must be a number');
      expect(result.signal).toBe(0);
    });
  });

  describe('calculateQuality', () => {
    it('should return correct quality ratings', () => {
      expect(processor.calculateQuality(0)).toBe(0);
      expect(processor.calculateQuality(0.9)).toBe('excellent');
      expect(processor.calculateQuality(0.7)).toBe('good');
      expect(processor.calculateQuality(0.5)).toBe('fair');
      expect(processor.calculateQuality(0.3)).toBe('poor');
    });
  });
});

Create test/protocol-handler.test.js:

import { describe, it, expect } from 'bun:test';
import { ProtocolHandler } from '../src/protocol-handler.js';

describe('ProtocolHandler', () => {
  const handler = new ProtocolHandler();

  describe('validateProtocol', () => {
    it('should validate supported protocols', () => {
      expect(handler.validateProtocol('DEEP_SPACE')).toBe(true);
      expect(handler.validateProtocol('ORBITAL_COMM')).toBe(true);
      expect(handler.validateProtocol('EMERGENCY')).toBe(true);
      expect(handler.validateProtocol('INVALID')).toBe(false);
    });
  });

  describe('encodeMessage', () => {
    it('should encode valid message', () => {
      const result = handler.encodeMessage('Test message', 'DEEP_SPACE');
      expect(result.protocol).toBe('DEEP_SPACE');
      expect(result.message).toBe('Test message');
      expect(result.length).toBe(12);
      expect(typeof result.timestamp).toBe('number');
      expect(typeof result.checksum).toBe('number');
    });

    it('should throw error for invalid message', () => {
      expect(() => handler.encodeMessage('')).toThrow('Message must be a non-empty string');
      expect(() => handler.encodeMessage(null)).toThrow('Message must be a non-empty string');
    });

    it('should throw error for message too long', () => {
      const longMessage = 'x'.repeat(1025);
      expect(() => handler.encodeMessage(longMessage)).toThrow('Message exceeds maximum length');
    });

    it('should throw error for invalid protocol', () => {
      expect(() => handler.encodeMessage('Test', 'INVALID')).toThrow('Unsupported protocol: INVALID');
    });
  });

  describe('decodeMessage', () => {
    it('should decode valid encoded message', () => {
      const encoded = handler.encodeMessage('Test message', 'EMERGENCY');
      const decoded = handler.decodeMessage(encoded);
      
      expect(decoded.success).toBe(true);
      expect(decoded.message).toBe('Test message');
      expect(decoded.protocol).toBe('EMERGENCY');
      expect(decoded.verified).toBe(true);
    });

    it('should throw error for invalid encoded message', () => {
      expect(() => handler.decodeMessage(null)).toThrow('Invalid encoded message format');
      expect(() => handler.decodeMessage('invalid')).toThrow('Invalid encoded message format');
    });

    it('should throw error for corrupted checksum', () => {
      const encoded = handler.encodeMessage('Test message');
      encoded.checksum = 999999; // Corrupt the checksum
      
      expect(() => handler.decodeMessage(encoded)).toThrow('Message checksum validation failed');
    });
  });

  describe('calculateChecksum', () => {
    it('should generate consistent checksums', () => {
      const checksum1 = handler.calculateChecksum('test');
      const checksum2 = handler.calculateChecksum('test');
      expect(checksum1).toBe(checksum2);
    });

    it('should generate different checksums for different messages', () => {
      const checksum1 = handler.calculateChecksum('test1');
      const checksum2 = handler.calculateChecksum('test2');
      expect(checksum1).not.toBe(checksum2);
    });
  });
});

Create test/transmission-manager.test.js:

import { describe, it, expect } from 'bun:test';
import { TransmissionManager } from '../src/transmission-manager.js';

describe('TransmissionManager', () => {
  let manager;

  beforeEach(() => {
    manager = new TransmissionManager();
  });

  describe('queueTransmission', () => {
    it('should queue valid transmission', () => {
      const result = manager.queueTransmission('Test message', 'DEEP_SPACE', 0.8);
      expect(result.success).toBe(true);
      expect(result.queueLength).toBe(1);
    });

    it('should handle invalid signal strength', () => {
      const result = manager.queueTransmission('Test message', 'DEEP_SPACE', 'invalid');
      expect(result.success).toBe(false);
      expect(result.error).toContain('Signal processing failed');
    });

    it('should handle invalid protocol', () => {
      const result = manager.queueTransmission('Test message', 'INVALID_PROTOCOL', 0.8);
      expect(result.success).toBe(false);
      expect(result.error).toContain('Unsupported protocol');
    });
  });

  describe('transmit', () => {
    it('should transmit queued message', async () => {
      manager.queueTransmission('Test message', 'EMERGENCY', 0.9);
      const result = await manager.transmit();
      
      expect(result.success).toBe(true);
      expect(result.transmission.message).toBe('Test message');
      expect(result.transmission.protocol).toBe('EMERGENCY');
    });

    it('should fail when no transmissions queued', async () => {
      const result = await manager.transmit();
      expect(result.success).toBe(false);
      expect(result.error).toContain('No transmissions queued');
    });
  });

  describe('getQueueStatus', () => {
    it('should return correct queue status', () => {
      const status = manager.getQueueStatus();
      expect(status.queueLength).toBe(0);
      expect(status.isTransmitting).toBe(false);
      expect(status.nextTransmission).toBe(null);

      manager.queueTransmission('Test', 'DEEP_SPACE', 0.7);
      const statusAfterQueue = manager.getQueueStatus();
      expect(statusAfterQueue.queueLength).toBe(1);
      expect(statusAfterQueue.nextTransmission).not.toBe(null);
    });
  });
});

Run the tests:

bun test

Verification

Run bun test. You should see all three test suites pass.

• SignalProcessor
• ProtocolHandler
• TransmissionManager
• pass

You can also run tests with more verbose output:

bun test --verbose

Commander Torres: "Excellent work, Chen. All communication modules are testing clean—no corrupted data, no protocol failures." She watches as the test suite completes with all green indicators, but her expression remains tense. "The modules are solid, but now comes the hard part. We need to deploy this to the external communication array, and there's only one way to reach it."

Review

Captain Liu's voice crackles through the static, weaker than before: "Kepler Station, this is our final status check. If we don't hear from you in two hours, we abort rendezvous. Repeat—two hours to contact or we're gone."

Chapter 5: Critical Deployment

[Scene: Through the viewport of Engineering Bay Alpha, the supply ship is now visible as more than just a distant star—a tiny but growing point of light against the cosmic void. Commander Torres stands beside an EVA suit rack, her weathered hands checking the seals and power systems of the bulky white suit that will carry you to the external communication array.]

The station's hull groans softly as thermal expansion and contraction cycles continue, a reminder that you're floating in the vacuum of space with only metal and composites between you and eternity. The communication array sits on an external platform, accessible only through a maintenance airlock and a careful EVA traverse.

Commander Torres: "The communication array is on Platform Seven, Chen. You'll need to suit up and deploy the system manually from out there—the internal connections were severed when the cascade hit." She hands you the EVA suit's helmet, her eyes reflecting the urgency of the situation. "This isn't just about getting the code running. It's about production deployment in an environment where there's no room for error. One mistake and we lose our only chance to contact that supply ship."

Think First

Consider what makes this deployment critical:

• What's different about deploying to a production environment versus running code on your development machine?
• Why would environment configuration be crucial for a system that needs to work reliably in space?
• How might you ensure the deployed system can handle the specific conditions it will face?

The Task

Create the production deployment system:

mkdir critical-deployment
cd critical-deployment
bun init

Install production dependenci

…(truncated)