vigor-roblox 1.0.1 → 1.0.3

package/dist/index.d.ts

@@ -117,6 +117,11 @@ interface RobloxThumbnailTarget {
     format?: string;
     isCircular?: boolean;
 }
+interface RobloxThumbnailRaw extends RobloxThumbnailTarget {
+    imageUrl: string | null;
+    state: string;
+    version: string;
+}
 interface RobloxThumbnail extends RobloxThumbnailTarget {
     url: string | null;
     state: string;
@@ -178,6 +183,15 @@ interface RobloxServerLocation {
     isp: string;
     timezone: string;
 }
+interface RobloxFriendEntry {
+    id: RobloxUserId;
+    name: RobloxUserName;
+    displayName: RobloxDisplayName;
+    hasVerifiedBadge?: boolean;
+    isOnline?: boolean;
+    isDeleted?: boolean;
+    friendFrom?: string | null;
+}
 interface CreateRobloxApiOptions {
     cache: RobloxApiCache;
     cookies: RobloxCookie[];
@@ -227,13 +241,18 @@ interface RobloxApi {
         placeId: RobloxPlaceId;
         jobIds: RobloxJobId[];
     }) => Promise<RobloxServerLocation[]>;
+    friends: (userId: RobloxUserId) => Promise<RobloxFriendEntry[]>;
+    sendFriendRequest: (targetUserId: RobloxUserId) => Promise<void>;
+    unfriend: (targetUserId: RobloxUserId) => Promise<void>;
     _internal: {
         gamejoinApi: VigorFetchInstance;
         gamesApi: VigorFetchInstance;
         apisRoblox: VigorFetchInstance;
+        friendsApi: VigorFetchInstance;
+        presenceApi: VigorFetchInstance;
     };
 }
 declare function createRobloxApi({ cache, cookies: cookiesList, ipgeolocationKey, }: CreateRobloxApiOptions): RobloxApi;
 
 export { RobloxAuthError, RobloxRateLimitError, RobloxRequestError, createRobloxApi };
-export type { CreateRobloxApiOptions, RobloxApi, RobloxApiCache, RobloxAssetId, RobloxAuthenticatedUser, RobloxCookie, RobloxDisplayName, RobloxJobId, RobloxPlaceId, RobloxPlaceInfo, RobloxPresenceEntry, RobloxServerEntry, RobloxServerEntryWithLocation, RobloxServerLocation, RobloxServersResult, RobloxThumbnail, RobloxThumbnailTarget, RobloxUniverseId, RobloxUser, RobloxUserAgeBracket, RobloxUserBirthdate, RobloxUserCountryCode, RobloxUserDescription, RobloxUserGender, RobloxUserId, RobloxUserName, RobloxUserRoles, RobloxUserSimple, VigorFetchInstance };
+export type { CreateRobloxApiOptions, RobloxApi, RobloxApiCache, RobloxAssetId, RobloxAuthenticatedUser, RobloxCookie, RobloxDisplayName, RobloxFriendEntry, RobloxJobId, RobloxPlaceId, RobloxPlaceInfo, RobloxPresenceEntry, RobloxServerEntry, RobloxServerEntryWithLocation, RobloxServerLocation, RobloxServersResult, RobloxThumbnail, RobloxThumbnailRaw, RobloxThumbnailTarget, RobloxUniverseId, RobloxUser, RobloxUserAgeBracket, RobloxUserBirthdate, RobloxUserCountryCode, RobloxUserDescription, RobloxUserGender, RobloxUserId, RobloxUserName, RobloxUserRoles, RobloxUserSimple, VigorFetchInstance };

package/dist/index.js

@@ -1904,6 +1904,14 @@ function createRobloxApi({ cache, cookies: cookiesList, ipgeolocationKey, }) {
         .retryConfig(c => c
         .settings(s => s.attempt(4))
         .algorithms(a => a.backoff().initial(500).multiplier(2)));
+    // friends.roblox.com — used for friend list lookups, sending friend
+    // requests, and unfriending. Same cookie + WinInet headers as usersApi.
+    const friendsApi = vigor.fetch('https://friends.roblox.com/v1')
+        .interceptors(cookieInterceptor)
+        .interceptors(winInetInterceptor)
+        .retryConfig(c => c
+        .settings(s => s.attempt(5))
+        .algorithms(a => a.backoff().initial(500).multiplier(2)));
     async function withCache(opts) {
         const { type, keys, ttlMs, getKey, fetchMissing, fallback } = opts;
         const cached = await cache.select(type, keys);
@@ -2062,7 +2070,7 @@ function createRobloxApi({ cache, cookies: cookiesList, ipgeolocationKey, }) {
                 api.setResult(ctx.result.flat());
             }))
                 .request();
-            return results.map(t => ({ ...t, url: t.state === 'Completed' ? t.url : null }));
+            return results.map(t => ({ ...t, url: t.state === 'Completed' ? t.imageUrl : null }));
         }
         catch (cause) {
             throw wrapVigorError(cause);
@@ -2092,7 +2100,7 @@ function createRobloxApi({ cache, cookies: cookiesList, ipgeolocationKey, }) {
             return results.map(item => {
                 const original = batchMap.get(item.requestId) ?? {};
                 const { requestId: _rid, ...rest } = item;
-                return { ...original, ...rest, url: rest.state === 'Completed' ? rest.url : null };
+                return { ...original, ...rest, url: rest.state === 'Completed' ? rest.imageUrl : null };
             });
         }
         catch (cause) {
@@ -2398,6 +2406,42 @@ function createRobloxApi({ cache, cookies: cookiesList, ipgeolocationKey, }) {
         ]);
         return jobIds.flatMap(id => { const loc = resultMap.get(id); return loc ? [loc] : []; });
     }
+    // ----------------------------------------------------------------
+    // Friends
+    // ----------------------------------------------------------------
+    async function friends(userId) {
+        try {
+            return await friendsApi
+                .path('users', userId, 'friends')
+                .interceptors(dataInterceptor)
+                .request();
+        }
+        catch (cause) {
+            throw wrapVigorError(cause);
+        }
+    }
+    async function sendFriendRequest(targetUserId) {
+        try {
+            await friendsApi
+                .path('users', targetUserId, 'request-friendship')
+                .body({})
+                .request();
+        }
+        catch (cause) {
+            throw wrapVigorError(cause);
+        }
+    }
+    async function unfriend(targetUserId) {
+        try {
+            await friendsApi
+                .path('users', targetUserId, 'unfriend')
+                .body({})
+                .request();
+        }
+        catch (cause) {
+            throw wrapVigorError(cause);
+        }
+    }
     return {
         authenticated,
         usersSimple,
@@ -2413,7 +2457,10 @@ function createRobloxApi({ cache, cookies: cookiesList, ipgeolocationKey, }) {
         usersWithImg,
         track,
         serversRegion,
-        _internal: { gamejoinApi, gamesApi, apisRoblox },
+        friends,
+        sendFriendRequest,
+        unfriend,
+        _internal: { gamejoinApi, gamesApi, apisRoblox, friendsApi, presenceApi },
     };
 }
 

package/dist/index.mjs

@@ -1902,6 +1902,14 @@ function createRobloxApi({ cache, cookies: cookiesList, ipgeolocationKey, }) {
         .retryConfig(c => c
         .settings(s => s.attempt(4))
         .algorithms(a => a.backoff().initial(500).multiplier(2)));
+    // friends.roblox.com — used for friend list lookups, sending friend
+    // requests, and unfriending. Same cookie + WinInet headers as usersApi.
+    const friendsApi = vigor.fetch('https://friends.roblox.com/v1')
+        .interceptors(cookieInterceptor)
+        .interceptors(winInetInterceptor)
+        .retryConfig(c => c
+        .settings(s => s.attempt(5))
+        .algorithms(a => a.backoff().initial(500).multiplier(2)));
     async function withCache(opts) {
         const { type, keys, ttlMs, getKey, fetchMissing, fallback } = opts;
         const cached = await cache.select(type, keys);
@@ -2060,7 +2068,7 @@ function createRobloxApi({ cache, cookies: cookiesList, ipgeolocationKey, }) {
                 api.setResult(ctx.result.flat());
             }))
                 .request();
-            return results.map(t => ({ ...t, url: t.state === 'Completed' ? t.url : null }));
+            return results.map(t => ({ ...t, url: t.state === 'Completed' ? t.imageUrl : null }));
         }
         catch (cause) {
             throw wrapVigorError(cause);
@@ -2090,7 +2098,7 @@ function createRobloxApi({ cache, cookies: cookiesList, ipgeolocationKey, }) {
             return results.map(item => {
                 const original = batchMap.get(item.requestId) ?? {};
                 const { requestId: _rid, ...rest } = item;
-                return { ...original, ...rest, url: rest.state === 'Completed' ? rest.url : null };
+                return { ...original, ...rest, url: rest.state === 'Completed' ? rest.imageUrl : null };
             });
         }
         catch (cause) {
@@ -2396,6 +2404,42 @@ function createRobloxApi({ cache, cookies: cookiesList, ipgeolocationKey, }) {
         ]);
         return jobIds.flatMap(id => { const loc = resultMap.get(id); return loc ? [loc] : []; });
     }
+    // ----------------------------------------------------------------
+    // Friends
+    // ----------------------------------------------------------------
+    async function friends(userId) {
+        try {
+            return await friendsApi
+                .path('users', userId, 'friends')
+                .interceptors(dataInterceptor)
+                .request();
+        }
+        catch (cause) {
+            throw wrapVigorError(cause);
+        }
+    }
+    async function sendFriendRequest(targetUserId) {
+        try {
+            await friendsApi
+                .path('users', targetUserId, 'request-friendship')
+                .body({})
+                .request();
+        }
+        catch (cause) {
+            throw wrapVigorError(cause);
+        }
+    }
+    async function unfriend(targetUserId) {
+        try {
+            await friendsApi
+                .path('users', targetUserId, 'unfriend')
+                .body({})
+                .request();
+        }
+        catch (cause) {
+            throw wrapVigorError(cause);
+        }
+    }
     return {
         authenticated,
         usersSimple,
@@ -2411,7 +2455,10 @@ function createRobloxApi({ cache, cookies: cookiesList, ipgeolocationKey, }) {
         usersWithImg,
         track,
         serversRegion,
-        _internal: { gamejoinApi, gamesApi, apisRoblox },
+        friends,
+        sendFriendRequest,
+        unfriend,
+        _internal: { gamejoinApi, gamesApi, apisRoblox, friendsApi, presenceApi },
     };
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vigor-roblox",
-  "version": "1.0.1",
+  "version": "1.0.3",
   "description": "",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",