ts-flp 1.0.0

package/dist/src/io/BinaryReader.js

@@ -0,0 +1,159 @@
+/**
+ * Binary reader for FL Studio .flp files
+ * Uses smart-buffer for binary reading and protobufjs for VarInt decoding
+ */
+import * as protobuf from "protobufjs/minimal.js";
+import { SmartBuffer } from "smart-buffer";
+export class BinaryReader {
+    sb;
+    constructor(buffer) {
+        this.sb = SmartBuffer.fromBuffer(buffer);
+    }
+    /**
+     * Returns current read position
+     */
+    tell() {
+        return this.sb.readOffset;
+    }
+    /**
+     * Seeks to an absolute position
+     */
+    seek(pos) {
+        this.sb.readOffset = pos;
+    }
+    /**
+     * Seeks relative to current position
+     */
+    skip(offset) {
+        this.sb.readOffset += offset;
+    }
+    /**
+     * Returns total buffer length
+     */
+    length() {
+        return this.sb.length;
+    }
+    /**
+     * Returns remaining bytes to read
+     */
+    remaining() {
+        return this.sb.remaining();
+    }
+    /**
+     * Returns true if there are more bytes to read
+     */
+    hasMore() {
+        return this.sb.remaining() > 0;
+    }
+    /**
+     * Reads an unsigned 8-bit integer
+     */
+    readU8() {
+        return this.sb.readUInt8();
+    }
+    /**
+     * Reads a signed 8-bit integer
+     */
+    readI8() {
+        return this.sb.readInt8();
+    }
+    /**
+     * Reads an unsigned 16-bit integer (little-endian)
+     */
+    readU16LE() {
+        return this.sb.readUInt16LE();
+    }
+    /**
+     * Reads a signed 16-bit integer (little-endian)
+     */
+    readI16LE() {
+        return this.sb.readInt16LE();
+    }
+    /**
+     * Reads an unsigned 32-bit integer (little-endian)
+     */
+    readU32LE() {
+        return this.sb.readUInt32LE();
+    }
+    /**
+     * Reads a signed 32-bit integer (little-endian)
+     */
+    readI32LE() {
+        return this.sb.readInt32LE();
+    }
+    /**
+     * Reads a 32-bit float (little-endian)
+     */
+    readF32LE() {
+        return this.sb.readFloatLE();
+    }
+    /**
+     * Reads a 64-bit float (little-endian)
+     */
+    readF64LE() {
+        return this.sb.readDoubleLE();
+    }
+    /**
+     * Reads raw bytes
+     */
+    readBytes(length) {
+        return this.sb.readBuffer(length);
+    }
+    /**
+     * Reads a VarInt (variable-length integer) using protobufjs
+     * FL Studio uses this encoding for TEXT and DATA event sizes
+     */
+    readVarInt() {
+        // Get remaining buffer from current position
+        const remainingBuffer = this.sb.toBuffer().subarray(this.sb.readOffset);
+        const reader = protobuf.Reader.create(remainingBuffer);
+        const value = reader.uint32();
+        // Advance our position by how many bytes protobufjs consumed
+        this.sb.readOffset += reader.pos;
+        return value;
+    }
+    /**
+     * Reads an ASCII string (null-terminated)
+     */
+    readAsciiString(length) {
+        const str = this.sb.readString(length, "ascii");
+        // Remove null terminator if present
+        const nullPos = str.indexOf("\0");
+        return nullPos === -1 ? str : str.substring(0, nullPos);
+    }
+    /**
+     * Reads a UTF-16LE string (null-terminated)
+     */
+    readUtf16LEString(length) {
+        const bytes = this.sb.readBuffer(length);
+        const str = bytes.toString("utf16le");
+        // Remove null terminator if present
+        const nullPos = str.indexOf("\0");
+        return nullPos === -1 ? str : str.substring(0, nullPos);
+    }
+    /**
+     * Peeks at bytes without advancing position
+     */
+    peek(length) {
+        const pos = this.sb.readOffset;
+        const data = this.sb.readBuffer(length);
+        this.sb.readOffset = pos;
+        return data;
+    }
+    /**
+     * Peeks at a single byte without advancing position
+     */
+    peekU8() {
+        const pos = this.sb.readOffset;
+        const value = this.sb.readUInt8();
+        this.sb.readOffset = pos;
+        return value;
+    }
+    /**
+     * Returns the internal buffer
+     */
+    toBuffer() {
+        return this.sb.toBuffer();
+    }
+}
+//# sourceMappingURL=BinaryReader.js.map

package/dist/src/io/BinaryReader.js.map

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

package/dist/src/io/BinaryWriter.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Binary writer for FL Studio .flp files
+ * Uses smart-buffer for binary writing and protobufjs for VarInt encoding
+ */
+export declare class BinaryWriter {
+    private sb;
+    constructor();
+    /**
+     * Returns current write position (total bytes written)
+     */
+    tell(): number;
+    /**
+     * Writes an unsigned 8-bit integer
+     */
+    writeU8(value: number): void;
+    /**
+     * Writes a signed 8-bit integer
+     */
+    writeI8(value: number): void;
+    /**
+     * Writes an unsigned 16-bit integer (little-endian)
+     */
+    writeU16LE(value: number): void;
+    /**
+     * Writes a signed 16-bit integer (little-endian)
+     */
+    writeI16LE(value: number): void;
+    /**
+     * Writes an unsigned 32-bit integer (little-endian)
+     */
+    writeU32LE(value: number): void;
+    /**
+     * Writes a signed 32-bit integer (little-endian)
+     */
+    writeI32LE(value: number): void;
+    /**
+     * Writes a 32-bit float (little-endian)
+     */
+    writeF32LE(value: number): void;
+    /**
+     * Writes a 64-bit float (little-endian)
+     */
+    writeF64LE(value: number): void;
+    /**
+     * Writes raw bytes
+     */
+    writeBytes(data: Buffer): void;
+    /**
+     * Writes a VarInt (variable-length integer) using protobufjs
+     * FL Studio uses this encoding for TEXT and DATA event sizes
+     */
+    writeVarInt(value: number): void;
+    /**
+     * Writes an ASCII string (null-terminated)
+     */
+    writeAsciiString(str: string): void;
+    /**
+     * Writes a UTF-16LE string (null-terminated)
+     */
+    writeUtf16LEString(str: string): void;
+    /**
+     * Gets the final buffer
+     */
+    toBuffer(): Buffer;
+}
+/**
+ * Encodes a VarInt to a Buffer using protobufjs (standalone utility)
+ */
+export declare function encodeVarInt(value: number): Buffer;
+/**
+ * Calculates the byte size needed for a VarInt
+ */
+export declare function varIntSize(value: number): number;
+//# sourceMappingURL=BinaryWriter.d.ts.map

package/dist/src/io/BinaryWriter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BinaryWriter.d.ts","sourceRoot":"","sources":["../../../src/io/BinaryWriter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,qBAAa,YAAY;IACvB,OAAO,CAAC,EAAE,CAAc;;IAMxB;;OAEG;IACH,IAAI,IAAI,MAAM;IAId;;OAEG;IACH,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAI5B;;OAEG;IACH,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAI5B;;OAEG;IACH,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAI/B;;OAEG;IACH,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAI/B;;OAEG;IACH,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAI/B;;OAEG;IACH,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAI/B;;OAEG;IACH,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAI/B;;OAEG;IACH,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAI/B;;OAEG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAI9B;;;OAGG;IACH,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAOhC;;OAEG;IACH,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAInC;;OAEG;IACH,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAKrC;;OAEG;IACH,QAAQ,IAAI,MAAM;CAGnB;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAIlD;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAMhD"}

package/dist/src/io/BinaryWriter.js

@@ -0,0 +1,124 @@
+/**
+ * Binary writer for FL Studio .flp files
+ * Uses smart-buffer for binary writing and protobufjs for VarInt encoding
+ */
+import { SmartBuffer } from "smart-buffer";
+import * as protobuf from "protobufjs/minimal.js";
+export class BinaryWriter {
+    sb;
+    constructor() {
+        this.sb = new SmartBuffer();
+    }
+    /**
+     * Returns current write position (total bytes written)
+     */
+    tell() {
+        return this.sb.writeOffset;
+    }
+    /**
+     * Writes an unsigned 8-bit integer
+     */
+    writeU8(value) {
+        this.sb.writeUInt8(value & 0xff);
+    }
+    /**
+     * Writes a signed 8-bit integer
+     */
+    writeI8(value) {
+        this.sb.writeInt8(value);
+    }
+    /**
+     * Writes an unsigned 16-bit integer (little-endian)
+     */
+    writeU16LE(value) {
+        this.sb.writeUInt16LE(value & 0xffff);
+    }
+    /**
+     * Writes a signed 16-bit integer (little-endian)
+     */
+    writeI16LE(value) {
+        this.sb.writeInt16LE(value);
+    }
+    /**
+     * Writes an unsigned 32-bit integer (little-endian)
+     */
+    writeU32LE(value) {
+        this.sb.writeUInt32LE(value >>> 0);
+    }
+    /**
+     * Writes a signed 32-bit integer (little-endian)
+     */
+    writeI32LE(value) {
+        this.sb.writeInt32LE(value);
+    }
+    /**
+     * Writes a 32-bit float (little-endian)
+     */
+    writeF32LE(value) {
+        this.sb.writeFloatLE(value);
+    }
+    /**
+     * Writes a 64-bit float (little-endian)
+     */
+    writeF64LE(value) {
+        this.sb.writeDoubleLE(value);
+    }
+    /**
+     * Writes raw bytes
+     */
+    writeBytes(data) {
+        this.sb.writeBuffer(data);
+    }
+    /**
+     * Writes a VarInt (variable-length integer) using protobufjs
+     * FL Studio uses this encoding for TEXT and DATA event sizes
+     */
+    writeVarInt(value) {
+        const writer = protobuf.Writer.create();
+        writer.uint32(value);
+        const encoded = writer.finish();
+        this.sb.writeBuffer(Buffer.from(encoded));
+    }
+    /**
+     * Writes an ASCII string (null-terminated)
+     */
+    writeAsciiString(str) {
+        this.sb.writeString(str + "\0", "ascii");
+    }
+    /**
+     * Writes a UTF-16LE string (null-terminated)
+     */
+    writeUtf16LEString(str) {
+        const buf = Buffer.from(str + "\0", "utf16le");
+        this.sb.writeBuffer(buf);
+    }
+    /**
+     * Gets the final buffer
+     */
+    toBuffer() {
+        return this.sb.toBuffer();
+    }
+}
+/**
+ * Encodes a VarInt to a Buffer using protobufjs (standalone utility)
+ */
+export function encodeVarInt(value) {
+    const writer = protobuf.Writer.create();
+    writer.uint32(value);
+    return Buffer.from(writer.finish());
+}
+/**
+ * Calculates the byte size needed for a VarInt
+ */
+export function varIntSize(value) {
+    if (value < 0x80)
+        return 1;
+    if (value < 0x4000)
+        return 2;
+    if (value < 0x200000)
+        return 3;
+    if (value < 0x10000000)
+        return 4;
+    return 5;
+}
+//# sourceMappingURL=BinaryWriter.js.map

package/dist/src/io/BinaryWriter.js.map

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

package/dist/src/parser/FlpParser.d.ts

@@ -0,0 +1,90 @@
+/**
+ * FL Studio .flp file parser and serializer
+ * Conservative patch approach: preserves all unknown data byte-for-byte
+ */
+/**
+ * Represents a single event in an FLP file
+ * Stores raw bytes to enable conservative patching
+ */
+export interface FlpEvent {
+    /** Event ID (0-255) */
+    id: number;
+    /** Data type classification */
+    kind: "u8" | "i8" | "u16" | "i16" | "u32" | "i32" | "f32" | "text" | "data" | "unknown";
+    /** Original header bytes (ID + size for variable-length events) */
+    header: Buffer;
+    /** Event payload data */
+    payload: Buffer;
+}
+/**
+ * Represents a parsed FLP file
+ * Contains all data needed for conservative round-trip
+ */
+export interface ParsedFlp {
+    /** FLhd chunk (header) - 14 bytes total */
+    headerChunkBytes: Buffer;
+    /** FLdt chunk header (magic + size placeholder) - 8 bytes */
+    fldtHeaderBytes: Buffer;
+    /** All events from the FLdt chunk */
+    events: FlpEvent[];
+    /** Any trailing bytes after events (should be empty) */
+    trailingBytes: Buffer | undefined;
+    /** Detected FL version for string encoding */
+    flVersion: string;
+    /** Whether to use UTF-16LE for strings (FL >= 11.5) */
+    useUnicode: boolean;
+}
+/**
+ * Parses an FL Studio project file
+ *
+ * @param buffer - Raw file data
+ * @returns Parsed FLP structure
+ * @throws Error if file is corrupted or invalid
+ */
+export declare function parseFlp(buffer: Buffer): ParsedFlp;
+/**
+ * Serializes a parsed FLP back to a buffer
+ * Recalculates FLdt chunk size if events have changed
+ *
+ * @param parsed - Parsed FLP structure
+ * @returns Serialized buffer
+ */
+export declare function serializeFlp(parsed: ParsedFlp): Buffer;
+/**
+ * Creates a new event with the given ID and payload
+ */
+export declare function createEvent(id: number, payload: Buffer): FlpEvent;
+/**
+ * Applies a patcher function to all events
+ * Returns a new ParsedFlp with patched events
+ *
+ * @param parsed - Original parsed FLP
+ * @param patcher - Function that transforms each event
+ * @returns New ParsedFlp with patched events
+ */
+export declare function patchEvents(parsed: ParsedFlp, patcher: (event: FlpEvent, index: number) => FlpEvent): ParsedFlp;
+/**
+ * Finds all events with a specific ID
+ */
+export declare function findEvents(parsed: ParsedFlp, eventId: number): FlpEvent[];
+/**
+ * Finds the first event with a specific ID
+ */
+export declare function findFirstEvent(parsed: ParsedFlp, eventId: number): FlpEvent | undefined;
+/**
+ * Gets event payload as a string (handles encoding)
+ */
+export declare function getEventString(event: FlpEvent, useUnicode: boolean): string;
+/**
+ * Creates a text payload with proper encoding
+ */
+export declare function createTextPayload(text: string, useUnicode: boolean): Buffer;
+/**
+ * Gets event payload as a number
+ */
+export declare function getEventNumber(event: FlpEvent): number;
+/**
+ * Creates a numeric payload
+ */
+export declare function createNumberPayload(value: number, kind: "u8" | "i8" | "u16" | "i16" | "u32" | "i32" | "f32"): Buffer;
+//# sourceMappingURL=FlpParser.d.ts.map

package/dist/src/parser/FlpParser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FlpParser.d.ts","sourceRoot":"","sources":["../../../src/parser/FlpParser.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH;;;GAGG;AACH,MAAM,WAAW,QAAQ;IACvB,uBAAuB;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,+BAA+B;IAC/B,IAAI,EAAE,IAAI,GAAG,IAAI,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;IACxF,mEAAmE;IACnE,MAAM,EAAE,MAAM,CAAC;IACf,yBAAyB;IACzB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;GAGG;AACH,MAAM,WAAW,SAAS;IACxB,2CAA2C;IAC3C,gBAAgB,EAAE,MAAM,CAAC;IACzB,6DAA6D;IAC7D,eAAe,EAAE,MAAM,CAAC;IACxB,qCAAqC;IACrC,MAAM,EAAE,QAAQ,EAAE,CAAC;IACnB,wDAAwD;IACxD,aAAa,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,8CAA8C;IAC9C,SAAS,EAAE,MAAM,CAAC;IAClB,uDAAuD;IACvD,UAAU,EAAE,OAAO,CAAC;CACrB;AASD;;;;;;GAMG;AACH,wBAAgB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CA0HlD;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,SAAS,GAAG,MAAM,CAgCtD;AAuBD;;GAEG;AACH,wBAAgB,WAAW,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,QAAQ,CAiBjE;AAED;;;;;;;GAOG;AACH,wBAAgB,WAAW,CACzB,MAAM,EAAE,SAAS,EACjB,OAAO,EAAE,CAAC,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,KAAK,QAAQ,GACpD,SAAS,CAsBX;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,GAAG,QAAQ,EAAE,CAEzE;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS,CAEvF;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,OAAO,GAAG,MAAM,CAc3E;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,GAAG,MAAM,CAM3E;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,QAAQ,GAAG,MAAM,CAqBtD;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,IAAI,GAAG,IAAI,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GACxD,MAAM,CA4BR"}