node-logy 0.1.0 → 0.1.2

package/dist/protocol.js

@@ -0,0 +1,414 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ResponseEncoder = exports.RequestEncoder = exports.ProtocolError = exports.VALID_LOG_LEVELS = exports.LOG_LEVEL = exports.VALID_METHODS = exports.METHOD = void 0;
+/**
+ * Contains all methods a request / response can have
+ */
+exports.METHOD = {
+    /**
+     * Indicates log information
+     */
+    LOG: 0x01,
+    /**
+     * Indicates that it needs flushing i.e write the remaining stuff
+     */
+    FLUSH: 0x02,
+    /**
+     * Indicates that the stream opened needs to be closed / re opened typically used for file rotation
+     */
+    RELOAD: 0x03,
+    /**
+     * Close the child process
+     */
+    SHUTDOWN: 0x04,
+};
+/**
+ * Contains a set of valid methods
+ */
+exports.VALID_METHODS = new Set(Object.values(exports.METHOD));
+/**
+ * Contains all the levels logs can be indicating there importance
+ */
+exports.LOG_LEVEL = {
+    /**
+     * Used for information
+     */
+    INFO: 0x01,
+    /**
+     * Used for warning
+     */
+    WARN: 0x02,
+    /**
+     * Used for errors
+     */
+    ERROR: 0x03,
+    /**
+     * Used for debug
+     */
+    DEBUG: 0x04,
+    /**
+     * Used for fatal
+     */
+    FATAL: 0x05,
+};
+/**
+ * Contains a set of valid log levels
+ */
+exports.VALID_LOG_LEVELS = new Set(Object.values(exports.LOG_LEVEL));
+/**
+ * Error thrown when encoding/decoding fails
+ */
+class ProtocolError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "ProtocolError";
+    }
+}
+exports.ProtocolError = ProtocolError;
+/**
+ * Used to encode the request messages to the buffer protocol encoding
+ */
+class RequestEncoder {
+    static HEADER_SIZE = 8;
+    static MAX_ID = 0xffffffff;
+    static MAX_PAYLOAD_LENGTH = 0xffff;
+    validMethods;
+    validLevels;
+    constructor(validMethods = exports.VALID_METHODS, validLevels = exports.VALID_LOG_LEVELS) {
+        this.validMethods = validMethods;
+        this.validLevels = validLevels;
+    }
+    /**
+     * Validates that a buffer contains a complete, valid request binary protocol
+     * without actually decoding the content. Checks:
+     * - Buffer has complete header (8 bytes)
+     * - Buffer has complete message (header + payload)
+     * - Payload length is within valid range (0 to 65535)
+     *
+     * @param buffer The buffer to validate
+     * @returns true if buffer is a valid complete request, false otherwise
+     */
+    static isValid(buffer) {
+        // Check complete header exists
+        if (!RequestEncoder.hasCompleteHeader(buffer)) {
+            return false;
+        }
+        // Check payload length is valid
+        const payloadLength = RequestEncoder.getPayloadLength(buffer);
+        // Check complete message exists
+        if (buffer.length !== RequestEncoder.HEADER_SIZE + payloadLength) {
+            return false;
+        }
+        return true;
+    }
+    /**
+     * Instance method to validate with method/level checking
+     * Validates that a buffer contains a complete, valid request with valid method and level values
+     */
+    isValidInstance(buffer) {
+        // First do static validation
+        if (!RequestEncoder.isValid(buffer)) {
+            return false;
+        }
+        // Check method is valid
+        const method = RequestEncoder.getMethod(buffer);
+        if (!this.validMethods.has(method)) {
+            return false;
+        }
+        // Check level is valid
+        const level = RequestEncoder.getLevel(buffer);
+        if (!this.validLevels.has(level)) {
+            return false;
+        }
+        return true;
+    }
+    /**
+     * Get the ID from a buffer (4 bytes, uint32 at offset 0)
+     */
+    static getId(buffer) {
+        return buffer.readUInt32BE(0);
+    }
+    /**
+     * Get the method from a buffer (1 byte at offset 4)
+     */
+    static getMethod(buffer) {
+        return buffer[4];
+    }
+    /**
+     * Get the level from a buffer (1 byte at offset 5)
+     */
+    static getLevel(buffer) {
+        return buffer[5];
+    }
+    /**
+     * Get the payload length from a buffer (2 bytes, uint16 at offset 6)
+     */
+    static getPayloadLength(buffer) {
+        return buffer.readUInt16BE(6);
+    }
+    /**
+     * Get the payload as a Buffer from a buffer (starting at offset 8)
+     */
+    static getPayloadBuffer(buffer) {
+        const payloadLength = RequestEncoder.getPayloadLength(buffer);
+        return buffer.subarray(RequestEncoder.HEADER_SIZE, RequestEncoder.HEADER_SIZE + payloadLength);
+    }
+    /**
+     * Get the payload as a UTF-8 string from a buffer
+     */
+    static getPayloadString(buffer) {
+        return RequestEncoder.getPayloadBuffer(buffer).toString("utf-8");
+    }
+    /**
+     * Check if buffer has complete header (8 bytes)
+     */
+    static hasCompleteHeader(buffer) {
+        return buffer.length >= RequestEncoder.HEADER_SIZE;
+    }
+    /**
+     * Check if buffer has complete message (header + payload)
+     */
+    static hasCompleteMessage(buffer) {
+        if (!RequestEncoder.hasCompleteHeader(buffer))
+            return false;
+        const payloadLength = RequestEncoder.getPayloadLength(buffer);
+        return buffer.length >= RequestEncoder.HEADER_SIZE + payloadLength;
+    }
+    /**
+     * Get total message size (header + payload)
+     */
+    static getTotalMessageSize(buffer) {
+        if (!RequestEncoder.hasCompleteHeader(buffer))
+            return RequestEncoder.HEADER_SIZE;
+        return RequestEncoder.HEADER_SIZE + RequestEncoder.getPayloadLength(buffer);
+    }
+    /**
+     * Encode a request to the binary protocol
+     */
+    encode(request) {
+        if (!Number.isInteger(request.id) ||
+            request.id < 0 ||
+            request.id > RequestEncoder.MAX_ID) {
+            throw new ProtocolError(`Invalid ID: ${request.id}`);
+        }
+        if (!this.validMethods.has(request.method)) {
+            throw new ProtocolError(`Invalid method: ${request.method}`);
+        }
+        if (!this.validLevels.has(request.level)) {
+            throw new ProtocolError(`Invalid level: ${request.level}`);
+        }
+        const payloadBytes = Buffer.from(request.payload, "utf-8");
+        if (payloadBytes.length > RequestEncoder.MAX_PAYLOAD_LENGTH) {
+            throw new ProtocolError(`Payload too large: ${payloadBytes.length} bytes`);
+        }
+        const buffer = Buffer.allocUnsafe(RequestEncoder.HEADER_SIZE + payloadBytes.length);
+        buffer.writeUInt32BE(request.id, 0);
+        buffer[4] = request.method;
+        buffer[5] = request.level;
+        buffer.writeUInt16BE(payloadBytes.length, 6);
+        payloadBytes.copy(buffer, 8);
+        return buffer;
+    }
+    /**
+     * Decode a binary protocol buffer to a request object
+     */
+    decode(buffer) {
+        if (!RequestEncoder.hasCompleteHeader(buffer)) {
+            throw new ProtocolError(`Buffer too small: ${buffer.length} bytes, minimum ${RequestEncoder.HEADER_SIZE} bytes required`);
+        }
+        const id = RequestEncoder.getId(buffer);
+        const method = RequestEncoder.getMethod(buffer);
+        const level = RequestEncoder.getLevel(buffer);
+        const payloadLength = RequestEncoder.getPayloadLength(buffer);
+        if (buffer.length !== RequestEncoder.HEADER_SIZE + payloadLength) {
+            throw new ProtocolError(`Buffer size mismatch: expected ${RequestEncoder.HEADER_SIZE + payloadLength} bytes, got ${buffer.length} bytes`);
+        }
+        if (!this.validMethods.has(method)) {
+            throw new ProtocolError(`Invalid method: ${method}`);
+        }
+        if (!this.validLevels.has(level)) {
+            throw new ProtocolError(`Invalid level: ${level}`);
+        }
+        const payload = RequestEncoder.getPayloadString(buffer);
+        return {
+            id,
+            method: method,
+            level: level,
+            payload,
+        };
+    }
+    static getHeaderSize() {
+        return RequestEncoder.HEADER_SIZE;
+    }
+}
+exports.RequestEncoder = RequestEncoder;
+/**
+ * Used to encode the response messages to the buffer protocol encoding
+ */
+class ResponseEncoder {
+    static HEADER_SIZE = 8;
+    static MAX_ID = 0xffffffff;
+    validMethods;
+    validLevels;
+    constructor(validMethods = exports.VALID_METHODS, validLevels = exports.VALID_LOG_LEVELS) {
+        this.validMethods = validMethods;
+        this.validLevels = validLevels;
+    }
+    /**
+     * Validates that a buffer contains a valid response binary protocol
+     * without actually decoding the content. Checks:
+     * - Buffer has complete header (8 bytes)
+     * - Reserved byte is 0x00
+     * - Success byte is 0 or 1
+     *
+     * @param buffer The buffer to validate
+     * @returns true if buffer is a valid response, false otherwise
+     */
+    static isValid(buffer) {
+        // Check complete header exists (responses are fixed 8 bytes)
+        if (buffer.length !== ResponseEncoder.HEADER_SIZE) {
+            return false;
+        }
+        // Check reserved byte is 0x00
+        if (buffer[7] !== 0x00) {
+            return false;
+        }
+        // Check success byte is valid (0 or 1)
+        const successByte = buffer[6];
+        if (successByte !== 0 && successByte !== 1) {
+            return false;
+        }
+        return true;
+    }
+    /**
+     * Instance method to validate with method/level checking
+     * Validates that a buffer contains a valid response with valid method and level values
+     */
+    isValidInstance(buffer) {
+        // First do static validation
+        if (!ResponseEncoder.isValid(buffer)) {
+            return false;
+        }
+        // Check method is valid
+        const method = ResponseEncoder.getMethod(buffer);
+        if (!this.validMethods.has(method)) {
+            return false;
+        }
+        // Check level is valid
+        const level = ResponseEncoder.getLevel(buffer);
+        if (!this.validLevels.has(level)) {
+            return false;
+        }
+        return true;
+    }
+    /**
+     * Get the ID from a buffer (4 bytes, uint32 at offset 0)
+     */
+    static getId(buffer) {
+        return buffer.readUInt32BE(0);
+    }
+    /**
+     * Get the method from a buffer (1 byte at offset 4)
+     */
+    static getMethod(buffer) {
+        return buffer[4];
+    }
+    /**
+     * Get the level from a buffer (1 byte at offset 5)
+     */
+    static getLevel(buffer) {
+        return buffer[5];
+    }
+    /**
+     * Get the success flag from a buffer (1 byte at offset 6)
+     * @returns boolean indicating success
+     */
+    static getSuccess(buffer) {
+        const successByte = buffer[6];
+        return successByte === 1;
+    }
+    /**
+     * Get the reserved byte from a buffer (1 byte at offset 7)
+     */
+    static getReserved(buffer) {
+        return buffer[7];
+    }
+    /**
+     * Check if buffer has complete header (8 bytes)
+     * For responses, this means the buffer is exactly 8 bytes
+     */
+    static hasCompleteHeader(buffer) {
+        return buffer.length >= ResponseEncoder.HEADER_SIZE;
+    }
+    /**
+     * Check if buffer is a complete response message (exactly 8 bytes)
+     */
+    static hasCompleteMessage(buffer) {
+        return buffer.length === ResponseEncoder.HEADER_SIZE;
+    }
+    /**
+     * Get total message size (always 8 bytes for responses)
+     */
+    static getTotalMessageSize() {
+        return ResponseEncoder.HEADER_SIZE;
+    }
+    /**
+     * Encode a response to the binary protocol
+     * @param response The JSON response object
+     * @returns Binary protocol buffer (exactly 8 bytes)
+     */
+    encode(response) {
+        if (!Number.isInteger(response.id) ||
+            response.id < 0 ||
+            response.id > ResponseEncoder.MAX_ID) {
+            throw new ProtocolError(`Invalid ID: ${response.id}`);
+        }
+        if (!this.validMethods.has(response.method)) {
+            throw new ProtocolError(`Invalid method: ${response.method}`);
+        }
+        if (!this.validLevels.has(response.level)) {
+            throw new ProtocolError(`Invalid level: ${response.level}`);
+        }
+        const buffer = Buffer.allocUnsafe(ResponseEncoder.HEADER_SIZE);
+        buffer.writeUInt32BE(response.id, 0);
+        buffer[4] = response.method;
+        buffer[5] = response.level;
+        buffer[6] = response.success ? 1 : 0;
+        buffer[7] = 0x00; // reserved padding
+        return buffer;
+    }
+    /**
+     * Decode a binary protocol buffer to a response object
+     * @param buffer The binary protocol buffer
+     * @returns The decoded response object
+     */
+    decode(buffer) {
+        if (buffer.length !== ResponseEncoder.HEADER_SIZE) {
+            throw new ProtocolError(`Invalid buffer size: expected ${ResponseEncoder.HEADER_SIZE} bytes, got ${buffer.length} bytes`);
+        }
+        const id = ResponseEncoder.getId(buffer);
+        const method = ResponseEncoder.getMethod(buffer);
+        const level = ResponseEncoder.getLevel(buffer);
+        const success = ResponseEncoder.getSuccess(buffer);
+        if (buffer[7] !== 0x00) {
+            throw new ProtocolError(`Invalid reserved byte: expected 0x00, got 0x${buffer[7]?.toString(16).padStart(2, "0")}`);
+        }
+        if (!this.validMethods.has(method)) {
+            throw new ProtocolError(`Invalid method: ${method}`);
+        }
+        if (!this.validLevels.has(level)) {
+            throw new ProtocolError(`Invalid level: ${level}`);
+        }
+        return {
+            id,
+            method: method,
+            level: level,
+            success,
+        };
+    }
+    static getHeaderSize() {
+        return ResponseEncoder.HEADER_SIZE;
+    }
+}
+exports.ResponseEncoder = ResponseEncoder;
+//# sourceMappingURL=protocol.js.map

package/dist/protocol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.js","sourceRoot":"","sources":["../src/protocol.ts"],"names":[],"mappings":";;;AAAA;;GAEG;AACU,QAAA,MAAM,GAAG;IACpB;;OAEG;IACH,GAAG,EAAE,IAAI;IAET;;OAEG;IACH,KAAK,EAAE,IAAI;IAEX;;OAEG;IACH,MAAM,EAAE,IAAI;IAEZ;;OAEG;IACH,QAAQ,EAAE,IAAI;CACN,CAAC;AAEX;;GAEG;AACU,QAAA,aAAa,GAAgB,IAAI,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,cAAM,CAAC,CAAC,CAAC;AAOzE;;GAEG;AACU,QAAA,SAAS,GAAG;IACvB;;OAEG;IACH,IAAI,EAAE,IAAI;IAEV;;OAEG;IACH,IAAI,EAAE,IAAI;IAEV;;OAEG;IACH,KAAK,EAAE,IAAI;IAEX;;OAEG;IACH,KAAK,EAAE,IAAI;IAEX;;OAEG;IACH,KAAK,EAAE,IAAI;CACH,CAAC;AAEX;;GAEG;AACU,QAAA,gBAAgB,GAAgB,IAAI,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,iBAAS,CAAC,CAAC,CAAC;AAuF/E;;GAEG;AACH,MAAa,aAAc,SAAQ,KAAK;IACtC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;IAC9B,CAAC;CACF;AALD,sCAKC;AAED;;GAEG;AACH,MAAa,cAAc;IACjB,MAAM,CAAU,WAAW,GAAG,CAAC,CAAC;IAChC,MAAM,CAAU,MAAM,GAAG,UAAU,CAAC;IAC5C,MAAM,CAAU,kBAAkB,GAAG,MAAM,CAAC;IACpC,YAAY,CAAc;IAC1B,WAAW,CAAc;IAEjC,YACE,eAA4B,qBAAa,EACzC,cAA2B,wBAAgB;QAE3C,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;QACjC,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;IACjC,CAAC;IAED;;;;;;;;;OASG;IACH,MAAM,CAAC,OAAO,CAAC,MAAc;QAC3B,+BAA+B;QAC/B,IAAI,CAAC,cAAc,CAAC,iBAAiB,CAAC,MAAM,CAAC,EAAE,CAAC;YAC9C,OAAO,KAAK,CAAC;QACf,CAAC;QAED,gCAAgC;QAChC,MAAM,aAAa,GAAG,cAAc,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC;QAE9D,gCAAgC;QAChC,IAAI,MAAM,CAAC,MAAM,KAAK,cAAc,CAAC,WAAW,GAAG,aAAa,EAAE,CAAC;YACjE,OAAO,KAAK,CAAC;QACf,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;OAGG;IACH,eAAe,CAAC,MAAc;QAC5B,6BAA6B;QAC7B,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YACpC,OAAO,KAAK,CAAC;QACf,CAAC;QAED,wBAAwB;QACxB,MAAM,MAAM,GAAG,cAAc,CAAC,SAAS,CAAC,MAAM,CAAW,CAAC;QAC1D,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;YACnC,OAAO,KAAK,CAAC;QACf,CAAC;QAED,uBAAuB;QACvB,MAAM,KAAK,GAAG,cAAc,CAAC,QAAQ,CAAC,MAAM,CAAW,CAAC;QACxD,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;YACjC,OAAO,KAAK,CAAC;QACf,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,KAAK,CAAC,MAAc;QACzB,OAAO,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IAChC,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,SAAS,CAAC,MAAc;QAC7B,OAAO,MAAM,CAAC,CAAC,CAAC,CAAC;IACnB,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,QAAQ,CAAC,MAAc;QAC5B,OAAO,MAAM,CAAC,CAAC,CAAC,CAAC;IACnB,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,gBAAgB,CAAC,MAAc;QACpC,OAAO,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IAChC,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,gBAAgB,CAAC,MAAc;QACpC,MAAM,aAAa,GAAG,cAAc,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC;QAC9D,OAAO,MAAM,CAAC,QAAQ,CACpB,cAAc,CAAC,WAAW,EAC1B,cAAc,CAAC,WAAW,GAAG,aAAa,CAC3C,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,gBAAgB,CAAC,MAAc;QACpC,OAAO,cAAc,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;IACnE,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,iBAAiB,CAAC,MAAc;QACrC,OAAO,MAAM,CAAC,MAAM,IAAI,cAAc,CAAC,WAAW,CAAC;IACrD,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,kBAAkB,CAAC,MAAc;QACtC,IAAI,CAAC,cAAc,CAAC,iBAAiB,CAAC,MAAM,CAAC;YAAE,OAAO,KAAK,CAAC;QAC5D,MAAM,aAAa,GAAG,cAAc,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC;QAC9D,OAAO,MAAM,CAAC,MAAM,IAAI,cAAc,CAAC,WAAW,GAAG,aAAa,CAAC;IACrE,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,mBAAmB,CAAC,MAAc;QACvC,IAAI,CAAC,cAAc,CAAC,iBAAiB,CAAC,MAAM,CAAC;YAC3C,OAAO,cAAc,CAAC,WAAW,CAAC;QACpC,OAAO,cAAc,CAAC,WAAW,GAAG,cAAc,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC;IAC9E,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,OAAgB;QACrB,IACE,CAAC,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC;YAC7B,OAAO,CAAC,EAAE,GAAG,CAAC;YACd,OAAO,CAAC,EAAE,GAAG,cAAc,CAAC,MAAM,EAClC,CAAC;YACD,MAAM,IAAI,aAAa,CAAC,eAAe,OAAO,CAAC,EAAE,EAAE,CAAC,CAAC;QACvD,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YAC3C,MAAM,IAAI,aAAa,CAAC,mBAAmB,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;QAC/D,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YACzC,MAAM,IAAI,aAAa,CAAC,kBAAkB,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;QAC7D,CAAC;QAED,MAAM,YAAY,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAC3D,IAAI,YAAY,CAAC,MAAM,GAAG,cAAc,CAAC,kBAAkB,EAAE,CAAC;YAC5D,MAAM,IAAI,aAAa,CACrB,sBAAsB,YAAY,CAAC,MAAM,QAAQ,CAClD,CAAC;QACJ,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,CAAC,WAAW,CAC/B,cAAc,CAAC,WAAW,GAAG,YAAY,CAAC,MAAM,CACjD,CAAC;QAEF,MAAM,CAAC,aAAa,CAAC,OAAO,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;QACpC,MAAM,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC;QAC3B,MAAM,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC;QAC1B,MAAM,CAAC,aAAa,CAAC,YAAY,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;QAC7C,YAAY,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;QAE7B,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,MAAc;QACnB,IAAI,CAAC,cAAc,CAAC,iBAAiB,CAAC,MAAM,CAAC,EAAE,CAAC;YAC9C,MAAM,IAAI,aAAa,CACrB,qBAAqB,MAAM,CAAC,MAAM,mBAAmB,cAAc,CAAC,WAAW,iBAAiB,CACjG,CAAC;QACJ,CAAC;QAED,MAAM,EAAE,GAAG,cAAc,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QACxC,MAAM,MAAM,GAAG,cAAc,CAAC,SAAS,CAAC,MAAM,CAAW,CAAC;QAC1D,MAAM,KAAK,GAAG,cAAc,CAAC,QAAQ,CAAC,MAAM,CAAW,CAAC;QACxD,MAAM,aAAa,GAAG,cAAc,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC;QAE9D,IAAI,MAAM,CAAC,MAAM,KAAK,cAAc,CAAC,WAAW,GAAG,aAAa,EAAE,CAAC;YACjE,MAAM,IAAI,aAAa,CACrB,kCAAkC,cAAc,CAAC,WAAW,GAAG,aAAa,eAAe,MAAM,CAAC,MAAM,QAAQ,CACjH,CAAC;QACJ,CAAC;QAED,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;YACnC,MAAM,IAAI,aAAa,CAAC,mBAAmB,MAAM,EAAE,CAAC,CAAC;QACvD,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;YACjC,MAAM,IAAI,aAAa,CAAC,kBAAkB,KAAK,EAAE,CAAC,CAAC;QACrD,CAAC;QAED,MAAM,OAAO,GAAG,cAAc,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC;QAExD,OAAO;YACL,EAAE;YACF,MAAM,EAAE,MAAoB;YAC5B,KAAK,EAAE,KAAqB;YAC5B,OAAO;SACR,CAAC;IACJ,CAAC;IAED,MAAM,CAAC,aAAa;QAClB,OAAO,cAAc,CAAC,WAAW,CAAC;IACpC,CAAC;;AAxNH,wCAyNC;AAED;;GAEG;AACH,MAAa,eAAe;IAClB,MAAM,CAAU,WAAW,GAAG,CAAC,CAAC;IAChC,MAAM,CAAU,MAAM,GAAG,UAAU,CAAC;IACpC,YAAY,CAAc;IAC1B,WAAW,CAAc;IAEjC,YACE,eAA4B,qBAAa,EACzC,cAA2B,wBAAgB;QAE3C,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;QACjC,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;IACjC,CAAC;IAED;;;;;;;;;OASG;IACH,MAAM,CAAC,OAAO,CAAC,MAAc;QAC3B,6DAA6D;QAC7D,IAAI,MAAM,CAAC,MAAM,KAAK,eAAe,CAAC,WAAW,EAAE,CAAC;YAClD,OAAO,KAAK,CAAC;QACf,CAAC;QAED,8BAA8B;QAC9B,IAAI,MAAM,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;YACvB,OAAO,KAAK,CAAC;QACf,CAAC;QAED,uCAAuC;QACvC,MAAM,WAAW,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;QAC9B,IAAI,WAAW,KAAK,CAAC,IAAI,WAAW,KAAK,CAAC,EAAE,CAAC;YAC3C,OAAO,KAAK,CAAC;QACf,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;OAGG;IACH,eAAe,CAAC,MAAc;QAC5B,6BAA6B;QAC7B,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YACrC,OAAO,KAAK,CAAC;QACf,CAAC;QAED,wBAAwB;QACxB,MAAM,MAAM,GAAG,eAAe,CAAC,SAAS,CAAC,MAAM,CAAW,CAAC;QAC3D,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;YACnC,OAAO,KAAK,CAAC;QACf,CAAC;QAED,uBAAuB;QACvB,MAAM,KAAK,GAAG,eAAe,CAAC,QAAQ,CAAC,MAAM,CAAW,CAAC;QACzD,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;YACjC,OAAO,KAAK,CAAC;QACf,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,KAAK,CAAC,MAAc;QACzB,OAAO,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IAChC,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,SAAS,CAAC,MAAc;QAC7B,OAAO,MAAM,CAAC,CAAC,CAAC,CAAC;IACnB,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,QAAQ,CAAC,MAAc;QAC5B,OAAO,MAAM,CAAC,CAAC,CAAC,CAAC;IACnB,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,UAAU,CAAC,MAAc;QAC9B,MAAM,WAAW,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;QAC9B,OAAO,WAAW,KAAK,CAAC,CAAC;IAC3B,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,WAAW,CAAC,MAAc;QAC/B,OAAO,MAAM,CAAC,CAAC,CAAC,CAAC;IACnB,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,iBAAiB,CAAC,MAAc;QACrC,OAAO,MAAM,CAAC,MAAM,IAAI,eAAe,CAAC,WAAW,CAAC;IACtD,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,kBAAkB,CAAC,MAAc;QACtC,OAAO,MAAM,CAAC,MAAM,KAAK,eAAe,CAAC,WAAW,CAAC;IACvD,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,mBAAmB;QACxB,OAAO,eAAe,CAAC,WAAW,CAAC;IACrC,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,QAAkB;QACvB,IACE,CAAC,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC9B,QAAQ,CAAC,EAAE,GAAG,CAAC;YACf,QAAQ,CAAC,EAAE,GAAG,eAAe,CAAC,MAAM,EACpC,CAAC;YACD,MAAM,IAAI,aAAa,CAAC,eAAe,QAAQ,CAAC,EAAE,EAAE,CAAC,CAAC;QACxD,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;YAC5C,MAAM,IAAI,aAAa,CAAC,mBAAmB,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;QAChE,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;YAC1C,MAAM,IAAI,aAAa,CAAC,kBAAkB,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC;QAC9D,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,CAAC,WAAW,CAAC,eAAe,CAAC,WAAW,CAAC,CAAC;QAE/D,MAAM,CAAC,aAAa,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;QACrC,MAAM,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,MAAM,CAAC;QAC5B,MAAM,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC;QAC3B,MAAM,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACrC,MAAM,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,mBAAmB;QAErC,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,MAAc;QACnB,IAAI,MAAM,CAAC,MAAM,KAAK,eAAe,CAAC,WAAW,EAAE,CAAC;YAClD,MAAM,IAAI,aAAa,CACrB,iCAAiC,eAAe,CAAC,WAAW,eAAe,MAAM,CAAC,MAAM,QAAQ,CACjG,CAAC;QACJ,CAAC;QAED,MAAM,EAAE,GAAG,eAAe,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QACzC,MAAM,MAAM,GAAG,eAAe,CAAC,SAAS,CAAC,MAAM,CAAW,CAAC;QAC3D,MAAM,KAAK,GAAG,eAAe,CAAC,QAAQ,CAAC,MAAM,CAAW,CAAC;QACzD,MAAM,OAAO,GAAG,eAAe,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;QAEnD,IAAI,MAAM,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;YACvB,MAAM,IAAI,aAAa,CACrB,+CAA+C,MAAM,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAC1F,CAAC;QACJ,CAAC;QAED,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;YACnC,MAAM,IAAI,aAAa,CAAC,mBAAmB,MAAM,EAAE,CAAC,CAAC;QACvD,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;YACjC,MAAM,IAAI,aAAa,CAAC,kBAAkB,KAAK,EAAE,CAAC,CAAC;QACrD,CAAC;QAED,OAAO;YACL,EAAE;YACF,MAAM,EAAE,MAAoB;YAC5B,KAAK,EAAE,KAAqB;YAC5B,OAAO;SACR,CAAC;IACJ,CAAC;IAED,MAAM,CAAC,aAAa;QAClB,OAAO,eAAe,CAAC,WAAW,CAAC;IACrC,CAAC;;AAvMH,0CAwMC"}

package/dist/server.d.ts

@@ -0,0 +1,5 @@
+/**
+ * This is a self contained script that runs as the server process which accepts the binary protocol and then performs actions
+ */
+export {};
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

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

package/dist/server.js

@@ -0,0 +1,257 @@
+"use strict";
+/**
+ * This is a self contained script that runs as the server process which accepts the binary protocol and then performs actions
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const node_path_1 = __importDefault(require("node:path"));
+const protocol_1 = require("./protocol");
+const node_fs_1 = __importDefault(require("node:fs"));
+/**
+ * Used for sucess exits
+ */
+const EXIT_SUCCESS = 0;
+/**
+ * Holds the stream for the log file
+ */
+let fileStream = null;
+/**
+ * Holds the base path of where to save the log files
+ */
+let basePath = "./logs";
+/**
+ * Holds stdin buffer
+ */
+let stdinBuffer = Buffer.alloc(0);
+/**
+ * Holds the array of buffer data we will write to the log file
+ */
+let fileWriteBufferArray = [];
+/**
+ * How long we wait until we flush unless the buffer gets full
+ */
+const FLUSH_MS = 130;
+/**
+ * How many buffers can accumulate before we have to flush
+ */
+const FILE_WRITE_BUFFER_FLUSH_COUNT = 100;
+/**
+ * Holds the timeout for flush
+ */
+let flushTimeout = null;
+/**
+ * Used to encode and decode response binary protocol data
+ */
+const responseEncoder = new protocol_1.ResponseEncoder();
+/**
+ * Newline buffer for efficient concatenation
+ */
+const NEWLINE_BUFFER = Buffer.from("\n");
+/**
+ * Clears the pending flush timeout
+ */
+const clearFlushTimeout = () => {
+    if (flushTimeout) {
+        clearTimeout(flushTimeout);
+        flushTimeout = null;
+    }
+};
+/**
+ * Flushes the buffer array to the file and resets it
+ */
+const flush = () => {
+    if (fileWriteBufferArray.length === 0 || !fileStream) {
+        return;
+    }
+    const joinedBuffer = Buffer.concat([
+        Buffer.concat(fileWriteBufferArray.map((buf, index) => index < fileWriteBufferArray.length - 1
+            ? Buffer.concat([buf, NEWLINE_BUFFER])
+            : buf)),
+        NEWLINE_BUFFER,
+    ]);
+    fileStream.write(joinedBuffer, (err) => {
+        if (err) {
+            console.error(`Write error: ${err.message}`);
+        }
+    });
+    fileWriteBufferArray = [];
+    clearFlushTimeout();
+};
+/**
+ * Starts the delayed flush timer if not already running
+ */
+const startFlush = () => {
+    if (flushTimeout !== null) {
+        return;
+    }
+    flushTimeout = setTimeout(() => {
+        flush();
+    }, FLUSH_MS);
+};
+/**
+ * Used to send response to the parent
+ * @param response The response
+ */
+const sendResponse = (response) => {
+    process.stdout.write(responseEncoder.encode(response));
+};
+/**
+ * Handle the request decoded
+ * @param request The request that was buffer bytes extracted
+ */
+const requestHandler = (request) => {
+    const requestMethod = protocol_1.RequestEncoder.getMethod(request);
+    const requestId = protocol_1.RequestEncoder.getId(request);
+    const requestLevel = protocol_1.RequestEncoder.getLevel(request);
+    switch (requestMethod) {
+        case protocol_1.METHOD.LOG: {
+            const payload = protocol_1.RequestEncoder.getPayloadBuffer(request);
+            fileWriteBufferArray.push(payload);
+            if (fileWriteBufferArray.length >= FILE_WRITE_BUFFER_FLUSH_COUNT) {
+                flush();
+            }
+            else {
+                startFlush();
+            }
+            sendResponse({
+                id: requestId,
+                level: requestLevel,
+                method: requestMethod,
+                success: true,
+            });
+            break;
+        }
+        case protocol_1.METHOD.FLUSH:
+            flush();
+            if (fileStream?.writableNeedDrain) {
+                fileStream.once("drain", () => {
+                    sendResponse({
+                        id: requestId,
+                        level: requestLevel,
+                        method: requestMethod,
+                        success: true,
+                    });
+                });
+            }
+            else {
+                sendResponse({
+                    id: requestId,
+                    level: requestLevel,
+                    method: requestMethod,
+                    success: true,
+                });
+            }
+            break;
+        case protocol_1.METHOD.RELOAD:
+            flush();
+            fileStream?.end(() => {
+                fileStream = null;
+                createStream();
+                sendResponse({
+                    id: requestId,
+                    level: requestLevel,
+                    method: requestMethod,
+                    success: true,
+                });
+            });
+            return;
+        case protocol_1.METHOD.SHUTDOWN:
+            flush();
+            fileStream?.end(() => {
+                sendResponse({
+                    id: requestId,
+                    level: requestLevel,
+                    method: requestMethod,
+                    success: true,
+                });
+                setImmediate(() => {
+                    process.exit(EXIT_SUCCESS);
+                });
+            });
+            return;
+        default:
+            process.stderr.write(`request unhandled method ${requestMethod}`);
+            sendResponse({
+                id: requestId,
+                level: requestLevel,
+                method: requestMethod,
+                success: false,
+            });
+            break;
+    }
+};
+/**
+ * Parses the buffer and moves it along with backpressure handling
+ */
+function parseBuffer() {
+    const HEADER_SIZE = protocol_1.RequestEncoder.getHeaderSize();
+    while (stdinBuffer.length >= HEADER_SIZE) {
+        const payloadLength = protocol_1.RequestEncoder.getPayloadLength(stdinBuffer);
+        const totalMessageSize = HEADER_SIZE + payloadLength;
+        if (stdinBuffer.length < totalMessageSize) {
+            break;
+        }
+        const messageBuffer = stdinBuffer.subarray(0, totalMessageSize);
+        requestHandler(messageBuffer);
+        stdinBuffer = stdinBuffer.subarray(totalMessageSize);
+    }
+    if (stdinBuffer.length >= protocol_1.RequestEncoder.getHeaderSize()) {
+        setImmediate(parseBuffer);
+    }
+}
+/**
+ * Generates a log filename based on current date
+ * @returns Filename in format YYYY-MM-DD.log
+ */
+const getLogFileName = () => {
+    const date = new Date();
+    const year = date.getFullYear();
+    const month = String(date.getMonth() + 1).padStart(2, "0");
+    const day = String(date.getDate()).padStart(2, "0");
+    return `${year}-${month}-${day}.log`;
+};
+/**
+ * Creates a stream to the file in append mode for today's log file.
+ * Closes existing stream if one is already open.
+ */
+const createStream = () => {
+    fileStream = null;
+    const fileName = getLogFileName();
+    const filePath = node_path_1.default.join(basePath, fileName);
+    fileStream = node_fs_1.default.createWriteStream(filePath, { flags: "a" });
+    fileStream.on("error", (err) => {
+        console.error(`Stream error: ${err.message}`);
+    });
+};
+/**
+ * Graceful shutdown handler
+ */
+const shutdown = () => {
+    clearFlushTimeout();
+    flush();
+    fileStream?.end(() => {
+        process.exit(EXIT_SUCCESS);
+    });
+};
+process.on("SIGINT", shutdown);
+process.on("SIGTERM", shutdown);
+/**
+ * Main entry point
+ */
+async function main() {
+    basePath = process.env["BASE_PATH"] ? process.env["BASE_PATH"] : "./logs";
+    basePath = node_path_1.default.normalize(node_path_1.default.resolve(basePath));
+    await node_fs_1.default.promises.mkdir(basePath, { recursive: true });
+    createStream();
+    process.stdin.on("data", (chunk) => {
+        stdinBuffer = Buffer.concat([stdinBuffer, chunk]);
+        parseBuffer();
+    });
+    process.stdin.on("end", () => {
+        shutdown();
+    });
+}
+main();
+//# sourceMappingURL=server.js.map