deterministic-dice 1.0.0 → 2.0.0

package/README.md

@@ -17,15 +17,15 @@ const dice = new DeterministicDice(
   "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef"
 );
 
-dice.roll(15); // 0-15
-dice.roll(6); // 0-6
-dice.roll(100); // 0-100
+dice.roll(16); // 0-15
+dice.roll(6); // 0-5
+dice.roll(100); // 0-99
 ```
 
 ## How It Works
 
 1. Initialize with a bytes32 hash (with or without `0x` prefix)
-2. Call `roll(max)` to get a random number from 0 to max (inclusive)
+2. Call `roll(n)` to get a random number from 0 to n-1 (n possible values)
 3. Entropy is automatically rehashed with SHA256 when exhausted
 4. Same hash always produces the same sequence of rolls
 

package/dist/index.d.ts

@@ -6,9 +6,9 @@ export declare class DeterministicDice {
     private position;
     constructor(randomHash: string);
     /**
-     * Roll a random number from 0 to max (inclusive).
+     * Roll a random number from 0 to n-1 (n possible values).
      */
-    roll(max: number): number;
+    roll(n: number): number;
     private consumeHex;
 }
 export default DeterministicDice;

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,QAAQ,CAAS;gBAEb,UAAU,EAAE,MAAM;IAO9B;;OAEG;IACH,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IAezB,OAAO,CAAC,UAAU;CAYnB;AAED,eAAe,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,QAAQ,CAAS;gBAEb,UAAU,EAAE,MAAM;IAO9B;;OAEG;IACH,IAAI,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM;IAevB,OAAO,CAAC,UAAU;CAYnB;AAED,eAAe,iBAAiB,CAAC"}

package/dist/index.js

@@ -11,10 +11,10 @@ export class DeterministicDice {
         this.position = 0;
     }
     /**
-     * Roll a random number from 0 to max (inclusive).
+     * Roll a random number from 0 to n-1 (n possible values).
      */
-    roll(max) {
-        const range = max + 1;
+    roll(n) {
+        const range = n;
         const bitsNeeded = Math.ceil(Math.log2(range));
         const hexCharsNeeded = Math.max(1, Math.ceil(bitsNeeded / 4));
         const maxValue = Math.pow(16, hexCharsNeeded);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "deterministic-dice",
-  "version": "1.0.0",
+  "version": "2.0.0",
   "description": "Deterministic random number generator seeded by a bytes32 hash",
   "type": "module",
   "main": "./dist/index.js",
@@ -37,4 +37,3 @@
     "typescript": "^5.3.3"
   }
 }
-