@csfloat/cs2-inspect-serializer 1.0.1 → 1.1.0

package/README.md

@@ -1,6 +1,6 @@
 # CS2 Inspect Link Serializer
 
-Lightweight serializer for CS2 inspect links. Fork of the package
+Lightweight serializer and decoder for CS2 inspect links. Fork of the package
 [cs2-inspect-create](https://github.com/candyboyz/cs2-inspect-create).
 
 # Installation
@@ -13,6 +13,26 @@ npm i @csfloat/cs2-inspect-serializer
 
 See the [tests](tests/gen.test.ts) for examples.
 
+```ts
+import { decodeHex, decodeLink, generateHex, generateLink } from "@csfloat/cs2-inspect-serializer";
+
+const props = {
+	defindex: 7,
+	paintindex: 474,
+	paintseed: 306,
+	paintwear: 0.6336590647697449,
+	rarity: 6,
+	stickers: [],
+	keychains: [],
+};
+
+const hex = generateHex(props);
+const link = generateLink(props);
+
+decodeHex(hex);
+decodeLink(link);
+```
+
 # Development
 
 ```bash

package/dist/index.d.mts

@@ -149,6 +149,9 @@ interface CEconItemPreviewDataBlock_Sticker {
  */
 declare const CEconItemPreviewDataBlock_Sticker: CEconItemPreviewDataBlock_Sticker$Type;
 
+declare const decodeHex: (hex: string) => CEconItemPreviewDataBlock;
+declare const decodeLink: (link: string) => CEconItemPreviewDataBlock;
+
 declare const previewLink = "steam://rungame/730/76561202255233023/+csgo_econ_action_preview";
 /**
  * Creates the hex representation of the inspect data
@@ -163,4 +166,4 @@ declare const generateHex: ({ paintwear, ...props }: CEconItemPreviewDataBlock)
  */
 declare const generateLink: (props: CEconItemPreviewDataBlock) => string;
 
-export { generateHex, generateLink, previewLink };
+export { CEconItemPreviewDataBlock, decodeHex, decodeLink, generateHex, generateLink, previewLink };

package/dist/index.d.ts

@@ -149,6 +149,9 @@ interface CEconItemPreviewDataBlock_Sticker {
  */
 declare const CEconItemPreviewDataBlock_Sticker: CEconItemPreviewDataBlock_Sticker$Type;
 
+declare const decodeHex: (hex: string) => CEconItemPreviewDataBlock;
+declare const decodeLink: (link: string) => CEconItemPreviewDataBlock;
+
 declare const previewLink = "steam://rungame/730/76561202255233023/+csgo_econ_action_preview";
 /**
  * Creates the hex representation of the inspect data
@@ -163,4 +166,4 @@ declare const generateHex: ({ paintwear, ...props }: CEconItemPreviewDataBlock)
  */
 declare const generateLink: (props: CEconItemPreviewDataBlock) => string;
 
-export { generateHex, generateLink, previewLink };
+export { CEconItemPreviewDataBlock, decodeHex, decodeLink, generateHex, generateLink, previewLink };

package/dist/index.js

@@ -30,6 +30,9 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/index.ts
 var index_exports = {};
 __export(index_exports, {
+  CEconItemPreviewDataBlock: () => CEconItemPreviewDataBlock,
+  decodeHex: () => decodeHex,
+  decodeLink: () => decodeLink,
   generateHex: () => generateHex,
   generateLink: () => generateLink,
   previewLink: () => previewLink
@@ -289,27 +292,125 @@ var CEconItemPreviewDataBlock_Sticker$Type = class extends import_runtime.Messag
 var CEconItemPreviewDataBlock_Sticker = new CEconItemPreviewDataBlock_Sticker$Type();
 
 // src/index.ts
+var import_buffer3 = require("buffer");
+
+// src/decode.ts
+var import_buffer2 = require("buffer");
+
+// src/inspect-payload.ts
 var import_crc_32 = __toESM(require("crc-32"));
 var import_buffer = require("buffer");
-var previewLink = "steam://rungame/730/76561202255233023/+csgo_econ_action_preview";
 var floatToBytes = (floatValue) => {
-  const floatArray = new Float32Array(1);
-  floatArray[0] = floatValue;
-  const byteArray = new Uint32Array(floatArray.buffer);
-  return byteArray[0];
+  const buffer = new ArrayBuffer(4);
+  const view = new DataView(buffer);
+  view.setFloat32(0, floatValue, true);
+  return view.getUint32(0, true);
+};
+var bytesToFloat = (uintValue) => {
+  const buffer = new ArrayBuffer(4);
+  const view = new DataView(buffer);
+  view.setUint32(0, uintValue, true);
+  return view.getFloat32(0, true);
+};
+var getChecksum = (payload) => {
+  const bufferPayload = import_buffer.Buffer.concat([Uint8Array.from([0]), payload]);
+  const crc = import_crc_32.default.buf(bufferPayload);
+  const x_crc = crc & 65535 ^ payload.byteLength * crc;
+  return (x_crc & 4294967295) >>> 0;
 };
+
+// src/decode.ts
+var normalizeDecodedEcon = (econ) => {
+  return {
+    ...econ,
+    paintwear: econ.paintwear === void 0 ? void 0 : bytesToFloat(econ.paintwear)
+  };
+};
+var hasDecodedInspectPayload = (econ) => {
+  return econ.itemid !== void 0 || econ.defindex !== void 0 || econ.paintindex !== void 0 || econ.paintseed !== void 0 || econ.stickers.length > 0 || econ.keychains.length > 0;
+};
+var assertValidHex = (hex) => {
+  if (!/^[0-9A-F]+$/i.test(hex) || hex.length % 2 !== 0) {
+    throw new Error("Invalid inspect hex payload");
+  }
+};
+var decodeURIComponentSafely = (value) => {
+  try {
+    return decodeURIComponent(value);
+  } catch {
+    return value;
+  }
+};
+var extractHexFromLink = (link) => {
+  const decodedLink = decodeURIComponentSafely(link.trim());
+  const linkMatch = decodedLink.match(
+    /^(?:steam:\/\/(?:run|rungame)\/730\/(?:76561202255233023\/)?\/?)?\+?csgo_econ_action_preview\s+([0-9A-F]+)$/i
+  );
+  if (linkMatch?.[1]) {
+    assertValidHex(linkMatch[1]);
+    return linkMatch[1];
+  }
+  throw new Error("Invalid inspect link");
+};
+var decodePayload = (payload, isValidPayload) => {
+  const econ = normalizeDecodedEcon(CEconItemPreviewDataBlock.fromBinary(payload));
+  if (!isValidPayload(econ)) {
+    throw new Error("Invalid inspect hex payload");
+  }
+  return econ;
+};
+var decodeWrappedBuffer = (buffer) => {
+  if (buffer.length < 5 || buffer[0] !== 0) {
+    throw new Error("Invalid inspect hex payload");
+  }
+  const payload = buffer.subarray(1, -4);
+  const expectedChecksum = buffer.readUInt32BE(buffer.length - 4);
+  const actualChecksum = getChecksum(payload);
+  if (expectedChecksum !== actualChecksum) {
+    throw new Error("Inspect hex checksum mismatch");
+  }
+  return decodePayload(payload, hasDecodedInspectPayload);
+};
+var isDecodedMaskedInspectPayload = (econ) => {
+  return econ.itemid !== void 0 && econ.defindex !== void 0 && econ.paintindex !== void 0 && econ.inventory !== void 0 && econ.origin !== void 0;
+};
+var decodeMaskedBuffer = (buffer) => {
+  if (buffer.length < 5) {
+    throw new Error("Invalid inspect hex payload");
+  }
+  const unmaskedBuffer = xorMaskBuffer(buffer, buffer[0]);
+  if (unmaskedBuffer[0] !== 0) {
+    throw new Error("Invalid inspect hex payload");
+  }
+  return decodePayload(unmaskedBuffer.subarray(1, -4), isDecodedMaskedInspectPayload);
+};
+var xorMaskBuffer = (buffer, key) => {
+  return import_buffer2.Buffer.from(buffer.map((byte) => byte ^ key));
+};
+var decodeHex = (hex) => {
+  const normalizedHex = hex.trim();
+  assertValidHex(normalizedHex);
+  const buffer = import_buffer2.Buffer.from(normalizedHex, "hex");
+  if (buffer[0] === 0) {
+    return decodeWrappedBuffer(buffer);
+  }
+  return decodeMaskedBuffer(buffer);
+};
+var decodeLink = (link) => {
+  return decodeHex(extractHexFromLink(link));
+};
+
+// src/index.ts
+var previewLink = "steam://rungame/730/76561202255233023/+csgo_econ_action_preview";
 var generateHex = ({ paintwear = 1e-3, ...props }) => {
   const econ = {
     ...props,
     paintwear: floatToBytes(paintwear)
   };
   const payload = CEconItemPreviewDataBlock.toBinary(econ);
-  const bufferPayload = import_buffer.Buffer.concat([Uint8Array.from([0]), payload]);
-  const crc = import_crc_32.default.buf(bufferPayload);
-  const x_crc = crc & 65535 ^ payload.byteLength * crc;
-  const crcBuffer = import_buffer.Buffer.alloc(4);
-  crcBuffer.writeUInt32BE((x_crc & 4294967295) >>> 0, 0);
-  return import_buffer.Buffer.concat([bufferPayload, crcBuffer]).toString("hex").toUpperCase();
+  const crcBuffer = import_buffer3.Buffer.alloc(4);
+  crcBuffer.writeUInt32BE(getChecksum(payload), 0);
+  return import_buffer3.Buffer.concat([Uint8Array.from([0]), payload, crcBuffer]).toString("hex").toUpperCase();
 };
 var generateLink = (props) => {
   const hex = generateHex(props);
@@ -317,6 +418,9 @@ var generateLink = (props) => {
 };
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  CEconItemPreviewDataBlock,
+  decodeHex,
+  decodeLink,
   generateHex,
   generateLink,
   previewLink

package/dist/index.mjs

@@ -251,33 +251,134 @@ var CEconItemPreviewDataBlock_Sticker$Type = class extends MessageType {
 var CEconItemPreviewDataBlock_Sticker = new CEconItemPreviewDataBlock_Sticker$Type();
 
 // src/index.ts
+import { Buffer as Buffer3 } from "buffer";
+
+// src/decode.ts
+import { Buffer as Buffer2 } from "buffer";
+
+// src/inspect-payload.ts
 import CRC32 from "crc-32";
 import { Buffer } from "buffer";
-var previewLink = "steam://rungame/730/76561202255233023/+csgo_econ_action_preview";
 var floatToBytes = (floatValue) => {
-  const floatArray = new Float32Array(1);
-  floatArray[0] = floatValue;
-  const byteArray = new Uint32Array(floatArray.buffer);
-  return byteArray[0];
+  const buffer = new ArrayBuffer(4);
+  const view = new DataView(buffer);
+  view.setFloat32(0, floatValue, true);
+  return view.getUint32(0, true);
+};
+var bytesToFloat = (uintValue) => {
+  const buffer = new ArrayBuffer(4);
+  const view = new DataView(buffer);
+  view.setUint32(0, uintValue, true);
+  return view.getFloat32(0, true);
+};
+var getChecksum = (payload) => {
+  const bufferPayload = Buffer.concat([Uint8Array.from([0]), payload]);
+  const crc = CRC32.buf(bufferPayload);
+  const x_crc = crc & 65535 ^ payload.byteLength * crc;
+  return (x_crc & 4294967295) >>> 0;
 };
+
+// src/decode.ts
+var normalizeDecodedEcon = (econ) => {
+  return {
+    ...econ,
+    paintwear: econ.paintwear === void 0 ? void 0 : bytesToFloat(econ.paintwear)
+  };
+};
+var hasDecodedInspectPayload = (econ) => {
+  return econ.itemid !== void 0 || econ.defindex !== void 0 || econ.paintindex !== void 0 || econ.paintseed !== void 0 || econ.stickers.length > 0 || econ.keychains.length > 0;
+};
+var assertValidHex = (hex) => {
+  if (!/^[0-9A-F]+$/i.test(hex) || hex.length % 2 !== 0) {
+    throw new Error("Invalid inspect hex payload");
+  }
+};
+var decodeURIComponentSafely = (value) => {
+  try {
+    return decodeURIComponent(value);
+  } catch {
+    return value;
+  }
+};
+var extractHexFromLink = (link) => {
+  const decodedLink = decodeURIComponentSafely(link.trim());
+  const linkMatch = decodedLink.match(
+    /^(?:steam:\/\/(?:run|rungame)\/730\/(?:76561202255233023\/)?\/?)?\+?csgo_econ_action_preview\s+([0-9A-F]+)$/i
+  );
+  if (linkMatch?.[1]) {
+    assertValidHex(linkMatch[1]);
+    return linkMatch[1];
+  }
+  throw new Error("Invalid inspect link");
+};
+var decodePayload = (payload, isValidPayload) => {
+  const econ = normalizeDecodedEcon(CEconItemPreviewDataBlock.fromBinary(payload));
+  if (!isValidPayload(econ)) {
+    throw new Error("Invalid inspect hex payload");
+  }
+  return econ;
+};
+var decodeWrappedBuffer = (buffer) => {
+  if (buffer.length < 5 || buffer[0] !== 0) {
+    throw new Error("Invalid inspect hex payload");
+  }
+  const payload = buffer.subarray(1, -4);
+  const expectedChecksum = buffer.readUInt32BE(buffer.length - 4);
+  const actualChecksum = getChecksum(payload);
+  if (expectedChecksum !== actualChecksum) {
+    throw new Error("Inspect hex checksum mismatch");
+  }
+  return decodePayload(payload, hasDecodedInspectPayload);
+};
+var isDecodedMaskedInspectPayload = (econ) => {
+  return econ.itemid !== void 0 && econ.defindex !== void 0 && econ.paintindex !== void 0 && econ.inventory !== void 0 && econ.origin !== void 0;
+};
+var decodeMaskedBuffer = (buffer) => {
+  if (buffer.length < 5) {
+    throw new Error("Invalid inspect hex payload");
+  }
+  const unmaskedBuffer = xorMaskBuffer(buffer, buffer[0]);
+  if (unmaskedBuffer[0] !== 0) {
+    throw new Error("Invalid inspect hex payload");
+  }
+  return decodePayload(unmaskedBuffer.subarray(1, -4), isDecodedMaskedInspectPayload);
+};
+var xorMaskBuffer = (buffer, key) => {
+  return Buffer2.from(buffer.map((byte) => byte ^ key));
+};
+var decodeHex = (hex) => {
+  const normalizedHex = hex.trim();
+  assertValidHex(normalizedHex);
+  const buffer = Buffer2.from(normalizedHex, "hex");
+  if (buffer[0] === 0) {
+    return decodeWrappedBuffer(buffer);
+  }
+  return decodeMaskedBuffer(buffer);
+};
+var decodeLink = (link) => {
+  return decodeHex(extractHexFromLink(link));
+};
+
+// src/index.ts
+var previewLink = "steam://rungame/730/76561202255233023/+csgo_econ_action_preview";
 var generateHex = ({ paintwear = 1e-3, ...props }) => {
   const econ = {
     ...props,
     paintwear: floatToBytes(paintwear)
   };
   const payload = CEconItemPreviewDataBlock.toBinary(econ);
-  const bufferPayload = Buffer.concat([Uint8Array.from([0]), payload]);
-  const crc = CRC32.buf(bufferPayload);
-  const x_crc = crc & 65535 ^ payload.byteLength * crc;
-  const crcBuffer = Buffer.alloc(4);
-  crcBuffer.writeUInt32BE((x_crc & 4294967295) >>> 0, 0);
-  return Buffer.concat([bufferPayload, crcBuffer]).toString("hex").toUpperCase();
+  const crcBuffer = Buffer3.alloc(4);
+  crcBuffer.writeUInt32BE(getChecksum(payload), 0);
+  return Buffer3.concat([Uint8Array.from([0]), payload, crcBuffer]).toString("hex").toUpperCase();
 };
 var generateLink = (props) => {
   const hex = generateHex(props);
   return `${previewLink} ${hex}`;
 };
 export {
+  CEconItemPreviewDataBlock,
+  decodeHex,
+  decodeLink,
   generateHex,
   generateLink,
   previewLink

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@csfloat/cs2-inspect-serializer",
-  "version": "1.0.1",
+  "version": "1.1.0",
   "description": "Lightweight serializer for CS2 inspect links",
   "homepage": "https://github.com/csfloat/cs2-inspect-serializer",
   "bugs": {