traktor-connect 1.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Christopher Le
+
+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,70 @@
+# traktor-connect
+
+Library to receive track metadata from Traktor Pro via OGG Vorbis broadcast.
+
+## Installation
+
+```bash
+npm install traktor-connect
+```
+
+## Usage
+
+```typescript
+import { TraktorConnect } from 'traktor-connect';
+
+const traktor = new TraktorConnect({ port: 8000 });
+
+traktor.on('track', (data) => {
+  console.log(`Now playing: ${data.artist} - ${data.title}`);
+});
+
+traktor.on('connected', () => {
+  console.log('Traktor connected');
+});
+
+traktor.on('disconnected', () => {
+  console.log('Traktor disconnected');
+});
+
+await traktor.start();
+```
+
+## Traktor Configuration
+
+1. Open Traktor Pro preferences
+2. Go to **Broadcasting** section
+3. Set **Server** to your machine's IP address
+4. Set **Port** to `8000` (or your custom port)
+5. Set **Format** to **Ogg Vorbis**
+6. Enable broadcasting
+
+## API
+
+### `new TraktorConnect(options?)`
+
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `port` | `number` | `8000` | TCP port to listen on |
+| `skipFirstTrack` | `boolean` | `true` | Skip the first track (Traktor sends current track on connect) |
+| `logger` | `Logger` | `noopLogger` | Logger implementation |
+
+### Events
+
+| Event | Payload | Description |
+|-------|---------|-------------|
+| `track` | `TraktorTrackData` | New track detected |
+| `connected` | - | Traktor connected to the server |
+| `disconnected` | - | Traktor disconnected |
+| `ready` | - | Server is listening |
+| `error` | `Error` | An error occurred |
+
+### Methods
+
+- `start(): Promise<void>` - Start the TCP server
+- `stop(): Promise<void>` - Stop the server and clean up
+- `configure(options): Promise<void>` - Update configuration at runtime
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * traktor-connect - Receive track metadata from Traktor Pro via OGG Vorbis broadcast.
+ *
+ * @module traktor-connect
+ */
+export { TraktorConnect } from './traktor-connect.js';
+export { OggDecoder } from './ogg-decoder.js';
+export { VorbisDecoder } from './vorbis-decoder.js';
+export { noopLogger } from './types.js';
+export type { TraktorConnectOptions, TraktorTrackData, TraktorConnectEvents, Logger, } from './types.js';

package/dist/index.js

@@ -0,0 +1,17 @@
+"use strict";
+/**
+ * traktor-connect - Receive track metadata from Traktor Pro via OGG Vorbis broadcast.
+ *
+ * @module traktor-connect
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.noopLogger = exports.VorbisDecoder = exports.OggDecoder = exports.TraktorConnect = void 0;
+var traktor_connect_js_1 = require("./traktor-connect.js");
+Object.defineProperty(exports, "TraktorConnect", { enumerable: true, get: function () { return traktor_connect_js_1.TraktorConnect; } });
+var ogg_decoder_js_1 = require("./ogg-decoder.js");
+Object.defineProperty(exports, "OggDecoder", { enumerable: true, get: function () { return ogg_decoder_js_1.OggDecoder; } });
+var vorbis_decoder_js_1 = require("./vorbis-decoder.js");
+Object.defineProperty(exports, "VorbisDecoder", { enumerable: true, get: function () { return vorbis_decoder_js_1.VorbisDecoder; } });
+var types_js_1 = require("./types.js");
+Object.defineProperty(exports, "noopLogger", { enumerable: true, get: function () { return types_js_1.noopLogger; } });
+//# 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;;;;GAIG;;;AAEH,2DAAsD;AAA7C,oHAAA,cAAc,OAAA;AACvB,mDAA8C;AAArC,4GAAA,UAAU,OAAA;AACnB,yDAAoD;AAA3C,kHAAA,aAAa,OAAA;AACtB,uCAAwC;AAA/B,sGAAA,UAAU,OAAA"}

package/dist/ogg-decoder.d.ts

@@ -0,0 +1,18 @@
+/**
+ * @fileoverview OGG container decoder - extracts pages from an OGG stream.
+ * Parses the OGG page structure and emits raw page data.
+ */
+import { Transform } from 'stream';
+/**
+ * OGG container decoder.
+ * Transforms an OGG byte stream into individual page payloads.
+ * Emits 'page' events with stream serial number and page sequence number.
+ */
+export declare class OggDecoder extends Transform {
+    private bufferPos;
+    private pageBuffer;
+    _transform(chunk: Buffer, _encoding: string, callback: () => void): void;
+    private dataLength;
+    private pageLength;
+    private parseHeader;
+}

package/dist/ogg-decoder.js

@@ -0,0 +1,64 @@
+"use strict";
+/**
+ * @fileoverview OGG container decoder - extracts pages from an OGG stream.
+ * Parses the OGG page structure and emits raw page data.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OggDecoder = void 0;
+const stream_1 = require("stream");
+/**
+ * OGG container decoder.
+ * Transforms an OGG byte stream into individual page payloads.
+ * Emits 'page' events with stream serial number and page sequence number.
+ */
+class OggDecoder extends stream_1.Transform {
+    constructor() {
+        super(...arguments);
+        this.bufferPos = 0;
+        this.pageBuffer = Buffer.alloc(131072, 0);
+    }
+    _transform(chunk, _encoding, callback) {
+        const copied = chunk.copy(this.pageBuffer, this.bufferPos);
+        this.bufferPos += copied;
+        let capturePatternPos = this.pageBuffer.indexOf('OggS');
+        while (capturePatternPos !== -1) {
+            const header = this.parseHeader(capturePatternPos);
+            if (header && this.bufferPos >= capturePatternPos + this.pageLength(header)) {
+                const packetFragmentLength = this.dataLength(header);
+                const packetFragmentStart = capturePatternPos + 27 + header.pageSegments;
+                const page = Buffer.alloc(packetFragmentLength);
+                this.pageBuffer.copy(page, 0, packetFragmentStart, packetFragmentStart + packetFragmentLength);
+                this.emit('page', { stream: header.streamSerialNumber, page: header.pageSequenceNumber });
+                this.push(page);
+                this.pageBuffer.copy(this.pageBuffer, 0, packetFragmentStart + packetFragmentLength);
+                this.pageBuffer.fill(0, this.pageBuffer.length - (packetFragmentStart + packetFragmentLength));
+                this.bufferPos -= packetFragmentStart + packetFragmentLength;
+                capturePatternPos = this.pageBuffer.indexOf('OggS');
+            }
+            else {
+                break;
+            }
+        }
+        callback();
+    }
+    dataLength(header) {
+        return header.segmentTable.reduce((a, b) => a + b, 0);
+    }
+    pageLength(header) {
+        return 27 + header.pageSegments + this.dataLength(header);
+    }
+    parseHeader(position) {
+        const streamStructureVersion = this.pageBuffer.readUInt8(position + 4);
+        if (streamStructureVersion !== 0) {
+            return null;
+        }
+        const streamSerialNumber = this.pageBuffer.readUInt32LE(position + 14);
+        const pageSequenceNumber = this.pageBuffer.readUInt32LE(position + 18);
+        const pageSegments = this.pageBuffer.readUInt8(position + 26);
+        const segmentTable = new Uint8Array(pageSegments);
+        this.pageBuffer.copy(segmentTable, 0, position + 27, position + 27 + pageSegments);
+        return { streamSerialNumber, pageSequenceNumber, pageSegments, segmentTable };
+    }
+}
+exports.OggDecoder = OggDecoder;
+//# sourceMappingURL=ogg-decoder.js.map

package/dist/ogg-decoder.js.map

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

package/dist/traktor-connect.d.ts

@@ -0,0 +1,54 @@
+/**
+ * @fileoverview TraktorConnect - receives track metadata from Traktor Pro
+ * via OGG Vorbis broadcast over TCP.
+ *
+ * Traktor Pro can be configured to broadcast its output as an OGG Vorbis stream.
+ * This class creates a TCP server that Traktor connects to, decodes the stream,
+ * and emits track metadata events.
+ */
+import { EventEmitter } from 'events';
+import type { TraktorConnectOptions } from './types.js';
+/**
+ * TraktorConnect creates a TCP server that receives OGG Vorbis broadcast
+ * streams from Traktor Pro and extracts track metadata.
+ *
+ * @example
+ * ```ts
+ * const traktor = new TraktorConnect({ port: 8000 });
+ *
+ * traktor.on('track', (data) => {
+ *   console.log(`Now playing: ${data.artist} - ${data.title}`);
+ * });
+ *
+ * await traktor.start();
+ * ```
+ */
+export declare class TraktorConnect extends EventEmitter {
+    private _port;
+    private skipFirstTrack;
+    private log;
+    private server;
+    private lastTrackHash;
+    private connectedClients;
+    constructor(options?: TraktorConnectOptions);
+    /** The port the server is configured to listen on */
+    get port(): number;
+    /**
+     * Start the TCP server and begin listening for Traktor connections.
+     */
+    start(): Promise<void>;
+    /**
+     * Stop the TCP server and clean up all connections.
+     */
+    stop(): Promise<void>;
+    /**
+     * Update the port at runtime. If the server is running, it will be
+     * restarted on the new port.
+     */
+    configure(options: {
+        port?: number;
+    }): Promise<void>;
+    private handleTrackData;
+    private createOggVorbisHandler;
+    private createTcpServer;
+}

package/dist/traktor-connect.js

@@ -0,0 +1,186 @@
+"use strict";
+/**
+ * @fileoverview TraktorConnect - receives track metadata from Traktor Pro
+ * via OGG Vorbis broadcast over TCP.
+ *
+ * Traktor Pro can be configured to broadcast its output as an OGG Vorbis stream.
+ * This class creates a TCP server that Traktor connects to, decodes the stream,
+ * and emits track metadata events.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TraktorConnect = void 0;
+const events_1 = require("events");
+const crypto_1 = require("crypto");
+const net_1 = require("net");
+const ogg_decoder_js_1 = require("./ogg-decoder.js");
+const vorbis_decoder_js_1 = require("./vorbis-decoder.js");
+const types_js_1 = require("./types.js");
+/**
+ * TraktorConnect creates a TCP server that receives OGG Vorbis broadcast
+ * streams from Traktor Pro and extracts track metadata.
+ *
+ * @example
+ * ```ts
+ * const traktor = new TraktorConnect({ port: 8000 });
+ *
+ * traktor.on('track', (data) => {
+ *   console.log(`Now playing: ${data.artist} - ${data.title}`);
+ * });
+ *
+ * await traktor.start();
+ * ```
+ */
+class TraktorConnect extends events_1.EventEmitter {
+    constructor(options = {}) {
+        super();
+        this.server = null;
+        this.lastTrackHash = '';
+        this.connectedClients = new Set();
+        this._port = options.port ?? 8000;
+        this.skipFirstTrack = options.skipFirstTrack ?? true;
+        this.log = options.logger ?? types_js_1.noopLogger;
+    }
+    /** The port the server is configured to listen on */
+    get port() {
+        return this._port;
+    }
+    /**
+     * Start the TCP server and begin listening for Traktor connections.
+     */
+    async start() {
+        if (this.server) {
+            return;
+        }
+        this.log.debug('Starting TraktorConnect...');
+        this.server = this.createTcpServer();
+        await new Promise((resolve, reject) => {
+            this.server.once('error', reject);
+            this.server.listen(this._port, () => {
+                this.server.removeListener('error', reject);
+                resolve();
+            });
+        });
+        this.log.info(`Listening for Traktor on port ${this._port}`);
+        this.emit('ready');
+    }
+    /**
+     * Stop the TCP server and clean up all connections.
+     */
+    async stop() {
+        this.log.debug('Stopping TraktorConnect...');
+        for (const client of this.connectedClients) {
+            client.destroy();
+        }
+        this.connectedClients.clear();
+        if (this.server) {
+            await new Promise((resolve) => {
+                this.server.close(() => resolve());
+            });
+            this.server = null;
+        }
+        this.lastTrackHash = '';
+        this.log.debug('TraktorConnect stopped');
+    }
+    /**
+     * Update the port at runtime. If the server is running, it will be
+     * restarted on the new port.
+     */
+    async configure(options) {
+        if (options.port !== undefined && options.port !== this._port) {
+            this._port = options.port;
+            if (this.server) {
+                await this.stop();
+                await this.start();
+            }
+        }
+    }
+    // ---------------------------------------------------------------------------
+    // Private
+    // ---------------------------------------------------------------------------
+    handleTrackData(data) {
+        if (!data.artist && !data.title) {
+            return;
+        }
+        const trackHash = (0, crypto_1.createHash)('md5')
+            .update(`${data.artist}${data.title}`)
+            .digest('hex');
+        if (trackHash === this.lastTrackHash) {
+            return;
+        }
+        // Skip first track if configured (store hash but don't emit)
+        if (this.skipFirstTrack && !this.lastTrackHash) {
+            this.lastTrackHash = trackHash;
+            return;
+        }
+        this.lastTrackHash = trackHash;
+        this.log.debug(`New track: ${data.artist} - ${data.title}`);
+        this.emit('track', data);
+    }
+    createOggVorbisHandler() {
+        const createVorbisDecoder = () => {
+            const decoder = new vorbis_decoder_js_1.VorbisDecoder();
+            decoder.on('track', (data) => this.handleTrackData(data));
+            return decoder;
+        };
+        const oggDecoder = new ogg_decoder_js_1.OggDecoder();
+        let vorbisDecoder = createVorbisDecoder();
+        let lastOggStream = null;
+        oggDecoder.on('page', (page) => {
+            if (page.stream !== lastOggStream) {
+                lastOggStream = page.stream;
+                oggDecoder.unpipe(vorbisDecoder);
+                vorbisDecoder = createVorbisDecoder();
+                oggDecoder.pipe(vorbisDecoder);
+            }
+        });
+        return oggDecoder;
+    }
+    createTcpServer() {
+        const server = (0, net_1.createServer)((socket) => {
+            this.log.info('Traktor connected');
+            this.connectedClients.add(socket);
+            this.emit('connected');
+            const dataBuffer = Buffer.alloc(65536);
+            let dataBufferIndex = 0;
+            let headerComplete = false;
+            const oggDecoder = this.createOggVorbisHandler();
+            const linebreak = Buffer.from([13, 10]);
+            socket.on('data', (data) => {
+                const copied = data.copy(dataBuffer, dataBufferIndex);
+                dataBufferIndex += copied;
+                if (!headerComplete) {
+                    let offset;
+                    while ((offset = dataBuffer.indexOf(linebreak)) !== -1) {
+                        const headerLine = dataBuffer.subarray(0, offset);
+                        if (headerLine.length === 0) {
+                            headerComplete = true;
+                            socket.write('HTTP/1.0 200 OK\r\n\r\n');
+                            socket.pipe(oggDecoder);
+                        }
+                        dataBuffer.copy(dataBuffer, 0, offset + 2);
+                        dataBufferIndex -= offset + 2;
+                    }
+                }
+            });
+            socket.on('end', () => {
+                this.log.info('Traktor ending connection');
+                this.connectedClients.delete(socket);
+            });
+            socket.on('close', () => {
+                this.log.info('Traktor disconnected');
+                this.connectedClients.delete(socket);
+                this.emit('disconnected');
+            });
+            socket.on('error', (error) => {
+                this.log.error('Socket error:', error.message);
+                this.connectedClients.delete(socket);
+            });
+        });
+        server.on('error', (error) => {
+            this.emit('error', error);
+        });
+        return server;
+    }
+}
+exports.TraktorConnect = TraktorConnect;
+//# sourceMappingURL=traktor-connect.js.map

package/dist/traktor-connect.js.map

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

package/dist/tsconfig.tsbuildinfo

@@ -0,0 +1 @@
+{"root":["../src/index.ts","../src/ogg-decoder.ts","../src/traktor-connect.ts","../src/types.ts","../src/vorbis-decoder.ts"],"version":"5.9.3"}

package/dist/types.d.ts

@@ -0,0 +1,31 @@
+/**
+ * @fileoverview Types for traktor-connect.
+ */
+export interface TraktorConnectOptions {
+    /** TCP port to listen on for Traktor broadcast connections (default: 8000) */
+    port?: number;
+    /** Whether to skip emitting the first track (Traktor sends current track on connect) (default: true) */
+    skipFirstTrack?: boolean;
+    /** Logger implementation (default: noopLogger) */
+    logger?: Logger;
+}
+export interface TraktorTrackData {
+    artist: string;
+    title: string;
+    encoder?: string;
+}
+export interface TraktorConnectEvents {
+    track: (data: TraktorTrackData) => void;
+    connected: () => void;
+    disconnected: () => void;
+    error: (error: Error) => void;
+    ready: () => void;
+}
+export interface Logger {
+    trace(msg: string, ...args: unknown[]): void;
+    debug(msg: string, ...args: unknown[]): void;
+    info(msg: string, ...args: unknown[]): void;
+    warn(msg: string, ...args: unknown[]): void;
+    error(msg: string, ...args: unknown[]): void;
+}
+export declare const noopLogger: Logger;

package/dist/types.js

@@ -0,0 +1,14 @@
+"use strict";
+/**
+ * @fileoverview Types for traktor-connect.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.noopLogger = void 0;
+exports.noopLogger = {
+    trace() { },
+    debug() { },
+    info() { },
+    warn() { },
+    error() { },
+};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAiCU,QAAA,UAAU,GAAW;IAChC,KAAK,KAAI,CAAC;IACV,KAAK,KAAI,CAAC;IACV,IAAI,KAAI,CAAC;IACT,IAAI,KAAI,CAAC;IACT,KAAK,KAAI,CAAC;CACX,CAAC"}

package/dist/vorbis-decoder.d.ts

@@ -0,0 +1,17 @@
+/**
+ * @fileoverview Vorbis comment decoder - extracts metadata from a Vorbis stream.
+ * Parses Vorbis identification and comment headers to extract track metadata.
+ */
+import { Writable } from 'stream';
+/**
+ * Vorbis comment decoder.
+ * Accepts OGG page payloads and extracts Vorbis comment metadata.
+ * Emits 'track' events with parsed TraktorTrackData.
+ */
+export declare class VorbisDecoder extends Writable {
+    private currentStep;
+    private buffer;
+    private bufferPos;
+    _write(chunk: Buffer, _encoding: string, callback: (error?: Error | null) => void): void;
+    private readVorbisComment;
+}

package/dist/vorbis-decoder.js

@@ -0,0 +1,91 @@
+"use strict";
+/**
+ * @fileoverview Vorbis comment decoder - extracts metadata from a Vorbis stream.
+ * Parses Vorbis identification and comment headers to extract track metadata.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VorbisDecoder = void 0;
+const stream_1 = require("stream");
+/**
+ * Vorbis comment decoder.
+ * Accepts OGG page payloads and extracts Vorbis comment metadata.
+ * Emits 'track' events with parsed TraktorTrackData.
+ */
+class VorbisDecoder extends stream_1.Writable {
+    constructor() {
+        super(...arguments);
+        this.currentStep = 0;
+        this.buffer = Buffer.alloc(131072, 0);
+        this.bufferPos = 0;
+    }
+    _write(chunk, _encoding, callback) {
+        if (this.currentStep < 2) {
+            chunk.copy(this.buffer, this.bufferPos);
+            this.bufferPos += chunk.length;
+        }
+        if (this.currentStep === 0 && this.bufferPos >= 30) {
+            if (this.buffer.readUInt8(0) !== 1) {
+                callback(new Error('Expected header 1'));
+                return;
+            }
+            this.currentStep = 1;
+            this.buffer.copy(this.buffer, 0, 30, this.buffer.length - 30);
+            this.bufferPos -= 30;
+        }
+        else {
+            const comments = this.readVorbisComment();
+            if (comments) {
+                this.emit('track', parseComments(comments));
+                this.currentStep = 2;
+            }
+        }
+        callback();
+    }
+    readVorbisComment() {
+        try {
+            const vendorLength = this.buffer.readUInt32LE(7);
+            const userCommentListLength = this.buffer.readUInt32LE(11 + vendorLength);
+            const userComments = [];
+            let currentPos = 15 + vendorLength;
+            for (let i = 0; i < userCommentListLength; i++) {
+                const commentLength = this.buffer.readUInt32LE(currentPos);
+                const comment = this.buffer.toString('utf-8', currentPos + 4, currentPos + 4 + commentLength);
+                userComments.push(comment);
+                currentPos += 4 + commentLength;
+            }
+            if (currentPos > this.bufferPos) {
+                return null;
+            }
+            const framingBit = this.buffer.readUInt8(currentPos);
+            if (framingBit !== 1) {
+                return null;
+            }
+            if (this.buffer.readUInt8(0) !== 3 || this.buffer.toString('utf-8', 1, 7) !== 'vorbis') {
+                return null;
+            }
+            return userComments;
+        }
+        catch {
+            return null;
+        }
+    }
+}
+exports.VorbisDecoder = VorbisDecoder;
+/**
+ * Parse Vorbis comments into track data object
+ */
+function parseComments(comments) {
+    const result = {};
+    for (const comment of comments) {
+        const [key, ...valueParts] = comment.split('=');
+        if (key) {
+            result[key.toLowerCase()] = valueParts.join('=');
+        }
+    }
+    return {
+        encoder: result.encoder,
+        artist: result.artist || '',
+        title: result.title || '',
+    };
+}
+//# sourceMappingURL=vorbis-decoder.js.map

package/dist/vorbis-decoder.js.map

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

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "traktor-connect",
+  "version": "1.1.0",
+  "description": "Library to receive track metadata from Traktor Pro via OGG Vorbis broadcast",
+  "license": "MIT",
+  "private": false,
+  "type": "commonjs",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "build": "tsc --build tsconfig.json",
+    "watch": "tsc --build tsconfig.json -w",
+    "clean": "rm -rf dist",
+    "prepublishOnly": "npm run clean && npm run build && npm test",
+    "release": "node .github/release.js",
+    "release:patch": "node .github/release.js --patch",
+    "release:major": "node .github/release.js --major"
+  },
+  "engines": {
+    "node": ">=22.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.15.29",
+    "typescript": "^5.9.3",
+    "vitest": "^4.0.16"
+  }
+}