@oxyhq/core 3.4.14 → 3.4.15

package/dist/esm/index.js

@@ -30,7 +30,11 @@ export { AuthManager, createAuthManager } from './AuthManager.js';
 export { CrossDomainAuth, createCrossDomainAuth } from './CrossDomainAuth.js';
 export { ServiceCredentialMismatchError } from './mixins/OxyServices.auth.js';
 export { OxyAppDataIdentifierError } from './mixins/OxyServices.appData.js';
-export { getCanonicalUserHandle, getNormalizedUserId, normalizeUserIdentity, normalizeUserIdentityOrNull, } from './utils/userIdentity.js';
+// ---------------------------------------------------------------------------
+// User identity and handles
+// ---------------------------------------------------------------------------
+export { getNormalizedUserId, normalizeUserIdentity, normalizeUserIdentityOrNull, } from './utils/userIdentity.js';
+export { getCanonicalUserHandle, getNormalizedUserHandle, } from './utils/userHandle.js';
 // ---------------------------------------------------------------------------
 // Auth helpers (token refresh, error normalisation, retry policies)
 // ---------------------------------------------------------------------------

package/dist/esm/utils/userHandle.js

@@ -0,0 +1,33 @@
+function normalizeHandlePart(value) {
+    const trimmed = value?.trim().replace(/^@+/, '');
+    if (!trimmed || /[/?#]/.test(trimmed))
+        return null;
+    return trimmed;
+}
+/**
+ * Returns the normalized profile handle used by Oxy consumers for display and
+ * profile routing.
+ *
+ * Local users resolve to `username`. Federated users resolve to
+ * `username@instance` when the username does not already include an instance.
+ * Route-like values are rejected so callers do not accidentally turn paths or
+ * query strings into profile destinations.
+ */
+export function getNormalizedUserHandle(user) {
+    const username = normalizeHandlePart(user?.username ?? user?.handle);
+    if (!username)
+        return null;
+    const isFederated = user?.isFederated === true || user?.type === 'federated';
+    const instance = normalizeHandlePart(user?.instance ?? user?.federation?.domain);
+    if (isFederated && instance && !username.includes('@')) {
+        return `${username}@${instance}`;
+    }
+    return username;
+}
+/**
+ * Compatibility alias for the first public name shipped with this helper.
+ * Prefer {@link getNormalizedUserHandle} in new code.
+ */
+export function getCanonicalUserHandle(user) {
+    return getNormalizedUserHandle(user);
+}

package/dist/esm/utils/userIdentity.js

@@ -18,18 +18,21 @@ function stringifyIdentity(value) {
     }
     return null;
 }
-function normalizeHandle(value) {
-    const trimmed = value?.trim().replace(/^@+/, '');
-    if (!trimmed || /[/?#]/.test(trimmed))
-        return null;
-    return trimmed;
-}
+/**
+ * Returns the stable SDK user id from API payloads that may use either `id` or
+ * Mongo-style `_id`.
+ */
 export function getNormalizedUserId(user) {
     if (!user) {
         return null;
     }
     return stringifyIdentity(user.id) ?? stringifyIdentity(user._id);
 }
+/**
+ * Normalizes a user payload to always expose `id`. Throws when the payload does
+ * not contain a usable id, because SDK callers should never receive anonymous
+ * user objects from authenticated identity endpoints.
+ */
 export function normalizeUserIdentity(user) {
     const id = getNormalizedUserId(user);
     if (!id) {
@@ -40,14 +43,3 @@ export function normalizeUserIdentity(user) {
 export function normalizeUserIdentityOrNull(user) {
     return user ? normalizeUserIdentity(user) : null;
 }
-export function getCanonicalUserHandle(user) {
-    const username = normalizeHandle(user?.username ?? user?.handle);
-    if (!username)
-        return null;
-    const isFederated = user?.isFederated === true || user?.type === 'federated';
-    const instance = normalizeHandle(user?.instance ?? user?.federation?.domain);
-    if (isFederated && instance && !username.includes('@')) {
-        return `${username}@${instance}`;
-    }
-    return username;
-}