@roundtable-bb/sdk 0.1.0

package/package.json

@@ -0,0 +1,24 @@
+{
+  "name": "@roundtable-bb/sdk",
+  "version": "0.1.0",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    "./package.json": "./package.json",
+    ".": {
+      "@org/source": "./src/index.ts",
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "devDependencies": {
+    "esbuild": "*"
+  },
+  "peerDependencies": {
+    "@roundtable-bb/types": "*",
+    "zod": "^4.0.0"
+  }
+}

package/project.json

@@ -0,0 +1,28 @@
+{
+  "$schema": "../../node_modules/nx/schemas/project-schema.json",
+  "name": "@roundtable-bb/sdk",
+  "projectType": "library",
+  "sourceRoot": "packages/sdk/src",
+  "targets": {
+    "codegen": {
+      "executor": "nx:run-commands",
+      "options": {
+        "commands": [
+          "tsx --conditions @org/source packages/sdk/codegen/extract-spec.ts",
+          "tsx --conditions @org/source packages/sdk/codegen/generate.ts"
+        ],
+        "sequential": true,
+        "cwd": "{workspaceRoot}"
+      },
+      "dependsOn": []
+    },
+    "bundle": {
+      "executor": "nx:run-commands",
+      "options": {
+        "command": "node packages/sdk/codegen/bundle.mjs",
+        "cwd": "{workspaceRoot}"
+      },
+      "dependsOn": ["build"]
+    }
+  }
+}

package/src/generated/client.ts

@@ -0,0 +1,229 @@
+// AUTO-GENERATED — do not edit manually.
+// Run `nx run @roundtable-bb/sdk:codegen` to regenerate.
+
+import type { ApiKey, Category, CreateApiKey, CreateCategory, CreateGroup, CreatePost, CreateTenant, CreateThread, CreatedApiKey, GrantPlatformOwner, Group, Id, Notification, PaginatedResponse, PlatformSetting, Post, SearchResponse, SetGroupCategories, SetGroupPermissions, SetThreadReadStatus, SetUserMembership, Tenant, TenantToken, Thread, ThreadReadStatus, UpdateCategory, UpdateGroup, UpdatePlatformSetting, UpdateThread, UpdateUserProfile, UserMembership, UserProfile } from '@roundtable-bb/types'
+import { request, type RoundtableClientOpts } from '../request.js'
+
+export class RoundtableClient {
+  constructor(private readonly opts: RoundtableClientOpts) {}
+
+  /** Create a platform-scoped API key (returned once in full) */
+  createApiKey(body: CreateApiKey): Promise<CreatedApiKey> {
+    return request(this.opts, 'POST', '/platform/api-keys', { body })
+  }
+
+  /** Create a category (admin) */
+  createCategory(body: CreateCategory): Promise<Category> {
+    return request(this.opts, 'POST', '/categories', { body })
+  }
+
+  /** Create a group (admin) */
+  createGroup(body: CreateGroup): Promise<Group> {
+    return request(this.opts, 'POST', '/groups', { body })
+  }
+
+  /** Create a post in a thread */
+  createPost(params: { threadId: string }, body: CreatePost): Promise<Post> {
+    return request(this.opts, 'POST', `/threads/${params.threadId}/posts`, { body })
+  }
+
+  /** Create a new tenant (requires allow_tenant_creation platform setting or platform owner) */
+  createTenant(body: CreateTenant): Promise<Tenant> {
+    return request(this.opts, 'POST', '/tenants', { body })
+  }
+
+  /** Create a thread (and its first post) */
+  createThread(params: { categoryId: string }, body: CreateThread): Promise<Thread> {
+    return request(this.opts, 'POST', `/categories/${params.categoryId}/threads`, { body })
+  }
+
+  /** Delete a platform-scoped API key */
+  deleteApiKey(params: { id: string }): Promise<void> {
+    return request(this.opts, 'DELETE', `/platform/api-keys/${params.id}`)
+  }
+
+  /** Delete a category (admin) */
+  deleteCategory(params: { id: string }): Promise<void> {
+    return request(this.opts, 'DELETE', `/categories/${params.id}`)
+  }
+
+  /** Delete a group (admin) */
+  deleteGroup(params: { id: string }): Promise<void> {
+    return request(this.opts, 'DELETE', `/groups/${params.id}`)
+  }
+
+  /** Delete a notification */
+  deleteNotification(params: { id: string }): Promise<void> {
+    return request(this.opts, 'DELETE', `/notifications/${params.id}`)
+  }
+
+  /** Soft-delete a post */
+  deletePost(params: { id: string }): Promise<void> {
+    return request(this.opts, 'DELETE', `/posts/${params.id}`)
+  }
+
+  /** Delete a thread */
+  deleteThread(params: { id: string }): Promise<void> {
+    return request(this.opts, 'DELETE', `/threads/${params.id}`)
+  }
+
+  /** Exchange session cookie for a short-lived tenant JWT */
+  exchangeTenantToken(): Promise<TenantToken> {
+    return request(this.opts, 'POST', '/tenant-token')
+  }
+
+  /** Get a single category */
+  getCategory(params: { id: string }): Promise<Category> {
+    return request(this.opts, 'GET', `/categories/${params.id}`)
+  }
+
+  /** Get a group */
+  getGroup(params: { id: string }): Promise<Group> {
+    return request(this.opts, 'GET', `/groups/${params.id}`)
+  }
+
+  /** Get own profile */
+  getMe(): Promise<UserProfile> {
+    return request(this.opts, 'GET', '/users/me')
+  }
+
+  /** Get a single thread */
+  getThread(params: { id: string }): Promise<Thread> {
+    return request(this.opts, 'GET', `/threads/${params.id}`)
+  }
+
+  /** Get read status for the current user in a thread */
+  getThreadReadStatus(params: { id: string }): Promise<ThreadReadStatus> {
+    return request(this.opts, 'GET', `/threads/${params.id}/read-status`)
+  }
+
+  /** Get a user profile by ID */
+  getUser(params: { id: string }): Promise<UserProfile> {
+    return request(this.opts, 'GET', `/users/${params.id}`)
+  }
+
+  /** Get user membership in the current forum */
+  getUserMembership(params: { id: string }): Promise<UserMembership> {
+    return request(this.opts, 'GET', `/users/${params.id}/membership`)
+  }
+
+  /** Grant platform owner status to a user (platform owners only) */
+  grantPlatformOwner(body: GrantPlatformOwner): Promise<void> {
+    return request(this.opts, 'POST', '/platform/owners', { body })
+  }
+
+  /** List your platform-scoped API keys */
+  listApiKeys(): Promise<ApiKey[]> {
+    return request(this.opts, 'GET', '/platform/api-keys')
+  }
+
+  /** List visible categories for the requesting user */
+  listCategories(): Promise<Category[]> {
+    return request(this.opts, 'GET', '/categories')
+  }
+
+  /** List groups */
+  listGroups(): Promise<Group[]> {
+    return request(this.opts, 'GET', '/groups')
+  }
+
+  /** Get unified notification inbox */
+  listNotifications(query?: { cursor?: Id; limit?: number; unreadOnly?: boolean }): Promise<PaginatedResponse<Notification>> {
+    return request(this.opts, 'GET', '/notifications', { query })
+  }
+
+  /** List platform owner user IDs (platform owners only) */
+  listPlatformOwners(): Promise<string[]> {
+    return request(this.opts, 'GET', '/platform/owners')
+  }
+
+  /** List all platform settings (platform owners only) */
+  listPlatformSettings(): Promise<PlatformSetting[]> {
+    return request(this.opts, 'GET', '/platform/settings')
+  }
+
+  /** List posts in a thread — cursor pagination or anchor via ?from=postId */
+  listPosts(params: { threadId: string }, query?: { cursor?: Id; limit?: number; from?: Id }): Promise<PaginatedResponse<Post>> {
+    return request(this.opts, 'GET', `/threads/${params.threadId}/posts`, { query })
+  }
+
+  /** List threads in a category */
+  listThreads(params: { categoryId: string }, query?: { cursor?: Id; limit?: number }): Promise<PaginatedResponse<Thread>> {
+    return request(this.opts, 'GET', `/categories/${params.categoryId}/threads`, { query })
+  }
+
+  /** Mark a notification as read */
+  markNotificationRead(params: { id: string }): Promise<Notification> {
+    return request(this.opts, 'PATCH', `/notifications/${params.id}/read`)
+  }
+
+  /** Revoke platform owner status from a user (platform owners only) */
+  revokePlatformOwner(params: { userId: string }): Promise<void> {
+    return request(this.opts, 'DELETE', `/platform/owners/${params.userId}`)
+  }
+
+  /** Full-text search across threads and posts (visible categories only) */
+  search(query?: { q: string; categoryId?: Id; limit?: number }): Promise<SearchResponse> {
+    return request(this.opts, 'GET', '/search', { query })
+  }
+
+  /** Set category visibility for a group (admin) */
+  setGroupCategories(params: { id: string }, body: SetGroupCategories): Promise<Group> {
+    return request(this.opts, 'PUT', `/groups/${params.id}/categories`, { body })
+  }
+
+  /** Replace all permissions for a group (admin) */
+  setGroupPermissions(params: { id: string }, body: SetGroupPermissions): Promise<Group> {
+    return request(this.opts, 'PUT', `/groups/${params.id}/permissions`, { body })
+  }
+
+  /** Mark a thread as read up to a given post */
+  setThreadReadStatus(params: { id: string }, body: SetThreadReadStatus): Promise<void> {
+    return request(this.opts, 'PUT', `/threads/${params.id}/read-status`, { body })
+  }
+
+  /** Set user group in the current forum (admin) */
+  setUserMembership(params: { id: string }, body: SetUserMembership): Promise<UserMembership> {
+    return request(this.opts, 'PUT', `/users/${params.id}/membership`, { body })
+  }
+
+  /** Subscribe to a thread */
+  subscribeThread(params: { id: string }): Promise<void> {
+    return request(this.opts, 'POST', `/threads/${params.id}/subscribe`)
+  }
+
+  /** Unsubscribe from a thread */
+  unsubscribeThread(params: { id: string }): Promise<void> {
+    return request(this.opts, 'DELETE', `/threads/${params.id}/subscribe`)
+  }
+
+  /** Update a category (admin) */
+  updateCategory(params: { id: string }, body: UpdateCategory): Promise<Category> {
+    return request(this.opts, 'PATCH', `/categories/${params.id}`, { body })
+  }
+
+  /** Update a group (admin) */
+  updateGroup(params: { id: string }, body: UpdateGroup): Promise<Group> {
+    return request(this.opts, 'PATCH', `/groups/${params.id}`, { body })
+  }
+
+  /** Update own profile */
+  updateMe(body: UpdateUserProfile): Promise<UserProfile> {
+    return request(this.opts, 'PATCH', '/users/me', { body })
+  }
+
+  /** Update a platform setting (platform owners only) */
+  updatePlatformSetting(params: { key: string }, body: UpdatePlatformSetting): Promise<PlatformSetting> {
+    return request(this.opts, 'PATCH', `/platform/settings/${params.key}`, { body })
+  }
+
+  /** Edit a post (author or moderator) */
+  updatePost(params: { id: string }, body: CreatePost): Promise<Post> {
+    return request(this.opts, 'PATCH', `/posts/${params.id}`, { body })
+  }
+
+  /** Update a thread (title, pin, lock, move) */
+  updateThread(params: { id: string }, body: UpdateThread): Promise<Thread> {
+    return request(this.opts, 'PATCH', `/threads/${params.id}`, { body })
+  }
+}

package/src/index.ts

@@ -0,0 +1,3 @@
+export { RoundtableClient } from './generated/client.js'
+export type { RoundtableClientOpts } from './request.js'
+export type * from '@roundtable-bb/types'

package/src/request.ts

@@ -0,0 +1,35 @@
+export interface RoundtableClientOpts {
+  baseUrl: string
+  token?: string
+}
+
+export async function request<T>(
+  opts: RoundtableClientOpts,
+  method: string,
+  path: string,
+  options?: { body?: unknown; query?: Record<string, unknown> },
+): Promise<T> {
+  const url = new URL(`${opts.baseUrl}${path}`)
+  if (options?.query) {
+    for (const [k, v] of Object.entries(options.query)) {
+      if (v !== undefined && v !== null) url.searchParams.set(k, String(v))
+    }
+  }
+
+  const res = await fetch(url.toString(), {
+    method,
+    headers: {
+      ...(options?.body !== undefined ? { 'Content-Type': 'application/json' } : {}),
+      ...(opts.token ? { Authorization: `Bearer ${opts.token}` } : {}),
+    },
+    body: options?.body !== undefined ? JSON.stringify(options.body) : undefined,
+  })
+
+  if (res.status === 204) return undefined as T
+  if (!res.ok) {
+    const err = await res.json().catch(() => ({ message: res.statusText }))
+    const msg = (err as { message?: string }).message ?? res.statusText
+    throw Object.assign(new Error(msg), { status: res.status })
+  }
+  return res.json() as Promise<T>
+}

package/tsconfig.json

@@ -0,0 +1,8 @@
+{
+  "extends": "../../tsconfig.base.json",
+  "files": [],
+  "include": [],
+  "references": [
+    { "path": "./tsconfig.lib.json" }
+  ]
+}

package/tsconfig.lib.json

@@ -0,0 +1,13 @@
+{
+  "extends": "../../tsconfig.base.json",
+  "compilerOptions": {
+    "rootDir": "src",
+    "outDir": "dist",
+    "tsBuildInfoFile": "dist/tsconfig.lib.tsbuildinfo",
+    "emitDeclarationOnly": false,
+    "forceConsistentCasingInFileNames": true,
+    "types": ["node"]
+  },
+  "include": ["src/**/*.ts"],
+  "references": []
+}