@stablebaseline/sdk 0.1.0

package/dist/index.js

@@ -0,0 +1,90 @@
+// src/client.ts
+var DEFAULT_BASE_URL = "https://api.stablebaseline.io/functions/v1/cloud-serve/api/v1";
+function makeAuthHeader(opts) {
+  const token = opts.accessToken ?? opts.apiKey;
+  if (!token) return {};
+  return { Authorization: `Bearer ${token}` };
+}
+var StableBaselineToolError = class extends Error {
+  constructor(status, code, message, details) {
+    super(message);
+    this.status = status;
+    this.code = code;
+    this.details = details;
+    this.name = "StableBaselineToolError";
+  }
+  status;
+  code;
+  details;
+};
+var StableBaseline = class {
+  fetch;
+  baseUrl;
+  authHeader;
+  signal;
+  /**
+   * Strongly-typed dispatch surface. Every entry is one of the 163 MCP tools.
+   *
+   *   const orgs = await sb.tools.listOrganisations({});
+   *   const doc = await sb.tools.createDocument({ folderId, title, cdmd });
+   */
+  tools;
+  constructor(opts = {}) {
+    if (!opts.apiKey && !opts.accessToken) {
+      throw new Error(
+        "StableBaseline: provide either `apiKey` (sta_*) or `accessToken` (OAuth Bearer)."
+      );
+    }
+    this.fetch = opts.fetch ?? globalThis.fetch.bind(globalThis);
+    this.baseUrl = (opts.baseUrl ?? DEFAULT_BASE_URL).replace(/\/$/, "");
+    this.authHeader = makeAuthHeader(opts);
+    this.signal = opts.signal;
+    const self = this;
+    this.tools = new Proxy({}, {
+      get(_target, prop) {
+        if (typeof prop !== "string") return void 0;
+        return (input) => self.callTool(prop, input);
+      }
+    });
+  }
+  /** Call a tool by name. Mainly an escape hatch — prefer `client.tools.<toolName>`. */
+  async callTool(name, input) {
+    const url = `${this.baseUrl}/tools/${encodeURIComponent(name)}`;
+    const res = await this.fetch(url, {
+      method: "POST",
+      headers: { "Content-Type": "application/json", ...this.authHeader },
+      body: JSON.stringify(input ?? {}),
+      signal: this.signal
+    });
+    if (!res.ok) {
+      let body = null;
+      try {
+        body = await res.json();
+      } catch {
+      }
+      const errEnvelope = body?.error ?? {};
+      throw new StableBaselineToolError(
+        res.status,
+        errEnvelope.code ?? `http_${res.status}`,
+        errEnvelope.message ?? `${res.status} ${res.statusText}`,
+        errEnvelope.details
+      );
+    }
+    return res.json();
+  }
+  /** Fetch the live OpenAPI spec from the server. Useful for code generation. */
+  async openapi() {
+    const res = await this.fetch(`${this.baseUrl}/openapi.json`, { signal: this.signal });
+    if (!res.ok) throw new Error(`Failed to fetch OpenAPI: ${res.status}`);
+    return res.json();
+  }
+  /** Lightweight tool-catalogue discovery without parsing the full OpenAPI doc. */
+  async listTools() {
+    const res = await this.fetch(`${this.baseUrl}/tools`, { signal: this.signal });
+    if (!res.ok) throw new Error(`Failed to list tools: ${res.status}`);
+    return res.json();
+  }
+};
+export {
+  StableBaseline
+};