@faceliftbbt/fds-core

Shared API client and config helpers used by @faceliftbbt/fds-cli and @faceliftbbt/fds-mcp. Provides programmatic access to the quintly social media analytics API.

Install

npm install @faceliftbbt/fds-core

Usage

import { ApiClient, loadConfig, requireCredentials } from "@faceliftbbt/fds-core";

const cfg = requireCredentials(await loadConfig());
const client = new ApiClient({
  auth: { kind: "basic", clientId: cfg.clientId, apiSecret: cfg.apiSecret },
  baseUrl: cfg.baseUrl,
});

const { data } = await client.call<{ data: unknown[] }>("/v0.9/list-data-sources");
console.log(data);

What's included

• ApiClient — fetch-based client for /v0.9/* endpoints. Supports HTTP Basic auth (clientId + apiSecret) and Bearer auth. Auto-switches between GET and POST when body-only fields are present.
• loadConfig / saveConfig / clearConfig — read/write ~/.fds/config.json, with overrides via FDS_CLIENT_ID, FDS_API_SECRET, FDS_BASE_URL env vars.
• requireCredentials — assert credentials are present; throws otherwise.

Most users won't need this directly — install @faceliftbbt/fds-cli for command-line access or @faceliftbbt/fds-mcp for an MCP server.

License

MIT