Queries

import { setup, query } from '@start-chat/sdk'

await setup({ apiKey: 'sk_live_your_api_key' })

const channels = await query.channelsByServer({ serverId: 'srv_...' })

const result = await query.serverById({ serverId: 'srv_...' })

{
  "id": "srv_acme",
  "name": "Acme Corp",
  "description": "Our team workspace",
  "icon": "https://...",
  "creatorId": "usr_alice",
  "createdAt": 1709251200000,
  "memberCount": 42,
  "roles": [
    { "id": "role_admin", "name": "Admin", "color": "#EF4444", "canAdmin": true },
    { "id": "role_team", "name": "Team", "color": "#3B82F6", "canEditData": true }
  ]
}

const result = await query.serverMembers({ serverId: 'srv_...' })

[
  {
    "serverId": "srv_acme",
    "userId": "usr_alice",
    "joinedAt": 1709251200000,
    "user": {
      "id": "usr_alice",
      "name": "Alice",
      "username": "alice",
      "image": "https://..."
    }
  },
  {
    "serverId": "srv_acme",
    "userId": "usr_bob",
    "joinedAt": 1709337600000,
    "user": { "id": "usr_bob", "name": "Bob", "username": "bob", "image": "https://..." }
  }
]

const result = await query.userServers({})

[
  {
    "id": "srv_acme",
    "name": "Acme Corp",
    "icon": "https://...",
    "member": { "joinedAt": 1709251200000 }
  },
  {
    "id": "srv_oss",
    "name": "Open Source",
    "icon": "https://...",
    "member": { "joinedAt": 1709337600000 }
  }
]

const result = await query.searchJoinableServers({})

const result = await query.channelsByServer({ serverId: 'srv_...' })

[
  { id: "ch_general", name: "general", private: false, ... },
  { id: "ch_random", name: "random", private: false, ... },
  { id: "ch_eng", name: "engineering", private: true, ... }
]

const result = await query.channelById({ channelId: 'ch_...' })

{
  "id": "ch_general",
  "serverId": "srv_acme",
  "name": "general",
  "description": "General discussion",
  "private": false,
  "readonly": false,
  "deleted": false,
  "createdAt": 1709251200000
}

const result = await query.channelMessages({ serverId: 'srv_...', channelId: 'ch_...' })

[
  {
    "id": "msg_abc123",
    "content": "Hello!",
    "type": "person",
    "createdAt": 1709251200000,
    "order": "0000001",
    "creator": { "id": "usr_alice", "name": "Alice", "username": "alice" },
    "attachments": [],
    "reactionStats": []
  },
  {
    "id": "msg_def456",
    "content": "Hey there!",
    "type": "person",
    "createdAt": 1709251260000,
    "order": "0000002",
    "creator": { "id": "usr_bob", "name": "Bob", "username": "bob" },
    "attachments": [],
    "reactionStats": []
  }
]

const result = await query.messageById({ messageId: 'msg_...' })

{
  "id": "msg_abc123",
  "channelId": "ch_general",
  "content": "Hello everyone!",
  "type": "person",
  "createdAt": 1709251200000,
  "deleted": false,
  "creator": {
    "id": "usr_alice",
    "name": "Alice",
    "username": "alice",
    "image": "https://..."
  },
  "attachments": [],
  "reactionStats": [{ "content": "thumbsup", "count": 3 }]
}

const result = await query.threadWithMessages({
  threadId: 'thr_...',
  serverId: 'srv_...',
})

{
  id: "thr_xyz789",
  channelId: "ch_general",
  serverId: "srv_acme",
  title: "Feature discussion",
  replyCount: 5,
  createdAt: 1709251200000,
  creator: { id: "usr_alice", name: "Alice" },
  messages: [
    { id: "msg_1", content: "What about...", creator: { ... } },
    { id: "msg_2", content: "Good idea!", creator: { ... } }
  ]
}

const result = await query.threadById({ threadId: 'thr_...' })

const result = await query.userById({ userId: 'usr_...' })