@oxyhq/core 1.11.0 → 1.11.2

package/dist/cjs/i18n/locales/locales/es-ES.json

@@ -147,6 +147,7 @@
   },
   "editProfile": {
     "title": "Editar perfil",
+    "subtitle": "Gestiona tu perfil y preferencias",
     "sections": {
       "profilePicture": "Foto de perfil",
       "basicInfo": "Información básica",
@@ -157,29 +158,69 @@
     "items": {
       "displayName": {
         "title": "Nombre para mostrar",
-        "add": "Añade tu nombre para mostrar"
+        "subtitle": "Así aparecerá tu nombre para los demás",
+        "add": "Añade tu nombre para mostrar",
+        "firstName": "Nombre",
+        "firstNamePlaceholder": "Introduce tu nombre",
+        "lastName": "Apellido",
+        "lastNamePlaceholder": "Introduce tu apellido (opcional)"
       },
       "username": {
         "title": "Usuario",
-        "choose": "Elige un usuario"
+        "subtitle": "Tu identificador único en la plataforma",
+        "label": "Usuario",
+        "placeholder": "Elige un usuario",
+        "choose": "Elige un usuario",
+        "required": "El usuario es obligatorio",
+        "tooShort": "El usuario debe tener al menos 3 caracteres"
       },
       "email": {
         "title": "Correo electrónico",
-        "add": "Añade tu correo electrónico"
+        "subtitle": "Tu dirección de correo principal",
+        "label": "Correo electrónico",
+        "placeholder": "Introduce tu correo electrónico",
+        "add": "Añade tu correo electrónico",
+        "invalid": "Introduce una dirección de correo válida"
       },
       "bio": {
         "title": "Biografía",
+        "subtitle": "Cuenta algo sobre ti",
+        "label": "Biografía",
         "placeholder": "Cuenta algo sobre ti"
       },
+      "phone": {
+        "title": "Número de teléfono",
+        "subtitle": "Tu número de teléfono de contacto",
+        "label": "Número de teléfono",
+        "placeholder": "Introduce tu número de teléfono"
+      },
+      "address": {
+        "title": "Dirección",
+        "subtitle": "Tu dirección física",
+        "label": "Dirección",
+        "placeholder": "Introduce tu dirección"
+      },
+      "birthday": {
+        "title": "Fecha de nacimiento",
+        "subtitle": "Tu fecha de nacimiento",
+        "label": "Fecha de nacimiento",
+        "placeholder": "AAAA-MM-DD"
+      },
       "locations": {
         "title": "Ubicaciones",
+        "subtitle": "Lugares donde has estado o vives",
         "add": "Añade tus ubicaciones",
+        "placeholder": "Introduce el nombre del lugar",
+        "yourLocations": "Tus ubicaciones",
         "count": "{{count}} ubicación añadida",
         "count_plural": "{{count}} ubicaciones añadidas"
       },
       "links": {
         "title": "Enlaces",
+        "subtitle": "Comparte tu web, perfiles sociales, etc.",
         "add": "Añade tus enlaces",
+        "placeholder": "Introduce la URL",
+        "yourLinks": "Tus enlaces",
         "count": "{{count}} enlace añadido",
         "count_plural": "{{count}} enlaces añadidos"
       },
@@ -219,9 +260,15 @@
       "getStarted": "Comenzar",
       "createAccount": "Crear cuenta",
       "signIn": "Entrar",
+      "signOut": "Cerrar sesión",
       "verify": "Verificar",
       "resetPassword": "Restablecer contraseña"
     },
+    "cancel": "Cancelar",
+    "retry": "Reintentar",
+    "save": "Guardar",
+    "saved": "Guardado correctamente",
+    "saving": "Guardando...",
     "links": {
       "recoverAccount": "Recuperar tu cuenta",
       "signUp": "Registrarse"
@@ -623,6 +670,34 @@
         "title": "¿Por qué el karma?",
         "text": "El karma desbloquea funciones especiales y reconocimiento en el ecosistema de Oxy. ¡Cuanto más contribuyas, más ganarás!"
       }
+    },
+    "achievements": {
+      "unlocked": "Logros desbloqueados",
+      "locked": "Logros bloqueados",
+      "firstStep": "Primer paso",
+      "firstStepDesc": "Ganaste tu primer punto de karma",
+      "novice": "Novato",
+      "noviceDesc": "Alcanzaste 10 puntos de karma",
+      "contributor": "Contribuidor",
+      "contributorDesc": "Alcanzaste 50 puntos de karma",
+      "risingStar": "Estrella en ascenso",
+      "risingStarDesc": "Alcanzaste 100 puntos de karma",
+      "earlyAdopter": "Pionero",
+      "earlyAdopterDesc": "Parte de la comunidad desde el inicio",
+      "communityHero": "Héroe de la comunidad",
+      "communityHeroDesc": "Alcanzaste 500 puntos de karma",
+      "legend": "Leyenda",
+      "legendDesc": "Alcanzaste 1000 puntos de karma",
+      "phoenix": "Fénix",
+      "phoenixDesc": "Alcanzaste 2500 puntos de karma",
+      "unstoppable": "Imparable",
+      "unstoppableDesc": "Alcanzaste 5000 puntos de karma",
+      "bugHunter": "Cazador de errores",
+      "bugHunterDesc": "Reportaste errores útiles",
+      "helper": "Ayudante",
+      "helperDesc": "Ayudaste a 10 usuarios",
+      "streakMaster": "Maestro de rachas",
+      "streakMasterDesc": "Racha de actividad de 7 días"
     }
   },
   "premium": {
@@ -819,8 +894,19 @@
       "account": "PRIVACIDAD DE LA CUENTA",
       "interactions": "INTERACCIONES",
       "activity": "ACTIVIDAD Y DATOS",
-      "content": "CONTENIDO Y SEGURIDAD"
-    },
+      "content": "CONTENIDO Y SEGURIDAD",
+      "blockedUsers": "USUARIOS BLOQUEADOS",
+      "restrictedUsers": "USUARIOS RESTRINGIDOS"
+    },
+    "noBlockedUsers": "No hay usuarios bloqueados",
+    "noRestrictedUsers": "No hay usuarios restringidos",
+    "unblock": "Desbloquear",
+    "unblockError": "Error al desbloquear al usuario",
+    "unrestrict": "Quitar restricción",
+    "unrestrictError": "Error al quitar la restricción del usuario",
+    "restrictedDescription": "Interacciones limitadas",
+    "userUnblocked": "Usuario desbloqueado",
+    "userUnrestricted": "Restricción del usuario eliminada",
     "isPrivateAccount": "Cuenta privada",
     "isPrivateAccountDesc": "Solo los seguidores aprobados pueden ver tus publicaciones",
     "profileVisibility": "Visibilidad del perfil",
@@ -940,5 +1026,22 @@
       "title": "Política de cookies",
       "subtitle": "Cómo usamos cookies y tecnologías similares"
     }
+  },
+  "faq": {
+    "title": "Preguntas frecuentes",
+    "searchPlaceholder": "Buscar en las FAQ...",
+    "allCategories": "Todas",
+    "loading": "Cargando preguntas frecuentes...",
+    "noResults": "No se encontraron preguntas que coincidan con tu búsqueda",
+    "empty": "No hay preguntas frecuentes disponibles",
+    "loadError": "Error al cargar las preguntas frecuentes"
+  },
+  "userList": {
+    "followers": "Seguidores",
+    "following": "Siguiendo",
+    "noFollowers": "Aún no hay seguidores",
+    "noFollowersDesc": "Cuando alguien siga a este usuario, aparecerá aquí.",
+    "noFollowing": "No sigue a nadie",
+    "noFollowingDesc": "Cuando este usuario siga a alguien, aparecerá aquí."
   }
 }

package/dist/cjs/index.js

@@ -29,8 +29,8 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.calculateBackoffInterval = exports.createCircuitBreakerState = exports.DEFAULT_CIRCUIT_BREAKER_CONFIG = exports.isRetryableError = exports.isNetworkError = exports.isServerError = exports.isRateLimitError = exports.isNotFoundError = exports.isForbiddenError = exports.isUnauthorizedError = exports.isAlreadyRegisteredError = exports.getErrorMessage = exports.getErrorStatus = exports.HttpStatus = exports.getSystemColorScheme = exports.systemPrefersDarkMode = exports.getOppositeTheme = exports.normalizeColorScheme = exports.normalizeTheme = exports.getContrastTextColor = exports.isLightColor = exports.withOpacity = exports.rgbToHex = exports.hexToRgb = exports.lightenColor = exports.darkenColor = exports.isAndroid = exports.isIOS = exports.isNative = exports.isWeb = exports.setPlatformOS = exports.getPlatformOS = exports.normalizeLanguageCode = exports.getNativeLanguageName = exports.getLanguageName = exports.getLanguageMetadata = exports.SUPPORTED_LANGUAGES = exports.DeviceManager = exports.RecoveryPhraseService = exports.SignatureService = exports.KeyManager = exports.createCrossDomainAuth = exports.CrossDomainAuth = exports.createAuthManager = exports.AuthManager = exports.oxyClient = exports.OXY_CLOUD_URL = exports.OxyAuthenticationTimeoutError = exports.OxyAuthenticationError = exports.OxyServices = void 0;
-exports.createQuickAccount = exports.buildAccountsArray = exports.updateAvatarVisibility = exports.logPerformance = exports.logPayment = exports.logDevice = exports.logUser = exports.logSession = exports.logApi = exports.logAuth = exports.LogLevel = exports.logger = exports.retryAsync = exports.validateRequiredFields = exports.handleHttpError = exports.createApiError = exports.ErrorCodes = exports.packageInfo = exports.sessionsArraysEqual = exports.normalizeAndSortSessions = exports.mergeSessions = exports.authenticatedApiCall = exports.withAuthErrorHandling = exports.isAuthenticationError = exports.ensureValidToken = exports.AuthenticationFailedError = exports.SessionSyncRequiredError = exports.translate = exports.createDebugLogger = exports.debugError = exports.debugWarn = exports.debugLog = exports.isDev = exports.withRetry = exports.delay = exports.shouldAllowRequest = exports.recordSuccess = exports.recordFailure = void 0;
+exports.DEFAULT_CIRCUIT_BREAKER_CONFIG = exports.isRetryableError = exports.isNetworkError = exports.isServerError = exports.isRateLimitError = exports.isNotFoundError = exports.isForbiddenError = exports.isUnauthorizedError = exports.isAlreadyRegisteredError = exports.getErrorMessage = exports.getErrorStatus = exports.HttpStatus = exports.getSystemColorScheme = exports.systemPrefersDarkMode = exports.getOppositeTheme = exports.normalizeColorScheme = exports.normalizeTheme = exports.getContrastTextColor = exports.isLightColor = exports.withOpacity = exports.rgbToHex = exports.hexToRgb = exports.lightenColor = exports.darkenColor = exports.isAndroid = exports.isIOS = exports.isNative = exports.isWeb = exports.setPlatformOS = exports.getPlatformOS = exports.normalizeLanguageCode = exports.getNativeLanguageName = exports.getLanguageName = exports.getLanguageMetadata = exports.SUPPORTED_LANGUAGES = exports.DeviceManager = exports.TopicSource = exports.TopicType = exports.RecoveryPhraseService = exports.SignatureService = exports.KeyManager = exports.createCrossDomainAuth = exports.CrossDomainAuth = exports.createAuthManager = exports.AuthManager = exports.oxyClient = exports.OXY_CLOUD_URL = exports.OxyAuthenticationTimeoutError = exports.OxyAuthenticationError = exports.OxyServices = void 0;
+exports.createQuickAccount = exports.buildAccountsArray = exports.updateAvatarVisibility = exports.logPerformance = exports.logPayment = exports.logDevice = exports.logUser = exports.logSession = exports.logApi = exports.logAuth = exports.LogLevel = exports.logger = exports.retryAsync = exports.validateRequiredFields = exports.handleHttpError = exports.createApiError = exports.ErrorCodes = exports.packageInfo = exports.sessionsArraysEqual = exports.normalizeAndSortSessions = exports.mergeSessions = exports.authenticatedApiCall = exports.withAuthErrorHandling = exports.isAuthenticationError = exports.ensureValidToken = exports.AuthenticationFailedError = exports.SessionSyncRequiredError = exports.translate = exports.createDebugLogger = exports.debugError = exports.debugWarn = exports.debugLog = exports.isDev = exports.withRetry = exports.delay = exports.shouldAllowRequest = exports.recordSuccess = exports.recordFailure = exports.calculateBackoffInterval = exports.createCircuitBreakerState = void 0;
 // Ensure crypto polyfills are loaded before anything else
 require("./crypto/polyfill");
 // --- Core API Client ---
@@ -56,6 +56,9 @@ Object.defineProperty(exports, "RecoveryPhraseService", { enumerable: true, get:
 // --- Models & Types ---
 __exportStar(require("./models/interfaces"), exports);
 __exportStar(require("./models/session"), exports);
+var Topic_1 = require("./models/Topic");
+Object.defineProperty(exports, "TopicType", { enumerable: true, get: function () { return Topic_1.TopicType; } });
+Object.defineProperty(exports, "TopicSource", { enumerable: true, get: function () { return Topic_1.TopicSource; } });
 // --- Device Management ---
 var deviceManager_1 = require("./utils/deviceManager");
 Object.defineProperty(exports, "DeviceManager", { enumerable: true, get: function () { return deviceManager_1.DeviceManager; } });

package/dist/cjs/mixins/OxyServices.topics.js

@@ -0,0 +1,123 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OxyServicesTopicsMixin = OxyServicesTopicsMixin;
+const mixinHelpers_1 = require("./mixinHelpers");
+function OxyServicesTopicsMixin(Base) {
+    return class extends Base {
+        constructor(...args) {
+            super(...args);
+        }
+        /**
+         * Get top-level topic categories
+         * @param locale - Optional locale for translated results
+         * @returns List of category topics
+         */
+        async getTopicCategories(locale) {
+            try {
+                const params = {};
+                if (locale)
+                    params.locale = locale;
+                return await this.makeRequest('GET', '/topics/categories', params, {
+                    cache: true,
+                    cacheTTL: mixinHelpers_1.CACHE_TIMES.EXTRA_LONG,
+                });
+            }
+            catch (error) {
+                throw this.handleError(error);
+            }
+        }
+        /**
+         * Search topics by query string
+         * @param query - Search query
+         * @param limit - Optional result limit
+         * @returns Matching topics
+         */
+        async searchTopics(query, limit) {
+            try {
+                const params = { q: query };
+                if (limit)
+                    params.limit = limit;
+                return await this.makeRequest('GET', '/topics/search', params, {
+                    cache: false,
+                });
+            }
+            catch (error) {
+                throw this.handleError(error);
+            }
+        }
+        /**
+         * List topics with optional filters
+         * @param options - Filter and pagination options
+         * @returns List of topics
+         */
+        async listTopics(options) {
+            try {
+                const params = {};
+                if (options?.type)
+                    params.type = options.type;
+                if (options?.q)
+                    params.q = options.q;
+                if (options?.limit)
+                    params.limit = options.limit;
+                if (options?.offset)
+                    params.offset = options.offset;
+                if (options?.locale)
+                    params.locale = options.locale;
+                return await this.makeRequest('GET', '/topics', params, {
+                    cache: true,
+                    cacheTTL: mixinHelpers_1.CACHE_TIMES.SHORT,
+                });
+            }
+            catch (error) {
+                throw this.handleError(error);
+            }
+        }
+        /**
+         * Get a single topic by slug
+         * @param slug - Topic slug
+         * @returns Topic data
+         */
+        async getTopicBySlug(slug) {
+            try {
+                return await this.makeRequest('GET', `/topics/${slug}`, undefined, {
+                    cache: true,
+                    cacheTTL: mixinHelpers_1.CACHE_TIMES.LONG,
+                });
+            }
+            catch (error) {
+                throw this.handleError(error);
+            }
+        }
+        /**
+         * Resolve an array of topic names to existing or newly created topics
+         * @param names - Array of { name, type } objects to resolve
+         * @returns Resolved topic data
+         */
+        async resolveTopicNames(names) {
+            try {
+                return await this.makeRequest('POST', '/topics/resolve', { names }, {
+                    cache: false,
+                });
+            }
+            catch (error) {
+                throw this.handleError(error);
+            }
+        }
+        /**
+         * Update metadata for a topic
+         * @param slug - Topic slug
+         * @param data - Metadata fields to update
+         * @returns Updated topic data
+         */
+        async updateTopicMetadata(slug, data) {
+            try {
+                return await this.makeRequest('PATCH', `/topics/${slug}`, data, {
+                    cache: false,
+                });
+            }
+            catch (error) {
+                throw this.handleError(error);
+            }
+        }
+    };
+}

package/dist/cjs/mixins/OxyServices.user.js

@@ -89,11 +89,22 @@ function OxyServicesUserMixin(Base) {
             }
         }
         /**
-         * Get profile recommendations
+         * Resolve (find or create) a non-local user. All user creation for
+         * external accounts (federated, agent, automated) goes through this
+         * method — calling services never write user data directly.
          */
-        async getProfileRecommendations() {
+        async resolveExternalUser(data) {
+            return this.makeRequest('PUT', '/users/resolve', data);
+        }
+        /**
+         * Get profile recommendations, optionally filtering out specific user types.
+         */
+        async getProfileRecommendations(options) {
+            const params = options?.excludeTypes?.length
+                ? { excludeTypes: options.excludeTypes.join(',') }
+                : undefined;
             return this.withAuthRetry(async () => {
-                return await this.makeRequest('GET', '/profiles/recommendations', undefined, { cache: true });
+                return await this.makeRequest('GET', '/profiles/recommendations', params, { cache: true });
             }, 'getProfileRecommendations');
         }
         /**

package/dist/cjs/mixins/index.js

@@ -26,6 +26,7 @@ const OxyServices_devices_1 = require("./OxyServices.devices");
 const OxyServices_security_1 = require("./OxyServices.security");
 const OxyServices_utility_1 = require("./OxyServices.utility");
 const OxyServices_features_1 = require("./OxyServices.features");
+const OxyServices_topics_1 = require("./OxyServices.topics");
 /**
  * Mixin pipeline - applied in order from first to last.
  *
@@ -62,6 +63,7 @@ const MIXIN_PIPELINE = [
     OxyServices_devices_1.OxyServicesDevicesMixin,
     OxyServices_security_1.OxyServicesSecurityMixin,
     OxyServices_features_1.OxyServicesFeaturesMixin,
+    OxyServices_topics_1.OxyServicesTopicsMixin,
     // Utility (last, can use all above)
     OxyServices_utility_1.OxyServicesUtilityMixin,
 ];

package/dist/cjs/models/Topic.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TopicSource = exports.TopicType = void 0;
+var TopicType;
+(function (TopicType) {
+    TopicType["CATEGORY"] = "category";
+    TopicType["TOPIC"] = "topic";
+    TopicType["ENTITY"] = "entity";
+})(TopicType || (exports.TopicType = TopicType = {}));
+var TopicSource;
+(function (TopicSource) {
+    TopicSource["SEED"] = "seed";
+    TopicSource["AI"] = "ai";
+    TopicSource["MANUAL"] = "manual";
+    TopicSource["SYSTEM"] = "system";
+})(TopicSource || (exports.TopicSource = TopicSource = {}));