Web & Node SDK

npm install @beforequery/sdk

import { BeforeQuery } from "@beforequery/sdk";

const bq = new BeforeQuery({
  projectId: "proj_xxx",
  clientKey: "bq_pk_your_public_key",   // safe for client-side code
});

const { answer, citations, threadId } = await bq.chat(
  "How do I set up authentication?",
  {
    onToken: (t) => process(t),          // stream tokens as they arrive
    onCitations: (c) => showSources(c),
  },
);

// Follow-up in the same conversation
await bq.chat("What about SSO?", { threadId });

import { BeforeQuery } from "@beforequery/sdk";

const bq = new BeforeQuery({
  projectId: "proj_xxx",
  clientId: "bq_ci_your_client_id",       // never ship these to browsers
  clientSecret: "bq_cs_your_client_secret",
});

// RAG chat
const { answer } = await bq.chat("Summarise the rate-limiting strategy");

// Hybrid search — raw chunks + scores
const { results } = await bq.search("pgvector cosine", { limit: 5 });

// Feedback
await bq.feedback({ messageId: "msg_xxx", rating: 5, comment: "Spot on!" });

await bq.chat("How do I paginate?", { groupIds: ["grp_v2"] });
await bq.search("pagination", { groupIds: ["grp_v2"] });

new BeforeQuery({ projectId, clientKey });                      // auto: WS with SSE fallback (default)
new BeforeQuery({ projectId, clientKey, transport: "ws" });     // WebSocket only
new BeforeQuery({ projectId, clientKey, transport: "sse" });    // SSE only

const bq = new BeforeQuery({
  projectId: "…",
  clientKey: "bq_pk_…",
  baseUrl: "http://localhost:8280",   // WS URL derived automatically (ws://localhost:8280)
});