first commit

This commit is contained in:
dahyeon committed 2026-02-02 19:14:07 -08:00
commit b6256abbfb
397 files changed
+537630

No files matched your search

+2
View File
@@ -0,0 +1,2 @@
export { buildLocoPacket, parseLocoPacket, buildEncryptedPacket, parseEncryptedPacket, buildPlainPacket, buildHandshakePacket, isHandshakePacket, PacketReader, PlainPacketReader, } from "./packet.js";
//# sourceMappingURL=index.d.ts.map
+1
View File
@@ -0,0 +1 @@
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/protocol/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EACf,eAAe,EACf,oBAAoB,EACpB,oBAAoB,EACpB,gBAAgB,EAChB,oBAAoB,EACpB,iBAAiB,EACjB,YAAY,EACZ,iBAAiB,GAClB,MAAM,aAAa,CAAC"}
+2
View File
@@ -0,0 +1,2 @@
export { buildLocoPacket, parseLocoPacket, buildEncryptedPacket, parseEncryptedPacket, buildPlainPacket, buildHandshakePacket, isHandshakePacket, PacketReader, PlainPacketReader, } from "./packet.js";
//# sourceMappingURL=index.js.map
+1
View File
@@ -0,0 +1 @@
{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/protocol/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EACf,eAAe,EACf,oBAAoB,EACpB,oBAAoB,EACpB,gBAAgB,EAChB,oBAAoB,EACpB,iBAAiB,EACjB,YAAY,EACZ,iBAAiB,GAClB,MAAM,aAAa,CAAC"}
+38
View File
@@ -0,0 +1,38 @@
import { type LocoPacketHeader, type LocoCommand } from "../types/index.js";
export declare function buildLocoPacket(id: number, command: LocoCommand, statusCode: number, body: Record<string, unknown>): Buffer;
export declare function parseLocoPacket(data: Buffer): {
header: LocoPacketHeader;
body: Record<string, unknown>;
} | null;
export declare function buildEncryptedPacket(locoPacket: Buffer, aesKey: Buffer): Buffer;
export declare function parseEncryptedPacket(data: Buffer, aesKey: Buffer): {
decrypted: Buffer;
consumed: number;
} | null;
export declare function buildHandshakePacket(aesKey: Buffer, serverPublicKeyPem: string): Buffer;
export declare function isHandshakePacket(data: Buffer): boolean;
/**
* In plaintext mode (over TLS), LOCO packets are sent raw — no length prefix.
* The packet itself contains bodyLength at offset 18, so we can frame it.
*/
export declare function buildPlainPacket(locoPacket: Buffer): Buffer;
export declare class PlainPacketReader {
private buffer;
/** Append incoming data and yield all complete parsed packets.
* Framing: read LOCO header (22 bytes), then bodyLength bytes. */
feed(chunk: Buffer): Array<{
header: LocoPacketHeader;
body: Record<string, unknown>;
}>;
}
export declare class PacketReader {
private buffer;
private aesKey;
constructor(aesKey: Buffer);
/** Append incoming data and yield all complete parsed packets. */
feed(chunk: Buffer): Array<{
header: LocoPacketHeader;
body: Record<string, unknown>;
}>;
}
//# sourceMappingURL=packet.d.ts.map
+1
View File
@@ -0,0 +1 @@
{"version":3,"file":"packet.d.ts","sourceRoot":"","sources":["../../src/protocol/packet.ts"],"names":[],"mappings":"AACA,OAAO,EAIL,KAAK,gBAAgB,EACrB,KAAK,WAAW,EAEjB,MAAM,mBAAmB,CAAC;AAa3B,wBAAgB,eAAe,CAC7B,EAAE,EAAE,MAAM,EACV,OAAO,EAAE,WAAW,EACpB,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,MAAM,CAiBR;AAED,wBAAgB,eAAe,CAC7B,IAAI,EAAE,MAAM,GACX;IAAE,MAAM,EAAE,gBAAgB,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,GAAG,IAAI,CAgCpE;AAMD,wBAAgB,oBAAoB,CAClC,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,GACb,MAAM,CAWR;AAED,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,GACb;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAahD;AAMD,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,MAAM,EACd,kBAAkB,EAAE,MAAM,GACzB,MAAM,CAWR;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAGvD;AAOD;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAE3D;AAED,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,MAAM,CAA2B;IAEzC;uEACmE;IACnE,IAAI,CACF,KAAK,EAAE,MAAM,GACZ,KAAK,CAAC;QAAE,MAAM,EAAE,gBAAgB,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,CAAC;CAqBtE;AAMD,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAA2B;IACzC,OAAO,CAAC,MAAM,CAAS;gBAEX,MAAM,EAAE,MAAM;IAI1B,kEAAkE;IAClE,IAAI,CACF,KAAK,EAAE,MAAM,GACZ,KAAK,CAAC;QAAE,MAAM,EAAE,gBAAgB,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,CAAC;CAmBtE"}
+150
View File
@@ -0,0 +1,150 @@
import { BSON } from "bson";
import { LOCO_HEADER_SIZE, ENCRYPTED_HEADER_SIZE, HANDSHAKE_LENGTH, } from "../types/index.js";
import { aesEncryptGCM, aesDecryptGCM, generateNonce, NONCE_SIZE, rsaEncryptOAEP, } from "../crypto/index.js";
// ---------------------------------------------------------------------------
// LOCO inner packet (plaintext layer)
// ---------------------------------------------------------------------------
export function buildLocoPacket(id, command, statusCode, body) {
const bsonBody = Buffer.from(BSON.serialize(body));
const buf = Buffer.alloc(LOCO_HEADER_SIZE + bsonBody.length);
buf.writeUInt32LE(id, 0);
buf.writeUInt16LE(statusCode, 4);
// command: 11 bytes, null-padded
const cmdBuf = Buffer.alloc(11, 0);
cmdBuf.write(command, "utf-8");
cmdBuf.copy(buf, 6);
buf.writeInt8(0, 17); // bodyType = 0 (BSON)
buf.writeInt32LE(bsonBody.length, 18);
bsonBody.copy(buf, LOCO_HEADER_SIZE);
return buf;
}
export function parseLocoPacket(data) {
if (data.length < LOCO_HEADER_SIZE)
return null;
const id = data.readUInt32LE(0);
const statusCode = data.readUInt16LE(4);
const command = data
.subarray(6, 17)
.toString("utf-8")
.replace(/\0/g, "");
const bodyType = data.readInt8(17);
const bodyLength = data.readInt32LE(18);
const header = {
id,
statusCode,
command,
bodyType,
bodyLength,
};
let body = {};
if (bodyLength > 0 && data.length >= LOCO_HEADER_SIZE + bodyLength) {
try {
body = BSON.deserialize(data.subarray(LOCO_HEADER_SIZE, LOCO_HEADER_SIZE + bodyLength));
}
catch {
// body stays empty if BSON parsing fails
}
}
return { header, body };
}
// ---------------------------------------------------------------------------
// Encrypted LOCO packet (network layer)
// ---------------------------------------------------------------------------
export function buildEncryptedPacket(locoPacket, aesKey) {
const nonce = generateNonce();
const encrypted = aesEncryptGCM(locoPacket, aesKey, nonce);
// [length:4][nonce:12][ciphertext+tag]
const buf = Buffer.alloc(4 + NONCE_SIZE + encrypted.length);
buf.writeUInt32LE(NONCE_SIZE + encrypted.length, 0);
nonce.copy(buf, 4);
encrypted.copy(buf, 4 + NONCE_SIZE);
return buf;
}
export function parseEncryptedPacket(data, aesKey) {
if (data.length < ENCRYPTED_HEADER_SIZE + 1)
return null;
const length = data.readUInt32LE(0);
const totalSize = 4 + length;
if (data.length < totalSize)
return null; // fragmented
const nonce = data.subarray(4, 4 + NONCE_SIZE);
const payload = data.subarray(4 + NONCE_SIZE, totalSize);
const decrypted = aesDecryptGCM(payload, aesKey, nonce);
return { decrypted, consumed: totalSize };
}
// ---------------------------------------------------------------------------
// Handshake packet
// ---------------------------------------------------------------------------
export function buildHandshakePacket(aesKey, serverPublicKeyPem) {
const encryptedKey = rsaEncryptOAEP(aesKey, serverPublicKeyPem);
// [keyLen:4][encType:4][blockMode:4][encKey:keyLen]
const buf = Buffer.alloc(4 + 4 + 4 + encryptedKey.length);
buf.writeUInt32LE(encryptedKey.length, 0); // RSA ciphertext length (256)
buf.writeUInt32LE(15, 4); // encryption type (RSA-OAEP-SHA1)
buf.writeUInt32LE(4, 8); // block cipher mode (AES/GCM)
encryptedKey.copy(buf, 12);
return buf;
}
export function isHandshakePacket(data) {
if (data.length < 4)
return false;
return data.readUInt32LE(0) === HANDSHAKE_LENGTH;
}
// ---------------------------------------------------------------------------
// Plain (unencrypted) packet framing — used over TLS (booking, checkin)
// [length:4 LE][loco_packet:length]
// ---------------------------------------------------------------------------
/**
* In plaintext mode (over TLS), LOCO packets are sent raw — no length prefix.
* The packet itself contains bodyLength at offset 18, so we can frame it.
*/
export function buildPlainPacket(locoPacket) {
return locoPacket; // no wrapping needed
}
export class PlainPacketReader {
buffer = Buffer.alloc(0);
/** Append incoming data and yield all complete parsed packets.
* Framing: read LOCO header (22 bytes), then bodyLength bytes. */
feed(chunk) {
this.buffer = Buffer.concat([this.buffer, chunk]);
const results = [];
while (this.buffer.length >= LOCO_HEADER_SIZE) {
const bodyLength = this.buffer.readInt32LE(18);
const totalSize = LOCO_HEADER_SIZE + bodyLength;
if (this.buffer.length < totalSize)
break;
const payload = this.buffer.subarray(0, totalSize);
const loco = parseLocoPacket(payload);
if (loco)
results.push(loco);
this.buffer = this.buffer.subarray(totalSize);
}
return results;
}
}
// ---------------------------------------------------------------------------
// Encrypted stream reassembly helper
// ---------------------------------------------------------------------------
export class PacketReader {
buffer = Buffer.alloc(0);
aesKey;
constructor(aesKey) {
this.aesKey = aesKey;
}
/** Append incoming data and yield all complete parsed packets. */
feed(chunk) {
this.buffer = Buffer.concat([this.buffer, chunk]);
const results = [];
while (this.buffer.length >= ENCRYPTED_HEADER_SIZE + 1) {
const parsed = parseEncryptedPacket(this.buffer, this.aesKey);
if (!parsed)
break; // incomplete packet, wait for more data
const loco = parseLocoPacket(parsed.decrypted);
if (loco)
results.push(loco);
this.buffer = this.buffer.subarray(parsed.consumed);
}
return results;
}
}
//# sourceMappingURL=packet.js.map
+1
View File
@@ -0,0 +1 @@
{"version":3,"file":"packet.js","sourceRoot":"","sources":["../../src/protocol/packet.ts"],"names":[],"mappings":"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 truncated