@databolsa/sdk 1.0.0 → 1.0.2

package/README.md

@@ -1,56 +1,98 @@
 # @databolsa/sdk
 
-SDK TypeScript tipado sobre a Serving API aberta do DataBolsa. **Casca fina e
-agnóstica** — sem React, sem dependências de runtime: o `HttpClient` fala com a
-API pelo contrato `api/openapi.yaml` usando o `fetch` nativo, com Bearer
-opcional e degradação graciosa (501/404 → `NotInPreviewError`).
+[![npm version](https://img.shields.io/npm/v/@databolsa/sdk?color=cb3837&logo=npm)](https://www.npmjs.com/package/@databolsa/sdk)
+[![license](https://img.shields.io/npm/l/@databolsa/sdk?color=2ea44f)](https://github.com/databolsahq/databolsa/blob/main/LICENSE)
 
-É a mesma "pegada" do `packages/mcp` e do `packages/cli` (dirigido pelo
-contrato, sem lógica de negócio), só que aqui a superfície é **tipada em tempo
-de compilação**: os tipos vêm do contrato via `openapi-typescript`. Quem
-consome monta a própria camada por cima — o app web envolve em hooks React
-Query (`apps/web/lib/queries.ts`); um script Node usa direto.
+SDK TypeScript tipado para a Serving API pública do DataBolsa.
 
-## Uso
+O DataBolsa oferece infraestrutura aberta e reprodutível de dados para o mercado
+financeiro brasileiro: ações, FIIs, índices, séries macro, renda fixa, BDRs,
+opções, cripto e busca. O SDK é uma casca fina sobre o contrato OpenAPI. Ele não
+calcula indicadores financeiros no cliente.
+
+## Instalação
+
+```bash
+npm install @databolsa/sdk
+```
+
+## Uso Rápido
 
 ```ts
-import { DataBolsa } from "@databolsa/sdk";
-import type { Stock, QuotesResponse } from "@databolsa/sdk";
+import { DataBolsa, NotInPreviewError } from "@databolsa/sdk";
+import type { QuotesResponse, Stock } from "@databolsa/sdk";
+
+const db = new DataBolsa("https://api.databolsa.com", {
+  apiKey: process.env.DATABOLSA_API_KEY,
+});
+
+try {
+  const stock: Stock = await db.getStock("PETR4");
+  const quotes: QuotesResponse = await db.listQuotes("PETR4", {
+    from: "2024-01-01",
+    limit: 30,
+  });
+
+  console.log(stock.company?.name, quotes.data.length);
+} catch (err) {
+  if (err instanceof NotInPreviewError) {
+    console.warn(err.message);
+  } else {
+    throw err;
+  }
+}
+```
+
+`DataBolsa` é um alias de `HttpClient`.
+
+## Configuração
 
-const db = new DataBolsa("http://localhost:8081", { apiKey: process.env.DATABOLSA_API_KEY });
+Use um `baseUrl` absoluto em Node ou no servidor:
 
-const s: Stock = await db.getStock("PETR4");
-const q: QuotesResponse = await db.listQuotes("PETR4", { from: "2024-01-01", limit: 30 });
+```ts
+const db = new DataBolsa("https://api.databolsa.com");
 ```
 
-`DataBolsa` é um alias de `HttpClient`. O `baseUrl` pode ser:
+Use um `baseUrl` relativo apenas em apps browser que fazem proxy de `/v1` para a
+API a partir da mesma origem:
 
-- **absoluto** (`http://…`) → chamada direta (cross-origin, exige CORS);
-- **relativo** (`/`) → mesma origem (browser + proxy do Next) — usado pelo web.
+```ts
+const db = new DataBolsa("/");
+```
 
-Rotas ainda não servidas lançam `NotInPreviewError` (a mesma exceção que a UI
-sabe exibir), em vez de estourar.
+Autenticação é opcional em implantações abertas. Se você usar uma chave de API,
+mantenha a chave no servidor e passe por `apiKey` ou `getToken`.
 
 ## Tipos
 
-- Tipos de domínio e de resposta: `Stock`, `Fii`, `QuotesResponse`,
-  `StockIndicatorsResponse`, `RegimeSnapshot`, … (derivados do contrato).
-- Crus do OpenAPI: `paths`, `components`, `operations` (de `@databolsa/sdk`).
+O pacote exporta tipos de domínio e de resposta gerados do contrato OpenAPI,
+incluindo `Stock`, `Fii`, `QuotesResponse`, `ScreenStocksResponse`,
+`RegimeSnapshot`, `YieldCurveResponse` e outros.
+
+Também exporta os tipos brutos do OpenAPI: `paths`, `components` e `operations`.
 
-Regenerar após mudar o contrato:
+## Erros
+
+`NotInPreviewError` é lançado quando a API retorna 501 para um endpoint ainda não
+servido ou 404 para um recurso ausente. Outros status não-2xx lançam um `Error`
+com o status da API e o detalhe do problema quando disponível.
+
+## Pacotes Relacionados
+
+A CLI e o MCP expõem o mesmo contrato da API em formatos diferentes:
 
 ```bash
-bun run gen:api        # da raiz: gera openapi.yaml + schema do SDK
-# ou só o schema:
-bun run --cwd packages/sdk gen:schema
+npm install -g @databolsa/cli
+npx -y @databolsa/mcp
 ```
 
-## Quem consome
+## Links
+
+- OpenAPI: https://api.databolsa.com/openapi.json
+- Fontes e cobertura: https://github.com/databolsahq/databolsa/blob/main/docs/sources.md
+- Metodologia dos indicadores: https://github.com/databolsahq/databolsa/blob/main/docs/indicators.md
+- Limitações conhecidas: https://github.com/databolsahq/databolsa/blob/main/docs/limitations.md
 
-- **apps/web** — `HttpClient` (ao vivo) ao lado do `FixtureClient` (demo);
-  `getClient()` troca por env. Componentes usam hooks React Query por cima.
-- Scripts Node / integrações externas — direto, tipado.
+## Licença
 
-> O `packages/cli` e o `packages/mcp` **não** usam este SDK: eles são dinâmicos
-> em runtime (leem o spec vivo e geram a superfície na hora), enquanto o SDK é
-> tipado em tempo de compilação. Mesma filosofia, mecânica oposta.
+Apache-2.0. O DataBolsa é infraestrutura de dados, não recomendação de investimento.

package/dist/client.d.ts

@@ -0,0 +1,111 @@
+import type { CorporateEventsResponse, CryptoQuotesResponse, DividendsResponse, DocumentsResponse, ExpectationsResponse, Fii, FiiDistributionsResponse, FiiIndicatorsResponse, FiiReportsResponse, FiiScreenResponse, HealthResponse, IngestHealthResponse, IndexCompositionResponse, IndexMeta, IndexQuotesResponse, IndicatorHistoryResponse, BdrListResponse, BdrProfile, BdrQuotesResponse, InsiderResponse, MacroGearsResponse, OptionExpiriesResponse, OptionsChainResponse, OptionsQuotesResponse, Query, QuotesResponse, RangeParams, RegimeSnapshot, ScreenStocksResponse, SearchResult, SeriesResponse, Stock, StockIndicatorsResponse, TesouroBondsResponse, YieldCurveResponse } from "./types";
+/** Filtros do screener de ações — derivados de `GET /v1/screener/stocks`. */
+export type ScreenStocksParams = Query<"screenStocks">;
+/**
+ * Filtros do listing de FIIs — derivados de `GET /v1/screener/fiis`, com uma
+ * ergonomia: `paper` aceita `boolean` (o contrato pede `"true"`/`"false"`; o
+ * HttpClient serializa). true = papel, false = tijolo, undefined = todos.
+ */
+export type ScreenFiisParams = Omit<Query<"screenFiis">, "paper"> & {
+    paper?: boolean;
+};
+/**
+ * Interface do cliente DataBolsa — métodos = operationIds do api/openapi.yaml.
+ * O SDK público implementa esta interface com HttpClient; apps podem envolver
+ * a interface com cache, hooks ou adaptadores próprios sem duplicar contrato.
+ */
+export interface DataBolsaClient {
+    getHealth(): Promise<HealthResponse>;
+    /** Saúde da ingestão: última run + saúde por fonte + histórico (data lake). */
+    getIngestHealth(): Promise<IngestHealthResponse>;
+    /** Lista/filtra ações por fundamentos (o universo real, não o preview). */
+    screenStocks(params?: ScreenStocksParams): Promise<ScreenStocksResponse>;
+    getStock(ticker: string): Promise<Stock>;
+    listQuotes(ticker: string, params?: RangeParams & {
+        adjusted?: boolean;
+        limit?: number;
+    }): Promise<QuotesResponse>;
+    getStockIndicators(ticker: string, params?: {
+        at?: string;
+    }): Promise<StockIndicatorsResponse>;
+    getStockIndicatorHistory(ticker: string, name: string, params?: RangeParams): Promise<IndicatorHistoryResponse>;
+    listDividends(ticker: string, params?: RangeParams): Promise<DividendsResponse>;
+    listCorporateEvents(ticker: string, params?: RangeParams): Promise<CorporateEventsResponse>;
+    listCompanyDocuments(cvmCode: number, params?: RangeParams & {
+        category?: string;
+    }): Promise<DocumentsResponse>;
+    /** PENDÊNCIA DE CONTRATO — ver lib/api/types.ts (InsiderMove) */
+    listInsiderMoves(ticker: string, params?: RangeParams): Promise<InsiderResponse>;
+    /** Lista o universo real de FIIs (não o preview). */
+    screenFiis(params?: ScreenFiisParams): Promise<FiiScreenResponse>;
+    getFii(ticker: string): Promise<Fii>;
+    getFiiIndicators(ticker: string, params?: {
+        at?: string;
+    }): Promise<FiiIndicatorsResponse>;
+    /** Série mensal de um indicador de FII (mart_fii__reports) — mesmo shape do histórico de ações. */
+    getFiiIndicatorHistory(ticker: string, name: string, params?: RangeParams): Promise<IndicatorHistoryResponse>;
+    listFiiDistributions(ticker: string, params?: RangeParams): Promise<FiiDistributionsResponse>;
+    listFiiReports(ticker: string, params?: RangeParams): Promise<FiiReportsResponse>;
+    listIndices(): Promise<IndexMeta[]>;
+    listIndexQuotes(code: string, params?: RangeParams & {
+        limit?: number;
+    }): Promise<IndexQuotesResponse>;
+    getIndexComposition(code: string): Promise<IndexCompositionResponse>;
+    getSeries(source: string, seriesId: string, params?: RangeParams & {
+        accumulated?: "none" | "12m" | "ytd";
+    }): Promise<SeriesResponse>;
+    getYieldCurve(params?: {
+        kind?: "nominal" | "real";
+    }): Promise<YieldCurveResponse>;
+    listTesouroBonds(params?: {
+        type?: string;
+        maturity?: string;
+        date?: string;
+        limit?: number;
+    }): Promise<TesouroBondsResponse>;
+    getMarketExpectations(indicator: "ipca" | "selic" | "pib" | "cambio", params?: {
+        reference?: string;
+    } & RangeParams): Promise<ExpectationsResponse>;
+    getMacroRegime(params?: {
+        at?: string;
+    }): Promise<RegimeSnapshot>;
+    getMacroGears(params?: {
+        gear?: string;
+    }): Promise<MacroGearsResponse>;
+    listCryptoQuotes(symbol: string, params?: RangeParams & {
+        interval?: "1d" | "1h";
+        limit?: number;
+    }): Promise<CryptoQuotesResponse>;
+    /** Cadeia viva de um subjacente (séries não vencidas, mais negociadas). Filtra por vencimento/tipo. */
+    listOptionsChain(underlying: string, params?: {
+        expiry?: string;
+        type?: "call" | "put";
+    }): Promise<OptionsChainResponse>;
+    /** Vencimentos distintos disponíveis para um subjacente (com contagem de séries). */
+    listOptionExpiries(underlying: string): Promise<OptionExpiriesResponse>;
+    /** Histórico EOD de UMA série de opção (paginado; só europeu). */
+    listOptionQuotes(optionTicker: string, params?: RangeParams & {
+        limit?: number;
+        cursor?: string;
+    }): Promise<OptionsQuotesResponse>;
+    /** Catálogo de BDRs (paginado; busca por ticker/nome). */
+    listBdrs(params?: {
+        search?: string;
+        limit?: number;
+        cursor?: string;
+    }): Promise<BdrListResponse>;
+    getBdr(ticker: string): Promise<BdrProfile>;
+    /** Histórico EOD de um BDR em BRL (paginado). */
+    listBdrQuotes(ticker: string, params?: RangeParams & {
+        limit?: number;
+        cursor?: string;
+    }): Promise<BdrQuotesResponse>;
+    /** Busca unificada (ações, FIIs, índices, títulos, séries macro) — backed o Cmd+K. */
+    search(q: string, params?: {
+        limit?: number;
+    }): Promise<SearchResult[]>;
+}
+export declare class NotInPreviewError extends Error {
+    readonly entity: string;
+    constructor(entity: string);
+}

package/dist/http-client.d.ts

@@ -0,0 +1,105 @@
+import { type DataBolsaClient, type ScreenFiisParams, type ScreenStocksParams } from "./client";
+import type { CorporateEventsResponse, CryptoQuotesResponse, DividendsResponse, DocumentsResponse, ExpectationsResponse, Fii, FiiDistributionsResponse, FiiIndicatorsResponse, FiiReportsResponse, FiiScreenResponse, HealthResponse, IngestHealthResponse, IndexCompositionResponse, IndexMeta, IndexQuotesResponse, IndicatorHistoryResponse, BdrListResponse, BdrProfile, BdrQuotesResponse, InsiderResponse, MacroGearsResponse, OptionExpiriesResponse, OptionsChainResponse, OptionsQuotesResponse, QuotesResponse, RangeParams, RegimeSnapshot, ScreenStocksResponse, SearchResult, SeriesResponse, Stock, StockIndicatorsResponse, TesouroBondsResponse, YieldCurveResponse } from "./types";
+/**
+ * Cliente HTTP da Serving API do DataBolsa. Os métodos públicos espelham os
+ * operationIds do OpenAPI e retornam tipos gerados.
+ *
+ * Degradação graciosa: 501 (endpoint ainda não servido) e 404 (recurso não
+ * encontrado) viram {@link NotInPreviewError}; outros status não-2xx lançam
+ * Error.
+ *
+ * `baseUrl` pode ser uma origem absoluta para Node/servidor ou uma base
+ * relativa de mesma origem em apps browser que fazem proxy de `/v1` para a API.
+ */
+export interface HttpClientOptions {
+    /** Token bearer a anexar (opcional). Hoje a API de dev é aberta. */
+    getToken?: () => string | null | undefined;
+    /** Chave estática (atalho p/ Node/CLI). Ignorada se `getToken` for passada. */
+    apiKey?: string | null;
+}
+export declare class HttpClient implements DataBolsaClient {
+    private readonly base;
+    private readonly getToken?;
+    constructor(baseUrl: string, opts?: HttpClientOptions);
+    private request;
+    /** Extrai `detail`/`title` de um application/problem+json, se houver. */
+    private problemDetail;
+    getHealth(): Promise<HealthResponse>;
+    getIngestHealth(): Promise<IngestHealthResponse>;
+    screenStocks(params?: ScreenStocksParams): Promise<ScreenStocksResponse>;
+    getStock(ticker: string): Promise<Stock>;
+    listQuotes(ticker: string, params?: RangeParams & {
+        adjusted?: boolean;
+        limit?: number;
+    }): Promise<QuotesResponse>;
+    getStockIndicators(ticker: string, params?: {
+        at?: string;
+    }): Promise<StockIndicatorsResponse>;
+    getStockIndicatorHistory(ticker: string, name: string, params?: RangeParams): Promise<IndicatorHistoryResponse>;
+    listDividends(ticker: string, params?: RangeParams): Promise<DividendsResponse>;
+    listCorporateEvents(ticker: string, params?: RangeParams): Promise<CorporateEventsResponse>;
+    listCompanyDocuments(cvmCode: number, params?: RangeParams & {
+        category?: string;
+    }): Promise<DocumentsResponse>;
+    listInsiderMoves(ticker: string, params?: RangeParams): Promise<InsiderResponse>;
+    screenFiis(params?: ScreenFiisParams): Promise<FiiScreenResponse>;
+    getFii(ticker: string): Promise<Fii>;
+    getFiiIndicators(ticker: string, params?: {
+        at?: string;
+    }): Promise<FiiIndicatorsResponse>;
+    getFiiIndicatorHistory(ticker: string, name: string, params?: RangeParams): Promise<IndicatorHistoryResponse>;
+    listFiiDistributions(ticker: string, params?: RangeParams): Promise<FiiDistributionsResponse>;
+    listFiiReports(ticker: string, params?: RangeParams): Promise<FiiReportsResponse>;
+    listIndices(): Promise<IndexMeta[]>;
+    listIndexQuotes(code: string, params?: RangeParams & {
+        limit?: number;
+    }): Promise<IndexQuotesResponse>;
+    getIndexComposition(code: string): Promise<IndexCompositionResponse>;
+    getSeries(source: string, seriesId: string, params?: RangeParams & {
+        accumulated?: "none" | "12m" | "ytd";
+    }): Promise<SeriesResponse>;
+    getYieldCurve(params?: {
+        kind?: "nominal" | "real";
+    }): Promise<YieldCurveResponse>;
+    listTesouroBonds(params?: {
+        type?: string;
+        maturity?: string;
+        date?: string;
+        limit?: number;
+    }): Promise<TesouroBondsResponse>;
+    getMarketExpectations(indicator: "ipca" | "selic" | "pib" | "cambio", params?: {
+        reference?: string;
+    } & RangeParams): Promise<ExpectationsResponse>;
+    getMacroRegime(params?: {
+        at?: string;
+    }): Promise<RegimeSnapshot>;
+    getMacroGears(params?: {
+        gear?: string;
+    }): Promise<MacroGearsResponse>;
+    listCryptoQuotes(symbol: string, params?: RangeParams & {
+        interval?: "1d" | "1h";
+        limit?: number;
+    }): Promise<CryptoQuotesResponse>;
+    listOptionsChain(underlying: string, params?: {
+        expiry?: string;
+        type?: "call" | "put";
+    }): Promise<OptionsChainResponse>;
+    listOptionExpiries(underlying: string): Promise<OptionExpiriesResponse>;
+    listOptionQuotes(optionTicker: string, params?: RangeParams & {
+        limit?: number;
+        cursor?: string;
+    }): Promise<OptionsQuotesResponse>;
+    listBdrs(params?: {
+        search?: string;
+        limit?: number;
+        cursor?: string;
+    }): Promise<BdrListResponse>;
+    getBdr(ticker: string): Promise<BdrProfile>;
+    listBdrQuotes(ticker: string, params?: RangeParams & {
+        limit?: number;
+        cursor?: string;
+    }): Promise<BdrQuotesResponse>;
+    search(q: string, params?: {
+        limit?: number;
+    }): Promise<SearchResult[]>;
+}

package/dist/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * `@databolsa/sdk` - cliente TypeScript tipado da Serving API pública.
+ *
+ * Casca fina e agnóstica de runtime: o `HttpClient` implementa
+ * {@link DataBolsaClient} sobre o `fetch` nativo, com Bearer opcional e
+ * 501/404 mapeados para {@link NotInPreviewError}. Os tipos são gerados do
+ * contrato OpenAPI.
+ */
+export { HttpClient, HttpClient as DataBolsa } from "./http-client";
+export type { HttpClientOptions } from "./http-client";
+export { NotInPreviewError } from "./client";
+export type { DataBolsaClient, ScreenStocksParams, ScreenFiisParams } from "./client";
+export type * from "./types";
+export type { paths, components, operations } from "./schema";

package/dist/index.js

@@ -0,0 +1,260 @@
+// src/client.ts
+class NotInPreviewError extends Error {
+  entity;
+  constructor(entity) {
+    super(`"${entity}" não está disponível na API DataBolsa atual.`);
+    this.entity = entity;
+    this.name = "NotInPreviewError";
+  }
+}
+
+// src/http-client.ts
+class HttpClient {
+  base;
+  getToken;
+  constructor(baseUrl, opts = {}) {
+    const isAbsolute = /^https?:\/\//i.test(baseUrl);
+    const loc = globalThis.location;
+    const origin = isAbsolute ? baseUrl.replace(/\/+$/, "") : loc?.origin ?? "";
+    this.base = `${origin}/v1`;
+    this.getToken = opts.getToken ?? (opts.apiKey ? () => opts.apiKey : undefined);
+  }
+  async request(path, query) {
+    const url = new URL(this.base + path);
+    if (query) {
+      for (const [k, v] of Object.entries(query)) {
+        if (v !== undefined && v !== null && v !== "")
+          url.searchParams.set(k, String(v));
+      }
+    }
+    const headers = { accept: "application/json" };
+    const token = this.getToken?.();
+    if (token)
+      headers.authorization = `Bearer ${token}`;
+    let res;
+    try {
+      res = await fetch(url, { headers });
+    } catch (cause) {
+      throw new Error(`Falha de rede ao chamar ${path}`, { cause });
+    }
+    if (res.ok)
+      return await res.json();
+    if (res.status === 501 || res.status === 404) {
+      throw new NotInPreviewError(decodeURIComponent(path.replace(/^\//, "")));
+    }
+    const detail = await this.problemDetail(res);
+    throw new Error(`API ${res.status} em ${path}${detail ? `: ${detail}` : ""}`);
+  }
+  async problemDetail(res) {
+    try {
+      const body = await res.json();
+      return body.detail ?? body.title ?? null;
+    } catch {
+      return null;
+    }
+  }
+  getHealth() {
+    return this.request("/health");
+  }
+  getIngestHealth() {
+    return this.request("/ingest");
+  }
+  screenStocks(params) {
+    return this.request("/screener/stocks", {
+      sector: params?.sector,
+      segment: params?.segment,
+      sort: params?.sort,
+      limit: params?.limit,
+      cursor: params?.cursor,
+      pl_min: params?.pl_min,
+      pl_max: params?.pl_max,
+      pvp_min: params?.pvp_min,
+      pvp_max: params?.pvp_max,
+      dy_min: params?.dy_min,
+      roe_min: params?.roe_min,
+      ev_ebitda_max: params?.ev_ebitda_max,
+      div_liq_ebitda_max: params?.div_liq_ebitda_max
+    });
+  }
+  getStock(ticker) {
+    return this.request(`/stocks/${enc(ticker)}`);
+  }
+  listQuotes(ticker, params) {
+    return this.request(`/stocks/${enc(ticker)}/quotes`, {
+      from: params?.from,
+      to: params?.to,
+      limit: params?.limit,
+      adjusted: params?.adjusted === false ? "false" : undefined
+    });
+  }
+  getStockIndicators(ticker, params) {
+    return this.request(`/stocks/${enc(ticker)}/indicators`, {
+      at: params?.at
+    });
+  }
+  getStockIndicatorHistory(ticker, name, params) {
+    return this.request(`/stocks/${enc(ticker)}/indicators/history`, {
+      name,
+      from: params?.from,
+      to: params?.to
+    });
+  }
+  listDividends(ticker, params) {
+    return this.request(`/stocks/${enc(ticker)}/dividends`, {
+      from: params?.from,
+      to: params?.to
+    });
+  }
+  listCorporateEvents(ticker, params) {
+    return this.request(`/stocks/${enc(ticker)}/events`, {
+      from: params?.from,
+      to: params?.to
+    });
+  }
+  listCompanyDocuments(cvmCode, params) {
+    return this.request(`/companies/${cvmCode}/documents`, {
+      from: params?.from,
+      to: params?.to,
+      category: params?.category
+    });
+  }
+  listInsiderMoves(ticker, params) {
+    return this.request(`/stocks/${enc(ticker)}/insider`, {
+      from: params?.from,
+      to: params?.to
+    });
+  }
+  screenFiis(params) {
+    return this.request("/screener/fiis", {
+      segment: params?.segment,
+      paper: params?.paper === undefined ? undefined : String(params.paper),
+      sort: params?.sort,
+      limit: params?.limit,
+      cursor: params?.cursor
+    });
+  }
+  getFii(ticker) {
+    return this.request(`/fiis/${enc(ticker)}`);
+  }
+  getFiiIndicators(ticker, params) {
+    return this.request(`/fiis/${enc(ticker)}/indicators`, { at: params?.at });
+  }
+  getFiiIndicatorHistory(ticker, name, params) {
+    return this.request(`/fiis/${enc(ticker)}/indicators/history`, {
+      name,
+      from: params?.from,
+      to: params?.to
+    });
+  }
+  listFiiDistributions(ticker, params) {
+    return this.request(`/fiis/${enc(ticker)}/distributions`, {
+      from: params?.from,
+      to: params?.to
+    });
+  }
+  listFiiReports(ticker, params) {
+    return this.request(`/fiis/${enc(ticker)}/reports`, {
+      from: params?.from,
+      to: params?.to
+    });
+  }
+  listIndices() {
+    return this.request("/indices");
+  }
+  listIndexQuotes(code, params) {
+    return this.request(`/indices/${enc(code)}/quotes`, {
+      from: params?.from,
+      to: params?.to,
+      limit: params?.limit
+    });
+  }
+  getIndexComposition(code) {
+    return this.request(`/indices/${enc(code)}/composition`);
+  }
+  getSeries(source, seriesId, params) {
+    return this.request(`/series/${enc(source)}/${enc(seriesId)}`, {
+      from: params?.from,
+      to: params?.to,
+      accumulated: params?.accumulated
+    });
+  }
+  getYieldCurve(params) {
+    return this.request("/bonds/tesouro/yield-curve", { kind: params?.kind });
+  }
+  listTesouroBonds(params) {
+    return this.request("/bonds/tesouro", {
+      type: params?.type,
+      maturity: params?.maturity,
+      date: params?.date,
+      limit: params?.limit
+    });
+  }
+  getMarketExpectations(indicator, params) {
+    return this.request("/macro/expectations", {
+      indicator,
+      reference: params?.reference,
+      from: params?.from,
+      to: params?.to
+    });
+  }
+  getMacroRegime(params) {
+    return this.request("/macro/regime", { at: params?.at });
+  }
+  getMacroGears(params) {
+    return this.request("/macro/gears", { gear: params?.gear });
+  }
+  listCryptoQuotes(symbol, params) {
+    return this.request(`/crypto/${enc(symbol)}/quotes`, {
+      interval: params?.interval,
+      from: params?.from,
+      to: params?.to,
+      limit: params?.limit
+    });
+  }
+  listOptionsChain(underlying, params) {
+    return this.request(`/options/${enc(underlying)}/chain`, {
+      expiry: params?.expiry,
+      type: params?.type
+    });
+  }
+  listOptionExpiries(underlying) {
+    return this.request(`/options/${enc(underlying)}/expiries`);
+  }
+  listOptionQuotes(optionTicker, params) {
+    return this.request(`/options/${enc(optionTicker)}/quotes`, {
+      from: params?.from,
+      to: params?.to,
+      limit: params?.limit,
+      cursor: params?.cursor
+    });
+  }
+  listBdrs(params) {
+    return this.request("/bdr", {
+      search: params?.search,
+      limit: params?.limit,
+      cursor: params?.cursor
+    });
+  }
+  getBdr(ticker) {
+    return this.request(`/bdr/${enc(ticker)}`);
+  }
+  listBdrQuotes(ticker, params) {
+    return this.request(`/bdr/${enc(ticker)}/quotes`, {
+      from: params?.from,
+      to: params?.to,
+      limit: params?.limit,
+      cursor: params?.cursor
+    });
+  }
+  search(q, params) {
+    return this.request("/search", { q, limit: params?.limit });
+  }
+}
+function enc(segment) {
+  return encodeURIComponent(segment);
+}
+export {
+  NotInPreviewError,
+  HttpClient,
+  HttpClient as DataBolsa
+};

package/{src/schema.ts → dist/schema.d.ts}

@@ -2,7 +2,6 @@
  * This file was auto-generated by openapi-typescript.
  * Do not make direct changes to the file.
  */
-
 export interface paths {
     "/v1/health": {
         parameters: {

package/{src/types.ts → dist/types.d.ts}

@@ -1,22 +1,21 @@
 import type { components, operations } from "./schema";
-
 /** Corpo JSON da resposta 200 de uma operação do contrato. */
 export type Ok<Op extends keyof operations> = operations[Op] extends {
-  responses: { 200: { content: { "application/json": infer T } } };
-}
-  ? T
-  : never;
-
+    responses: {
+        200: {
+            content: {
+                "application/json": infer T;
+            };
+        };
+    };
+} ? T : never;
 /** Parâmetros de query de uma operação do contrato (sem o `| undefined`). */
 export type Query<Op extends keyof operations> = operations[Op] extends {
-  parameters: { query?: infer Q };
-}
-  ? NonNullable<Q>
-  : never;
-
+    parameters: {
+        query?: infer Q;
+    };
+} ? NonNullable<Q> : never;
 export type Schemas = components["schemas"];
-
-// --- objetos de domínio (schemas do contrato) -----------------------------
 export type Lineage = Schemas["Lineage"];
 export type Company = Schemas["Company"];
 export type Stock = Schemas["Stock"];
@@ -48,8 +47,6 @@ export type BdrQuote = Schemas["BdrQuote"];
 export type IngestSourceStatus = Schemas["IngestSourceHealth"]["status"];
 export type IngestSourceHealth = Schemas["IngestSourceHealth"];
 export type IngestRunSummary = Schemas["IngestRunSummary"];
-
-// --- respostas (corpo 200 de cada operação) -------------------------------
 export type HealthResponse = Ok<"getHealth">;
 export type IngestHealthResponse = Ok<"getIngestHealth">;
 export type ScreenStocksResponse = Ok<"screenStocks">;
@@ -78,13 +75,12 @@ export type OptionExpiriesResponse = Ok<"listOptionExpiries">;
 export type OptionsQuotesResponse = Ok<"listOptionQuotes">;
 export type BdrListResponse = Ok<"listBdrs">;
 export type BdrQuotesResponse = Ok<"listBdrQuotes">;
-
 /**
  * Agrupamento client-side de `from`/`to` (datas ISO) — não é um schema do
  * contrato; os endpoints os recebem como query params soltos. Único tipo
  * mantido à mão de propósito.
  */
 export interface RangeParams {
-  from?: string;
-  to?: string;
+    from?: string;
+    to?: string;
 }

package/package.json

@@ -1,15 +1,21 @@
 {
   "name": "@databolsa/sdk",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "license": "Apache-2.0",
   "type": "module",
-  "description": "SDK TypeScript tipado sobre a Serving API aberta do DataBolsa — cliente agnóstico (fetch nativo), tipos gerados do contrato OpenAPI.",
+  "description": "SDK TypeScript tipado para a Serving API pública do DataBolsa, gerado a partir do contrato OpenAPI.",
   "exports": {
-    ".": "./src/index.ts"
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
   },
+  "types": "./dist/index.d.ts",
   "scripts": {
     "gen:schema": "openapi-typescript ../../api/openapi.yaml -o src/schema.ts",
-    "typecheck": "tsc --noEmit"
+    "typecheck": "tsc --noEmit",
+    "build": "rm -rf dist && bun build src/index.ts --target browser --format esm --outfile dist/index.js && tsc --declaration --emitDeclarationOnly --outDir dist --noEmit false",
+    "prepack": "bun run build"
   },
   "devDependencies": {
     "@types/bun": "latest",
@@ -20,8 +26,11 @@
     "access": "public"
   },
   "files": [
-    "src"
+    "dist"
   ],
+  "engines": {
+    "node": ">=18"
+  },
   "author": "Rodrigo Klosowski",
   "homepage": "https://github.com/databolsahq/databolsa/tree/main/packages/sdk",
   "repository": {

package/src/client.ts

@@ -1,148 +0,0 @@
-import type {
-  CorporateEventsResponse,
-  CryptoQuotesResponse,
-  DividendsResponse,
-  DocumentsResponse,
-  ExpectationsResponse,
-  Fii,
-  FiiDistributionsResponse,
-  FiiIndicatorsResponse,
-  FiiReportsResponse,
-  FiiScreenResponse,
-  HealthResponse,
-  IngestHealthResponse,
-  IndexCompositionResponse,
-  IndexMeta,
-  IndexQuotesResponse,
-  IndicatorHistoryResponse,
-  BdrListResponse,
-  BdrProfile,
-  BdrQuotesResponse,
-  InsiderResponse,
-  MacroGearsResponse,
-  OptionExpiriesResponse,
-  OptionsChainResponse,
-  OptionsQuotesResponse,
-  Query,
-  QuotesResponse,
-  RangeParams,
-  RegimeSnapshot,
-  ScreenStocksResponse,
-  SearchResult,
-  SeriesResponse,
-  Stock,
-  StockIndicatorsResponse,
-  TesouroBondsResponse,
-  YieldCurveResponse,
-} from "./types";
-
-/** Filtros do screener de ações — derivados de `GET /v1/screener/stocks`. */
-export type ScreenStocksParams = Query<"screenStocks">;
-
-/**
- * Filtros do listing de FIIs — derivados de `GET /v1/screener/fiis`, com uma
- * ergonomia: `paper` aceita `boolean` (o contrato pede `"true"`/`"false"`; o
- * HttpClient serializa). true = papel, false = tijolo, undefined = todos.
- */
-export type ScreenFiisParams = Omit<Query<"screenFiis">, "paper"> & { paper?: boolean };
-
-/**
- * Interface do cliente DataBolsa — métodos = operationIds do api/openapi.yaml.
- * Hoje implementada por FixtureClient (dados de demonstração); quando a API
- * real existir, um FetchClient implementa a mesma interface e o resto da UI
- * não muda.
- */
-export interface DataBolsaClient {
-  getHealth(): Promise<HealthResponse>;
-
-  /** Saúde da ingestão: última run + saúde por fonte + histórico (data lake). */
-  getIngestHealth(): Promise<IngestHealthResponse>;
-
-  /** Lista/filtra ações por fundamentos (o universo real, não o preview). */
-  screenStocks(params?: ScreenStocksParams): Promise<ScreenStocksResponse>;
-
-  getStock(ticker: string): Promise<Stock>;
-  listQuotes(
-    ticker: string,
-    params?: RangeParams & { adjusted?: boolean; limit?: number },
-  ): Promise<QuotesResponse>;
-  getStockIndicators(ticker: string, params?: { at?: string }): Promise<StockIndicatorsResponse>;
-  getStockIndicatorHistory(ticker: string, name: string, params?: RangeParams): Promise<IndicatorHistoryResponse>;
-  listDividends(ticker: string, params?: RangeParams): Promise<DividendsResponse>;
-  listCorporateEvents(ticker: string, params?: RangeParams): Promise<CorporateEventsResponse>;
-  listCompanyDocuments(cvmCode: number, params?: RangeParams & { category?: string }): Promise<DocumentsResponse>;
-  /** PENDÊNCIA DE CONTRATO — ver lib/api/types.ts (InsiderMove) */
-  listInsiderMoves(ticker: string, params?: RangeParams): Promise<InsiderResponse>;
-
-  /** Lista o universo real de FIIs (não o preview). */
-  screenFiis(params?: ScreenFiisParams): Promise<FiiScreenResponse>;
-  getFii(ticker: string): Promise<Fii>;
-  getFiiIndicators(ticker: string, params?: { at?: string }): Promise<FiiIndicatorsResponse>;
-  /** Série mensal de um indicador de FII (mart_fii__reports) — mesmo shape do histórico de ações. */
-  getFiiIndicatorHistory(ticker: string, name: string, params?: RangeParams): Promise<IndicatorHistoryResponse>;
-  listFiiDistributions(ticker: string, params?: RangeParams): Promise<FiiDistributionsResponse>;
-  listFiiReports(ticker: string, params?: RangeParams): Promise<FiiReportsResponse>;
-
-  listIndices(): Promise<IndexMeta[]>;
-  listIndexQuotes(code: string, params?: RangeParams & { limit?: number }): Promise<IndexQuotesResponse>;
-  getIndexComposition(code: string): Promise<IndexCompositionResponse>;
-
-  getSeries(
-    source: string,
-    seriesId: string,
-    params?: RangeParams & { accumulated?: "none" | "12m" | "ytd" },
-  ): Promise<SeriesResponse>;
-  getYieldCurve(params?: { kind?: "nominal" | "real" }): Promise<YieldCurveResponse>;
-  listTesouroBonds(params?: {
-    type?: string;
-    maturity?: string;
-    date?: string;
-    limit?: number;
-  }): Promise<TesouroBondsResponse>;
-  getMarketExpectations(
-    indicator: "ipca" | "selic" | "pib" | "cambio",
-    params?: { reference?: string } & RangeParams,
-  ): Promise<ExpectationsResponse>;
-  getMacroRegime(params?: { at?: string }): Promise<RegimeSnapshot>;
-  getMacroGears(params?: { gear?: string }): Promise<MacroGearsResponse>;
-
-  listCryptoQuotes(
-    symbol: string,
-    params?: RangeParams & { interval?: "1d" | "1h"; limit?: number },
-  ): Promise<CryptoQuotesResponse>;
-
-  // --- opções (chain viva + greeks europeus/americanos; histórico por série) ---
-  /** Cadeia viva de um subjacente (séries não vencidas, mais negociadas). Filtra por vencimento/tipo. */
-  listOptionsChain(
-    underlying: string,
-    params?: { expiry?: string; type?: "call" | "put" },
-  ): Promise<OptionsChainResponse>;
-  /** Vencimentos distintos disponíveis para um subjacente (com contagem de séries). */
-  listOptionExpiries(underlying: string): Promise<OptionExpiriesResponse>;
-  /** Histórico EOD de UMA série de opção (paginado; só europeu). */
-  listOptionQuotes(
-    optionTicker: string,
-    params?: RangeParams & { limit?: number; cursor?: string },
-  ): Promise<OptionsQuotesResponse>;
-
-  // --- BDRs (catálogo + cotações em BRL; dolarização via USD/BRL no client) ---
-  /** Catálogo de BDRs (paginado; busca por ticker/nome). */
-  listBdrs(params?: { search?: string; limit?: number; cursor?: string }): Promise<BdrListResponse>;
-  getBdr(ticker: string): Promise<BdrProfile>;
-  /** Histórico EOD de um BDR em BRL (paginado). */
-  listBdrQuotes(
-    ticker: string,
-    params?: RangeParams & { limit?: number; cursor?: string },
-  ): Promise<BdrQuotesResponse>;
-
-  /** Busca unificada (ações, FIIs, índices, títulos, séries macro) — backed o Cmd+K. */
-  search(q: string, params?: { limit?: number }): Promise<SearchResult[]>;
-}
-
-export class NotInPreviewError extends Error {
-  constructor(public readonly entity: string) {
-    super(`"${entity}" ainda não está no preview — dados de demonstração cobrem um subconjunto`);
-    this.name = "NotInPreviewError";
-  }
-}
-

package/src/http-client.ts

@@ -1,412 +0,0 @@
-import {
-  type DataBolsaClient,
-  NotInPreviewError,
-  type ScreenFiisParams,
-  type ScreenStocksParams,
-} from "./client";
-import type {
-  CorporateEventsResponse,
-  CryptoQuotesResponse,
-  DividendsResponse,
-  DocumentsResponse,
-  ExpectationsResponse,
-  Fii,
-  FiiDistributionsResponse,
-  FiiIndicatorsResponse,
-  FiiReportsResponse,
-  FiiScreenResponse,
-  HealthResponse,
-  IngestHealthResponse,
-  IndexCompositionResponse,
-  IndexMeta,
-  IndexQuotesResponse,
-  IndicatorHistoryResponse,
-  BdrListResponse,
-  BdrProfile,
-  BdrQuotesResponse,
-  InsiderResponse,
-  MacroGearsResponse,
-  OptionExpiriesResponse,
-  OptionsChainResponse,
-  OptionsQuotesResponse,
-  QuotesResponse,
-  RangeParams,
-  RegimeSnapshot,
-  ScreenStocksResponse,
-  SearchResult,
-  SeriesResponse,
-  Stock,
-  StockIndicatorsResponse,
-  TesouroBondsResponse,
-  YieldCurveResponse,
-} from "./types";
-
-/**
- * Cliente HTTP real — fala com a Serving API (`@databolsa/api`) pelo contrato
- * `api/openapi.yaml`. Implementa a MESMA interface do FixtureClient, então a UI
- * não muda: `getClient()` (lib/api/index.ts) escolhe um ou outro por env.
- *
- * Princípio de degradação graciosa: a API responde **501** para qualquer rota
- * `/v1/*` ainda não servida (notFoundHandler). Tratamos 501 (e 404 de recurso
- * inexistente) como {@link NotInPreviewError} — a mesma exceção que a UI já sabe
- * exibir. Assim cada método chama o path real do contrato e "acende" sozinho
- * quando o endpoint correspondente passar a existir no servidor, sem editar aqui.
- *
- * A API é a camada ABERTA (sem dados de usuário): a autenticação é só um cheque
- * de chave opcional. Quando existir um control-plane à frente (mint/assinatura de
- * chave, rate-limit), `baseUrl` aponta para ele e o token vem de `getToken()`.
- */
-export interface HttpClientOptions {
-  /** Token bearer a anexar (opcional). Hoje a API de dev é aberta. */
-  getToken?: () => string | null | undefined;
-  /** Chave estática (atalho p/ Node/CLI). Ignorada se `getToken` for passada. */
-  apiKey?: string | null;
-}
-
-type Query = Record<string, string | number | boolean | null | undefined>;
-
-export class HttpClient implements DataBolsaClient {
-  private readonly base: string;
-  private readonly getToken?: () => string | null | undefined;
-
-  constructor(baseUrl: string, opts: HttpClientOptions = {}) {
-    // baseUrl absoluto (http(s)://…) → chamada direta (cross-origin, precisa CORS).
-    // baseUrl relativo (ex.: "/") → MESMA ORIGEM: o browser fala com a própria origem
-    // e o Next faz proxy p/ a API (next.config.ts) — funciona local, tunelado ou atrás
-    // do gateway, sem o browser saber onde a API mora. As rotas vivem sob /v1.
-    const isAbsolute = /^https?:\/\//i.test(baseUrl);
-    // `globalThis.location` em vez do `window` nu: o SDK é agnóstico (sem lib DOM),
-    // resolve a origem no browser e cai em "" no Node (onde baseUrl deve ser absoluto).
-    const loc = (globalThis as { location?: { origin?: string } }).location;
-    const origin = isAbsolute ? baseUrl.replace(/\/+$/, "") : (loc?.origin ?? "");
-    this.base = `${origin}/v1`;
-    this.getToken = opts.getToken ?? (opts.apiKey ? () => opts.apiKey : undefined);
-  }
-
-  private async request<T>(path: string, query?: Query): Promise<T> {
-    const url = new URL(this.base + path);
-    if (query) {
-      for (const [k, v] of Object.entries(query)) {
-        if (v !== undefined && v !== null && v !== "") url.searchParams.set(k, String(v));
-      }
-    }
-
-    const headers: Record<string, string> = { accept: "application/json" };
-    const token = this.getToken?.();
-    if (token) headers.authorization = `Bearer ${token}`;
-
-    let res: Response;
-    try {
-      res = await fetch(url, { headers });
-    } catch (cause) {
-      // Rede indisponível (API fora do ar, CORS, DNS) — erro real, não "preview".
-      throw new Error(`Falha de rede ao chamar ${path}`, { cause });
-    }
-
-    if (res.ok) return (await res.json()) as T;
-
-    // 501 (rota não servida nesta versão) e 404 (recurso inexistente) → a UI
-    // trata como "fora do preview"; demais status são erros de verdade.
-    if (res.status === 501 || res.status === 404) {
-      throw new NotInPreviewError(decodeURIComponent(path.replace(/^\//, "")));
-    }
-    const detail = await this.problemDetail(res);
-    throw new Error(`API ${res.status} em ${path}${detail ? `: ${detail}` : ""}`);
-  }
-
-  /** Extrai `detail`/`title` de um application/problem+json, se houver. */
-  private async problemDetail(res: Response): Promise<string | null> {
-    try {
-      const body = (await res.json()) as { detail?: string; title?: string };
-      return body.detail ?? body.title ?? null;
-    } catch {
-      return null;
-    }
-  }
-
-  // --- saúde ---------------------------------------------------------------
-  getHealth(): Promise<HealthResponse> {
-    return this.request<HealthResponse>("/health");
-  }
-
-  getIngestHealth(): Promise<IngestHealthResponse> {
-    return this.request<IngestHealthResponse>("/ingest");
-  }
-
-  // --- screener (o universo real de ações) ---------------------------------
-  screenStocks(params?: ScreenStocksParams): Promise<ScreenStocksResponse> {
-    return this.request<ScreenStocksResponse>("/screener/stocks", {
-      sector: params?.sector,
-      segment: params?.segment,
-      sort: params?.sort,
-      limit: params?.limit,
-      cursor: params?.cursor,
-      pl_min: params?.pl_min,
-      pl_max: params?.pl_max,
-      pvp_min: params?.pvp_min,
-      pvp_max: params?.pvp_max,
-      dy_min: params?.dy_min,
-      roe_min: params?.roe_min,
-      ev_ebitda_max: params?.ev_ebitda_max,
-      div_liq_ebitda_max: params?.div_liq_ebitda_max,
-    });
-  }
-
-  // --- ações ---------------------------------------------------------------
-  getStock(ticker: string): Promise<Stock> {
-    return this.request<Stock>(`/stocks/${enc(ticker)}`);
-  }
-
-  listQuotes(
-    ticker: string,
-    params?: RangeParams & { adjusted?: boolean; limit?: number },
-  ): Promise<QuotesResponse> {
-    return this.request<QuotesResponse>(`/stocks/${enc(ticker)}/quotes`, {
-      from: params?.from,
-      to: params?.to,
-      limit: params?.limit,
-      // só envia quando explicitamente não-ajustado (servidor: adjusted = v !== "false")
-      adjusted: params?.adjusted === false ? "false" : undefined,
-    });
-  }
-
-  getStockIndicators(ticker: string, params?: { at?: string }): Promise<StockIndicatorsResponse> {
-    return this.request<StockIndicatorsResponse>(`/stocks/${enc(ticker)}/indicators`, {
-      at: params?.at,
-    });
-  }
-
-  getStockIndicatorHistory(
-    ticker: string,
-    name: string,
-    params?: RangeParams,
-  ): Promise<IndicatorHistoryResponse> {
-    // Contrato: /stocks/{ticker}/indicators/history?name=… (não /{name}/history).
-    return this.request<IndicatorHistoryResponse>(`/stocks/${enc(ticker)}/indicators/history`, {
-      name,
-      from: params?.from,
-      to: params?.to,
-    });
-  }
-
-  listDividends(ticker: string, params?: RangeParams): Promise<DividendsResponse> {
-    return this.request<DividendsResponse>(`/stocks/${enc(ticker)}/dividends`, {
-      from: params?.from,
-      to: params?.to,
-    });
-  }
-
-  listCorporateEvents(ticker: string, params?: RangeParams): Promise<CorporateEventsResponse> {
-    return this.request<CorporateEventsResponse>(`/stocks/${enc(ticker)}/events`, {
-      from: params?.from,
-      to: params?.to,
-    });
-  }
-
-  listCompanyDocuments(
-    cvmCode: number,
-    params?: RangeParams & { category?: string },
-  ): Promise<DocumentsResponse> {
-    return this.request<DocumentsResponse>(`/companies/${cvmCode}/documents`, {
-      from: params?.from,
-      to: params?.to,
-      category: params?.category,
-    });
-  }
-
-  listInsiderMoves(ticker: string, params?: RangeParams): Promise<InsiderResponse> {
-    // Pendência de contrato (sem operationId ainda) — 501 até a rota existir.
-    return this.request<InsiderResponse>(`/stocks/${enc(ticker)}/insider`, {
-      from: params?.from,
-      to: params?.to,
-    });
-  }
-
-  // --- FIIs ----------------------------------------------------------------
-  screenFiis(params?: ScreenFiisParams): Promise<FiiScreenResponse> {
-    return this.request<FiiScreenResponse>("/screener/fiis", {
-      segment: params?.segment,
-      paper: params?.paper === undefined ? undefined : String(params.paper),
-      sort: params?.sort,
-      limit: params?.limit,
-      cursor: params?.cursor,
-    });
-  }
-
-  getFii(ticker: string): Promise<Fii> {
-    return this.request<Fii>(`/fiis/${enc(ticker)}`);
-  }
-
-  getFiiIndicators(ticker: string, params?: { at?: string }): Promise<FiiIndicatorsResponse> {
-    return this.request<FiiIndicatorsResponse>(`/fiis/${enc(ticker)}/indicators`, { at: params?.at });
-  }
-
-  getFiiIndicatorHistory(
-    ticker: string,
-    name: string,
-    params?: RangeParams,
-  ): Promise<IndicatorHistoryResponse> {
-    return this.request<IndicatorHistoryResponse>(`/fiis/${enc(ticker)}/indicators/history`, {
-      name,
-      from: params?.from,
-      to: params?.to,
-    });
-  }
-
-  listFiiDistributions(ticker: string, params?: RangeParams): Promise<FiiDistributionsResponse> {
-    return this.request<FiiDistributionsResponse>(`/fiis/${enc(ticker)}/distributions`, {
-      from: params?.from,
-      to: params?.to,
-    });
-  }
-
-  listFiiReports(ticker: string, params?: RangeParams): Promise<FiiReportsResponse> {
-    return this.request<FiiReportsResponse>(`/fiis/${enc(ticker)}/reports`, {
-      from: params?.from,
-      to: params?.to,
-    });
-  }
-
-  // --- índices -------------------------------------------------------------
-  listIndices(): Promise<IndexMeta[]> {
-    return this.request<IndexMeta[]>("/indices");
-  }
-
-  listIndexQuotes(code: string, params?: RangeParams & { limit?: number }): Promise<IndexQuotesResponse> {
-    return this.request<IndexQuotesResponse>(`/indices/${enc(code)}/quotes`, {
-      from: params?.from,
-      to: params?.to,
-      limit: params?.limit,
-    });
-  }
-
-  getIndexComposition(code: string): Promise<IndexCompositionResponse> {
-    return this.request<IndexCompositionResponse>(`/indices/${enc(code)}/composition`);
-  }
-
-  // --- séries / renda fixa -------------------------------------------------
-  getSeries(
-    source: string,
-    seriesId: string,
-    params?: RangeParams & { accumulated?: "none" | "12m" | "ytd" },
-  ): Promise<SeriesResponse> {
-    return this.request<SeriesResponse>(`/series/${enc(source)}/${enc(seriesId)}`, {
-      from: params?.from,
-      to: params?.to,
-      accumulated: params?.accumulated,
-    });
-  }
-
-  getYieldCurve(params?: { kind?: "nominal" | "real" }): Promise<YieldCurveResponse> {
-    return this.request<YieldCurveResponse>("/bonds/tesouro/yield-curve", { kind: params?.kind });
-  }
-
-  listTesouroBonds(params?: {
-    type?: string;
-    maturity?: string;
-    date?: string;
-    limit?: number;
-  }): Promise<TesouroBondsResponse> {
-    return this.request<TesouroBondsResponse>("/bonds/tesouro", {
-      type: params?.type,
-      maturity: params?.maturity,
-      date: params?.date,
-      limit: params?.limit,
-    });
-  }
-
-  // --- macro ---------------------------------------------------------------
-  getMarketExpectations(
-    indicator: "ipca" | "selic" | "pib" | "cambio",
-    params?: { reference?: string } & RangeParams,
-  ): Promise<ExpectationsResponse> {
-    return this.request<ExpectationsResponse>("/macro/expectations", {
-      indicator,
-      reference: params?.reference,
-      from: params?.from,
-      to: params?.to,
-    });
-  }
-
-  getMacroRegime(params?: { at?: string }): Promise<RegimeSnapshot> {
-    return this.request<RegimeSnapshot>("/macro/regime", { at: params?.at });
-  }
-
-  getMacroGears(params?: { gear?: string }): Promise<MacroGearsResponse> {
-    return this.request<MacroGearsResponse>("/macro/gears", { gear: params?.gear });
-  }
-
-  listCryptoQuotes(
-    symbol: string,
-    params?: RangeParams & { interval?: "1d" | "1h"; limit?: number },
-  ): Promise<CryptoQuotesResponse> {
-    return this.request<CryptoQuotesResponse>(`/crypto/${enc(symbol)}/quotes`, {
-      interval: params?.interval,
-      from: params?.from,
-      to: params?.to,
-      limit: params?.limit,
-    });
-  }
-
-  // --- opções --------------------------------------------------------------
-  listOptionsChain(
-    underlying: string,
-    params?: { expiry?: string; type?: "call" | "put" },
-  ): Promise<OptionsChainResponse> {
-    return this.request<OptionsChainResponse>(`/options/${enc(underlying)}/chain`, {
-      expiry: params?.expiry,
-      type: params?.type,
-    });
-  }
-
-  listOptionExpiries(underlying: string): Promise<OptionExpiriesResponse> {
-    return this.request<OptionExpiriesResponse>(`/options/${enc(underlying)}/expiries`);
-  }
-
-  listOptionQuotes(
-    optionTicker: string,
-    params?: RangeParams & { limit?: number; cursor?: string },
-  ): Promise<OptionsQuotesResponse> {
-    return this.request<OptionsQuotesResponse>(`/options/${enc(optionTicker)}/quotes`, {
-      from: params?.from,
-      to: params?.to,
-      limit: params?.limit,
-      cursor: params?.cursor,
-    });
-  }
-
-  // --- BDRs ----------------------------------------------------------------
-  listBdrs(params?: { search?: string; limit?: number; cursor?: string }): Promise<BdrListResponse> {
-    return this.request<BdrListResponse>("/bdr", {
-      search: params?.search,
-      limit: params?.limit,
-      cursor: params?.cursor,
-    });
-  }
-
-  getBdr(ticker: string): Promise<BdrProfile> {
-    return this.request<BdrProfile>(`/bdr/${enc(ticker)}`);
-  }
-
-  listBdrQuotes(
-    ticker: string,
-    params?: RangeParams & { limit?: number; cursor?: string },
-  ): Promise<BdrQuotesResponse> {
-    return this.request<BdrQuotesResponse>(`/bdr/${enc(ticker)}/quotes`, {
-      from: params?.from,
-      to: params?.to,
-      limit: params?.limit,
-      cursor: params?.cursor,
-    });
-  }
-
-  // --- busca ---------------------------------------------------------------
-  search(q: string, params?: { limit?: number }): Promise<SearchResult[]> {
-    return this.request<SearchResult[]>("/search", { q, limit: params?.limit });
-  }
-}
-
-/** Segmento de path seguro (tickers/códigos vêm da UI/URL). */
-function enc(segment: string): string {
-  return encodeURIComponent(segment);
-}

package/src/index.ts

@@ -1,26 +0,0 @@
-/**
- * `@databolsa/sdk` — cliente TypeScript tipado da Serving API aberta.
- *
- * Casca fina e **agnóstica** (sem React, sem dependências): o `HttpClient`
- * implementa a interface {@link DataBolsaClient} sobre o `fetch` nativo, com
- * degradação 501/404 → {@link NotInPreviewError} e Bearer opcional. Os tipos
- * saem do contrato `api/openapi.yaml` (gerados em `src/schema.ts` via
- * `bun run --cwd packages/sdk gen:schema`).
- *
- * Consumidores montam suas próprias camadas por cima: o app web envolve em
- * hooks React Query (apps/web/lib/queries.ts); um script Node usa direto.
- */
-
-// Cliente (valor) + nome amigável p/ uso externo.
-export { HttpClient, HttpClient as DataBolsa } from "./http-client";
-export type { HttpClientOptions } from "./http-client";
-
-// Contrato do cliente, params de busca e a exceção de degradação.
-export { NotInPreviewError } from "./client";
-export type { DataBolsaClient, ScreenStocksParams, ScreenFiisParams } from "./client";
-
-// Todos os tipos de domínio e de resposta derivados do schema.
-export type * from "./types";
-
-// Tipos crus do contrato (paths/operations/components), p/ quem quiser cavar.
-export type { paths, components, operations } from "./schema";