@vlydev/cs2-masked-inspect-ts 1.0.1 → 1.1.0

package/README.md

@@ -45,6 +45,31 @@ InspectLink.isMasked('steam://...csgo_econ_action_preview%20A0011...');  // true
 InspectLink.isClassic('steam://...csgo_econ_action_preview%20S123A456D789'); // true — classic S/A/D format
 ```
 
+## Gen codes
+
+Generate a Steam inspect URL from item parameters (defindex, paintindex, paintseed, paintwear):
+
+```ts
+import { generate, toGenCode, parseGenCode, ItemPreviewData } from '@vlydev/cs2-masked-inspect-ts';
+
+// Generate a Steam inspect URL from item parameters
+const url = generate(7, 474, 306, 0.22540508);
+// steam://rungame/730/76561202255233023/+csgo_econ_action_preview%20...
+
+// Convert ItemPreviewData to a gen code string
+const item = new ItemPreviewData({ defIndex: 7, paintIndex: 474, paintSeed: 306, paintWear: 0.22540508 });
+toGenCode(item);        // "!gen 7 474 306 0.22540508"
+toGenCode(item, '!g'); // "!g 7 474 306 0.22540508"
+
+// Parse a gen code back to ItemPreviewData
+parseGenCode('!gen 7 474 306 0.22540508');
+
+// Convert an existing inspect link directly to a gen code
+import { genCodeFromLink } from '@vlydev/cs2-masked-inspect-ts';
+const code = genCodeFromLink('steam://rungame/730/76561202255233023/+csgo_econ_action_preview%20001A...');
+// "!gen 7 474 306 0.22540508"
+```
+
 ## API
 
 ### `InspectLink`

package/dist/cjs/GenCode.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Gen code utilities for CS2 inspect links.
+ *
+ * Gen codes are space-separated command strings used on community servers:
+ *   !gen {defindex} {paintindex} {paintseed} {paintwear}
+ *   !gen ... {s0_id} {s0_wear} {s1_id} {s1_wear} {s2_id} {s2_wear} {s3_id} {s3_wear} {s4_id} {s4_wear} [{kc_id} {kc_wear} ...]
+ *
+ * Stickers are always padded to 5 slot pairs. Keychains follow without padding.
+ */
+import { ItemPreviewData } from './ItemPreviewData.ts';
+import { Sticker } from './Sticker.ts';
+export declare const INSPECT_BASE = "steam://rungame/730/76561202255233023/+csgo_econ_action_preview%20";
+/**
+ * Convert an ItemPreviewData to a gen code string.
+ * @param item - The item to convert.
+ * @param prefix - The command prefix, defaults to `"!gen"`.
+ * @returns A gen code like `"!gen 7 474 306 0.22540508"`.
+ */
+export declare function toGenCode(item: ItemPreviewData, prefix?: string): string;
+export interface GenerateOptions {
+    rarity?: number;
+    quality?: number;
+    stickers?: Sticker[];
+    keychains?: Sticker[];
+}
+/**
+ * Generate a full Steam inspect URL from item parameters.
+ * @param defIndex - Weapon definition ID (e.g. 7 = AK-47)
+ * @param paintIndex - Skin/paint ID
+ * @param paintSeed - Pattern index (0-1000)
+ * @param paintWear - Float value (0.0-1.0)
+ * @param opts - Optional item properties
+ * @returns Full `steam://rungame/...` inspect URL
+ */
+export declare function generate(defIndex: number, paintIndex: number, paintSeed: number, paintWear: number, opts?: GenerateOptions): string;
+/**
+ * Parse a gen code string into an ItemPreviewData.
+ * @param genCode - A gen code string like `"!gen 7 474 306 0.22540508"`
+ * @returns Parsed ItemPreviewData
+ * @throws {Error} If the code has fewer than 4 tokens.
+ */
+/**
+ * Generate a gen code string from an existing CS2 inspect link.
+ * @param hexOrUrl - A hex payload or full steam:// inspect URL.
+ * @param prefix - The command prefix (default "!gen").
+ */
+export declare function genCodeFromLink(hexOrUrl: string, prefix?: string): string;
+export declare function parseGenCode(genCode: string): ItemPreviewData;
+//# sourceMappingURL=GenCode.d.ts.map

package/dist/cjs/GenCode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GenCode.d.ts","sourceRoot":"","sources":["../../src/GenCode.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAGvC,eAAO,MAAM,YAAY,uEAAuE,CAAC;AAkCjG;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,eAAe,EAAE,MAAM,GAAE,MAAe,GAAG,MAAM,CAmBhF;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,OAAO,EAAE,CAAC;IACrB,SAAS,CAAC,EAAE,OAAO,EAAE,CAAC;CACvB;AAED;;;;;;;;GAQG;AACH,wBAAgB,QAAQ,CACtB,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,IAAI,GAAE,eAAoB,GACzB,MAAM,CAQR;AAED;;;;;GAKG;AACH;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,GAAE,MAAe,GAAG,MAAM,CAGjF;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,eAAe,CAwC7D"}

package/dist/cjs/GenCode.js

@@ -0,0 +1,141 @@
+"use strict";
+/**
+ * Gen code utilities for CS2 inspect links.
+ *
+ * Gen codes are space-separated command strings used on community servers:
+ *   !gen {defindex} {paintindex} {paintseed} {paintwear}
+ *   !gen ... {s0_id} {s0_wear} {s1_id} {s1_wear} {s2_id} {s2_wear} {s3_id} {s3_wear} {s4_id} {s4_wear} [{kc_id} {kc_wear} ...]
+ *
+ * Stickers are always padded to 5 slot pairs. Keychains follow without padding.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.INSPECT_BASE = void 0;
+exports.toGenCode = toGenCode;
+exports.generate = generate;
+exports.genCodeFromLink = genCodeFromLink;
+exports.parseGenCode = parseGenCode;
+const ItemPreviewData_ts_1 = require("./ItemPreviewData.js");
+const Sticker_ts_1 = require("./Sticker.js");
+const InspectLink_ts_1 = require("./InspectLink.js");
+exports.INSPECT_BASE = 'steam://rungame/730/76561202255233023/+csgo_econ_action_preview%20';
+/** Format a float, stripping trailing zeros (max 8 decimal places). */
+function formatFloat(value) {
+    let s = value.toFixed(8).replace(/0+$/, '').replace(/\.$/, '');
+    return s || '0';
+}
+function serializeStickerPairs(stickers, padTo) {
+    const result = [];
+    const filtered = stickers.filter(s => s.stickerId !== 0);
+    if (padTo !== undefined) {
+        const slotMap = new Map(filtered.map(s => [s.slot, s]));
+        for (let slot = 0; slot < padTo; slot++) {
+            const s = slotMap.get(slot);
+            if (s) {
+                result.push(String(s.stickerId));
+                result.push(formatFloat(s.wear !== null ? s.wear : 0));
+            }
+            else {
+                result.push('0', '0');
+            }
+        }
+    }
+    else {
+        const sorted = [...filtered].sort((a, b) => a.slot - b.slot);
+        for (const s of sorted) {
+            result.push(String(s.stickerId));
+            result.push(formatFloat(s.wear !== null ? s.wear : 0));
+        }
+    }
+    return result;
+}
+/**
+ * Convert an ItemPreviewData to a gen code string.
+ * @param item - The item to convert.
+ * @param prefix - The command prefix, defaults to `"!gen"`.
+ * @returns A gen code like `"!gen 7 474 306 0.22540508"`.
+ */
+function toGenCode(item, prefix = '!gen') {
+    const wearStr = item.paintWear !== null ? formatFloat(item.paintWear) : '0';
+    const parts = [
+        String(item.defIndex),
+        String(item.paintIndex),
+        String(item.paintSeed),
+        wearStr,
+    ];
+    const hasStickers = item.stickers.some(s => s.stickerId !== 0);
+    const hasKeychains = item.keychains.some(s => s.stickerId !== 0);
+    if (hasStickers || hasKeychains) {
+        parts.push(...serializeStickerPairs(item.stickers, 5));
+        parts.push(...serializeStickerPairs(item.keychains));
+    }
+    const payload = parts.join(' ');
+    return prefix ? `${prefix} ${payload}` : payload;
+}
+/**
+ * Generate a full Steam inspect URL from item parameters.
+ * @param defIndex - Weapon definition ID (e.g. 7 = AK-47)
+ * @param paintIndex - Skin/paint ID
+ * @param paintSeed - Pattern index (0-1000)
+ * @param paintWear - Float value (0.0-1.0)
+ * @param opts - Optional item properties
+ * @returns Full `steam://rungame/...` inspect URL
+ */
+function generate(defIndex, paintIndex, paintSeed, paintWear, opts = {}) {
+    const { rarity = 0, quality = 0, stickers = [], keychains = [] } = opts;
+    const data = new ItemPreviewData_ts_1.ItemPreviewData({
+        defIndex, paintIndex, paintSeed, paintWear,
+        rarity, quality, stickers, keychains,
+    });
+    const hex = InspectLink_ts_1.InspectLink.serialize(data);
+    return `${exports.INSPECT_BASE}${hex}`;
+}
+/**
+ * Parse a gen code string into an ItemPreviewData.
+ * @param genCode - A gen code string like `"!gen 7 474 306 0.22540508"`
+ * @returns Parsed ItemPreviewData
+ * @throws {Error} If the code has fewer than 4 tokens.
+ */
+/**
+ * Generate a gen code string from an existing CS2 inspect link.
+ * @param hexOrUrl - A hex payload or full steam:// inspect URL.
+ * @param prefix - The command prefix (default "!gen").
+ */
+function genCodeFromLink(hexOrUrl, prefix = '!gen') {
+    const item = InspectLink_ts_1.InspectLink.deserialize(hexOrUrl);
+    return toGenCode(item, prefix);
+}
+function parseGenCode(genCode) {
+    let tokens = genCode.trim().split(/\s+/);
+    if (tokens[0] && tokens[0].startsWith('!')) {
+        tokens = tokens.slice(1);
+    }
+    if (tokens.length < 4) {
+        throw new Error(`Gen code must have at least 4 tokens, got: "${genCode}"`);
+    }
+    const defIndex = parseInt(tokens[0], 10);
+    const paintIndex = parseInt(tokens[1], 10);
+    const paintSeed = parseInt(tokens[2], 10);
+    const paintWear = parseFloat(tokens[3]);
+    let rest = tokens.slice(4);
+    const stickers = [];
+    const keychains = [];
+    if (rest.length >= 10) {
+        const stickerTokens = rest.slice(0, 10);
+        for (let slot = 0; slot < 5; slot++) {
+            const sid = parseInt(stickerTokens[slot * 2], 10);
+            const wear = parseFloat(stickerTokens[slot * 2 + 1]);
+            if (sid !== 0) {
+                stickers.push(new Sticker_ts_1.Sticker({ slot, stickerId: sid, wear }));
+            }
+        }
+        rest = rest.slice(10);
+    }
+    for (let i = 0; i + 1 < rest.length; i += 2) {
+        const sid = parseInt(rest[i], 10);
+        const wear = parseFloat(rest[i + 1]);
+        if (sid !== 0) {
+            keychains.push(new Sticker_ts_1.Sticker({ slot: i / 2, stickerId: sid, wear }));
+        }
+    }
+    return new ItemPreviewData_ts_1.ItemPreviewData({ defIndex, paintIndex, paintSeed, paintWear, stickers, keychains });
+}

package/dist/cjs/index.d.ts

@@ -7,4 +7,6 @@ export { crc32 } from './crc32.ts';
 export { ProtoReader } from './proto/reader.ts';
 export type { ProtoField } from './proto/reader.ts';
 export { ProtoWriter } from './proto/writer.ts';
+export { toGenCode, generate, parseGenCode, genCodeFromLink, INSPECT_BASE } from './GenCode.ts';
+export type { GenerateOptions } from './GenCode.ts';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +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"}
+{"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;AAChD,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,YAAY,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAChG,YAAY,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC"}

package/dist/cjs/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ProtoWriter = exports.ProtoReader = exports.crc32 = exports.Sticker = exports.ItemPreviewData = exports.InspectLink = void 0;
+exports.INSPECT_BASE = exports.genCodeFromLink = exports.parseGenCode = exports.generate = exports.toGenCode = exports.ProtoWriter = exports.ProtoReader = exports.crc32 = exports.Sticker = exports.ItemPreviewData = exports.InspectLink = void 0;
 var InspectLink_ts_1 = require("./InspectLink.js");
 Object.defineProperty(exports, "InspectLink", { enumerable: true, get: function () { return InspectLink_ts_1.InspectLink; } });
 var ItemPreviewData_ts_1 = require("./ItemPreviewData.js");
@@ -13,3 +13,9 @@ var reader_ts_1 = require("./proto/reader.js");
 Object.defineProperty(exports, "ProtoReader", { enumerable: true, get: function () { return reader_ts_1.ProtoReader; } });
 var writer_ts_1 = require("./proto/writer.js");
 Object.defineProperty(exports, "ProtoWriter", { enumerable: true, get: function () { return writer_ts_1.ProtoWriter; } });
+var GenCode_ts_1 = require("./GenCode.js");
+Object.defineProperty(exports, "toGenCode", { enumerable: true, get: function () { return GenCode_ts_1.toGenCode; } });
+Object.defineProperty(exports, "generate", { enumerable: true, get: function () { return GenCode_ts_1.generate; } });
+Object.defineProperty(exports, "parseGenCode", { enumerable: true, get: function () { return GenCode_ts_1.parseGenCode; } });
+Object.defineProperty(exports, "genCodeFromLink", { enumerable: true, get: function () { return GenCode_ts_1.genCodeFromLink; } });
+Object.defineProperty(exports, "INSPECT_BASE", { enumerable: true, get: function () { return GenCode_ts_1.INSPECT_BASE; } });

package/dist/esm/GenCode.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Gen code utilities for CS2 inspect links.
+ *
+ * Gen codes are space-separated command strings used on community servers:
+ *   !gen {defindex} {paintindex} {paintseed} {paintwear}
+ *   !gen ... {s0_id} {s0_wear} {s1_id} {s1_wear} {s2_id} {s2_wear} {s3_id} {s3_wear} {s4_id} {s4_wear} [{kc_id} {kc_wear} ...]
+ *
+ * Stickers are always padded to 5 slot pairs. Keychains follow without padding.
+ */
+import { ItemPreviewData } from './ItemPreviewData.ts';
+import { Sticker } from './Sticker.ts';
+export declare const INSPECT_BASE = "steam://rungame/730/76561202255233023/+csgo_econ_action_preview%20";
+/**
+ * Convert an ItemPreviewData to a gen code string.
+ * @param item - The item to convert.
+ * @param prefix - The command prefix, defaults to `"!gen"`.
+ * @returns A gen code like `"!gen 7 474 306 0.22540508"`.
+ */
+export declare function toGenCode(item: ItemPreviewData, prefix?: string): string;
+export interface GenerateOptions {
+    rarity?: number;
+    quality?: number;
+    stickers?: Sticker[];
+    keychains?: Sticker[];
+}
+/**
+ * Generate a full Steam inspect URL from item parameters.
+ * @param defIndex - Weapon definition ID (e.g. 7 = AK-47)
+ * @param paintIndex - Skin/paint ID
+ * @param paintSeed - Pattern index (0-1000)
+ * @param paintWear - Float value (0.0-1.0)
+ * @param opts - Optional item properties
+ * @returns Full `steam://rungame/...` inspect URL
+ */
+export declare function generate(defIndex: number, paintIndex: number, paintSeed: number, paintWear: number, opts?: GenerateOptions): string;
+/**
+ * Parse a gen code string into an ItemPreviewData.
+ * @param genCode - A gen code string like `"!gen 7 474 306 0.22540508"`
+ * @returns Parsed ItemPreviewData
+ * @throws {Error} If the code has fewer than 4 tokens.
+ */
+/**
+ * Generate a gen code string from an existing CS2 inspect link.
+ * @param hexOrUrl - A hex payload or full steam:// inspect URL.
+ * @param prefix - The command prefix (default "!gen").
+ */
+export declare function genCodeFromLink(hexOrUrl: string, prefix?: string): string;
+export declare function parseGenCode(genCode: string): ItemPreviewData;
+//# sourceMappingURL=GenCode.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"GenCode.d.ts","sourceRoot":"","sources":["../../src/GenCode.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAGvC,eAAO,MAAM,YAAY,uEAAuE,CAAC;AAkCjG;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,eAAe,EAAE,MAAM,GAAE,MAAe,GAAG,MAAM,CAmBhF;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,OAAO,EAAE,CAAC;IACrB,SAAS,CAAC,EAAE,OAAO,EAAE,CAAC;CACvB;AAED;;;;;;;;GAQG;AACH,wBAAgB,QAAQ,CACtB,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,IAAI,GAAE,eAAoB,GACzB,MAAM,CAQR;AAED;;;;;GAKG;AACH;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,GAAE,MAAe,GAAG,MAAM,CAGjF;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,eAAe,CAwC7D"}

package/dist/esm/GenCode.js

@@ -0,0 +1,134 @@
+/**
+ * Gen code utilities for CS2 inspect links.
+ *
+ * Gen codes are space-separated command strings used on community servers:
+ *   !gen {defindex} {paintindex} {paintseed} {paintwear}
+ *   !gen ... {s0_id} {s0_wear} {s1_id} {s1_wear} {s2_id} {s2_wear} {s3_id} {s3_wear} {s4_id} {s4_wear} [{kc_id} {kc_wear} ...]
+ *
+ * Stickers are always padded to 5 slot pairs. Keychains follow without padding.
+ */
+import { ItemPreviewData } from "./ItemPreviewData.js";
+import { Sticker } from "./Sticker.js";
+import { InspectLink } from "./InspectLink.js";
+export const INSPECT_BASE = 'steam://rungame/730/76561202255233023/+csgo_econ_action_preview%20';
+/** Format a float, stripping trailing zeros (max 8 decimal places). */
+function formatFloat(value) {
+    let s = value.toFixed(8).replace(/0+$/, '').replace(/\.$/, '');
+    return s || '0';
+}
+function serializeStickerPairs(stickers, padTo) {
+    const result = [];
+    const filtered = stickers.filter(s => s.stickerId !== 0);
+    if (padTo !== undefined) {
+        const slotMap = new Map(filtered.map(s => [s.slot, s]));
+        for (let slot = 0; slot < padTo; slot++) {
+            const s = slotMap.get(slot);
+            if (s) {
+                result.push(String(s.stickerId));
+                result.push(formatFloat(s.wear !== null ? s.wear : 0));
+            }
+            else {
+                result.push('0', '0');
+            }
+        }
+    }
+    else {
+        const sorted = [...filtered].sort((a, b) => a.slot - b.slot);
+        for (const s of sorted) {
+            result.push(String(s.stickerId));
+            result.push(formatFloat(s.wear !== null ? s.wear : 0));
+        }
+    }
+    return result;
+}
+/**
+ * Convert an ItemPreviewData to a gen code string.
+ * @param item - The item to convert.
+ * @param prefix - The command prefix, defaults to `"!gen"`.
+ * @returns A gen code like `"!gen 7 474 306 0.22540508"`.
+ */
+export function toGenCode(item, prefix = '!gen') {
+    const wearStr = item.paintWear !== null ? formatFloat(item.paintWear) : '0';
+    const parts = [
+        String(item.defIndex),
+        String(item.paintIndex),
+        String(item.paintSeed),
+        wearStr,
+    ];
+    const hasStickers = item.stickers.some(s => s.stickerId !== 0);
+    const hasKeychains = item.keychains.some(s => s.stickerId !== 0);
+    if (hasStickers || hasKeychains) {
+        parts.push(...serializeStickerPairs(item.stickers, 5));
+        parts.push(...serializeStickerPairs(item.keychains));
+    }
+    const payload = parts.join(' ');
+    return prefix ? `${prefix} ${payload}` : payload;
+}
+/**
+ * Generate a full Steam inspect URL from item parameters.
+ * @param defIndex - Weapon definition ID (e.g. 7 = AK-47)
+ * @param paintIndex - Skin/paint ID
+ * @param paintSeed - Pattern index (0-1000)
+ * @param paintWear - Float value (0.0-1.0)
+ * @param opts - Optional item properties
+ * @returns Full `steam://rungame/...` inspect URL
+ */
+export function generate(defIndex, paintIndex, paintSeed, paintWear, opts = {}) {
+    const { rarity = 0, quality = 0, stickers = [], keychains = [] } = opts;
+    const data = new ItemPreviewData({
+        defIndex, paintIndex, paintSeed, paintWear,
+        rarity, quality, stickers, keychains,
+    });
+    const hex = InspectLink.serialize(data);
+    return `${INSPECT_BASE}${hex}`;
+}
+/**
+ * Parse a gen code string into an ItemPreviewData.
+ * @param genCode - A gen code string like `"!gen 7 474 306 0.22540508"`
+ * @returns Parsed ItemPreviewData
+ * @throws {Error} If the code has fewer than 4 tokens.
+ */
+/**
+ * Generate a gen code string from an existing CS2 inspect link.
+ * @param hexOrUrl - A hex payload or full steam:// inspect URL.
+ * @param prefix - The command prefix (default "!gen").
+ */
+export function genCodeFromLink(hexOrUrl, prefix = '!gen') {
+    const item = InspectLink.deserialize(hexOrUrl);
+    return toGenCode(item, prefix);
+}
+export function parseGenCode(genCode) {
+    let tokens = genCode.trim().split(/\s+/);
+    if (tokens[0] && tokens[0].startsWith('!')) {
+        tokens = tokens.slice(1);
+    }
+    if (tokens.length < 4) {
+        throw new Error(`Gen code must have at least 4 tokens, got: "${genCode}"`);
+    }
+    const defIndex = parseInt(tokens[0], 10);
+    const paintIndex = parseInt(tokens[1], 10);
+    const paintSeed = parseInt(tokens[2], 10);
+    const paintWear = parseFloat(tokens[3]);
+    let rest = tokens.slice(4);
+    const stickers = [];
+    const keychains = [];
+    if (rest.length >= 10) {
+        const stickerTokens = rest.slice(0, 10);
+        for (let slot = 0; slot < 5; slot++) {
+            const sid = parseInt(stickerTokens[slot * 2], 10);
+            const wear = parseFloat(stickerTokens[slot * 2 + 1]);
+            if (sid !== 0) {
+                stickers.push(new Sticker({ slot, stickerId: sid, wear }));
+            }
+        }
+        rest = rest.slice(10);
+    }
+    for (let i = 0; i + 1 < rest.length; i += 2) {
+        const sid = parseInt(rest[i], 10);
+        const wear = parseFloat(rest[i + 1]);
+        if (sid !== 0) {
+            keychains.push(new Sticker({ slot: i / 2, stickerId: sid, wear }));
+        }
+    }
+    return new ItemPreviewData({ defIndex, paintIndex, paintSeed, paintWear, stickers, keychains });
+}

package/dist/esm/index.d.ts

@@ -7,4 +7,6 @@ export { crc32 } from './crc32.ts';
 export { ProtoReader } from './proto/reader.ts';
 export type { ProtoField } from './proto/reader.ts';
 export { ProtoWriter } from './proto/writer.ts';
+export { toGenCode, generate, parseGenCode, genCodeFromLink, INSPECT_BASE } from './GenCode.ts';
+export type { GenerateOptions } from './GenCode.ts';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +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"}
+{"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;AAChD,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,YAAY,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAChG,YAAY,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC"}

package/dist/esm/index.js

@@ -4,3 +4,4 @@ export { Sticker } from "./Sticker.js";
 export { crc32 } from "./crc32.js";
 export { ProtoReader } from "./proto/reader.js";
 export { ProtoWriter } from "./proto/writer.js";
+export { toGenCode, generate, parseGenCode, genCodeFromLink, INSPECT_BASE } from "./GenCode.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vlydev/cs2-masked-inspect-ts",
-  "version": "1.0.1",
+  "version": "1.1.0",
   "description": "Offline encoder/decoder for CS2 masked inspect URLs — TypeScript, fully typed, no dependencies",
   "type": "module",
   "main": "./dist/cjs/index.js",
@@ -20,7 +20,7 @@
   },
   "scripts": {
     "build": "tsc -p tsconfig.json && tsc -p tsconfig.cjs.json",
-    "test": "node --experimental-strip-types --test tests/inspect_link.test.ts",
+    "test": "node --experimental-strip-types --test tests/*.test.ts",
     "prepublishOnly": "npm run build"
   },
   "keywords": [