speexjs-core 0.7.0

package/dist/crypto/index.d.ts

@@ -0,0 +1,84 @@
+/**
+ * Simple hash function using the djb2 algorithm.
+ * Fast, non-cryptographic — suitable for hashtables, not security.
+ *
+ * @param str - The string to hash.
+ * @returns A 32-bit integer hash.
+ */
+declare function hash(str: string): number;
+/**
+ * Produces a deterministic hex hash from a string.
+ * NOT actual MD5 — use for cache keys / deterministic IDs.
+ *
+ * @param str - The string to hash.
+ * @returns A 32-character hex string.
+ */
+declare function simpleHash(str: string): string;
+/**
+ * Generates random bytes as a hex string.
+ *
+ * @param size - Number of random bytes (default 16).
+ * @returns A hex string of length `size * 2`.
+ */
+declare function randomHex(size?: number): string;
+/**
+ * Encodes a string to base64. Works in both Node.js and browser.
+ * Handles UTF-8 characters correctly.
+ *
+ * @param str - The string to encode.
+ * @returns The base64-encoded string.
+ */
+declare function base64Encode(str: string): string;
+/**
+ * Decodes a base64-encoded string. Works in both Node.js and browser.
+ *
+ * @param str - The base64 string to decode.
+ * @returns The decoded string.
+ */
+declare function base64Decode(str: string): string;
+/**
+ * Generates a cryptographically random token string.
+ *
+ * @param bytes - Number of random bytes (default 32 → 64-char hex).
+ * @returns A hex string suitable for API keys, reset tokens, etc.
+ */
+declare function generateToken(bytes?: number): string;
+/**
+ * Generates a numeric OTP of the given length.
+ *
+ * @param length - Number of digits (default 6).
+ * @returns A numeric string of the specified length.
+ */
+declare function generateOTP(length?: number): string;
+/**
+ * Simple XOR cipher — symmetrical, for light obfuscation only.
+ *
+ * ⚠️ WARNING: This is NOT encryption. XOR cipher provides zero security
+ * against any attacker. Do NOT use this for passwords, API keys, personal
+ * data, or any sensitive information. It can be trivially reversed.
+ * For real encryption, use native `crypto.subtle` (Web) or `node:crypto`.
+ *
+ * Suitable only for: basic data masking, simple anti-scraping, educational purposes.
+ *
+ * @param str - The input string (will be transformed).
+ * @param key - The cipher key.
+ * @returns The XOR-transformed string.
+ */
+declare function xorCipher(str: string, key: string): string;
+/**
+ * Computes a simple checksum (CRC-like) for file integrity checks.
+ *
+ * @param input - The input string.
+ * @returns An 8-character hex checksum.
+ */
+declare function checksum(input: string): string;
+/**
+ * Constant-time string comparison to prevent timing attacks.
+ *
+ * @param a - First string.
+ * @param b - Second string.
+ * @returns Whether the strings are equal.
+ */
+declare function constantTimeEqual(a: string, b: string): boolean;
+
+export { base64Decode, base64Encode, checksum, constantTimeEqual, generateOTP, generateToken, hash, randomHex, simpleHash, xorCipher };

package/dist/crypto/index.js

@@ -0,0 +1,144 @@
+// src/crypto/index.ts
+function hash(str) {
+  let h = 5381;
+  for (let i = 0; i < str.length; i++) {
+    h = (h << 5) + h + str.charCodeAt(i) | 0;
+  }
+  return h >>> 0;
+}
+function simpleHash(str) {
+  let h1 = 1732584193;
+  let h2 = 4023233417;
+  let h3 = 2562383102;
+  let h4 = 271733878;
+  for (let i = 0; i < str.length; i++) {
+    const c = str.charCodeAt(i);
+    h1 = h1 + c | 0;
+    h2 = h2 + (c << 3) + i | 0;
+    h3 = h3 ^ c | 0;
+    h4 = h4 + (c << 5) + (c << 1) | 0;
+  }
+  const toHex = (n) => (n >>> 0).toString(16).padStart(8, "0");
+  return toHex(h1) + toHex(h2) + toHex(h3) + toHex(h4);
+}
+function getRandomBytes(size) {
+  if (typeof crypto !== "undefined" && typeof crypto.getRandomValues === "function") {
+    const bytes = new Uint8Array(size);
+    crypto.getRandomValues(bytes);
+    return bytes;
+  }
+  throw new Error("Crypto API unavailable. Cannot generate secure random bytes.");
+}
+function randomHex(size = 16) {
+  const bytes = getRandomBytes(size);
+  let result = "";
+  for (let i = 0; i < bytes.length; i++) {
+    result += bytes[i].toString(16).padStart(2, "0");
+  }
+  return result;
+}
+function utf8ToBytes(str) {
+  if (typeof TextEncoder !== "undefined") {
+    return new TextEncoder().encode(str);
+  }
+  const bytes = new Uint8Array(str.length);
+  for (let i = 0; i < str.length; i++) {
+    bytes[i] = str.charCodeAt(i);
+  }
+  return bytes;
+}
+function bytesToUtf8(bytes) {
+  if (typeof TextDecoder !== "undefined") {
+    return new TextDecoder().decode(bytes);
+  }
+  let result = "";
+  for (let i = 0; i < bytes.length; i++) {
+    result += String.fromCharCode(bytes[i]);
+  }
+  return result;
+}
+function bytesToBase64(bytes) {
+  let binary = "";
+  for (let i = 0; i < bytes.length; i++) {
+    binary += String.fromCharCode(bytes[i]);
+  }
+  if (typeof btoa === "function") {
+    return btoa(binary);
+  }
+  return Buffer.from(binary, "latin1").toString("base64");
+}
+function base64ToBytes(str) {
+  let binary;
+  if (typeof atob === "function") {
+    binary = atob(str);
+  } else {
+    binary = Buffer.from(str, "base64").toString("latin1");
+  }
+  const bytes = new Uint8Array(binary.length);
+  for (let i = 0; i < binary.length; i++) {
+    bytes[i] = binary.charCodeAt(i);
+  }
+  return bytes;
+}
+function base64Encode(str) {
+  const bytes = utf8ToBytes(str);
+  return bytesToBase64(bytes);
+}
+function base64Decode(str) {
+  const bytes = base64ToBytes(str);
+  return bytesToUtf8(bytes);
+}
+function generateToken(bytes = 32) {
+  return randomHex(bytes);
+}
+function generateOTP(length = 6) {
+  const bytes = getRandomBytes(length);
+  let otp = "";
+  for (let i = 0; i < length; i++) {
+    otp += (bytes[i] % 10).toString();
+  }
+  return otp;
+}
+function xorCipher(str, key) {
+  let result = "";
+  for (let i = 0; i < str.length; i++) {
+    const code = str.charCodeAt(i) ^ key.charCodeAt(i % key.length);
+    result += String.fromCharCode(code);
+  }
+  return result;
+}
+function checksum(input) {
+  let crc = 4294967295;
+  for (let i = 0; i < input.length; i++) {
+    crc ^= input.charCodeAt(i);
+    for (let j = 0; j < 8; j++) {
+      if (crc & 1) {
+        crc = crc >>> 1 ^ 3988292384;
+      } else {
+        crc = crc >>> 1;
+      }
+    }
+  }
+  return ((crc ^ 4294967295) >>> 0).toString(16).padStart(8, "0");
+}
+function constantTimeEqual(a, b) {
+  if (a.length !== b.length) return false;
+  let result = 0;
+  for (let i = 0; i < a.length; i++) {
+    result |= a.charCodeAt(i) ^ b.charCodeAt(i);
+  }
+  return result === 0;
+}
+export {
+  base64Decode,
+  base64Encode,
+  checksum,
+  constantTimeEqual,
+  generateOTP,
+  generateToken,
+  hash,
+  randomHex,
+  simpleHash,
+  xorCipher
+};
+//# sourceMappingURL=index.js.map

package/dist/crypto/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/crypto/index.ts"],"sourcesContent":["/**\r\n * Simple hash function using the djb2 algorithm.\r\n * Fast, non-cryptographic — suitable for hashtables, not security.\r\n *\r\n * @param str - The string to hash.\r\n * @returns A 32-bit integer hash.\r\n */\r\nexport function hash(str: string): number {\r\n  let h = 5381\r\n  for (let i = 0; i < str.length; i++) {\r\n    h = ((h << 5) + h + str.charCodeAt(i)) | 0\r\n  }\r\n  return h >>> 0\r\n}\r\n\r\n/**\r\n * Produces a deterministic hex hash from a string.\r\n * NOT actual MD5 — use for cache keys / deterministic IDs.\r\n *\r\n * @param str - The string to hash.\r\n * @returns A 32-character hex string.\r\n */\r\nexport function simpleHash(str: string): string {\r\n  let h1 = 0x67452301\r\n  let h2 = 0xefcdab89\r\n  let h3 = 0x98badcfe\r\n  let h4 = 0x10325476\r\n\r\n  for (let i = 0; i < str.length; i++) {\r\n    const c = str.charCodeAt(i)\r\n    h1 = (h1 + c) | 0\r\n    h2 = (h2 + (c << 3) + i) | 0\r\n    h3 = (h3 ^ c) | 0\r\n    h4 = (h4 + (c << 5) + (c << 1)) | 0\r\n  }\r\n\r\n  const toHex = (n: number): string => (n >>> 0).toString(16).padStart(8, '0')\r\n  return toHex(h1) + toHex(h2) + toHex(h3) + toHex(h4)\r\n}\r\n\r\nfunction getRandomBytes(size: number): Uint8Array {\r\n  if (typeof crypto !== 'undefined' && typeof crypto.getRandomValues === 'function') {\r\n    const bytes = new Uint8Array(size)\r\n    crypto.getRandomValues(bytes)\r\n    return bytes\r\n  }\r\n  throw new Error('Crypto API unavailable. Cannot generate secure random bytes.')\r\n}\r\n\r\n/**\r\n * Generates random bytes as a hex string.\r\n *\r\n * @param size - Number of random bytes (default 16).\r\n * @returns A hex string of length `size * 2`.\r\n */\r\nexport function randomHex(size: number = 16): string {\r\n  const bytes = getRandomBytes(size)\r\n  let result = ''\r\n  for (let i = 0; i < bytes.length; i++) {\r\n    result += bytes[i]!.toString(16).padStart(2, '0')\r\n  }\r\n  return result\r\n}\r\n\r\nfunction utf8ToBytes(str: string): Uint8Array {\r\n  if (typeof TextEncoder !== 'undefined') {\r\n    return new TextEncoder().encode(str)\r\n  }\r\n  const bytes = new Uint8Array(str.length)\r\n  for (let i = 0; i < str.length; i++) {\r\n    bytes[i] = str.charCodeAt(i)\r\n  }\r\n  return bytes\r\n}\r\n\r\nfunction bytesToUtf8(bytes: Uint8Array): string {\r\n  if (typeof TextDecoder !== 'undefined') {\r\n    return new TextDecoder().decode(bytes)\r\n  }\r\n  let result = ''\r\n  for (let i = 0; i < bytes.length; i++) {\r\n    result += String.fromCharCode(bytes[i]!)\r\n  }\r\n  return result\r\n}\r\n\r\nfunction bytesToBase64(bytes: Uint8Array): string {\r\n  let binary = ''\r\n  for (let i = 0; i < bytes.length; i++) {\r\n    binary += String.fromCharCode(bytes[i]!)\r\n  }\r\n  if (typeof btoa === 'function') {\r\n    return btoa(binary)\r\n  }\r\n  return Buffer.from(binary, 'latin1').toString('base64')\r\n}\r\n\r\nfunction base64ToBytes(str: string): Uint8Array {\r\n  let binary: string\r\n  if (typeof atob === 'function') {\r\n    binary = atob(str)\r\n  } else {\r\n    binary = Buffer.from(str, 'base64').toString('latin1')\r\n  }\r\n  const bytes = new Uint8Array(binary.length)\r\n  for (let i = 0; i < binary.length; i++) {\r\n    bytes[i] = binary.charCodeAt(i)\r\n  }\r\n  return bytes\r\n}\r\n\r\n/**\r\n * Encodes a string to base64. Works in both Node.js and browser.\r\n * Handles UTF-8 characters correctly.\r\n *\r\n * @param str - The string to encode.\r\n * @returns The base64-encoded string.\r\n */\r\nexport function base64Encode(str: string): string {\r\n  const bytes = utf8ToBytes(str)\r\n  return bytesToBase64(bytes)\r\n}\r\n\r\n/**\r\n * Decodes a base64-encoded string. Works in both Node.js and browser.\r\n *\r\n * @param str - The base64 string to decode.\r\n * @returns The decoded string.\r\n */\r\nexport function base64Decode(str: string): string {\r\n  const bytes = base64ToBytes(str)\r\n  return bytesToUtf8(bytes)\r\n}\r\n\r\n/**\r\n * Generates a cryptographically random token string.\r\n *\r\n * @param bytes - Number of random bytes (default 32 → 64-char hex).\r\n * @returns A hex string suitable for API keys, reset tokens, etc.\r\n */\r\nexport function generateToken(bytes: number = 32): string {\r\n  return randomHex(bytes)\r\n}\r\n\r\n/**\r\n * Generates a numeric OTP of the given length.\r\n *\r\n * @param length - Number of digits (default 6).\r\n * @returns A numeric string of the specified length.\r\n */\r\nexport function generateOTP(length: number = 6): string {\r\n  const bytes = getRandomBytes(length)\r\n  let otp = ''\r\n  for (let i = 0; i < length; i++) {\r\n    otp += (bytes[i]! % 10).toString()\r\n  }\r\n  return otp\r\n}\r\n\r\n/**\r\n * Simple XOR cipher — symmetrical, for light obfuscation only.\r\n *\r\n * ⚠️ WARNING: This is NOT encryption. XOR cipher provides zero security\r\n * against any attacker. Do NOT use this for passwords, API keys, personal\r\n * data, or any sensitive information. It can be trivially reversed.\r\n * For real encryption, use native `crypto.subtle` (Web) or `node:crypto`.\r\n *\r\n * Suitable only for: basic data masking, simple anti-scraping, educational purposes.\r\n *\r\n * @param str - The input string (will be transformed).\r\n * @param key - The cipher key.\r\n * @returns The XOR-transformed string.\r\n */\r\nexport function xorCipher(str: string, key: string): string {\r\n  let result = ''\r\n  for (let i = 0; i < str.length; i++) {\r\n    const code = str.charCodeAt(i) ^ key.charCodeAt(i % key.length)\r\n    result += String.fromCharCode(code)\r\n  }\r\n  return result\r\n}\r\n\r\n/**\r\n * Computes a simple checksum (CRC-like) for file integrity checks.\r\n *\r\n * @param input - The input string.\r\n * @returns An 8-character hex checksum.\r\n */\r\nexport function checksum(input: string): string {\r\n  let crc = 0xffffffff\r\n  for (let i = 0; i < input.length; i++) {\r\n    crc ^= input.charCodeAt(i)\r\n    for (let j = 0; j < 8; j++) {\r\n      if (crc & 1) {\r\n        crc = (crc >>> 1) ^ 0xedb88320\r\n      } else {\r\n        crc = crc >>> 1\r\n      }\r\n    }\r\n  }\r\n  return ((crc ^ 0xffffffff) >>> 0).toString(16).padStart(8, '0')\r\n}\r\n\r\n/**\r\n * Constant-time string comparison to prevent timing attacks.\r\n *\r\n * @param a - First string.\r\n * @param b - Second string.\r\n * @returns Whether the strings are equal.\r\n */\r\nexport function constantTimeEqual(a: string, b: string): boolean {\r\n  if (a.length !== b.length) return false\r\n  let result = 0\r\n  for (let i = 0; i < a.length; i++) {\r\n    result |= a.charCodeAt(i) ^ b.charCodeAt(i)\r\n  }\r\n  return result === 0\r\n}\r\n"],"mappings":"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","names":[]}