@oxy.so/core 7.12.0 → 7.13.1

package/src/api/devices.ts

@@ -40,6 +40,8 @@ import type {
 import { logger } from '../logger';
 import { extractErrorStatus } from '../utils/errorUtils';
 
+const enc = encodeURIComponent;
+
 /** One of the signed-in user's devices (`GET /devices`). */
 export interface UserDevice {
   id: string;
@@ -139,7 +141,7 @@ export class DevicesApi {
    * @param deviceId - The device ID to remove
    */
   async remove(deviceId: string): Promise<void> {
-    await this.ctx.request('DELETE', `/devices/${deviceId}`, undefined, { cache: false });
+    await this.ctx.request('DELETE', `/devices/${enc(deviceId)}`, undefined, { cache: false });
   }
 
   /**
@@ -152,7 +154,7 @@ export class DevicesApi {
     // Cache disabled by default to ensure fresh session data
     return this.ctx.request<DeviceLinkedSession[]>(
       'GET',
-      `/session/device/sessions/${sessionId}`,
+      `/session/device/sessions/${enc(sessionId)}`,
       undefined,
       {
         cache: false, // Don't cache sessions - always get fresh data
@@ -178,7 +180,7 @@ export class DevicesApi {
     if (excludeCurrent) urlParams.excludeCurrent = 'true';
     return this.ctx.request<DeviceLinkedSessionLogoutResponse>(
       'POST',
-      `/session/device/logout-all/${sessionId}`,
+      `/session/device/logout-all/${enc(sessionId)}`,
       urlParams,
       { cache: false },
     );
@@ -196,7 +198,7 @@ export class DevicesApi {
   ): Promise<{ success: boolean; message: string; deviceName: string }> {
     return this.ctx.request(
       'PUT',
-      `/session/device/name/${sessionId}`,
+      `/session/device/name/${enc(sessionId)}`,
       { deviceName },
       { cache: false },
     );

package/src/api/follows.ts

@@ -27,6 +27,7 @@ import {
   buildUrl,
   type FollowGraphParams,
 } from '../utils/apiUtils';
+import { oxyUserByIdCacheKey, oxyUserByIdPath } from '../utils/identityCacheSweep';
 
 const GRAPH_TTL = 2 * 60 * 1000;
 const STATUS_TTL = 60 * 1000;
@@ -130,7 +131,7 @@ export class FollowsApi {
   async follow(userId: string): Promise<FollowMutationResult> {
     const result = await this.ctx.request<FollowMutationResult>(
       'POST',
-      `/users/${userId}/follow`,
+      `${oxyUserByIdPath(userId)}/follow`,
       undefined,
       { cache: false },
     );
@@ -155,7 +156,7 @@ export class FollowsApi {
   async unfollow(userId: string): Promise<FollowMutationResult> {
     const result = await this.ctx.request<FollowMutationResult>(
       'DELETE',
-      `/users/${userId}/follow`,
+      `${oxyUserByIdPath(userId)}/follow`,
       undefined,
       { cache: false },
     );
@@ -178,7 +179,7 @@ export class FollowsApi {
 
   /** Whether the signed-in user follows `userId`. Cached 1 minute, busted by every write. */
   async status(userId: string): Promise<{ isFollowing: boolean }> {
-    return this.ctx.request('GET', `/users/${userId}/follow-status`, undefined, {
+    return this.ctx.request('GET', `${oxyUserByIdPath(userId)}/follow-status`, undefined, {
       cache: true,
       cacheTTL: STATUS_TTL,
     });
@@ -221,13 +222,19 @@ export class FollowsApi {
    * `limit`/`offset`/`sort` combination is its own cache entry (2 minutes).
    */
   async followers(userId: string, params?: FollowGraphParams): Promise<UserPage<'followers'>> {
-    const { data, total, hasMore } = await this.userPage(`/users/${userId}/followers`, params);
+    const { data, total, hasMore } = await this.userPage(
+      `${oxyUserByIdPath(userId)}/followers`,
+      params,
+    );
     return { followers: data, total, hasMore };
   }
 
   /** Who a user follows. `sort` as in `followers`. */
   async following(userId: string, params?: FollowGraphParams): Promise<UserPage<'following'>> {
-    const { data, total, hasMore } = await this.userPage(`/users/${userId}/following`, params);
+    const { data, total, hasMore } = await this.userPage(
+      `${oxyUserByIdPath(userId)}/following`,
+      params,
+    );
     return { following: data, total, hasMore };
   }
 
@@ -236,7 +243,10 @@ export class FollowsApi {
    * `userId`.
    */
   async mutuals(userId: string, params?: FollowGraphParams): Promise<UserPage<'mutuals'>> {
-    const { data, total, hasMore } = await this.userPage(`/users/${userId}/mutuals`, params);
+    const { data, total, hasMore } = await this.userPage(
+      `${oxyUserByIdPath(userId)}/mutuals`,
+      params,
+    );
     return { mutuals: data, total, hasMore };
   }
 
@@ -443,15 +453,16 @@ export class FollowsApi {
     const keys: string[] = ['GET:/users/me/graph'];
     const prefixes: string[] = ['GET:/profiles/username/', 'GET:/profiles/resolve'];
     for (const id of targetUserIds) {
-      keys.push(`GET:/users/${id}/follow-status`);
+      const user = oxyUserByIdPath(id);
+      keys.push(`GET:${user}/follow-status`);
       // Profiles embed the viewer-relative `relationship`.
-      keys.push(`GET:/users/${id}`);
+      keys.push(oxyUserByIdCacheKey(id));
       // The target gained or lost a follower, and "followers you know" with it.
-      prefixes.push(`GET:/users/${id}/followers`, `GET:/users/${id}/mutuals`);
+      prefixes.push(`GET:${user}/followers`, `GET:${user}/mutuals`);
     }
     // The viewer's own following list changed.
     const viewerId = this.ctx.oxy.session.userId;
-    if (viewerId) prefixes.push(`GET:/users/${viewerId}/following`);
+    if (viewerId) prefixes.push(`GET:${oxyUserByIdPath(viewerId)}/following`);
     this.ctx.http.invalidateCache({ keys, prefixes });
   }
 }

package/src/api/privacy.ts

@@ -5,6 +5,8 @@ import type { BlockedUser, PrivacySettings, RestrictedUser } from '../models/int
 import type { OxyContext } from '../client/context';
 import { evictOxyIdentityCache } from '../utils/identityCacheSweep';
 
+const enc = encodeURIComponent;
+
 const LIST_TTL = 60 * 1000;
 const SETTINGS_TTL = 2 * 60 * 1000;
 
@@ -20,7 +22,7 @@ export class PrivacyApi {
   /** A user's privacy settings (default: the signed-in user's). */
   async settings(userId?: string): Promise<PrivacySettings> {
     const id = await this.resolveUserId(userId);
-    return this.ctx.request<PrivacySettings>('GET', `/privacy/${id}/privacy`, undefined, {
+    return this.ctx.request<PrivacySettings>('GET', `/privacy/${enc(id)}/privacy`, undefined, {
       cache: true,
       cacheTTL: SETTINGS_TTL,
     });
@@ -34,13 +36,13 @@ export class PrivacyApi {
     const id = await this.resolveUserId(userId);
     const res = await this.ctx.request<PrivacySettings>(
       'PATCH',
-      `/privacy/${id}/privacy`,
+      `/privacy/${enc(id)}/privacy`,
       settings,
       { cache: false },
     );
     // Privacy settings ride the user DTO, so every identity read goes stale too.
     evictOxyIdentityCache(this.ctx.http, id);
-    this.ctx.oxy.cache.delete(`GET:/privacy/${id}/privacy`);
+    this.ctx.oxy.cache.delete(`GET:/privacy/${enc(id)}/privacy`);
     return res;
   }
 
@@ -59,7 +61,7 @@ export class PrivacyApi {
     requireId(userId);
     const res = await this.ctx.request<{ message: string }>(
       'POST',
-      `/privacy/blocked/${userId}`,
+      `/privacy/blocked/${enc(userId)}`,
       undefined,
       { cache: false },
     );
@@ -72,7 +74,7 @@ export class PrivacyApi {
     requireId(userId);
     const res = await this.ctx.request<{ message: string }>(
       'DELETE',
-      `/privacy/blocked/${userId}`,
+      `/privacy/blocked/${enc(userId)}`,
       undefined,
       { cache: false },
     );
@@ -105,7 +107,7 @@ export class PrivacyApi {
     requireId(userId);
     const res = await this.ctx.request<{ message: string }>(
       'POST',
-      `/privacy/restricted/${userId}`,
+      `/privacy/restricted/${enc(userId)}`,
       undefined,
       { cache: false },
     );
@@ -118,7 +120,7 @@ export class PrivacyApi {
     requireId(userId);
     const res = await this.ctx.request<{ message: string }>(
       'DELETE',
-      `/privacy/restricted/${userId}`,
+      `/privacy/restricted/${enc(userId)}`,
       undefined,
       { cache: false },
     );

package/src/api/session.ts

@@ -20,6 +20,8 @@ import type {
   HolderEvidenceUnavailableReason,
 } from './holderEvidence';
 
+const enc = encodeURIComponent;
+
 /** How long a refusal (disabled, rate limited, unreachable) is remembered per installation. */
 const EVIDENCE_REFUSAL_MS = 5_000;
 const unavailable = (reason: HolderEvidenceUnavailableReason): HolderEvidenceResult => ({
@@ -376,7 +378,7 @@ export class SessionApi {
           )
         : await this.ctx.request<SessionValidation>(
             'GET',
-            `/session/validate/${sessionId}`,
+            `/session/validate/${enc(sessionId)}`,
             {
               ...(options.deviceFingerprint
                 ? { deviceFingerprint: options.deviceFingerprint }
@@ -407,7 +409,7 @@ export class SessionApi {
         const invalid =
           candidate?.status === 401 && candidate.code === 'OXY_LIVE_SESSION_INVALID_V1';
         const denied = candidate?.status === 403 && candidate.code === 'OXY_LIVE_SESSION_POLICY_V1';
-        if (invalid) this.ctx.oxy.cache.delete(`GET:/session/user/${sessionId}`);
+        if (invalid) this.ctx.oxy.cache.delete(`GET:/session/user/${enc(sessionId)}`);
         if (invalid || denied) throw error;
         throw new OxyApiError('Live session authority is unavailable', {
           status: 503,
@@ -416,29 +418,36 @@ export class SessionApi {
         });
       }
       // The session is gone: drop any user cached for it (#196).
-      this.ctx.oxy.cache.delete(`GET:/session/user/${sessionId}`);
+      this.ctx.oxy.cache.delete(`GET:/session/user/${enc(sessionId)}`);
       throw error;
     }
   }
 
   /** The sessions that belong with `sessionId` (same account set). */
   async list(sessionId: string): Promise<ClientSession[]> {
-    return this.ctx.request<ClientSession[]>('GET', `/session/sessions/${sessionId}`, undefined, {
-      cache: false,
-    });
+    return this.ctx.request<ClientSession[]>(
+      'GET',
+      `/session/sessions/${enc(sessionId)}`,
+      undefined,
+      {
+        cache: false,
+      },
+    );
   }
 
   /** Sign out `sessionId`, or — with `targetSessionId` — one of the sessions beside it. */
   async logout(sessionId: string, targetSessionId?: string): Promise<void> {
     const url = targetSessionId
-      ? `/session/logout/${sessionId}/${targetSessionId}`
-      : `/session/logout/${sessionId}`;
+      ? `/session/logout/${enc(sessionId)}/${enc(targetSessionId)}`
+      : `/session/logout/${enc(sessionId)}`;
     await this.ctx.request('POST', url, undefined, { cache: false });
   }
 
   /** Sign out the other sessions for this account; preserve `sessionId`. */
   async logoutAll(sessionId: string): Promise<void> {
-    await this.ctx.request('POST', `/session/logout-all/${sessionId}`, undefined, { cache: false });
+    await this.ctx.request('POST', `/session/logout-all/${enc(sessionId)}`, undefined, {
+      cache: false,
+    });
   }
 
   /** Decoded claims of the current token, memoised per token string. */

package/src/api/topics.ts

@@ -4,6 +4,8 @@
 import type { OxyContext } from '../client/context';
 import type { TopicData, TopicListResult, TopicTranslation } from '../models/Topic';
 
+const enc = encodeURIComponent;
+
 const SHORT = 60 * 1000;
 const LONG = 5 * 60 * 1000;
 const EXTRA_LONG = 30 * 60 * 1000;
@@ -51,7 +53,7 @@ export class TopicsApi {
 
   /** One topic by slug. */
   async get(slug: string): Promise<TopicData> {
-    return this.ctx.request<TopicData>('GET', `/topics/${slug}`, undefined, {
+    return this.ctx.request<TopicData>('GET', `/topics/${enc(slug)}`, undefined, {
       cache: true,
       cacheTTL: LONG,
     });
@@ -86,10 +88,10 @@ export class TopicsApi {
     slug: string,
     data: { description?: string; translations?: Record<string, TopicTranslation> },
   ): Promise<TopicData> {
-    const topic = await this.ctx.request<TopicData>('PATCH', `/topics/${slug}`, data, {
+    const topic = await this.ctx.request<TopicData>('PATCH', `/topics/${enc(slug)}`, data, {
       cache: false,
     });
-    this.ctx.oxy.cache.delete(`GET:/topics/${slug}`);
+    this.ctx.oxy.cache.delete(`GET:/topics/${enc(slug)}`);
     return topic;
   }
 }

package/src/api/users.ts

@@ -12,7 +12,11 @@ import type { OxyContext } from '../client/context';
 import type { PaginationInfo, SearchProfilesResponse, User } from '../models/interfaces';
 import { buildQueryParams, type PaginationParams } from '../utils/apiUtils';
 import { normalizeUserIdentity, normalizeUserIdentityOrNull } from '../utils/userIdentity';
-import { OXY_IDENTITY_CACHE_PREFIXES, oxyUserByIdCacheKey } from '../utils/identityCacheSweep';
+import {
+  OXY_IDENTITY_CACHE_PREFIXES,
+  oxyUserByIdCacheKey,
+  oxyUserByIdPath,
+} from '../utils/identityCacheSweep';
 import {
   OXY_ACCOUNT_LIST_CACHE_KEY,
   OXY_ACCOUNT_LIST_CACHE_QUERY_PREFIX,
@@ -22,6 +26,8 @@ import { extractErrorStatus } from '../utils/errorUtils';
 import { type BatchLookup, runBatchLookup } from '../utils/batchLookup';
 import { logger } from '../logger';
 
+const enc = encodeURIComponent;
+
 const PROFILE_TTL = 5 * 60 * 1000;
 const SESSION_USER_TTL = 2 * 60 * 1000;
 const ME_TTL = 60 * 1000;
@@ -65,7 +71,7 @@ export class UsersApi {
    * registry-fresh read that neither serves nor overwrites a cached entry.
    */
   async get(userId: string, options?: { cache?: boolean }): Promise<User> {
-    const user = await this.ctx.request<User>('GET', `/users/${userId}`, undefined, {
+    const user = await this.ctx.request<User>('GET', oxyUserByIdPath(userId), undefined, {
       cache: options?.cache ?? true,
       cacheTTL: PROFILE_TTL,
     });
@@ -166,7 +172,7 @@ export class UsersApi {
 
   /** The user a session belongs to. */
   async bySession(sessionId: string): Promise<User> {
-    const user = await this.ctx.request<User>('GET', `/session/user/${sessionId}`, undefined, {
+    const user = await this.ctx.request<User>('GET', `/session/user/${enc(sessionId)}`, undefined, {
       cache: true,
       cacheTTL: SESSION_USER_TTL,
     });
@@ -271,7 +277,7 @@ export class UsersApi {
         : (limitOrPagination ?? {});
     const users = await this.ctx.request<User[]>(
       'GET',
-      `/profiles/${userId}/similar`,
+      `/profiles/${enc(userId)}/similar`,
       buildQueryParams(pagination),
       {
         cache: true,
@@ -289,7 +295,7 @@ export class UsersApi {
   async moderators(communityId: string): Promise<User[]> {
     const moderators = await this.ctx.request<User[]>(
       'GET',
-      `/users/${communityId}/moderators`,
+      `/users/${enc(communityId)}/moderators`,
       undefined,
       { cache: true, cacheTTL: PROFILE_TTL },
     );