rotur-sdk 1.0.2 → 1.0.4

package/README.md

@@ -31,8 +31,8 @@ const rotur = new Rotur({ token: "your-token-here" });
 await rotur.login({ system: "my-app", timeout: 60_000 });
 
 // Check current auth state
-rotur.loggedIn;    // boolean
-rotur.token;       // string | null
+rotur.loggedIn; // boolean
+rotur.token; // string | null
 
 // Set/refresh token manually
 rotur.setToken("new-token");
@@ -117,7 +117,11 @@ await rotur.keys.buy("key-id");
 ### Items
 
 ```ts
-const item = await rotur.items.create({ name: "sword", price: 100, selling: true });
+const item = await rotur.items.create({
+  name: "sword",
+  price: 100,
+  selling: true,
+});
 const item = await rotur.items.get("sword");
 const items = await rotur.items.list("username");
 await rotur.items.buy("sword");
@@ -138,9 +142,11 @@ await rotur.gifts.claim("code");
 const { permissions, groups } = await rotur.tokens.permissions();
 const { tokens } = await rotur.tokens.list();
 
-const sub = await rotur.tokens.create("bot-token", [
-  "posts:view", "posts:create", "account:profile"
-], { expiresInHrs: 24, origin: "my-app" });
+const sub = await rotur.tokens.create(
+  "bot-token",
+  ["posts:view", "posts:create", "account:profile"],
+  { expiresInHrs: 24, origin: "my-app" },
+);
 
 await rotur.tokens.revoke(sub.id);
 ```
@@ -178,7 +184,9 @@ const files = await rotur.files.index();
 const { used, max } = await rotur.files.usage();
 const file = await rotur.files.getByUUID("uuid");
 const file = await rotur.files.getByPath("path/to/file");
-await rotur.files.upload({ /* file data */ });
+await rotur.files.upload({
+  /* file data */
+});
 ```
 
 ### Push Notifications
@@ -187,7 +195,10 @@ await rotur.files.upload({ /* file data */ });
 const { public_key } = await rotur.push.vapidKeys();
 await rotur.push.register(endpoint, p256dh, auth, "my-app", "fingerprint");
 const { endpoints } = await rotur.push.endpoints();
-await rotur.push.send("username", "my-app", { title: "Hi!", body: "You have a message" });
+await rotur.push.send("username", "my-app", {
+  title: "Hi!",
+  body: "You have a message",
+});
 ```
 
 ### Status & Validators
@@ -262,8 +273,8 @@ try {
   await rotur.me.transfer("user", 1000);
 } catch (e) {
   if (e instanceof ApiError) {
-    console.log(e.status);  // HTTP status code
-    console.log(e.data);    // response body
+    console.log(e.status); // HTTP status code
+    console.log(e.data); // response body
     console.log(e.message); // human-readable error
   }
 }
@@ -288,14 +299,14 @@ npm test           # vitest
 
 ## Exports
 
-| Export | Description |
-|---|---|
-| `Rotur` | Main client class |
-| `RoturSocket` | WebSocket connection (real-time presence) |
-| `ApiError` | HTTP error with `status` and `data` |
-| `performAuth`, `AuthError` | Browser auth flow |
-| `AuthOptions`, `AuthResult` | Auth option types |
-| All types from `types.ts` | `UserProfile`, `NetPost`, `GroupPublic`, `WSMessage`, etc. |
+| Export                      | Description                                                |
+| --------------------------- | ---------------------------------------------------------- |
+| `Rotur`                     | Main client class                                          |
+| `RoturSocket`               | WebSocket connection (real-time presence)                  |
+| `ApiError`                  | HTTP error with `status` and `data`                        |
+| `performAuth`, `AuthError`  | Browser auth flow                                          |
+| `AuthOptions`, `AuthResult` | Auth option types                                          |
+| All types from `types.ts`   | `UserProfile`, `NetPost`, `GroupPublic`, `WSMessage`, etc. |
 
 ## License
 

package/dist/index.d.mts

@@ -615,6 +615,8 @@ declare class ProfilesNamespace extends Namespace {
         subscription: string;
     }>>;
     getAvatarUrl(username: Username, cache?: string): string;
+    getOverlayUrl(username: Username, cache?: string): string;
+    getBannerUrl(username: Username, cache?: string): string;
 }
 declare class MeNamespace extends Namespace {
     get(): Promise<Record<string, any>>;
@@ -654,6 +656,9 @@ declare class MeNamespace extends Namespace {
     requests(): Promise<{
         requests: Username[];
     }>;
+    outgoing(): Promise<{
+        outgoing: Username[];
+    }>;
     transactions(): Promise<any[]>;
     subscription(): Promise<{
         active: boolean;
@@ -684,14 +689,43 @@ declare class FriendsNamespace extends Namespace {
     list(): Promise<{
         friends: Username[];
     }>;
-    request(username: Username): Promise<any>;
-    accept(username: Username): Promise<any>;
-    reject(username: Username): Promise<any>;
-    remove(username: Username): Promise<any>;
+    request(username: Username): Promise<{
+        ok: boolean;
+        message?: string;
+        error?: string;
+    }>;
+    accept(username: Username): Promise<{
+        ok: boolean;
+        message?: string;
+        error?: string;
+    }>;
+    reject(username: Username): Promise<{
+        ok: boolean;
+        message?: string;
+        error?: string;
+    }>;
+    remove(username: Username): Promise<{
+        ok: boolean;
+        message?: string;
+        error?: string;
+    }>;
+    cancel(username: Username): Promise<{
+        ok: boolean;
+        message?: string;
+        error?: string;
+    }>;
 }
 declare class FollowingNamespace extends Namespace {
-    follow(username: Username): Promise<any>;
-    unfollow(username: Username): Promise<any>;
+    follow(username: Username): Promise<{
+        ok: boolean;
+        message?: string;
+        error?: string;
+    }>;
+    unfollow(username: Username): Promise<{
+        ok: boolean;
+        message?: string;
+        error?: string;
+    }>;
     followers(username: Username): Promise<{
         followers: Username[];
     }>;

package/dist/index.d.ts

@@ -615,6 +615,8 @@ declare class ProfilesNamespace extends Namespace {
         subscription: string;
     }>>;
     getAvatarUrl(username: Username, cache?: string): string;
+    getOverlayUrl(username: Username, cache?: string): string;
+    getBannerUrl(username: Username, cache?: string): string;
 }
 declare class MeNamespace extends Namespace {
     get(): Promise<Record<string, any>>;
@@ -654,6 +656,9 @@ declare class MeNamespace extends Namespace {
     requests(): Promise<{
         requests: Username[];
     }>;
+    outgoing(): Promise<{
+        outgoing: Username[];
+    }>;
     transactions(): Promise<any[]>;
     subscription(): Promise<{
         active: boolean;
@@ -684,14 +689,43 @@ declare class FriendsNamespace extends Namespace {
     list(): Promise<{
         friends: Username[];
     }>;
-    request(username: Username): Promise<any>;
-    accept(username: Username): Promise<any>;
-    reject(username: Username): Promise<any>;
-    remove(username: Username): Promise<any>;
+    request(username: Username): Promise<{
+        ok: boolean;
+        message?: string;
+        error?: string;
+    }>;
+    accept(username: Username): Promise<{
+        ok: boolean;
+        message?: string;
+        error?: string;
+    }>;
+    reject(username: Username): Promise<{
+        ok: boolean;
+        message?: string;
+        error?: string;
+    }>;
+    remove(username: Username): Promise<{
+        ok: boolean;
+        message?: string;
+        error?: string;
+    }>;
+    cancel(username: Username): Promise<{
+        ok: boolean;
+        message?: string;
+        error?: string;
+    }>;
 }
 declare class FollowingNamespace extends Namespace {
-    follow(username: Username): Promise<any>;
-    unfollow(username: Username): Promise<any>;
+    follow(username: Username): Promise<{
+        ok: boolean;
+        message?: string;
+        error?: string;
+    }>;
+    unfollow(username: Username): Promise<{
+        ok: boolean;
+        message?: string;
+        error?: string;
+    }>;
     followers(username: Username): Promise<{
         followers: Username[];
     }>;

package/dist/index.js

@@ -482,6 +482,12 @@ var ProfilesNamespace = class extends Namespace {
   getAvatarUrl(username, cache = "") {
     return `https://avatars.rotur.dev/${username}?v=${cache}`;
   }
+  getOverlayUrl(username, cache = "") {
+    return `https://avatars.rotur.dev/.overlay/${username}?v=${cache}`;
+  }
+  getBannerUrl(username, cache = "") {
+    return `https://avatars.rotur.dev/.banners/${username}?v=${cache}`;
+  }
 };
 var MeNamespace = class extends Namespace {
   async get() {
@@ -551,8 +557,13 @@ var MeNamespace = class extends Namespace {
     return this.$get("/check_auth");
   }
   async requests() {
-    return this.$get("/me", void 0).then((u) => ({
-      requests: u["sys.requests"] ?? []
+    return this.$get("/requests", void 0).then((u) => ({
+      requests: u.requests ?? []
+    }));
+  }
+  async outgoing() {
+    return this.$get("/requests_out", void 0).then((u) => ({
+      outgoing: u.requests_out ?? []
     }));
   }
   async transactions() {
@@ -607,29 +618,43 @@ var PostsNamespace = class extends Namespace {
     return this.$get("/limits", void 0, false);
   }
 };
+function handleMessageOrError(res) {
+  return res.then((r) => {
+    if (r.ok) {
+      return { ok: true };
+    } else if (r.error) {
+      return { ok: false, error: r.error };
+    } else {
+      return { ok: false, message: r.message };
+    }
+  });
+}
 var FriendsNamespace = class extends Namespace {
   async list() {
     return this.$get("/friends");
   }
   async request(username) {
-    return this.$post(`/friends/request/${username}`);
+    return handleMessageOrError(this.$post(`/friends/request/${username}`));
   }
   async accept(username) {
-    return this.$post(`/friends/accept/${username}`);
+    return handleMessageOrError(this.$post(`/friends/accept/${username}`));
   }
   async reject(username) {
-    return this.$post(`/friends/reject/${username}`);
+    return handleMessageOrError(this.$post(`/friends/reject/${username}`));
   }
   async remove(username) {
-    return this.$post(`/friends/remove/${username}`);
+    return handleMessageOrError(this.$post(`/friends/remove/${username}`));
+  }
+  async cancel(username) {
+    return handleMessageOrError(this.$post(`/friends/cancel/${username}`));
   }
 };
 var FollowingNamespace = class extends Namespace {
   async follow(username) {
-    return this.$get("/follow", { username });
+    return handleMessageOrError(this.$get("/follow", { username }));
   }
   async unfollow(username) {
-    return this.$get("/unfollow", { username });
+    return handleMessageOrError(this.$get("/unfollow", { username }));
   }
   async followers(username) {
     return this.$get("/followers", { username }, false);

package/dist/index.mjs

@@ -452,6 +452,12 @@ var ProfilesNamespace = class extends Namespace {
   getAvatarUrl(username, cache = "") {
     return `https://avatars.rotur.dev/${username}?v=${cache}`;
   }
+  getOverlayUrl(username, cache = "") {
+    return `https://avatars.rotur.dev/.overlay/${username}?v=${cache}`;
+  }
+  getBannerUrl(username, cache = "") {
+    return `https://avatars.rotur.dev/.banners/${username}?v=${cache}`;
+  }
 };
 var MeNamespace = class extends Namespace {
   async get() {
@@ -521,8 +527,13 @@ var MeNamespace = class extends Namespace {
     return this.$get("/check_auth");
   }
   async requests() {
-    return this.$get("/me", void 0).then((u) => ({
-      requests: u["sys.requests"] ?? []
+    return this.$get("/requests", void 0).then((u) => ({
+      requests: u.requests ?? []
+    }));
+  }
+  async outgoing() {
+    return this.$get("/requests_out", void 0).then((u) => ({
+      outgoing: u.requests_out ?? []
     }));
   }
   async transactions() {
@@ -577,29 +588,43 @@ var PostsNamespace = class extends Namespace {
     return this.$get("/limits", void 0, false);
   }
 };
+function handleMessageOrError(res) {
+  return res.then((r) => {
+    if (r.ok) {
+      return { ok: true };
+    } else if (r.error) {
+      return { ok: false, error: r.error };
+    } else {
+      return { ok: false, message: r.message };
+    }
+  });
+}
 var FriendsNamespace = class extends Namespace {
   async list() {
     return this.$get("/friends");
   }
   async request(username) {
-    return this.$post(`/friends/request/${username}`);
+    return handleMessageOrError(this.$post(`/friends/request/${username}`));
   }
   async accept(username) {
-    return this.$post(`/friends/accept/${username}`);
+    return handleMessageOrError(this.$post(`/friends/accept/${username}`));
   }
   async reject(username) {
-    return this.$post(`/friends/reject/${username}`);
+    return handleMessageOrError(this.$post(`/friends/reject/${username}`));
   }
   async remove(username) {
-    return this.$post(`/friends/remove/${username}`);
+    return handleMessageOrError(this.$post(`/friends/remove/${username}`));
+  }
+  async cancel(username) {
+    return handleMessageOrError(this.$post(`/friends/cancel/${username}`));
   }
 };
 var FollowingNamespace = class extends Namespace {
   async follow(username) {
-    return this.$get("/follow", { username });
+    return handleMessageOrError(this.$get("/follow", { username }));
   }
   async unfollow(username) {
-    return this.$get("/unfollow", { username });
+    return handleMessageOrError(this.$get("/unfollow", { username }));
   }
   async followers(username) {
     return this.$get("/followers", { username }, false);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rotur-sdk",
-  "version": "1.0.2",
+  "version": "1.0.4",
   "description": "The official SDK for the Rotur platform - auth, profiles, posts, credits, keys, groups, items, gifts, tokens, validators, status, files, cosmetics, push notifications, and more",
   "main": "dist/index.js",
   "module": "dist/index.mjs",