@databolsa/sdk 1.0.12 → 1.0.14

package/dist/client.d.ts

@@ -1,4 +1,4 @@
-import type { CorporateEventsResponse, CryptoAsset, CryptoListResponse, CryptoLiveResponse, CryptoQuotesResponse, UsAssetsResponse, UsAssetDetail, UsQuotesResponse, UsFilingsResponse, 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, AddPortfolioTransactionResponse, CreatePortfolioResponse, PortfolioAssetRef, PortfolioDetail, PortfolioHistoryResponse, PortfolioImportInput, PortfolioImportRowsResponse, PortfolioImportsResponse, PortfolioImportSummary, PortfolioPatch, PortfolioRfContract, PortfolioTransaction, PortfolioTransactionInput, PortfolioTransactionPatch, PortfoliosResponse, PortfolioTransactionsResponse } from "./types";
+import type { CorporateEventsResponse, CryptoAsset, CryptoListResponse, CryptoLiveResponse, CryptoQuotesResponse, UsAssetsResponse, UsAssetDetail, UsQuotesResponse, UsFilingsResponse, 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, AddPortfolioTransactionResponse, CreatePortfolioResponse, PortfolioAssetRef, PortfolioDetail, PortfolioHistoryResponse, PortfolioImportInput, PortfolioImportRowsResponse, PortfolioImportsResponse, PortfolioImportSummary, PortfolioPatch, PortfolioRfContract, PortfolioTransaction, PortfolioTransactionInput, PortfolioTransactionPatch, PortfoliosResponse, PortfolioTransactionsResponse, ThesesResponse, ThesisResponse, CreateThesisResponse, ThesisExportStatus, ThesisWriteInput } from "./types";
 /** Filtros do screener de ações — derivados de `GET /v1/screener/stocks`. */
 export type ScreenStocksParams = Query<"screenStocks">;
 /**
@@ -238,6 +238,29 @@ export interface DataBolsaClient {
     deletePortfolio(id: string): Promise<{
         deleted?: boolean;
     }>;
+    /** Lista as suas teses (resumo + limite do plano). */
+    listMyTheses(): Promise<ThesesResponse>;
+    /** Cria uma tese a partir de um ReportDoc (validado no servidor; 402 no teto do plano). */
+    createThesis(input: ThesisWriteInput): Promise<CreateThesisResponse>;
+    /** Cria uma tese enviando o arquivo JSON do doc em base64 (caminho do CLI `--file`). */
+    importThesisFile(input: {
+        filename?: string;
+        contentBase64: string;
+        visibility?: "private" | "unlisted" | "public";
+        showPersonal?: boolean;
+    }): Promise<CreateThesisResponse>;
+    /** Documento completo + status do export. */
+    getThesis(id: string): Promise<ThesisResponse>;
+    /** Atualiza doc e/ou visibilidade. */
+    updateThesis(id: string, patch: Partial<ThesisWriteInput>): Promise<ThesisResponse>;
+    /** APAGA a tese (irreversível). */
+    deleteThesis(id: string): Promise<{
+        deleted?: boolean;
+    }>;
+    /** Muda a visibilidade (public aparece no perfil; seções pessoais redigidas por default). */
+    publishThesis(id: string, visibility: "private" | "unlisted" | "public", showPersonal?: boolean): Promise<ThesisResponse>;
+    /** Exporta em PDF (plano pago): 202 queued ou 200 ready com o link. */
+    exportThesis(id: string): Promise<ThesisExportStatus>;
     /** Histórico mensal de UMA carteira. */
     getPortfolioHistoryById(id: string): Promise<PortfolioHistoryResponse>;
     /** Adiciona um ativo à carteira (idempotente; sem transações = watchlist). */

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 { AddPortfolioTransactionResponse, CreatePortfolioResponse, PortfolioAssetRef, PortfolioDetail, PortfolioHistoryResponse, PortfolioImportInput, PortfolioImportRowsResponse, PortfolioImportsResponse, PortfolioImportSummary, PortfolioPatch, PortfolioRfContract, PortfolioTransaction, PortfolioTransactionInput, PortfolioTransactionPatch, PortfoliosResponse, PortfolioTransactionsResponse, CorporateEventsResponse, CryptoAsset, CryptoListResponse, CryptoLiveResponse, CryptoQuotesResponse, UsAssetsResponse, UsAssetDetail, UsQuotesResponse, UsFilingsResponse, 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";
+import type { AddPortfolioTransactionResponse, CreatePortfolioResponse, PortfolioAssetRef, PortfolioDetail, PortfolioHistoryResponse, PortfolioImportInput, PortfolioImportRowsResponse, PortfolioImportsResponse, PortfolioImportSummary, PortfolioPatch, PortfolioRfContract, PortfolioTransaction, PortfolioTransactionInput, PortfolioTransactionPatch, PortfoliosResponse, PortfolioTransactionsResponse, CorporateEventsResponse, CryptoAsset, CryptoListResponse, CryptoLiveResponse, CryptoQuotesResponse, UsAssetsResponse, UsAssetDetail, UsQuotesResponse, UsFilingsResponse, 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, ThesesResponse, ThesisResponse, CreateThesisResponse, ThesisExportStatus, ThesisWriteInput } from "./types";
 /**
  * Cliente HTTP da Serving API do DataBolsa. Os métodos públicos espelham os
  * operationIds do OpenAPI e retornam tipos gerados.
@@ -207,6 +207,21 @@ export declare class HttpClient implements DataBolsaClient {
     deletePortfolio(id: string): Promise<{
         deleted?: boolean;
     }>;
+    listMyTheses(): Promise<ThesesResponse>;
+    createThesis(input: ThesisWriteInput): Promise<CreateThesisResponse>;
+    importThesisFile(input: {
+        filename?: string;
+        contentBase64: string;
+        visibility?: "private" | "unlisted" | "public";
+        showPersonal?: boolean;
+    }): Promise<CreateThesisResponse>;
+    getThesis(id: string): Promise<ThesisResponse>;
+    updateThesis(id: string, patch: Partial<ThesisWriteInput>): Promise<ThesisResponse>;
+    deleteThesis(id: string): Promise<{
+        deleted?: boolean;
+    }>;
+    publishThesis(id: string, visibility: "private" | "unlisted" | "public", showPersonal?: boolean): Promise<ThesisResponse>;
+    exportThesis(id: string): Promise<ThesisExportStatus>;
     getPortfolioHistoryById(id: string): Promise<PortfolioHistoryResponse>;
     addPortfolioAsset(id: string, asset: PortfolioAssetRef): Promise<unknown>;
     removePortfolioAsset(id: string, asset: PortfolioAssetRef): Promise<unknown>;

package/dist/index.js

@@ -494,6 +494,42 @@ class HttpClient {
   deletePortfolio(id) {
     return this.request(`/portfolios/${enc(id)}`, undefined, { method: "DELETE" });
   }
+  listMyTheses() {
+    return this.request("/theses");
+  }
+  createThesis(input) {
+    return this.request("/theses", undefined, {
+      method: "POST",
+      body: { doc: input.doc, visibility: input.visibility, show_personal: input.showPersonal }
+    });
+  }
+  importThesisFile(input) {
+    return this.request("/theses/import", undefined, {
+      method: "POST",
+      body: { filename: input.filename, content_base64: input.contentBase64, visibility: input.visibility, show_personal: input.showPersonal }
+    });
+  }
+  getThesis(id) {
+    return this.request(`/theses/${enc(id)}`);
+  }
+  updateThesis(id, patch) {
+    return this.request(`/theses/${enc(id)}`, undefined, {
+      method: "PUT",
+      body: { doc: patch.doc, visibility: patch.visibility, show_personal: patch.showPersonal }
+    });
+  }
+  deleteThesis(id) {
+    return this.request(`/theses/${enc(id)}`, undefined, { method: "DELETE" });
+  }
+  publishThesis(id, visibility, showPersonal) {
+    return this.request(`/theses/${enc(id)}/publish`, undefined, {
+      method: "POST",
+      body: { visibility, show_personal: showPersonal }
+    });
+  }
+  exportThesis(id) {
+    return this.request(`/theses/${enc(id)}/export`, undefined, { method: "POST", body: {} });
+  }
   getPortfolioHistoryById(id) {
     return this.request(`/portfolios/${enc(id)}/history`);
   }

package/dist/schema.d.ts

@@ -1628,6 +1628,115 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/v1/theses": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Minhas teses
+         * @description Lista as teses do dono da chave (resumo: título, ticker, visibilidade, status de export) e o teto do plano. O documento completo vem no getThesis.
+         */
+        get: operations["listMyTheses"];
+        put?: never;
+        /**
+         * Criar tese
+         * @description Cria uma tese a partir de um documento de report estruturado (`doc`). O doc é validado no servidor contra o schema de reports (seções → blocos: cover, rating, summary, keyStats, prose, chart, table, callout, scenarios, sources, disclaimer…); erros voltam com o caminho do campo. Título/ticker/tipo são derivados do próprio doc. Respeita o limite de teses do plano (402 plan_required ao estourar).
+         */
+        post: operations["createThesis"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/theses/import": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Importar tese de arquivo JSON
+         * @description Cria uma tese enviando o ARQUIVO JSON do documento em base64 (`content_base64`) — o caminho natural para CLI e automações (`--file tese.json`). Mesma validação e limites do createThesis.
+         */
+        post: operations["importThesisFile"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/theses/{id}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Detalhe de uma tese
+         * @description Documento completo + visibilidade + status do export (quando `ready`, `pdfUrl`/`previewUrl` apontam para a mídia pública).
+         */
+        get: operations["getThesis"];
+        /**
+         * Atualizar tese
+         * @description Atualiza o documento e/ou a visibilidade. O doc, quando enviado, passa pela mesma validação do create.
+         */
+        put: operations["updateThesis"];
+        post?: never;
+        /** Excluir tese */
+        delete: operations["deleteThesis"];
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/theses/{id}/publish": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Publicar / mudar visibilidade
+         * @description Define a visibilidade: `public` aparece no perfil e tem página própria; `unlisted` só por link; `private` volta a ser só sua. Por default as seções pessoais (posição, preço médio, P&L) são REMOVIDAS da leitura pública — `show_personal: true` as exibe (opt-in).
+         */
+        post: operations["publishThesis"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/theses/{id}/export": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Exportar em PDF (plano pago)
+         * @description Gera o PDF (A4, com preview PNG) da tese e publica num link público de mídia. Assíncrono: responde 202 {status: queued} e o getThesis passa a devolver `pdfUrl` quando pronto; se o conteúdo não mudou desde o último export, responde 200 direto com o link. Exporta a MESMA visão do link compartilhado (seções pessoais redigidas, salvo show_personal).
+         */
+        post: operations["exportThesis"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
 }
 export type webhooks = Record<string, never>;
 export interface components {
@@ -2298,6 +2407,40 @@ export interface components {
             rows: number;
             duration_s: number | null;
         };
+        ThesisSummary: {
+            id?: string;
+            /** @description Slug estável por usuário — compõe a URL pública /teses/{handle}/{slug}. */
+            slug?: string;
+            title?: string;
+            subtitle?: string | null;
+            ticker?: string | null;
+            /** @description equity | fii | macro | setor | carta | carteira */
+            kind?: string;
+            /** @enum {string} */
+            visibility?: "private" | "unlisted" | "public";
+            showPersonal?: boolean;
+            /** @description idle | queued | processing | ready | failed */
+            exportStatus?: string;
+            pdfUrl?: string | null;
+            previewUrl?: string | null;
+            publishedAt?: string | null;
+            createdAt?: string;
+            updatedAt?: string;
+        };
+        ThesisDetail: components["schemas"]["ThesisSummary"] & {
+            doc?: components["schemas"]["ReportDocInput"];
+            exportError?: string | null;
+        };
+        ThesisExportStatus: {
+            /** @enum {string} */
+            status?: "ready" | "queued";
+            pdfUrl?: string;
+            previewUrl?: string;
+        };
+        /** @description Documento de report estruturado (JSON): { id, kind, title, subtitle?, date, authors[], ticker?, tags?, sections[] } onde cada section tem { id, title?, blocks[] } e cada block é um dos tipos cover, rating, summary, keyStats, prose (markdown), chart, table, callout, scenarios, quote, figure, columns, sources, disclaimer ou pageBreak. Validado integralmente no servidor; erros voltam com o caminho do campo violado. */
+        ReportDocInput: {
+            [key: string]: unknown;
+        };
         CommunityBot: {
             id?: string;
             handle?: string;
@@ -2327,6 +2470,14 @@ export interface components {
             views?: number;
             replyCount?: number;
             replies?: Record<string, never>[];
+            /** @description Cashtags do texto com tipo resolvido no servidor (ausente em posts antigos). */
+            cashtags?: {
+                symbol: string;
+                /** @description stock | fii | index | crypto | us */
+                kind: string;
+                /** @description Rota da página do ativo no site. */
+                href: string;
+            }[];
         };
         PortfolioHolding: {
             symbol: string;
@@ -2361,7 +2512,7 @@ export interface components {
             unrealizedPL?: number;
             unrealizedPct?: number;
             realizedPL?: number;
-            /** @description Posições com qty, preço médio, valor de mercado, P&L, proventos e peso. */
+            /** @description Posições com qty, preço médio, valor de mercado, P&L, proventos e peso. Valores monetários sempre em BRL; ativos em moeda estrangeira (asset_type=us) expõem também currency, priceNative (US$) e fxRate. */
             holdings?: Record<string, never>[];
         };
         PortfolioTransaction: {
@@ -5367,7 +5518,7 @@ export interface operations {
                      * @description Tipo do ativo.
                      * @enum {string}
                      */
-                    asset_type: "stock" | "fii" | "bdr" | "index" | "tesouro" | "crypto" | "option" | "renda_fixa";
+                    asset_type: "stock" | "fii" | "bdr" | "index" | "tesouro" | "crypto" | "option" | "renda_fixa" | "us";
                     /** @description Ticker (ex.: PETR4) ou nome oficial do título do Tesouro. */
                     symbol: string;
                 };
@@ -5398,7 +5549,7 @@ export interface operations {
         parameters: {
             query: {
                 /** @description Tipo do ativo. */
-                asset_type: "stock" | "fii" | "bdr" | "index" | "tesouro" | "crypto" | "option" | "renda_fixa";
+                asset_type: "stock" | "fii" | "bdr" | "index" | "tesouro" | "crypto" | "option" | "renda_fixa" | "us";
                 /** @description Ticker ou nome do título. */
                 symbol: string;
             };
@@ -5536,7 +5687,7 @@ export interface operations {
                      * @description Tipo do ativo.
                      * @enum {string}
                      */
-                    asset_type: "stock" | "fii" | "bdr" | "index" | "tesouro" | "crypto" | "option" | "renda_fixa";
+                    asset_type: "stock" | "fii" | "bdr" | "index" | "tesouro" | "crypto" | "option" | "renda_fixa" | "us";
                     /** @description Ticker (ex.: PETR4) ou nome oficial do título do Tesouro. */
                     symbol: string;
                     /**
@@ -6038,7 +6189,7 @@ export interface operations {
                      * @description Tipo do ativo principal.
                      * @enum {string}
                      */
-                    asset_type?: "stock" | "fii";
+                    asset_type?: "stock" | "fii" | "crypto" | "us";
                 };
             };
         };
@@ -6183,4 +6334,312 @@ export interface operations {
             };
         };
     };
+    listMyTheses: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Teses + limite do plano (null = ilimitado). */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        theses?: components["schemas"]["ThesisSummary"][];
+                        limit?: number | null;
+                    };
+                };
+            };
+            /** @description Erro (RFC 9457 application/problem+json) */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": Record<string, never>;
+                };
+            };
+        };
+    };
+    createThesis: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": {
+                    doc: components["schemas"]["ReportDocInput"];
+                    /**
+                     * @description Default: private.
+                     * @enum {string}
+                     */
+                    visibility?: "private" | "unlisted" | "public";
+                    /** @description Exibir seções pessoais (minha-posicao) na leitura pública. Default: false (redigidas). */
+                    show_personal?: boolean;
+                };
+            };
+        };
+        responses: {
+            /** @description Tese criada. */
+            201: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        thesis?: components["schemas"]["ThesisDetail"];
+                    };
+                };
+            };
+            /** @description Erro (RFC 9457 application/problem+json) */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": Record<string, never>;
+                };
+            };
+        };
+    };
+    importThesisFile: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": {
+                    /** @description Nome do arquivo (informativo). */
+                    filename?: string;
+                    /** @description JSON do ReportDoc codificado em base64. */
+                    content_base64: string;
+                    /** @enum {string} */
+                    visibility?: "private" | "unlisted" | "public";
+                    show_personal?: boolean;
+                };
+            };
+        };
+        responses: {
+            /** @description Tese criada. */
+            201: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        thesis?: components["schemas"]["ThesisDetail"];
+                    };
+                };
+            };
+            /** @description Erro (RFC 9457 application/problem+json) */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": Record<string, never>;
+                };
+            };
+        };
+    };
+    getThesis: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Tese. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        thesis?: components["schemas"]["ThesisDetail"];
+                    };
+                };
+            };
+            /** @description Erro (RFC 9457 application/problem+json) */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": Record<string, never>;
+                };
+            };
+        };
+    };
+    updateThesis: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                id: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": {
+                    doc?: components["schemas"]["ReportDocInput"];
+                    /** @enum {string} */
+                    visibility?: "private" | "unlisted" | "public";
+                    show_personal?: boolean;
+                };
+            };
+        };
+        responses: {
+            /** @description Tese atualizada. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        thesis?: components["schemas"]["ThesisDetail"];
+                    };
+                };
+            };
+            /** @description Erro (RFC 9457 application/problem+json) */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": Record<string, never>;
+                };
+            };
+        };
+    };
+    deleteThesis: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Excluída. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        deleted?: boolean;
+                    };
+                };
+            };
+            /** @description Erro (RFC 9457 application/problem+json) */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": Record<string, never>;
+                };
+            };
+        };
+    };
+    publishThesis: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                id: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": {
+                    /** @enum {string} */
+                    visibility: "private" | "unlisted" | "public";
+                    show_personal?: boolean;
+                };
+            };
+        };
+        responses: {
+            /** @description Visibilidade atualizada. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        thesis?: components["schemas"]["ThesisDetail"];
+                    };
+                };
+            };
+            /** @description Erro (RFC 9457 application/problem+json) */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": Record<string, never>;
+                };
+            };
+        };
+    };
+    exportThesis: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Já exportada (conteúdo inalterado). */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ThesisExportStatus"];
+                };
+            };
+            /** @description Export enfileirado. */
+            202: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ThesisExportStatus"];
+                };
+            };
+            /** @description Erro (RFC 9457 application/problem+json) */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": Record<string, never>;
+                };
+            };
+        };
+    };
 }

package/dist/types.d.ts

@@ -140,11 +140,11 @@ export interface RegisterCommunityBotInput {
 }
 /** Publicação como bot — `POST /v1/community/bots/{handle}/posts`. */
 export interface CommunityBotPostInput {
-    /** Texto do post (12–2000 caracteres; cashtags $PETR4 viram links). */
+    /** Texto do post (12–2000 caracteres; cashtags $PETR4, $BTC, $AAPL viram links). */
     body: string;
     title?: string;
     ticker?: string;
-    assetType?: "stock" | "fii";
+    assetType?: "stock" | "fii" | "crypto" | "us";
 }
 /** Filtros do feed — `GET /v1/community/feed`. */
 export interface CommunityFeedParams {
@@ -164,10 +164,22 @@ export type PortfolioImportRowsResponse = Ok<"listPortfolioImportRows">;
 export type CreatePortfolioResponse = Created<"createPortfolio">;
 export type AddPortfolioTransactionResponse = Created<"addPortfolioTransaction">;
 export type PortfolioImportSummary = Schemas["PortfolioImportSummary"];
+export type ThesisSummary = Schemas["ThesisSummary"];
+export type ThesisDetail = Schemas["ThesisDetail"];
+export type ThesesResponse = Ok<"listMyTheses">;
+export type ThesisResponse = Ok<"getThesis">;
+export type CreateThesisResponse = Created<"createThesis">;
+export type ThesisExportStatus = Schemas["ThesisExportStatus"];
+export interface ThesisWriteInput {
+    /** O ReportDoc completo (JSON) — validado no servidor. */
+    doc: Record<string, unknown>;
+    visibility?: "private" | "unlisted" | "public";
+    showPersonal?: boolean;
+}
 /** Referência de ativo dentro de uma carteira (chave natural). */
 export interface PortfolioAssetRef {
-    assetType: "stock" | "fii" | "bdr" | "index" | "tesouro" | "crypto" | "option" | "renda_fixa";
-    /** Ticker (PETR4) ou, para Tesouro, o nome oficial do título. */
+    assetType: "stock" | "fii" | "bdr" | "index" | "tesouro" | "crypto" | "option" | "renda_fixa" | "us";
+    /** Ticker (PETR4, AAPL) ou, para Tesouro, o nome oficial do título. */
     symbol: string;
 }
 /** Campos de uma transação — `POST /v1/portfolios/{id}/transactions`. */
@@ -177,7 +189,7 @@ export interface PortfolioTransactionInput {
     tradeDate: string;
     /** Obrigatória em buy/sell (> 0). */
     quantity?: number;
-    /** Preço unitário em BRL (omita se desconhecido). */
+    /** Preço unitário na moeda de negociação do ativo: BRL, ou USD para asset_type=us (omita se desconhecido). */
     price?: number | null;
     fees?: number;
     /** Fator do split (2 = 2:1; 0.5 = grupamento 1:2). */

package/package.json

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