@recursiv/sdk 0.7.50 → 0.7.52

package/dist/resources/video.d.ts

@@ -27,6 +27,17 @@ export interface VideoPlaybackToken {
     token: string;
     expires: number;
 }
+/** Whether the caller may publish video in this app, and how much storage is left. */
+export interface VideoEntitlement {
+    allowed: boolean;
+    /** The caller's active app-subscription tier ('free' when none, canceled or past due). */
+    tier: string;
+    /** Why video is not allowed: a tier without video, or a used-up quota. */
+    reason?: 'tier' | 'quota';
+    quotaSeconds: number;
+    usedSeconds: number;
+    remainingSeconds: number;
+}
 /**
  * Video primitive. Upload is gated by the caller's paid tier + storage quota
  * (so apps stay profitable); viewing is open with a signed playback URL.
@@ -34,6 +45,14 @@ export interface VideoPlaybackToken {
 export declare class VideoResource {
     private client;
     constructor(client: HttpClient);
+    /**
+     * The check `createUpload` runs, without starting an upload: lets a composer
+     * gate or explain video before the member picks a file. Needs an app-bound
+     * key with `uploads:write`.
+     */
+    entitlement(): Promise<{
+        data: VideoEntitlement;
+    }>;
     /** Begin an upload. Returns Bunny direct-upload creds + the playbackId to attach to a post. */
     createUpload(input?: {
         title?: string;

package/dist/resources/video.js

@@ -7,6 +7,14 @@ export class VideoResource {
     constructor(client) {
         this.client = client;
     }
+    /**
+     * The check `createUpload` runs, without starting an upload: lets a composer
+     * gate or explain video before the member picks a file. Needs an app-bound
+     * key with `uploads:write`.
+     */
+    entitlement() {
+        return this.client.get('/video/entitlement');
+    }
     /** Begin an upload. Returns Bunny direct-upload creds + the playbackId to attach to a post. */
     createUpload(input) {
         return this.client.post('/video/create-upload', input ?? {});

package/dist/resources/wallet.d.ts

@@ -1,5 +1,5 @@
 import type { HttpClient } from '../client.js';
-import type { SingleResponse } from '../types.js';
+import type { PaginatedResponse, SingleResponse } from '../types.js';
 interface WalletInfo {
     configured: boolean;
     address: string | null;
@@ -37,6 +37,39 @@ export interface PayoutState {
     payouts_enabled: boolean;
     country: string | null;
 }
+/** A wallet the user linked and (optionally) verified. */
+export interface LinkedTokenWallet {
+    chain: string;
+    address: string;
+    verified_at: string | null;
+}
+/** The user's MINDS token balance from the off-chain ledger. */
+export interface TokenBalance {
+    /** Signed wei as a decimal string: it exceeds Number.MAX_SAFE_INTEGER, never parse it as a number. */
+    offchain_wei: string;
+    /** The same balance in MINDS, rounded to 6 decimal places. Display only. */
+    offchain_minds: number;
+    /** How many off-chain ledger entries make up the balance. */
+    entries: number;
+    linked_wallets: LinkedTokenWallet[];
+    base_wallet_address: string | null;
+}
+/** One token ledger movement. */
+export interface TokenLedgerEntry {
+    id: string;
+    category: string | null;
+    /** Signed wei as a decimal string. */
+    amount_wei: string;
+    amount_minds: number;
+    asset: string;
+    settlement: string;
+    tx_hash: string | null;
+    counterparty_user_id: string | null;
+    subject_type: string | null;
+    subject_id: string | null;
+    status: string;
+    occurred_at: string;
+}
 export declare class WalletResource {
     private client;
     constructor(client: HttpClient);
@@ -44,6 +77,13 @@ export declare class WalletResource {
     getMyWallet(): Promise<SingleResponse<WalletInfo>>;
     /** Get wallet balance for the current user */
     getBalance(): Promise<SingleResponse<WalletBalance>>;
+    /** The current user's MINDS token balance (off-chain ledger) and linked wallets. */
+    getTokenBalance(): Promise<SingleResponse<TokenBalance>>;
+    /** The current user's token ledger, newest first (limit up to 200, default 50). */
+    getTokenLedger(params?: {
+        limit?: number;
+        offset?: number;
+    }): Promise<PaginatedResponse<TokenLedgerEntry>>;
     /** USD payout eligibility for the current app user (Stripe Connect). */
     getPayouts(): Promise<SingleResponse<PayoutState>>;
     /** Start or resume payout onboarding. Open the returned URL in a browser. */

package/dist/resources/wallet.js

@@ -11,6 +11,14 @@ export class WalletResource {
     getBalance() {
         return this.client.get('/wallet/balance');
     }
+    /** The current user's MINDS token balance (off-chain ledger) and linked wallets. */
+    getTokenBalance() {
+        return this.client.get('/wallet/token-balance');
+    }
+    /** The current user's token ledger, newest first (limit up to 200, default 50). */
+    getTokenLedger(params) {
+        return this.client.get('/wallet/token-ledger', params);
+    }
     /** USD payout eligibility for the current app user (Stripe Connect). */
     getPayouts() {
         return this.client.get('/wallet/payouts');

package/dist/types.d.ts

@@ -92,7 +92,14 @@ export interface User extends UserSummary {
     posts_count: number;
     created_at: string;
 }
-export interface FollowUser {
+/** The caller's follow relationship with a listed account (both directions). */
+export interface ViewerRelationship {
+    /** The caller follows this account. */
+    is_following: boolean;
+    /** This account follows the caller. */
+    follows_you: boolean;
+}
+export interface FollowUser extends ViewerRelationship {
     id: string;
     name: string;
     username: string;
@@ -155,7 +162,10 @@ export interface RepostedPost {
     created_at: string;
 }
 export interface PostDetail extends Post {
+    /** The newest replies (at most 50). */
     replies: PostReply[];
+    /** Present when the thread has more replies; pass it to `posts.replies(id, { cursor })` for the next, older page. */
+    replies_next_cursor?: string | null;
 }
 export interface PostReply {
     id: string;
@@ -164,8 +174,27 @@ export interface PostReply {
     author: UserSummary;
     tags: Tag[];
     reactions_count: number;
+    score?: number;
+    user_reaction?: string | null;
+    /** This reply's own reply count, so its sub-thread can be opened. */
+    reply_count?: number;
     created_at: string;
 }
+export interface ListPostRepliesParams {
+    /** 1-100, default 50. */
+    limit?: number;
+    /** `replies_next_cursor` from `posts.get`, or `meta.next_cursor` from the previous page. */
+    cursor?: string;
+}
+/** One page of a post's replies, newest first. */
+export interface PostRepliesPage {
+    data: PostReply[];
+    meta: {
+        limit: number;
+        has_more: boolean;
+        next_cursor: string | null;
+    };
+}
 export interface CreatePostInput {
     content: string;
     content_format?: 'plain' | 'markdown';
@@ -197,7 +226,11 @@ export interface UpdatePostInput {
 }
 export type ReactionType = 'like' | 'heart' | 'fire' | 'laugh' | 'sad' | 'angry' | 'upvote' | 'downvote';
 export interface ListPostsParams extends PaginationParams {
-    /** Public-only feed with a bounded Jev presentation hint. Limit <=25. */
+    /**
+     * Public-only feed with a bounded Jev presentation hint. Limit <=25.
+     * The safety floor does not depend on it: a category page and every app-wide
+     * `sort: 'hot'` or `'score'` read are screened with or without a layout.
+     */
     discovery?: boolean;
     /** Public-only broad category. Requires an enabled app experiment; limit <=25. */
     category?: string;
@@ -214,6 +247,10 @@ export interface ListPostsParams extends PaginationParams {
 export interface SearchPostsParams extends PaginationParams {
     q: string;
     tag_ids?: string;
+    /** `relevance` (default) or `new` (newest first). */
+    sort?: 'relevance' | 'new';
+    since?: string;
+    until?: string;
 }
 export type QueryParams = Record<string, unknown>;
 export interface CommunityCreator {
@@ -232,6 +269,10 @@ export interface Community {
     privacy: 'public' | 'private' | 'hidden';
     created_by: CommunityCreator;
     member_count: number;
+    /** Denormalized post count. */
+    post_count?: number;
+    /** Whether the caller is an accepted member. Returned by `list` and `search`. */
+    is_member?: boolean;
     created_at: string;
 }
 /** Filters accepted by the communities directory. */
@@ -240,11 +281,71 @@ export interface ListCommunitiesParams extends PaginationParams {
     member?: boolean;
     /** Restrict personal keys to one organization. Project-bound keys are already scoped. */
     organization_id?: string;
-    /** Server-side directory ordering. */
+    /** Server-side directory ordering. With `q`, name matches come first and this breaks ties. */
     sort?: 'members' | 'active' | 'newest';
+    /**
+     * Case-insensitive text search over name and description, up to 200
+     * characters. With `member: true` it searches only the caller's own groups.
+     */
+    q?: string;
 }
+/** The caller's own membership row in a group, if any. */
+export type CommunityMembershipStatus = 'accepted' | 'pending' | 'invited' | 'banned';
 export interface CommunityDetail extends Community {
     post_count: number;
+    /** The caller's role when they are an accepted member (the creator is always `owner`). */
+    viewer_role?: 'owner' | 'admin' | 'moderator' | 'member' | null;
+    /** The caller's own membership state, whether or not it is accepted. */
+    membership_status?: CommunityMembershipStatus | null;
+    /** People waiting to join. Present only for moderators and up. */
+    pending_request_count?: number;
+    /** Always absent or false on a full detail; see `CommunityCard`. */
+    limited?: false;
+}
+/**
+ * A private group seen from outside: `communities.get` returns this to a
+ * signed-in person who is not an accepted member (including a pending
+ * requester or a banned account), so an app can offer "Request to join" or
+ * show "Requested". The description, creator, roster, post count and posts
+ * stay with members. Hidden groups still answer 404, and so does an app's
+ * private group to a caller outside that app (an app key sees its own app).
+ */
+export interface CommunityCard {
+    id: string;
+    name: string;
+    slug: string;
+    image: string | null;
+    banner: string | null;
+    privacy: 'private';
+    member_count: number;
+    is_member: false;
+    viewer_role: null;
+    membership_status: CommunityMembershipStatus | null;
+    limited: true;
+    description?: undefined;
+    created_by?: undefined;
+    post_count?: undefined;
+    created_at?: undefined;
+}
+/** A row from `communities.related`: a public group, ranked by shared members. */
+export interface RelatedCommunity {
+    id: string;
+    name: string;
+    slug: string;
+    description: string | null;
+    image: string | null;
+    banner: string | null;
+    privacy: 'public';
+    /** Whether the caller is an accepted member of this related group. */
+    is_member: boolean;
+    member_count: number;
+    post_count: number;
+    /** How many members this group shares with the one asked about. */
+    overlap: number;
+}
+/** Paging plus `q`: a case-insensitive name or username search, up to 200 characters. */
+export interface CommunityPeopleParams extends PaginationParams {
+    q?: string;
 }
 export interface CommunityMember {
     id: string;
@@ -269,7 +370,8 @@ export interface CommunityBannedMember {
 }
 export interface CreateCommunityInput {
     name: string;
-    slug: string;
+    /** Optional vanity slug. Omit it for a server-generated collision-resistant default. */
+    slug?: string;
     description?: string;
     privacy?: 'public' | 'private' | 'hidden';
 }
@@ -328,8 +430,25 @@ export interface Conversation {
     last_message: LastMessage | null;
     /** Omitted by API versions deployed before message requests. */
     request_status?: ChatRequestStatus;
+    /** The member who started it; null when it cannot be told (older threads). */
+    created_by?: string | null;
+    /** Whether `chat.deleteConversation()` is allowed for the caller. */
+    can_delete?: boolean;
+    /** Whether `chat.leave()` is allowed for the caller. */
+    can_leave?: boolean;
     created_at: string;
 }
+export interface ConversationRequestResult {
+    id: string;
+    request_status: ChatRequestStatus;
+    /** False when the conversation was already in that state. */
+    changed: boolean;
+}
+export interface LeaveConversationResult {
+    left: true;
+    /** True when the caller was the last person in it, so the room was removed. */
+    conversation_deleted: boolean;
+}
 export interface ConversationDetail {
     /** Missing on older APIs: treat as unknown, never as plaintext permission. */
     encryption?: ConversationEncryptionPolicy;
@@ -340,6 +459,12 @@ export interface ConversationDetail {
     members: ConversationMemberDetail[];
     /** Omitted by API versions deployed before message requests. */
     request_status?: ChatRequestStatus;
+    /** The member who started it; null when it cannot be told (older threads). */
+    created_by?: string | null;
+    /** Whether `chat.deleteConversation()` is allowed for the caller. */
+    can_delete?: boolean;
+    /** Whether `chat.leave()` is allowed for the caller. */
+    can_leave?: boolean;
     created_at: string;
 }
 export interface MessageReaction {
@@ -599,7 +724,8 @@ export interface AgentDetail extends Agent {
 }
 export interface CreateAgentInput {
     name: string;
-    username: string;
+    /** Optional public handle. Omit it for a server-generated collision-resistant default. */
+    username?: string;
     bio?: string;
     model?: string;
     system_prompt?: string;
@@ -656,6 +782,12 @@ export interface AgentChatInput {
     conversation_id?: string;
     new_conversation?: boolean;
 }
+/** Answer an existing message of yours again, without sending it a second time. */
+export interface AgentChatRetryInput {
+    conversation_id: string;
+    /** Your message whose reply failed (or that you want answered again). Must be the latest one. */
+    retry_message_id: string;
+}
 export interface AgentChatResult {
     message_id: string;
     conversation_id: string;
@@ -727,6 +859,24 @@ export interface Profile {
     is_ai: boolean;
     created_at: string;
 }
+/** A row of a followers/following list: the profile plus the caller's relationship with it. */
+export interface FollowListProfile extends Profile, ViewerRelationship {
+}
+/** An account the caller blocked. */
+export interface BlockedProfile extends Profile {
+    blocked_at: string;
+}
+/** An account the caller muted. */
+export interface MutedProfile extends Profile {
+    muted_at: string;
+}
+/** Paging and name/username filter for the caller's blocked and muted lists. */
+export type ModerationListParams = {
+    limit?: number;
+    offset?: number;
+    /** Case-insensitive match on name or username. */
+    search?: string;
+};
 export interface ProfileDetail extends Profile {
     followers_count: number;
     following_count: number;
@@ -736,6 +886,12 @@ export interface ProfileMe extends Profile {
     email_verified: boolean;
     role: string;
     two_factor_enabled: boolean | null;
+    /**
+     * Whether the account can confirm changes with a password. False for
+     * OTP-only accounts: they confirm email and two-factor changes with a code
+     * from `settings.requestConfirmationCode`. Absent on servers older than this field.
+     */
+    has_password?: boolean;
     followers_count: number;
     following_count: number;
     updated_at: string;
@@ -749,6 +905,20 @@ export interface UpdateProfileInput {
 export interface SearchProfilesParams extends PaginationParams {
     q: string;
 }
+export interface SearchMentionsParams {
+    /** What the member typed after `@` (a leading `@` is ignored). */
+    q: string;
+    /** Default 8, max 25. */
+    limit?: number;
+    [key: string]: unknown;
+}
+/** An account a composer's @-picker may offer: a person or an agent. */
+export interface MentionCandidate extends Profile {
+    /** True for an agent (a platform or app agent, not a person's own AI). */
+    is_agent: boolean;
+    /** True when the caller follows this account; followed accounts rank first. */
+    is_following: boolean;
+}
 export interface LeaderboardEntry {
     id: string;
     name: string;
@@ -759,6 +929,8 @@ export interface LeaderboardEntry {
     post_count: number;
     reaction_count: number;
     engagement: number;
+    /** Whether the caller follows this account. */
+    is_following?: boolean;
     created_at: string;
 }
 export interface Organization {
@@ -868,7 +1040,39 @@ export interface ChangePasswordInput {
 }
 export interface RequestEmailChangeInput {
     new_email: string;
-    password: string;
+    /** Required for an account with a password. */
+    password?: string;
+    /**
+     * Required for an account with no password (`has_password: false`): the
+     * code from `settings.requestConfirmationCode('email_change')`, which is
+     * sent to the CURRENT address.
+     */
+    email_code?: string;
+}
+/** What a confirmation code is for. A code for one purpose never confirms another. */
+export type ConfirmationCodePurpose = 'email_change' | 'two_factor';
+export interface ConfirmationCodeSent {
+    success: true;
+    purpose: ConfirmationCodePurpose;
+    /** ISO timestamp. Codes live ten minutes. */
+    expires_at: string;
+}
+export interface RevokeOtherSessionsInput {
+    /**
+     * The Better Auth session token this device holds, if any. Proving it keeps
+     * that session alive; without it every session is revoked. The calling API
+     * key is always kept.
+     */
+    keep_session_token?: string;
+}
+export interface RevokeOtherSessionsResult {
+    success: true;
+    /** Better Auth sessions revoked. */
+    revoked: number;
+    /** Other API keys revoked (within this key's app when the key is app-bound). */
+    api_keys_revoked: number;
+    /** Whether keep_session_token named a session of this account, which was kept. */
+    kept_session: boolean;
 }
 export interface DeletionStatus {
     requested: boolean;
@@ -884,6 +1088,13 @@ export interface LoginHistoryEntry {
 }
 export interface RecursivConfig {
     apiKey?: string;
+    /**
+     * Whether to fall back to `RECURSIV_API_KEY` when `apiKey` is omitted.
+     * Defaults to true for backwards compatibility and branded pre-auth flows.
+     * Set to false for public clients that must remain keyless even in a
+     * credentialed server process.
+     */
+    inheritEnvironmentApiKey?: boolean;
     baseUrl?: string;
     timeout?: number;
     maxRetries?: number;