@databolsa/sdk 1.0.8 → 1.0.10

package/dist/client.d.ts

@@ -1,4 +1,4 @@
-import type { CorporateEventsResponse, CryptoQuotesResponse, DividendsResponse, DocumentsResponse, EtfListResponse, EtfProfile, ExpectationsResponse, Fii, FiiDistributionsResponse, FiiIndicatorsResponse, FiiReportsResponse, FiiScreenResponse, FundHoldersResponse, FundHoldingsResponse, FundListResponse, FundProfile, FundQuotesResponse, FundScreenerResponse, HealthResponse, IngestHealthResponse, IndexCompositionResponse, IndexMeta, IndexQuotesResponse, IndicatorHistoryResponse, IntradaySeriesResponse, LiveQuotesResponse, BdrListResponse, BdrProfile, BdrQuotesResponse, InsiderResponse, InvestorFlowMonthlyResponse, InvestorFlowResponse, MacroGearsResponse, OfferingsResponse, OptionExpiriesResponse, OptionsChainResponse, OptionsQuotesResponse, DocumentSearchResponse, PortfolioResponse, Query, QuotesResponse, RangeParams, RegimeSnapshot, ScreenStocksResponse, SearchDocumentsParams, SearchResult, SeriesResponse, Stock, StockIndicatorsResponse, SuitabilityResponse, TesouroBondsResponse, TradeStatsResponse, YieldCurveResponse } from "./types";
+import type { CorporateEventsResponse, CryptoQuotesResponse, DividendsResponse, DocumentsResponse, EtfListResponse, EtfProfile, ExpectationsResponse, Fii, FiiDistributionsResponse, FiiIndicatorsResponse, FiiReportsResponse, FiiScreenResponse, FundHoldersResponse, FundHoldingsResponse, FundListResponse, FundProfile, FundQuotesResponse, FundScreenerResponse, HealthResponse, IngestHealthResponse, IndexCompositionResponse, IndexMeta, IndexQuotesResponse, IndicatorHistoryResponse, IntradaySeriesResponse, LiveQuotesResponse, BdrListResponse, BdrProfile, BdrQuotesResponse, InsiderResponse, InvestorFlowMonthlyResponse, InvestorFlowResponse, MacroGearsResponse, OfferingsResponse, OptionExpiriesResponse, OptionsChainResponse, OptionsQuotesResponse, DocumentSearchResponse, PortfolioResponse, CommunityBotsResponse, CommunityBotPostInput, CommunityBotPostResponse, CommunityBotReplyResponse, CommunityFeedParams, CommunityFeedResponse, CommunityPostResponse, RegisterCommunityBotInput, RegisterCommunityBotResponse, Query, QuotesResponse, RangeParams, RegimeSnapshot, ScreenStocksResponse, SearchDocumentsParams, SearchResult, SeriesResponse, Stock, StockIndicatorsResponse, SuitabilityResponse, TesouroBondsResponse, TradeStatsResponse, YieldCurveResponse } from "./types";
 /** Filtros do screener de ações — derivados de `GET /v1/screener/stocks`. */
 export type ScreenStocksParams = Query<"screenStocks">;
 /**
@@ -199,6 +199,28 @@ export interface DataBolsaClient {
      * balanços, relatórios de FII, atas). Filtre por papel/categoria/ano quando souber.
      */
     searchDocuments(q: string, params?: SearchDocumentsParams): Promise<DocumentSearchResponse>;
+    /** Lista os bots de comunidade registrados pela sua conta. */
+    listCommunityBots(): Promise<CommunityBotsResponse>;
+    /**
+     * Registra um bot de comunidade (perfil público @handle que publica via API,
+     * com selo BOT). O número de bots por conta depende do plano.
+     */
+    registerCommunityBot(input: RegisterCommunityBotInput): Promise<RegisterCommunityBotResponse>;
+    /** Desativa um bot da conta (publicações antigas permanecem, rotuladas BOT). */
+    deleteCommunityBot(handle: string): Promise<{
+        ok?: boolean;
+    }>;
+    /**
+     * Publica um post na comunidade em nome do bot (público, com selo BOT).
+     * Moderação automática: conteúdo reprovado vira erro 422 com o motivo.
+     */
+    createCommunityBotPost(handle: string, input: CommunityBotPostInput): Promise<CommunityBotPostResponse>;
+    /** Publica uma resposta em nome do bot num post existente (mesma moderação). */
+    createCommunityBotReply(handle: string, postId: string, body: string): Promise<CommunityBotReplyResponse>;
+    /** Feed público da comunidade, paginado por cursor. */
+    getCommunityFeed(params?: CommunityFeedParams): Promise<CommunityFeedResponse>;
+    /** Um post da comunidade com a discussão completa. */
+    getCommunityPost(id: string): Promise<CommunityPostResponse>;
 }
 export declare class NotInPreviewError extends Error {
     readonly entity: string;

package/dist/http-client.d.ts

@@ -1,5 +1,5 @@
 import { type DataBolsaClient, type LiveQuotesParams, type ScreenFiisParams, type ScreenFundsParams, type ScreenStocksParams } from "./client";
-import type { CorporateEventsResponse, CryptoQuotesResponse, DividendsResponse, DocumentSearchResponse, DocumentsResponse, EtfListResponse, EtfProfile, ExpectationsResponse, Fii, FiiDistributionsResponse, FiiIndicatorsResponse, FiiReportsResponse, FiiScreenResponse, FundHoldersResponse, FundHoldingsResponse, FundListResponse, FundProfile, FundQuotesResponse, FundScreenerResponse, HealthResponse, IngestHealthResponse, IndexCompositionResponse, IndexMeta, IndexQuotesResponse, IndicatorHistoryResponse, IntradaySeriesResponse, LiveQuotesResponse, BdrListResponse, BdrProfile, BdrQuotesResponse, InsiderResponse, InvestorFlowMonthlyResponse, InvestorFlowResponse, MacroGearsResponse, OfferingsResponse, OptionExpiriesResponse, OptionsChainResponse, OptionsQuotesResponse, PortfolioResponse, QuotesResponse, RangeParams, RegimeSnapshot, ScreenStocksResponse, SearchDocumentsParams, SearchResult, SeriesResponse, Stock, StockIndicatorsResponse, SuitabilityResponse, TesouroBondsResponse, TradeStatsResponse, YieldCurveResponse } from "./types";
+import type { CorporateEventsResponse, CryptoQuotesResponse, DividendsResponse, DocumentSearchResponse, DocumentsResponse, EtfListResponse, EtfProfile, ExpectationsResponse, Fii, FiiDistributionsResponse, FiiIndicatorsResponse, FiiReportsResponse, FiiScreenResponse, FundHoldersResponse, FundHoldingsResponse, FundListResponse, FundProfile, FundQuotesResponse, FundScreenerResponse, HealthResponse, IngestHealthResponse, IndexCompositionResponse, IndexMeta, IndexQuotesResponse, IndicatorHistoryResponse, IntradaySeriesResponse, LiveQuotesResponse, BdrListResponse, BdrProfile, BdrQuotesResponse, InsiderResponse, InvestorFlowMonthlyResponse, InvestorFlowResponse, MacroGearsResponse, OfferingsResponse, OptionExpiriesResponse, OptionsChainResponse, OptionsQuotesResponse, PortfolioResponse, CommunityBotsResponse, CommunityBotPostInput, CommunityBotPostResponse, CommunityBotReplyResponse, CommunityFeedParams, CommunityFeedResponse, CommunityPostResponse, RegisterCommunityBotInput, RegisterCommunityBotResponse, QuotesResponse, RangeParams, RegimeSnapshot, ScreenStocksResponse, SearchDocumentsParams, SearchResult, SeriesResponse, Stock, StockIndicatorsResponse, SuitabilityResponse, TesouroBondsResponse, TradeStatsResponse, YieldCurveResponse } from "./types";
 /**
  * Cliente HTTP da Serving API do DataBolsa. Os métodos públicos espelham os
  * operationIds do OpenAPI e retornam tipos gerados.
@@ -164,4 +164,13 @@ export declare class HttpClient implements DataBolsaClient {
     getPortfolio(): Promise<PortfolioResponse>;
     getSuitability(): Promise<SuitabilityResponse>;
     searchDocuments(q: string, params?: SearchDocumentsParams): Promise<DocumentSearchResponse>;
+    listCommunityBots(): Promise<CommunityBotsResponse>;
+    registerCommunityBot(input: RegisterCommunityBotInput): Promise<RegisterCommunityBotResponse>;
+    deleteCommunityBot(handle: string): Promise<{
+        ok?: boolean;
+    }>;
+    createCommunityBotPost(handle: string, input: CommunityBotPostInput): Promise<CommunityBotPostResponse>;
+    createCommunityBotReply(handle: string, postId: string, body: string): Promise<CommunityBotReplyResponse>;
+    getCommunityFeed(params?: CommunityFeedParams): Promise<CommunityFeedResponse>;
+    getCommunityPost(id: string): Promise<CommunityPostResponse>;
 }

package/dist/index.js

@@ -19,7 +19,7 @@ class HttpClient {
     this.base = `${origin}/v1`;
     this.getToken = opts.getToken ?? (opts.apiKey ? () => opts.apiKey : undefined);
   }
-  async request(path, query) {
+  async request(path, query, opts) {
     const url = new URL(this.base + path);
     if (query) {
       for (const [k, v] of Object.entries(query)) {
@@ -31,9 +31,15 @@ class HttpClient {
     const token = this.getToken?.();
     if (token)
       headers.authorization = `Bearer ${token}`;
+    if (opts?.body !== undefined)
+      headers["content-type"] = "application/json";
     let res;
     try {
-      res = await fetch(url, { headers });
+      res = await fetch(url, {
+        method: opts?.method ?? "GET",
+        headers,
+        ...opts?.body !== undefined ? { body: JSON.stringify(opts.body) } : {}
+      });
     } catch (cause) {
       throw new Error(`Falha de rede ao chamar ${path}`, { cause });
     }
@@ -372,6 +378,41 @@ class HttpClient {
       limit: params?.limit
     });
   }
+  listCommunityBots() {
+    return this.request("/community/bots");
+  }
+  registerCommunityBot(input) {
+    return this.request("/community/bots", undefined, {
+      method: "POST",
+      body: { handle: input.handle, display_name: input.displayName, bio: input.bio }
+    });
+  }
+  deleteCommunityBot(handle) {
+    return this.request(`/community/bots/${enc(handle)}`, undefined, { method: "DELETE" });
+  }
+  createCommunityBotPost(handle, input) {
+    return this.request(`/community/bots/${enc(handle)}/posts`, undefined, {
+      method: "POST",
+      body: { body: input.body, title: input.title, ticker: input.ticker, asset_type: input.assetType }
+    });
+  }
+  createCommunityBotReply(handle, postId, body) {
+    return this.request(`/community/bots/${enc(handle)}/replies`, undefined, {
+      method: "POST",
+      body: { post_id: postId, body }
+    });
+  }
+  getCommunityFeed(params) {
+    return this.request("/community/feed", {
+      tab: params?.tab,
+      ticker: params?.ticker,
+      q: params?.q,
+      cursor: params?.cursor
+    });
+  }
+  getCommunityPost(id) {
+    return this.request(`/community/posts/${enc(id)}`);
+  }
 }
 function enc(segment) {
   return encodeURIComponent(segment);

package/dist/schema.d.ts

@@ -947,6 +947,126 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/v1/news/edition": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Edição de notícias (a mais recente ou de uma data)
+         * @description Retorna a edição publicada mais recente (ou de uma data específica via `date`), com o resumo do dia, o humor de mercado, os destaques e todos os itens (`items`). Cada item traz `why` (por que importa), `impact` e a fonte. Use para saber o que aconteceu no pregão e o contexto editorial já sintetizado.
+         */
+        get: operations["getNewsEdition"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/news/dates": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Datas com edição publicada
+         * @description Lista as datas com pelo menos uma edição publicada (recentes primeiro) e os períodos (slots) de cada dia. Útil p/ navegar edições passadas.
+         */
+        get: operations["listNewsDates"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/news/feed": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Feed de notícias ranqueado
+         * @description Feed paginado de itens das edições recentes, ordenado por relevância. Filtre por `category` e pagine com `cursor` (use o `nextCursor` da resposta anterior).
+         */
+        get: operations["listNewsFeed"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/news/item/{slug}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Item de notícia + relacionadas
+         * @description Retorna um item pelo `slug`, com o corpo completo (`body`), as fontes citadas (`sources`) e itens relacionados.
+         */
+        get: operations["getNewsItem"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/news/stories": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Stories do dia
+         * @description Retorna as stories (formato vertical, cartões encadeados) da publicação mais recente. Cada story tem um `ring` (rótulo), `mark` e uma lista de `cards`.
+         */
+        get: operations["listNewsStories"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/news/agenda": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Agenda: proventos, macro e resultados
+         * @description Agenda forward: proventos com data-ex próxima (`mercado`), eventos macro conhecidos (`macro`) e o calendário de divulgação de resultados (`resultados`, `status` previsto até confirmar com o Fato Relevante).
+         */
+        get: operations["getNewsAgenda"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/v1/portfolio": {
         parameters: {
             query?: never;
@@ -1007,6 +1127,130 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/v1/community/bots": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Seus bots registrados
+         * @description Lista os bots de comunidade registrados pela sua conta, com handle, status e data de criação.
+         */
+        get: operations["listCommunityBots"];
+        put?: never;
+        /**
+         * Registrar um bot
+         * @description Registra um bot de comunidade na sua conta. O bot ganha um perfil público (@handle) e publica via API em nome dele; as publicações exibem o selo BOT. O número de bots por conta depende do plano.
+         */
+        post: operations["registerCommunityBot"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/community/bots/{handle}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        post?: never;
+        /**
+         * Desativar um bot
+         * @description Desativa um bot da sua conta (as publicações antigas permanecem, rotuladas como BOT).
+         */
+        delete: operations["deleteCommunityBot"];
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/community/bots/{handle}/posts": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Publicar como bot
+         * @description Publica um post na comunidade EM NOME do bot informado (público, com selo BOT). Passa por moderação automática: conteúdo reprovado retorna 422 com o motivo. Sujeito a limite diário por bot conforme o plano. Cashtags ($PETR4) viram links.
+         */
+        post: operations["createCommunityBotPost"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/community/bots/{handle}/replies": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Responder como bot
+         * @description Publica uma resposta EM NOME do bot num post existente da comunidade (pública, com selo BOT). Mesma moderação automática e limites diários por bot do plano.
+         */
+        post: operations["createCommunityBotReply"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/community/feed": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Feed da comunidade
+         * @description Feed público da comunidade (posts e perguntas), paginado por cursor. Filtre por ticker ou busque por texto.
+         */
+        get: operations["getCommunityFeed"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/community/posts/{id}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Um post com a discussão completa
+         * @description Retorna um post da comunidade com todas as respostas (thread completa).
+         */
+        get: operations["getCommunityPost"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
 }
 export type webhooks = Record<string, never>;
 export interface components {
@@ -1590,6 +1834,36 @@ export interface components {
             rows: number;
             duration_s: number | null;
         };
+        CommunityBot: {
+            id?: string;
+            handle?: string;
+            display_name?: string;
+            bio?: string | null;
+            /** @description active | suspended | disabled */
+            status?: string;
+            /** Format: date-time */
+            created_at?: string;
+        };
+        /** @description Post da comunidade (raiz) com autor, contadores e respostas. */
+        CommunityItem: {
+            id?: string;
+            author?: {
+                name?: string;
+                handle?: string | null;
+                /** @description user | official | bot ("bot" = publicado por bot registrado). */
+                kind?: string;
+            };
+            /** Format: date-time */
+            time?: string;
+            ticker?: string;
+            title?: string;
+            body?: string;
+            text?: string;
+            votes?: number;
+            views?: number;
+            replyCount?: number;
+            replies?: Record<string, never>[];
+        };
         PortfolioHolding: {
             symbol: string;
             assetType: string;
@@ -1662,6 +1936,116 @@ export interface components {
             /** @description Bloco pronto p/ prompt, com citação por trecho. */
             context: string;
         };
+        NewsItem: {
+            id: string;
+            /** @description Identificador estável p/ buscar o item completo em /v1/news/item/{slug}. */
+            slug: string;
+            /** @description Timestamp ISO de publicação. */
+            time: string;
+            /** @description Linha editorial. */
+            tag?: string | null;
+            category?: string | null;
+            title: string;
+            /** @description Por que a notícia importa p/ quem investe. */
+            why?: string | null;
+            /** @description Papéis/temas impactados. */
+            impact?: string[];
+            source?: string | null;
+            /** @description Destaque do dia. */
+            hot?: boolean | null;
+        };
+        NewsEdition: {
+            /** @description Data da edição (AAAA-MM-DD). */
+            date: string;
+            /** @description Período: pre_abertura | intraday | fechamento. */
+            slot?: string | null;
+            /** @description Resumo do dia. */
+            summary?: string | null;
+            /** @description Humor de mercado (ex.: otimista, cauteloso). */
+            mood?: string | null;
+            moodNote?: string | null;
+            /** @description Tiles de mercado assados na edição (índices etc.). */
+            nowTiles?: Record<string, never>[];
+            agenda?: Record<string, never>[];
+            watch?: Record<string, never>[];
+            items: components["schemas"]["NewsItem"][];
+        };
+        NewsEditionEnvelope: {
+            edition: components["schemas"]["NewsEdition"];
+        };
+        NewsDatesResponse: {
+            dates: {
+                date: string;
+                slots: string[];
+            }[];
+        };
+        NewsFeedResponse: {
+            items: (components["schemas"]["NewsItem"] & {
+                rankContext?: {
+                    position?: number;
+                    score?: number;
+                };
+            })[];
+            /** @description Passe em ?cursor= p/ a próxima página. Ausente na última. */
+            nextCursor?: string | null;
+        };
+        NewsItemEnvelope: {
+            item: components["schemas"]["NewsItem"] & {
+                /** @description Corpo completo do item. */
+                body?: string | null;
+                sources?: {
+                    label: string;
+                    href: string;
+                }[];
+            };
+            related: components["schemas"]["NewsItem"][];
+        };
+        /** @description Uma story: um anel temático com cartões encadeados. */
+        NewsStory: {
+            id?: string;
+            kind?: string | null;
+            /** @description Selo curto (ex.: B3, M, R). */
+            mark?: string | null;
+            /** @description Rótulo do anel (ex.: Hoje na bolsa, Macro, Radar). */
+            ring?: string | null;
+            /** @description Cartões da story (cover/news/stat/list…). */
+            cards: Record<string, never>[];
+            /** @description ISO da geração. */
+            generatedAt?: string;
+        };
+        NewsStoriesResponse: {
+            stories: components["schemas"]["NewsStory"][];
+        };
+        NewsAgendaResponse: {
+            /** @description Proventos com data-ex próxima. */
+            mercado: {
+                date: string;
+                day?: string;
+                ticker: string;
+                name?: string | null;
+                /** @description Dividendo | JCP | Rendimento. */
+                kind: string;
+                unit?: string | null;
+                perShare?: number | null;
+                status?: string | null;
+            }[];
+            macro: {
+                when?: string;
+                what?: string;
+                why?: string;
+                tag?: string;
+            }[];
+            /** @description Calendário forward de divulgação de resultados. */
+            resultados: {
+                date?: string;
+                day?: string;
+                publishDate: string;
+                ticker: string;
+                name?: string | null;
+                /** @description previsto | confirmado. */
+                status: string;
+            }[];
+        };
     };
     responses: never;
     parameters: never;
@@ -3666,22 +4050,25 @@ export interface operations {
             };
         };
     };
-    getPortfolio: {
+    getNewsEdition: {
         parameters: {
-            query?: never;
+            query?: {
+                /** @description Data da edição (AAAA-MM-DD). Omita p/ a mais recente. */
+                date?: string;
+            };
             header?: never;
             path?: never;
             cookie?: never;
         };
         requestBody?: never;
         responses: {
-            /** @description Carteira consolidada do usuário. */
+            /** @description Edição publicada + itens. */
             200: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["PortfolioContext"];
+                    "application/json": components["schemas"]["NewsEditionEnvelope"];
                 };
             };
             /** @description Erro (RFC 9457 application/problem+json) */
@@ -3695,7 +4082,7 @@ export interface operations {
             };
         };
     };
-    getSuitability: {
+    listNewsDates: {
         parameters: {
             query?: never;
             header?: never;
@@ -3704,13 +4091,13 @@ export interface operations {
         };
         requestBody?: never;
         responses: {
-            /** @description Perfil de investidor do usuário (ou nulo). */
+            /** @description Datas + slots. */
             200: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["SuitabilityEnvelope"];
+                    "application/json": components["schemas"]["NewsDatesResponse"];
                 };
             };
             /** @description Erro (RFC 9457 application/problem+json) */
@@ -3724,21 +4111,15 @@ export interface operations {
             };
         };
     };
-    searchDocuments: {
+    listNewsFeed: {
         parameters: {
-            query: {
-                /** @description Termo/pergunta em linguagem natural. */
-                q: string;
-                /** @description Filtra por papéis (CSV), ex.: PETR4,PRIO3. */
-                tickers?: string;
-                /** @description Categoria do documento, ex.: Fato Relevante. */
-                category?: string;
-                /** @description Ano de referência do documento (AAAA). */
-                year?: number;
-                /** @description Restringe a trechos de tabela (fatos numéricos). */
-                tables_only?: boolean;
-                /** @description Máximo de trechos (1–25, default 8). */
+            query?: {
+                /** @description Itens por página (1–50, default 20). */
                 limit?: number;
+                /** @description Offset de paginação (do `nextCursor` anterior). */
+                cursor?: string;
+                /** @description Filtra por categoria/linha editorial. */
+                category?: string;
             };
             header?: never;
             path?: never;
@@ -3746,13 +4127,479 @@ export interface operations {
         };
         requestBody?: never;
         responses: {
-            /** @description Trechos relevantes + bloco de contexto com citação. */
+            /** @description Página de itens + `nextCursor`. */
             200: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["DocumentSearchResponse"];
+                    "application/json": components["schemas"]["NewsFeedResponse"];
+                };
+            };
+            /** @description Erro (RFC 9457 application/problem+json) */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": Record<string, never>;
+                };
+            };
+        };
+    };
+    getNewsItem: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Slug do item (do campo `slug` do feed/edição). */
+                slug: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Item + relacionadas. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["NewsItemEnvelope"];
+                };
+            };
+            /** @description Erro (RFC 9457 application/problem+json) */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": Record<string, never>;
+                };
+            };
+        };
+    };
+    listNewsStories: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Stories do dia. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["NewsStoriesResponse"];
+                };
+            };
+            /** @description Erro (RFC 9457 application/problem+json) */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": Record<string, never>;
+                };
+            };
+        };
+    };
+    getNewsAgenda: {
+        parameters: {
+            query?: {
+                /** @description Janela em dias (1–90, default 30). */
+                days?: number;
+            };
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Agenda consolidada. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["NewsAgendaResponse"];
+                };
+            };
+            /** @description Erro (RFC 9457 application/problem+json) */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": Record<string, never>;
+                };
+            };
+        };
+    };
+    getPortfolio: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Carteira consolidada do usuário. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["PortfolioContext"];
+                };
+            };
+            /** @description Erro (RFC 9457 application/problem+json) */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": Record<string, never>;
+                };
+            };
+        };
+    };
+    getSuitability: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Perfil de investidor do usuário (ou nulo). */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["SuitabilityEnvelope"];
+                };
+            };
+            /** @description Erro (RFC 9457 application/problem+json) */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": Record<string, never>;
+                };
+            };
+        };
+    };
+    searchDocuments: {
+        parameters: {
+            query: {
+                /** @description Termo/pergunta em linguagem natural. */
+                q: string;
+                /** @description Filtra por papéis (CSV), ex.: PETR4,PRIO3. */
+                tickers?: string;
+                /** @description Categoria do documento, ex.: Fato Relevante. */
+                category?: string;
+                /** @description Ano de referência do documento (AAAA). */
+                year?: number;
+                /** @description Restringe a trechos de tabela (fatos numéricos). */
+                tables_only?: boolean;
+                /** @description Máximo de trechos (1–25, default 8). */
+                limit?: number;
+            };
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Trechos relevantes + bloco de contexto com citação. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["DocumentSearchResponse"];
+                };
+            };
+            /** @description Erro (RFC 9457 application/problem+json) */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": Record<string, never>;
+                };
+            };
+        };
+    };
+    listCommunityBots: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Bots da conta. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        bots?: components["schemas"]["CommunityBot"][];
+                    };
+                };
+            };
+            /** @description Erro (RFC 9457 application/problem+json) */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": Record<string, never>;
+                };
+            };
+        };
+    };
+    registerCommunityBot: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": {
+                    /** @description Handle público do bot (^[a-z0-9_.]{3,20}$). */
+                    handle: string;
+                    /** @description Nome de exibição. */
+                    display_name: string;
+                    /** @description Bio curta (opcional, até 280 caracteres). */
+                    bio?: string;
+                };
+            };
+        };
+        responses: {
+            /** @description Bot registrado. */
+            201: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        bot?: components["schemas"]["CommunityBot"];
+                    };
+                };
+            };
+            /** @description Erro (RFC 9457 application/problem+json) */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": Record<string, never>;
+                };
+            };
+        };
+    };
+    deleteCommunityBot: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                handle: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Bot desativado. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        ok?: boolean;
+                    };
+                };
+            };
+            /** @description Erro (RFC 9457 application/problem+json) */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": Record<string, never>;
+                };
+            };
+        };
+    };
+    createCommunityBotPost: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                handle: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": {
+                    /** @description Texto do post (12–2000 caracteres). */
+                    body: string;
+                    /** @description Título opcional (formato pergunta/destaque). */
+                    title?: string;
+                    /** @description Ativo principal do post (ex.: PETR4, MXRF11). */
+                    ticker?: string;
+                    /**
+                     * @description Tipo do ativo principal.
+                     * @enum {string}
+                     */
+                    asset_type?: "stock" | "fii";
+                };
+            };
+        };
+        responses: {
+            /** @description Post publicado. */
+            201: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        item?: components["schemas"]["CommunityItem"];
+                        moderation?: string;
+                    };
+                };
+            };
+            /** @description Erro (RFC 9457 application/problem+json) */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": Record<string, never>;
+                };
+            };
+        };
+    };
+    createCommunityBotReply: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                handle: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": {
+                    /** @description ID do post a responder. */
+                    post_id: string;
+                    /** @description Texto da resposta (12–2000 caracteres). */
+                    body: string;
+                };
+            };
+        };
+        responses: {
+            /** @description Resposta publicada. */
+            201: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        reply?: Record<string, never>;
+                        moderation?: string;
+                    };
+                };
+            };
+            /** @description Erro (RFC 9457 application/problem+json) */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": Record<string, never>;
+                };
+            };
+        };
+    };
+    getCommunityFeed: {
+        parameters: {
+            query?: {
+                /** @description recentes (default) ou alta. */
+                tab?: "recentes" | "alta";
+                /** @description Filtra posts do ativo (ex.: PETR4). */
+                ticker?: string;
+                /** @description Busca por texto. */
+                q?: string;
+                /** @description Cursor de paginação (next_cursor da página anterior). */
+                cursor?: string;
+            };
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Página do feed. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        items?: components["schemas"]["CommunityItem"][];
+                        next_cursor?: string | null;
+                    };
+                };
+            };
+            /** @description Erro (RFC 9457 application/problem+json) */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": Record<string, never>;
+                };
+            };
+        };
+    };
+    getCommunityPost: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Post + respostas. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        item?: components["schemas"]["CommunityItem"];
+                    };
                 };
             };
             /** @description Erro (RFC 9457 application/problem+json) */

package/dist/types.d.ts

@@ -106,6 +106,46 @@ export type IntradaySeriesResponse = Ok<"getStockIntraday">;
 export type PortfolioResponse = Ok<"getPortfolio">;
 export type SuitabilityResponse = Ok<"getSuitability">;
 export type DocumentSearchResponse = Ok<"searchDocuments">;
+/** Corpo JSON da resposta 201 (criação) de uma operação do contrato. */
+export type Created<Op extends keyof operations> = operations[Op] extends {
+    responses: {
+        201: {
+            content: {
+                "application/json": infer T;
+            };
+        };
+    };
+} ? T : never;
+export type CommunityBot = Schemas["CommunityBot"];
+export type CommunityItem = Schemas["CommunityItem"];
+export type CommunityBotsResponse = Ok<"listCommunityBots">;
+export type CommunityFeedResponse = Ok<"getCommunityFeed">;
+export type CommunityPostResponse = Ok<"getCommunityPost">;
+export type RegisterCommunityBotResponse = Created<"registerCommunityBot">;
+export type CommunityBotPostResponse = Created<"createCommunityBotPost">;
+export type CommunityBotReplyResponse = Created<"createCommunityBotReply">;
+/** Registro de um bot de comunidade — `POST /v1/community/bots`. */
+export interface RegisterCommunityBotInput {
+    /** Handle público (^[a-z0-9_.]{3,20}$). */
+    handle: string;
+    displayName: string;
+    bio?: string;
+}
+/** Publicação como bot — `POST /v1/community/bots/{handle}/posts`. */
+export interface CommunityBotPostInput {
+    /** Texto do post (12–2000 caracteres; cashtags $PETR4 viram links). */
+    body: string;
+    title?: string;
+    ticker?: string;
+    assetType?: "stock" | "fii";
+}
+/** Filtros do feed — `GET /v1/community/feed`. */
+export interface CommunityFeedParams {
+    tab?: "recentes" | "alta";
+    ticker?: string;
+    q?: string;
+    cursor?: string;
+}
 /** Filtros da busca semântica de documentos — `GET /v1/documents/search`. */
 export interface SearchDocumentsParams {
     /** Papéis a filtrar; array serializado em CSV pelo HttpClient. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@databolsa/sdk",
-  "version": "1.0.8",
+  "version": "1.0.10",
   "license": "Apache-2.0",
   "type": "module",
   "description": "SDK TypeScript tipado para a Serving API pública do DataBolsa, gerado a partir do contrato OpenAPI.",