sentisense 0.55.0 → 0.56.0

package/dist/index.d.mts

@@ -325,6 +325,45 @@ interface Fundamentals {
      * securities portfolio is wrong by billions and can flip the sign.
      */
     freeCashFlow?: number | null;
+    /**
+     * Basic earnings per share. Always the basic figure, on every data source, unlike `eps`,
+     * whose basis depends on which source served the row.
+     */
+    epsBasic?: number | null;
+    /** Diluted earnings per share. `null` when the provider reports no diluted figure. */
+    epsDiluted?: number | null;
+    /**
+     * The provider's bottom-line income line, which can differ from `netIncome` in size and in
+     * sign. Published as the provider states it; it is not promised to reconcile with either EPS
+     * field, and neither is `netIncome`.
+     */
+    bottomLineNetIncome?: number | null;
+    /**
+     * Basic weighted-average shares for the period. An average ACROSS the period, not a count at
+     * period end, so it is not a correct input to a market capitalisation or a book value per
+     * share. `null` when the provider reports none.
+     */
+    weightedAverageSharesBasic?: number | null;
+    /**
+     * Diluted weighted-average shares for the period. Same caveat as the basic count: it is an
+     * average across the period, not a period-end count. `null` when the provider reports none.
+     */
+    weightedAverageSharesDiluted?: number | null;
+    /**
+     * @deprecated Stops being populated on 2026-12-15. Despite the name this is never a
+     * period-end shares-outstanding count, and it means different things on different rows: a
+     * diluted weighted average, a basic weighted average where no diluted figure exists, or an
+     * estimate derived from market capitalisation. It is being retired rather than redefined
+     * because no single definition would be true of every row it has already served.
+     *
+     * Use `weightedAverageSharesDiluted` or `weightedAverageSharesBasic`, and handle `null`,
+     * which now means the provider did not report that count instead of silently substituting
+     * the other one. Reading `weightedAverageSharesDiluted` and falling back to
+     * `weightedAverageSharesBasic` when null reproduces the statement-history form of the old
+     * field, which is what most callers were reading; it does not reproduce the rows that
+     * carried no value, nor the market-capitalisation-derived estimate on the latest snapshot.
+     */
+    sharesOutstanding?: number | null;
     [key: string]: unknown;
 }
 /**
@@ -1495,7 +1534,10 @@ interface GetEarningsCalendarOptions {
     from?: string;
     /** Inclusive upper date bound, ISO "YYYY-MM-DD". */
     to?: string;
-    /** When true, only company-confirmed dates. */
+    /**
+     * Two-sided. `true` returns only company-confirmed dates, `false` returns only
+     * the still-estimated ones. Omit it to get both.
+     */
     confirmed?: boolean;
     /** Session filter. */
     time?: "before_open" | "after_close" | "during_market" | "unknown";
@@ -4092,6 +4134,6 @@ declare class APIError extends SentiSenseError {
     constructor(message: string, status: number, code?: string);
 }
 
-declare const VERSION = "0.55.0";
+declare const VERSION = "0.56.0";
 
 export { type AISummary, APIError, type AnalystAction, type AnalystCall, type AnalystCalledItCall, type AnalystCalledItMove, type AnalystConsensus, type AnalystConsensusHistory, type AnalystConsensusHistoryPoint, type AnalystCoverage, type AnalystCoverageAnalyst, type AnalystCoverageBookEntry, type AnalystCoverageFirm, type AnalystEarningsSurprise, type AnalystEstimate, type AnalystEstimatesResponse, type AnalystFirmRating, type AnalystFirmTenure, type AnalystNote, type AnalystProfile, type AnalystRatingBuckets, 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 EarningsOutcomeStatistics, type EarningsQuarter, type EarningsReaction, type EarningsReactionsResponse, type EarningsSource, type EarningsStatistics, type EarningsStatisticsBaseline, type EarningsStatisticsDeviation, type EarningsStatisticsThresholds, type EarningsStatisticsWindow, type EntitySearchResult, type EntitySearchType, type EtfAggregateCoverage, type EtfAnalystAggregate, type EtfAnalystContributor, type EtfHolding, type EtfHoldings, type EtfInfo, type EtfInsiderAggregate, type EtfInsiderContributor, type EtfScreenerExecuteResponse, type EtfScreenerRow, type EtfSentimentAggregate, type EtfSentimentReading, type FeaturedScreen, type FloatInfo, type Fundamentals, type FundamentalsPeriod, type FundamentalsPeriodsResponse, type GetAnalystActionsOptions, type GetAnalystCalledItOptions, type GetAnalystCallsOptions, type GetAnalystConsensusHistoryOptions, type GetAnalystCoverageOptions, type GetAnalystMarketActivityOptions, type GetEarningsCalendarOptions, type GetEarningsStatisticsOptions, type GetEarningsSummariesOptions, type GetEtfInsiderAggregateOptions, type GetHoldersOptions, type GetInsiderOptions, type GetInsightsOptions, type GetLatestInsightsOptions, type GetOptionsHistoryOptions, type GetPoliticianActivityOptions, type GetPoliticianDirectoryOptions, type GetPoliticianMemberOptions, type GetPoliticiansOptions, type GetRankedEarningsOptions, 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 OptionsAggregate, type OptionsContext, type OptionsHistory, type OptionsHistoryWindow, type OptionsOiWalls, type OptionsOverview, type OptionsOverviewRow, type OptionsSummary, type OptionsUnusualContract, type OptionsWall, type PoliticianDetail, type PoliticianDirectory, type PoliticianDirectoryEntry, type PoliticianDirectoryResponse, type PoliticianSummary, type PreviewResponse, type Quarter, type RankedEarnings, type RankedEarningsSection, type RankedReportedEarnings, type RankedUpcomingEarnings, RateLimitError, type RatingBase, type RatingDimension, type RatingDimensionKey, type RatingFlag, type RatingNotRatedReason, type RatingSubLeg, type RecentEarningsEntry, type RiskAdjustment, type RiskCondition, type ScreenerExecuteOptions, type ScreenerExecuteResponse, type ScreenerFieldCatalog, type ScreenerFieldDescriptor, type ScreenerFieldOption, type ScreenerFilter, type ScreenerPlan, type ScreenerRow, type ScreenerScreensResponse, type ScreenerSort, type SearchEntitiesOptions, SentiSense, SentiSenseError, type SentiSenseOptions, type SentimentEntry, type ServingMetric, type ShortInterest, type ShortVolume, type SimilarStock, type StockDetail, type StockEntity, type StockImage, type StockNotRated, type StockPrice, type StockProfile, type StockQuote, type StockRating, type StockRatingResponse, type StockSocialDominance, type Story, type StoryCluster, type StoryTimelineEntry, TemporarilyUnavailableError, 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

@@ -325,6 +325,45 @@ interface Fundamentals {
      * securities portfolio is wrong by billions and can flip the sign.
      */
     freeCashFlow?: number | null;
+    /**
+     * Basic earnings per share. Always the basic figure, on every data source, unlike `eps`,
+     * whose basis depends on which source served the row.
+     */
+    epsBasic?: number | null;
+    /** Diluted earnings per share. `null` when the provider reports no diluted figure. */
+    epsDiluted?: number | null;
+    /**
+     * The provider's bottom-line income line, which can differ from `netIncome` in size and in
+     * sign. Published as the provider states it; it is not promised to reconcile with either EPS
+     * field, and neither is `netIncome`.
+     */
+    bottomLineNetIncome?: number | null;
+    /**
+     * Basic weighted-average shares for the period. An average ACROSS the period, not a count at
+     * period end, so it is not a correct input to a market capitalisation or a book value per
+     * share. `null` when the provider reports none.
+     */
+    weightedAverageSharesBasic?: number | null;
+    /**
+     * Diluted weighted-average shares for the period. Same caveat as the basic count: it is an
+     * average across the period, not a period-end count. `null` when the provider reports none.
+     */
+    weightedAverageSharesDiluted?: number | null;
+    /**
+     * @deprecated Stops being populated on 2026-12-15. Despite the name this is never a
+     * period-end shares-outstanding count, and it means different things on different rows: a
+     * diluted weighted average, a basic weighted average where no diluted figure exists, or an
+     * estimate derived from market capitalisation. It is being retired rather than redefined
+     * because no single definition would be true of every row it has already served.
+     *
+     * Use `weightedAverageSharesDiluted` or `weightedAverageSharesBasic`, and handle `null`,
+     * which now means the provider did not report that count instead of silently substituting
+     * the other one. Reading `weightedAverageSharesDiluted` and falling back to
+     * `weightedAverageSharesBasic` when null reproduces the statement-history form of the old
+     * field, which is what most callers were reading; it does not reproduce the rows that
+     * carried no value, nor the market-capitalisation-derived estimate on the latest snapshot.
+     */
+    sharesOutstanding?: number | null;
     [key: string]: unknown;
 }
 /**
@@ -1495,7 +1534,10 @@ interface GetEarningsCalendarOptions {
     from?: string;
     /** Inclusive upper date bound, ISO "YYYY-MM-DD". */
     to?: string;
-    /** When true, only company-confirmed dates. */
+    /**
+     * Two-sided. `true` returns only company-confirmed dates, `false` returns only
+     * the still-estimated ones. Omit it to get both.
+     */
     confirmed?: boolean;
     /** Session filter. */
     time?: "before_open" | "after_close" | "during_market" | "unknown";
@@ -4092,6 +4134,6 @@ declare class APIError extends SentiSenseError {
     constructor(message: string, status: number, code?: string);
 }
 
-declare const VERSION = "0.55.0";
+declare const VERSION = "0.56.0";
 
 export { type AISummary, APIError, type AnalystAction, type AnalystCall, type AnalystCalledItCall, type AnalystCalledItMove, type AnalystConsensus, type AnalystConsensusHistory, type AnalystConsensusHistoryPoint, type AnalystCoverage, type AnalystCoverageAnalyst, type AnalystCoverageBookEntry, type AnalystCoverageFirm, type AnalystEarningsSurprise, type AnalystEstimate, type AnalystEstimatesResponse, type AnalystFirmRating, type AnalystFirmTenure, type AnalystNote, type AnalystProfile, type AnalystRatingBuckets, 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 EarningsOutcomeStatistics, type EarningsQuarter, type EarningsReaction, type EarningsReactionsResponse, type EarningsSource, type EarningsStatistics, type EarningsStatisticsBaseline, type EarningsStatisticsDeviation, type EarningsStatisticsThresholds, type EarningsStatisticsWindow, type EntitySearchResult, type EntitySearchType, type EtfAggregateCoverage, type EtfAnalystAggregate, type EtfAnalystContributor, type EtfHolding, type EtfHoldings, type EtfInfo, type EtfInsiderAggregate, type EtfInsiderContributor, type EtfScreenerExecuteResponse, type EtfScreenerRow, type EtfSentimentAggregate, type EtfSentimentReading, type FeaturedScreen, type FloatInfo, type Fundamentals, type FundamentalsPeriod, type FundamentalsPeriodsResponse, type GetAnalystActionsOptions, type GetAnalystCalledItOptions, type GetAnalystCallsOptions, type GetAnalystConsensusHistoryOptions, type GetAnalystCoverageOptions, type GetAnalystMarketActivityOptions, type GetEarningsCalendarOptions, type GetEarningsStatisticsOptions, type GetEarningsSummariesOptions, type GetEtfInsiderAggregateOptions, type GetHoldersOptions, type GetInsiderOptions, type GetInsightsOptions, type GetLatestInsightsOptions, type GetOptionsHistoryOptions, type GetPoliticianActivityOptions, type GetPoliticianDirectoryOptions, type GetPoliticianMemberOptions, type GetPoliticiansOptions, type GetRankedEarningsOptions, 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 OptionsAggregate, type OptionsContext, type OptionsHistory, type OptionsHistoryWindow, type OptionsOiWalls, type OptionsOverview, type OptionsOverviewRow, type OptionsSummary, type OptionsUnusualContract, type OptionsWall, type PoliticianDetail, type PoliticianDirectory, type PoliticianDirectoryEntry, type PoliticianDirectoryResponse, type PoliticianSummary, type PreviewResponse, type Quarter, type RankedEarnings, type RankedEarningsSection, type RankedReportedEarnings, type RankedUpcomingEarnings, RateLimitError, type RatingBase, type RatingDimension, type RatingDimensionKey, type RatingFlag, type RatingNotRatedReason, type RatingSubLeg, type RecentEarningsEntry, type RiskAdjustment, type RiskCondition, type ScreenerExecuteOptions, type ScreenerExecuteResponse, type ScreenerFieldCatalog, type ScreenerFieldDescriptor, type ScreenerFieldOption, type ScreenerFilter, type ScreenerPlan, type ScreenerRow, type ScreenerScreensResponse, type ScreenerSort, type SearchEntitiesOptions, SentiSense, SentiSenseError, type SentiSenseOptions, type SentimentEntry, type ServingMetric, type ShortInterest, type ShortVolume, type SimilarStock, type StockDetail, type StockEntity, type StockImage, type StockNotRated, type StockPrice, type StockProfile, type StockQuote, type StockRating, type StockRatingResponse, type StockSocialDominance, type Story, type StoryCluster, type StoryTimelineEntry, TemporarilyUnavailableError, 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

@@ -1300,7 +1300,7 @@ var Trackers = class {
 };
 
 // src/version.ts
-var VERSION = "0.55.0";
+var VERSION = "0.56.0";
 
 // src/client.ts
 var DEFAULT_BASE_URL = "https://app.sentisense.ai";