@vlydev/cs2-masked-inspect-ts 1.0.0

package/dist/esm/proto/reader.js

@@ -0,0 +1,101 @@
+/**
+ * Pure TypeScript protobuf binary reader.
+ *
+ * Implements the subset of wire types needed for CEconItemPreviewDataBlock:
+ *   - Wire type 0: varint (uint32, uint64, int32)
+ *   - Wire type 2: length-delimited (string, bytes, nested messages)
+ *   - Wire type 5: 32-bit fixed (float32)
+ */
+export const WIRE_VARINT = 0;
+export const WIRE_64BIT = 1;
+export const WIRE_LEN = 2;
+export const WIRE_32BIT = 5;
+export class ProtoReader {
+    constructor(data) {
+        this._data = data;
+        this._pos = 0;
+    }
+    get pos() {
+        return this._pos;
+    }
+    remaining() {
+        return this._data.length - this._pos;
+    }
+    readByte() {
+        if (this._pos >= this._data.length) {
+            throw new RangeError('Unexpected end of protobuf data');
+        }
+        return this._data[this._pos++];
+    }
+    readBytes(n) {
+        if (this._pos + n > this._data.length) {
+            throw new RangeError(`Need ${n} bytes but only ${this._data.length - this._pos} remain`);
+        }
+        const chunk = this._data.slice(this._pos, this._pos + n);
+        this._pos += n;
+        return chunk;
+    }
+    /**
+     * Read a base-128 varint.
+     * Returns a BigInt for 64-bit range safety; callers convert as needed.
+     */
+    readVarint() {
+        let result = 0n;
+        let shift = 0n;
+        while (true) {
+            const b = this.readByte();
+            result |= BigInt(b & 0x7F) << shift;
+            if (!(b & 0x80))
+                break;
+            shift += 7n;
+            if (shift > 63n) {
+                throw new RangeError('Varint too long');
+            }
+        }
+        return result;
+    }
+    /**
+     * Read tag and return [fieldNumber, wireType].
+     */
+    readTag() {
+        const tag = this.readVarint();
+        return [Number(tag >> 3n), Number(tag & 7n)];
+    }
+    readLengthDelimited() {
+        const length = Number(this.readVarint());
+        return this.readBytes(length);
+    }
+    /**
+     * Read all fields until EOF.
+     * Max 100 fields enforced.
+     */
+    readAllFields() {
+        const fields = [];
+        let fieldCount = 0;
+        while (this.remaining() > 0) {
+            if (++fieldCount > 100) {
+                throw new RangeError('Protobuf field count exceeds limit of 100');
+            }
+            const [fieldNum, wireType] = this.readTag();
+            let value;
+            switch (wireType) {
+                case WIRE_VARINT:
+                    value = this.readVarint();
+                    break;
+                case WIRE_64BIT:
+                    value = this.readBytes(8);
+                    break;
+                case WIRE_LEN:
+                    value = this.readLengthDelimited();
+                    break;
+                case WIRE_32BIT:
+                    value = this.readBytes(4);
+                    break;
+                default:
+                    throw new RangeError(`Unknown wire type ${wireType} for field ${fieldNum}`);
+            }
+            fields.push({ field: fieldNum, wire: wireType, value });
+        }
+        return fields;
+    }
+}

package/dist/esm/proto/writer.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Pure TypeScript protobuf binary writer.
+ *
+ * Writes to an in-memory buffer; call toBytes() to retrieve the result.
+ * Fields with default/zero values are omitted (proto3 semantics).
+ */
+export declare class ProtoWriter {
+    private _buf;
+    constructor();
+    toBytes(): Uint8Array;
+    private _writeVarint;
+    private _writeTag;
+    writeUint32(fieldNum: number, value: number | bigint): void;
+    writeUint64(fieldNum: number, value: number | bigint): void;
+    writeInt32(fieldNum: number, value: number | bigint): void;
+    writeString(fieldNum: number, value: string): void;
+    /**
+     * Write a float32 as wire type 5 (fixed 32-bit, little-endian).
+     * Used for sticker float fields (wear, scale, rotation, etc.).
+     */
+    writeFloat32Fixed(fieldNum: number, value: number): void;
+    /**
+     * Write raw bytes as a length-delimited field (wire type 2).
+     */
+    writeRawBytes(fieldNum: number, data: Uint8Array): void;
+    /**
+     * Write a nested message (another ProtoWriter's output) as a length-delimited field.
+     */
+    writeEmbedded(fieldNum: number, nested: ProtoWriter): void;
+}
+//# sourceMappingURL=writer.d.ts.map

package/dist/esm/proto/writer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"writer.d.ts","sourceRoot":"","sources":["../../../src/proto/writer.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,qBAAa,WAAW;IACtB,OAAO,CAAC,IAAI,CAAe;;IAM3B,OAAO,IAAI,UAAU;IAerB,OAAO,CAAC,YAAY;IAkBpB,OAAO,CAAC,SAAS;IAQjB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAM3D,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAM3D,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAM1D,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAQlD;;;OAGG;IACH,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAOxD;;OAEG;IACH,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,IAAI;IAOvD;;OAEG;IACH,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,IAAI;CAG3D"}

package/dist/esm/proto/writer.js

@@ -0,0 +1,101 @@
+/**
+ * Pure TypeScript protobuf binary writer.
+ *
+ * Writes to an in-memory buffer; call toBytes() to retrieve the result.
+ * Fields with default/zero values are omitted (proto3 semantics).
+ */
+const WIRE_VARINT = 0;
+const WIRE_LEN = 2;
+const WIRE_32BIT = 5;
+export class ProtoWriter {
+    constructor() {
+        this._buf = [];
+    }
+    toBytes() {
+        const totalLength = this._buf.reduce((sum, chunk) => sum + chunk.length, 0);
+        const result = new Uint8Array(totalLength);
+        let offset = 0;
+        for (const chunk of this._buf) {
+            result.set(chunk, offset);
+            offset += chunk.length;
+        }
+        return result;
+    }
+    // ------------------------------------------------------------------
+    // Low-level primitives
+    // ------------------------------------------------------------------
+    _writeVarint(value) {
+        let v = BigInt(value);
+        // Handle negative: treat as unsigned 64-bit two's complement
+        if (v < 0n) {
+            v = BigInt.asUintN(64, v);
+        }
+        const parts = [];
+        do {
+            let b = Number(v & 0x7fn);
+            v >>= 7n;
+            if (v !== 0n)
+                b |= 0x80;
+            parts.push(b);
+        } while (v !== 0n);
+        this._buf.push(new Uint8Array(parts));
+    }
+    _writeTag(fieldNum, wireType) {
+        this._writeVarint((fieldNum << 3) | wireType);
+    }
+    // ------------------------------------------------------------------
+    // Public field writers
+    // ------------------------------------------------------------------
+    writeUint32(fieldNum, value) {
+        if (value === 0 || value === 0n)
+            return;
+        this._writeTag(fieldNum, WIRE_VARINT);
+        this._writeVarint(value);
+    }
+    writeUint64(fieldNum, value) {
+        if (value === 0 || value === 0n)
+            return;
+        this._writeTag(fieldNum, WIRE_VARINT);
+        this._writeVarint(value);
+    }
+    writeInt32(fieldNum, value) {
+        if (value === 0 || value === 0n)
+            return;
+        this._writeTag(fieldNum, WIRE_VARINT);
+        this._writeVarint(value);
+    }
+    writeString(fieldNum, value) {
+        if (!value)
+            return;
+        const encoded = new TextEncoder().encode(value);
+        this._writeTag(fieldNum, WIRE_LEN);
+        this._writeVarint(encoded.length);
+        this._buf.push(encoded);
+    }
+    /**
+     * Write a float32 as wire type 5 (fixed 32-bit, little-endian).
+     * Used for sticker float fields (wear, scale, rotation, etc.).
+     */
+    writeFloat32Fixed(fieldNum, value) {
+        this._writeTag(fieldNum, WIRE_32BIT);
+        const dv = new DataView(new ArrayBuffer(4));
+        dv.setFloat32(0, value, true); // little-endian
+        this._buf.push(new Uint8Array(dv.buffer));
+    }
+    /**
+     * Write raw bytes as a length-delimited field (wire type 2).
+     */
+    writeRawBytes(fieldNum, data) {
+        if (!data || data.length === 0)
+            return;
+        this._writeTag(fieldNum, WIRE_LEN);
+        this._writeVarint(data.length);
+        this._buf.push(data);
+    }
+    /**
+     * Write a nested message (another ProtoWriter's output) as a length-delimited field.
+     */
+    writeEmbedded(fieldNum, nested) {
+        this.writeRawBytes(fieldNum, nested.toBytes());
+    }
+}

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "@vlydev/cs2-masked-inspect-ts",
+  "version": "1.0.0",
+  "description": "Offline encoder/decoder for CS2 masked inspect URLs — TypeScript, fully typed, no dependencies",
+  "type": "module",
+  "main": "./dist/cjs/index.js",
+  "module": "./dist/esm/index.js",
+  "types": "./dist/esm/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/esm/index.d.ts",
+        "default": "./dist/esm/index.js"
+      },
+      "require": {
+        "types": "./dist/cjs/index.d.ts",
+        "default": "./dist/cjs/index.js"
+      }
+    }
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json && tsc -p tsconfig.cjs.json",
+    "test": "node --experimental-strip-types --test tests/inspect_link.test.ts",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": ["cs2", "csgo", "inspect", "protobuf", "steam", "typescript"],
+  "author": {
+    "name": "VlyDev",
+    "email": "vladdnepr1989@gmail.com",
+    "url": "https://github.com/vlydev"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/vlydev/cs2-masked-inspect-ts"
+  },
+  "license": "MIT",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.6.0"
+  }
+}