@oxyhq/core 3.4.15 → 3.4.17

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (28) hide show
  1. package/README.md +7 -2
  2. package/dist/cjs/.tsbuildinfo +1 -1
  3. package/dist/cjs/AuthManager.js +5 -0
  4. package/dist/cjs/mixins/OxyServices.auth.js +1 -1
  5. package/dist/cjs/mixins/OxyServices.sso.js +2 -1
  6. package/dist/cjs/mixins/OxyServices.user.js +1 -1
  7. package/dist/cjs/utils/accountUtils.js +15 -14
  8. package/dist/esm/.tsbuildinfo +1 -1
  9. package/dist/esm/AuthManager.js +5 -0
  10. package/dist/esm/mixins/OxyServices.auth.js +1 -1
  11. package/dist/esm/mixins/OxyServices.sso.js +2 -1
  12. package/dist/esm/mixins/OxyServices.user.js +1 -1
  13. package/dist/esm/utils/accountUtils.js +15 -14
  14. package/dist/types/.tsbuildinfo +1 -1
  15. package/dist/types/mixins/OxyServices.user.d.ts +5 -8
  16. package/dist/types/models/interfaces.d.ts +11 -10
  17. package/dist/types/models/session.d.ts +2 -0
  18. package/dist/types/utils/accountUtils.d.ts +11 -18
  19. package/package.json +2 -2
  20. package/src/AuthManager.ts +6 -1
  21. package/src/mixins/OxyServices.auth.ts +1 -1
  22. package/src/mixins/OxyServices.sso.ts +4 -1
  23. package/src/mixins/OxyServices.user.ts +5 -4
  24. package/src/models/interfaces.ts +11 -10
  25. package/src/models/session.ts +3 -0
  26. package/src/utils/__tests__/accountUtils.test.ts +10 -23
  27. package/src/utils/accountUtils.ts +25 -24
  28. package/src/utils/asyncUtils.ts +1 -1
package/README.md CHANGED
@@ -2,7 +2,7 @@
2
2
 
3
3
  OxyHQ SDK Foundation. Platform-agnostic core library that works in Node.js, browser, and React Native environments. No React dependency.
4
4
 
5
- **Current published version: 3.4.15**
5
+ **Current published version: 3.4.16**
6
6
 
7
7
  ## Installation
8
8
 
@@ -21,7 +21,7 @@ bun add @oxyhq/core
21
21
  - **Platform detection utilities**
22
22
  - **Device management**
23
23
  - **Linked clients** for app backends that need the active Oxy bearer token
24
- - **User identity and handle normalization** so SDK user payloads expose `id` and apps build local/federated profile handles consistently
24
+ - **User identity contracts and handle normalization** so SDK user payloads expose required `id`/`displayName` fields and apps build local/federated profile handles consistently
25
25
  - **Server middleware** for Express request identity and per-user rate limiting
26
26
 
27
27
  ## Exports
@@ -58,6 +58,11 @@ const id = getNormalizedUserId(user);
58
58
  const normalizedUser = normalizeUserIdentity(user);
59
59
  ```
60
60
 
61
+ `User.displayName` is a required API contract. The API composes it server-side
62
+ from the structured name when present, otherwise from the username/server
63
+ fallback. UI consumers should render `displayName` directly instead of rebuilding
64
+ names from `name.first`, `name.last`, `name.full`, or `username`.
65
+
61
66
  For profile display/routing, use `getNormalizedUserHandle()`. It strips a
62
67
  leading `@`, preserves an existing `user@instance` handle, and appends
63
68
  `instance`/`federation.domain` only for federated users: