@sublay/js 7.6.0 → 7.7.1

package/README.md

@@ -42,7 +42,7 @@ One `SublayClient` with 14 module namespaces (call them as `sublay.<module>.<fn>
 | `users` | profiles, username lookup, suggestions, updates, and the per-user follow/connection graph |
 | `entities` | content CRUD, drafts, feeds (`fetchManyEntities`), reactions, saves |
 | `comments` | threaded comments CRUD, reactions |
-| `spaces` | communities: lifecycle, membership, roles, rules, digests, moderation |
+| `spaces` | communities: lifecycle, membership, roles, rules, moderation |
 | `collections` | saved-entity collections |
 | `follows` / `connections` | the logged-in user's own follow graph and mutual connections |
 | `appNotifications` | in-app notifications and unread counts |

package/dist/index.d.mts

@@ -967,22 +967,6 @@ interface CheckMyMembershipResponse {
 }
 interface DeleteSpaceResponse {
     message: string;
-    deletedSpace: {
-        id: string;
-        name: string;
-    };
-    counts: {
-        entities: number;
-        members: number;
-        childSpaces: number;
-    };
-}
-interface DigestConfig {
-    digestEnabled: boolean;
-    digestWebhookUrl: string | null;
-    digestWebhookSecret: string | null;
-    digestScheduleHour: number | null;
-    digestTimezone: string | null;
 }
 interface SpaceBreadcrumb {
     breadcrumb: SpacePreview[];
@@ -1623,7 +1607,10 @@ declare function fetchCommentByForeignId(client: SublayHttpClient, data: FetchCo
 
 interface UpdateCommentProps {
     commentId: string;
-    content: string;
+    /** New text content. Cannot be empty. Omit to leave the content untouched. */
+    content?: string;
+    /** Replaces the comment's metadata wholesale (not merged). */
+    metadata?: Record<string, any>;
 }
 declare function updateComment(client: SublayHttpClient, data: UpdateCommentProps): Promise<Comment>;
 
@@ -1765,6 +1752,12 @@ interface FetchUserSpacesProps {
     include?: string;
     role?: string;
     all?: "true" | "false";
+    /**
+     * Membership status to list. Defaults to `"active"` (spaces the user is in);
+     * `"pending"` returns join requests awaiting approval, `"banned"` the spaces
+     * they were removed from.
+     */
+    status?: "active" | "pending" | "banned";
 }
 declare function fetchUserSpaces(client: SublayHttpClient, data: FetchUserSpacesProps): Promise<UserSpacesResponse>;
 
@@ -2043,21 +2036,6 @@ interface ModerateSpaceCommentProps {
 }
 declare function moderateSpaceComment(client: SublayHttpClient, data: ModerateSpaceCommentProps): Promise<ModerationResponse>;
 
-interface FetchDigestConfigProps {
-    spaceId: string;
-}
-declare function fetchDigestConfig(client: SublayHttpClient, data: FetchDigestConfigProps): Promise<DigestConfig>;
-
-interface UpdateDigestConfigProps {
-    spaceId: string;
-    digestEnabled?: boolean;
-    digestWebhookUrl?: string;
-    digestWebhookSecret?: string;
-    digestScheduleHour?: number;
-    digestTimezone?: string;
-}
-declare function updateDigestConfig(client: SublayHttpClient, data: UpdateDigestConfigProps): Promise<DigestConfig>;
-
 interface ChatMessage {
     id: string;
     projectId: string;
@@ -2173,7 +2151,6 @@ declare const Spaces_declineMembership: typeof declineMembership;
 declare const Spaces_deleteRule: typeof deleteRule;
 declare const Spaces_deleteSpace: typeof deleteSpace;
 declare const Spaces_fetchChildSpaces: typeof fetchChildSpaces;
-declare const Spaces_fetchDigestConfig: typeof fetchDigestConfig;
 declare const Spaces_fetchManyRules: typeof fetchManyRules;
 declare const Spaces_fetchManySpaces: typeof fetchManySpaces;
 declare const Spaces_fetchMutualSpaces: typeof fetchMutualSpaces;
@@ -2197,12 +2174,11 @@ declare const Spaces_moderateSpaceEntity: typeof moderateSpaceEntity;
 declare const Spaces_reorderRules: typeof reorderRules;
 declare const Spaces_setSpaceEntityNsfw: typeof setSpaceEntityNsfw;
 declare const Spaces_unbanMember: typeof unbanMember;
-declare const Spaces_updateDigestConfig: typeof updateDigestConfig;
 declare const Spaces_updateMemberRole: typeof updateMemberRole;
 declare const Spaces_updateRule: typeof updateRule;
 declare const Spaces_updateSpace: typeof updateSpace;
 declare namespace Spaces {
-  export { Spaces_approveMembership as approveMembership, Spaces_banMember as banMember, Spaces_checkMyMembership as checkMyMembership, Spaces_checkSlugAvailability as checkSlugAvailability, Spaces_createRule as createRule, Spaces_createSpace as createSpace, Spaces_declineMembership as declineMembership, Spaces_deleteRule as deleteRule, Spaces_deleteSpace as deleteSpace, Spaces_fetchChildSpaces as fetchChildSpaces, Spaces_fetchDigestConfig as fetchDigestConfig, Spaces_fetchManyRules as fetchManyRules, Spaces_fetchManySpaces as fetchManySpaces, Spaces_fetchMutualSpaces as fetchMutualSpaces, Spaces_fetchRule as fetchRule, Spaces_fetchSpace as fetchSpace, Spaces_fetchSpaceBreadcrumb as fetchSpaceBreadcrumb, Spaces_fetchSpaceByShortId as fetchSpaceByShortId, Spaces_fetchSpaceBySlug as fetchSpaceBySlug, Spaces_fetchSpaceMembers as fetchSpaceMembers, Spaces_fetchSpaceTeam as fetchSpaceTeam, Spaces_fetchUserSpaces as fetchUserSpaces, Spaces_getSpaceConversation as getSpaceConversation, Spaces_handleCommentReport as handleCommentReport, Spaces_handleEntityReport as handleEntityReport, Spaces_handleSpaceChatReport as handleSpaceChatReport, Spaces_joinSpace as joinSpace, Spaces_leaveSpace as leaveSpace, Spaces_moderateSpaceChatMessage as moderateSpaceChatMessage, Spaces_moderateSpaceComment as moderateSpaceComment, Spaces_moderateSpaceEntity as moderateSpaceEntity, Spaces_reorderRules as reorderRules, Spaces_setSpaceEntityNsfw as setSpaceEntityNsfw, Spaces_unbanMember as unbanMember, Spaces_updateDigestConfig as updateDigestConfig, Spaces_updateMemberRole as updateMemberRole, Spaces_updateRule as updateRule, Spaces_updateSpace as updateSpace };
+  export { Spaces_approveMembership as approveMembership, Spaces_banMember as banMember, Spaces_checkMyMembership as checkMyMembership, Spaces_checkSlugAvailability as checkSlugAvailability, Spaces_createRule as createRule, Spaces_createSpace as createSpace, Spaces_declineMembership as declineMembership, Spaces_deleteRule as deleteRule, Spaces_deleteSpace as deleteSpace, Spaces_fetchChildSpaces as fetchChildSpaces, Spaces_fetchManyRules as fetchManyRules, Spaces_fetchManySpaces as fetchManySpaces, Spaces_fetchMutualSpaces as fetchMutualSpaces, Spaces_fetchRule as fetchRule, Spaces_fetchSpace as fetchSpace, Spaces_fetchSpaceBreadcrumb as fetchSpaceBreadcrumb, Spaces_fetchSpaceByShortId as fetchSpaceByShortId, Spaces_fetchSpaceBySlug as fetchSpaceBySlug, Spaces_fetchSpaceMembers as fetchSpaceMembers, Spaces_fetchSpaceTeam as fetchSpaceTeam, Spaces_fetchUserSpaces as fetchUserSpaces, Spaces_getSpaceConversation as getSpaceConversation, Spaces_handleCommentReport as handleCommentReport, Spaces_handleEntityReport as handleEntityReport, Spaces_handleSpaceChatReport as handleSpaceChatReport, Spaces_joinSpace as joinSpace, Spaces_leaveSpace as leaveSpace, Spaces_moderateSpaceChatMessage as moderateSpaceChatMessage, Spaces_moderateSpaceComment as moderateSpaceComment, Spaces_moderateSpaceEntity as moderateSpaceEntity, Spaces_reorderRules as reorderRules, Spaces_setSpaceEntityNsfw as setSpaceEntityNsfw, Spaces_unbanMember as unbanMember, Spaces_updateMemberRole as updateMemberRole, Spaces_updateRule as updateRule, Spaces_updateSpace as updateSpace };
 }
 
 interface Collection {
@@ -2262,7 +2238,7 @@ declare function removeEntityFromCollection(client: SublayHttpClient, data: Remo
 
 interface UpdateCollectionProps {
     collectionId: string;
-    name?: string;
+    name: string;
 }
 declare function updateCollection(client: SublayHttpClient, data: UpdateCollectionProps): Promise<Collection>;
 
@@ -2645,7 +2621,13 @@ declare namespace AppNotifications {
   export { AppNotifications_countUnreadNotifications as countUnreadNotifications, AppNotifications_fetchNotifications as fetchNotifications, AppNotifications_markAllNotificationsAsRead as markAllNotificationsAsRead, AppNotifications_markNotificationAsRead as markNotificationAsRead };
 }
 
-type ReportTargetType = "entity" | "comment";
+type ReportTargetType = "entity" | "comment" | "message";
+/**
+ * The reasons the API accepts on a report. Server-enforced — anything outside
+ * this set is rejected with `report/invalid-body`. Use `other` plus `details`
+ * for anything the taxonomy doesn't cover.
+ */
+type ReportReason = "spam" | "inappropriateContent" | "harassment" | "misinformation" | "hateSpeech" | "violence" | "illegalActivity" | "selfHarm" | "other";
 type ReportStatus = "pending" | "on-hold" | "escalated" | "dismissed" | "actioned";
 interface UserReport {
     id: string;
@@ -2678,7 +2660,7 @@ interface CreateReportResponse {
 interface CreateReportProps {
     targetType: ReportTargetType;
     targetId: string;
-    reason: string;
+    reason: ReportReason;
     details?: string;
 }
 declare function createReport(client: SublayHttpClient, data: CreateReportProps): Promise<CreateReportResponse>;
@@ -3198,8 +3180,8 @@ interface EditMessageProps {
     conversationId: string;
     messageId: string;
     content?: string;
-    /** A GIF URL, or null to clear it. */
-    gif?: string | null;
+    /** A GIF attachment, or null to clear it. */
+    gif?: GifData | null;
     mentions?: Mention[];
     metadata?: Record<string, any> | null;
 }
@@ -3304,18 +3286,6 @@ interface MuteConversationResponse {
  */
 declare function muteConversation(client: SublayHttpClient, data: MuteConversationProps): Promise<MuteConversationResponse>;
 
-interface ReportMessageProps {
-    conversationId: string;
-    messageId: string;
-    reason: string;
-    details?: string;
-}
-interface ReportMessageResponse {
-    message: string;
-    code: string;
-}
-declare function reportMessage(client: SublayHttpClient, data: ReportMessageProps): Promise<ReportMessageResponse>;
-
 declare const Chat_addMember: typeof addMember;
 declare const Chat_changeMemberRole: typeof changeMemberRole;
 declare const Chat_createDirectConversation: typeof createDirectConversation;
@@ -3334,12 +3304,11 @@ declare const Chat_listReactions: typeof listReactions;
 declare const Chat_markAsRead: typeof markAsRead;
 declare const Chat_muteConversation: typeof muteConversation;
 declare const Chat_removeMember: typeof removeMember;
-declare const Chat_reportMessage: typeof reportMessage;
 declare const Chat_sendMessage: typeof sendMessage;
 declare const Chat_toggleReaction: typeof toggleReaction;
 declare const Chat_updateConversation: typeof updateConversation;
 declare namespace Chat {
-  export { Chat_addMember as addMember, Chat_changeMemberRole as changeMemberRole, Chat_createDirectConversation as createDirectConversation, Chat_createGroupConversation as createGroupConversation, Chat_deleteConversation as deleteConversation, Chat_deleteMessage as deleteMessage, Chat_editMessage as editMessage, Chat_getConversation as getConversation, Chat_getMessage as getMessage, Chat_getUnreadCount as getUnreadCount, Chat_leaveConversation as leaveConversation, Chat_listConversations as listConversations, Chat_listMembers as listMembers, Chat_listMessages as listMessages, Chat_listReactions as listReactions, Chat_markAsRead as markAsRead, Chat_muteConversation as muteConversation, Chat_removeMember as removeMember, Chat_reportMessage as reportMessage, Chat_sendMessage as sendMessage, Chat_toggleReaction as toggleReaction, Chat_updateConversation as updateConversation };
+  export { Chat_addMember as addMember, Chat_changeMemberRole as changeMemberRole, Chat_createDirectConversation as createDirectConversation, Chat_createGroupConversation as createGroupConversation, Chat_deleteConversation as deleteConversation, Chat_deleteMessage as deleteMessage, Chat_editMessage as editMessage, Chat_getConversation as getConversation, Chat_getMessage as getMessage, Chat_getUnreadCount as getUnreadCount, Chat_leaveConversation as leaveConversation, Chat_listConversations as listConversations, Chat_listMembers as listMembers, Chat_listMessages as listMessages, Chat_listReactions as listReactions, Chat_markAsRead as markAsRead, Chat_muteConversation as muteConversation, Chat_removeMember as removeMember, Chat_sendMessage as sendMessage, Chat_toggleReaction as toggleReaction, Chat_updateConversation as updateConversation };
 }
 
 /**
@@ -3373,6 +3342,440 @@ declare namespace Push {
   export { Push_getNotificationPreferences as getNotificationPreferences, Push_updateNotificationPreferences as updateNotificationPreferences };
 }
 
+/**
+ * Workspaces bundle interfaces (client subset). Mirrors the server's
+ * `IWorkspace` / `IWorkspaceMember` / `IWorkspaceInvitation` shapes and the
+ * workspace controller responses.
+ *
+ * `capabilities` is a CLOSED, Sublay-enforced vocabulary (cascades via reach);
+ * `permissions` is opaque free-form developer strings Sublay never consumes
+ * (per-node only, does NOT cascade).
+ */
+type WorkspaceCapability = "view" | "invite" | "remove-member" | "edit-member-access" | "edit-member-profile" | "create-sub-workspace" | "edit-workspace";
+type WorkspaceInvitationStatus = "pending" | "accepted" | "declined" | "revoked";
+type WorkspaceAuthorityReason = "owner" | "ancestor-owner" | "member" | "reach-holder";
+type WorkspaceAuthorityReasonDetail = {
+    type: "owner" | "member";
+    viaWorkspaceId?: never;
+} | {
+    type: "ancestor-owner" | "reach-holder";
+    viaWorkspaceId: string;
+};
+interface Workspace {
+    id: string;
+    name: string;
+    metadata: Record<string, any>;
+    ownerId: string;
+    parentWorkspaceId: string | null;
+    depth: number;
+    inheritsFromParent: boolean;
+    createdAt: string;
+    updatedAt: string;
+    memberCount?: number;
+}
+interface WorkspaceMember {
+    id: string;
+    workspaceId: string;
+    userId: string;
+    capabilities: WorkspaceCapability[];
+    permissions: string[];
+    rank: number;
+    title: string | null;
+    metadata: Record<string, any>;
+    joinedAt: string;
+    createdAt: string;
+}
+interface WorkspaceInvitation {
+    id: string;
+    workspaceId: string;
+    invitedBy: string;
+    userId: string | null;
+    email: string | null;
+    capabilities: WorkspaceCapability[];
+    permissions: string[];
+    rank: number;
+    title: string | null;
+    status: WorkspaceInvitationStatus;
+    expiresAt: string;
+    createdAt: string;
+    updatedAt: string;
+}
+interface WorkspaceRosterReason {
+    type: "owner" | "member" | "ancestor-owner" | "reach-holder" | "descendant-member";
+    rank?: number;
+    capabilities?: WorkspaceCapability[];
+    permissions?: string[];
+    title?: string | null;
+    metadata?: Record<string, any>;
+    viaWorkspaceId?: string;
+    workspaceId?: string;
+}
+interface WorkspaceRosterEntry {
+    user: User;
+    reasons: WorkspaceRosterReason[];
+}
+interface WorkspaceRosterResponse {
+    data: WorkspaceRosterEntry[];
+    total: number;
+}
+interface WorkspaceRosterCountsResponse {
+    counts: {
+        owner: number;
+        member: number;
+        ancestorOwner: number;
+        reachHolder: number;
+        descendantMember: number;
+    };
+    total: number;
+    distinctUsers: number;
+}
+/**
+ * The `user` carried by a standing read. Normally the full user record, but the
+ * server falls back to `{ id }` alone when the user row is gone (a deleted user
+ * with a lingering membership row is a reachable case), so every field except
+ * `id` may be absent.
+ */
+type WorkspaceStandingUser = Pick<User, "id"> & Partial<Omit<User, "id">>;
+interface WorkspaceMemberStanding {
+    user: WorkspaceStandingUser;
+    reasons: WorkspaceAuthorityReasonDetail[];
+    capabilities?: WorkspaceCapability[];
+    permissions?: string[];
+    rank?: number | null;
+    title: string | null;
+    metadata: Record<string, any>;
+}
+interface WorkspaceAuthority {
+    reasons: WorkspaceAuthorityReasonDetail[];
+    capabilities: WorkspaceCapability[];
+    permissions: string[];
+    rank: number | null;
+}
+/**
+ * One descendant the subtree sweep did NOT clear, where the target user still
+ * holds a direct membership.
+ *
+ * `id` / `name` are masked TOGETHER: an entry the acting user may see carries
+ * both, and one they may not carries `null` for both — the sweep reports THAT a
+ * membership survived without disclosing the existence or name of a sealed
+ * sub-workspace the actor has no authority over (the same sealing fence the
+ * descendant roster read applies). Modelled as a discriminated union so a
+ * `null` check on `id` narrows `name` too.
+ */
+type SkippedWorkspace = {
+    id: string;
+    name: string;
+    /** Why it was skipped. `out-of-reach`: the actor's authority does not extend there. */
+    reason: "out-of-reach";
+} | {
+    id: null;
+    name: null;
+    /** Why it was skipped. `out-of-reach`: the actor's authority does not extend there. */
+    reason: "out-of-reach";
+};
+interface RemoveWorkspaceMemberFromSubtreeResponse {
+    removedCount: number;
+    removed: {
+        workspaceId: string;
+        userId: string;
+    }[];
+    /**
+     * How many descendant memberships the target RETAINED because the sweep could
+     * not reach them. Always `0` for an owner / ancestor-owner / privileged key.
+     * A non-zero value means the offboarding is PARTIAL — never conclude a user is
+     * fully removed from `removedCount` alone.
+     */
+    skippedCount: number;
+    /** One entry per retained membership; `skippedCount === skipped.length`. */
+    skipped: SkippedWorkspace[];
+}
+
+interface CreateWorkspaceProps {
+    name: string;
+    metadata?: Record<string, any>;
+    parentWorkspaceId?: string | null;
+}
+/**
+ * Create a root or child workspace. The creator (the bearer-token user) becomes
+ * the owner. Root creation requires a verified email.
+ */
+declare function createWorkspace(client: SublayHttpClient, data: CreateWorkspaceProps): Promise<Workspace>;
+
+interface FetchWorkspaceProps {
+    workspaceId: string;
+    include?: string;
+}
+declare function fetchWorkspace(client: SublayHttpClient, data: FetchWorkspaceProps): Promise<Workspace>;
+
+interface FetchManyWorkspacesProps {
+    page?: number;
+    limit?: number;
+    include?: string;
+}
+/**
+ * List the bearer-token user's direct-membership + owned workspaces. The actor
+ * is derived from the token — no `userId` is sent.
+ */
+declare function fetchManyWorkspaces(client: SublayHttpClient, data?: FetchManyWorkspacesProps): Promise<PaginatedResponse<Workspace>>;
+
+interface UpdateWorkspaceProps {
+    workspaceId: string;
+    name?: string;
+    metadata?: Record<string, any>;
+}
+/**
+ * Edit a workspace's name / metadata. Requires the `edit-workspace` capability
+ * (or ownership). The actor is the bearer-token user — no `userId` is sent.
+ */
+declare function updateWorkspace(client: SublayHttpClient, data: UpdateWorkspaceProps): Promise<Workspace>;
+
+interface UpdateWorkspaceInheritFlagProps {
+    workspaceId: string;
+    inheritsFromParent: boolean;
+}
+/**
+ * Flip whether capabilities held on an ancestor "reach" into this workspace.
+ * Owner-only in both directions (own owner or an ancestor owner), and blocked
+ * (403 `workspace/inherit-enforced`) when the project enforces its default.
+ * The actor is the bearer-token user — no `userId` is sent.
+ */
+declare function updateWorkspaceInheritFlag(client: SublayHttpClient, data: UpdateWorkspaceInheritFlagProps): Promise<Workspace>;
+
+interface DeleteWorkspaceProps {
+    workspaceId: string;
+}
+interface DeleteWorkspaceResponse {
+    message: string;
+}
+/**
+ * Owner-only delete (own owner or an ancestor owner). Cascades the whole
+ * subtree transactionally. The actor is the bearer-token user — no `userId`
+ * body is sent.
+ */
+declare function deleteWorkspace(client: SublayHttpClient, data: DeleteWorkspaceProps): Promise<DeleteWorkspaceResponse>;
+
+interface TransferWorkspaceOwnershipProps {
+    workspaceId: string;
+    newOwnerId: string;
+    previousOwnerDisposition?: "demote" | "remove";
+    previousOwnerRank?: number;
+    previousOwnerCapabilities?: WorkspaceCapability[];
+}
+/**
+ * Hand the workspace to a new owner. Owner-only (own owner or an ancestor
+ * owner). The actor is the bearer-token user — no `userId` is sent;
+ * `newOwnerId` addresses the TARGET, not the actor.
+ */
+declare function transferWorkspaceOwnership(client: SublayHttpClient, data: TransferWorkspaceOwnershipProps): Promise<Workspace>;
+
+interface FetchWorkspaceMembersProps {
+    workspaceId: string;
+    include?: string;
+    countOnly?: boolean;
+}
+/**
+ * Unified roster read — one entry per distinct user, each with a `reasons`
+ * array. Always returned in full (never paginated). With `countOnly=true` the
+ * shape is `WorkspaceRosterCountsResponse` instead. Actor from the token.
+ */
+declare function fetchWorkspaceMembers(client: SublayHttpClient, data: FetchWorkspaceMembersProps): Promise<WorkspaceRosterResponse | WorkspaceRosterCountsResponse>;
+
+interface FetchWorkspaceMemberStandingProps {
+    workspaceId: string;
+    targetUserId: string;
+}
+/**
+ * Read one user's resolved standing on a workspace (`reasons`, `capabilities`,
+ * `permissions`, `rank`, `title`, `metadata`).
+ */
+declare function fetchWorkspaceMemberStanding(client: SublayHttpClient, data: FetchWorkspaceMemberStandingProps): Promise<WorkspaceMemberStanding>;
+
+interface UpdateWorkspaceMemberProps {
+    workspaceId: string;
+    targetUserId: string;
+    capabilities?: WorkspaceCapability[];
+    permissions?: string[];
+    rank?: number;
+    title?: string | null;
+    metadata?: Record<string, any>;
+}
+/**
+ * Edit a member's grant / profile. Powerful fields need `edit-member-access`
+ * plus rank + no-escalation rules; cosmetic fields need only
+ * `edit-member-profile`. No `userId` is sent — the actor comes from the token.
+ */
+declare function updateWorkspaceMember(client: SublayHttpClient, data: UpdateWorkspaceMemberProps): Promise<WorkspaceMember>;
+
+interface RemoveWorkspaceMemberProps {
+    workspaceId: string;
+    targetUserId: string;
+}
+/**
+ * Remove a member from this workspace. Requires the `remove-member` capability
+ * and is rank-bounded. The workspace owner cannot be removed (409
+ * `workspace/sole-owner`) — transfer ownership first. No `userId` body is sent;
+ * the actor comes from the token.
+ */
+declare function removeWorkspaceMember(client: SublayHttpClient, data: RemoveWorkspaceMemberProps): Promise<void>;
+
+interface LeaveWorkspaceProps {
+    workspaceId: string;
+}
+/**
+ * The bearer-token user leaves this workspace — removes THEIR OWN direct
+ * membership on THIS node only (owning a child is unaffected). An owner cannot
+ * leave (409 `workspace/sole-owner`); transfer or delete first. No `userId` is
+ * sent — the server derives the leaver from the token.
+ */
+declare function leaveWorkspace(client: SublayHttpClient, data: LeaveWorkspaceProps): Promise<void>;
+
+interface RemoveWorkspaceMemberFromSubtreeProps {
+    workspaceId: string;
+    targetUserId: string;
+}
+/**
+ * Removes the target user's direct memberships on this workspace and every
+ * descendant. Requires `remove-member` (rank-bounded per node). Blocks (409
+ * `workspace/owns-descendants`) with a report if the user OWNS any descendant
+ * workspace — transfer or delete those first. The actor comes from the token.
+ *
+ * A NON-owner's sweep can be PARTIAL: it stops at sealed sub-workspaces. Check
+ * `skippedCount` / `skipped` before treating the user as fully offboarded.
+ */
+declare function removeWorkspaceMemberFromSubtree(client: SublayHttpClient, data: RemoveWorkspaceMemberFromSubtreeProps): Promise<RemoveWorkspaceMemberFromSubtreeResponse>;
+
+interface CreateWorkspaceInviteProps {
+    workspaceId: string;
+    email?: string;
+    userId?: string;
+    username?: string;
+    capabilities?: WorkspaceCapability[];
+    permissions?: string[];
+    rank: number;
+    title?: string | null;
+}
+/**
+ * Create an invitation (requires the `invite` capability on the workspace). The
+ * inviter is the bearer-token user.
+ */
+declare function createWorkspaceInvite(client: SublayHttpClient, data: CreateWorkspaceInviteProps): Promise<WorkspaceInvitation>;
+
+interface FetchWorkspaceInvitesProps {
+    workspaceId: string;
+}
+interface FetchWorkspaceInvitesResponse {
+    data: WorkspaceInvitation[];
+}
+/**
+ * List a workspace's LIVE pending invites (`status='pending' AND expiresAt >
+ * now`). Requires the `invite` capability (or owner). Always returned in full —
+ * this list is deliberately unpaginated.
+ *
+ * This is the OUTBOX read — invites this workspace ISSUED. For the invites
+ * addressed TO the caller, use `fetchMyWorkspaceInvites`.
+ */
+declare function fetchWorkspaceInvites(client: SublayHttpClient, data: FetchWorkspaceInvitesProps): Promise<FetchWorkspaceInvitesResponse>;
+
+interface RevokeWorkspaceInviteProps {
+    workspaceId: string;
+    inviteId: string;
+}
+interface RevokeWorkspaceInviteResponse {
+    success: boolean;
+}
+/**
+ * Revoke a pending invitation. Requires the `invite` capability (or owner).
+ * Note the verb-suffixed POST route — this is not a `DELETE`.
+ */
+declare function revokeWorkspaceInvite(client: SublayHttpClient, data: RevokeWorkspaceInviteProps): Promise<RevokeWorkspaceInviteResponse>;
+
+interface ResendWorkspaceInviteProps {
+    workspaceId: string;
+    inviteId: string;
+}
+/**
+ * Resend / refresh a pending invitation (valid on any `pending` invite, even one
+ * past `expiresAt` — resets a 14-day expiry and resends the email). A terminal
+ * invite (accepted/declined/revoked) → 409. Requires `invite` (or owner).
+ */
+declare function resendWorkspaceInvite(client: SublayHttpClient, data: ResendWorkspaceInviteProps): Promise<WorkspaceInvitation>;
+
+interface AcceptWorkspaceInviteProps {
+    inviteId: string;
+}
+interface AcceptWorkspaceInviteResponse {
+    success: boolean;
+    workspaceId: string;
+}
+/**
+ * Accept an invitation — identity-matched to the bearer-token user + verified
+ * email required. Non-secret id. Idempotent when already a member/owner.
+ */
+declare function acceptWorkspaceInvite(client: SublayHttpClient, data: AcceptWorkspaceInviteProps): Promise<AcceptWorkspaceInviteResponse>;
+
+interface DeclineWorkspaceInviteProps {
+    inviteId: string;
+}
+interface DeclineWorkspaceInviteResponse {
+    success: boolean;
+}
+/**
+ * Decline an invitation — identity-matched to the bearer-token user, and
+ * verified-email-gated (the same gate as accept, so an unverified squatter on
+ * someone else's address cannot burn their invite). An unverified decline
+ * returns `403 workspace/email-not-verified`.
+ */
+declare function declineWorkspaceInvite(client: SublayHttpClient, data: DeclineWorkspaceInviteProps): Promise<DeclineWorkspaceInviteResponse>;
+
+interface FetchMyWorkspaceInvitesResponse {
+    data: WorkspaceInvitation[];
+}
+/**
+ * The bearer-token user's LIVE pending invites (`status='pending' AND expiresAt
+ * > now`), matched by `userId` from the token. Surfacing is NOT
+ * verification-gated (the verified check applies when the user ACTS on an
+ * invite — accept or decline).
+ *
+ * This is the INBOX read — invites addressed TO the caller. For the invites a
+ * workspace has ISSUED, use `fetchWorkspaceInvites`.
+ */
+declare function fetchMyWorkspaceInvites(client: SublayHttpClient): Promise<FetchMyWorkspaceInvitesResponse>;
+
+interface FetchWorkspaceAuthorityProps {
+    workspaceId: string;
+}
+/**
+ * Authority-as-a-service read — the bearer-token user's resolved standing
+ * (`{ reasons, capabilities, permissions, rank }`) on the workspace. A
+ * permission check is a one-line `.includes()` on the result.
+ */
+declare function fetchWorkspaceAuthority(client: SublayHttpClient, data: FetchWorkspaceAuthorityProps): Promise<WorkspaceAuthority>;
+
+declare const Workspaces_acceptWorkspaceInvite: typeof acceptWorkspaceInvite;
+declare const Workspaces_createWorkspace: typeof createWorkspace;
+declare const Workspaces_createWorkspaceInvite: typeof createWorkspaceInvite;
+declare const Workspaces_declineWorkspaceInvite: typeof declineWorkspaceInvite;
+declare const Workspaces_deleteWorkspace: typeof deleteWorkspace;
+declare const Workspaces_fetchManyWorkspaces: typeof fetchManyWorkspaces;
+declare const Workspaces_fetchMyWorkspaceInvites: typeof fetchMyWorkspaceInvites;
+declare const Workspaces_fetchWorkspace: typeof fetchWorkspace;
+declare const Workspaces_fetchWorkspaceAuthority: typeof fetchWorkspaceAuthority;
+declare const Workspaces_fetchWorkspaceInvites: typeof fetchWorkspaceInvites;
+declare const Workspaces_fetchWorkspaceMemberStanding: typeof fetchWorkspaceMemberStanding;
+declare const Workspaces_fetchWorkspaceMembers: typeof fetchWorkspaceMembers;
+declare const Workspaces_leaveWorkspace: typeof leaveWorkspace;
+declare const Workspaces_removeWorkspaceMember: typeof removeWorkspaceMember;
+declare const Workspaces_removeWorkspaceMemberFromSubtree: typeof removeWorkspaceMemberFromSubtree;
+declare const Workspaces_resendWorkspaceInvite: typeof resendWorkspaceInvite;
+declare const Workspaces_revokeWorkspaceInvite: typeof revokeWorkspaceInvite;
+declare const Workspaces_transferWorkspaceOwnership: typeof transferWorkspaceOwnership;
+declare const Workspaces_updateWorkspace: typeof updateWorkspace;
+declare const Workspaces_updateWorkspaceInheritFlag: typeof updateWorkspaceInheritFlag;
+declare const Workspaces_updateWorkspaceMember: typeof updateWorkspaceMember;
+declare namespace Workspaces {
+  export { Workspaces_acceptWorkspaceInvite as acceptWorkspaceInvite, Workspaces_createWorkspace as createWorkspace, Workspaces_createWorkspaceInvite as createWorkspaceInvite, Workspaces_declineWorkspaceInvite as declineWorkspaceInvite, Workspaces_deleteWorkspace as deleteWorkspace, Workspaces_fetchManyWorkspaces as fetchManyWorkspaces, Workspaces_fetchMyWorkspaceInvites as fetchMyWorkspaceInvites, Workspaces_fetchWorkspace as fetchWorkspace, Workspaces_fetchWorkspaceAuthority as fetchWorkspaceAuthority, Workspaces_fetchWorkspaceInvites as fetchWorkspaceInvites, Workspaces_fetchWorkspaceMemberStanding as fetchWorkspaceMemberStanding, Workspaces_fetchWorkspaceMembers as fetchWorkspaceMembers, Workspaces_leaveWorkspace as leaveWorkspace, Workspaces_removeWorkspaceMember as removeWorkspaceMember, Workspaces_removeWorkspaceMemberFromSubtree as removeWorkspaceMemberFromSubtree, Workspaces_resendWorkspaceInvite as resendWorkspaceInvite, Workspaces_revokeWorkspaceInvite as revokeWorkspaceInvite, Workspaces_transferWorkspaceOwnership as transferWorkspaceOwnership, Workspaces_updateWorkspace as updateWorkspace, Workspaces_updateWorkspaceInheritFlag as updateWorkspaceInheritFlag, Workspaces_updateWorkspaceMember as updateWorkspaceMember };
+}
+
 /**
  * Custom-table types for the `/db` surface (row ops only — the js-sdk holds no
  * service key, so it carries no table-management/DDL surface).
@@ -3455,6 +3858,7 @@ declare class SublayClient {
     oauth: BoundModule<typeof OAuth>;
     chat: BoundModule<typeof Chat>;
     push: BoundModule<typeof Push>;
+    workspaces: BoundModule<typeof Workspaces>;
     private constructor();
     static init(config: ClientConfig): Promise<SublayClient>;
     /**
@@ -3469,4 +3873,4 @@ declare class SublayClient {
     clearTokens(): void;
 }
 
-export { type AuthTokens, type BulkDeleteProps, type BulkDeleteResult, type ClientConfig, type DbFilter, type DbFilterOperator, type DeleteResult, MUTE_DURATIONS, type MuteConversationProps, type MuteConversationResponse, type MuteDuration, type NotificationPreferences, PUSH_EVENT_TYPES, type PaginatedResponse, type PaginationMetadata, type PushEventType, type SpaceReputationContextParams, type SpaceReputationUserParams, SublayClient, type TableAccessor, type TableQuery, type TableRow, type UpdateNotificationPreferencesProps, type UserSearchParams };
+export { type AuthTokens, type BulkDeleteProps, type BulkDeleteResult, type ClientConfig, type DbFilter, type DbFilterOperator, type DeleteResult, MUTE_DURATIONS, type MuteConversationProps, type MuteConversationResponse, type MuteDuration, type NotificationPreferences, PUSH_EVENT_TYPES, type PaginatedResponse, type PaginationMetadata, type PushEventType, type RemoveWorkspaceMemberFromSubtreeResponse, type SkippedWorkspace, type SpaceReputationContextParams, type SpaceReputationUserParams, SublayClient, type TableAccessor, type TableQuery, type TableRow, type UpdateNotificationPreferencesProps, type UserSearchParams, type Workspace, type WorkspaceAuthority, type WorkspaceAuthorityReason, type WorkspaceAuthorityReasonDetail, type WorkspaceCapability, type WorkspaceInvitation, type WorkspaceInvitationStatus, type WorkspaceMember, type WorkspaceMemberStanding, type WorkspaceRosterCountsResponse, type WorkspaceRosterEntry, type WorkspaceRosterReason, type WorkspaceRosterResponse, type WorkspaceStandingUser };

package/dist/index.d.ts

@@ -15,6 +15,7 @@ import * as Storage from "./modules/storage";
 import * as OAuth from "./modules/oauth";
 import * as Chat from "./modules/chat";
 import * as Push from "./modules/push";
+import * as Workspaces from "./modules/workspaces";
 import { TableAccessor, TableRow } from "./interfaces/Table";
 type BoundModule<T extends Record<string, (client: SublayHttpClient, ...args: any[]) => any>> = {
     [K in keyof T]: (...args: Parameters<T[K]> extends [any, ...infer R] ? R : never) => ReturnType<T[K]>;
@@ -37,6 +38,7 @@ export declare class SublayClient {
     oauth: BoundModule<typeof OAuth>;
     chat: BoundModule<typeof Chat>;
     push: BoundModule<typeof Push>;
+    workspaces: BoundModule<typeof Workspaces>;
     private constructor();
     static init(config: ClientConfig): Promise<SublayClient>;
     /**
@@ -54,6 +56,7 @@ export type { ClientConfig, AuthTokens } from "./core/client";
 export type { PaginatedResponse, PaginationMetadata, } from "./interfaces/IPaginatedResponse";
 export type { SpaceReputationContextParams, SpaceReputationUserParams, } from "./interfaces/SpaceReputation";
 export type { UserSearchParams } from "./interfaces/UserSearch";
+export type { Workspace, WorkspaceMember, WorkspaceInvitation, WorkspaceCapability, WorkspaceInvitationStatus, WorkspaceAuthorityReason, WorkspaceAuthorityReasonDetail, WorkspaceRosterReason, WorkspaceRosterEntry, WorkspaceRosterResponse, WorkspaceRosterCountsResponse, WorkspaceStandingUser, WorkspaceMemberStanding, WorkspaceAuthority, RemoveWorkspaceMemberFromSubtreeResponse, SkippedWorkspace, } from "./interfaces/Workspace";
 export { PUSH_EVENT_TYPES, MUTE_DURATIONS } from "./interfaces/Push";
 export type { PushEventType, MuteDuration, NotificationPreferences, } from "./interfaces/Push";
 export type { UpdateNotificationPreferencesProps } from "./modules/push/updateNotificationPreferences";