k9guard 1.0.1 → 1.0.2

package/src/utils/scrambleGenerator.ts

@@ -1,24 +1,35 @@
 import { randomBytes } from './crypto';
 
 export class ScrambleGenerator {
-  private static words: string[] = [
+  private static readonly easyWords: string[] = [
+    'apple', 'cat', 'dog', 'house', 'sun', 'moon', 'car', 'tree', 'book', 'water'
+  ];
+
+  private static readonly mediumWords: string[] = [
     'apple', 'cat', 'dog', 'house', 'sun', 'moon', 'car', 'tree', 'book', 'water',
     'bread', 'milk', 'fish', 'bird', 'flower', 'star', 'hand', 'eye', 'nose', 'mouth'
   ];
 
+  // hard pool: longer words with uncommon letter patterns to resist guessing
+  private static readonly hardWords: string[] = [
+    'typescript', 'javascript', 'algorithm', 'encryption', 'blockchain',
+    'metamorphosis', 'cryptography', 'synchronize', 'parallelism', 'obfuscation',
+    'infrastructure', 'authentication', 'authorization', 'vulnerability', 'orchestration'
+  ];
+
   static generate(difficulty: 'easy' | 'medium' | 'hard'): { question: string; answer: string } {
-    let word: string;
-    const buffer = randomBytes(4);
-    // convert crypto bytes to a float between 0 and 1
-    const rand = buffer.readUInt32LE(0) / 0xFFFFFFFF;
-    
+    let pool: string[];
     if (difficulty === 'easy') {
-      word = this.words[Math.floor(rand * 10)]!;
+      pool = this.easyWords;
     } else if (difficulty === 'medium') {
-      word = this.words[Math.floor(rand * this.words.length)]!;
+      pool = this.mediumWords;
     } else {
-      word = 'typescript';
+      pool = this.hardWords;
     }
+
+    const buffer = randomBytes(4);
+    const rand = buffer.readUInt32LE(0) / 0xFFFFFFFF;
+    const word = pool[Math.floor(rand * pool.length)]!;
     
     const scrambled = this.scramble(word);
     return { question: scrambled, answer: word };
@@ -26,10 +37,11 @@ export class ScrambleGenerator {
 
   private static scramble(word: string): string {
     const arr = word.split('');
-    // NOTE: fisher yates shuffle using crypto random for each swap
-    for (let i = arr.length - 1; i > 0; i--) {
-      const buffer = randomBytes(4);
-      const j = buffer.readUInt32LE(0) % (i + 1);
+    const n   = arr.length;
+    // batch all uint32 values for Fisher-Yates in one crypto call (n-1 swaps × 4 bytes)
+    const batchBuf = randomBytes(n * 4);
+    for (let i = n - 1; i > 0; i--) {
+      const j = batchBuf.readUInt32LE((n - 1 - i) * 4) % (i + 1);
       [arr[i]!, arr[j]!] = [arr[j]!, arr[i]!];
     }
     return arr.join('');

package/src/utils/sequenceGenerator.ts

@@ -13,16 +13,13 @@ export class SequenceGenerator {
     }
     if (difficulty === 'medium') {
       const letters = ['A', 'B', 'C', 'D', 'E', 'F', 'G', 'H', 'I', 'J'];
-      const buffer = randomBytes(4);
-      const start = buffer.readUInt32LE(0) % 4;
       const step = 2;
+      // max start ensures all 4 elements (start, +2, +4, +6) fit within the 10-letter array
+      const maxStart = letters.length - step * 3 - 1;
+      const buffer = randomBytes(4);
+      const start = buffer.readUInt32LE(0) % (maxStart + 1);
       const sequence = [letters[start], letters[start + step], letters[start + 2 * step]];
-      const nextIndex = start + 3 * step;
-      // check if next letter goes out of bounds
-      if (nextIndex >= letters.length) {
-        return { question: `${sequence.join(', ')}, ?`, answer: '?' };
-      }
-      const answer = letters[nextIndex]!;
+      const answer = letters[start + 3 * step]!;
       return { question: `${sequence.join(', ')}, ?`, answer };
     }
     // hard mode uses fibonacci sequence

package/src/locale/en.json

@@ -1,46 +0,0 @@
-{
-  "riddles": [
-    { "question": "What has keys but can't open locks?", "answer": "piano" },
-    { "question": "What gets wetter as it dries?", "answer": "towel" },
-    { "question": "What has a head, a tail, but no body?", "answer": "coin" },
-    { "question": "What can you catch but not throw?", "answer": "cold" },
-    { "question": "What has one eye but can't see?", "answer": "needle" },
-    { "question": "What is always in front of you but can't be seen?", "answer": "future" },
-    { "question": "What has many teeth but can't bite?", "answer": "comb" },
-    { "question": "What is full of holes but still holds water?", "answer": "sponge" },
-    { "question": "What has a neck but no head?", "answer": "bottle" },
-    { "question": "What can travel around the world while staying in a corner?", "answer": "stamp" },
-    { "question": "What has hands but cannot clap?", "answer": "clock" },
-    { "question": "What runs but never walks?", "answer": "water" },
-    { "question": "What has a bed but never sleeps?", "answer": "river" },
-    { "question": "What has a face and two hands but no arms or legs?", "answer": "clock" },
-    { "question": "What goes up but never comes down?", "answer": "age" },
-    { "question": "What has words but never speaks?", "answer": "book" },
-    { "question": "What has a thumb and four fingers but is not alive?", "answer": "glove" },
-    { "question": "What can fill a room but takes up no space?", "answer": "light" },
-    { "question": "What breaks when you say its name?", "answer": "silence" },
-    { "question": "What has legs but cannot walk?", "answer": "table" }
-  ],
-  "logics": [
-    { "question": "If today is Monday, tomorrow is Tuesday. True or False?", "answer": "True" },
-    { "question": "A cat is an animal. True or False?", "answer": "True" },
-    { "question": "Water is dry. True or False?", "answer": "False" },
-    { "question": "All apples are red. True or False?", "answer": "False" },
-    { "question": "5 is greater than 3. True or False?", "answer": "True" },
-    { "question": "If A > B and B > C, then A > C. True or False?", "answer": "True" },
-    { "question": "A square has 3 sides. True or False?", "answer": "False" },
-    { "question": "The sun rises in the east. True or False?", "answer": "True" },
-    { "question": "Fish can fly. True or False?", "answer": "False" },
-    { "question": "2 + 2 = 4. True or False?", "answer": "True" },
-    { "question": "A triangle has 3 corners. True or False?", "answer": "True" },
-    { "question": "Ice is hot. True or False?", "answer": "False" },
-    { "question": "10 is an even number. True or False?", "answer": "True" },
-    { "question": "Humans need oxygen to breathe. True or False?", "answer": "True" },
-    { "question": "A year has 12 months. True or False?", "answer": "True" },
-    { "question": "Birds are mammals. True or False?", "answer": "False" },
-    { "question": "7 is less than 15. True or False?", "answer": "True" },
-    { "question": "A circle has corners. True or False?", "answer": "False" },
-    { "question": "The earth is flat. True or False?", "answer": "False" },
-    { "question": "A week has 7 days. True or False?", "answer": "True" }
-  ]
-}

package/src/locale/tr.json

@@ -1,46 +0,0 @@
-{
-  "riddles": [
-    { "question": "Anahtarları var ama kapıları açamaz?", "answer": "piyano" },
-    { "question": "Kurudukça ıslanan nedir?", "answer": "havlu" },
-    { "question": "Baş ve kuyruğu var ama vücudu yok?", "answer": "madeni para" },
-    { "question": "Yakalayabilirsin ama atamazsın?", "answer": "soğuk algınlığı" },
-    { "question": "Bir gözü var ama göremez?", "answer": "iğne" },
-    { "question": "Her zaman önünde ama görülemez?", "answer": "gelecek" },
-    { "question": "Çok dişleri var ama ısırmaz?", "answer": "tarak" },
-    { "question": "Delik dolu ama suyu tutar?", "answer": "sünger" },
-    { "question": "Boynu var ama başı yok?", "answer": "şişe" },
-    { "question": "Dünyayı dolaşır ama köşede kalır?", "answer": "posta pulu" },
-    { "question": "Elleri var ama alkışlayamaz?", "answer": "saat" },
-    { "question": "Koşar ama asla yürümez?", "answer": "su" },
-    { "question": "Yatağı var ama asla uyumaz?", "answer": "nehir" },
-    { "question": "Yüzü ve iki eli var ama kolu ve bacağı yok?", "answer": "saat" },
-    { "question": "Yukarı çıkar ama asla aşağı inmez?", "answer": "yaş" },
-    { "question": "Kelimeleri var ama asla konuşmaz?", "answer": "kitap" },
-    { "question": "Başparmağı ve dört parmağı var ama canlı değil?", "answer": "eldiven" },
-    { "question": "Bir odayı doldurur ama yer kaplamaz?", "answer": "ışık" },
-    { "question": "Adını söylediğinde kırılır?", "answer": "sessizlik" },
-    { "question": "Bacakları var ama yürüyemez?", "answer": "masa" }
-  ],
-  "logics": [
-    { "question": "Bugün Pazartesi ise, yarın Salı'dır. Doğru mu Yanlış mı?", "answer": "Doğru" },
-    { "question": "Kedi bir hayvandır. Doğru mu Yanlış mı?", "answer": "Doğru" },
-    { "question": "Su kurudur. Doğru mu Yanlış mı?", "answer": "Yanlış" },
-    { "question": "Tüm elmalar kırmızıdır. Doğru mu Yanlış mı?", "answer": "Yanlış" },
-    { "question": "5, 3'ten büyüktür. Doğru mu Yanlış mı?", "answer": "Doğru" },
-    { "question": "Eğer A > B ve B > C ise, A > C olur. Doğru mu Yanlış mı?", "answer": "Doğru" },
-    { "question": "Karenin 3 kenarı vardır. Doğru mu Yanlış mı?", "answer": "Yanlış" },
-    { "question": "Güneş doğudan doğar. Doğru mu Yanlış mı?", "answer": "Doğru" },
-    { "question": "Balıklar uçar. Doğru mu Yanlış mı?", "answer": "Yanlış" },
-    { "question": "2 + 2 = 4. Doğru mu Yanlış mı?", "answer": "Doğru" },
-    { "question": "Üçgenin 3 köşesi vardır. Doğru mu Yanlış mı?", "answer": "Doğru" },
-    { "question": "Buz sıcaktır. Doğru mu Yanlış mı?", "answer": "Yanlış" },
-    { "question": "10 çift sayıdır. Doğru mu Yanlış mı?", "answer": "Doğru" },
-    { "question": "İnsanlar nefes almak için oksijene ihtiyaç duyar. Doğru mu Yanlış mı?", "answer": "Doğru" },
-    { "question": "Bir yılda 12 ay vardır. Doğru mu Yanlış mı?", "answer": "Doğru" },
-    { "question": "Kuşlar memelidir. Doğru mu Yanlış mı?", "answer": "Yanlış" },
-    { "question": "7, 15'ten küçüktür. Doğru mu Yanlış mı?", "answer": "Doğru" },
-    { "question": "Dairenin köşeleri vardır. Doğru mu Yanlış mı?", "answer": "Yanlış" },
-    { "question": "Dünya düzdür. Doğru mu Yanlış mı?", "answer": "Yanlış" },
-    { "question": "Bir haftada 7 gün vardır. Doğru mu Yanlış mı?", "answer": "Doğru" }
-  ]
-}

package/src/utils/logicGenerator.ts

@@ -1,18 +0,0 @@
-import { randomBytes } from './crypto';
-import enData from '../locale/en.json';
-import trData from '../locale/tr.json';
-
-export class LogicGenerator {
-  private static data: Record<'en' | 'tr', { question: string; answer: string }[]> = {
-    en: enData.logics,
-    tr: trData.logics
-  };
-
-  static getRandom(locale: 'en' | 'tr' = 'en', difficulty: 'easy' | 'medium' | 'hard' = 'easy'): { question: string; answer: string } {
-    const logics = this.data[locale];
-    // use crypto random to select a logic puzzle securely
-    const buffer = randomBytes(4);
-    const index = buffer.readUInt32LE(0) % logics.length;
-    return logics[index]!;
-  }
-}

package/src/utils/riddleBank.ts

@@ -1,18 +0,0 @@
-import { randomBytes } from './crypto';
-import enData from '../locale/en.json';
-import trData from '../locale/tr.json';
-
-export class RiddleBank {
-  private static data: Record<'en' | 'tr', { question: string; answer: string }[]> = {
-    en: enData.riddles,
-    tr: trData.riddles
-  };
-
-  static getRandom(locale: 'en' | 'tr' = 'en', difficulty: 'easy' | 'medium' | 'hard' = 'easy'): { question: string; answer: string } {
-    const riddles = this.data[locale];
-    // use crypto random to select a riddle securely
-    const buffer = randomBytes(4);
-    const index = buffer.readUInt32LE(0) % riddles.length;
-    return riddles[index]!;
-  }
-}