two-pack 1.0.0

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export * from "./packet";
+export * from "./packet-buffer";
+export * from "./packet-client";
+export * from "./packet-codec";
+export * from "./packet-registry";
+export * from "./types/packet.types";
+//# 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,cAAc,UAAU,CAAC;AACzB,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC"}

package/dist/index.js

@@ -0,0 +1,22 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./packet"), exports);
+__exportStar(require("./packet-buffer"), exports);
+__exportStar(require("./packet-client"), exports);
+__exportStar(require("./packet-codec"), exports);
+__exportStar(require("./packet-registry"), exports);
+__exportStar(require("./types/packet.types"), exports);

package/dist/packet-buffer.d.ts

@@ -0,0 +1,23 @@
+export declare class PacketWriter {
+    private buffer;
+    private offset;
+    constructor(initialSize?: number);
+    writeInt32(value: number): void;
+    writeString(value: string): void;
+    writeBoolean(value: boolean): void;
+    writeDouble(value: number): void;
+    toBuffer(): Buffer;
+    private ensureCapacity;
+}
+export declare class PacketReader {
+    private readonly buffer;
+    private offset;
+    constructor(buffer: Buffer);
+    readInt32(): number;
+    readString(): string;
+    readBoolean(): boolean;
+    readFloat(): number;
+    readDouble(): number;
+    getRemaining(): number;
+}
+//# sourceMappingURL=packet-buffer.d.ts.map

package/dist/packet-buffer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"packet-buffer.d.ts","sourceRoot":"","sources":["../src/packet-buffer.ts"],"names":[],"mappings":"AAAA,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,MAAM,CAAa;gBAEf,WAAW,GAAE,MAAY;IAIrC,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAM/B,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAQhC,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI;IAMlC,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAMhC,QAAQ,IAAI,MAAM;IAIlB,OAAO,CAAC,cAAc;CAOvB;AAED,qBAAa,YAAY;IAGX,OAAO,CAAC,QAAQ,CAAC,MAAM;IAFnC,OAAO,CAAC,MAAM,CAAa;gBAEE,MAAM,EAAE,MAAM;IAE3C,SAAS,IAAI,MAAM;IAMnB,UAAU,IAAI,MAAM;IAWpB,WAAW,IAAI,OAAO;IAMtB,SAAS,IAAI,MAAM;IAMnB,UAAU,IAAI,MAAM;IAMpB,YAAY,IAAI,MAAM;CAGvB"}

package/dist/packet-buffer.js

@@ -0,0 +1,80 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PacketReader = exports.PacketWriter = void 0;
+class PacketWriter {
+    buffer;
+    offset = 0;
+    constructor(initialSize = 256) {
+        this.buffer = Buffer.alloc(initialSize);
+    }
+    writeInt32(value) {
+        this.ensureCapacity(4);
+        this.buffer.writeInt32BE(value, this.offset);
+        this.offset += 4;
+    }
+    writeString(value) {
+        const encoded = Buffer.from(value, 'utf-8');
+        this.writeInt32(encoded.length);
+        this.ensureCapacity(encoded.length);
+        encoded.copy(this.buffer, this.offset);
+        this.offset += encoded.length;
+    }
+    writeBoolean(value) {
+        this.ensureCapacity(1);
+        this.buffer.writeUInt8(value ? 1 : 0, this.offset);
+        this.offset += 1;
+    }
+    writeDouble(value) {
+        this.ensureCapacity(8);
+        this.buffer.writeDoubleBE(value, this.offset);
+        this.offset += 8;
+    }
+    toBuffer() {
+        return this.buffer.slice(0, this.offset);
+    }
+    ensureCapacity(bytes) {
+        while (this.offset + bytes > this.buffer.length) {
+            const newBuffer = Buffer.alloc(this.buffer.length * 2);
+            this.buffer.copy(newBuffer);
+            this.buffer = newBuffer;
+        }
+    }
+}
+exports.PacketWriter = PacketWriter;
+class PacketReader {
+    buffer;
+    offset = 0;
+    constructor(buffer) {
+        this.buffer = buffer;
+    }
+    readInt32() {
+        const value = this.buffer.readInt32BE(this.offset);
+        this.offset += 4;
+        return value;
+    }
+    readString() {
+        const length = this.readInt32();
+        const value = this.buffer.toString('utf-8', this.offset, this.offset + length);
+        this.offset += length;
+        return value;
+    }
+    readBoolean() {
+        const value = this.buffer.readUInt8(this.offset);
+        this.offset += 1;
+        return value === 1;
+    }
+    readFloat() {
+        const value = this.buffer.readFloatBE(this.offset);
+        this.offset += 4;
+        return value;
+    }
+    readDouble() {
+        const value = this.buffer.readDoubleBE(this.offset);
+        this.offset += 8;
+        return value;
+    }
+    getRemaining() {
+        return this.buffer.length - this.offset;
+    }
+}
+exports.PacketReader = PacketReader;

package/dist/packet-client.d.ts

@@ -0,0 +1,45 @@
+import { Packet } from './packet';
+import { PacketClientCallbacks } from './types/packet.types';
+import { FrameAccumulator } from "./packet-codec";
+import * as tls from "node:tls";
+import { Observable } from "rxjs";
+import { PacketRegistry } from "./packet-registry";
+export interface TLSClientOptions {
+    host: string;
+    port: number;
+    pfx: Buffer;
+    passphrase: string;
+    reconnectDelay?: number;
+    ciphers?: string;
+}
+export declare abstract class PacketClient {
+    private readonly _listeners;
+    private _socket;
+    private readonly _frameAccumulator;
+    private reconnectTimer;
+    private _destroyed;
+    private readonly packetSubject;
+    readonly packets$: Observable<Packet>;
+    private readonly _options;
+    private readonly _registry;
+    protected constructor(_options: TLSClientOptions, _registry: PacketRegistry);
+    get listeners(): Map<PacketClientCallbacks, (...args: any[]) => void>;
+    get socket(): tls.TLSSocket | null;
+    set socket(value: tls.TLSSocket | null);
+    get frameAccumulator(): FrameAccumulator;
+    get destroyed(): boolean;
+    set destroyed(value: boolean);
+    get options(): TLSClientOptions;
+    get registry(): PacketRegistry;
+    get localHost(): string;
+    get remoteHost(): string;
+    get connected(): boolean;
+    send(packet: Packet): void;
+    connect(): void;
+    disconnect(): void;
+    on(event: PacketClientCallbacks, listener: (...args: any[]) => void): this;
+    callback(event: PacketClientCallbacks, ...args: any[]): void;
+    private scheduleReconnect;
+    private clearReconnect;
+}
+//# sourceMappingURL=packet-client.d.ts.map

package/dist/packet-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"packet-client.d.ts","sourceRoot":"","sources":["../src/packet-client.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAA6B,gBAAgB,EAAC,MAAM,gBAAgB,CAAC;AAC5E,OAAO,KAAK,GAAG,MAAM,UAAU,CAAC;AAChC,OAAO,EAAC,UAAU,EAAU,MAAM,MAAM,CAAC;AACzC,OAAO,EAAC,cAAc,EAAC,MAAM,mBAAmB,CAAC;AAEjD,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,8BAAsB,YAAY;IAChC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAGvB;IACJ,OAAO,CAAC,OAAO,CAA8B;IAC7C,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAA0B;IAC5D,OAAO,CAAC,cAAc,CAA8C;IACpE,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAyB;IACvD,QAAQ,CAAC,QAAQ,EAAE,UAAU,CAAC,MAAM,CAAC,CAAqC;IAC1E,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAmB;IAC5C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAiB;IAE3C,SAAS,aAAa,QAAQ,EAAE,gBAAgB,EAAE,SAAS,EAAE,cAAc;IAK3E,IAAI,SAAS,IAAI,GAAG,CAAC,qBAAqB,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,CAAC,CAEpE;IAED,IAAI,MAAM,IAAI,GAAG,CAAC,SAAS,GAAG,IAAI,CAEjC;IAED,IAAI,MAAM,CAAC,KAAK,EAAE,GAAG,CAAC,SAAS,GAAG,IAAI,EAErC;IAED,IAAI,gBAAgB,IAAI,gBAAgB,CAEvC;IAED,IAAI,SAAS,IAAI,OAAO,CAEvB;IAGD,IAAI,SAAS,CAAC,KAAK,EAAE,OAAO,EAE3B;IAED,IAAI,OAAO,IAAI,gBAAgB,CAE9B;IAED,IAAI,QAAQ,IAAI,cAAc,CAE7B;IAED,IAAI,SAAS,IAAI,MAAM,CAEtB;IAED,IAAI,UAAU,IAAI,MAAM,CAEvB;IAED,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAW1B,OAAO,IAAI,IAAI;IA6Cf,UAAU,IAAI,IAAI;IAUlB,EAAE,CACA,KAAK,EAAE,qBAAqB,EAC5B,QAAQ,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,GACjC,IAAI;IAKP,QAAQ,CAAC,KAAK,EAAE,qBAAqB,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI;IAO5D,OAAO,CAAC,iBAAiB;IAWzB,OAAO,CAAC,cAAc;CAMvB"}

package/dist/packet-client.js

@@ -0,0 +1,172 @@
+"use strict";
+/*
+ * Copyright (c) Tristan Landry
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PacketClient = void 0;
+const packet_codec_1 = require("./packet-codec");
+const tls = __importStar(require("node:tls"));
+const rxjs_1 = require("rxjs");
+class PacketClient {
+    _listeners = new Map();
+    _socket = null;
+    _frameAccumulator = new packet_codec_1.FrameAccumulator();
+    reconnectTimer = null;
+    _destroyed = false;
+    packetSubject = new rxjs_1.Subject();
+    packets$ = this.packetSubject.asObservable();
+    _options;
+    _registry;
+    constructor(_options, _registry) {
+        this._options = _options;
+        this._registry = _registry;
+    }
+    get listeners() {
+        return this._listeners;
+    }
+    get socket() {
+        return this._socket;
+    }
+    set socket(value) {
+        this._socket = value;
+    }
+    get frameAccumulator() {
+        return this._frameAccumulator;
+    }
+    get destroyed() {
+        return this._destroyed;
+    }
+    set destroyed(value) {
+        this._destroyed = value;
+    }
+    get options() {
+        return this._options;
+    }
+    get registry() {
+        return this._registry;
+    }
+    get localHost() {
+        return this.socket?.localAddress || 'unknown';
+    }
+    get remoteHost() {
+        return this.socket?.remoteAddress || 'unknown';
+    }
+    get connected() {
+        return !!this.socket && !this.socket.destroyed;
+    }
+    send(packet) {
+        if (!this.socket || this.socket.destroyed) {
+            console.error('Socket is not connected');
+            return;
+        }
+        const frame = (0, packet_codec_1.encodePacket)(packet);
+        this.socket.write(frame);
+        this.callback("packetSent", packet);
+    }
+    connect() {
+        this.destroyed = false;
+        if (this.destroyed)
+            return;
+        const { host, port, pfx, ciphers, passphrase } = this.options;
+        this.socket = tls.connect({
+            host,
+            port,
+            pfx,
+            passphrase,
+            ciphers,
+            minVersion: 'TLSv1.2',
+            rejectUnauthorized: false,
+        }, () => {
+            this.callback("connected", this);
+        });
+        this.socket.on('data', (chunk) => {
+            const frames = this.frameAccumulator.push(chunk);
+            for (const frame of frames) {
+                try {
+                    const packet = (0, packet_codec_1.decodePacket)(frame, this.registry);
+                    if (packet) {
+                        this.packetSubject.next(packet);
+                    }
+                }
+                catch (err) {
+                    console.error('Error decoding packet:', err instanceof Error ? err.message : err);
+                }
+            }
+        });
+        this.socket.on('error', (err) => {
+            console.error('Socket error:', err.message);
+        });
+        this.socket.on('close', () => {
+            console.warn('Socket closed');
+            this.frameAccumulator.reset();
+            this.scheduleReconnect();
+        });
+    }
+    disconnect() {
+        this.destroyed = true;
+        this.clearReconnect();
+        this.socket?.destroy();
+        this.socket = null;
+        this.frameAccumulator.reset();
+        this.callback("disconnected", this);
+    }
+    on(event, listener) {
+        this.listeners.set(event, listener);
+        return this;
+    }
+    callback(event, ...args) {
+        const listener = this.listeners.get(event);
+        if (listener) {
+            listener(...args);
+        }
+    }
+    scheduleReconnect() {
+        if (this.destroyed)
+            return;
+        const delay = this.options.reconnectDelay ?? 5_000;
+        console.log(`Reconnecting in ${delay}ms...`);
+        this.reconnectTimer = setTimeout(() => {
+            this.connect();
+        }, delay);
+    }
+    clearReconnect() {
+        if (this.reconnectTimer) {
+            clearTimeout(this.reconnectTimer);
+            this.reconnectTimer = null;
+        }
+    }
+}
+exports.PacketClient = PacketClient;

package/dist/packet-codec.d.ts

@@ -0,0 +1,10 @@
+import { Packet } from './packet';
+import { PacketRegistry } from './packet-registry';
+export declare function encodePacket(packet: Packet): Buffer;
+export declare function decodePacket(data: Buffer, registry: PacketRegistry): Packet | undefined;
+export declare class FrameAccumulator {
+    private buffer;
+    push(chunk: Buffer): Buffer[];
+    reset(): void;
+}
+//# sourceMappingURL=packet-codec.d.ts.map

package/dist/packet-codec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"packet-codec.d.ts","sourceRoot":"","sources":["../src/packet-codec.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAInD,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAYnD;AAED,wBAAgB,YAAY,CAC1B,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,cAAc,GACvB,MAAM,GAAG,SAAS,CAYpB;AAED,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,MAAM,CAA2B;IAEzC,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE;IAoB7B,KAAK,IAAI,IAAI;CAGd"}

package/dist/packet-codec.js

@@ -0,0 +1,50 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FrameAccumulator = void 0;
+exports.encodePacket = encodePacket;
+exports.decodePacket = decodePacket;
+const common_1 = require("@nestjs/common");
+const packet_buffer_1 = require("./packet-buffer");
+const logger = new common_1.Logger('PacketCodec');
+function encodePacket(packet) {
+    const writer = new packet_buffer_1.PacketWriter();
+    writer.writeString(packet.packetName);
+    packet.write(writer);
+    const body = writer.toBuffer();
+    const frame = Buffer.alloc(4 + body.length);
+    frame.writeInt32BE(body.length, 0);
+    body.copy(frame, 4);
+    return frame;
+}
+function decodePacket(data, registry) {
+    const reader = new packet_buffer_1.PacketReader(data);
+    const packetName = reader.readString();
+    const packet = registry.create(packetName);
+    if (!packet) {
+        logger.warn(`Unknown packet received: ${packetName}`);
+        return undefined;
+    }
+    packet.read(reader);
+    return packet;
+}
+class FrameAccumulator {
+    buffer = Buffer.alloc(0);
+    push(chunk) {
+        this.buffer = Buffer.concat([this.buffer, chunk]);
+        const frames = [];
+        while (this.buffer.length >= 4) {
+            const bodyLength = this.buffer.readInt32BE(0);
+            if (this.buffer.length < 4 + bodyLength) {
+                break;
+            }
+            const body = this.buffer.subarray(4, 4 + bodyLength);
+            frames.push(body);
+            this.buffer = this.buffer.subarray(4 + bodyLength);
+        }
+        return frames;
+    }
+    reset() {
+        this.buffer = Buffer.alloc(0);
+    }
+}
+exports.FrameAccumulator = FrameAccumulator;

package/dist/packet-registry.d.ts

@@ -0,0 +1,11 @@
+import { Packet } from './packet';
+type PacketConstructor = new () => Packet;
+export declare class PacketRegistry {
+    private readonly packets;
+    register(packetClass: PacketConstructor): void;
+    get(name: string): PacketConstructor | undefined;
+    create(name: string): Packet | undefined;
+    has(name: string): boolean;
+}
+export {};
+//# sourceMappingURL=packet-registry.d.ts.map

package/dist/packet-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"packet-registry.d.ts","sourceRoot":"","sources":["../src/packet-registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAElC,KAAK,iBAAiB,GAAG,UAAU,MAAM,CAAC;AAE1C,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAwC;IAEhE,QAAQ,CAAC,WAAW,EAAE,iBAAiB,GAAG,IAAI;IAM9C,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS;IAIhD,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAKxC,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;CAG3B"}

package/dist/packet-registry.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PacketRegistry = void 0;
+class PacketRegistry {
+    packets = new Map();
+    register(packetClass) {
+        const instance = new packetClass();
+        const name = instance.packetName;
+        this.packets.set(name, packetClass);
+    }
+    get(name) {
+        return this.packets.get(name.toLowerCase());
+    }
+    create(name) {
+        const ctor = this.get(name);
+        return ctor ? new ctor() : undefined;
+    }
+    has(name) {
+        return this.packets.has(name.toLowerCase());
+    }
+}
+exports.PacketRegistry = PacketRegistry;

package/dist/packet.d.ts

@@ -0,0 +1,23 @@
+import { PacketReader, PacketWriter } from './packet-buffer';
+import { PacketClient } from './packet-client';
+import { Logger } from '@nestjs/common';
+/**
+ * Abstract base class for all packets.
+ *
+ * Naming convention (informational only, both sides use this same class):
+ *   - SPacket* = server-side (sent FROM server)
+ *   - CPacket* = client-side (sent FROM client)
+ *
+ * Packets are matched by their lowercase name without the S/C prefix:
+ *   SPacketKiosks -> "packetkiosks"
+ *   CPacketKiosks -> "packetkiosks"
+ */
+export declare abstract class Packet {
+    readonly logger: Logger;
+    get packetName(): string;
+    log(...args: any[]): void;
+    abstract read(reader: PacketReader): void;
+    abstract write(writer: PacketWriter): void;
+    abstract handle(client: PacketClient): void;
+}
+//# sourceMappingURL=packet.d.ts.map

package/dist/packet.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"packet.d.ts","sourceRoot":"","sources":["../src/packet.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAExC;;;;;;;;;;GAUG;AACH,8BAAsB,MAAM;IACxB,QAAQ,CAAC,MAAM,SAAkD;IAGjE,IAAI,UAAU,IAAI,MAAM,CAIvB;IAED,GAAG,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE;IAOlB,QAAQ,CAAC,IAAI,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI;IAEzC,QAAQ,CAAC,KAAK,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI;IAE1C,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI;CAC9C"}

package/dist/packet.js

@@ -0,0 +1,32 @@
+"use strict";
+/*
+ * Copyright (c) Tristan Landry
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Packet = void 0;
+const common_1 = require("@nestjs/common");
+/**
+ * Abstract base class for all packets.
+ *
+ * Naming convention (informational only, both sides use this same class):
+ *   - SPacket* = server-side (sent FROM server)
+ *   - CPacket* = client-side (sent FROM client)
+ *
+ * Packets are matched by their lowercase name without the S/C prefix:
+ *   SPacketKiosks -> "packetkiosks"
+ *   CPacketKiosks -> "packetkiosks"
+ */
+class Packet {
+    logger = new common_1.Logger(this.constructor.name.substring(1));
+    // Strip the S/C prefix: "SPacketKiosks" -> "PacketKiosks" -> "packetkiosks"
+    get packetName() {
+        const className = this.constructor.name;
+        const stripped = className.replace(/^[SC](?=Packet)/i, '');
+        return stripped.toLowerCase();
+    }
+    log(...args) {
+        this.logger.verbose((this.constructor.name.startsWith('S') ? '[CLIENT] ' : '[SERVER] ') +
+            args);
+    }
+}
+exports.Packet = Packet;

package/dist/types/packet.types.d.ts

@@ -0,0 +1,8 @@
+export declare const PACKET_CLIENT_CALLBACKS: {
+    readonly packetSent: "packetSent";
+    readonly packetReceived: "packetReceived";
+    readonly connected: "connected";
+    readonly disconnected: "disconnected";
+};
+export type PacketClientCallbacks = (typeof PACKET_CLIENT_CALLBACKS)[keyof typeof PACKET_CLIENT_CALLBACKS];
+//# sourceMappingURL=packet.types.d.ts.map

package/dist/types/packet.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"packet.types.d.ts","sourceRoot":"","sources":["../../src/types/packet.types.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,uBAAuB;;;;;CAK1B,CAAC;AAEX,MAAM,MAAM,qBAAqB,GAC/B,CAAC,OAAO,uBAAuB,CAAC,CAAC,MAAM,OAAO,uBAAuB,CAAC,CAAC"}

package/dist/types/packet.types.js

@@ -0,0 +1,12 @@
+"use strict";
+/*
+ * Copyright (c) Tristan Landry
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PACKET_CLIENT_CALLBACKS = void 0;
+exports.PACKET_CLIENT_CALLBACKS = {
+    packetSent: 'packetSent',
+    packetReceived: 'packetReceived',
+    connected: 'connected',
+    disconnected: 'disconnected',
+};

package/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "two-pack",
+  "version": "1.0.0",
+  "description": "Original: TwoPack (Java) Library rewritten using TypeScript/JavaScript.",
+  "author": "Tristan Landry",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./src": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc"
+  },
+  "dependencies": {
+    "rxjs": "^7.8.2"
+  },
+  "devDependencies": {
+    "@nestjs/common": "^11.1.19",
+    "@types/node": "^25.6.0",
+    "node": "^25.9.0",
+    "typescript": "^5.5.3"
+  },
+  "private": false
+}