@usepanacea/sdk 0.1.0

package/dist/index.cjs

@@ -0,0 +1,249 @@
+'use strict';
+
+// src/http.ts
+var PanaceaApiError = class extends Error {
+  code;
+  status;
+  retriable;
+  traceId;
+  constructor(status, body) {
+    super(body.error.message);
+    this.name = "PanaceaApiError";
+    this.code = body.error.code;
+    this.status = status;
+    this.retriable = body.error.retriable;
+    this.traceId = body.error.traceId;
+  }
+};
+var HttpClient = class {
+  baseURL;
+  defaultHeaders;
+  _fetch;
+  constructor(opts) {
+    this.baseURL = opts.baseURL.replace(/\/$/, "");
+    this._fetch = opts.fetch ?? globalThis.fetch.bind(globalThis);
+    this.defaultHeaders = {
+      "Content-Type": "application/json",
+      Accept: "application/json",
+      Authorization: `Bearer ${opts.apiKey}`,
+      ...opts.tenantId ? { "X-Tenant-Id": opts.tenantId } : {},
+      ...opts.headers
+    };
+  }
+  async get(path, params) {
+    const url = new URL(this.baseURL + path);
+    if (params) {
+      for (const [k, v] of Object.entries(params)) {
+        if (v !== void 0) url.searchParams.set(k, String(v));
+      }
+    }
+    const res = await this._fetch(url.toString(), {
+      method: "GET",
+      headers: this.defaultHeaders
+    });
+    return this.parseResponse(res);
+  }
+  async post(path, body) {
+    const res = await this._fetch(this.baseURL + path, {
+      method: "POST",
+      headers: this.defaultHeaders,
+      body: body !== void 0 ? JSON.stringify(body) : void 0
+    });
+    return this.parseResponse(res);
+  }
+  async patch(path, body) {
+    const res = await this._fetch(this.baseURL + path, {
+      method: "PATCH",
+      headers: this.defaultHeaders,
+      body: body !== void 0 ? JSON.stringify(body) : void 0
+    });
+    return this.parseResponse(res);
+  }
+  async delete(path) {
+    const res = await this._fetch(this.baseURL + path, {
+      method: "DELETE",
+      headers: this.defaultHeaders
+    });
+    return this.parseResponse(res);
+  }
+  async parseResponse(res) {
+    const text = await res.text();
+    let json;
+    try {
+      json = JSON.parse(text);
+    } catch {
+      if (!res.ok) throw new Error(`HTTP ${res.status}: ${text}`);
+      return void 0;
+    }
+    if (!res.ok) {
+      throw new PanaceaApiError(res.status, json);
+    }
+    return json;
+  }
+};
+
+// src/wiki.ts
+var WikiClient = class {
+  constructor(http) {
+    this.http = http;
+  }
+  http;
+  /**
+   * List wiki entries (paginated).
+   */
+  list(opts) {
+    return this.http.get("/api/v1/wiki", {
+      page: opts?.page,
+      limit: opts?.limit,
+      status: opts?.status
+    });
+  }
+  /**
+   * Get a single wiki entry by path slug.
+   */
+  get(path) {
+    return this.http.get(`/api/v1/wiki/${encodeURIComponent(path)}`);
+  }
+  /**
+   * Create a new wiki entry.
+   */
+  create(opts) {
+    return this.http.post("/api/v1/wiki", opts);
+  }
+  /**
+   * Update an existing wiki entry.
+   */
+  update(path, opts) {
+    return this.http.patch(`/api/v1/wiki/${encodeURIComponent(path)}`, opts);
+  }
+  /**
+   * Delete a wiki entry.
+   */
+  delete(path) {
+    return this.http.delete(`/api/v1/wiki/${encodeURIComponent(path)}`);
+  }
+};
+
+// src/review.ts
+var ReviewClient = class {
+  constructor(http) {
+    this.http = http;
+  }
+  http;
+  /**
+   * List review queue items (paginated).
+   */
+  list(opts) {
+    return this.http.get("/api/v1/review", {
+      page: opts?.page,
+      limit: opts?.limit,
+      status: opts?.status
+    });
+  }
+  /**
+   * Get a single review item by ID.
+   */
+  get(id) {
+    return this.http.get(`/api/v1/review/${id}`);
+  }
+  /**
+   * Approve, reject, or modify a review item.
+   */
+  act(id, opts) {
+    return this.http.post(`/api/v1/review/${id}`, opts);
+  }
+};
+
+// src/webhooks-client.ts
+var WebhooksClient = class {
+  constructor(http) {
+    this.http = http;
+  }
+  http;
+  /**
+   * List registered webhooks.
+   */
+  list() {
+    return this.http.get("/api/v1/webhooks");
+  }
+  /**
+   * Register a new webhook endpoint.
+   */
+  create(opts) {
+    return this.http.post("/api/v1/webhooks", opts);
+  }
+  /**
+   * Delete a webhook registration.
+   */
+  delete(id) {
+    return this.http.delete(`/api/v1/webhooks/${id}`);
+  }
+  /**
+   * Replay the last event delivery for a webhook.
+   */
+  replay(id) {
+    return this.http.post(`/api/v1/webhooks/${id}/replay`);
+  }
+};
+
+// src/client.ts
+var PanaceaClient = class {
+  http;
+  /** Wiki knowledge base CRUD */
+  wiki;
+  /** Review queue operations */
+  review;
+  /** Webhook registration management */
+  webhooks;
+  constructor(opts) {
+    if (!opts.apiKey) throw new Error("PanaceaClient: apiKey is required");
+    if (!opts.baseURL) throw new Error("PanaceaClient: baseURL is required");
+    this.http = new HttpClient(opts);
+    this.wiki = new WikiClient(this.http);
+    this.review = new ReviewClient(this.http);
+    this.webhooks = new WebhooksClient(this.http);
+  }
+  query(questionOrOpts, rest) {
+    const body = typeof questionOrOpts === "string" ? { question: questionOrOpts, ...rest } : questionOrOpts;
+    return this.http.post("/api/v1/query", body);
+  }
+  // ---------------------------------------------------------------------------
+  // Ingest
+  // ---------------------------------------------------------------------------
+  /**
+   * Submit a URL or raw text content for ingestion.
+   *
+   * @example URL
+   * ```typescript
+   * await client.ingest({ type: "url", url: "https://docs.example.com" })
+   * ```
+   *
+   * @example Raw text
+   * ```typescript
+   * await client.ingest({ type: "text", content: "# FAQ\n...", filename: "faq.md" })
+   * ```
+   */
+  ingest(opts) {
+    const body = opts.type === "url" ? { url: opts.url, slug: opts.slug, category: opts.category } : {
+      content: opts.content,
+      filename: opts.filename,
+      slug: opts.slug,
+      category: opts.category
+    };
+    return this.http.post("/api/v1/ingest", body);
+  }
+  // ---------------------------------------------------------------------------
+  // Health
+  // ---------------------------------------------------------------------------
+  /**
+   * Get the current system health report.
+   */
+  health() {
+    return this.http.get("/api/v1/health");
+  }
+};
+
+exports.PanaceaApiError = PanaceaApiError;
+exports.PanaceaClient = PanaceaClient;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/http.ts","../src/wiki.ts","../src/review.ts","../src/webhooks-client.ts","../src/client.ts"],"names":[],"mappings":"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","file":"index.cjs","sourcesContent":["/**\n * @module http\n * Internal fetch wrapper used by PanaceaClient.\n * Works in Node.js (18+), browser, and edge runtimes (native fetch).\n */\n\nimport type { ApiErrorBody } from \"./types.js\";\n\nexport class PanaceaApiError extends Error {\n  readonly code: string;\n  readonly status: number;\n  readonly retriable: boolean;\n  readonly traceId?: string;\n\n  constructor(status: number, body: ApiErrorBody) {\n    super(body.error.message);\n    this.name = \"PanaceaApiError\";\n    this.code = body.error.code;\n    this.status = status;\n    this.retriable = body.error.retriable;\n    this.traceId = body.error.traceId;\n  }\n}\n\nexport interface HttpClientOptions {\n  baseURL: string;\n  apiKey: string;\n  /** Tenant ID header value (X-Tenant-Id). Required if your installation uses it. */\n  tenantId?: string;\n  /** Override the global fetch (e.g. for testing) */\n  fetch?: typeof globalThis.fetch;\n  /** Additional default headers */\n  headers?: Record<string, string>;\n}\n\nexport class HttpClient {\n  private readonly baseURL: string;\n  private readonly defaultHeaders: Record<string, string>;\n  private readonly _fetch: typeof globalThis.fetch;\n\n  constructor(opts: HttpClientOptions) {\n    this.baseURL = opts.baseURL.replace(/\\/$/, \"\");\n    this._fetch = opts.fetch ?? globalThis.fetch.bind(globalThis);\n    this.defaultHeaders = {\n      \"Content-Type\": \"application/json\",\n      Accept: \"application/json\",\n      Authorization: `Bearer ${opts.apiKey}`,\n      ...(opts.tenantId ? { \"X-Tenant-Id\": opts.tenantId } : {}),\n      ...opts.headers,\n    };\n  }\n\n  async get<T>(\n    path: string,\n    params?: Record<string, string | number | boolean | undefined>,\n  ): Promise<T> {\n    const url = new URL(this.baseURL + path);\n    if (params) {\n      for (const [k, v] of Object.entries(params)) {\n        if (v !== undefined) url.searchParams.set(k, String(v));\n      }\n    }\n    const res = await this._fetch(url.toString(), {\n      method: \"GET\",\n      headers: this.defaultHeaders,\n    });\n    return this.parseResponse<T>(res);\n  }\n\n  async post<T>(path: string, body?: unknown): Promise<T> {\n    const res = await this._fetch(this.baseURL + path, {\n      method: \"POST\",\n      headers: this.defaultHeaders,\n      body: body !== undefined ? JSON.stringify(body) : undefined,\n    });\n    return this.parseResponse<T>(res);\n  }\n\n  async patch<T>(path: string, body?: unknown): Promise<T> {\n    const res = await this._fetch(this.baseURL + path, {\n      method: \"PATCH\",\n      headers: this.defaultHeaders,\n      body: body !== undefined ? JSON.stringify(body) : undefined,\n    });\n    return this.parseResponse<T>(res);\n  }\n\n  async delete<T = void>(path: string): Promise<T> {\n    const res = await this._fetch(this.baseURL + path, {\n      method: \"DELETE\",\n      headers: this.defaultHeaders,\n    });\n    return this.parseResponse<T>(res);\n  }\n\n  private async parseResponse<T>(res: Response): Promise<T> {\n    const text = await res.text();\n    let json: unknown;\n    try {\n      json = JSON.parse(text);\n    } catch {\n      if (!res.ok) throw new Error(`HTTP ${res.status}: ${text}`);\n      return undefined as T;\n    }\n\n    if (!res.ok) {\n      throw new PanaceaApiError(res.status, json as ApiErrorBody);\n    }\n\n    return json as T;\n  }\n}\n","/**\n * @module wiki\n * Wiki knowledge base sub-client.\n */\n\nimport { HttpClient } from \"./http.js\";\nimport type {\n  WikiEntry,\n  ListWikiOptions,\n  CreateWikiEntryOptions,\n  UpdateWikiEntryOptions,\n  PaginatedResponse,\n} from \"./types.js\";\n\nexport class WikiClient {\n  constructor(private readonly http: HttpClient) {}\n\n  /**\n   * List wiki entries (paginated).\n   */\n  list(opts?: ListWikiOptions): Promise<PaginatedResponse<WikiEntry>> {\n    return this.http.get<PaginatedResponse<WikiEntry>>(\"/api/v1/wiki\", {\n      page: opts?.page,\n      limit: opts?.limit,\n      status: opts?.status,\n    });\n  }\n\n  /**\n   * Get a single wiki entry by path slug.\n   */\n  get(path: string): Promise<WikiEntry> {\n    return this.http.get<WikiEntry>(`/api/v1/wiki/${encodeURIComponent(path)}`);\n  }\n\n  /**\n   * Create a new wiki entry.\n   */\n  create(opts: CreateWikiEntryOptions): Promise<WikiEntry> {\n    return this.http.post<WikiEntry>(\"/api/v1/wiki\", opts);\n  }\n\n  /**\n   * Update an existing wiki entry.\n   */\n  update(path: string, opts: UpdateWikiEntryOptions): Promise<WikiEntry> {\n    return this.http.patch<WikiEntry>(`/api/v1/wiki/${encodeURIComponent(path)}`, opts);\n  }\n\n  /**\n   * Delete a wiki entry.\n   */\n  delete(path: string): Promise<void> {\n    return this.http.delete<void>(`/api/v1/wiki/${encodeURIComponent(path)}`);\n  }\n}\n","/**\n * @module review\n * Review queue sub-client.\n */\n\nimport { HttpClient } from \"./http.js\";\nimport type {\n  ReviewQueueItem,\n  ListReviewOptions,\n  ActOnReviewOptions,\n  PaginatedResponse,\n} from \"./types.js\";\n\nexport class ReviewClient {\n  constructor(private readonly http: HttpClient) {}\n\n  /**\n   * List review queue items (paginated).\n   */\n  list(opts?: ListReviewOptions): Promise<PaginatedResponse<ReviewQueueItem>> {\n    return this.http.get<PaginatedResponse<ReviewQueueItem>>(\"/api/v1/review\", {\n      page: opts?.page,\n      limit: opts?.limit,\n      status: opts?.status,\n    });\n  }\n\n  /**\n   * Get a single review item by ID.\n   */\n  get(id: string): Promise<ReviewQueueItem> {\n    return this.http.get<ReviewQueueItem>(`/api/v1/review/${id}`);\n  }\n\n  /**\n   * Approve, reject, or modify a review item.\n   */\n  act(id: string, opts: ActOnReviewOptions): Promise<ReviewQueueItem> {\n    return this.http.post<ReviewQueueItem>(`/api/v1/review/${id}`, opts);\n  }\n}\n","/**\n * @module webhooks-client\n * Webhook registration sub-client.\n */\n\nimport { HttpClient } from \"./http.js\";\nimport type { WebhookRegistration, CreateWebhookOptions } from \"./types.js\";\n\nexport class WebhooksClient {\n  constructor(private readonly http: HttpClient) {}\n\n  /**\n   * List registered webhooks.\n   */\n  list(): Promise<WebhookRegistration[]> {\n    return this.http.get<WebhookRegistration[]>(\"/api/v1/webhooks\");\n  }\n\n  /**\n   * Register a new webhook endpoint.\n   */\n  create(opts: CreateWebhookOptions): Promise<WebhookRegistration> {\n    return this.http.post<WebhookRegistration>(\"/api/v1/webhooks\", opts);\n  }\n\n  /**\n   * Delete a webhook registration.\n   */\n  delete(id: string): Promise<void> {\n    return this.http.delete<void>(`/api/v1/webhooks/${id}`);\n  }\n\n  /**\n   * Replay the last event delivery for a webhook.\n   */\n  replay(id: string): Promise<void> {\n    return this.http.post<void>(`/api/v1/webhooks/${id}/replay`);\n  }\n}\n","/**\n * @module client\n * PanaceaClient — top-level entry point for the @usepanacea/sdk.\n *\n * @example Node.js / Edge\n * ```typescript\n * import { PanaceaClient } from \"@usepanacea/sdk\"\n *\n * const client = new PanaceaClient({\n *   apiKey: process.env.PANACEA_API_KEY!,\n *   baseURL: \"https://your-panacea-instance.example.com\",\n * })\n *\n * // Query\n * const result = await client.query(\"How do I reset my password?\")\n * console.log(result.answer)\n *\n * // Ingest\n * await client.ingest({ type: \"url\", url: \"https://docs.example.com/setup\" })\n *\n * // Wiki\n * const entry = await client.wiki.get(\"faq/reset-password\")\n * ```\n */\n\nimport { HttpClient, PanaceaApiError } from \"./http.js\";\nimport { WikiClient } from \"./wiki.js\";\nimport { ReviewClient } from \"./review.js\";\nimport { WebhooksClient } from \"./webhooks-client.js\";\nimport type {\n  QueryOptions,\n  QueryResult,\n  IngestOptions,\n  IngestResult,\n  HealthReport,\n} from \"./types.js\";\n\nexport interface PanaceaClientOptions {\n  /** Base URL of your Panacea instance, e.g. \"https://panacea.example.com\" */\n  baseURL: string;\n  /** Your API key (Bearer token) */\n  apiKey: string;\n  /** Optional tenant ID sent as X-Tenant-Id header */\n  tenantId?: string;\n  /** Additional default request headers */\n  headers?: Record<string, string>;\n  /** Override the global fetch implementation (e.g. for testing) */\n  fetch?: typeof globalThis.fetch;\n}\n\nexport class PanaceaClient {\n  private readonly http: HttpClient;\n\n  /** Wiki knowledge base CRUD */\n  readonly wiki: WikiClient;\n\n  /** Review queue operations */\n  readonly review: ReviewClient;\n\n  /** Webhook registration management */\n  readonly webhooks: WebhooksClient;\n\n  constructor(opts: PanaceaClientOptions) {\n    if (!opts.apiKey) throw new Error(\"PanaceaClient: apiKey is required\");\n    if (!opts.baseURL) throw new Error(\"PanaceaClient: baseURL is required\");\n\n    this.http = new HttpClient(opts);\n    this.wiki = new WikiClient(this.http);\n    this.review = new ReviewClient(this.http);\n    this.webhooks = new WebhooksClient(this.http);\n  }\n\n  // ---------------------------------------------------------------------------\n  // Query\n  // ---------------------------------------------------------------------------\n\n  /**\n   * Submit a question to the Q&A agent.\n   *\n   * @param question - The user's question string\n   * @param opts - Optional session ID and context override\n   */\n  query(question: string, opts?: Omit<QueryOptions, \"question\">): Promise<QueryResult>;\n  query(opts: QueryOptions): Promise<QueryResult>;\n  query(\n    questionOrOpts: string | QueryOptions,\n    rest?: Omit<QueryOptions, \"question\">,\n  ): Promise<QueryResult> {\n    const body: QueryOptions =\n      typeof questionOrOpts === \"string\" ? { question: questionOrOpts, ...rest } : questionOrOpts;\n    return this.http.post<QueryResult>(\"/api/v1/query\", body);\n  }\n\n  // ---------------------------------------------------------------------------\n  // Ingest\n  // ---------------------------------------------------------------------------\n\n  /**\n   * Submit a URL or raw text content for ingestion.\n   *\n   * @example URL\n   * ```typescript\n   * await client.ingest({ type: \"url\", url: \"https://docs.example.com\" })\n   * ```\n   *\n   * @example Raw text\n   * ```typescript\n   * await client.ingest({ type: \"text\", content: \"# FAQ\\n...\", filename: \"faq.md\" })\n   * ```\n   */\n  ingest(opts: IngestOptions): Promise<IngestResult> {\n    const body =\n      opts.type === \"url\"\n        ? { url: opts.url, slug: opts.slug, category: opts.category }\n        : {\n            content: opts.content,\n            filename: opts.filename,\n            slug: opts.slug,\n            category: opts.category,\n          };\n    return this.http.post<IngestResult>(\"/api/v1/ingest\", body);\n  }\n\n  // ---------------------------------------------------------------------------\n  // Health\n  // ---------------------------------------------------------------------------\n\n  /**\n   * Get the current system health report.\n   */\n  health(): Promise<HealthReport> {\n    return this.http.get<HealthReport>(\"/api/v1/health\");\n  }\n}\n\nexport { PanaceaApiError };\n"]}

package/dist/index.d.cts

@@ -0,0 +1,2 @@
+export { PanaceaApiError, PanaceaClient, PanaceaClientOptions } from './browser.cjs';
+export { ActOnReviewOptions, AgentHealth, AgentStatus, ApiErrorBody, ApiKey, ApiKeyPrefix, CreateApiKeyOptions, CreateApiKeyResult, CreateWebhookOptions, CreateWikiEntryOptions, HealthReport, IngestOptions, IngestResult, IngestTextOptions, IngestUrlOptions, ListReviewOptions, ListWikiOptions, PaginatedResponse, PaginationMeta, QueryOptions, QueryResult, QuerySource, ReviewQueueItem, ReviewStatus, SystemStatus, UpdateWikiEntryOptions, WebhookEvent, WebhookRegistration, WikiEntry, WikiEntryStatus } from './types.cjs';

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export { PanaceaApiError, PanaceaClient, PanaceaClientOptions } from './browser.js';
+export { ActOnReviewOptions, AgentHealth, AgentStatus, ApiErrorBody, ApiKey, ApiKeyPrefix, CreateApiKeyOptions, CreateApiKeyResult, CreateWebhookOptions, CreateWikiEntryOptions, HealthReport, IngestOptions, IngestResult, IngestTextOptions, IngestUrlOptions, ListReviewOptions, ListWikiOptions, PaginatedResponse, PaginationMeta, QueryOptions, QueryResult, QuerySource, ReviewQueueItem, ReviewStatus, SystemStatus, UpdateWikiEntryOptions, WebhookEvent, WebhookRegistration, WikiEntry, WikiEntryStatus } from './types.js';

package/dist/index.js

@@ -0,0 +1,246 @@
+// src/http.ts
+var PanaceaApiError = class extends Error {
+  code;
+  status;
+  retriable;
+  traceId;
+  constructor(status, body) {
+    super(body.error.message);
+    this.name = "PanaceaApiError";
+    this.code = body.error.code;
+    this.status = status;
+    this.retriable = body.error.retriable;
+    this.traceId = body.error.traceId;
+  }
+};
+var HttpClient = class {
+  baseURL;
+  defaultHeaders;
+  _fetch;
+  constructor(opts) {
+    this.baseURL = opts.baseURL.replace(/\/$/, "");
+    this._fetch = opts.fetch ?? globalThis.fetch.bind(globalThis);
+    this.defaultHeaders = {
+      "Content-Type": "application/json",
+      Accept: "application/json",
+      Authorization: `Bearer ${opts.apiKey}`,
+      ...opts.tenantId ? { "X-Tenant-Id": opts.tenantId } : {},
+      ...opts.headers
+    };
+  }
+  async get(path, params) {
+    const url = new URL(this.baseURL + path);
+    if (params) {
+      for (const [k, v] of Object.entries(params)) {
+        if (v !== void 0) url.searchParams.set(k, String(v));
+      }
+    }
+    const res = await this._fetch(url.toString(), {
+      method: "GET",
+      headers: this.defaultHeaders
+    });
+    return this.parseResponse(res);
+  }
+  async post(path, body) {
+    const res = await this._fetch(this.baseURL + path, {
+      method: "POST",
+      headers: this.defaultHeaders,
+      body: body !== void 0 ? JSON.stringify(body) : void 0
+    });
+    return this.parseResponse(res);
+  }
+  async patch(path, body) {
+    const res = await this._fetch(this.baseURL + path, {
+      method: "PATCH",
+      headers: this.defaultHeaders,
+      body: body !== void 0 ? JSON.stringify(body) : void 0
+    });
+    return this.parseResponse(res);
+  }
+  async delete(path) {
+    const res = await this._fetch(this.baseURL + path, {
+      method: "DELETE",
+      headers: this.defaultHeaders
+    });
+    return this.parseResponse(res);
+  }
+  async parseResponse(res) {
+    const text = await res.text();
+    let json;
+    try {
+      json = JSON.parse(text);
+    } catch {
+      if (!res.ok) throw new Error(`HTTP ${res.status}: ${text}`);
+      return void 0;
+    }
+    if (!res.ok) {
+      throw new PanaceaApiError(res.status, json);
+    }
+    return json;
+  }
+};
+
+// src/wiki.ts
+var WikiClient = class {
+  constructor(http) {
+    this.http = http;
+  }
+  http;
+  /**
+   * List wiki entries (paginated).
+   */
+  list(opts) {
+    return this.http.get("/api/v1/wiki", {
+      page: opts?.page,
+      limit: opts?.limit,
+      status: opts?.status
+    });
+  }
+  /**
+   * Get a single wiki entry by path slug.
+   */
+  get(path) {
+    return this.http.get(`/api/v1/wiki/${encodeURIComponent(path)}`);
+  }
+  /**
+   * Create a new wiki entry.
+   */
+  create(opts) {
+    return this.http.post("/api/v1/wiki", opts);
+  }
+  /**
+   * Update an existing wiki entry.
+   */
+  update(path, opts) {
+    return this.http.patch(`/api/v1/wiki/${encodeURIComponent(path)}`, opts);
+  }
+  /**
+   * Delete a wiki entry.
+   */
+  delete(path) {
+    return this.http.delete(`/api/v1/wiki/${encodeURIComponent(path)}`);
+  }
+};
+
+// src/review.ts
+var ReviewClient = class {
+  constructor(http) {
+    this.http = http;
+  }
+  http;
+  /**
+   * List review queue items (paginated).
+   */
+  list(opts) {
+    return this.http.get("/api/v1/review", {
+      page: opts?.page,
+      limit: opts?.limit,
+      status: opts?.status
+    });
+  }
+  /**
+   * Get a single review item by ID.
+   */
+  get(id) {
+    return this.http.get(`/api/v1/review/${id}`);
+  }
+  /**
+   * Approve, reject, or modify a review item.
+   */
+  act(id, opts) {
+    return this.http.post(`/api/v1/review/${id}`, opts);
+  }
+};
+
+// src/webhooks-client.ts
+var WebhooksClient = class {
+  constructor(http) {
+    this.http = http;
+  }
+  http;
+  /**
+   * List registered webhooks.
+   */
+  list() {
+    return this.http.get("/api/v1/webhooks");
+  }
+  /**
+   * Register a new webhook endpoint.
+   */
+  create(opts) {
+    return this.http.post("/api/v1/webhooks", opts);
+  }
+  /**
+   * Delete a webhook registration.
+   */
+  delete(id) {
+    return this.http.delete(`/api/v1/webhooks/${id}`);
+  }
+  /**
+   * Replay the last event delivery for a webhook.
+   */
+  replay(id) {
+    return this.http.post(`/api/v1/webhooks/${id}/replay`);
+  }
+};
+
+// src/client.ts
+var PanaceaClient = class {
+  http;
+  /** Wiki knowledge base CRUD */
+  wiki;
+  /** Review queue operations */
+  review;
+  /** Webhook registration management */
+  webhooks;
+  constructor(opts) {
+    if (!opts.apiKey) throw new Error("PanaceaClient: apiKey is required");
+    if (!opts.baseURL) throw new Error("PanaceaClient: baseURL is required");
+    this.http = new HttpClient(opts);
+    this.wiki = new WikiClient(this.http);
+    this.review = new ReviewClient(this.http);
+    this.webhooks = new WebhooksClient(this.http);
+  }
+  query(questionOrOpts, rest) {
+    const body = typeof questionOrOpts === "string" ? { question: questionOrOpts, ...rest } : questionOrOpts;
+    return this.http.post("/api/v1/query", body);
+  }
+  // ---------------------------------------------------------------------------
+  // Ingest
+  // ---------------------------------------------------------------------------
+  /**
+   * Submit a URL or raw text content for ingestion.
+   *
+   * @example URL
+   * ```typescript
+   * await client.ingest({ type: "url", url: "https://docs.example.com" })
+   * ```
+   *
+   * @example Raw text
+   * ```typescript
+   * await client.ingest({ type: "text", content: "# FAQ\n...", filename: "faq.md" })
+   * ```
+   */
+  ingest(opts) {
+    const body = opts.type === "url" ? { url: opts.url, slug: opts.slug, category: opts.category } : {
+      content: opts.content,
+      filename: opts.filename,
+      slug: opts.slug,
+      category: opts.category
+    };
+    return this.http.post("/api/v1/ingest", body);
+  }
+  // ---------------------------------------------------------------------------
+  // Health
+  // ---------------------------------------------------------------------------
+  /**
+   * Get the current system health report.
+   */
+  health() {
+    return this.http.get("/api/v1/health");
+  }
+};
+
+export { PanaceaApiError, PanaceaClient };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/http.ts","../src/wiki.ts","../src/review.ts","../src/webhooks-client.ts","../src/client.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["/**\n * @module http\n * Internal fetch wrapper used by PanaceaClient.\n * Works in Node.js (18+), browser, and edge runtimes (native fetch).\n */\n\nimport type { ApiErrorBody } from \"./types.js\";\n\nexport class PanaceaApiError extends Error {\n  readonly code: string;\n  readonly status: number;\n  readonly retriable: boolean;\n  readonly traceId?: string;\n\n  constructor(status: number, body: ApiErrorBody) {\n    super(body.error.message);\n    this.name = \"PanaceaApiError\";\n    this.code = body.error.code;\n    this.status = status;\n    this.retriable = body.error.retriable;\n    this.traceId = body.error.traceId;\n  }\n}\n\nexport interface HttpClientOptions {\n  baseURL: string;\n  apiKey: string;\n  /** Tenant ID header value (X-Tenant-Id). Required if your installation uses it. */\n  tenantId?: string;\n  /** Override the global fetch (e.g. for testing) */\n  fetch?: typeof globalThis.fetch;\n  /** Additional default headers */\n  headers?: Record<string, string>;\n}\n\nexport class HttpClient {\n  private readonly baseURL: string;\n  private readonly defaultHeaders: Record<string, string>;\n  private readonly _fetch: typeof globalThis.fetch;\n\n  constructor(opts: HttpClientOptions) {\n    this.baseURL = opts.baseURL.replace(/\\/$/, \"\");\n    this._fetch = opts.fetch ?? globalThis.fetch.bind(globalThis);\n    this.defaultHeaders = {\n      \"Content-Type\": \"application/json\",\n      Accept: \"application/json\",\n      Authorization: `Bearer ${opts.apiKey}`,\n      ...(opts.tenantId ? { \"X-Tenant-Id\": opts.tenantId } : {}),\n      ...opts.headers,\n    };\n  }\n\n  async get<T>(\n    path: string,\n    params?: Record<string, string | number | boolean | undefined>,\n  ): Promise<T> {\n    const url = new URL(this.baseURL + path);\n    if (params) {\n      for (const [k, v] of Object.entries(params)) {\n        if (v !== undefined) url.searchParams.set(k, String(v));\n      }\n    }\n    const res = await this._fetch(url.toString(), {\n      method: \"GET\",\n      headers: this.defaultHeaders,\n    });\n    return this.parseResponse<T>(res);\n  }\n\n  async post<T>(path: string, body?: unknown): Promise<T> {\n    const res = await this._fetch(this.baseURL + path, {\n      method: \"POST\",\n      headers: this.defaultHeaders,\n      body: body !== undefined ? JSON.stringify(body) : undefined,\n    });\n    return this.parseResponse<T>(res);\n  }\n\n  async patch<T>(path: string, body?: unknown): Promise<T> {\n    const res = await this._fetch(this.baseURL + path, {\n      method: \"PATCH\",\n      headers: this.defaultHeaders,\n      body: body !== undefined ? JSON.stringify(body) : undefined,\n    });\n    return this.parseResponse<T>(res);\n  }\n\n  async delete<T = void>(path: string): Promise<T> {\n    const res = await this._fetch(this.baseURL + path, {\n      method: \"DELETE\",\n      headers: this.defaultHeaders,\n    });\n    return this.parseResponse<T>(res);\n  }\n\n  private async parseResponse<T>(res: Response): Promise<T> {\n    const text = await res.text();\n    let json: unknown;\n    try {\n      json = JSON.parse(text);\n    } catch {\n      if (!res.ok) throw new Error(`HTTP ${res.status}: ${text}`);\n      return undefined as T;\n    }\n\n    if (!res.ok) {\n      throw new PanaceaApiError(res.status, json as ApiErrorBody);\n    }\n\n    return json as T;\n  }\n}\n","/**\n * @module wiki\n * Wiki knowledge base sub-client.\n */\n\nimport { HttpClient } from \"./http.js\";\nimport type {\n  WikiEntry,\n  ListWikiOptions,\n  CreateWikiEntryOptions,\n  UpdateWikiEntryOptions,\n  PaginatedResponse,\n} from \"./types.js\";\n\nexport class WikiClient {\n  constructor(private readonly http: HttpClient) {}\n\n  /**\n   * List wiki entries (paginated).\n   */\n  list(opts?: ListWikiOptions): Promise<PaginatedResponse<WikiEntry>> {\n    return this.http.get<PaginatedResponse<WikiEntry>>(\"/api/v1/wiki\", {\n      page: opts?.page,\n      limit: opts?.limit,\n      status: opts?.status,\n    });\n  }\n\n  /**\n   * Get a single wiki entry by path slug.\n   */\n  get(path: string): Promise<WikiEntry> {\n    return this.http.get<WikiEntry>(`/api/v1/wiki/${encodeURIComponent(path)}`);\n  }\n\n  /**\n   * Create a new wiki entry.\n   */\n  create(opts: CreateWikiEntryOptions): Promise<WikiEntry> {\n    return this.http.post<WikiEntry>(\"/api/v1/wiki\", opts);\n  }\n\n  /**\n   * Update an existing wiki entry.\n   */\n  update(path: string, opts: UpdateWikiEntryOptions): Promise<WikiEntry> {\n    return this.http.patch<WikiEntry>(`/api/v1/wiki/${encodeURIComponent(path)}`, opts);\n  }\n\n  /**\n   * Delete a wiki entry.\n   */\n  delete(path: string): Promise<void> {\n    return this.http.delete<void>(`/api/v1/wiki/${encodeURIComponent(path)}`);\n  }\n}\n","/**\n * @module review\n * Review queue sub-client.\n */\n\nimport { HttpClient } from \"./http.js\";\nimport type {\n  ReviewQueueItem,\n  ListReviewOptions,\n  ActOnReviewOptions,\n  PaginatedResponse,\n} from \"./types.js\";\n\nexport class ReviewClient {\n  constructor(private readonly http: HttpClient) {}\n\n  /**\n   * List review queue items (paginated).\n   */\n  list(opts?: ListReviewOptions): Promise<PaginatedResponse<ReviewQueueItem>> {\n    return this.http.get<PaginatedResponse<ReviewQueueItem>>(\"/api/v1/review\", {\n      page: opts?.page,\n      limit: opts?.limit,\n      status: opts?.status,\n    });\n  }\n\n  /**\n   * Get a single review item by ID.\n   */\n  get(id: string): Promise<ReviewQueueItem> {\n    return this.http.get<ReviewQueueItem>(`/api/v1/review/${id}`);\n  }\n\n  /**\n   * Approve, reject, or modify a review item.\n   */\n  act(id: string, opts: ActOnReviewOptions): Promise<ReviewQueueItem> {\n    return this.http.post<ReviewQueueItem>(`/api/v1/review/${id}`, opts);\n  }\n}\n","/**\n * @module webhooks-client\n * Webhook registration sub-client.\n */\n\nimport { HttpClient } from \"./http.js\";\nimport type { WebhookRegistration, CreateWebhookOptions } from \"./types.js\";\n\nexport class WebhooksClient {\n  constructor(private readonly http: HttpClient) {}\n\n  /**\n   * List registered webhooks.\n   */\n  list(): Promise<WebhookRegistration[]> {\n    return this.http.get<WebhookRegistration[]>(\"/api/v1/webhooks\");\n  }\n\n  /**\n   * Register a new webhook endpoint.\n   */\n  create(opts: CreateWebhookOptions): Promise<WebhookRegistration> {\n    return this.http.post<WebhookRegistration>(\"/api/v1/webhooks\", opts);\n  }\n\n  /**\n   * Delete a webhook registration.\n   */\n  delete(id: string): Promise<void> {\n    return this.http.delete<void>(`/api/v1/webhooks/${id}`);\n  }\n\n  /**\n   * Replay the last event delivery for a webhook.\n   */\n  replay(id: string): Promise<void> {\n    return this.http.post<void>(`/api/v1/webhooks/${id}/replay`);\n  }\n}\n","/**\n * @module client\n * PanaceaClient — top-level entry point for the @usepanacea/sdk.\n *\n * @example Node.js / Edge\n * ```typescript\n * import { PanaceaClient } from \"@usepanacea/sdk\"\n *\n * const client = new PanaceaClient({\n *   apiKey: process.env.PANACEA_API_KEY!,\n *   baseURL: \"https://your-panacea-instance.example.com\",\n * })\n *\n * // Query\n * const result = await client.query(\"How do I reset my password?\")\n * console.log(result.answer)\n *\n * // Ingest\n * await client.ingest({ type: \"url\", url: \"https://docs.example.com/setup\" })\n *\n * // Wiki\n * const entry = await client.wiki.get(\"faq/reset-password\")\n * ```\n */\n\nimport { HttpClient, PanaceaApiError } from \"./http.js\";\nimport { WikiClient } from \"./wiki.js\";\nimport { ReviewClient } from \"./review.js\";\nimport { WebhooksClient } from \"./webhooks-client.js\";\nimport type {\n  QueryOptions,\n  QueryResult,\n  IngestOptions,\n  IngestResult,\n  HealthReport,\n} from \"./types.js\";\n\nexport interface PanaceaClientOptions {\n  /** Base URL of your Panacea instance, e.g. \"https://panacea.example.com\" */\n  baseURL: string;\n  /** Your API key (Bearer token) */\n  apiKey: string;\n  /** Optional tenant ID sent as X-Tenant-Id header */\n  tenantId?: string;\n  /** Additional default request headers */\n  headers?: Record<string, string>;\n  /** Override the global fetch implementation (e.g. for testing) */\n  fetch?: typeof globalThis.fetch;\n}\n\nexport class PanaceaClient {\n  private readonly http: HttpClient;\n\n  /** Wiki knowledge base CRUD */\n  readonly wiki: WikiClient;\n\n  /** Review queue operations */\n  readonly review: ReviewClient;\n\n  /** Webhook registration management */\n  readonly webhooks: WebhooksClient;\n\n  constructor(opts: PanaceaClientOptions) {\n    if (!opts.apiKey) throw new Error(\"PanaceaClient: apiKey is required\");\n    if (!opts.baseURL) throw new Error(\"PanaceaClient: baseURL is required\");\n\n    this.http = new HttpClient(opts);\n    this.wiki = new WikiClient(this.http);\n    this.review = new ReviewClient(this.http);\n    this.webhooks = new WebhooksClient(this.http);\n  }\n\n  // ---------------------------------------------------------------------------\n  // Query\n  // ---------------------------------------------------------------------------\n\n  /**\n   * Submit a question to the Q&A agent.\n   *\n   * @param question - The user's question string\n   * @param opts - Optional session ID and context override\n   */\n  query(question: string, opts?: Omit<QueryOptions, \"question\">): Promise<QueryResult>;\n  query(opts: QueryOptions): Promise<QueryResult>;\n  query(\n    questionOrOpts: string | QueryOptions,\n    rest?: Omit<QueryOptions, \"question\">,\n  ): Promise<QueryResult> {\n    const body: QueryOptions =\n      typeof questionOrOpts === \"string\" ? { question: questionOrOpts, ...rest } : questionOrOpts;\n    return this.http.post<QueryResult>(\"/api/v1/query\", body);\n  }\n\n  // ---------------------------------------------------------------------------\n  // Ingest\n  // ---------------------------------------------------------------------------\n\n  /**\n   * Submit a URL or raw text content for ingestion.\n   *\n   * @example URL\n   * ```typescript\n   * await client.ingest({ type: \"url\", url: \"https://docs.example.com\" })\n   * ```\n   *\n   * @example Raw text\n   * ```typescript\n   * await client.ingest({ type: \"text\", content: \"# FAQ\\n...\", filename: \"faq.md\" })\n   * ```\n   */\n  ingest(opts: IngestOptions): Promise<IngestResult> {\n    const body =\n      opts.type === \"url\"\n        ? { url: opts.url, slug: opts.slug, category: opts.category }\n        : {\n            content: opts.content,\n            filename: opts.filename,\n            slug: opts.slug,\n            category: opts.category,\n          };\n    return this.http.post<IngestResult>(\"/api/v1/ingest\", body);\n  }\n\n  // ---------------------------------------------------------------------------\n  // Health\n  // ---------------------------------------------------------------------------\n\n  /**\n   * Get the current system health report.\n   */\n  health(): Promise<HealthReport> {\n    return this.http.get<HealthReport>(\"/api/v1/health\");\n  }\n}\n\nexport { PanaceaApiError };\n"]}

package/dist/types.cjs

@@ -0,0 +1,4 @@
+'use strict';
+
+//# sourceMappingURL=types.cjs.map
+//# sourceMappingURL=types.cjs.map

package/dist/types.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"types.cjs"}