cynx-lib 1.3.80 → 1.3.82

package/utils/utils/session.js

@@ -1,58 +1,58 @@
-/**
- * cynx/utils — Session and Device Resolution Utilities (session.js)
- *
- * Helpers for generating secure session tokens and extracting human-friendly device names
- * from request headers and user-agent strings.
- */
-
-import { getRandomBytes } from './uid.js';
-
-/**
- * Generate a cryptographically secure random session token.
- * Example: "st_9b1deb4d3b7d4bad9bdd2b0d7b3dcb6d..."
- *
- * @param {number} [byteLength=32]
- * @returns {string}
- */
-export function genSessionToken(byteLength = 32) {
-  const bytes = getRandomBytes(byteLength);
-  let hex = '';
-  for (let i = 0; i < bytes.length; i++) {
-    hex += bytes[i].toString(16).padStart(2, '0');
-  }
-  return `st_${hex}`;
-}
-
-/**
- * Derive human-readable device name from Express/Fastify request or User-Agent string.
- *
- * @param {object} [req] HTTP request object
- * @param {string} [userAgent=''] User-Agent string
- * @returns {string} e.g. "Windows PC", "Mac", "iPhone", "Android Device", "Desktop PC"
- */
-export function deriveDeviceName(req, userAgent = '') {
-  const headers = req?.headers || {};
-  const fromHeader = headers['x-device-name'] || headers['x-pc-name'] || headers['x-computer-name'] || '';
-  if (typeof fromHeader === 'string' && fromHeader.trim()) {
-    return fromHeader.trim().slice(0, 120);
-  }
-
-  const fromBody = req?.body?.deviceName || req?.body?.device_name || req?.body?.pcName || req?.body?.pc_name;
-  if (typeof fromBody === 'string' && fromBody.trim()) {
-    return fromBody.trim().slice(0, 120);
-  }
-
-  const ua = userAgent || headers['user-agent'] || '';
-  if (/windows/i.test(ua)) return 'Windows PC';
-  if (/macintosh|mac os/i.test(ua)) return 'Mac';
-  if (/iphone/i.test(ua)) return 'iPhone';
-  if (/ipad/i.test(ua)) return 'iPad';
-  if (/android/i.test(ua)) return 'Android Device';
-  if (/linux/i.test(ua)) return 'Linux PC';
-  return 'Desktop PC';
-}
-
-export default {
-  genSessionToken,
-  deriveDeviceName,
-};
+/**
+ * cynx/utils — Session and Device Resolution Utilities (session.js)
+ *
+ * Helpers for generating secure session tokens and extracting human-friendly device names
+ * from request headers and user-agent strings.
+ */
+
+import { getRandomBytes } from './uid.js';
+
+/**
+ * Generate a cryptographically secure random session token.
+ * Example: "st_9b1deb4d3b7d4bad9bdd2b0d7b3dcb6d..."
+ *
+ * @param {number} [byteLength=32]
+ * @returns {string}
+ */
+export function genSessionToken(byteLength = 32) {
+  const bytes = getRandomBytes(byteLength);
+  let hex = '';
+  for (let i = 0; i < bytes.length; i++) {
+    hex += bytes[i].toString(16).padStart(2, '0');
+  }
+  return `st_${hex}`;
+}
+
+/**
+ * Derive human-readable device name from Express/Fastify request or User-Agent string.
+ *
+ * @param {object} [req] HTTP request object
+ * @param {string} [userAgent=''] User-Agent string
+ * @returns {string} e.g. "Windows PC", "Mac", "iPhone", "Android Device", "Desktop PC"
+ */
+export function deriveDeviceName(req, userAgent = '') {
+  const headers = req?.headers || {};
+  const fromHeader = headers['x-device-name'] || headers['x-pc-name'] || headers['x-computer-name'] || '';
+  if (typeof fromHeader === 'string' && fromHeader.trim()) {
+    return fromHeader.trim().slice(0, 120);
+  }
+
+  const fromBody = req?.body?.deviceName || req?.body?.device_name || req?.body?.pcName || req?.body?.pc_name;
+  if (typeof fromBody === 'string' && fromBody.trim()) {
+    return fromBody.trim().slice(0, 120);
+  }
+
+  const ua = userAgent || headers['user-agent'] || '';
+  if (/windows/i.test(ua)) return 'Windows PC';
+  if (/macintosh|mac os/i.test(ua)) return 'Mac';
+  if (/iphone/i.test(ua)) return 'iPhone';
+  if (/ipad/i.test(ua)) return 'iPad';
+  if (/android/i.test(ua)) return 'Android Device';
+  if (/linux/i.test(ua)) return 'Linux PC';
+  return 'Desktop PC';
+}
+
+export default {
+  genSessionToken,
+  deriveDeviceName,
+};