@oxy.so/core 1.1.1 → 1.2.0

package/dist/esm/index.js

@@ -91,7 +91,7 @@ export { TopicType, TopicSource } from './models/Topic.js';
 // ---------------------------------------------------------------------------
 // Languages
 // ---------------------------------------------------------------------------
-export { SUPPORTED_LANGUAGES, FALLBACK_LOCALE, getBaseLanguage, normalizeLocale, isSupportedLocale, getLanguageMetadata, getLanguageName, getNativeLanguageName, isRTLLocale, getUserLanguages, getPrimaryLanguage, } from './utils/languageUtils.js';
+export { SUPPORTED_LANGUAGES, FALLBACK_LOCALE, getBaseLanguage, normalizeLocale, isSupportedLocale, getLanguageMetadata, getLanguageName, getNativeLanguageName, isRTLLocale, getUserLanguages, getPrimaryLanguage, coerceToSupportedLocale, } from './utils/languageUtils.js';
 // ---------------------------------------------------------------------------
 // Platform detection
 // ---------------------------------------------------------------------------

package/dist/esm/utils/cache.js

@@ -78,6 +78,8 @@ export class TTLCache {
         const effectiveTTL = ttl === undefined ? this.defaultTTL : ttl;
         const expiresAt = now + effectiveTTL;
         this.cache.set(key, { data, timestamp: now, expiresAt });
+        if (!cleanupInterval && activeCaches.has(this))
+            updateCleanupInterval();
     }
     /**
      * Delete a specific cache entry
@@ -85,7 +87,10 @@ export class TTLCache {
      * @returns true if entry was deleted, false if not found
      */
     delete(key) {
-        return this.cache.delete(key);
+        const deleted = this.cache.delete(key);
+        if (activeCaches.has(this))
+            updateCleanupInterval();
+        return deleted;
     }
     /**
      * Clear all cache entries
@@ -94,6 +99,8 @@ export class TTLCache {
         this.cache.clear();
         this.hits = 0;
         this.misses = 0;
+        if (activeCaches.has(this))
+            updateCleanupInterval();
     }
     /**
      * Check if a key exists and is not expired
@@ -191,28 +198,30 @@ const activeCaches = new Set();
  */
 export function registerCacheForCleanup(cache) {
     activeCaches.add(cache);
-    // Start cleanup interval if not already running
-    if (!cleanupInterval) {
-        cleanupInterval = setInterval(() => {
-            for (const cache of activeCaches) {
-                cache.cleanup();
-            }
-        }, 60000); // Every minute
-        // Never block process/worker exit on a housekeeping timer.
-        cleanupInterval.unref?.();
+    updateCleanupInterval();
+}
+/** Empty registered caches need no timer; importing a client must stay inert. */
+function updateCleanupInterval() {
+    const hasEntries = [...activeCaches].some(cache => cache.size() > 0);
+    if (!hasEntries) {
+        if (cleanupInterval)
+            clearInterval(cleanupInterval);
+        cleanupInterval = null;
+        return;
     }
+    if (cleanupInterval)
+        return;
+    cleanupInterval = setInterval(() => {
+        for (const cache of activeCaches)
+            cache.cleanup();
+        updateCleanupInterval();
+    }, 60000);
+    cleanupInterval.unref?.();
 }
-/**
- * Unregister a cache from automatic cleanup
- * @param cache Cache instance to unregister
- */
+/** Unregister a cache without changing its entries or TTL behavior. */
 export function unregisterCacheFromCleanup(cache) {
     activeCaches.delete(cache);
-    // Stop cleanup interval if no caches are registered
-    if (activeCaches.size === 0 && cleanupInterval) {
-        clearInterval(cleanupInterval);
-        cleanupInterval = null;
-    }
+    updateCleanupInterval();
 }
 /**
  * Stop all cleanup intervals (useful for testing)

package/dist/esm/utils/languageUtils.js

@@ -210,3 +210,28 @@ export function getUserLanguages(user) {
 export function getPrimaryLanguage(user) {
     return getUserLanguages(user)[0];
 }
+/**
+ * Coerce a locale down to one from a CALLER-provided catalog: an exact
+ * canonical match wins, else the closest entry sharing the same base
+ * language (an `es-MX` account reads a host app's `es-ES` catalog), else
+ * `fallback`.
+ *
+ * A host app's own shipped translation catalog is rarely {@link SUPPORTED_LANGUAGES}
+ * itself — Oxy's account-locale catalog is broader than any one app's
+ * translated strings — so this is the one place that gap is bridged. Every Oxy
+ * app was independently re-deriving this exact algorithm against its own
+ * catalog before it moved here.
+ */
+export function coerceToSupportedLocale(locale, supportedLocales, fallback) {
+    if (locale) {
+        const canonical = normalizeLocale(locale);
+        if (canonical && supportedLocales.includes(canonical)) {
+            return canonical;
+        }
+        const base = getBaseLanguage(locale);
+        const byBase = supportedLocales.find((entry) => getBaseLanguage(entry) === base);
+        if (byBase)
+            return byBase;
+    }
+    return fallback;
+}