sentisense 0.35.0 → 0.36.0

package/dist/index.d.mts

@@ -839,6 +839,110 @@ interface GetEarningsCalendarOptions {
     /** Session filter. */
     time?: "before_open" | "after_close" | "during_market" | "unknown";
 }
+/**
+ * One KPI card on a reported quarter.
+ *
+ * `value` and `yoy` are display strings, already formatted (`"$109.4B"`,
+ * `"+16% YoY"`), not numbers to compute with. `yoy` is absent when the quarter
+ * carries no year-over-year comparison for that line, which is common on
+ * call highlights.
+ */
+interface EarningsKpiHighlight {
+    label: string;
+    value: string;
+    yoy?: string;
+}
+/** A citation backing a reported quarter. */
+interface EarningsSource {
+    title: string;
+    url: string;
+}
+/**
+ * One fiscal quarter of the earnings analysis report, from
+ * `client.earnings.getSummaries()`.
+ *
+ * The wire shape depends on the caller's tier, so branch on the envelope's
+ * `isPreview` rather than on field presence. `fiscalPeriod`, `reportDate`,
+ * `headline`, `hasTranscript`, `generatedAt` and `source` arrive on both tiers.
+ *
+ * PRO adds the bodies: `summaryMd`, the full `kpiHighlights`, `guidance`,
+ * `transcriptSummaryMd`, `transcriptHighlights`, `transcriptGeneratedAt` and
+ * `sources`.
+ *
+ * The FREE preview replaces those bodies with shape: up to two `kpiHighlights`
+ * cards (without `yoy`) plus `kpiHighlightCount`, the section titles in
+ * `summaryTopics` and `transcriptTopics`, and `hasGuidance` with
+ * `guidanceDirection` in place of the guidance language. It never carries a
+ * body, a KPI history, or a guidance figure.
+ *
+ * Absence is explicit: a quarter with no call summary sets `hasTranscript` to
+ * `false` rather than dropping the concept, so a client can say "no call
+ * summary yet" instead of rendering nothing.
+ */
+interface EarningsQuarter {
+    /** Display fiscal period, e.g. `"Q2 FY2026"`. */
+    fiscalPeriod: string;
+    /** Date the results were reported, ISO calendar day `"YYYY-MM-DD"`. */
+    reportDate: string;
+    /** One-line editorial summary of the quarter. */
+    headline: string;
+    /** True when a summary of the earnings call exists for this quarter. */
+    hasTranscript: boolean;
+    /** When the quarter summary was generated, epoch seconds. */
+    generatedAt: number;
+    /** Provenance of the quarter summary. */
+    source: "press_release" | "transcript";
+    /** PRO: markdown body summarizing the reported results. */
+    summaryMd?: string;
+    /** PRO carries the full set; a preview carries up to two cards without `yoy`. */
+    kpiHighlights?: EarningsKpiHighlight[];
+    /** PRO: forward-guidance language as reported. Absent when the quarter carries none. */
+    guidance?: string;
+    /** PRO: markdown body summarizing the call. Absent when `hasTranscript` is false. */
+    transcriptSummaryMd?: string;
+    /** PRO: call-specific highlights. Absent when there is no call summary. */
+    transcriptHighlights?: EarningsKpiHighlight[];
+    /** PRO: when the call summary was generated, epoch seconds. Can post-date `generatedAt`. */
+    transcriptGeneratedAt?: number;
+    /** PRO: citations backing the quarter. */
+    sources?: EarningsSource[];
+    /** Preview: how many KPI cards the full quarter carries. */
+    kpiHighlightCount?: number;
+    /** Preview: section titles of the summary, never body text. */
+    summaryTopics?: string[];
+    /** Preview: section titles of the call summary, never body text. */
+    transcriptTopics?: string[];
+    /** Preview: whether the quarter carries guidance at all. */
+    hasGuidance?: boolean;
+    /** Preview: the direction only, in place of the guidance language. */
+    guidanceDirection?: "RAISED" | "CUT" | "HELD" | "MIXED" | null;
+}
+/** One company that reported inside the recent window. */
+interface RecentEarningsEntry {
+    ticker: string;
+    /** Display fiscal period, e.g. `"Q2 FY2026"`. */
+    fiscalPeriod: string;
+    /** Date the results were reported, ISO calendar day `"YYYY-MM-DD"`. */
+    reportDate: string;
+    headline: string;
+    /** True when a summary of the earnings call exists for this quarter. */
+    hasTranscriptSummary: boolean;
+    /** Latest content written for this quarter, epoch seconds. */
+    generatedAt: number;
+}
+interface GetEarningsSummariesOptions {
+    /**
+     * Max quarters returned, 1 to 40. Omitted, the API applies its own default
+     * of 12. A FREE key receives one quarter whatever you pass.
+     */
+    limit?: number;
+}
+interface GetRecentEarningsOptions {
+    /** Look-back window in days, 1 to 31. Omitted, the API applies its own default of 7. */
+    days?: number;
+    /** Max rows returned, 1 to 100. Omitted, the API applies its own default of 50. */
+    limit?: number;
+}
 interface PreviewResponse<T> {
     isPreview: boolean;
     previewReason: "PRO_REQUIRED" | null;
@@ -1422,6 +1526,58 @@ declare class Documents {
     getStoriesByTicker(ticker: string, options?: GetStoriesByTickerOptions): Promise<Story[]>;
 }
 
+/**
+ * Earnings: what a company actually reported, after the fact.
+ *
+ * A quarter's results arrive as a press release, a filing, and a call, none of
+ * which is a data structure. {@link getSummaries} is the assembled version, one
+ * object per fiscal quarter, and {@link getRecent} is the cross-ticker view of
+ * who reported lately. Pair them to drive a post-earnings sweep: list the
+ * window, then pull each ticker's analysis report.
+ *
+ * The forward-looking half of the family lives on `client.calendar.getEarnings()`,
+ * which covers scheduled dates and consensus EPS rather than results.
+ *
+ * @see EarningsQuarter
+ */
+declare class Earnings {
+    private client;
+    constructor(client: APIClient);
+    /**
+     * Per-quarter earnings analysis report for one ticker, newest first.
+     *
+     * Each quarter carries the editorial headline, the KPI cards that matter for
+     * that company with year-over-year deltas, the guidance language as
+     * management phrased it, and a summary of the earnings call.
+     *
+     * Branch on `isPreview`: a PRO key receives every hydrated quarter in full, a
+     * FREE key receives the latest quarter shaped rather than truncated, plus
+     * `totalCount`. {@link EarningsQuarter} documents which fields each tier
+     * carries.
+     *
+     * A quarter typically appears within 48 hours of the company reporting, and
+     * the call summary can arrive after the press-release content for the same
+     * quarter, so read `generatedAt` and `transcriptGeneratedAt` rather than
+     * assuming a fixed lag. A ticker with no stored quarter answers with an empty
+     * `data` array, not a 404.
+     *
+     * Use canonical ticker symbols: `GOOGL` (not `GOOG`), `BRK.B` (not `BRK-B`).
+     */
+    getSummaries(ticker: string, options?: GetEarningsSummariesOptions): Promise<PreviewResponse<EarningsQuarter[]>>;
+    /**
+     * Which covered companies reported on or after `today - days`, newest first.
+     *
+     * Every API key receives the full window it asks for, so `isPreview` is
+     * always `false` here. The window is bounded by `reportDate`, so a quarter
+     * reported inside it appears even when its call summary lands later, and an
+     * empty `data` array means nobody in the covered set reported in that window.
+     *
+     * This is the backward-looking feed; `client.calendar.getEarnings()` is the
+     * forward-looking one.
+     */
+    getRecent(options?: GetRecentEarningsOptions): Promise<PreviewResponse<RecentEarningsEntry[]>>;
+}
+
 declare class EntityMetrics {
     private client;
     constructor(client: APIClient);
@@ -1615,7 +1771,7 @@ declare class Insider {
     /**
      * Get market-wide insider activity: top buys and sells aggregated by ticker.
      *
-     * PRO-gated. Free/unauthenticated users receive a preview (top 5 per direction)
+     * PRO-gated. Free-tier users receive a preview (top 5 per direction)
      * with `isPreview: true` in the response.
      */
     getActivity(options?: GetInsiderOptions): Promise<PreviewResponse<InsiderActivityResponse>>;
@@ -1639,7 +1795,7 @@ declare class Politicians {
     /**
      * Get recent congressional STOCK Act trading activity across all politicians.
      *
-     * PRO-gated. Free/unauthenticated users receive a preview (top 5 trades)
+     * PRO-gated. Free-tier users receive a preview (top 5 trades)
      * with `isPreview: true` in the response.
      *
      * The feed is longer than one response: a default 90-day window is routinely well over a
@@ -1734,7 +1890,7 @@ declare class Insights {
     user(options?: GetUserInsightsOptions): Promise<PreviewResponse<Insight[]>>;
     /**
      * Get available insight types for a specific stock.
-     * No authentication required.
+     * API key required.
      *
      * Returns an array of insight type strings (e.g., `["sentiment_shift", "options_activity"]`).
      */
@@ -2048,6 +2204,7 @@ declare class SentiSense implements APIClient {
     readonly indexes: Indexes;
     readonly trackers: Trackers;
     readonly calendar: Calendar;
+    readonly earnings: Earnings;
     constructor(options?: SentiSenseOptions);
     /** @internal */
     get<T = unknown>(path: string, params?: object): Promise<T>;
@@ -2093,6 +2250,6 @@ declare class APIError extends SentiSenseError {
     constructor(message: string, status: number, code?: string);
 }
 
-declare const VERSION = "0.35.0";
+declare const VERSION = "0.36.0";
 
-export { type AISummary, APIError, type AnalystAction, type AnalystConsensus, type AnalystEarningsSurprise, type AnalystEstimate, type AnalystEstimatesResponse, type AssetMetadata, AuthenticationError, type CalendarMeta, type ChartData, type ChartDataPoint, type ClusterBuy, type CompanyKpisData, type CongressTrade, DeepHistoryUnavailableError, type Document, type DocumentSearchResponse, type DocumentSource, type EarningsCalendarResponse, type EarningsEvent, type EtfAggregateCoverage, type EtfAnalystAggregate, type EtfAnalystContributor, type EtfHolding, type EtfHoldings, type EtfInfo, type EtfInsiderAggregate, type EtfInsiderContributor, type EtfSentimentAggregate, type EtfSentimentReading, type FloatInfo, type Fundamentals, type FundamentalsPeriod, type FundamentalsPeriodsResponse, type GetAnalystActionsOptions, type GetAnalystMarketActivityOptions, type GetEarningsCalendarOptions, type GetEtfInsiderAggregateOptions, type GetHoldersOptions, type GetInsiderOptions, type GetInsightsOptions, type GetLatestInsightsOptions, type GetPoliticianActivityOptions, type GetPoliticiansOptions, type GetStockInsightsRangeOptions, type GetUserInsightsOptions, type Holder, type HolderNotableChanges, type IndexConstituent, type IndexHistoryPoint, type IndexHistoryResponse, type IndexListResponse, type IndexListing, type IndexSnapshot, type InsiderActivityResponse, type InsiderActivitySummary, type InsiderTrade, type Insight, type InsightPreviewResponse, type InstitutionList, type InstitutionListResponse, type InstitutionSummary, type InstitutionalFlow, type InstitutionalFlows, type InstitutionalFlowsResponse, type KBEntity, type KpiCoverageEntry, type KpiCoverageResponse, type KpiDataPoint, type KpiSeries, type KpiTypeEntry, type ListInstitutionsOptions, type LockedInsight, type MarketMood, type MarketStatus, type MarketSummary, type MetricDistribution, type MetricDistributionOptions, type MetricType, type MetricsBreakdown, type MetricsOptions, NotFoundError, type PoliticianDetail, type PoliticianSummary, type PreviewResponse, type Quarter, RateLimitError, SentiSense, SentiSenseError, type SentiSenseOptions, type SentimentEntry, type ServingMetric, type ShortInterest, type ShortVolume, type SimilarStock, type StockDetail, type StockEntity, type StockImage, type StockPrice, type StockProfile, type StockQuote, type Story, type StoryCluster, type TickerHolders, type TrackerEvent, type TrackerGeoEntry, type TrackerHeadlineMetric, type TrackerListResponse, type TrackerListing, type TrackerMetricValue, type TrackerSignal, type TrackerSnapshot, type TrackerSnapshotResponse, type TrackerSourceRef, type TrackerTableRow, type TrackerTimeSeriesPoint, type TtmFundamentals, VERSION, type WeightedConsensus, type WeightedNetFlow, SentiSense as default };
+export { type AISummary, APIError, type AnalystAction, type AnalystConsensus, type AnalystEarningsSurprise, type AnalystEstimate, type AnalystEstimatesResponse, type AssetMetadata, AuthenticationError, type CalendarMeta, type ChartData, type ChartDataPoint, type ClusterBuy, type CompanyKpisData, type CongressTrade, DeepHistoryUnavailableError, type Document, type DocumentSearchResponse, type DocumentSource, type EarningsCalendarResponse, type EarningsEvent, type EarningsKpiHighlight, type EarningsQuarter, type EarningsSource, type EtfAggregateCoverage, type EtfAnalystAggregate, type EtfAnalystContributor, type EtfHolding, type EtfHoldings, type EtfInfo, type EtfInsiderAggregate, type EtfInsiderContributor, type EtfSentimentAggregate, type EtfSentimentReading, type FloatInfo, type Fundamentals, type FundamentalsPeriod, type FundamentalsPeriodsResponse, type GetAnalystActionsOptions, type GetAnalystMarketActivityOptions, type GetEarningsCalendarOptions, type GetEarningsSummariesOptions, type GetEtfInsiderAggregateOptions, type GetHoldersOptions, type GetInsiderOptions, type GetInsightsOptions, type GetLatestInsightsOptions, type GetPoliticianActivityOptions, type GetPoliticiansOptions, type GetRecentEarningsOptions, type GetStockInsightsRangeOptions, type GetUserInsightsOptions, type Holder, type HolderNotableChanges, type IndexConstituent, type IndexHistoryPoint, type IndexHistoryResponse, type IndexListResponse, type IndexListing, type IndexSnapshot, type InsiderActivityResponse, type InsiderActivitySummary, type InsiderTrade, type Insight, type InsightPreviewResponse, type InstitutionList, type InstitutionListResponse, type InstitutionSummary, type InstitutionalFlow, type InstitutionalFlows, type InstitutionalFlowsResponse, type KBEntity, type KpiCoverageEntry, type KpiCoverageResponse, type KpiDataPoint, type KpiSeries, type KpiTypeEntry, type ListInstitutionsOptions, type LockedInsight, type MarketMood, type MarketStatus, type MarketSummary, type MetricDistribution, type MetricDistributionOptions, type MetricType, type MetricsBreakdown, type MetricsOptions, NotFoundError, type PoliticianDetail, type PoliticianSummary, type PreviewResponse, type Quarter, RateLimitError, type RecentEarningsEntry, SentiSense, SentiSenseError, type SentiSenseOptions, type SentimentEntry, type ServingMetric, type ShortInterest, type ShortVolume, type SimilarStock, type StockDetail, type StockEntity, type StockImage, type StockPrice, type StockProfile, type StockQuote, type Story, type StoryCluster, type TickerHolders, type TrackerEvent, type TrackerGeoEntry, type TrackerHeadlineMetric, type TrackerListResponse, type TrackerListing, type TrackerMetricValue, type TrackerSignal, type TrackerSnapshot, type TrackerSnapshotResponse, type TrackerSourceRef, type TrackerTableRow, type TrackerTimeSeriesPoint, type TtmFundamentals, VERSION, type WeightedConsensus, type WeightedNetFlow, SentiSense as default };

package/dist/index.d.ts

@@ -839,6 +839,110 @@ interface GetEarningsCalendarOptions {
     /** Session filter. */
     time?: "before_open" | "after_close" | "during_market" | "unknown";
 }
+/**
+ * One KPI card on a reported quarter.
+ *
+ * `value` and `yoy` are display strings, already formatted (`"$109.4B"`,
+ * `"+16% YoY"`), not numbers to compute with. `yoy` is absent when the quarter
+ * carries no year-over-year comparison for that line, which is common on
+ * call highlights.
+ */
+interface EarningsKpiHighlight {
+    label: string;
+    value: string;
+    yoy?: string;
+}
+/** A citation backing a reported quarter. */
+interface EarningsSource {
+    title: string;
+    url: string;
+}
+/**
+ * One fiscal quarter of the earnings analysis report, from
+ * `client.earnings.getSummaries()`.
+ *
+ * The wire shape depends on the caller's tier, so branch on the envelope's
+ * `isPreview` rather than on field presence. `fiscalPeriod`, `reportDate`,
+ * `headline`, `hasTranscript`, `generatedAt` and `source` arrive on both tiers.
+ *
+ * PRO adds the bodies: `summaryMd`, the full `kpiHighlights`, `guidance`,
+ * `transcriptSummaryMd`, `transcriptHighlights`, `transcriptGeneratedAt` and
+ * `sources`.
+ *
+ * The FREE preview replaces those bodies with shape: up to two `kpiHighlights`
+ * cards (without `yoy`) plus `kpiHighlightCount`, the section titles in
+ * `summaryTopics` and `transcriptTopics`, and `hasGuidance` with
+ * `guidanceDirection` in place of the guidance language. It never carries a
+ * body, a KPI history, or a guidance figure.
+ *
+ * Absence is explicit: a quarter with no call summary sets `hasTranscript` to
+ * `false` rather than dropping the concept, so a client can say "no call
+ * summary yet" instead of rendering nothing.
+ */
+interface EarningsQuarter {
+    /** Display fiscal period, e.g. `"Q2 FY2026"`. */
+    fiscalPeriod: string;
+    /** Date the results were reported, ISO calendar day `"YYYY-MM-DD"`. */
+    reportDate: string;
+    /** One-line editorial summary of the quarter. */
+    headline: string;
+    /** True when a summary of the earnings call exists for this quarter. */
+    hasTranscript: boolean;
+    /** When the quarter summary was generated, epoch seconds. */
+    generatedAt: number;
+    /** Provenance of the quarter summary. */
+    source: "press_release" | "transcript";
+    /** PRO: markdown body summarizing the reported results. */
+    summaryMd?: string;
+    /** PRO carries the full set; a preview carries up to two cards without `yoy`. */
+    kpiHighlights?: EarningsKpiHighlight[];
+    /** PRO: forward-guidance language as reported. Absent when the quarter carries none. */
+    guidance?: string;
+    /** PRO: markdown body summarizing the call. Absent when `hasTranscript` is false. */
+    transcriptSummaryMd?: string;
+    /** PRO: call-specific highlights. Absent when there is no call summary. */
+    transcriptHighlights?: EarningsKpiHighlight[];
+    /** PRO: when the call summary was generated, epoch seconds. Can post-date `generatedAt`. */
+    transcriptGeneratedAt?: number;
+    /** PRO: citations backing the quarter. */
+    sources?: EarningsSource[];
+    /** Preview: how many KPI cards the full quarter carries. */
+    kpiHighlightCount?: number;
+    /** Preview: section titles of the summary, never body text. */
+    summaryTopics?: string[];
+    /** Preview: section titles of the call summary, never body text. */
+    transcriptTopics?: string[];
+    /** Preview: whether the quarter carries guidance at all. */
+    hasGuidance?: boolean;
+    /** Preview: the direction only, in place of the guidance language. */
+    guidanceDirection?: "RAISED" | "CUT" | "HELD" | "MIXED" | null;
+}
+/** One company that reported inside the recent window. */
+interface RecentEarningsEntry {
+    ticker: string;
+    /** Display fiscal period, e.g. `"Q2 FY2026"`. */
+    fiscalPeriod: string;
+    /** Date the results were reported, ISO calendar day `"YYYY-MM-DD"`. */
+    reportDate: string;
+    headline: string;
+    /** True when a summary of the earnings call exists for this quarter. */
+    hasTranscriptSummary: boolean;
+    /** Latest content written for this quarter, epoch seconds. */
+    generatedAt: number;
+}
+interface GetEarningsSummariesOptions {
+    /**
+     * Max quarters returned, 1 to 40. Omitted, the API applies its own default
+     * of 12. A FREE key receives one quarter whatever you pass.
+     */
+    limit?: number;
+}
+interface GetRecentEarningsOptions {
+    /** Look-back window in days, 1 to 31. Omitted, the API applies its own default of 7. */
+    days?: number;
+    /** Max rows returned, 1 to 100. Omitted, the API applies its own default of 50. */
+    limit?: number;
+}
 interface PreviewResponse<T> {
     isPreview: boolean;
     previewReason: "PRO_REQUIRED" | null;
@@ -1422,6 +1526,58 @@ declare class Documents {
     getStoriesByTicker(ticker: string, options?: GetStoriesByTickerOptions): Promise<Story[]>;
 }
 
+/**
+ * Earnings: what a company actually reported, after the fact.
+ *
+ * A quarter's results arrive as a press release, a filing, and a call, none of
+ * which is a data structure. {@link getSummaries} is the assembled version, one
+ * object per fiscal quarter, and {@link getRecent} is the cross-ticker view of
+ * who reported lately. Pair them to drive a post-earnings sweep: list the
+ * window, then pull each ticker's analysis report.
+ *
+ * The forward-looking half of the family lives on `client.calendar.getEarnings()`,
+ * which covers scheduled dates and consensus EPS rather than results.
+ *
+ * @see EarningsQuarter
+ */
+declare class Earnings {
+    private client;
+    constructor(client: APIClient);
+    /**
+     * Per-quarter earnings analysis report for one ticker, newest first.
+     *
+     * Each quarter carries the editorial headline, the KPI cards that matter for
+     * that company with year-over-year deltas, the guidance language as
+     * management phrased it, and a summary of the earnings call.
+     *
+     * Branch on `isPreview`: a PRO key receives every hydrated quarter in full, a
+     * FREE key receives the latest quarter shaped rather than truncated, plus
+     * `totalCount`. {@link EarningsQuarter} documents which fields each tier
+     * carries.
+     *
+     * A quarter typically appears within 48 hours of the company reporting, and
+     * the call summary can arrive after the press-release content for the same
+     * quarter, so read `generatedAt` and `transcriptGeneratedAt` rather than
+     * assuming a fixed lag. A ticker with no stored quarter answers with an empty
+     * `data` array, not a 404.
+     *
+     * Use canonical ticker symbols: `GOOGL` (not `GOOG`), `BRK.B` (not `BRK-B`).
+     */
+    getSummaries(ticker: string, options?: GetEarningsSummariesOptions): Promise<PreviewResponse<EarningsQuarter[]>>;
+    /**
+     * Which covered companies reported on or after `today - days`, newest first.
+     *
+     * Every API key receives the full window it asks for, so `isPreview` is
+     * always `false` here. The window is bounded by `reportDate`, so a quarter
+     * reported inside it appears even when its call summary lands later, and an
+     * empty `data` array means nobody in the covered set reported in that window.
+     *
+     * This is the backward-looking feed; `client.calendar.getEarnings()` is the
+     * forward-looking one.
+     */
+    getRecent(options?: GetRecentEarningsOptions): Promise<PreviewResponse<RecentEarningsEntry[]>>;
+}
+
 declare class EntityMetrics {
     private client;
     constructor(client: APIClient);
@@ -1615,7 +1771,7 @@ declare class Insider {
     /**
      * Get market-wide insider activity: top buys and sells aggregated by ticker.
      *
-     * PRO-gated. Free/unauthenticated users receive a preview (top 5 per direction)
+     * PRO-gated. Free-tier users receive a preview (top 5 per direction)
      * with `isPreview: true` in the response.
      */
     getActivity(options?: GetInsiderOptions): Promise<PreviewResponse<InsiderActivityResponse>>;
@@ -1639,7 +1795,7 @@ declare class Politicians {
     /**
      * Get recent congressional STOCK Act trading activity across all politicians.
      *
-     * PRO-gated. Free/unauthenticated users receive a preview (top 5 trades)
+     * PRO-gated. Free-tier users receive a preview (top 5 trades)
      * with `isPreview: true` in the response.
      *
      * The feed is longer than one response: a default 90-day window is routinely well over a
@@ -1734,7 +1890,7 @@ declare class Insights {
     user(options?: GetUserInsightsOptions): Promise<PreviewResponse<Insight[]>>;
     /**
      * Get available insight types for a specific stock.
-     * No authentication required.
+     * API key required.
      *
      * Returns an array of insight type strings (e.g., `["sentiment_shift", "options_activity"]`).
      */
@@ -2048,6 +2204,7 @@ declare class SentiSense implements APIClient {
     readonly indexes: Indexes;
     readonly trackers: Trackers;
     readonly calendar: Calendar;
+    readonly earnings: Earnings;
     constructor(options?: SentiSenseOptions);
     /** @internal */
     get<T = unknown>(path: string, params?: object): Promise<T>;
@@ -2093,6 +2250,6 @@ declare class APIError extends SentiSenseError {
     constructor(message: string, status: number, code?: string);
 }
 
-declare const VERSION = "0.35.0";
+declare const VERSION = "0.36.0";
 
-export { type AISummary, APIError, type AnalystAction, type AnalystConsensus, type AnalystEarningsSurprise, type AnalystEstimate, type AnalystEstimatesResponse, type AssetMetadata, AuthenticationError, type CalendarMeta, type ChartData, type ChartDataPoint, type ClusterBuy, type CompanyKpisData, type CongressTrade, DeepHistoryUnavailableError, type Document, type DocumentSearchResponse, type DocumentSource, type EarningsCalendarResponse, type EarningsEvent, type EtfAggregateCoverage, type EtfAnalystAggregate, type EtfAnalystContributor, type EtfHolding, type EtfHoldings, type EtfInfo, type EtfInsiderAggregate, type EtfInsiderContributor, type EtfSentimentAggregate, type EtfSentimentReading, type FloatInfo, type Fundamentals, type FundamentalsPeriod, type FundamentalsPeriodsResponse, type GetAnalystActionsOptions, type GetAnalystMarketActivityOptions, type GetEarningsCalendarOptions, type GetEtfInsiderAggregateOptions, type GetHoldersOptions, type GetInsiderOptions, type GetInsightsOptions, type GetLatestInsightsOptions, type GetPoliticianActivityOptions, type GetPoliticiansOptions, type GetStockInsightsRangeOptions, type GetUserInsightsOptions, type Holder, type HolderNotableChanges, type IndexConstituent, type IndexHistoryPoint, type IndexHistoryResponse, type IndexListResponse, type IndexListing, type IndexSnapshot, type InsiderActivityResponse, type InsiderActivitySummary, type InsiderTrade, type Insight, type InsightPreviewResponse, type InstitutionList, type InstitutionListResponse, type InstitutionSummary, type InstitutionalFlow, type InstitutionalFlows, type InstitutionalFlowsResponse, type KBEntity, type KpiCoverageEntry, type KpiCoverageResponse, type KpiDataPoint, type KpiSeries, type KpiTypeEntry, type ListInstitutionsOptions, type LockedInsight, type MarketMood, type MarketStatus, type MarketSummary, type MetricDistribution, type MetricDistributionOptions, type MetricType, type MetricsBreakdown, type MetricsOptions, NotFoundError, type PoliticianDetail, type PoliticianSummary, type PreviewResponse, type Quarter, RateLimitError, SentiSense, SentiSenseError, type SentiSenseOptions, type SentimentEntry, type ServingMetric, type ShortInterest, type ShortVolume, type SimilarStock, type StockDetail, type StockEntity, type StockImage, type StockPrice, type StockProfile, type StockQuote, type Story, type StoryCluster, type TickerHolders, type TrackerEvent, type TrackerGeoEntry, type TrackerHeadlineMetric, type TrackerListResponse, type TrackerListing, type TrackerMetricValue, type TrackerSignal, type TrackerSnapshot, type TrackerSnapshotResponse, type TrackerSourceRef, type TrackerTableRow, type TrackerTimeSeriesPoint, type TtmFundamentals, VERSION, type WeightedConsensus, type WeightedNetFlow, SentiSense as default };
+export { type AISummary, APIError, type AnalystAction, type AnalystConsensus, type AnalystEarningsSurprise, type AnalystEstimate, type AnalystEstimatesResponse, type AssetMetadata, AuthenticationError, type CalendarMeta, type ChartData, type ChartDataPoint, type ClusterBuy, type CompanyKpisData, type CongressTrade, DeepHistoryUnavailableError, type Document, type DocumentSearchResponse, type DocumentSource, type EarningsCalendarResponse, type EarningsEvent, type EarningsKpiHighlight, type EarningsQuarter, type EarningsSource, type EtfAggregateCoverage, type EtfAnalystAggregate, type EtfAnalystContributor, type EtfHolding, type EtfHoldings, type EtfInfo, type EtfInsiderAggregate, type EtfInsiderContributor, type EtfSentimentAggregate, type EtfSentimentReading, type FloatInfo, type Fundamentals, type FundamentalsPeriod, type FundamentalsPeriodsResponse, type GetAnalystActionsOptions, type GetAnalystMarketActivityOptions, type GetEarningsCalendarOptions, type GetEarningsSummariesOptions, type GetEtfInsiderAggregateOptions, type GetHoldersOptions, type GetInsiderOptions, type GetInsightsOptions, type GetLatestInsightsOptions, type GetPoliticianActivityOptions, type GetPoliticiansOptions, type GetRecentEarningsOptions, type GetStockInsightsRangeOptions, type GetUserInsightsOptions, type Holder, type HolderNotableChanges, type IndexConstituent, type IndexHistoryPoint, type IndexHistoryResponse, type IndexListResponse, type IndexListing, type IndexSnapshot, type InsiderActivityResponse, type InsiderActivitySummary, type InsiderTrade, type Insight, type InsightPreviewResponse, type InstitutionList, type InstitutionListResponse, type InstitutionSummary, type InstitutionalFlow, type InstitutionalFlows, type InstitutionalFlowsResponse, type KBEntity, type KpiCoverageEntry, type KpiCoverageResponse, type KpiDataPoint, type KpiSeries, type KpiTypeEntry, type ListInstitutionsOptions, type LockedInsight, type MarketMood, type MarketStatus, type MarketSummary, type MetricDistribution, type MetricDistributionOptions, type MetricType, type MetricsBreakdown, type MetricsOptions, NotFoundError, type PoliticianDetail, type PoliticianSummary, type PreviewResponse, type Quarter, RateLimitError, type RecentEarningsEntry, SentiSense, SentiSenseError, type SentiSenseOptions, type SentimentEntry, type ServingMetric, type ShortInterest, type ShortVolume, type SimilarStock, type StockDetail, type StockEntity, type StockImage, type StockPrice, type StockProfile, type StockQuote, type Story, type StoryCluster, type TickerHolders, type TrackerEvent, type TrackerGeoEntry, type TrackerHeadlineMetric, type TrackerListResponse, type TrackerListing, type TrackerMetricValue, type TrackerSignal, type TrackerSnapshot, type TrackerSnapshotResponse, type TrackerSourceRef, type TrackerTableRow, type TrackerTimeSeriesPoint, type TtmFundamentals, VERSION, type WeightedConsensus, type WeightedNetFlow, SentiSense as default };

package/dist/index.mjs

@@ -151,6 +151,53 @@ var Documents = class {
   }
 };
 
+// src/resources/earnings.ts
+var Earnings = class {
+  constructor(client) {
+    this.client = client;
+  }
+  /**
+   * Per-quarter earnings analysis report for one ticker, newest first.
+   *
+   * Each quarter carries the editorial headline, the KPI cards that matter for
+   * that company with year-over-year deltas, the guidance language as
+   * management phrased it, and a summary of the earnings call.
+   *
+   * Branch on `isPreview`: a PRO key receives every hydrated quarter in full, a
+   * FREE key receives the latest quarter shaped rather than truncated, plus
+   * `totalCount`. {@link EarningsQuarter} documents which fields each tier
+   * carries.
+   *
+   * A quarter typically appears within 48 hours of the company reporting, and
+   * the call summary can arrive after the press-release content for the same
+   * quarter, so read `generatedAt` and `transcriptGeneratedAt` rather than
+   * assuming a fixed lag. A ticker with no stored quarter answers with an empty
+   * `data` array, not a 404.
+   *
+   * Use canonical ticker symbols: `GOOGL` (not `GOOG`), `BRK.B` (not `BRK-B`).
+   */
+  async getSummaries(ticker, options) {
+    return this.client.get(
+      `/api/v1/stocks/${encodeURIComponent(ticker.toUpperCase())}/earnings-summaries`,
+      options
+    );
+  }
+  /**
+   * Which covered companies reported on or after `today - days`, newest first.
+   *
+   * Every API key receives the full window it asks for, so `isPreview` is
+   * always `false` here. The window is bounded by `reportDate`, so a quarter
+   * reported inside it appears even when its call summary lands later, and an
+   * empty `data` array means nobody in the covered set reported in that window.
+   *
+   * This is the backward-looking feed; `client.calendar.getEarnings()` is the
+   * forward-looking one.
+   */
+  async getRecent(options) {
+    return this.client.get("/api/v1/earnings/recent", options);
+  }
+};
+
 // src/resources/entityMetrics.ts
 var EntityMetrics = class {
   constructor(client) {
@@ -251,7 +298,7 @@ var Insider = class {
   /**
    * Get market-wide insider activity: top buys and sells aggregated by ticker.
    *
-   * PRO-gated. Free/unauthenticated users receive a preview (top 5 per direction)
+   * PRO-gated. Free-tier users receive a preview (top 5 per direction)
    * with `isPreview: true` in the response.
    */
   async getActivity(options) {
@@ -286,7 +333,7 @@ var Politicians = class {
   /**
    * Get recent congressional STOCK Act trading activity across all politicians.
    *
-   * PRO-gated. Free/unauthenticated users receive a preview (top 5 trades)
+   * PRO-gated. Free-tier users receive a preview (top 5 trades)
    * with `isPreview: true` in the response.
    *
    * The feed is longer than one response: a default 90-day window is routinely well over a
@@ -398,7 +445,7 @@ var Insights = class {
   }
   /**
    * Get available insight types for a specific stock.
-   * No authentication required.
+   * API key required.
    *
    * Returns an array of insight type strings (e.g., `["sentiment_shift", "options_activity"]`).
    */
@@ -810,7 +857,7 @@ var Trackers = class {
 };
 
 // src/version.ts
-var VERSION = "0.35.0";
+var VERSION = "0.36.0";
 
 // src/client.ts
 var DEFAULT_BASE_URL = "https://app.sentisense.ai";
@@ -855,6 +902,7 @@ var SentiSense = class {
     this.indexes = new Indexes(this);
     this.trackers = new Trackers(this);
     this.calendar = new Calendar(this);
+    this.earnings = new Earnings(this);
   }
   /** @internal */
   async get(path, params) {