@hixbe/time 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Hixbe
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,446 @@
+# @hixbe/time
+
+**High-precision NTP time synchronization package with powerful CLI tools**
+
+A professional-grade TypeScript package for querying NTP servers and synchronizing system time with network time servers. Built with Hixbe's primary server `time.hixbe.com` for ultra-reliable time synchronization.
+
+[![npm version](https://img.shields.io/npm/v/@hixbe/time.svg)](https://www.npmjs.com/package/@hixbe/time)
+[![TypeScript](https://img.shields.io/badge/TypeScript-5.0-blue)](https://www.typescriptlang.org/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+## Features
+
+✨ **Rich Feature Set**
+- 🚀 High-performance NTP client
+- 📊 Raw packet inspection & analysis
+- ⏱️ Precise timestamp conversion (NTP to Unix)
+- 🔄 Continuous sync mode with configurable intervals
+- 📡 Multiple server support (Hixbe, pool.ntp.org, etc.)
+- 📋 Detailed verbose reporting
+- 🎨 Beautiful CLI with multiple output formats
+- 🔐 Type-safe TypeScript implementation
+- ⚡ Zero external dependencies (uses Node.js built-ins)
+
+## Installation
+
+```bash
+npm install @hixbe/time
+```
+
+### Global CLI Installation
+
+```bash
+npm install -g @hixbe/time
+hixbe-time --help
+```
+
+## Quick Start
+
+### CLI Usage
+
+```bash
+# Get current time from Hixbe server
+hixbe-time
+
+# Verbose mode with raw packet details
+hixbe-time --verbose
+
+# Output as JSON
+hixbe-time --json
+
+# Get time offset (useful for scripts)
+hixbe-time --offset
+
+# Continuous synchronization (every 5 seconds)
+hixbe-time --continuous
+
+# Custom interval (every 2 seconds)
+hixbe-time --continuous --interval 2000
+
+# Query different server
+hixbe-time --server pool.ntp.org --verbose
+
+# Show only the offset
+hixbe-time --offset
+```
+
+### Programmatic Usage
+
+```typescript
+import { NTPClient } from '@hixbe/time';
+
+// Basic usage
+const client = new NTPClient();
+const result = await client.query();
+console.log(result.parsed.timestamps.transmit.date);
+
+// Get current time
+const time = await client.getTime();
+console.log(time); // Date object
+
+// Get offset between local and server time
+const offsetMs = await client.getOffset();
+console.log(`System is ${offsetMs > 0 ? 'slow' : 'fast'} by ${Math.abs(offsetMs)}ms`);
+
+// Custom server
+const customClient = new NTPClient({ 
+  host: 'time.google.com',
+  timeout: 3000 
+});
+const time = await customClient.getTime();
+```
+
+## API Reference
+
+### `NTPClient`
+
+Main class for NTP queries.
+
+```typescript
+class NTPClient {
+  constructor(config?: NTPClientConfig);
+  async query(): Promise<NTPQueryResult>;
+  async getTime(): Promise<Date>;
+  async getOffset(): Promise<number>;
+}
+```
+
+#### `NTPClientConfig`
+
+```typescript
+interface NTPClientConfig {
+  host?: string;      // Default: 'time.hixbe.com'
+  port?: number;      // Default: 123
+  timeout?: number;   // Default: 5000ms
+}
+```
+
+#### `NTPQueryResult`
+
+```typescript
+interface NTPQueryResult {
+  buffer: Buffer;                    // Raw NTP packet
+  hexDump: string;                   // Formatted hex dump
+  parsed: ParsedNTPPacket;          // Parsed packet
+  serverAddress: string;            // Server IP
+  clientReceiveTime: Date;          // When response arrived
+  clientOriginateTime: Date;        // When request sent
+}
+```
+
+### `ParsedNTPPacket`
+
+```typescript
+interface ParsedNTPPacket {
+  header: NTPPacketHeader;
+  timestamps: NTPTimestamps;
+  roundTripDelay: number | null;
+  clockOffset: number | null;
+}
+```
+
+#### `NTPPacketHeader`
+
+```typescript
+interface NTPPacketHeader {
+  leapIndicator: number;      // 0-3: Normal, +1sec, -1sec, unsync
+  versionNumber: number;      // NTP version (3 or 4)
+  mode: number;               // Client/Server mode
+  stratum: number;            // Clock distance from reference
+  pollInterval: number;       // Poll interval (2^x seconds)
+  precision: number;          // Precision (2^x seconds)
+  rootDelay: number;          // Root delay in milliseconds
+  rootDispersion: number;     // Root dispersion in milliseconds
+  referenceId: string;        // Reference clock identifier
+}
+```
+
+#### `NTPTimestamps`
+
+```typescript
+interface NTPTimestamps {
+  reference: ParsedNTPTimestamp;   // Reference time
+  originate: ParsedNTPTimestamp;   // Client's transmit time
+  receive: ParsedNTPTimestamp;     // Server's receive time
+  transmit: ParsedNTPTimestamp;    // Server's transmit time
+}
+```
+
+#### `ParsedNTPTimestamp`
+
+```typescript
+interface ParsedNTPTimestamp {
+  raw: {
+    seconds: number;        // NTP seconds (since 1900)
+    fraction: number;       // Fraction (32-bit fixed-point)
+  };
+  unix: {
+    seconds: number;        // Unix seconds (since 1970)
+    milliseconds: number;   // Fractional milliseconds
+  };
+  date: Date;               // JavaScript Date object
+  iso: string;              // ISO 8601 string
+  local: string;            // Local timezone string
+  timestamp: number;        // Unix timestamp in ms
+}
+```
+
+## Understanding NTP Timestamps
+
+### The Conversion Process
+
+NTP uses a unique timestamp format:
+- **NTP Epoch**: January 1, 1900
+- **Unix Epoch**: January 1, 1970
+- **Offset**: 2,208,988,800 seconds
+
+Each timestamp is 8 bytes (64-bit):
+- **First 4 bytes**: Seconds since 1900
+- **Last 4 bytes**: Fractional seconds (32-bit fixed-point)
+
+### Example Conversion
+
+```
+Raw NTP packet (Bytes 40-47, Transmit):
+  Hex:     EC EB 5C 3D 33 88 C9 16
+  
+Breakdown:
+  Seconds (bytes 0-3):   0xECEB5C3D = 3,974,847,549
+  Fraction (bytes 4-7):  0x3388C916 = 864,602,390
+  
+Conversion:
+  NTP → Unix:  3,974,847,549 - 2,208,988,800 = 1,765,858,749 sec
+  Fraction:    864,602,390 ÷ 0x100000000 = 0.201306 sec = 201.306 ms
+  
+Result:
+  Unix timestamp: 1,765,858,749.201 seconds
+  Date: 2025-12-16T04:19:09.201Z
+```
+
+## CLI Examples
+
+### Default Output
+```bash
+$ hixbe-time
+======================================================================
+🕐 HIXBE TIME SYNC
+======================================================================
+
+Server:        154.26.137.94 (time.hixbe.com)
+UTC Time:      2025-12-16T04:19:09.201Z
+Local Time:    Tue Dec 16 2025 10:19:09 GMT+0600
+Offset:        +0.468 seconds
+Precision:     ±231 (2^x sec)
+Stratum:       2
+======================================================================
+```
+
+### Verbose Mode
+```bash
+$ hixbe-time --verbose
+📡 TIMESTAMPS:
+  Reference: 2025-12-16T04:18:37.660Z
+  Transmit:  2025-12-16T04:19:09.201Z
+  Receive:   2025-12-16T04:19:09.200Z
+
+💾 RAW TRANSMIT TIMESTAMP (Bytes 40-47):
+  Hex: ECEB5C3D3388C916
+  Seconds (NTP): 3974847549 → Unix: 1765858749
+  Fraction: 0x3388C916 = 201.306ms
+```
+
+### JSON Output
+```bash
+$ hixbe-time --json
+{
+  "timestamp": 1765858749201,
+  "iso": "2025-12-16T04:19:09.201Z",
+  "server": {
+    "address": "154.26.137.94",
+    "stratum": 2,
+    "referenceId": "0xD8EF230C"
+  },
+  "offset": 468,
+  "precision": -23,
+  "version": 4
+}
+```
+
+### Continuous Sync
+```bash
+$ hixbe-time --continuous --interval 1000
+⏱️  Starting continuous sync with time.hixbe.com
+📊 Interval: 1000ms (1.0s)
+Press Ctrl+C to stop
+
+[1] ✅ 2025-12-16T04:19:09.201Z | Offset: +468ms
+[2] ✅ 2025-12-16T04:19:10.205Z | Offset: +456ms
+[3] ✅ 2025-12-16T04:19:11.210Z | Offset: +442ms
+```
+
+## Advanced Usage
+
+### Creating a Time Sync Daemon
+
+```typescript
+import { NTPClient } from '@hixbe/time';
+
+async function syncClock() {
+  const client = new NTPClient({ host: 'time.hixbe.com' });
+  const offsetMs = await client.getOffset();
+  
+  if (Math.abs(offsetMs) > 1000) {
+    console.warn(`⚠️ Large offset detected: ${offsetMs}ms`);
+    // Could trigger system time adjustment
+  }
+  
+  console.log(`Clock offset: ${offsetMs}ms`);
+}
+
+// Sync every 60 seconds
+setInterval(syncClock, 60000);
+```
+
+### Monitoring Multiple Servers
+
+```typescript
+import { NTPClient } from '@hixbe/time';
+
+const servers = [
+  'time.hixbe.com',
+  'pool.ntp.org',
+  'time.google.com'
+];
+
+for (const server of servers) {
+  const client = new NTPClient({ host: server });
+  try {
+    const time = await client.getTime();
+    console.log(`${server}: ${time.toISOString()}`);
+  } catch (error) {
+    console.error(`${server}: Failed`);
+  }
+}
+```
+
+### Raw Packet Analysis
+
+```typescript
+import { NTPClient, NTPParser } from '@hixbe/time';
+
+const client = new NTPClient();
+const result = await client.query();
+
+// Access raw bytes
+console.log(result.hexDump);
+
+// Parse header
+const header = result.parsed.header;
+console.log(`Stratum: ${header.stratum}`);
+console.log(`Reference ID: ${header.referenceId}`);
+
+// Access all timestamps
+const ts = result.parsed.timestamps;
+console.log(`Server said time is: ${ts.transmit.iso}`);
+```
+
+## Supported NTP Servers
+
+```typescript
+// Hixbe (recommended)
+new NTPClient({ host: 'time.hixbe.com' })
+
+// Public pools and servers
+new NTPClient({ host: 'pool.ntp.org' })
+new NTPClient({ host: 'time.nist.gov' })
+new NTPClient({ host: 'time.google.com' })
+new NTPClient({ host: 'time.cloudflare.com' })
+new NTPClient({ host: 'time.apple.com' })
+```
+
+## Performance & Reliability
+
+- ⚡ **Fast**: < 100ms typical response time
+- 🔒 **Reliable**: Works with standard NTP servers
+- 📊 **Accurate**: Microsecond precision
+- 🌐 **Network Safe**: Standard UDP port 123
+- 💾 **Lightweight**: No dependencies beyond Node.js
+
+## Troubleshooting
+
+### "NTP request timeout"
+- Server may be unreachable
+- Firewall blocking UDP port 123
+- Try a different server: `--server pool.ntp.org`
+
+### Offset seems large
+- Normal variation can be several hundred milliseconds
+- Check with `--verbose` for server stratum
+- Try lower latency server
+
+### "Invalid NTP packet"
+- Packet may be corrupted
+- Server may not be responding with valid NTP
+- Try different server
+
+## FAQ
+
+**Q: Can I use this in production?**
+A: Yes! This is a robust, type-safe implementation suitable for production clock synchronization.
+
+**Q: What's the precision?**
+A: Typically ±50-200ms depending on network latency and server stratum.
+
+**Q: Can I set system time?**
+A: This package only queries and reports time. OS permissions are needed for actual system time adjustment.
+
+**Q: Why is my offset negative?**
+A: Your system time is ahead of the NTP server time.
+
+**Q: Can I use IPv6 servers?**
+A: Currently uses UDP4. IPv6 support coming in v2.0.
+
+## Security
+
+- No authentication required for NTP (protocol design)
+- Uses standard UDP port 123
+- Validates packet structure
+- TypeScript type safety prevents injection attacks
+
+## Development
+
+```bash
+# Install dependencies
+npm install
+
+# Build TypeScript
+npm run build
+
+# Watch mode
+npm run dev
+
+# Run tests
+npm test
+```
+
+## License
+
+MIT © 2025 Hixbe
+
+## Contributing
+
+Contributions welcome! Please submit pull requests to improve:
+- IPv6 support
+- Performance optimizations
+- Additional time servers
+- Better documentation
+
+## Support
+
+- GitHub Issues: https://github.com/hixbehq/nodejs-time/issues
+- Documentation: https://github.com/hixbehq/nodejs-time#readme
+- Contact: support@hixbe.com
+
+---
+
+Made with ❤️ by **Hixbe** - Precision Time Solutions

package/dist/cli/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/cli/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":""}

package/dist/cli/index.js

@@ -0,0 +1,225 @@
+#!/usr/bin/env node
+import { NTPClient } from '../core/client.js';
+class HixbeTimeCLI {
+    constructor() {
+        this.options = {
+            server: 'time.hixbe.com',
+            json: false,
+            verbose: false,
+            offset: false,
+            continuous: false,
+            interval: 5000,
+        };
+    }
+    async run() {
+        this.parseArgs();
+        if (this.options.continuous) {
+            await this.continuousMode();
+        }
+        else {
+            await this.singleQuery();
+        }
+    }
+    parseArgs() {
+        const args = process.argv.slice(2);
+        for (let i = 0; i < args.length; i++) {
+            const arg = args[i];
+            switch (arg) {
+                case '-s':
+                case '--server':
+                    this.options.server = args[++i];
+                    break;
+                case '-j':
+                case '--json':
+                    this.options.json = true;
+                    break;
+                case '-v':
+                case '--verbose':
+                    this.options.verbose = true;
+                    break;
+                case '-o':
+                case '--offset':
+                    this.options.offset = true;
+                    break;
+                case '-c':
+                case '--continuous':
+                    this.options.continuous = true;
+                    break;
+                case '-i':
+                case '--interval':
+                    this.options.interval = parseInt(args[++i], 10);
+                    break;
+                case '-h':
+                case '--help':
+                    this.printHelp();
+                    process.exit(0);
+                    break;
+                case '--version':
+                    this.printVersion();
+                    process.exit(0);
+                    break;
+            }
+        }
+    }
+    async singleQuery() {
+        try {
+            const client = new NTPClient({ host: this.options.server });
+            const result = await client.query();
+            if (this.options.json) {
+                this.outputJSON(result);
+            }
+            else if (this.options.offset) {
+                this.outputOffset(result);
+            }
+            else if (this.options.verbose) {
+                this.outputVerbose(result);
+            }
+            else {
+                this.outputDefault(result);
+            }
+        }
+        catch (error) {
+            this.handleError(error);
+        }
+    }
+    async continuousMode() {
+        let count = 0;
+        console.log(`⏱️  Starting continuous sync with ${this.options.server}`);
+        console.log(`📊 Interval: ${this.options.interval}ms (${(this.options.interval / 1000).toFixed(1)}s)`);
+        console.log('Press Ctrl+C to stop\n');
+        const displayBars = () => {
+            process.stdout.write('');
+        };
+        while (true) {
+            try {
+                const client = new NTPClient({ host: this.options.server });
+                const result = await client.query();
+                const offset = result.parsed.timestamps.transmit.date.getTime() - result.clientReceiveTime.getTime();
+                count++;
+                const time = result.parsed.timestamps.transmit.date;
+                const status = offset > 500 ? '⚠️ ' : offset < -500 ? '⚠️ ' : '✅';
+                console.log(`[${count}] ${status} ${time.toISOString()} | Offset: ${offset > 0 ? '+' : ''}${offset.toFixed(0)}ms`);
+                await this.sleep(this.options.interval);
+            }
+            catch (error) {
+                console.error(`❌ Error: ${error.message}`);
+                await this.sleep(this.options.interval);
+            }
+        }
+    }
+    outputDefault(result) {
+        const tx = result.parsed.timestamps.transmit;
+        const offset = result.parsed.timestamps.transmit.timestamp - result.clientReceiveTime.getTime();
+        console.log('═'.repeat(70));
+        console.log('🕐 HIXBE TIME SYNC');
+        console.log('═'.repeat(70));
+        console.log(`\nServer:        ${result.serverAddress} (${this.options.server})`);
+        console.log(`UTC Time:      ${tx.iso}`);
+        console.log(`Local Time:    ${tx.local}`);
+        console.log(`Offset:        ${offset > 0 ? '+' : ''}${(offset / 1000).toFixed(3)} seconds`);
+        console.log(`Precision:     ±${result.parsed.header.precision} (2^x sec)`);
+        console.log(`Stratum:       ${result.parsed.header.stratum}`);
+        console.log('═'.repeat(70) + '\n');
+    }
+    outputOffset(result) {
+        const offset = result.parsed.timestamps.transmit.timestamp - result.clientReceiveTime.getTime();
+        console.log(offset > 0 ? '+' : '');
+        console.log(offset);
+    }
+    outputJSON(result) {
+        const output = {
+            timestamp: result.parsed.timestamps.transmit.timestamp,
+            iso: result.parsed.timestamps.transmit.iso,
+            server: {
+                address: result.serverAddress,
+                stratum: result.parsed.header.stratum,
+                referenceId: result.parsed.header.referenceId,
+            },
+            offset: result.parsed.timestamps.transmit.timestamp - result.clientReceiveTime.getTime(),
+            precision: result.parsed.header.precision,
+            version: result.parsed.header.versionNumber,
+        };
+        console.log(JSON.stringify(output, null, 2));
+    }
+    outputVerbose(result) {
+        const tx = result.parsed.timestamps.transmit;
+        const h = result.parsed.header;
+        console.log('═'.repeat(70));
+        console.log('🕐 HIXBE TIME - DETAILED REPORT');
+        console.log('═'.repeat(70));
+        // Timestamps
+        console.log('\n📡 TIMESTAMPS:');
+        console.log(`  Reference: ${result.parsed.timestamps.reference.iso}`);
+        console.log(`  Transmit:  ${tx.iso}`);
+        console.log(`  Receive:   ${result.parsed.timestamps.receive.iso}`);
+        // Raw bytes
+        console.log('\n💾 RAW TRANSMIT TIMESTAMP (Bytes 40-47):');
+        const txOffset = 40;
+        const txBuffer = result.buffer.slice(txOffset, txOffset + 8);
+        console.log(`  Hex: ${txBuffer.toString('hex').toUpperCase()}`);
+        const ntpSeconds = txBuffer.readUInt32BE(0);
+        const fraction = txBuffer.readUInt32BE(4);
+        const unixSeconds = ntpSeconds - 2208988800;
+        const fracMs = (fraction / 0x100000000) * 1000;
+        console.log(`  Seconds (NTP): ${ntpSeconds} → Unix: ${unixSeconds}`);
+        console.log(`  Fraction: 0x${fraction.toString(16).toUpperCase()} = ${fracMs.toFixed(3)}ms`);
+        // Header
+        console.log('\n📋 PACKET HEADER:');
+        console.log(`  Leap Indicator: ${h.leapIndicator}`);
+        console.log(`  Version:        ${h.versionNumber}`);
+        console.log(`  Mode:           ${h.mode}`);
+        console.log(`  Stratum:        ${h.stratum}`);
+        console.log(`  Poll Interval:  2^${h.pollInterval}`);
+        console.log(`  Precision:      2^${h.precision}`);
+        console.log(`  Root Delay:     ${h.rootDelay / 65536} ms`);
+        console.log(`  Root Dispersion: ${h.rootDispersion / 65536} ms`);
+        console.log(`  Reference ID:   ${h.referenceId}`);
+        console.log('\n═'.repeat(70) + '\n');
+    }
+    handleError(error) {
+        const message = error instanceof Error ? error.message : String(error);
+        console.error(`❌ Error: ${message}`);
+        process.exit(1);
+    }
+    printHelp() {
+        console.log(`
+@hixbe/time - High-precision NTP Time Synchronization
+
+USAGE:
+  hixbe-time [OPTIONS]
+
+OPTIONS:
+  -s, --server <host>    NTP server (default: time.hixbe.com)
+  -j, --json             Output as JSON
+  -v, --verbose          Detailed output with raw bytes
+  -o, --offset           Output only the offset in milliseconds
+  -c, --continuous       Continuous sync mode
+  -i, --interval <ms>    Interval between syncs (default: 5000ms)
+  -h, --help             Show this help
+  --version              Show version
+
+EXAMPLES:
+  hixbe-time
+  hixbe-time --verbose
+  hixbe-time --json
+  hixbe-time --continuous --interval 1000
+  hixbe-time --offset
+  hixbe-time --server pool.ntp.org
+
+Learn more: https://github.com/hixbehq/nodejs-time
+    `);
+    }
+    printVersion() {
+        console.log('@hixbe/time v1.0.0');
+    }
+    sleep(ms) {
+        return new Promise((resolve) => setTimeout(resolve, ms));
+    }
+}
+// Run CLI
+const cli = new HixbeTimeCLI();
+cli.run().catch((error) => {
+    console.error(`Fatal error: ${error.message}`);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":"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"}

package/dist/core/client.d.ts

@@ -0,0 +1,44 @@
+import { ParsedNTPPacket } from './parser.js';
+export interface NTPClientConfig {
+    host?: string;
+    port?: number;
+    timeout?: number;
+}
+export interface NTPQueryResult {
+    buffer: Buffer;
+    hexDump: string;
+    parsed: ParsedNTPPacket;
+    serverAddress: string;
+    clientReceiveTime: Date;
+    clientOriginateTime: Date;
+}
+/**
+ * NTP Client - Sends NTP requests and retrieves responses
+ */
+export declare class NTPClient {
+    private host;
+    private port;
+    private timeout;
+    constructor(config?: NTPClientConfig);
+    /**
+     * Send NTP request and receive response
+     */
+    query(): Promise<NTPQueryResult>;
+    /**
+     * Get current NTP time from server
+     */
+    getTime(): Promise<Date>;
+    /**
+     * Get time offset between local and NTP server
+     */
+    getOffset(): Promise<number>;
+    /**
+     * Create NTP request packet (client mode)
+     */
+    private createRequestPacket;
+    /**
+     * Generate hex dump of buffer
+     */
+    private hexDump;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/core/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/core/client.ts"],"names":[],"mappings":"AACA,OAAO,EAAa,eAAe,EAAE,MAAM,aAAa,CAAC;AAEzD,MAAM,WAAW,eAAe;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,eAAe,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;IACtB,iBAAiB,EAAE,IAAI,CAAC;IACxB,mBAAmB,EAAE,IAAI,CAAC;CAC3B;AAED;;GAEG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,IAAI,CAAS;IACrB,OAAO,CAAC,IAAI,CAAS;IACrB,OAAO,CAAC,OAAO,CAAS;gBAEZ,MAAM,GAAE,eAAoB;IAMxC;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,cAAc,CAAC;IAsDtC;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAK9B;;OAEG;IACG,SAAS,IAAI,OAAO,CAAC,MAAM,CAAC;IAOlC;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAkB3B;;OAEG;IACH,OAAO,CAAC,OAAO;CAgBhB"}

package/dist/core/client.js

@@ -0,0 +1,116 @@
+import dgram from 'dgram';
+import { NTPParser } from './parser.js';
+/**
+ * NTP Client - Sends NTP requests and retrieves responses
+ */
+export class NTPClient {
+    constructor(config = {}) {
+        this.host = config.host || 'time.hixbe.com';
+        this.port = config.port || 123;
+        this.timeout = config.timeout || 5000;
+    }
+    /**
+     * Send NTP request and receive response
+     */
+    async query() {
+        return new Promise((resolve, reject) => {
+            const client = dgram.createSocket('udp4');
+            const timeoutId = setTimeout(() => {
+                client.close();
+                reject(new Error(`NTP request timeout after ${this.timeout}ms`));
+            }, this.timeout);
+            client.on('message', (buffer, rinfo) => {
+                clearTimeout(timeoutId);
+                client.close();
+                try {
+                    const clientReceiveTime = new Date();
+                    const parsed = NTPParser.parsePacket(buffer);
+                    resolve({
+                        buffer,
+                        hexDump: this.hexDump(buffer),
+                        parsed,
+                        serverAddress: rinfo.address,
+                        clientReceiveTime,
+                        clientOriginateTime: new Date(Date.now() - this.timeout / 2),
+                    });
+                }
+                catch (error) {
+                    reject(error);
+                }
+            });
+            client.on('error', (error) => {
+                clearTimeout(timeoutId);
+                client.close();
+                reject(error);
+            });
+            // Create NTP request packet
+            const ntpPacket = this.createRequestPacket();
+            try {
+                client.send(ntpPacket, 0, ntpPacket.length, this.port, this.host, (error) => {
+                    if (error) {
+                        clearTimeout(timeoutId);
+                        client.close();
+                        reject(error);
+                    }
+                });
+            }
+            catch (error) {
+                clearTimeout(timeoutId);
+                client.close();
+                reject(error);
+            }
+        });
+    }
+    /**
+     * Get current NTP time from server
+     */
+    async getTime() {
+        const result = await this.query();
+        return result.parsed.timestamps.transmit.date;
+    }
+    /**
+     * Get time offset between local and NTP server
+     */
+    async getOffset() {
+        const result = await this.query();
+        const serverTime = result.parsed.timestamps.transmit.date.getTime();
+        const localTime = result.clientReceiveTime.getTime();
+        return serverTime - localTime;
+    }
+    /**
+     * Create NTP request packet (client mode)
+     */
+    createRequestPacket() {
+        const packet = Buffer.alloc(48, 0);
+        // First byte: LI (0), VN (3), Mode (3 = client)
+        packet[0] = 0x23;
+        // Add transmit timestamp (current time)
+        const now = new Date();
+        const unixSeconds = Math.floor(now.getTime() / 1000);
+        const ntpSeconds = unixSeconds + 2208988800;
+        const fraction = Math.random() * 0x100000000;
+        packet.writeUInt32BE(ntpSeconds, 40);
+        packet.writeUInt32BE(Math.floor(fraction), 44);
+        return packet;
+    }
+    /**
+     * Generate hex dump of buffer
+     */
+    hexDump(buffer) {
+        let dump = '';
+        for (let i = 0; i < buffer.length; i += 16) {
+            const hex = buffer
+                .slice(i, i + 16)
+                .toString('hex')
+                .match(/.{1,2}/g)
+                ?.join(' ');
+            const ascii = buffer
+                .slice(i, i + 16)
+                .toString('ascii')
+                .replace(/[^\x20-\x7E]/g, '.');
+            dump += `${String(i).padStart(4, '0')}: ${hex?.padEnd(48)} ${ascii}\n`;
+        }
+        return dump;
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/core/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/core/client.ts"],"names":[],"mappings":"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"}

package/dist/core/index.d.ts

@@ -0,0 +1,14 @@
+import { NTPClient } from './client.js';
+import { NTPParser } from './parser.js';
+export { NTPClient, NTPParser };
+export type { NTPClientConfig, NTPQueryResult } from './client.js';
+export type { RawNTPTimestamp, ParsedNTPTimestamp, NTPPacketHeader, NTPTimestamps, ParsedNTPPacket, } from './parser.js';
+declare const _default: {
+    getTime(host?: string): Promise<Date>;
+    getOffset(host?: string): Promise<number>;
+    query(host?: string): Promise<import("./client.js").NTPQueryResult>;
+    NTPClient: typeof NTPClient;
+    NTPParser: typeof NTPParser;
+};
+export default _default;
+//# sourceMappingURL=index.d.ts.map

package/dist/core/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,CAAC;AAChC,YAAY,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AACnE,YAAY,EACV,eAAe,EACf,kBAAkB,EAClB,eAAe,EACf,aAAa,EACb,eAAe,GAChB,MAAM,aAAa,CAAC;;4BAIqB,OAAO,CAAC,IAAI,CAAC;8BAKX,OAAO,CAAC,MAAM,CAAC;;;;;AAN3D,wBAkBE"}

package/dist/core/index.js

@@ -0,0 +1,21 @@
+import { NTPClient } from './client.js';
+import { NTPParser } from './parser.js';
+export { NTPClient, NTPParser };
+// Default export with convenience functions
+export default {
+    async getTime(host = 'time.hixbe.com') {
+        const client = new NTPClient({ host });
+        return client.getTime();
+    },
+    async getOffset(host = 'time.hixbe.com') {
+        const client = new NTPClient({ host });
+        return client.getOffset();
+    },
+    async query(host = 'time.hixbe.com') {
+        const client = new NTPClient({ host });
+        return client.query();
+    },
+    NTPClient,
+    NTPParser,
+};
+//# sourceMappingURL=index.js.map

package/dist/core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,CAAC;AAUhC,4CAA4C;AAC5C,eAAe;IACb,KAAK,CAAC,OAAO,CAAC,IAAI,GAAG,gBAAgB;QACnC,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;QACvC,OAAO,MAAM,CAAC,OAAO,EAAE,CAAC;IAC1B,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,IAAI,GAAG,gBAAgB;QACrC,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;QACvC,OAAO,MAAM,CAAC,SAAS,EAAE,CAAC;IAC5B,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,IAAI,GAAG,gBAAgB;QACjC,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;QACvC,OAAO,MAAM,CAAC,KAAK,EAAE,CAAC;IACxB,CAAC;IAED,SAAS;IACT,SAAS;CACV,CAAC"}

package/dist/core/parser.d.ts

@@ -0,0 +1,82 @@
+/**
+ * NTP Timestamp Parser
+ * Handles conversion between NTP timestamps and JavaScript Date objects
+ */
+export interface RawNTPTimestamp {
+    seconds: number;
+    fraction: number;
+}
+export interface ParsedNTPTimestamp {
+    raw: RawNTPTimestamp;
+    unix: {
+        seconds: number;
+        milliseconds: number;
+    };
+    date: Date;
+    iso: string;
+    local: string;
+    timestamp: number;
+}
+export interface NTPPacketHeader {
+    leapIndicator: number;
+    versionNumber: number;
+    mode: number;
+    stratum: number;
+    pollInterval: number;
+    precision: number;
+    rootDelay: number;
+    rootDispersion: number;
+    referenceId: string;
+}
+export interface NTPTimestamps {
+    reference: ParsedNTPTimestamp;
+    originate: ParsedNTPTimestamp;
+    receive: ParsedNTPTimestamp;
+    transmit: ParsedNTPTimestamp;
+}
+export interface ParsedNTPPacket {
+    header: NTPPacketHeader;
+    timestamps: NTPTimestamps;
+    roundTripDelay: number | null;
+    clockOffset: number | null;
+}
+export declare class NTPParser {
+    /**
+     * NTP epoch starts on January 1, 1900
+     * Unix epoch starts on January 1, 1970
+     * The difference is 2,208,988,800 seconds
+     */
+    private static readonly NTP_EPOCH_OFFSET;
+    /**
+     * Parse raw NTP response buffer (48 bytes)
+     *
+     * Packet structure:
+     * - Bytes 0-3: LI, VN, Mode, Stratum, Poll, Precision
+     * - Bytes 4-7: Root Delay
+     * - Bytes 8-11: Root Dispersion
+     * - Bytes 12-15: Reference ID
+     * - Bytes 16-23: Reference Timestamp
+     * - Bytes 24-31: Originate Timestamp
+     * - Bytes 32-39: Receive Timestamp
+     * - Bytes 40-47: Transmit Timestamp
+     */
+    static parsePacket(buffer: Buffer): ParsedNTPPacket;
+    /**
+     * Parse 8-byte NTP timestamp (64-bit fixed-point: 32-bit seconds, 32-bit fraction)
+     */
+    private static parseNTPTimestamp;
+    /**
+     * Format reference ID based on stratum
+     */
+    private static formatReferenceId;
+    /**
+     * Calculate round-trip delay and clock offset
+     */
+    static calculateMetrics(parsed: ParsedNTPPacket, clientOriginateTime: Date, clientReceiveTime: Date): {
+        roundTripDelay: number;
+        clockOffset: number;
+        roundTripDelayMs: number;
+        clockOffsetMs: number;
+    };
+}
+//# sourceMappingURL=parser.d.ts.map

package/dist/core/parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../src/core/parser.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,kBAAkB;IACjC,GAAG,EAAE,eAAe,CAAC;IACrB,IAAI,EAAE;QACJ,OAAO,EAAE,MAAM,CAAC;QAChB,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC;IACF,IAAI,EAAE,IAAI,CAAC;IACX,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,eAAe;IAC9B,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,kBAAkB,CAAC;IAC9B,SAAS,EAAE,kBAAkB,CAAC;IAC9B,OAAO,EAAE,kBAAkB,CAAC;IAC5B,QAAQ,EAAE,kBAAkB,CAAC;CAC9B;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,eAAe,CAAC;IACxB,UAAU,EAAE,aAAa,CAAC;IAC1B,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAED,qBAAa,SAAS;IACpB;;;;OAIG;IACH,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,gBAAgB,CAAc;IAEtD;;;;;;;;;;;;OAYG;IACH,MAAM,CAAC,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,eAAe;IAgDnD;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,iBAAiB;IAwBhC;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,iBAAiB;IAWhC;;OAEG;IACH,MAAM,CAAC,gBAAgB,CACrB,MAAM,EAAE,eAAe,EACvB,mBAAmB,EAAE,IAAI,EACzB,iBAAiB,EAAE,IAAI,GACtB;QAAE,cAAc,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,gBAAgB,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAA;KAAE;CAgBpG"}

package/dist/core/parser.js

@@ -0,0 +1,123 @@
+/**
+ * NTP Timestamp Parser
+ * Handles conversion between NTP timestamps and JavaScript Date objects
+ */
+export class NTPParser {
+    /**
+     * Parse raw NTP response buffer (48 bytes)
+     *
+     * Packet structure:
+     * - Bytes 0-3: LI, VN, Mode, Stratum, Poll, Precision
+     * - Bytes 4-7: Root Delay
+     * - Bytes 8-11: Root Dispersion
+     * - Bytes 12-15: Reference ID
+     * - Bytes 16-23: Reference Timestamp
+     * - Bytes 24-31: Originate Timestamp
+     * - Bytes 32-39: Receive Timestamp
+     * - Bytes 40-47: Transmit Timestamp
+     */
+    static parsePacket(buffer) {
+        if (buffer.length < 48) {
+            throw new Error('Invalid NTP packet: minimum 48 bytes required');
+        }
+        // Parse header
+        const firstByte = buffer[0];
+        const leapIndicator = (firstByte >> 6) & 0b11;
+        const versionNumber = (firstByte >> 3) & 0b111;
+        const mode = firstByte & 0b111;
+        const stratum = buffer[1];
+        const pollInterval = buffer[2];
+        const precision = buffer[3];
+        // Parse timestamps
+        const referenceTimestamp = this.parseNTPTimestamp(buffer, 16);
+        const originateTimestamp = this.parseNTPTimestamp(buffer, 24);
+        const receiveTimestamp = this.parseNTPTimestamp(buffer, 32);
+        const transmitTimestamp = this.parseNTPTimestamp(buffer, 40);
+        // Parse root delay and dispersion
+        const rootDelay = buffer.readUInt32BE(4);
+        const rootDispersion = buffer.readUInt32BE(8);
+        const referenceId = buffer.readUInt32BE(12);
+        return {
+            header: {
+                leapIndicator,
+                versionNumber,
+                mode,
+                stratum,
+                pollInterval,
+                precision,
+                rootDelay,
+                rootDispersion,
+                referenceId: this.formatReferenceId(referenceId, stratum),
+            },
+            timestamps: {
+                reference: referenceTimestamp,
+                originate: originateTimestamp,
+                receive: receiveTimestamp,
+                transmit: transmitTimestamp,
+            },
+            roundTripDelay: null,
+            clockOffset: null,
+        };
+    }
+    /**
+     * Parse 8-byte NTP timestamp (64-bit fixed-point: 32-bit seconds, 32-bit fraction)
+     */
+    static parseNTPTimestamp(buffer, offset) {
+        const seconds = buffer.readUInt32BE(offset);
+        const fraction = buffer.readUInt32BE(offset + 4);
+        // Convert fraction to milliseconds (32-bit fraction / 2^32 * 1000)
+        const milliseconds = (fraction / 0x100000000) * 1000;
+        // Convert NTP timestamp to Unix timestamp
+        const unixSeconds = seconds - this.NTP_EPOCH_OFFSET;
+        const date = new Date((unixSeconds * 1000) + milliseconds);
+        return {
+            raw: { seconds, fraction },
+            unix: {
+                seconds: unixSeconds,
+                milliseconds,
+            },
+            date,
+            iso: date.toISOString(),
+            local: date.toString(),
+            timestamp: date.getTime(),
+        };
+    }
+    /**
+     * Format reference ID based on stratum
+     */
+    static formatReferenceId(id, stratum) {
+        if (stratum === 0)
+            return 'KISS';
+        if (stratum === 1) {
+            // First 4 bytes are ASCII
+            const bytes = Buffer.alloc(4);
+            bytes.writeUInt32BE(id);
+            return bytes.toString('ascii').replace(/\x00/g, '');
+        }
+        return `0x${id.toString(16).toUpperCase().padStart(8, '0')}`;
+    }
+    /**
+     * Calculate round-trip delay and clock offset
+     */
+    static calculateMetrics(parsed, clientOriginateTime, clientReceiveTime) {
+        const t1 = clientOriginateTime.getTime() / 1000;
+        const t2 = parsed.timestamps.receive.unix.seconds + parsed.timestamps.receive.unix.milliseconds / 1000;
+        const t3 = parsed.timestamps.transmit.unix.seconds + parsed.timestamps.transmit.unix.milliseconds / 1000;
+        const t4 = clientReceiveTime.getTime() / 1000;
+        const roundTripDelay = (t4 - t1) - (t3 - t2);
+        const clockOffset = ((t2 - t1) + (t3 - t4)) / 2;
+        return {
+            roundTripDelay,
+            clockOffset,
+            roundTripDelayMs: roundTripDelay * 1000,
+            clockOffsetMs: clockOffset * 1000,
+        };
+    }
+}
+/**
+ * NTP epoch starts on January 1, 1900
+ * Unix epoch starts on January 1, 1970
+ * The difference is 2,208,988,800 seconds
+ */
+NTPParser.NTP_EPOCH_OFFSET = 2208988800;
+//# sourceMappingURL=parser.js.map

package/dist/core/parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.js","sourceRoot":"","sources":["../../src/core/parser.ts"],"names":[],"mappings":"AAAA;;;GAGG;AA6CH,MAAM,OAAO,SAAS;IAQpB;;;;;;;;;;;;OAYG;IACH,MAAM,CAAC,WAAW,CAAC,MAAc;QAC/B,IAAI,MAAM,CAAC,MAAM,GAAG,EAAE,EAAE,CAAC;YACvB,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAC;QACnE,CAAC;QAED,eAAe;QACf,MAAM,SAAS,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;QAC5B,MAAM,aAAa,GAAG,CAAC,SAAS,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC;QAC9C,MAAM,aAAa,GAAG,CAAC,SAAS,IAAI,CAAC,CAAC,GAAG,KAAK,CAAC;QAC/C,MAAM,IAAI,GAAG,SAAS,GAAG,KAAK,CAAC;QAC/B,MAAM,OAAO,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;QAC1B,MAAM,YAAY,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;QAC/B,MAAM,SAAS,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;QAE5B,mBAAmB;QACnB,MAAM,kBAAkB,GAAG,IAAI,CAAC,iBAAiB,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QAC9D,MAAM,kBAAkB,GAAG,IAAI,CAAC,iBAAiB,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QAC9D,MAAM,gBAAgB,GAAG,IAAI,CAAC,iBAAiB,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QAC5D,MAAM,iBAAiB,GAAG,IAAI,CAAC,iBAAiB,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QAE7D,kCAAkC;QAClC,MAAM,SAAS,GAAG,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QACzC,MAAM,cAAc,GAAG,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QAC9C,MAAM,WAAW,GAAG,MAAM,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC;QAE5C,OAAO;YACL,MAAM,EAAE;gBACN,aAAa;gBACb,aAAa;gBACb,IAAI;gBACJ,OAAO;gBACP,YAAY;gBACZ,SAAS;gBACT,SAAS;gBACT,cAAc;gBACd,WAAW,EAAE,IAAI,CAAC,iBAAiB,CAAC,WAAW,EAAE,OAAO,CAAC;aAC1D;YACD,UAAU,EAAE;gBACV,SAAS,EAAE,kBAAkB;gBAC7B,SAAS,EAAE,kBAAkB;gBAC7B,OAAO,EAAE,gBAAgB;gBACzB,QAAQ,EAAE,iBAAiB;aAC5B;YACD,cAAc,EAAE,IAAI;YACpB,WAAW,EAAE,IAAI;SAClB,CAAC;IACJ,CAAC;IAED;;OAEG;IACK,MAAM,CAAC,iBAAiB,CAAC,MAAc,EAAE,MAAc;QAC7D,MAAM,OAAO,GAAG,MAAM,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;QAC5C,MAAM,QAAQ,GAAG,MAAM,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QAEjD,mEAAmE;QACnE,MAAM,YAAY,GAAG,CAAC,QAAQ,GAAG,WAAW,CAAC,GAAG,IAAI,CAAC;QAErD,0CAA0C;QAC1C,MAAM,WAAW,GAAG,OAAO,GAAG,IAAI,CAAC,gBAAgB,CAAC;QACpD,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,CAAC,WAAW,GAAG,IAAI,CAAC,GAAG,YAAY,CAAC,CAAC;QAE3D,OAAO;YACL,GAAG,EAAE,EAAE,OAAO,EAAE,QAAQ,EAAE;YAC1B,IAAI,EAAE;gBACJ,OAAO,EAAE,WAAW;gBACpB,YAAY;aACb;YACD,IAAI;YACJ,GAAG,EAAE,IAAI,CAAC,WAAW,EAAE;YACvB,KAAK,EAAE,IAAI,CAAC,QAAQ,EAAE;YACtB,SAAS,EAAE,IAAI,CAAC,OAAO,EAAE;SAC1B,CAAC;IACJ,CAAC;IAED;;OAEG;IACK,MAAM,CAAC,iBAAiB,CAAC,EAAU,EAAE,OAAe;QAC1D,IAAI,OAAO,KAAK,CAAC;YAAE,OAAO,MAAM,CAAC;QACjC,IAAI,OAAO,KAAK,CAAC,EAAE,CAAC;YAClB,0BAA0B;YAC1B,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;YAC9B,KAAK,CAAC,aAAa,CAAC,EAAE,CAAC,CAAC;YACxB,OAAO,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QACtD,CAAC;QACD,OAAO,KAAK,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC;IAC/D,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,gBAAgB,CACrB,MAAuB,EACvB,mBAAyB,EACzB,iBAAuB;QAEvB,MAAM,EAAE,GAAG,mBAAmB,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC;QAChD,MAAM,EAAE,GAAG,MAAM,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;QACvG,MAAM,EAAE,GAAG,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;QACzG,MAAM,EAAE,GAAG,iBAAiB,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC;QAE9C,MAAM,cAAc,GAAG,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC;QAC7C,MAAM,WAAW,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC;QAEhD,OAAO;YACL,cAAc;YACd,WAAW;YACX,gBAAgB,EAAE,cAAc,GAAG,IAAI;YACvC,aAAa,EAAE,WAAW,GAAG,IAAI;SAClC,CAAC;IACJ,CAAC;;AAnID;;;;GAIG;AACqB,0BAAgB,GAAG,UAAU,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export { default, NTPClient, NTPParser } from './core/index.js';
+export type { NTPClientConfig, NTPQueryResult } from './core/client.js';
+export type { RawNTPTimestamp, ParsedNTPTimestamp, NTPPacketHeader, NTPTimestamps, ParsedNTPPacket, } from './core/parser.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAChE,YAAY,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACxE,YAAY,EACV,eAAe,EACf,kBAAkB,EAClB,eAAe,EACf,aAAa,EACb,eAAe,GAChB,MAAM,kBAAkB,CAAC"}

package/dist/index.js

@@ -0,0 +1,2 @@
+export { default, NTPClient, NTPParser } from './core/index.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC"}

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "@hixbe/time",
+  "version": "1.0.0",
+  "description": "High-precision NTP time synchronization package with CLI tools",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "hixbe-time": "dist/cli/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "start": "node dist/cli/index.js",
+    "cli": "node dist/cli/index.js",
+    "test": "node --test dist/**/*.test.js",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "ntp",
+    "network-time-protocol",
+    "time",
+    "synchronization",
+    "time-server",
+    "hixbe"
+  ],
+  "author": "Hixbe",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/hixbehq/nodejs-time.git"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "typescript": "^5.0.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  }
+}