@piltoverarchive/riftbound-deck-codes 1.0.0

package/CHANGELOG.md

@@ -0,0 +1,75 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [1.0.0] - 2025
+
+### Added
+
+- Initial release of RiftboundDeckCodes library
+- Support for encoding Riftbound TCG decks to shareable codes
+- Support for decoding deck codes back to deck lists
+- Version 1 format: Main deck only
+- Version 2 format: Main deck + sideboard support
+- Support for 4 sets: OGN, OGS, SFD, ARC
+- Support for 4 variants: base, a, s, b
+- Support for card counts 1-12 (for runes and standard cards)
+- Comprehensive error handling for invalid inputs
+- TypeScript type definitions
+- Base32 encoding for compact, shareable codes
+- Variable-length integer encoding for space efficiency
+- Full documentation and usage examples
+- Compatibility with LoR deck code format structure
+
+### Format Specification
+
+- Format byte: `1`
+- Version 1: Main deck encoding only
+- Version 2: Main deck + sideboard (exactly 0 or 8 cards)
+- Card code format: `SET-NUMBERvariant` (e.g., `OGN-007a`)
+- Set encoding: 1 byte per set (0-255 supported)
+- Variant encoding: 1 byte per variant (0-255 supported)
+- Count groups: 12 down to 1 for backward compatibility
+
+---
+
+## Version History Summary
+
+| Version | Date | Key Changes                                          |
+| ------- | ---- | ---------------------------------------------------- |
+| 1.0.0   | 2025 | Initial release with Version 1 and Version 2 support |
+
+---
+
+## Migration Guides
+
+### From Version 1 to Version 2
+
+If you're upgrading from using Version 1 codes (main deck only) to Version 2 (with sideboard):
+
+**Before (Version 1):**
+
+```typescript
+const deckCode = getCodeFromDeck(mainDeck);
+const decoded = getDeckFromCode(deckCode); // Returns Deck
+```
+
+**After (Version 2):**
+
+```typescript
+const deckCode = getCodeFromDeck(mainDeck, sideboard);
+const decoded = getDeckFromCode(deckCode); // Returns DeckWithSideboard
+```
+
+**Backward Compatibility:**
+
+- Version 1 codes still work and return empty sideboard array
+- Version 2 encoder automatically detects if sideboard is provided
+- No breaking changes to existing code
+
+---
+
+For a full list of changes, see the [commit history](https://github.com/Piltover-Archive/RiftboundDeckCodes/commits/main).

package/LICENSE

@@ -0,0 +1,17 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   Copyright 2025 PiltoverArchive
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/README.md

@@ -0,0 +1,203 @@
+<div align="center">
+  <img src="https://cdn.piltoverarchive.com/PiltoverArchive.webp" alt="Piltover Archive" width="200"/>
+
+  # RiftboundDeckCodes
+
+  **By [Piltover Archive](https://piltoverarchive.com)**
+</div>
+
+The RiftboundDeckCodes library can be used to encode/decode Riftbound TCG decks to/from simple strings. Below is an example code for a Kai'Sa deck with sideboard.
+
+```
+CIAAAAAAAAAQCAAAA4AACAIAABMQAAILAAAAICIMDMOVOX3AM5UHIAIDAAACO6XYAEAQKAAABX3QDGACUABKIAQAAEBQAAAWDBOQCAQAABMHE
+```
+
+These strings can be used to share decks across Riftbound TCG applications and the PiltoverArchive companion app.
+
+## Cards & Decks
+
+Every Riftbound TCG card has a corresponding card code. Card codes are comprised of a three-character set identifier, a three-digit card number, and an optional single-character variant suffix.
+
+```
+OGN-007a
+│   │  └ variant - a
+│   └ card number - 007
+└ set - OGN
+```
+
+The deck code library accepts a Riftbound deck as a list of `Card` objects. This is simply the card code and an associated integer for the number of occurrences of the card in the deck.
+
+## Process
+
+Decks are encoded via arranging VarInts (big endian) into an array and then base32 encoding into a string.
+
+All encodings begin with 4 bits for format and 4 bits for version.
+
+| Format | Version | Date              | About                                                                     |
+| ------ | ------- | ----------------- | ------------------------------------------------------------------------- |
+| 1      | 1       | April 1, 2025     | Initial release. Supports main deck encoding.                             |
+| 1      | 2       | November 20, 2025 | Adds sideboard support. All new codes encode as V2 (backward compatible). |
+
+The list of cards are then encoded according to the following scheme:
+
+1. Cards are grouped together based on how many copies of the card are in the deck (e.g., cards with twelve copies, cards with three copies, cards with two copies, and cards with a single copy are grouped together).
+2. Within those groups, lists of cards are created which share the same set AND variant.
+3. The set/variant lists are ordered by increasing length. The contents of the set/variant lists are ordered alphanumerically by card number.
+4. Variable length integer ([varints](https://en.wikipedia.org/wiki/Variable-length_quantity)) (big endian) bytes for each ordered group of cards are written into the byte array according to the following convention:
+   - [how many lists of set/variant combination have twelve copies of a card]
+     - [how many cards within this set/variant combination follow]
+     - [set]
+     - [variant]
+       - [card number]
+       - [card number]
+       - ...
+     - [how many cards in this next set/variant combination follow]
+     - [set]
+     - [variant]
+       - [card number]
+       - [card number]
+       - ...
+   - [repeat for the groups of eleven copies of a card]
+   - [repeat down to groups of a single copy of a card]
+5. For Version 2 decks, the sideboard is encoded using the same scheme after the main deck, but **only processes counts 3, 2, and 1** (since sideboards cannot contain runes which may have higher counts). This optimization reduces sideboard encoding size by ~12%.
+6. The resulting byte array is base32 encoded into a string.
+
+### Set Identifiers
+
+Sets are mapped as follows:
+
+| Version | Integer Identifier | Set Code | Set Name        |
+| ------- | ------------------ | -------- | --------------- |
+| 1       | 0                  | OGN      | Origins         |
+| 1       | 1                  | OGS      | Proving Grounds |
+| 2       | 2                  | ARC      | Arcane Box Set  |
+| 2       | 3                  | SFD      | Spiritforged    |
+
+### Variant Identifiers
+
+Variants are mapped as follows:
+
+| Version | Integer Identifier | Variant Code | Variant Name    |
+| ------- | ------------------ | ------------ | --------------- |
+| 1       | 0                  | (none)       | Base variant    |
+| 1       | 1                  | a            | Alternate art A |
+| 1       | 2                  | s            | Signed          |
+| 2       | 3                  | b            | Alternate art B |
+
+## Installation
+
+```bash
+npm install @piltoverarchive/riftbound-deck-codes
+```
+
+Or using other package managers:
+
+```bash
+yarn add @piltoverarchive/riftbound-deck-codes
+pnpm add @piltoverarchive/riftbound-deck-codes
+```
+
+## Usage
+
+### Encoding a Deck
+
+```typescript
+import { getCodeFromDeck } from "@piltoverarchive/riftbound-deck-codes";
+import type { Deck } from "@piltoverarchive/riftbound-deck-codes";
+
+// Kai'Sa deck
+const mainDeck: Deck = [
+  { cardCode: "OGN-007", count: 7 },
+  { cardCode: "OGN-089", count: 5 },
+  { cardCode: "OGN-004", count: 3 },
+  { cardCode: "OGN-009", count: 3 },
+  { cardCode: "OGN-012", count: 3 },
+  { cardCode: "OGN-027", count: 3 },
+  { cardCode: "OGN-029", count: 3 },
+  { cardCode: "OGN-087", count: 3 },
+  { cardCode: "OGN-095", count: 3 },
+  { cardCode: "OGN-096", count: 3 },
+  { cardCode: "OGN-103", count: 3 },
+  { cardCode: "OGN-104", count: 3 },
+  { cardCode: "OGN-116", count: 3 },
+  { cardCode: "OGN-039", count: 2 },
+  { cardCode: "OGN-122", count: 2 },
+  { cardCode: "OGN-248", count: 2 },
+  { cardCode: "OGN-013", count: 1 },
+  { cardCode: "OGN-247", count: 1 },
+  { cardCode: "OGN-280", count: 1 },
+  { cardCode: "OGN-288", count: 1 },
+  { cardCode: "OGN-292", count: 1 },
+];
+
+const sideboard: Deck = [
+  { cardCode: "OGN-022", count: 2 },
+  { cardCode: "OGN-024", count: 2 },
+  { cardCode: "OGN-093", count: 2 },
+  { cardCode: "OGN-088", count: 1 },
+  { cardCode: "OGN-114", count: 1 },
+];
+
+// Encode with sideboard
+const deckCode = getCodeFromDeck(mainDeck, sideboard);
+console.log(deckCode);
+// Output: CIAAAAAAAAAQCAAAA4AACAIAABMQAAILAAAAICIMDMOVOX3AM5UHIAIDAAACO6XYAEAQKAAABX3QDGACUABKIAQAAEBQAAAWDBOQCAQAABMHE
+
+// Encode without sideboard (empty sideboard encoded as V2)
+const deckCodeNoSideboard = getCodeFromDeck(mainDeck);
+console.log(deckCodeNoSideboard);
+// Output: CIAAAAAAAAAQCAAAA4AACAIAABMQAAILAAAAICIMDMOVOX3AM5UHIAIDAAACO6XYAEAQKAAABX3QDGACUABKIAQAAAAA
+// Note: ~5 character overhead for empty sideboard encoding
+```
+
+### Decoding a Deck
+
+```typescript
+import { getDeckFromCode } from "@piltoverarchive/riftbound-deck-codes";
+import type { DeckWithSideboard } from "@piltoverarchive/riftbound-deck-codes";
+
+const code =
+  "CIAAAAAAAAAQCAAAA4AACAIAABMQAAILAAAAICIMDMOVOX3AM5UHIAIDAAACO6XYAEAQKAAABX3QDGACUABKIAQAAEBQAAAWDBOQCAQAABMHE";
+
+const decoded: DeckWithSideboard = getDeckFromCode(code);
+
+console.log("Main Deck:", decoded.mainDeck);
+// 21 cards including 7x OGN-007 (runes), 5x OGN-089 (runes), and various 1-3 copy cards
+
+console.log("Sideboard:", decoded.sideboard);
+// 8 cards: 2x OGN-022, 2x OGN-024, 2x OGN-093, 1x OGN-088, 1x OGN-114
+```
+
+### Important Notes
+
+- **No Game Rule Validation**: This library only encodes/decodes deck data. It does not validate Riftbound game rules (card limits, sideboard size, etc.). Validation should be done in your application.
+- **Card Counts**: Main deck supports counts 1-12 (for runes and standard cards). Sideboard only supports counts 1-3 (optimized for regular cards only).
+- **Always Version 2**: All new deck codes encode as Version 2, even without a sideboard. Empty sideboards add ~5 characters overhead.
+- **Backward Compatibility**: Can decode Version 1 codes (without sideboard section) which return an empty sideboard array.
+
+## Implementations
+
+The TypeScript implementation in this repository is the reference implementation. Community implementations in other languages are welcome!
+
+### Current Version
+
+| Name               | Language   | Version\* | Maintainer      |
+| ------------------ | ---------- | --------- | --------------- |
+| RiftboundDeckCodes | TypeScript | 2         | PiltoverArchive |
+
+\*Version refers to the MAX_KNOWN_VERSION supported by the implementation.
+
+## Links
+
+- **PiltoverArchive**: [https://piltoverarchive.com](https://piltoverarchive.com) - Comprehensive Riftbound TCG companion app
+- **Riftbound TCG**: [https://riftbound.leagueoflegends.com/](https://riftbound.leagueoflegends.com/) Official game information and rules
+
+## Credits
+
+This library is adapted from [Riot Games' LoRDeckCodes](https://github.com/RiotGames/LoRDeckCodes) for use with Riftbound TCG.
+
+This project is not affiliated with or endorsed by Riot Games.
+
+## License
+
+Apache 2.0 (see [LICENSE](LICENSE) for details)

package/dist/VarintTranslator.d.ts

@@ -0,0 +1,40 @@
+/**
+ * VarintTranslator handles encoding and decoding of variable-length integers
+ * used in the Riftbound deck code format.
+ *
+ * Variable-length integers use the most significant bit (MSB) as a continuation flag.
+ * If MSB is 1, more bytes follow. If MSB is 0, this is the final byte.
+ */
+export default class VarintTranslator {
+    private static readonly AllButMSB;
+    private static readonly JustMSB;
+    private bytes;
+    constructor(_bytes: ArrayBuffer | Uint8Array);
+    get length(): number;
+    /**
+     * Reads and removes a varint from the beginning of the byte array
+     * @returns The decoded integer value
+     * @throws Error if no bytes available or invalid varint format
+     */
+    PopVarint(): number;
+    /**
+     * Slices the internal byte array
+     * @param begin - Start index
+     * @param end - Optional end index
+     */
+    sliceAndSet(begin: number, end?: number): void;
+    /**
+     * Gets a byte at the specified index
+     * @param index - Index to retrieve
+     * @returns The byte value at the index
+     * @throws Error if index is out of bounds
+     */
+    get(index: number): number;
+    /**
+     * Converts a number into its varint byte representation
+     * @param value - The number to encode
+     * @returns Uint8Array containing the varint encoding
+     */
+    static GetVarint(value: number): Uint8Array;
+}
+//# sourceMappingURL=VarintTranslator.d.ts.map

package/dist/VarintTranslator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"VarintTranslator.d.ts","sourceRoot":"","sources":["../src/VarintTranslator.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,MAAM,CAAC,OAAO,OAAO,gBAAgB;IACpC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAQ;IACzC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAQ;IAEvC,OAAO,CAAC,KAAK,CAAa;gBAEd,MAAM,EAAE,WAAW,GAAG,UAAU;IAI5C,IAAW,MAAM,IAAI,MAAM,CAE1B;IAED;;;;OAIG;IACI,SAAS,IAAI,MAAM;IA6B1B;;;;OAIG;IACI,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI;IAIrD;;;;;OAKG;IACI,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAOjC;;;;OAIG;WACW,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU;CAqBlD"}

package/dist/VarintTranslator.js

@@ -0,0 +1,89 @@
+"use strict";
+// THIS CODE IS ADAPTED FROM https://github.com/RiotGames/LoRDeckCodes/blob/main/LoRDeckCodes/VarintTranslator.cs
+Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * VarintTranslator handles encoding and decoding of variable-length integers
+ * used in the Riftbound deck code format.
+ *
+ * Variable-length integers use the most significant bit (MSB) as a continuation flag.
+ * If MSB is 1, more bytes follow. If MSB is 0, this is the final byte.
+ */
+class VarintTranslator {
+    constructor(_bytes) {
+        this.bytes = new Uint8Array(_bytes);
+    }
+    get length() {
+        return this.bytes.length;
+    }
+    /**
+     * Reads and removes a varint from the beginning of the byte array
+     * @returns The decoded integer value
+     * @throws Error if no bytes available or invalid varint format
+     */
+    PopVarint() {
+        if (this.bytes.length === 0) {
+            throw new Error("No bytes available to read varint");
+        }
+        let result = 0;
+        let currentShift = 0;
+        let bytesPopped = 0;
+        for (let i = 0; i < this.bytes.length; i++) {
+            bytesPopped++;
+            const current = this.bytes[i] & VarintTranslator.AllButMSB;
+            result |= current << currentShift;
+            if ((this.bytes[i] & VarintTranslator.JustMSB) !==
+                VarintTranslator.JustMSB) {
+                this.bytes = this.bytes.slice(bytesPopped);
+                return result;
+            }
+            currentShift += 7;
+        }
+        throw new Error("Byte array did not contain valid varints.");
+    }
+    /**
+     * Slices the internal byte array
+     * @param begin - Start index
+     * @param end - Optional end index
+     */
+    sliceAndSet(begin, end) {
+        this.bytes = this.bytes.slice(begin, end);
+    }
+    /**
+     * Gets a byte at the specified index
+     * @param index - Index to retrieve
+     * @returns The byte value at the index
+     * @throws Error if index is out of bounds
+     */
+    get(index) {
+        if (index < 0 || index >= this.bytes.length) {
+            throw new Error(`Index out of bounds: ${index}`);
+        }
+        return this.bytes[index];
+    }
+    /**
+     * Converts a number into its varint byte representation
+     * @param value - The number to encode
+     * @returns Uint8Array containing the varint encoding
+     */
+    static GetVarint(value) {
+        const buff = new Uint8Array(10);
+        let currentIndex = 0;
+        if (value === 0)
+            return new Uint8Array([0]);
+        while (value !== 0) {
+            // Get lower 7 bits
+            let byteVal = value & this.AllButMSB;
+            // Shift right by 7 bits
+            value >>>= 7;
+            // If more bytes needed, set continuation bit
+            if (value !== 0)
+                byteVal |= this.JustMSB;
+            buff[currentIndex++] = byteVal;
+        }
+        return buff.slice(0, currentIndex);
+    }
+}
+VarintTranslator.AllButMSB = 0x7f;
+VarintTranslator.JustMSB = 0x80;
+exports.default = VarintTranslator;
+//# sourceMappingURL=VarintTranslator.js.map

package/dist/VarintTranslator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"VarintTranslator.js","sourceRoot":"","sources":["../src/VarintTranslator.ts"],"names":[],"mappings":";AAAA,iHAAiH;;AAEjH;;;;;;GAMG;AACH,MAAqB,gBAAgB;IAMpC,YAAY,MAAgC;QAC3C,IAAI,CAAC,KAAK,GAAG,IAAI,UAAU,CAAC,MAAM,CAAC,CAAC;IACrC,CAAC;IAED,IAAW,MAAM;QAChB,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC;IAC1B,CAAC;IAED;;;;OAIG;IACI,SAAS;QACf,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC7B,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAC;QACtD,CAAC;QAED,IAAI,MAAM,GAAG,CAAC,CAAC;QACf,IAAI,YAAY,GAAG,CAAC,CAAC;QACrB,IAAI,WAAW,GAAG,CAAC,CAAC;QAEpB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YAC5C,WAAW,EAAE,CAAC;YAEd,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAE,GAAG,gBAAgB,CAAC,SAAS,CAAC;YAC5D,MAAM,IAAI,OAAO,IAAI,YAAY,CAAC;YAElC,IACC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAE,GAAG,gBAAgB,CAAC,OAAO,CAAC;gBAC3C,gBAAgB,CAAC,OAAO,EACvB,CAAC;gBACF,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;gBAC3C,OAAO,MAAM,CAAC;YACf,CAAC;YAED,YAAY,IAAI,CAAC,CAAC;QACnB,CAAC;QAED,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAC;IAC9D,CAAC;IAED;;;;OAIG;IACI,WAAW,CAAC,KAAa,EAAE,GAAY;QAC7C,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IAC3C,CAAC;IAED;;;;;OAKG;IACI,GAAG,CAAC,KAAa;QACvB,IAAI,KAAK,GAAG,CAAC,IAAI,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;YAC7C,MAAM,IAAI,KAAK,CAAC,wBAAwB,KAAK,EAAE,CAAC,CAAC;QAClD,CAAC;QACD,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAE,CAAC;IAC3B,CAAC;IAED;;;;OAIG;IACI,MAAM,CAAC,SAAS,CAAC,KAAa;QACpC,MAAM,IAAI,GAAG,IAAI,UAAU,CAAC,EAAE,CAAC,CAAC;QAChC,IAAI,YAAY,GAAG,CAAC,CAAC;QAErB,IAAI,KAAK,KAAK,CAAC;YAAE,OAAO,IAAI,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAE5C,OAAO,KAAK,KAAK,CAAC,EAAE,CAAC;YACpB,mBAAmB;YACnB,IAAI,OAAO,GAAG,KAAK,GAAG,IAAI,CAAC,SAAS,CAAC;YAErC,wBAAwB;YACxB,KAAK,MAAM,CAAC,CAAC;YAEb,6CAA6C;YAC7C,IAAI,KAAK,KAAK,CAAC;gBAAE,OAAO,IAAI,IAAI,CAAC,OAAO,CAAC;YAEzC,IAAI,CAAC,YAAY,EAAE,CAAC,GAAG,OAAO,CAAC;QAChC,CAAC;QAED,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,YAAY,CAAC,CAAC;IACpC,CAAC;;AA9FuB,0BAAS,GAAG,IAAI,CAAC;AACjB,wBAAO,GAAG,IAAI,CAAC;kBAFnB,gBAAgB"}

package/dist/deckCode.d.ts

@@ -0,0 +1,17 @@
+import type { Deck, DeckWithSideboard } from "./types";
+/**
+ * Encodes a Riftbound deck into a shareable deck code
+ * @param mainDeck - The main deck cards
+ * @param sideboard - Optional sideboard cards (defaults to empty array)
+ * @returns Base32-encoded deck code string
+ * @throws Error if deck format is invalid
+ */
+export declare function getCodeFromDeck(mainDeck: Deck, sideboard?: Deck): string;
+/**
+ * Decodes a Riftbound deck code into deck and sideboard
+ * @param code - Base32-encoded deck code string
+ * @returns Object containing mainDeck and sideboard arrays
+ * @throws Error if code is invalid or unsupported
+ */
+export declare function getDeckFromCode(code: string): DeckWithSideboard;
+//# sourceMappingURL=deckCode.d.ts.map

package/dist/deckCode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deckCode.d.ts","sourceRoot":"","sources":["../src/deckCode.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAyB,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAsO9E;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,IAAI,EAAE,SAAS,GAAE,IAAS,GAAG,MAAM,CAc5E;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB,CAqC/D"}

package/dist/deckCode.js

@@ -0,0 +1,227 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getCodeFromDeck = getCodeFromDeck;
+exports.getDeckFromCode = getDeckFromCode;
+const mappings_1 = require("./mappings");
+const VarintTranslator_1 = __importDefault(require("./VarintTranslator"));
+const FORMAT = 1;
+const VERSION = 2;
+const BASE32_ALPHABET = "ABCDEFGHIJKLMNOPQRSTUVWXYZ234567";
+/**
+ * Encodes a byte array to base32 string
+ */
+function base32Encode(bytes) {
+    let result = "";
+    let buffer = 0;
+    let bitsLeft = 0;
+    for (const byte of bytes) {
+        buffer = (buffer << 8) | byte;
+        bitsLeft += 8;
+        while (bitsLeft >= 5) {
+            bitsLeft -= 5;
+            result += BASE32_ALPHABET[(buffer >> bitsLeft) & 0x1f];
+        }
+    }
+    if (bitsLeft > 0) {
+        buffer <<= 5 - bitsLeft;
+        result += BASE32_ALPHABET[buffer & 0x1f];
+    }
+    return result;
+}
+/**
+ * Decodes a base32 string to byte array
+ */
+function base32Decode(str) {
+    const bytes = [];
+    let buffer = 0;
+    let bitsLeft = 0;
+    for (const char of str) {
+        const value = BASE32_ALPHABET.indexOf(char.toUpperCase());
+        if (value === -1) {
+            throw new Error(`Invalid character in deck code: '${char}'`);
+        }
+        buffer = (buffer << 5) | value;
+        bitsLeft += 5;
+        while (bitsLeft >= 8) {
+            bitsLeft -= 8;
+            bytes.push((buffer >> bitsLeft) & 0xff);
+        }
+    }
+    return new Uint8Array(bytes);
+}
+/**
+ * Parses a Riftbound card code into its components
+ * @param cardCode - Card code in format "SET-NUMBERvariant" (e.g., "OGN-007a")
+ * @returns Object containing set, number, and variant
+ * @throws Error if card code format is invalid
+ */
+function parseCardCode(cardCode) {
+    const parts = cardCode.split("-");
+    if (parts.length !== 2) {
+        throw new Error(`Invalid card code format: ${cardCode}. Expected format: SET-NUMBERvariant`);
+    }
+    const set = parts[0];
+    const rest = parts[1];
+    if (!set || !rest) {
+        throw new Error(`Invalid card code format: ${cardCode}. Missing set or card number.`);
+    }
+    const match = rest.match(/^(\d+)([a-z]?)$/);
+    if (!match) {
+        throw new Error(`Invalid card code format: ${cardCode}. Expected format: SET-NUMBERvariant`);
+    }
+    return {
+        set,
+        number: match[1] ?? "",
+        variant: match[2] ?? "",
+    };
+}
+/**
+ * Groups cards by set and variant for efficient encoding
+ */
+function groupBySetAndVariant(cards) {
+    const groups = new Map();
+    for (const card of cards) {
+        const { set, number, variant } = parseCardCode(card.cardCode);
+        const key = `${set}-${variant}`;
+        if (!groups.has(key)) {
+            const setValue = mappings_1.SET_MAP[set];
+            if (setValue === undefined) {
+                throw new Error(`Unknown set: ${set}. Valid sets: ${Object.keys(mappings_1.SET_MAP).join(", ")}`);
+            }
+            const variantValue = mappings_1.VARIANT_MAP[variant];
+            if (variantValue === undefined) {
+                throw new Error(`Unknown variant: '${variant}'. Valid variants: ${Object.keys(mappings_1.VARIANT_MAP).join(", ")}`);
+            }
+            groups.set(key, {
+                set: setValue,
+                variant: variantValue,
+                cardNumbers: [],
+            });
+        }
+        groups.get(key).cardNumbers.push(number);
+    }
+    return Array.from(groups.values())
+        .sort((a, b) => {
+        if (a.set !== b.set)
+            return a.set - b.set;
+        if (a.variant !== b.variant)
+            return a.variant - b.variant;
+        return 0;
+    })
+        .map((group) => ({
+        ...group,
+        cardNumbers: group.cardNumbers.sort((a, b) => a.localeCompare(b, undefined, { numeric: true })),
+    }));
+}
+/**
+ * Encodes a deck section into bytes
+ * @param deck - The deck to encode
+ * @param maxCount - Maximum count to process (12 for main deck, 3 for sideboard)
+ */
+function encodeDeckSection(deck, maxCount = 12) {
+    const bytes = [];
+    // Process counts from maxCount down to 1
+    for (let count = maxCount; count >= 1; count--) {
+        const cards = deck.filter((card) => card.count === count);
+        const setVariantGroups = groupBySetAndVariant(cards);
+        // Write number of set/variant groups
+        bytes.push(...VarintTranslator_1.default.GetVarint(setVariantGroups.length));
+        // Write each set/variant group
+        for (const group of setVariantGroups) {
+            bytes.push(...VarintTranslator_1.default.GetVarint(group.cardNumbers.length));
+            bytes.push(group.set);
+            bytes.push(group.variant);
+            // Write card numbers
+            for (const cardNumber of group.cardNumbers) {
+                bytes.push(...VarintTranslator_1.default.GetVarint(parseInt(cardNumber)));
+            }
+        }
+    }
+    return bytes;
+}
+/**
+ * Decodes a deck section from bytes
+ * @param translator - The varint translator
+ * @param maxCount - Maximum count to process (12 for main deck, 3 for sideboard)
+ */
+function decodeDeckSection(translator, maxCount = 12) {
+    const deck = [];
+    // Process counts from maxCount down to 1
+    for (let count = maxCount; count >= 1; count--) {
+        const numGroups = translator.PopVarint();
+        for (let i = 0; i < numGroups; i++) {
+            const numCards = translator.PopVarint();
+            const set = translator.get(0);
+            const variant = translator.get(1);
+            translator.sliceAndSet(2);
+            const setCode = Object.entries(mappings_1.SET_MAP).find(([_, value]) => value === set)?.[0];
+            const variantCode = Object.entries(mappings_1.VARIANT_MAP).find(([_, value]) => value === variant)?.[0];
+            if (!setCode) {
+                throw new Error(`Unknown set code: ${set}`);
+            }
+            for (let j = 0; j < numCards; j++) {
+                const cardNumber = translator.PopVarint();
+                deck.push({
+                    cardCode: `${setCode}-${cardNumber.toString().padStart(3, "0")}${variantCode || ""}`,
+                    count,
+                });
+            }
+        }
+    }
+    return deck;
+}
+/**
+ * Encodes a Riftbound deck into a shareable deck code
+ * @param mainDeck - The main deck cards
+ * @param sideboard - Optional sideboard cards (defaults to empty array)
+ * @returns Base32-encoded deck code string
+ * @throws Error if deck format is invalid
+ */
+function getCodeFromDeck(mainDeck, sideboard = []) {
+    const bytes = [];
+    // Write format and version (always version 2)
+    bytes.push((FORMAT << 4) | VERSION);
+    // Encode main deck (counts 1-12)
+    bytes.push(...encodeDeckSection(mainDeck, 12));
+    // Encode sideboard (counts 1-3 only, since sideboards can't have runes/battlefields)
+    // Empty sideboard will encode as three 0-byte varints (3 bytes total)
+    bytes.push(...encodeDeckSection(sideboard, 3));
+    return base32Encode(new Uint8Array(bytes));
+}
+/**
+ * Decodes a Riftbound deck code into deck and sideboard
+ * @param code - Base32-encoded deck code string
+ * @returns Object containing mainDeck and sideboard arrays
+ * @throws Error if code is invalid or unsupported
+ */
+function getDeckFromCode(code) {
+    const bytes = base32Decode(code);
+    const translator = new VarintTranslator_1.default(bytes);
+    // Read format and version
+    const formatVersion = translator.get(0);
+    translator.sliceAndSet(1);
+    const format = (formatVersion >> 4) & 0x0f;
+    const version = formatVersion & 0x0f;
+    if (format !== FORMAT) {
+        throw new Error(`Unsupported format: ${format}. Expected format: ${FORMAT}`);
+    }
+    if (version > VERSION) {
+        throw new Error(`Unsupported version: ${version}. Maximum supported version: ${VERSION}`);
+    }
+    // Decode main deck (counts 1-12)
+    const mainDeck = decodeDeckSection(translator, 12);
+    // Decode sideboard (counts 1-3 only)
+    // Version 1 codes don't have sideboard section, version 2+ do
+    let sideboard = [];
+    if (version >= 2) {
+        sideboard = decodeDeckSection(translator, 3);
+    }
+    return {
+        mainDeck,
+        sideboard,
+    };
+}
+//# sourceMappingURL=deckCode.js.map

package/dist/deckCode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deckCode.js","sourceRoot":"","sources":["../src/deckCode.ts"],"names":[],"mappings":";;;;;AA8OA,0CAcC;AAQD,0CAqCC;AAzSD,yCAAkD;AAElD,0EAAkD;AAElD,MAAM,MAAM,GAAG,CAAC,CAAC;AACjB,MAAM,OAAO,GAAG,CAAC,CAAC;AAClB,MAAM,eAAe,GAAG,kCAAkC,CAAC;AAE3D;;GAEG;AACH,SAAS,YAAY,CAAC,KAAiB;IACrC,IAAI,MAAM,GAAG,EAAE,CAAC;IAChB,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,IAAI,QAAQ,GAAG,CAAC,CAAC;IAEjB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,GAAG,CAAC,MAAM,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC;QAC9B,QAAQ,IAAI,CAAC,CAAC;QAEd,OAAO,QAAQ,IAAI,CAAC,EAAE,CAAC;YACrB,QAAQ,IAAI,CAAC,CAAC;YACd,MAAM,IAAI,eAAe,CAAC,CAAC,MAAM,IAAI,QAAQ,CAAC,GAAG,IAAI,CAAC,CAAC;QACzD,CAAC;IACH,CAAC;IAED,IAAI,QAAQ,GAAG,CAAC,EAAE,CAAC;QACjB,MAAM,KAAK,CAAC,GAAG,QAAQ,CAAC;QACxB,MAAM,IAAI,eAAe,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAC3C,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;GAEG;AACH,SAAS,YAAY,CAAC,GAAW;IAC/B,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,IAAI,QAAQ,GAAG,CAAC,CAAC;IAEjB,KAAK,MAAM,IAAI,IAAI,GAAG,EAAE,CAAC;QACvB,MAAM,KAAK,GAAG,eAAe,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;QAC1D,IAAI,KAAK,KAAK,CAAC,CAAC,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CAAC,oCAAoC,IAAI,GAAG,CAAC,CAAC;QAC/D,CAAC;QAED,MAAM,GAAG,CAAC,MAAM,IAAI,CAAC,CAAC,GAAG,KAAK,CAAC;QAC/B,QAAQ,IAAI,CAAC,CAAC;QAEd,OAAO,QAAQ,IAAI,CAAC,EAAE,CAAC;YACrB,QAAQ,IAAI,CAAC,CAAC;YACd,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,IAAI,QAAQ,CAAC,GAAG,IAAI,CAAC,CAAC;QAC1C,CAAC;IACH,CAAC;IAED,OAAO,IAAI,UAAU,CAAC,KAAK,CAAC,CAAC;AAC/B,CAAC;AAED;;;;;GAKG;AACH,SAAS,aAAa,CAAC,QAAgB;IAKrC,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAClC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,MAAM,IAAI,KAAK,CACb,6BAA6B,QAAQ,sCAAsC,CAC5E,CAAC;IACJ,CAAC;IAED,MAAM,GAAG,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;IACrB,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;IACtB,IAAI,CAAC,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;QAClB,MAAM,IAAI,KAAK,CACb,6BAA6B,QAAQ,+BAA+B,CACrE,CAAC;IACJ,CAAC;IAED,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC;IAC5C,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CACb,6BAA6B,QAAQ,sCAAsC,CAC5E,CAAC;IACJ,CAAC;IAED,OAAO;QACL,GAAG;QACH,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE;QACtB,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE;KACxB,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAS,oBAAoB,CAAC,KAAa;IACzC,MAAM,MAAM,GAAG,IAAI,GAAG,EAA2B,CAAC;IAElD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,aAAa,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC9D,MAAM,GAAG,GAAG,GAAG,GAAG,IAAI,OAAO,EAAE,CAAC;QAEhC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YACrB,MAAM,QAAQ,GAAG,kBAAO,CAAC,GAAG,CAAC,CAAC;YAC9B,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;gBAC3B,MAAM,IAAI,KAAK,CACb,gBAAgB,GAAG,iBAAiB,MAAM,CAAC,IAAI,CAAC,kBAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CACtE,CAAC;YACJ,CAAC;YAED,MAAM,YAAY,GAAG,sBAAW,CAAC,OAAO,CAAC,CAAC;YAC1C,IAAI,YAAY,KAAK,SAAS,EAAE,CAAC;gBAC/B,MAAM,IAAI,KAAK,CACb,qBAAqB,OAAO,sBAAsB,MAAM,CAAC,IAAI,CAC3D,sBAAW,CACZ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CACf,CAAC;YACJ,CAAC;YAED,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE;gBACd,GAAG,EAAE,QAAQ;gBACb,OAAO,EAAE,YAAY;gBACrB,WAAW,EAAE,EAAE;aAChB,CAAC,CAAC;QACL,CAAC;QAED,MAAM,CAAC,GAAG,CAAC,GAAG,CAAE,CAAC,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC5C,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;SAC/B,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QACb,IAAI,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,GAAG;YAAE,OAAO,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,GAAG,CAAC;QAC1C,IAAI,CAAC,CAAC,OAAO,KAAK,CAAC,CAAC,OAAO;YAAE,OAAO,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,OAAO,CAAC;QAC1D,OAAO,CAAC,CAAC;IACX,CAAC,CAAC;SACD,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QACf,GAAG,KAAK;QACR,WAAW,EAAE,KAAK,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAC3C,CAAC,CAAC,aAAa,CAAC,CAAC,EAAE,SAAS,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CACjD;KACF,CAAC,CAAC,CAAC;AACR,CAAC;AAED;;;;GAIG;AACH,SAAS,iBAAiB,CAAC,IAAU,EAAE,WAAmB,EAAE;IAC1D,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,yCAAyC;IACzC,KAAK,IAAI,KAAK,GAAG,QAAQ,EAAE,KAAK,IAAI,CAAC,EAAE,KAAK,EAAE,EAAE,CAAC;QAC/C,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,KAAK,KAAK,CAAC,CAAC;QAC1D,MAAM,gBAAgB,GAAG,oBAAoB,CAAC,KAAK,CAAC,CAAC;QAErD,qCAAqC;QACrC,KAAK,CAAC,IAAI,CAAC,GAAG,0BAAgB,CAAC,SAAS,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC,CAAC;QAEnE,+BAA+B;QAC/B,KAAK,MAAM,KAAK,IAAI,gBAAgB,EAAE,CAAC;YACrC,KAAK,CAAC,IAAI,CAAC,GAAG,0BAAgB,CAAC,SAAS,CAAC,KAAK,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC;YACpE,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YACtB,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YAE1B,qBAAqB;YACrB,KAAK,MAAM,UAAU,IAAI,KAAK,CAAC,WAAW,EAAE,CAAC;gBAC3C,KAAK,CAAC,IAAI,CAAC,GAAG,0BAAgB,CAAC,SAAS,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;YAClE,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;GAIG;AACH,SAAS,iBAAiB,CACxB,UAA4B,EAC5B,WAAmB,EAAE;IAErB,MAAM,IAAI,GAAS,EAAE,CAAC;IAEtB,yCAAyC;IACzC,KAAK,IAAI,KAAK,GAAG,QAAQ,EAAE,KAAK,IAAI,CAAC,EAAE,KAAK,EAAE,EAAE,CAAC;QAC/C,MAAM,SAAS,GAAG,UAAU,CAAC,SAAS,EAAE,CAAC;QAEzC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,SAAS,EAAE,CAAC,EAAE,EAAE,CAAC;YACnC,MAAM,QAAQ,GAAG,UAAU,CAAC,SAAS,EAAE,CAAC;YACxC,MAAM,GAAG,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;YAC9B,MAAM,OAAO,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;YAClC,UAAU,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;YAE1B,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,kBAAO,CAAC,CAAC,IAAI,CAC1C,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,KAAK,KAAK,GAAG,CAC9B,EAAE,CAAC,CAAC,CAAC,CAAC;YACP,MAAM,WAAW,GAAG,MAAM,CAAC,OAAO,CAAC,sBAAW,CAAC,CAAC,IAAI,CAClD,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,KAAK,KAAK,OAAO,CAClC,EAAE,CAAC,CAAC,CAAC,CAAC;YAEP,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,MAAM,IAAI,KAAK,CAAC,qBAAqB,GAAG,EAAE,CAAC,CAAC;YAC9C,CAAC;YAED,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,QAAQ,EAAE,CAAC,EAAE,EAAE,CAAC;gBAClC,MAAM,UAAU,GAAG,UAAU,CAAC,SAAS,EAAE,CAAC;gBAE1C,IAAI,CAAC,IAAI,CAAC;oBACR,QAAQ,EAAE,GAAG,OAAO,IAAI,UAAU,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,GAC5D,WAAW,IAAI,EACjB,EAAE;oBACF,KAAK;iBACN,CAAC,CAAC;YACL,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,eAAe,CAAC,QAAc,EAAE,YAAkB,EAAE;IAClE,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,8CAA8C;IAC9C,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC;IAEpC,iCAAiC;IACjC,KAAK,CAAC,IAAI,CAAC,GAAG,iBAAiB,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,CAAC;IAE/C,qFAAqF;IACrF,sEAAsE;IACtE,KAAK,CAAC,IAAI,CAAC,GAAG,iBAAiB,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,CAAC;IAE/C,OAAO,YAAY,CAAC,IAAI,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC;AAC7C,CAAC;AAED;;;;;GAKG;AACH,SAAgB,eAAe,CAAC,IAAY;IAC1C,MAAM,KAAK,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;IACjC,MAAM,UAAU,GAAG,IAAI,0BAAgB,CAAC,KAAK,CAAC,CAAC;IAE/C,0BAA0B;IAC1B,MAAM,aAAa,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IACxC,UAAU,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;IAE1B,MAAM,MAAM,GAAG,CAAC,aAAa,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC;IAC3C,MAAM,OAAO,GAAG,aAAa,GAAG,IAAI,CAAC;IAErC,IAAI,MAAM,KAAK,MAAM,EAAE,CAAC;QACtB,MAAM,IAAI,KAAK,CACb,uBAAuB,MAAM,sBAAsB,MAAM,EAAE,CAC5D,CAAC;IACJ,CAAC;IAED,IAAI,OAAO,GAAG,OAAO,EAAE,CAAC;QACtB,MAAM,IAAI,KAAK,CACb,wBAAwB,OAAO,gCAAgC,OAAO,EAAE,CACzE,CAAC;IACJ,CAAC;IAED,iCAAiC;IACjC,MAAM,QAAQ,GAAG,iBAAiB,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;IAEnD,qCAAqC;IACrC,8DAA8D;IAC9D,IAAI,SAAS,GAAS,EAAE,CAAC;IACzB,IAAI,OAAO,IAAI,CAAC,EAAE,CAAC;QACjB,SAAS,GAAG,iBAAiB,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC;IAC/C,CAAC;IAED,OAAO;QACL,QAAQ;QACR,SAAS;KACV,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export { getCodeFromDeck, getDeckFromCode } from "./deckCode";
+export { SET_MAP, VARIANT_MAP } from "./mappings";
+export type { Card, Deck, DeckWithSideboard, SetVariantGroup, CountGroup } from "./types";
+export { default as VarintTranslator } from "./VarintTranslator";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAC9D,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAClD,YAAY,EAAE,IAAI,EAAE,IAAI,EAAE,iBAAiB,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAC1F,OAAO,EAAE,OAAO,IAAI,gBAAgB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/index.js

@@ -0,0 +1,15 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VarintTranslator = exports.VARIANT_MAP = exports.SET_MAP = exports.getDeckFromCode = exports.getCodeFromDeck = void 0;
+var deckCode_1 = require("./deckCode");
+Object.defineProperty(exports, "getCodeFromDeck", { enumerable: true, get: function () { return deckCode_1.getCodeFromDeck; } });
+Object.defineProperty(exports, "getDeckFromCode", { enumerable: true, get: function () { return deckCode_1.getDeckFromCode; } });
+var mappings_1 = require("./mappings");
+Object.defineProperty(exports, "SET_MAP", { enumerable: true, get: function () { return mappings_1.SET_MAP; } });
+Object.defineProperty(exports, "VARIANT_MAP", { enumerable: true, get: function () { return mappings_1.VARIANT_MAP; } });
+var VarintTranslator_1 = require("./VarintTranslator");
+Object.defineProperty(exports, "VarintTranslator", { enumerable: true, get: function () { return __importDefault(VarintTranslator_1).default; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;AAAA,uCAA8D;AAArD,2GAAA,eAAe,OAAA;AAAE,2GAAA,eAAe,OAAA;AACzC,uCAAkD;AAAzC,mGAAA,OAAO,OAAA;AAAE,uGAAA,WAAW,OAAA;AAE7B,uDAAiE;AAAxD,qIAAA,OAAO,OAAoB"}

package/dist/mappings.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Mapping of set codes to their numeric identifiers
+ * Format: SET_CODE -> numeric_id
+ */
+export declare const SET_MAP: Record<string, number>;
+/**
+ * Mapping of variant codes to their numeric identifiers
+ * Format: variant_suffix -> numeric_id
+ * Empty string represents the base/default variant
+ */
+export declare const VARIANT_MAP: Record<string, number>;
+//# sourceMappingURL=mappings.d.ts.map

package/dist/mappings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mappings.d.ts","sourceRoot":"","sources":["../src/mappings.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAK1C,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAK9C,CAAC"}

package/dist/mappings.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VARIANT_MAP = exports.SET_MAP = void 0;
+/**
+ * Mapping of set codes to their numeric identifiers
+ * Format: SET_CODE -> numeric_id
+ */
+exports.SET_MAP = {
+    OGN: 0,
+    OGS: 1,
+    ARC: 2,
+    SFD: 3,
+};
+/**
+ * Mapping of variant codes to their numeric identifiers
+ * Format: variant_suffix -> numeric_id
+ * Empty string represents the base/default variant
+ */
+exports.VARIANT_MAP = {
+    "": 0, // Base variant (no suffix)
+    a: 1,
+    s: 2,
+    b: 3,
+};
+//# sourceMappingURL=mappings.js.map

package/dist/mappings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mappings.js","sourceRoot":"","sources":["../src/mappings.ts"],"names":[],"mappings":";;;AAAA;;;GAGG;AACU,QAAA,OAAO,GAA2B;IAC7C,GAAG,EAAE,CAAC;IACN,GAAG,EAAE,CAAC;IACN,GAAG,EAAE,CAAC;IACN,GAAG,EAAE,CAAC;CACP,CAAC;AAEF;;;;GAIG;AACU,QAAA,WAAW,GAA2B;IACjD,EAAE,EAAE,CAAC,EAAE,2BAA2B;IAClC,CAAC,EAAE,CAAC;IACJ,CAAC,EAAE,CAAC;IACJ,CAAC,EAAE,CAAC;CACL,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,18 @@
+export interface Card {
+    cardCode: string;
+    count: number;
+}
+export type Deck = Card[];
+export interface DeckWithSideboard {
+    mainDeck: Deck;
+    sideboard: Deck;
+}
+export interface SetVariantGroup {
+    set: number;
+    variant: number;
+    cardNumbers: string[];
+}
+export interface CountGroup {
+    setVariantGroups: SetVariantGroup[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,IAAI;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;CACd;AAED,MAAM,MAAM,IAAI,GAAG,IAAI,EAAE,CAAC;AAE1B,MAAM,WAAW,iBAAiB;IACjC,QAAQ,EAAE,IAAI,CAAC;IACf,SAAS,EAAE,IAAI,CAAC;CAChB;AAED,MAAM,WAAW,eAAe;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,MAAM,WAAW,UAAU;IAC1B,gBAAgB,EAAE,eAAe,EAAE,CAAC;CACpC"}

package/dist/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "@piltoverarchive/riftbound-deck-codes",
+  "version": "1.0.0",
+  "description": "Encode and decode Riftbound TCG decks to/from shareable strings",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE",
+    "CHANGELOG.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "test": "echo \"Error: no test specified\" && exit 1",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "riftbound",
+    "tcg",
+    "deck",
+    "encoder",
+    "decoder",
+    "league-of-legends",
+    "trading-card-game"
+  ],
+  "author": "Piltover Archive",
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Piltover-Archive/RiftboundDeckCodes.git"
+  },
+  "bugs": {
+    "url": "https://github.com/Piltover-Archive/RiftboundDeckCodes/issues"
+  },
+  "homepage": "https://piltoverarchive.com",
+  "devDependencies": {
+    "typescript": "^5.8.0"
+  },
+  "engines": {
+    "node": ">=16.0.0"
+  }
+}