@oxy.so/core 4.5.0-oxy-one.1 → 4.6.0

package/src/utils/sessionUtils.ts

@@ -1,6 +1,6 @@
 /**
  * Session management utilities
- * 
+ *
  * Provides consistent session normalization, deduplication, and sorting
  * to ensure sessions are always displayed in a predictable order.
  */
@@ -10,7 +10,9 @@ import type { ClientSession } from '../models/session';
 /**
  * Normalize a session to ensure all required fields are present
  */
-export function normalizeSession(session: Partial<ClientSession> & { sessionId: string }): ClientSession {
+export function normalizeSession(
+  session: Partial<ClientSession> & { sessionId: string },
+): ClientSession {
   const now = new Date().toISOString();
   return {
     sessionId: session.sessionId,
@@ -49,7 +51,7 @@ export function sortSessions(sessions: ClientSession[]): ClientSession[] {
  */
 export function deduplicateSessions(sessions: ClientSession[]): ClientSession[] {
   const sessionMap = new Map<string, ClientSession>();
-  
+
   for (const session of sessions) {
     const existing = sessionMap.get(session.sessionId);
     if (!existing) {
@@ -63,7 +65,7 @@ export function deduplicateSessions(sessions: ClientSession[]): ClientSession[]
       }
     }
   }
-  
+
   return Array.from(sessionMap.values());
 }
 
@@ -74,15 +76,15 @@ export function deduplicateSessions(sessions: ClientSession[]): ClientSession[]
  */
 export function deduplicateSessionsByUserId(
   sessions: ClientSession[],
-  activeSessionId?: string | null
+  activeSessionId?: string | null,
 ): ClientSession[] {
   if (!sessions.length) return [];
-  
+
   const userSessionMap = new Map<string, ClientSession>();
-  
+
   for (const session of sessions) {
     if (!session.userId) continue; // Skip sessions without userId
-    
+
     const existing = userSessionMap.get(session.userId);
     if (!existing) {
       userSessionMap.set(session.userId, session);
@@ -90,7 +92,7 @@ export function deduplicateSessionsByUserId(
       // Prioritize active session
       const isCurrentActive = activeSessionId && session.sessionId === activeSessionId;
       const isExistingActive = activeSessionId && existing.sessionId === activeSessionId;
-      
+
       if (isCurrentActive && !isExistingActive) {
         userSessionMap.set(session.userId, session);
       } else if (!isCurrentActive && isExistingActive) {
@@ -104,14 +106,14 @@ export function deduplicateSessionsByUserId(
       }
     }
   }
-  
+
   return Array.from(userSessionMap.values());
 }
 
 /**
  * Normalize, deduplicate, and sort sessions
  * This ensures consistent session ordering across the application
- * 
+ *
  * @param sessions - Array of sessions to normalize
  * @param activeSessionId - Optional active session ID to prioritize
  * @param deduplicateByUserId - If true, deduplicate by userId (one account per user). Default: true
@@ -119,21 +121,21 @@ export function deduplicateSessionsByUserId(
 export function normalizeAndSortSessions(
   sessions: ClientSession[],
   activeSessionId?: string | null,
-  deduplicateByUserId = true
+  deduplicateByUserId = true,
 ): ClientSession[] {
   if (!sessions.length) return [];
-  
+
   // Normalize all sessions
   const normalized = sessions.map(normalizeSession);
-  
+
   // First deduplicate by sessionId (exact duplicates)
   const deduplicatedBySessionId = deduplicateSessions(normalized);
-  
+
   // Then deduplicate by userId if requested (one account per user)
   const finalSessions = deduplicateByUserId
     ? deduplicateSessionsByUserId(deduplicatedBySessionId, activeSessionId)
     : deduplicatedBySessionId;
-  
+
   // Sort consistently
   return sortSessions(finalSessions);
 }
@@ -141,7 +143,7 @@ export function normalizeAndSortSessions(
 /**
  * Merge two session arrays, prioritizing newer data
  * Returns normalized, deduplicated, and sorted sessions
- * 
+ *
  * @param existing - Existing sessions array
  * @param incoming - New sessions to merge in
  * @param activeSessionId - Optional active session ID to prioritize
@@ -151,37 +153,39 @@ export function mergeSessions(
   existing: ClientSession[],
   incoming: ClientSession[],
   activeSessionId?: string | null,
-  deduplicateByUserId = true
+  deduplicateByUserId = true,
 ): ClientSession[] {
   if (!existing.length && !incoming.length) return [];
-  if (!existing.length) return normalizeAndSortSessions(incoming, activeSessionId, deduplicateByUserId);
-  if (!incoming.length) return normalizeAndSortSessions(existing, activeSessionId, deduplicateByUserId);
-  
+  if (!existing.length)
+    return normalizeAndSortSessions(incoming, activeSessionId, deduplicateByUserId);
+  if (!incoming.length)
+    return normalizeAndSortSessions(existing, activeSessionId, deduplicateByUserId);
+
   // Normalize both arrays
   const normalizedExisting = existing.map(normalizeSession);
   const normalizedIncoming = incoming.map(normalizeSession);
-  
+
   // Create a map with existing sessions (by sessionId)
   const sessionMap = new Map<string, ClientSession>();
-  
+
   // Add existing sessions first
   for (const session of normalizedExisting) {
     sessionMap.set(session.sessionId, session);
   }
-  
+
   // Merge incoming sessions - backend data always replaces existing
   for (const session of normalizedIncoming) {
     sessionMap.set(session.sessionId, session);
   }
-  
+
   // Convert to array
   const merged = Array.from(sessionMap.values());
-  
+
   // Apply userId deduplication if requested
   const finalSessions = deduplicateByUserId
     ? deduplicateSessionsByUserId(merged, activeSessionId)
     : merged;
-  
+
   // Sort consistently
   return sortSessions(finalSessions);
 }
@@ -193,12 +197,9 @@ export function sessionsArraysEqual(a: ClientSession[], b: ClientSession[]): boo
   if (a.length !== b.length) {
     return false;
   }
-  
+
   const sortedA = sortSessions(a);
   const sortedB = sortSessions(b);
-  
-  return sortedA.every((session, index) => 
-    sessionsEqual(session, sortedB[index])
-  );
-}
 
+  return sortedA.every((session, index) => sessionsEqual(session, sortedB[index]));
+}

package/src/utils/userHandle.ts

@@ -44,6 +44,8 @@ export function getNormalizedUserHandle(user: UserHandleInput | null | undefined
  * Compatibility alias for the first public name shipped with this helper.
  * Prefer {@link getNormalizedUserHandle} in new code.
  */
-export function getCanonicalUserHandle(user: CanonicalUserHandleInput | null | undefined): string | null {
+export function getCanonicalUserHandle(
+  user: CanonicalUserHandleInput | null | undefined,
+): string | null {
   return getNormalizedUserHandle(user);
 }

package/src/utils/userIdentity.ts

@@ -29,7 +29,7 @@ function stringifyIdentity(value: unknown): string | null {
 
 /**
  * Returns the stable SDK user id from API payloads that may use either `id` or
- * Mongo-style `_id`.
+ * a raw `_id`.
  */
 export function getNormalizedUserId(user: UserIdentityInput | null | undefined): string | null {
   if (!user) {

package/src/utils/validationUtils.ts

@@ -87,10 +87,10 @@ export function isValidPassword(password: string): boolean {
  * — script digits (`٠١٢`, `०१२`), 1082 symbols (`֍ ۞ ৳`), 180 punctuation marks
  * (`։ ، ؛ ।`), and 9 INVISIBLE format/control characters, among them U+061C
  * ARABIC LETTER MARK (a bidi control that can visually reorder a name) and
- * U+180E MONGOLIAN VOWEL SEPARATOR. Without it the rejections listed above held
+ * U+180E (the Mong-script vowel separator). Without it the rejections listed above held
  * for ASCII input only. It is the set of scripts Unicode UTS #39 marks
  * "Recommended" for general interchange / identifiers, plus Cherokee and
- * Mongolian (both in real modern name use). "Common" script is deliberately
+ * the Mong script, ISO 15924 (both in real modern name use). "Common" script is deliberately
  * EXCLUDED — that is where ASCII digits and general punctuation live, and this
  * policy excludes those; the space separators, combining marks, and apostrophe a
  * name needs are added back explicitly. Limited-use / excluded / historic
@@ -351,15 +351,14 @@ export function sanitizeHTML(input: string): string {
 }
 
 /**
- * Validate MongoDB ObjectId format
- * Note: This is a basic format check. For full validation, use mongoose.Types.ObjectId.isValid()
- * This function works in environments where mongoose may not be available (e.g., client-side)
+ * Validate the legacy 24-hex id format (a format check only; it does not
+ * prove the id exists).
  */
 export function isValidObjectId(id: string): boolean {
   if (typeof id !== 'string') {
     return false;
   }
-  // MongoDB ObjectId is 24 hex characters
+  // A legacy id is 24 hex characters
   const OBJECT_ID_REGEX = /^[0-9a-fA-F]{24}$/;
   return OBJECT_ID_REGEX.test(id);
 }
@@ -367,13 +366,16 @@ export function isValidObjectId(id: string): boolean {
 /**
  * Validate and sanitize user input
  */
-export function validateAndSanitizeUserInput(input: unknown, type: 'string' | 'email' | 'username'): string | null {
+export function validateAndSanitizeUserInput(
+  input: unknown,
+  type: 'string' | 'email' | 'username',
+): string | null {
   if (typeof input !== 'string') {
     return null;
   }
 
   const sanitized = sanitizeString(input);
-  
+
   switch (type) {
     case 'email':
       return isValidEmail(sanitized) ? sanitized : null;
@@ -387,4 +389,4 @@ export function validateAndSanitizeUserInput(input: unknown, type: 'string' | 'e
     default:
       return null;
   }
-} 
+}