@oxyhq/core 3.17.1 → 3.18.0

package/dist/types/models/interfaces.d.ts

@@ -98,8 +98,10 @@ export interface User {
     privacySettings?: PrivacySettings;
     /**
      * Structured human name. `name.displayName` is the canonical display string
-     * resolved by the API; consumers render it directly instead of recomposing
-     * names from `first` / `last` / `full` / `username`.
+     * resolved by the API when present; consumers render it directly instead of
+     * recomposing names from `first` / `last` / `full` / `username`. It is now
+     * OPTIONAL (see `UserNameResponse`) — when absent, fall back to a handle
+     * (e.g. `getNormalizedUserHandle`) rather than recomposing a name locally.
      */
     name: UserNameResponse;
     bio?: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@oxyhq/core",
-  "version": "3.17.1",
+  "version": "3.18.0",
   "description": "OxyHQ SDK Foundation — API client, authentication, cryptographic identity, and shared utilities",
   "main": "dist/cjs/index.js",
   "module": "dist/esm/index.js",

package/src/mixins/OxyServices.auth.ts

@@ -1026,7 +1026,9 @@ export function OxyServicesAuthMixin<T extends typeof OxyServicesBase>(Base: T)
           continue;
         }
         const userId = e.user.id ?? e.user._id;
-        if (!userId || !e.user.username || !e.user.name?.displayName) {
+        // `name.displayName` is optional on the contract — do NOT drop no-name
+        // accounts. Only an absent userId or username makes the entry unusable.
+        if (!userId || !e.user.username) {
           continue;
         }
         if (typeof e.authuser !== 'number') {
@@ -1040,7 +1042,9 @@ export function OxyServicesAuthMixin<T extends typeof OxyServicesBase>(Base: T)
           user: {
             id: userId,
             username: e.user.username,
-            name: e.user.name,
+            // `name.displayName` is optional; carry whatever structured name the
+            // server sent (possibly an empty object) and let consumers fall back.
+            name: e.user.name ?? {},
             avatar: e.user.avatar ?? null,
             email: e.user.email,
             color: e.user.color ?? null,

package/src/mixins/OxyServices.sso.ts

@@ -171,14 +171,17 @@ export function OxyServicesSsoMixin<T extends typeof OxyServicesBase>(Base: T) {
       }
 
       const userId = payload.user?.id ?? payload.user?._id;
-      if (!userId || typeof payload.user?.username !== 'string' || typeof payload.user.name?.displayName !== 'string') {
+      if (!userId || typeof payload.user?.username !== 'string') {
         throw this.handleError(new Error('SSO exchange returned an invalid user'));
       }
 
       const user: MinimalUserData = {
         id: userId,
         username: payload.user.username,
-        name: payload.user.name,
+        // `name.displayName` is optional on the contract. A no-name user is
+        // valid; carry whatever structured name the server sent (possibly an
+        // empty object) and let consumers fall back to a handle.
+        name: payload.user.name ?? {},
         avatar: payload.user.avatar,
       };
 

package/src/models/interfaces.ts

@@ -108,8 +108,10 @@ export interface User {
   privacySettings?: PrivacySettings;
   /**
    * Structured human name. `name.displayName` is the canonical display string
-   * resolved by the API; consumers render it directly instead of recomposing
-   * names from `first` / `last` / `full` / `username`.
+   * resolved by the API when present; consumers render it directly instead of
+   * recomposing names from `first` / `last` / `full` / `username`. It is now
+   * OPTIONAL (see `UserNameResponse`) — when absent, fall back to a handle
+   * (e.g. `getNormalizedUserHandle`) rather than recomposing a name locally.
    */
   name: UserNameResponse;
   bio?: string;