@vlydev/cs2-masked-inspect-ts 1.0.0

package/dist/esm/InspectLink.js

@@ -0,0 +1,364 @@
+/**
+ * Encodes and decodes CS2 masked inspect links.
+ *
+ * Binary format:
+ *   [key_byte] [proto_bytes XOR'd with key] [4-byte checksum XOR'd with key]
+ *
+ * For tool-generated links key_byte = 0x00 (no XOR needed).
+ * For native CS2 links key_byte != 0x00 — every byte must be XOR'd before parsing.
+ *
+ * Checksum:
+ *   buffer   = [0x00] + proto_bytes
+ *   crc      = crc32(buffer)
+ *   xored    = (crc & 0xffff) ^ (len(proto_bytes) * crc)  [unsigned 32-bit]
+ *   checksum = big-endian uint32 of (xored & 0xFFFFFFFF)
+ */
+import { ItemPreviewData } from "./ItemPreviewData.js";
+import { Sticker } from "./Sticker.js";
+import { ProtoReader } from "./proto/reader.js";
+import { ProtoWriter } from "./proto/writer.js";
+import { crc32 } from "./crc32.js";
+// ------------------------------------------------------------------
+// Checksum helpers
+// ------------------------------------------------------------------
+/**
+ * Compute checksum over [0x00] + proto_bytes.
+ * Returns a 4-byte big-endian Uint8Array.
+ */
+function computeChecksum(buffer, protoLen) {
+    const crcVal = crc32(buffer);
+    const val = BigInt(((crcVal & 0xFFFF) ^ (protoLen * crcVal)) >>> 0) & 0xffffffffn;
+    const result = new Uint8Array(4);
+    const dv = new DataView(result.buffer);
+    dv.setUint32(0, Number(val), false); // big-endian
+    return result;
+}
+// ------------------------------------------------------------------
+// float32 <-> uint32 reinterpretation
+// ------------------------------------------------------------------
+function float32ToUint32(f) {
+    const dv = new DataView(new ArrayBuffer(4));
+    dv.setFloat32(0, f, true); // little-endian
+    return dv.getUint32(0, true);
+}
+function uint32ToFloat32(u) {
+    const dv = new DataView(new ArrayBuffer(4));
+    dv.setUint32(0, u >>> 0, true);
+    return dv.getFloat32(0, true);
+}
+// ------------------------------------------------------------------
+// Hex encoding / decoding helpers
+// ------------------------------------------------------------------
+function hexToBytes(hex) {
+    const bytes = new Uint8Array(hex.length / 2);
+    for (let i = 0; i < bytes.length; i++) {
+        bytes[i] = parseInt(hex.slice(i * 2, i * 2 + 2), 16);
+    }
+    return bytes;
+}
+function bytesToHex(bytes) {
+    return Array.from(bytes)
+        .map(b => b.toString(16).padStart(2, '0'))
+        .join('')
+        .toUpperCase();
+}
+function concatBytes(...arrays) {
+    const totalLength = arrays.reduce((sum, arr) => sum + arr.length, 0);
+    const result = new Uint8Array(totalLength);
+    let offset = 0;
+    for (const arr of arrays) {
+        result.set(arr, offset);
+        offset += arr.length;
+    }
+    return result;
+}
+// ------------------------------------------------------------------
+// URL extraction
+// ------------------------------------------------------------------
+const INSPECT_URL_RE = /(?:%20|\s|\+)A([0-9A-Fa-f]+)/i;
+const HYBRID_URL_RE = /S\d+A\d+D([0-9A-Fa-f]+)$/i;
+const CLASSIC_URL_RE = /csgo_econ_action_preview(?:%20|\s)[SM]\d+A\d+D\d+$/i;
+const MASKED_URL_RE = /csgo_econ_action_preview(?:%20|\s)[0-9A-Fa-f]{10,}$/i;
+function extractHex(input) {
+    const stripped = input.trim();
+    // Hybrid format: S\d+A\d+D<hexproto>
+    const mh = stripped.match(HYBRID_URL_RE);
+    if (mh && /[A-Fa-f]/.test(mh[1]))
+        return mh[1];
+    // Classic/market URL: A<hex> preceded by %20, space, or + (A is a prefix marker, not hex).
+    // If stripping A yields odd-length hex, A is actually the first byte of the payload —
+    // fall through to the pure-masked check below which captures it with A included.
+    const m = stripped.match(INSPECT_URL_RE);
+    if (m && m[1].length % 2 === 0)
+        return m[1];
+    // Pure masked format: csgo_econ_action_preview%20<hexblob> (no S/A/M prefix).
+    // Also handles payloads whose first hex character happens to be A.
+    const mm = stripped.match(/csgo_econ_action_preview(?:%20|\s|\+)([0-9A-Fa-f]{10,})$/i);
+    if (mm)
+        return mm[1];
+    // Bare hex — strip whitespace
+    return stripped.replace(/\s+/g, '');
+}
+// ------------------------------------------------------------------
+// Sticker encode / decode
+// ------------------------------------------------------------------
+function encodeSticker(s) {
+    const w = new ProtoWriter();
+    w.writeUint32(1, s.slot);
+    w.writeUint32(2, s.stickerId);
+    if (s.wear !== null)
+        w.writeFloat32Fixed(3, s.wear);
+    if (s.scale !== null)
+        w.writeFloat32Fixed(4, s.scale);
+    if (s.rotation !== null)
+        w.writeFloat32Fixed(5, s.rotation);
+    w.writeUint32(6, s.tintId);
+    if (s.offsetX !== null)
+        w.writeFloat32Fixed(7, s.offsetX);
+    if (s.offsetY !== null)
+        w.writeFloat32Fixed(8, s.offsetY);
+    if (s.offsetZ !== null)
+        w.writeFloat32Fixed(9, s.offsetZ);
+    w.writeUint32(10, s.pattern);
+    if (s.highlightReel != null)
+        w.writeUint32(11, s.highlightReel);
+    return w.toBytes();
+}
+function decodeSticker(data) {
+    const reader = new ProtoReader(data);
+    const s = new Sticker();
+    for (const f of reader.readAllFields()) {
+        switch (f.field) {
+            case 1:
+                s.slot = Number(f.value);
+                break;
+            case 2:
+                s.stickerId = Number(f.value);
+                break;
+            case 3: {
+                const bytes = f.value;
+                const dv = new DataView(bytes.buffer, bytes.byteOffset, bytes.byteLength);
+                s.wear = dv.getFloat32(0, true);
+                break;
+            }
+            case 4: {
+                const bytes = f.value;
+                const dv = new DataView(bytes.buffer, bytes.byteOffset, bytes.byteLength);
+                s.scale = dv.getFloat32(0, true);
+                break;
+            }
+            case 5: {
+                const bytes = f.value;
+                const dv = new DataView(bytes.buffer, bytes.byteOffset, bytes.byteLength);
+                s.rotation = dv.getFloat32(0, true);
+                break;
+            }
+            case 6:
+                s.tintId = Number(f.value);
+                break;
+            case 7: {
+                const bytes = f.value;
+                const dv = new DataView(bytes.buffer, bytes.byteOffset, bytes.byteLength);
+                s.offsetX = dv.getFloat32(0, true);
+                break;
+            }
+            case 8: {
+                const bytes = f.value;
+                const dv = new DataView(bytes.buffer, bytes.byteOffset, bytes.byteLength);
+                s.offsetY = dv.getFloat32(0, true);
+                break;
+            }
+            case 9: {
+                const bytes = f.value;
+                const dv = new DataView(bytes.buffer, bytes.byteOffset, bytes.byteLength);
+                s.offsetZ = dv.getFloat32(0, true);
+                break;
+            }
+            case 10:
+                s.pattern = Number(f.value);
+                break;
+            case 11:
+                s.highlightReel = Number(f.value);
+                break;
+            default: break;
+        }
+    }
+    return s;
+}
+// ------------------------------------------------------------------
+// ItemPreviewData encode / decode
+// ------------------------------------------------------------------
+function encodeItem(item) {
+    const w = new ProtoWriter();
+    w.writeUint32(1, item.accountId);
+    w.writeUint64(2, item.itemId);
+    w.writeUint32(3, item.defIndex);
+    w.writeUint32(4, item.paintIndex);
+    w.writeUint32(5, item.rarity);
+    w.writeUint32(6, item.quality);
+    // paintWear: float32 reinterpreted as uint32 varint
+    if (item.paintWear != null) {
+        w.writeUint32(7, float32ToUint32(item.paintWear));
+    }
+    w.writeUint32(8, item.paintSeed);
+    w.writeUint32(9, item.killEaterScoreType);
+    w.writeUint32(10, item.killEaterValue);
+    w.writeString(11, item.customName);
+    for (const sticker of item.stickers) {
+        w.writeRawBytes(12, encodeSticker(sticker));
+    }
+    w.writeUint32(13, item.inventory);
+    w.writeUint32(14, item.origin);
+    w.writeUint32(15, item.questId);
+    w.writeUint32(16, item.dropReason);
+    w.writeUint32(17, item.musicIndex);
+    w.writeInt32(18, item.entIndex);
+    w.writeUint32(19, item.petIndex);
+    for (const kc of item.keychains) {
+        w.writeRawBytes(20, encodeSticker(kc));
+    }
+    return w.toBytes();
+}
+function decodeItem(data) {
+    const reader = new ProtoReader(data);
+    const item = new ItemPreviewData();
+    for (const f of reader.readAllFields()) {
+        switch (f.field) {
+            case 1:
+                item.accountId = Number(f.value);
+                break;
+            case 2:
+                item.itemId = Number(f.value);
+                break;
+            case 3:
+                item.defIndex = Number(f.value);
+                break;
+            case 4:
+                item.paintIndex = Number(f.value);
+                break;
+            case 5:
+                item.rarity = Number(f.value);
+                break;
+            case 6:
+                item.quality = Number(f.value);
+                break;
+            case 7:
+                item.paintWear = uint32ToFloat32(Number(f.value));
+                break;
+            case 8:
+                item.paintSeed = Number(f.value);
+                break;
+            case 9:
+                item.killEaterScoreType = Number(f.value);
+                break;
+            case 10:
+                item.killEaterValue = Number(f.value);
+                break;
+            case 11:
+                item.customName = new TextDecoder().decode(f.value);
+                break;
+            case 12:
+                item.stickers.push(decodeSticker(f.value));
+                break;
+            case 13:
+                item.inventory = Number(f.value);
+                break;
+            case 14:
+                item.origin = Number(f.value);
+                break;
+            case 15:
+                item.questId = Number(f.value);
+                break;
+            case 16:
+                item.dropReason = Number(f.value);
+                break;
+            case 17:
+                item.musicIndex = Number(f.value);
+                break;
+            case 18:
+                item.entIndex = Number(f.value);
+                break;
+            case 19:
+                item.petIndex = Number(f.value);
+                break;
+            case 20:
+                item.keychains.push(decodeSticker(f.value));
+                break;
+            default: break;
+        }
+    }
+    return item;
+}
+// ------------------------------------------------------------------
+// Public API
+// ------------------------------------------------------------------
+export class InspectLink {
+    /**
+     * Encode an ItemPreviewData to an uppercase hex inspect-link payload.
+     *
+     * The returned string can be appended to a steam:// inspect URL or used
+     * standalone. The key_byte is always 0x00 (no XOR applied).
+     */
+    static serialize(data) {
+        if (data.paintWear != null && (data.paintWear < 0.0 || data.paintWear > 1.0)) {
+            throw new RangeError(`paintwear must be in [0.0, 1.0], got ${data.paintWear}`);
+        }
+        if (data.customName != null && data.customName.length > 100) {
+            throw new RangeError(`customname must not exceed 100 characters, got ${data.customName.length}`);
+        }
+        const protoBytes = encodeItem(data);
+        const buffer = concatBytes(new Uint8Array([0x00]), protoBytes);
+        const checksum = computeChecksum(buffer, protoBytes.length);
+        return bytesToHex(concatBytes(buffer, checksum));
+    }
+    /**
+     * Returns true if the link contains a decodable protobuf payload (can be decoded offline).
+     */
+    static isMasked(link) {
+        const s = link.trim();
+        if (MASKED_URL_RE.test(s))
+            return true;
+        const m = s.match(HYBRID_URL_RE);
+        return !!(m && /[A-Fa-f]/.test(m[1]));
+    }
+    /**
+     * Returns true if the link is a classic S/A/D inspect URL with decimal did.
+     */
+    static isClassic(link) {
+        return CLASSIC_URL_RE.test(link.trim());
+    }
+    /**
+     * Decode an inspect-link hex payload (or full URL) into an ItemPreviewData.
+     *
+     * Accepts:
+     *   - A raw uppercase or lowercase hex string
+     *   - A full steam://rungame/... inspect URL
+     *   - A CS2-style csgo://rungame/... URL
+     *
+     * Handles the XOR obfuscation used in native CS2 links.
+     */
+    static deserialize(input) {
+        const hex = extractHex(input);
+        if (hex.length > 4096) {
+            throw new RangeError(`Payload too long (max 4096 hex chars): "${input.slice(0, 64)}..."`);
+        }
+        const raw = hexToBytes(hex);
+        if (raw.length < 6) {
+            throw new TypeError(`Payload too short or invalid hex: "${input}"`);
+        }
+        const key = raw[0];
+        let decrypted;
+        if (key === 0) {
+            decrypted = raw;
+        }
+        else {
+            decrypted = new Uint8Array(raw.length);
+            for (let i = 0; i < raw.length; i++) {
+                decrypted[i] = raw[i] ^ key;
+            }
+        }
+        // Layout: [key_byte] [proto_bytes] [4-byte checksum]
+        const protoBytes = decrypted.slice(1, decrypted.length - 4);
+        return decodeItem(protoBytes);
+    }
+}

package/dist/esm/ItemPreviewData.d.ts

@@ -0,0 +1,59 @@
+import { Sticker } from './Sticker.ts';
+/**
+ * Represents a CS2 item as encoded in an inspect link.
+ *
+ * Fields map directly to the CEconItemPreviewDataBlock protobuf message
+ * used by the CS2 game coordinator.
+ *
+ * paintWear is stored as a float32 (IEEE 754). On the wire it is reinterpreted
+ * as a uint32 — this class always exposes it as a JavaScript number for convenience.
+ *
+ * accountId and itemId may be large integers; they are stored as number but
+ * can also accept bigint for construction (values > 2^53 should use bigint).
+ */
+export interface ItemPreviewDataInit {
+    accountId?: number | bigint;
+    itemId?: number | bigint;
+    defIndex?: number;
+    paintIndex?: number;
+    rarity?: number;
+    quality?: number;
+    paintWear?: number | null;
+    paintSeed?: number;
+    killEaterScoreType?: number;
+    killEaterValue?: number;
+    customName?: string;
+    stickers?: Sticker[];
+    inventory?: number;
+    origin?: number;
+    questId?: number;
+    dropReason?: number;
+    musicIndex?: number;
+    entIndex?: number;
+    petIndex?: number;
+    keychains?: Sticker[];
+}
+export declare class ItemPreviewData {
+    accountId: number | bigint;
+    itemId: number | bigint;
+    defIndex: number;
+    paintIndex: number;
+    rarity: number;
+    quality: number;
+    paintWear: number | null;
+    paintSeed: number;
+    killEaterScoreType: number;
+    killEaterValue: number;
+    customName: string;
+    stickers: Sticker[];
+    inventory: number;
+    origin: number;
+    questId: number;
+    dropReason: number;
+    musicIndex: number;
+    entIndex: number;
+    petIndex: number;
+    keychains: Sticker[];
+    constructor({ accountId, itemId, defIndex, paintIndex, rarity, quality, paintWear, paintSeed, killEaterScoreType, killEaterValue, customName, stickers, inventory, origin, questId, dropReason, musicIndex, entIndex, petIndex, keychains, }?: ItemPreviewDataInit);
+}
+//# sourceMappingURL=ItemPreviewData.d.ts.map

package/dist/esm/ItemPreviewData.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ItemPreviewData.d.ts","sourceRoot":"","sources":["../../src/ItemPreviewData.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,mBAAmB;IAClC,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC5B,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,OAAO,EAAE,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,OAAO,EAAE,CAAC;CACvB;AAED,qBAAa,eAAe;IAC1B,SAAS,EAAE,MAAM,GAAG,MAAM,CAAC;IAC3B,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,OAAO,EAAE,CAAC;gBAET,EACV,SAAa,EACb,MAAU,EACV,QAAY,EACZ,UAAc,EACd,MAAU,EACV,OAAW,EACX,SAAgB,EAChB,SAAa,EACb,kBAAsB,EACtB,cAAkB,EAClB,UAAe,EACf,QAAa,EACb,SAAa,EACb,MAAU,EACV,OAAW,EACX,UAAc,EACd,UAAc,EACd,QAAY,EACZ,QAAY,EACZ,SAAc,GACf,GAAE,mBAAwB;CAsB5B"}

package/dist/esm/ItemPreviewData.js

@@ -0,0 +1,24 @@
+export class ItemPreviewData {
+    constructor({ accountId = 0, itemId = 0, defIndex = 0, paintIndex = 0, rarity = 0, quality = 0, paintWear = null, paintSeed = 0, killEaterScoreType = 0, killEaterValue = 0, customName = '', stickers = [], inventory = 0, origin = 0, questId = 0, dropReason = 0, musicIndex = 0, entIndex = 0, petIndex = 0, keychains = [], } = {}) {
+        this.accountId = accountId;
+        this.itemId = itemId;
+        this.defIndex = defIndex;
+        this.paintIndex = paintIndex;
+        this.rarity = rarity;
+        this.quality = quality;
+        this.paintWear = paintWear;
+        this.paintSeed = paintSeed;
+        this.killEaterScoreType = killEaterScoreType;
+        this.killEaterValue = killEaterValue;
+        this.customName = customName;
+        this.stickers = stickers;
+        this.inventory = inventory;
+        this.origin = origin;
+        this.questId = questId;
+        this.dropReason = dropReason;
+        this.musicIndex = musicIndex;
+        this.entIndex = entIndex;
+        this.petIndex = petIndex;
+        this.keychains = keychains;
+    }
+}

package/dist/esm/Sticker.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Represents a sticker or keychain applied to a CS2 item.
+ *
+ * Maps to the Sticker protobuf message nested inside CEconItemPreviewDataBlock.
+ * The same message is used for both stickers (field 12) and keychains (field 20).
+ */
+export interface StickerInit {
+    slot?: number;
+    stickerId?: number;
+    wear?: number | null;
+    scale?: number | null;
+    rotation?: number | null;
+    tintId?: number;
+    offsetX?: number | null;
+    offsetY?: number | null;
+    offsetZ?: number | null;
+    pattern?: number;
+    highlightReel?: number | null;
+}
+export declare class Sticker {
+    slot: number;
+    stickerId: number;
+    wear: number | null;
+    scale: number | null;
+    rotation: number | null;
+    tintId: number;
+    offsetX: number | null;
+    offsetY: number | null;
+    offsetZ: number | null;
+    pattern: number;
+    highlightReel: number | null;
+    constructor({ slot, stickerId, wear, scale, rotation, tintId, offsetX, offsetY, offsetZ, pattern, highlightReel, }?: StickerInit);
+}
+//# sourceMappingURL=Sticker.d.ts.map

package/dist/esm/Sticker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Sticker.d.ts","sourceRoot":"","sources":["../../src/Sticker.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,WAAW,WAAW;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B;AAED,qBAAa,OAAO;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;gBAEjB,EACV,IAAQ,EACR,SAAa,EACb,IAAW,EACX,KAAY,EACZ,QAAe,EACf,MAAU,EACV,OAAc,EACd,OAAc,EACd,OAAc,EACd,OAAW,EACX,aAAoB,GACrB,GAAE,WAAgB;CAapB"}

package/dist/esm/Sticker.js

@@ -0,0 +1,15 @@
+export class Sticker {
+    constructor({ slot = 0, stickerId = 0, wear = null, scale = null, rotation = null, tintId = 0, offsetX = null, offsetY = null, offsetZ = null, pattern = 0, highlightReel = null, } = {}) {
+        this.slot = slot;
+        this.stickerId = stickerId;
+        this.wear = wear;
+        this.scale = scale;
+        this.rotation = rotation;
+        this.tintId = tintId;
+        this.offsetX = offsetX;
+        this.offsetY = offsetY;
+        this.offsetZ = offsetZ;
+        this.pattern = pattern;
+        this.highlightReel = highlightReel;
+    }
+}

package/dist/esm/crc32.d.ts

@@ -0,0 +1,9 @@
+/**
+ * CRC32 implementation using standard polynomial 0xEDB88320 (same as zlib/PHP crc32).
+ */
+/**
+ * Compute CRC32 of a Uint8Array.
+ * @returns unsigned 32-bit CRC32
+ */
+export declare function crc32(buf: Uint8Array): number;
+//# sourceMappingURL=crc32.d.ts.map

package/dist/esm/crc32.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"crc32.d.ts","sourceRoot":"","sources":["../../src/crc32.ts"],"names":[],"mappings":"AAAA;;GAEG;AAcH;;;GAGG;AACH,wBAAgB,KAAK,CAAC,GAAG,EAAE,UAAU,GAAG,MAAM,CAM7C"}

package/dist/esm/crc32.js

@@ -0,0 +1,25 @@
+/**
+ * CRC32 implementation using standard polynomial 0xEDB88320 (same as zlib/PHP crc32).
+ */
+const CRC32_TABLE = (() => {
+    const table = new Uint32Array(256);
+    for (let i = 0; i < 256; i++) {
+        let c = i;
+        for (let j = 0; j < 8; j++) {
+            c = (c & 1) ? (0xEDB88320 ^ (c >>> 1)) : (c >>> 1);
+        }
+        table[i] = c;
+    }
+    return table;
+})();
+/**
+ * Compute CRC32 of a Uint8Array.
+ * @returns unsigned 32-bit CRC32
+ */
+export function crc32(buf) {
+    let crc = 0xFFFFFFFF;
+    for (let i = 0; i < buf.length; i++) {
+        crc = (crc >>> 8) ^ CRC32_TABLE[(crc ^ buf[i]) & 0xFF];
+    }
+    return (crc ^ 0xFFFFFFFF) >>> 0;
+}

package/dist/esm/index.d.ts

@@ -0,0 +1,10 @@
+export { InspectLink } from './InspectLink.ts';
+export { ItemPreviewData } from './ItemPreviewData.ts';
+export type { ItemPreviewDataInit } from './ItemPreviewData.ts';
+export { Sticker } from './Sticker.ts';
+export type { StickerInit } from './Sticker.ts';
+export { crc32 } from './crc32.ts';
+export { ProtoReader } from './proto/reader.ts';
+export type { ProtoField } from './proto/reader.ts';
+export { ProtoWriter } from './proto/writer.ts';
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,YAAY,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAChE,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,YAAY,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,YAAY,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/esm/index.js

@@ -0,0 +1,6 @@
+export { InspectLink } from "./InspectLink.js";
+export { ItemPreviewData } from "./ItemPreviewData.js";
+export { Sticker } from "./Sticker.js";
+export { crc32 } from "./crc32.js";
+export { ProtoReader } from "./proto/reader.js";
+export { ProtoWriter } from "./proto/writer.js";

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

@@ -0,0 +1,42 @@
+/**
+ * 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 declare const WIRE_VARINT = 0;
+export declare const WIRE_64BIT = 1;
+export declare const WIRE_LEN = 2;
+export declare const WIRE_32BIT = 5;
+export interface ProtoField {
+    field: number;
+    wire: number;
+    value: bigint | Uint8Array;
+}
+export declare class ProtoReader {
+    private readonly _data;
+    private _pos;
+    constructor(data: Uint8Array);
+    get pos(): number;
+    remaining(): number;
+    readByte(): number;
+    readBytes(n: number): Uint8Array;
+    /**
+     * Read a base-128 varint.
+     * Returns a BigInt for 64-bit range safety; callers convert as needed.
+     */
+    readVarint(): bigint;
+    /**
+     * Read tag and return [fieldNumber, wireType].
+     */
+    readTag(): [number, number];
+    readLengthDelimited(): Uint8Array;
+    /**
+     * Read all fields until EOF.
+     * Max 100 fields enforced.
+     */
+    readAllFields(): ProtoField[];
+}
+//# sourceMappingURL=reader.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"reader.d.ts","sourceRoot":"","sources":["../../../src/proto/reader.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,eAAO,MAAM,WAAW,IAAI,CAAC;AAC7B,eAAO,MAAM,UAAU,IAAK,CAAC;AAC7B,eAAO,MAAM,QAAQ,IAAO,CAAC;AAC7B,eAAO,MAAM,UAAU,IAAK,CAAC;AAE7B,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,GAAG,UAAU,CAAC;CAC5B;AAED,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAa;IACnC,OAAO,CAAC,IAAI,CAAS;gBAET,IAAI,EAAE,UAAU;IAK5B,IAAI,GAAG,IAAI,MAAM,CAEhB;IAED,SAAS,IAAI,MAAM;IAInB,QAAQ,IAAI,MAAM;IAOlB,SAAS,CAAC,CAAC,EAAE,MAAM,GAAG,UAAU;IAWhC;;;OAGG;IACH,UAAU,IAAI,MAAM;IAiBpB;;OAEG;IACH,OAAO,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC;IAK3B,mBAAmB,IAAI,UAAU;IAKjC;;;OAGG;IACH,aAAa,IAAI,UAAU,EAAE;CAmC9B"}