tsacnhsaves 0.1.0

package/README.md

@@ -0,0 +1,37 @@
+# tsacnhsaves
+
+TypeScript library for reading Animal Crossing: New Horizons save files in the browser or Node. Ported from [kwsch/NHSE](https://github.com/kwsch/NHSE) (C#).
+
+Targets the Web Crypto API, so it runs in browsers without a Node `crypto` polyfill. Read-only: decrypts save pairs, verifies hashes, and parses save structures (players, museum, recipes, villagers, buildings, achievements, turnips, etc).
+
+## Installation
+
+```sh
+pnpm add tsacnhsaves
+```
+
+## Usage
+
+```ts
+import { loadHorizonSave } from 'tsacnhsaves';
+
+// Map of relative path -> file bytes. Keys match the on-disk layout:
+//   "main.dat", "mainHeader.dat",
+//   "Villager0/personal.dat", "Villager0/personalHeader.dat", ...
+const files = new Map<string, Uint8Array>();
+files.set('main.dat', mainDat);
+files.set('mainHeader.dat', mainHeader);
+// ...add each Villager{N}/personal.dat + personalHeader.dat pair
+
+const save = await loadHorizonSave(files);
+
+console.log(save.versionString);
+console.log(save.players[0].playerName, save.players[0].wallet);
+console.log(save.museum.fish.filter(f => f.donated).length);
+```
+
+Lower-level building blocks (`decrypt`, `loadFilePair`, offset tables, per-structure readers) are exported from the package root.
+
+## License
+
+GPL-3.0-or-later. This project is a port of [NHSE](https://github.com/kwsch/NHSE) by Kurt (kwsch), which is licensed under GPL-3.0.

package/dist/encryption/aes-ctr.d.ts

@@ -0,0 +1,14 @@
+/**
+ * AES Counter (CTR) mode encryption/decryption using Web Crypto API.
+ * AES-CTR is symmetric: encryption and decryption are the same operation.
+ *
+ * Ported from NHSE.Core
+ */
+/**
+ * Encrypts or decrypts data using AES-CTR mode.
+ * @param data Data to transform.
+ * @param key 16-byte AES key.
+ * @param counter 16-byte initial counter value.
+ * @returns Transformed data.
+ */
+export declare function aesCtrCrypt(data: Uint8Array, key: Uint8Array, counter: Uint8Array): Promise<Uint8Array>;

package/dist/encryption/aes-ctr.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"aes-ctr.d.ts","sourceRoot":"","sources":["../../src/encryption/aes-ctr.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AASH;;;;;;GAMG;AACH,wBAAsB,WAAW,CAChC,IAAI,EAAE,UAAU,EAChB,GAAG,EAAE,UAAU,EACf,OAAO,EAAE,UAAU,GACjB,OAAO,CAAC,UAAU,CAAC,CAoBrB"}

package/dist/encryption/aes-ctr.js

@@ -0,0 +1,28 @@
+/**
+ * AES Counter (CTR) mode encryption/decryption using Web Crypto API.
+ * AES-CTR is symmetric: encryption and decryption are the same operation.
+ *
+ * Ported from NHSE.Core
+ */
+/** Copy a Uint8Array into a fresh ArrayBuffer (avoids SharedArrayBuffer issues). */
+function toArrayBuffer(src) {
+    const buf = new ArrayBuffer(src.byteLength);
+    new Uint8Array(buf).set(src);
+    return buf;
+}
+/**
+ * Encrypts or decrypts data using AES-CTR mode.
+ * @param data Data to transform.
+ * @param key 16-byte AES key.
+ * @param counter 16-byte initial counter value.
+ * @returns Transformed data.
+ */
+export async function aesCtrCrypt(data, key, counter) {
+    const cryptoKey = await crypto.subtle.importKey('raw', toArrayBuffer(key), { name: 'AES-CTR' }, false, ['encrypt']);
+    const result = await crypto.subtle.encrypt({
+        name: 'AES-CTR',
+        counter: toArrayBuffer(counter),
+        length: 128,
+    }, cryptoKey, toArrayBuffer(data));
+    return new Uint8Array(result);
+}

package/dist/encryption/aes-ctr.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"aes-ctr.js","sourceRoot":"","sources":["../../src/encryption/aes-ctr.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,oFAAoF;AACpF,SAAS,aAAa,CAAC,GAAe;IACrC,MAAM,GAAG,GAAG,IAAI,WAAW,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IAC5C,IAAI,UAAU,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC7B,OAAO,GAAG,CAAC;AACZ,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAChC,IAAgB,EAChB,GAAe,EACf,OAAmB;IAEnB,MAAM,SAAS,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,SAAS,CAC9C,KAAK,EACL,aAAa,CAAC,GAAG,CAAC,EAClB,EAAE,IAAI,EAAE,SAAS,EAAE,EACnB,KAAK,EACL,CAAC,SAAS,CAAC,CACX,CAAC;IAEF,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,OAAO,CACzC;QACC,IAAI,EAAE,SAAS;QACf,OAAO,EAAE,aAAa,CAAC,OAAO,CAAC;QAC/B,MAAM,EAAE,GAAG;KACX,EACD,SAAS,EACT,aAAa,CAAC,IAAI,CAAC,CACnB,CAAC;IAEF,OAAO,IAAI,UAAU,CAAC,MAAM,CAAC,CAAC;AAC/B,CAAC"}

package/dist/encryption/encrypted-int32.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Represents an encrypted 32-bit integer with associated encryption parameters.
+ * Ported from NHSE.Core
+ */
+export interface EncryptedInt32 {
+    originalEncrypted: number;
+    adjust: number;
+    shift: number;
+    checksum: number;
+    value: number;
+}
+/** Calculates a checksum for a given encrypted value. */
+export declare function calculateChecksum(value: number): number;
+export declare function decryptInt32(encrypted: number, shift: number, adjust: number): number;
+export declare function encryptInt32(value: number, shift: number, adjust: number): number;
+export declare function readEncryptedInt32(data: DataView, offset: number): EncryptedInt32;
+export declare function readEncryptedInt32Verify(data: DataView, offset: number): EncryptedInt32;
+export declare function writeEncryptedInt32(data: DataView, offset: number, ei: EncryptedInt32): void;

package/dist/encryption/encrypted-int32.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"encrypted-int32.d.ts","sourceRoot":"","sources":["../../src/encryption/encrypted-int32.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAeH,MAAM,WAAW,cAAc;IAC9B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;CACd;AAED,yDAAyD;AACzD,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAIvD;AAED,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAGrF;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAGjF;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,GAAG,cAAc,CAOjF;AAED,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,GAAG,cAAc,CAQvF;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,cAAc,GAAG,IAAI,CAM5F"}

package/dist/encryption/encrypted-int32.js

@@ -0,0 +1,50 @@
+/**
+ * Represents an encrypted 32-bit integer with associated encryption parameters.
+ * Ported from NHSE.Core
+ */
+const ENCRYPTION_CONSTANT = 0x80e32b11;
+const SHIFT_BASE = 3;
+function rotateRight(value, shift) {
+    shift &= 31;
+    return ((value >>> shift) | (value << (32 - shift))) >>> 0;
+}
+function rotateLeft(value, shift) {
+    shift &= 31;
+    return ((value << shift) | (value >>> (32 - shift))) >>> 0;
+}
+/** Calculates a checksum for a given encrypted value. */
+export function calculateChecksum(value) {
+    value = value >>> 0;
+    const byteSum = value + (value >>> 16) + (value >>> 24) + (value >>> 8);
+    return (byteSum - 0x2d) & 0xff;
+}
+export function decryptInt32(encrypted, shift, adjust) {
+    const rotated = rotateRight(encrypted, shift + SHIFT_BASE);
+    return (rotated + ENCRYPTION_CONSTANT - adjust) >>> 0;
+}
+export function encryptInt32(value, shift, adjust) {
+    const adjusted = (value + adjust - ENCRYPTION_CONSTANT) >>> 0;
+    return rotateLeft(adjusted, shift + SHIFT_BASE);
+}
+export function readEncryptedInt32(data, offset) {
+    const originalEncrypted = data.getUint32(offset, true);
+    const adjust = data.getUint16(offset + 4, true);
+    const shift = data.getUint8(offset + 6);
+    const checksum = data.getUint8(offset + 7);
+    const value = decryptInt32(originalEncrypted, shift, adjust);
+    return { originalEncrypted, adjust, shift, checksum, value };
+}
+export function readEncryptedInt32Verify(data, offset) {
+    const result = readEncryptedInt32(data, offset);
+    if (result.checksum !== calculateChecksum(result.originalEncrypted)) {
+        throw new Error(`Failed to verify EncryptedInt32 at offset 0x${offset.toString(16).toUpperCase().padStart(8, '0')}`);
+    }
+    return result;
+}
+export function writeEncryptedInt32(data, offset, ei) {
+    const encrypted = encryptInt32(ei.value, ei.shift, ei.adjust);
+    data.setUint32(offset, encrypted, true);
+    data.setUint16(offset + 4, ei.adjust, true);
+    data.setUint8(offset + 6, ei.shift);
+    data.setUint8(offset + 7, calculateChecksum(encrypted));
+}

package/dist/encryption/encrypted-int32.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"encrypted-int32.js","sourceRoot":"","sources":["../../src/encryption/encrypted-int32.ts"],"names":[],"mappings":"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"}

package/dist/encryption/encrypted-int32.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=encrypted-int32.test.d.ts.map

package/dist/encryption/encrypted-int32.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"encrypted-int32.test.d.ts","sourceRoot":"","sources":["../../src/encryption/encrypted-int32.test.ts"],"names":[],"mappings":""}

package/dist/encryption/encrypted-int32.test.js

@@ -0,0 +1,45 @@
+import { describe, it, expect } from 'vitest';
+import { calculateChecksum, decryptInt32, encryptInt32, readEncryptedInt32, writeEncryptedInt32, } from './encrypted-int32.js';
+describe('EncryptedInt32', () => {
+    it('encrypt and decrypt should be inverse operations', () => {
+        const original = 0x12345678;
+        const shift = 5;
+        const adjust = 1000;
+        const encrypted = encryptInt32(original, shift, adjust);
+        const decrypted = decryptInt32(encrypted, shift, adjust);
+        expect(decrypted).toBe(original);
+    });
+    it('should work with zero values', () => {
+        const encrypted = encryptInt32(0, 0, 0);
+        const decrypted = decryptInt32(encrypted, 0, 0);
+        expect(decrypted).toBe(0);
+    });
+    it('should work with max values', () => {
+        const original = 0xFFFFFFFF;
+        const shift = 31;
+        const adjust = 0xFFFF;
+        const encrypted = encryptInt32(original, shift, adjust);
+        const decrypted = decryptInt32(encrypted, shift, adjust);
+        expect(decrypted).toBe(original);
+    });
+    it('calculateChecksum should be deterministic', () => {
+        expect(calculateChecksum(0x12345678)).toBe(calculateChecksum(0x12345678));
+    });
+    it('should round-trip through read/write', () => {
+        const buf = new ArrayBuffer(8);
+        const view = new DataView(buf);
+        const original = {
+            originalEncrypted: 0,
+            adjust: 500,
+            shift: 7,
+            checksum: 0,
+            value: 0xABCD1234,
+        };
+        writeEncryptedInt32(view, 0, original);
+        const read = readEncryptedInt32(view, 0);
+        expect(read.value).toBe(original.value);
+        expect(read.adjust).toBe(original.adjust);
+        expect(read.shift).toBe(original.shift);
+    });
+});
+//# sourceMappingURL=encrypted-int32.test.js.map

package/dist/encryption/encrypted-int32.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"encrypted-int32.test.js","sourceRoot":"","sources":["../../src/encryption/encrypted-int32.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EACL,iBAAiB,EACjB,YAAY,EACZ,YAAY,EACZ,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,sBAAsB,CAAC;AAE9B,QAAQ,CAAC,gBAAgB,EAAE,GAAG,EAAE;IAC9B,EAAE,CAAC,kDAAkD,EAAE,GAAG,EAAE;QAC1D,MAAM,QAAQ,GAAG,UAAU,CAAC;QAC5B,MAAM,KAAK,GAAG,CAAC,CAAC;QAChB,MAAM,MAAM,GAAG,IAAI,CAAC;QAEpB,MAAM,SAAS,GAAG,YAAY,CAAC,QAAQ,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;QACxD,MAAM,SAAS,GAAG,YAAY,CAAC,SAAS,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;QACzD,MAAM,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACnC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8BAA8B,EAAE,GAAG,EAAE;QACtC,MAAM,SAAS,GAAG,YAAY,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;QACxC,MAAM,SAAS,GAAG,YAAY,CAAC,SAAS,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;QAChD,MAAM,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC5B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6BAA6B,EAAE,GAAG,EAAE;QACrC,MAAM,QAAQ,GAAG,UAAU,CAAC;QAC5B,MAAM,KAAK,GAAG,EAAE,CAAC;QACjB,MAAM,MAAM,GAAG,MAAM,CAAC;QAEtB,MAAM,SAAS,GAAG,YAAY,CAAC,QAAQ,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;QACxD,MAAM,SAAS,GAAG,YAAY,CAAC,SAAS,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;QACzD,MAAM,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACnC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2CAA2C,EAAE,GAAG,EAAE;QACnD,MAAM,CAAC,iBAAiB,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,iBAAiB,CAAC,UAAU,CAAC,CAAC,CAAC;IAC5E,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sCAAsC,EAAE,GAAG,EAAE;QAC9C,MAAM,GAAG,GAAG,IAAI,WAAW,CAAC,CAAC,CAAC,CAAC;QAC/B,MAAM,IAAI,GAAG,IAAI,QAAQ,CAAC,GAAG,CAAC,CAAC;QAE/B,MAAM,QAAQ,GAAG;YACf,iBAAiB,EAAE,CAAC;YACpB,MAAM,EAAE,GAAG;YACX,KAAK,EAAE,CAAC;YACR,QAAQ,EAAE,CAAC;YACX,KAAK,EAAE,UAAU;SAClB,CAAC;QAEF,mBAAmB,CAAC,IAAI,EAAE,CAAC,EAAE,QAAQ,CAAC,CAAC;QACvC,MAAM,IAAI,GAAG,kBAAkB,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;QAEzC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QACxC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QAC1C,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC1C,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/encryption/encryption.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Save file encryption/decryption for Animal Crossing: New Horizons.
+ * Ported from NHSE.Core
+ */
+export interface EncryptedSaveFile {
+    data: Uint8Array;
+    header: Uint8Array;
+}
+/**
+ * Decrypts save data using the header data.
+ * @param headerData Header data (at least 0x300 bytes).
+ * @param encData Encrypted save data.
+ * @returns Decrypted save data.
+ */
+export declare function decrypt(headerData: Uint8Array, encData: Uint8Array): Promise<Uint8Array>;
+/**
+ * Encrypts save data with a given seed.
+ * @param data Save data to encrypt.
+ * @param seed Seed to encrypt with.
+ * @param versionData Version data (header bytes).
+ * @returns Encrypted save file (data + header).
+ */
+export declare function encrypt(data: Uint8Array, seed: number, versionData: Uint8Array): Promise<EncryptedSaveFile>;

package/dist/encryption/encryption.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"encryption.d.ts","sourceRoot":"","sources":["../../src/encryption/encryption.ts"],"names":[],"mappings":"AAAA;;;GAGG;AA8BH,MAAM,WAAW,iBAAiB;IACjC,IAAI,EAAE,UAAU,CAAC;IACjB,MAAM,EAAE,UAAU,CAAC;CACnB;AAED;;;;;GAKG;AACH,wBAAsB,OAAO,CAAC,UAAU,EAAE,UAAU,EAAE,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,CAQ9F;AA6BD;;;;;;GAMG;AACH,wBAAsB,OAAO,CAC5B,IAAI,EAAE,UAAU,EAChB,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,UAAU,GACrB,OAAO,CAAC,iBAAiB,CAAC,CAI5B"}

package/dist/encryption/encryption.js

@@ -0,0 +1,71 @@
+/**
+ * Save file encryption/decryption for Animal Crossing: New Horizons.
+ * Ported from NHSE.Core
+ */
+import { aesCtrCrypt } from './aes-ctr.js';
+import { XorShift128 } from './xor-shift-128.js';
+const BLOCK_SIZE = 16;
+/**
+ * Derives a 16-byte key or counter from the header's important data region.
+ */
+function getParam(data, index) {
+    const seedIndex = data.getUint32(index * 4, true) & 0x7f;
+    const seed = data.getUint32(seedIndex * 4, true);
+    const rand = new XorShift128(seed);
+    const prmsIndex = data.getUint32((index + 1) * 4, true) & 0x7f;
+    const prms = data.getUint32(prmsIndex * 4, true) & 0x7f;
+    const rndRollCount = (prms & 0xf) + 1;
+    for (let i = 0; i < rndRollCount; i++) {
+        rand.next64();
+    }
+    const result = new Uint8Array(BLOCK_SIZE);
+    for (let i = 0; i < result.length; i++) {
+        result[i] = (rand.next() >>> 24) & 0xff;
+    }
+    return result;
+}
+/**
+ * Decrypts save data using the header data.
+ * @param headerData Header data (at least 0x300 bytes).
+ * @param encData Encrypted save data.
+ * @returns Decrypted save data.
+ */
+export async function decrypt(headerData, encData) {
+    // Important data starts at offset 0x100, length 0x200 (128 uint32 values)
+    const importantData = new DataView(headerData.buffer, headerData.byteOffset + 0x100, 0x200);
+    const key = getParam(importantData, 0);
+    const counter = getParam(importantData, 2);
+    return aesCtrCrypt(encData, key, counter);
+}
+/**
+ * Generates a header file for encryption from a seed.
+ */
+function generateHeaderFile(seed, versionData) {
+    // Generate 128 random uint32s for params
+    const random = new XorShift128(seed);
+    const encryptData = new Uint32Array(128);
+    for (let i = 0; i < encryptData.length; i++) {
+        encryptData[i] = random.next();
+    }
+    const headerData = new Uint8Array(0x300);
+    // Copy version data (first 0x100 bytes)
+    headerData.set(versionData.subarray(0, 0x100));
+    // Copy random data to offset 0x100
+    headerData.set(new Uint8Array(encryptData.buffer), 0x100);
+    const importantView = new DataView(headerData.buffer, 0x100, 0x200);
+    const key = getParam(importantView, 0);
+    const ctr = getParam(importantView, 2);
+    return { headerData, key, ctr };
+}
+/**
+ * Encrypts save data with a given seed.
+ * @param data Save data to encrypt.
+ * @param seed Seed to encrypt with.
+ * @param versionData Version data (header bytes).
+ * @returns Encrypted save file (data + header).
+ */
+export async function encrypt(data, seed, versionData) {
+    const header = generateHeaderFile(seed, versionData);
+    const encData = await aesCtrCrypt(data, header.key, header.ctr);
+    return { data: encData, header: header.headerData };
+}

package/dist/encryption/encryption.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"encryption.js","sourceRoot":"","sources":["../../src/encryption/encryption.ts"],"names":[],"mappings":"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"}

package/dist/encryption/index.d.ts

@@ -0,0 +1,6 @@
+export { aesCtrCrypt } from './aes-ctr.js';
+export type { EncryptedInt32 } from './encrypted-int32.js';
+export { calculateChecksum, decryptInt32, encryptInt32, readEncryptedInt32, readEncryptedInt32Verify, writeEncryptedInt32, } from './encrypted-int32.js';
+export type { EncryptedSaveFile } from './encryption.js';
+export { decrypt, encrypt } from './encryption.js';
+export { XorShift128 } from './xor-shift-128.js';

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/encryption/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,YAAY,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EACN,iBAAiB,EACjB,YAAY,EACZ,YAAY,EACZ,kBAAkB,EAClB,wBAAwB,EACxB,mBAAmB,GACnB,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACzD,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/encryption/index.js

@@ -0,0 +1,4 @@
+export { aesCtrCrypt } from './aes-ctr.js';
+export { calculateChecksum, decryptInt32, encryptInt32, readEncryptedInt32, readEncryptedInt32Verify, writeEncryptedInt32, } from './encrypted-int32.js';
+export { decrypt, encrypt } from './encryption.js';
+export { XorShift128 } from './xor-shift-128.js';

package/dist/encryption/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/encryption/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAE3C,OAAO,EACN,iBAAiB,EACjB,YAAY,EACZ,YAAY,EACZ,kBAAkB,EAClB,wBAAwB,EACxB,mBAAmB,GACnB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/encryption/xor-shift-128.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Xorshift128 RNG Implementation (xor128)
+ * Ported from NHSE.Core
+ * @see https://en.wikipedia.org/wiki/Xorshift#Example_implementation
+ */
+export declare class XorShift128 {
+    private a;
+    private b;
+    private c;
+    private d;
+    private static readonly MERSENNE;
+    constructor(seed: number);
+    /** Returns the next random uint32. */
+    next(): number;
+    /** Returns the next random uint64 as a BigInt. */
+    next64(): bigint;
+}

package/dist/encryption/xor-shift-128.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"xor-shift-128.d.ts","sourceRoot":"","sources":["../../src/encryption/xor-shift-128.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,qBAAa,WAAW;IACvB,OAAO,CAAC,CAAC,CAAS;IAClB,OAAO,CAAC,CAAC,CAAS;IAClB,OAAO,CAAC,CAAC,CAAS;IAClB,OAAO,CAAC,CAAC,CAAS;IAElB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAc;gBAElC,IAAI,EAAE,MAAM;IASxB,sCAAsC;IACtC,IAAI,IAAI,MAAM;IAWd,kDAAkD;IAClD,MAAM,IAAI,MAAM;CAKhB"}

package/dist/encryption/xor-shift-128.js

@@ -0,0 +1,37 @@
+/**
+ * Xorshift128 RNG Implementation (xor128)
+ * Ported from NHSE.Core
+ * @see https://en.wikipedia.org/wiki/Xorshift#Example_implementation
+ */
+export class XorShift128 {
+    a;
+    b;
+    c;
+    d;
+    static MERSENNE = 0x6c078965;
+    constructor(seed) {
+        seed = seed >>> 0;
+        // Unrolled Mersenne Twister initialization loop
+        this.a = (Math.imul(XorShift128.MERSENNE, seed ^ (seed >>> 30)) + 1) >>> 0;
+        this.b = (Math.imul(XorShift128.MERSENNE, this.a ^ (this.a >>> 30)) + 2) >>> 0;
+        this.c = (Math.imul(XorShift128.MERSENNE, this.b ^ (this.b >>> 30)) + 3) >>> 0;
+        this.d = (Math.imul(XorShift128.MERSENNE, this.c ^ (this.c >>> 30)) + 4) >>> 0;
+    }
+    /** Returns the next random uint32. */
+    next() {
+        let t = this.a;
+        this.a = this.b;
+        this.b = this.c;
+        this.c = this.d;
+        t ^= t << 11;
+        t ^= t >>> 8;
+        this.d = (t ^ this.d ^ (this.d >>> 19)) >>> 0;
+        return this.d;
+    }
+    /** Returns the next random uint64 as a BigInt. */
+    next64() {
+        const hi = BigInt(this.next()) << 32n;
+        const lo = BigInt(this.next());
+        return hi | lo;
+    }
+}

package/dist/encryption/xor-shift-128.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"xor-shift-128.js","sourceRoot":"","sources":["../../src/encryption/xor-shift-128.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,OAAO,WAAW;IACf,CAAC,CAAS;IACV,CAAC,CAAS;IACV,CAAC,CAAS;IACV,CAAC,CAAS;IAEV,MAAM,CAAU,QAAQ,GAAG,UAAU,CAAC;IAE9C,YAAY,IAAY;QACvB,IAAI,GAAG,IAAI,KAAK,CAAC,CAAC;QAClB,gDAAgD;QAChD,IAAI,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,QAAQ,EAAE,IAAI,GAAG,CAAC,IAAI,KAAK,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC;QAC3E,IAAI,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC;QAC/E,IAAI,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC;QAC/E,IAAI,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC;IAChF,CAAC;IAED,sCAAsC;IACtC,IAAI;QACH,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC;QACf,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC;QAChB,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC;QAChB,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC;QAChB,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;QACb,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACb,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC;QAC9C,OAAO,IAAI,CAAC,CAAC,CAAC;IACf,CAAC;IAED,kDAAkD;IAClD,MAAM;QACL,MAAM,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,IAAI,GAAG,CAAC;QACtC,MAAM,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;QAC/B,OAAO,EAAE,GAAG,EAAE,CAAC;IAChB,CAAC"}

package/dist/encryption/xor-shift-128.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=xor-shift-128.test.d.ts.map

package/dist/encryption/xor-shift-128.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"xor-shift-128.test.d.ts","sourceRoot":"","sources":["../../src/encryption/xor-shift-128.test.ts"],"names":[],"mappings":""}

package/dist/encryption/xor-shift-128.test.js

@@ -0,0 +1,53 @@
+import { describe, it, expect } from 'vitest';
+import { XorShift128 } from './xor-shift-128.js';
+describe('XorShift128', () => {
+    it('should initialize deterministically from a seed', () => {
+        const rng1 = new XorShift128(12345);
+        const rng2 = new XorShift128(12345);
+        expect(rng1.next()).toBe(rng2.next());
+        expect(rng1.next()).toBe(rng2.next());
+    });
+    it('should produce different sequences for different seeds', () => {
+        const rng1 = new XorShift128(1);
+        const rng2 = new XorShift128(2);
+        // Collect several values - sequences should diverge
+        const seq1 = Array.from({ length: 10 }, () => rng1.next());
+        const seq2 = Array.from({ length: 10 }, () => rng2.next());
+        expect(seq1).not.toEqual(seq2);
+    });
+    it('should produce unsigned 32-bit values', () => {
+        const rng = new XorShift128(0xDEADBEEF);
+        for (let i = 0; i < 100; i++) {
+            const val = rng.next();
+            expect(val).toBeGreaterThanOrEqual(0);
+            expect(val).toBeLessThanOrEqual(0xFFFFFFFF);
+        }
+    });
+    it('next64 should combine two next() calls', () => {
+        const rng1 = new XorShift128(42);
+        const val64 = rng1.next64();
+        const rng2 = new XorShift128(42);
+        const hi = BigInt(rng2.next()) << 32n;
+        const lo = BigInt(rng2.next());
+        expect(val64).toBe(hi | lo);
+    });
+    it('should handle seed 0', () => {
+        const rng = new XorShift128(0);
+        // Should still produce non-zero values after initialization
+        const val = rng.next();
+        expect(val).not.toBe(0);
+    });
+    // Known values from C# reference implementation
+    // Seed: 0x12345678
+    // These can be verified by running the C# version
+    it('should produce expected sequence for known seed', () => {
+        const rng = new XorShift128(0);
+        // Just verify it doesn't throw and produces consistent results
+        const values = Array.from({ length: 5 }, () => rng.next());
+        // Re-create and verify determinism
+        const rng2 = new XorShift128(0);
+        const values2 = Array.from({ length: 5 }, () => rng2.next());
+        expect(values).toEqual(values2);
+    });
+});
+//# sourceMappingURL=xor-shift-128.test.js.map

package/dist/encryption/xor-shift-128.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"xor-shift-128.test.js","sourceRoot":"","sources":["../../src/encryption/xor-shift-128.test.ts"],"names":[],"mappings":"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"}

package/dist/hashing/file-hash-info.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Hash details and info for save file validation.
+ * Ported from NHSE.Core
+ */
+import type { FileHashRegion } from './file-hash-region.js';
+export interface FileHashDetails {
+    fileName: string;
+    fileSize: number;
+    hashRegions: readonly FileHashRegion[];
+}
+export interface FileHashInfo {
+    files: readonly FileHashDetails[];
+}
+export declare function getFileByName(info: FileHashInfo, name: string): FileHashDetails | undefined;

package/dist/hashing/file-hash-info.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-hash-info.d.ts","sourceRoot":"","sources":["../../src/hashing/file-hash-info.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAE5D,MAAM,WAAW,eAAe;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,SAAS,cAAc,EAAE,CAAC;CACvC;AAED,MAAM,WAAW,YAAY;IAC5B,KAAK,EAAE,SAAS,eAAe,EAAE,CAAC;CAClC;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS,CAE3F"}

package/dist/hashing/file-hash-info.js

@@ -0,0 +1,7 @@
+/**
+ * Hash details and info for save file validation.
+ * Ported from NHSE.Core
+ */
+export function getFileByName(info, name) {
+    return info.files.find((f) => f.fileName === name);
+}

package/dist/hashing/file-hash-info.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-hash-info.js","sourceRoot":"","sources":["../../src/hashing/file-hash-info.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAcH,MAAM,UAAU,aAAa,CAAC,IAAkB,EAAE,IAAY;IAC7D,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,IAAI,CAAC,CAAC;AACpD,CAAC"}

package/dist/hashing/file-hash-region.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Specifies the region that a validation hash is calculated over.
+ * Ported from NHSE.Core
+ */
+export interface FileHashRegion {
+    /** Offset where the calculated hash is stored. */
+    hashOffset: number;
+    /** Length of the hashed data. */
+    length: number;
+}
+/** Offset where the data to be hashed starts (hash stored at hashOffset, data follows). */
+export declare function hashRegionBegin(r: FileHashRegion): number;
+/** Offset where the data to be hashed ends (exclusive). */
+export declare function hashRegionEnd(r: FileHashRegion): number;

package/dist/hashing/file-hash-region.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-hash-region.d.ts","sourceRoot":"","sources":["../../src/hashing/file-hash-region.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,cAAc;IAC9B,kDAAkD;IAClD,UAAU,EAAE,MAAM,CAAC;IACnB,iCAAiC;IACjC,MAAM,EAAE,MAAM,CAAC;CACf;AAED,2FAA2F;AAC3F,wBAAgB,eAAe,CAAC,CAAC,EAAE,cAAc,GAAG,MAAM,CAEzD;AAED,2DAA2D;AAC3D,wBAAgB,aAAa,CAAC,CAAC,EAAE,cAAc,GAAG,MAAM,CAEvD"}

package/dist/hashing/file-hash-region.js

@@ -0,0 +1,12 @@
+/**
+ * Specifies the region that a validation hash is calculated over.
+ * Ported from NHSE.Core
+ */
+/** Offset where the data to be hashed starts (hash stored at hashOffset, data follows). */
+export function hashRegionBegin(r) {
+    return r.hashOffset + 4;
+}
+/** Offset where the data to be hashed ends (exclusive). */
+export function hashRegionEnd(r) {
+    return r.hashOffset + 4 + r.length;
+}

package/dist/hashing/file-hash-region.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-hash-region.js","sourceRoot":"","sources":["../../src/hashing/file-hash-region.ts"],"names":[],"mappings":"AAAA;;;GAGG;AASH,2FAA2F;AAC3F,MAAM,UAAU,eAAe,CAAC,CAAiB;IAChD,OAAO,CAAC,CAAC,UAAU,GAAG,CAAC,CAAC;AACzB,CAAC;AAED,2DAA2D;AAC3D,MAAM,UAAU,aAAa,CAAC,CAAiB;IAC9C,OAAO,CAAC,CAAC,UAAU,GAAG,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC;AACpC,CAAC"}

package/dist/hashing/file-hash-revision.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Hash region definitions for all game revisions.
+ * Ported from NHSE.Core FileHashRevision
+ */
+import type { FileHashInfo } from './file-hash-info.js';
+export declare const REV_100: FileHashInfo;
+export declare const REV_110: FileHashInfo;
+export declare const REV_120: FileHashInfo;
+export declare const REV_130: FileHashInfo;
+export declare const REV_140: FileHashInfo;
+export declare const REV_150: FileHashInfo;
+export declare const REV_160: FileHashInfo;
+export declare const REV_170: FileHashInfo;
+export declare const REV_180: FileHashInfo;
+export declare const REV_190: FileHashInfo;
+export declare const REV_1100: FileHashInfo;
+export declare const REV_1110: FileHashInfo;
+export declare const REV_200: FileHashInfo;
+export declare const REV_300: FileHashInfo;

package/dist/hashing/file-hash-revision.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-hash-revision.d.ts","sourceRoot":"","sources":["../../src/hashing/file-hash-revision.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAmB,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAkCzE,eAAO,MAAM,OAAO,EAAE,YA6BpB,CAAC;AAEH,eAAO,MAAM,OAAO,EAAE,YA6BpB,CAAC;AAEH,eAAO,MAAM,OAAO,EAAE,YA6BpB,CAAC;AAEH,eAAO,MAAM,OAAO,EAAE,YA6BpB,CAAC;AAEH,eAAO,MAAM,OAAO,EAAE,YA6BpB,CAAC;AAEH,eAAO,MAAM,OAAO,EAAE,YA6BpB,CAAC;AAEH,eAAO,MAAM,OAAO,EAAE,YA6BpB,CAAC;AAEH,eAAO,MAAM,OAAO,EAAE,YA6BpB,CAAC;AAEH,eAAO,MAAM,OAAO,EAAE,YAAsB,CAAC;AAE7C,eAAO,MAAM,OAAO,EAAE,YA6BpB,CAAC;AAEH,eAAO,MAAM,QAAQ,EAAE,YA6BrB,CAAC;AAEH,eAAO,MAAM,QAAQ,EAAE,YAAuB,CAAC;AAE/C,eAAO,MAAM,OAAO,EAAE,YA8BpB,CAAC;AAEH,eAAO,MAAM,OAAO,EAAE,YA8BpB,CAAC"}