sentisense 0.11.0 → 0.15.0

package/dist/index.d.mts

@@ -6,16 +6,31 @@ interface SentiSenseOptions {
 }
 interface StockPrice {
     ticker: string;
+    /** Regular-session price. During RTH: live last trade. Otherwise: most recent RTH close. */
     price: number;
     change: number;
     changePercent: number;
     previousClose: number;
     /** Unix timestamp in milliseconds of the price quote. */
     timestamp: number;
+    /** Extended-hours view (pre-market or after-hours). Null/absent during RTH, overnight, and weekends. */
+    extendedHours?: ExtendedHoursInfo | null;
+}
+/**
+ * Extended-hours session view embedded in price / quote responses when the snapshot sees
+ * pre-market (04:00–09:30 ET) or after-hours (16:00–20:00 ET) activity. `change` and
+ * `changePercent` are computed by the server vs the regular-session `currentPrice`.
+ */
+interface ExtendedHoursInfo {
+    session: "pre" | "post";
+    price: number;
+    change: number;
+    changePercent: number;
 }
 /** Aggregate quote snapshot from GET /api/v1/stocks/{ticker}/quote. */
 interface StockQuote {
     ticker: string;
+    /** Regular-session price. During RTH: live last trade. Otherwise: most recent RTH close. */
     currentPrice: number | null;
     change: number | null;
     changePercent: number | null;
@@ -31,7 +46,8 @@ interface StockQuote {
     epsTTM: number | null;
     dividendYield: number | null;
     timestamp: number | null;
-    extendedHours: boolean | null;
+    /** Extended-hours view (pre-market or after-hours). Null/absent during RTH, overnight, and weekends. */
+    extendedHours?: ExtendedHoursInfo | null;
 }
 interface StockDetail {
     ticker: string;
@@ -67,12 +83,20 @@ interface StockEntity {
     [key: string]: unknown;
 }
 interface ChartDataPoint {
+    /** Unix timestamp in milliseconds. */
+    timestamp?: number;
     date: string;
     open: number;
     high: number;
     low: number;
     close: number;
     volume: number;
+    /**
+     * US-equity market session: "pre" (04:00–09:30 ET), "regular" (09:30–16:00 ET),
+     * or "post" (16:00–20:00 ET). Populated for intraday timeframes (1D / 5D / 1W / 1M);
+     * `null` for daily / weekly bars (3M and longer) that span whole sessions.
+     */
+    session?: "pre" | "regular" | "post" | null;
 }
 interface ChartData {
     ticker: string;
@@ -112,7 +136,7 @@ interface AISummary {
     [key: string]: unknown;
 }
 interface GetChartOptions {
-    timeframe?: "1M" | "3M" | "6M" | "1Y";
+    timeframe?: "1D" | "5D" | "1W" | "1M" | "3M" | "6M" | "1Y" | "ALL";
 }
 interface GetImagesOptions {
     forced?: boolean;
@@ -173,8 +197,8 @@ interface Story {
     tickers: string[];
     primaryEntityNames: string[];
     impactScore: number;
-    /** Unix timestamp in seconds when the story first broke. */
-    brokeAt: number;
+    /** Unix timestamp in seconds when the story first broke. Null when the story has no representative document timestamp yet. */
+    brokeAt: number | null;
 }
 interface GetByTickerOptions {
     source?: DocumentSource;
@@ -701,6 +725,163 @@ declare class EntityMetrics {
     getAverageSentiment(symbol: string, options?: EntityMetricsDateRange): Promise<SentimentData>;
 }
 
+interface EtfInfo {
+    ticker: string;
+    name: string;
+    kbEntityId: string | null;
+    urlSlug: string | null;
+    issuer: string | null;
+    trackedIndex: string | null;
+    assetClass: string | null;
+}
+interface EtfHolding {
+    ticker: string;
+    name: string | null;
+    /** Weight in the fund as a percentage (0-100). */
+    weight_pct: number;
+    /** First date this holding appeared in the composition. */
+    first_seen: string | null;
+}
+interface EtfHoldings {
+    ticker: string;
+    issuer: string;
+    issuer_endpoint: string | null;
+    as_of_date: string;
+    fetched_at: string;
+    next_refresh_due: string;
+    total_holdings: number;
+    holdings: EtfHolding[];
+    /** True when this is a top-N view rather than the full fund. */
+    partial?: boolean | null;
+    /** Issuer's reported total holdings when `partial=true`. */
+    total_known_holdings?: number | null;
+}
+interface EtfAggregateCoverage {
+    holdingsCount: number;
+    holdingsCovered: number;
+    /** Sum of weights (0-100) for the covered holdings. */
+    weightCovered: number;
+    partial?: boolean | null;
+    totalKnownHoldings?: number | null;
+}
+interface WeightedConsensus {
+    upsidePercent: number | null;
+    consensusLabel: string | null;
+    /** Fractions of covered AUM in each bucket. Sums to ~1.0. */
+    distribution: Record<string, number>;
+    totalAnalysts: number;
+}
+interface EtfAnalystContributor {
+    ticker: string;
+    weightPct: number;
+    upsidePercent: number | null;
+    consensusLabel: string | null;
+    /** Signed contribution to the fund's weighted upside in percentage points. */
+    contributionPp: number;
+}
+interface EtfAnalystAggregate {
+    ticker: string;
+    asOfDate: string | null;
+    computedAt: string;
+    coverage: EtfAggregateCoverage;
+    weightedConsensus: WeightedConsensus;
+    /** PRO-only; null on the free preview. */
+    topContributors: EtfAnalystContributor[] | null;
+}
+interface WeightedNetFlow {
+    /** Weighted net dollar flow (buys - sells). Negative = net selling. */
+    netDollars: number;
+    buyDollars: number;
+    sellDollars: number;
+    /** Unweighted; for context. */
+    buyTradeCount: number;
+    /** Unweighted; for context. */
+    sellTradeCount: number;
+    distinctInsiderCount: number;
+}
+interface EtfInsiderContributor {
+    ticker: string;
+    weightPct: number;
+    /** Per-stock net flow over the window (signed). */
+    netDollars: number;
+    /** Signed contribution to the weighted headline. */
+    weightedNetDollars: number;
+    tradeCount: number;
+}
+interface EtfInsiderAggregate {
+    ticker: string;
+    asOfDate: string | null;
+    computedAt: string;
+    lookbackDays: number;
+    coverage: EtfAggregateCoverage;
+    weightedNetFlow: WeightedNetFlow;
+    /** PRO-only; null on the free preview. */
+    topContributors: EtfInsiderContributor[] | null;
+}
+interface EtfSentimentReading {
+    sentiSenseScore: number | null;
+    /** BULLISH / NEUTRAL / BEARISH. */
+    scoreLabel: string;
+    /** Epoch millis when the underlying metric was produced. */
+    asOfTimestamp: number | null;
+}
+interface EtfSentimentAggregate {
+    ticker: string;
+    asOfDate: string | null;
+    computedAt: string;
+    coverage: EtfAggregateCoverage;
+    /** Holdings-weighted SentiSense across the fund's constituents. */
+    constituentsWeighted: EtfSentimentReading;
+    /** Direct reading from mentions of the fund's own ticker. Null for low-mention funds. */
+    direct: EtfSentimentReading | null;
+}
+interface GetEtfInsiderAggregateOptions {
+    /** Trailing window for the trade aggregation. Typical values: 30, 90. Default 30. */
+    lookbackDays?: number;
+}
+/**
+ * ETF discovery, composition (holdings), and holdings-weighted aggregate views.
+ *
+ * Funds aren't rated by analysts directly, don't have insiders of their own, and
+ * may not get many direct news mentions -- but the companies inside them do. The
+ * aggregate endpoints synthesize fund-level views from each constituent's per-stock
+ * data, weighted by allocation, with a coverage block so consumers see how much of
+ * the fund's AUM the underlying data covered.
+ *
+ * Beta as of 2026-05-15: starting with a limited set of widely-traded funds.
+ */
+declare class Etfs {
+    private client;
+    constructor(client: APIClient);
+    /**
+     * List every ETF tracked by SentiSense, sorted by ticker.
+     */
+    list(): Promise<EtfInfo[]>;
+    /**
+     * Get the full holdings composition for an ETF, including per-holding weights
+     * and freshness metadata. Returns 404 for unknown ETFs or commodity-only funds.
+     */
+    holdings(ticker: string): Promise<EtfHoldings>;
+    /**
+     * Get the holdings-weighted analyst consensus for an ETF. Free users receive
+     * the headline and coverage block; PRO unlocks per-holding `topContributors`.
+     */
+    analystAggregate(ticker: string): Promise<PreviewResponse<EtfAnalystAggregate>>;
+    /**
+     * Get the holdings-weighted SEC Form 4 insider aggregate for an ETF over a
+     * configurable trailing window. Free users receive the headline + buy/sell
+     * split; PRO unlocks per-holding `topContributors` with signed contribution.
+     */
+    insiderAggregate(ticker: string, options?: GetEtfInsiderAggregateOptions): Promise<PreviewResponse<EtfInsiderAggregate>>;
+    /**
+     * Get two SentiSense Score readings side-by-side: `constituentsWeighted`
+     * (precomputed daily weighted average across the fund's holdings) and `direct`
+     * (score from mentions of the fund's own ticker). The two can diverge, and the
+     * gap is itself information.
+     */
+    sentimentAggregate(ticker: string): Promise<PreviewResponse<EtfSentimentAggregate>>;
+}
+
 declare class Insider {
     private client;
     constructor(client: APIClient);
@@ -963,6 +1144,7 @@ declare class SentiSense implements APIClient {
     private maxRetries;
     readonly stocks: Stocks;
     readonly documents: Documents;
+    readonly etfs: Etfs;
     readonly institutional: Institutional;
     readonly insider: Insider;
     readonly politicians: Politicians;
@@ -1000,6 +1182,6 @@ declare class APIError extends SentiSenseError {
     constructor(message: string, status: number, code?: string);
 }
 
-declare const VERSION = "0.11.0";
+declare const VERSION = "0.15.0";
 
-export { type AISummary, APIError, type AnalystAction, type AnalystConsensus, type AnalystEarningsSurprise, type AnalystEstimate, type AnalystEstimatesResponse, AuthenticationError, type ChartData, type ChartDataPoint, type ClusterBuy, type CompanyKpisData, type CongressTrade, type Document, type DocumentSource, type FloatInfo, type Fundamentals, type FundamentalsPeriod, type GetAnalystActionsOptions, type GetAnalystMarketActivityOptions, type GetInsiderOptions, type GetInsightsOptions, type GetLatestInsightsOptions, type GetPoliticiansOptions, type GetStockInsightsRangeOptions, type GetUserInsightsOptions, type Holder, type InsiderActivityResponse, type InsiderActivitySummary, type InsiderTrade, type Insight, type InsightPreviewResponse, type InstitutionalFlow, type InstitutionalFlowsResponse, type KBEntity, type KpiCoverageEntry, type KpiCoverageResponse, type KpiDataPoint, type KpiSeries, type KpiTypeEntry, type LockedInsight, type MarketMood, type MarketStatus, type MarketSummary, type MentionCount, type MentionData, 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 SentimentData, 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, VERSION, SentiSense as default };
+export { type AISummary, APIError, type AnalystAction, type AnalystConsensus, type AnalystEarningsSurprise, type AnalystEstimate, type AnalystEstimatesResponse, AuthenticationError, type ChartData, type ChartDataPoint, type ClusterBuy, type CompanyKpisData, type CongressTrade, type Document, type DocumentSource, 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 GetAnalystActionsOptions, type GetAnalystMarketActivityOptions, type GetEtfInsiderAggregateOptions, type GetInsiderOptions, type GetInsightsOptions, type GetLatestInsightsOptions, type GetPoliticiansOptions, type GetStockInsightsRangeOptions, type GetUserInsightsOptions, type Holder, type InsiderActivityResponse, type InsiderActivitySummary, type InsiderTrade, type Insight, type InsightPreviewResponse, type InstitutionalFlow, type InstitutionalFlowsResponse, type KBEntity, type KpiCoverageEntry, type KpiCoverageResponse, type KpiDataPoint, type KpiSeries, type KpiTypeEntry, type LockedInsight, type MarketMood, type MarketStatus, type MarketSummary, type MentionCount, type MentionData, 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 SentimentData, 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, VERSION, type WeightedConsensus, type WeightedNetFlow, SentiSense as default };

package/dist/index.d.ts

@@ -6,16 +6,31 @@ interface SentiSenseOptions {
 }
 interface StockPrice {
     ticker: string;
+    /** Regular-session price. During RTH: live last trade. Otherwise: most recent RTH close. */
     price: number;
     change: number;
     changePercent: number;
     previousClose: number;
     /** Unix timestamp in milliseconds of the price quote. */
     timestamp: number;
+    /** Extended-hours view (pre-market or after-hours). Null/absent during RTH, overnight, and weekends. */
+    extendedHours?: ExtendedHoursInfo | null;
+}
+/**
+ * Extended-hours session view embedded in price / quote responses when the snapshot sees
+ * pre-market (04:00–09:30 ET) or after-hours (16:00–20:00 ET) activity. `change` and
+ * `changePercent` are computed by the server vs the regular-session `currentPrice`.
+ */
+interface ExtendedHoursInfo {
+    session: "pre" | "post";
+    price: number;
+    change: number;
+    changePercent: number;
 }
 /** Aggregate quote snapshot from GET /api/v1/stocks/{ticker}/quote. */
 interface StockQuote {
     ticker: string;
+    /** Regular-session price. During RTH: live last trade. Otherwise: most recent RTH close. */
     currentPrice: number | null;
     change: number | null;
     changePercent: number | null;
@@ -31,7 +46,8 @@ interface StockQuote {
     epsTTM: number | null;
     dividendYield: number | null;
     timestamp: number | null;
-    extendedHours: boolean | null;
+    /** Extended-hours view (pre-market or after-hours). Null/absent during RTH, overnight, and weekends. */
+    extendedHours?: ExtendedHoursInfo | null;
 }
 interface StockDetail {
     ticker: string;
@@ -67,12 +83,20 @@ interface StockEntity {
     [key: string]: unknown;
 }
 interface ChartDataPoint {
+    /** Unix timestamp in milliseconds. */
+    timestamp?: number;
     date: string;
     open: number;
     high: number;
     low: number;
     close: number;
     volume: number;
+    /**
+     * US-equity market session: "pre" (04:00–09:30 ET), "regular" (09:30–16:00 ET),
+     * or "post" (16:00–20:00 ET). Populated for intraday timeframes (1D / 5D / 1W / 1M);
+     * `null` for daily / weekly bars (3M and longer) that span whole sessions.
+     */
+    session?: "pre" | "regular" | "post" | null;
 }
 interface ChartData {
     ticker: string;
@@ -112,7 +136,7 @@ interface AISummary {
     [key: string]: unknown;
 }
 interface GetChartOptions {
-    timeframe?: "1M" | "3M" | "6M" | "1Y";
+    timeframe?: "1D" | "5D" | "1W" | "1M" | "3M" | "6M" | "1Y" | "ALL";
 }
 interface GetImagesOptions {
     forced?: boolean;
@@ -173,8 +197,8 @@ interface Story {
     tickers: string[];
     primaryEntityNames: string[];
     impactScore: number;
-    /** Unix timestamp in seconds when the story first broke. */
-    brokeAt: number;
+    /** Unix timestamp in seconds when the story first broke. Null when the story has no representative document timestamp yet. */
+    brokeAt: number | null;
 }
 interface GetByTickerOptions {
     source?: DocumentSource;
@@ -701,6 +725,163 @@ declare class EntityMetrics {
     getAverageSentiment(symbol: string, options?: EntityMetricsDateRange): Promise<SentimentData>;
 }
 
+interface EtfInfo {
+    ticker: string;
+    name: string;
+    kbEntityId: string | null;
+    urlSlug: string | null;
+    issuer: string | null;
+    trackedIndex: string | null;
+    assetClass: string | null;
+}
+interface EtfHolding {
+    ticker: string;
+    name: string | null;
+    /** Weight in the fund as a percentage (0-100). */
+    weight_pct: number;
+    /** First date this holding appeared in the composition. */
+    first_seen: string | null;
+}
+interface EtfHoldings {
+    ticker: string;
+    issuer: string;
+    issuer_endpoint: string | null;
+    as_of_date: string;
+    fetched_at: string;
+    next_refresh_due: string;
+    total_holdings: number;
+    holdings: EtfHolding[];
+    /** True when this is a top-N view rather than the full fund. */
+    partial?: boolean | null;
+    /** Issuer's reported total holdings when `partial=true`. */
+    total_known_holdings?: number | null;
+}
+interface EtfAggregateCoverage {
+    holdingsCount: number;
+    holdingsCovered: number;
+    /** Sum of weights (0-100) for the covered holdings. */
+    weightCovered: number;
+    partial?: boolean | null;
+    totalKnownHoldings?: number | null;
+}
+interface WeightedConsensus {
+    upsidePercent: number | null;
+    consensusLabel: string | null;
+    /** Fractions of covered AUM in each bucket. Sums to ~1.0. */
+    distribution: Record<string, number>;
+    totalAnalysts: number;
+}
+interface EtfAnalystContributor {
+    ticker: string;
+    weightPct: number;
+    upsidePercent: number | null;
+    consensusLabel: string | null;
+    /** Signed contribution to the fund's weighted upside in percentage points. */
+    contributionPp: number;
+}
+interface EtfAnalystAggregate {
+    ticker: string;
+    asOfDate: string | null;
+    computedAt: string;
+    coverage: EtfAggregateCoverage;
+    weightedConsensus: WeightedConsensus;
+    /** PRO-only; null on the free preview. */
+    topContributors: EtfAnalystContributor[] | null;
+}
+interface WeightedNetFlow {
+    /** Weighted net dollar flow (buys - sells). Negative = net selling. */
+    netDollars: number;
+    buyDollars: number;
+    sellDollars: number;
+    /** Unweighted; for context. */
+    buyTradeCount: number;
+    /** Unweighted; for context. */
+    sellTradeCount: number;
+    distinctInsiderCount: number;
+}
+interface EtfInsiderContributor {
+    ticker: string;
+    weightPct: number;
+    /** Per-stock net flow over the window (signed). */
+    netDollars: number;
+    /** Signed contribution to the weighted headline. */
+    weightedNetDollars: number;
+    tradeCount: number;
+}
+interface EtfInsiderAggregate {
+    ticker: string;
+    asOfDate: string | null;
+    computedAt: string;
+    lookbackDays: number;
+    coverage: EtfAggregateCoverage;
+    weightedNetFlow: WeightedNetFlow;
+    /** PRO-only; null on the free preview. */
+    topContributors: EtfInsiderContributor[] | null;
+}
+interface EtfSentimentReading {
+    sentiSenseScore: number | null;
+    /** BULLISH / NEUTRAL / BEARISH. */
+    scoreLabel: string;
+    /** Epoch millis when the underlying metric was produced. */
+    asOfTimestamp: number | null;
+}
+interface EtfSentimentAggregate {
+    ticker: string;
+    asOfDate: string | null;
+    computedAt: string;
+    coverage: EtfAggregateCoverage;
+    /** Holdings-weighted SentiSense across the fund's constituents. */
+    constituentsWeighted: EtfSentimentReading;
+    /** Direct reading from mentions of the fund's own ticker. Null for low-mention funds. */
+    direct: EtfSentimentReading | null;
+}
+interface GetEtfInsiderAggregateOptions {
+    /** Trailing window for the trade aggregation. Typical values: 30, 90. Default 30. */
+    lookbackDays?: number;
+}
+/**
+ * ETF discovery, composition (holdings), and holdings-weighted aggregate views.
+ *
+ * Funds aren't rated by analysts directly, don't have insiders of their own, and
+ * may not get many direct news mentions -- but the companies inside them do. The
+ * aggregate endpoints synthesize fund-level views from each constituent's per-stock
+ * data, weighted by allocation, with a coverage block so consumers see how much of
+ * the fund's AUM the underlying data covered.
+ *
+ * Beta as of 2026-05-15: starting with a limited set of widely-traded funds.
+ */
+declare class Etfs {
+    private client;
+    constructor(client: APIClient);
+    /**
+     * List every ETF tracked by SentiSense, sorted by ticker.
+     */
+    list(): Promise<EtfInfo[]>;
+    /**
+     * Get the full holdings composition for an ETF, including per-holding weights
+     * and freshness metadata. Returns 404 for unknown ETFs or commodity-only funds.
+     */
+    holdings(ticker: string): Promise<EtfHoldings>;
+    /**
+     * Get the holdings-weighted analyst consensus for an ETF. Free users receive
+     * the headline and coverage block; PRO unlocks per-holding `topContributors`.
+     */
+    analystAggregate(ticker: string): Promise<PreviewResponse<EtfAnalystAggregate>>;
+    /**
+     * Get the holdings-weighted SEC Form 4 insider aggregate for an ETF over a
+     * configurable trailing window. Free users receive the headline + buy/sell
+     * split; PRO unlocks per-holding `topContributors` with signed contribution.
+     */
+    insiderAggregate(ticker: string, options?: GetEtfInsiderAggregateOptions): Promise<PreviewResponse<EtfInsiderAggregate>>;
+    /**
+     * Get two SentiSense Score readings side-by-side: `constituentsWeighted`
+     * (precomputed daily weighted average across the fund's holdings) and `direct`
+     * (score from mentions of the fund's own ticker). The two can diverge, and the
+     * gap is itself information.
+     */
+    sentimentAggregate(ticker: string): Promise<PreviewResponse<EtfSentimentAggregate>>;
+}
+
 declare class Insider {
     private client;
     constructor(client: APIClient);
@@ -963,6 +1144,7 @@ declare class SentiSense implements APIClient {
     private maxRetries;
     readonly stocks: Stocks;
     readonly documents: Documents;
+    readonly etfs: Etfs;
     readonly institutional: Institutional;
     readonly insider: Insider;
     readonly politicians: Politicians;
@@ -1000,6 +1182,6 @@ declare class APIError extends SentiSenseError {
     constructor(message: string, status: number, code?: string);
 }
 
-declare const VERSION = "0.11.0";
+declare const VERSION = "0.15.0";
 
-export { type AISummary, APIError, type AnalystAction, type AnalystConsensus, type AnalystEarningsSurprise, type AnalystEstimate, type AnalystEstimatesResponse, AuthenticationError, type ChartData, type ChartDataPoint, type ClusterBuy, type CompanyKpisData, type CongressTrade, type Document, type DocumentSource, type FloatInfo, type Fundamentals, type FundamentalsPeriod, type GetAnalystActionsOptions, type GetAnalystMarketActivityOptions, type GetInsiderOptions, type GetInsightsOptions, type GetLatestInsightsOptions, type GetPoliticiansOptions, type GetStockInsightsRangeOptions, type GetUserInsightsOptions, type Holder, type InsiderActivityResponse, type InsiderActivitySummary, type InsiderTrade, type Insight, type InsightPreviewResponse, type InstitutionalFlow, type InstitutionalFlowsResponse, type KBEntity, type KpiCoverageEntry, type KpiCoverageResponse, type KpiDataPoint, type KpiSeries, type KpiTypeEntry, type LockedInsight, type MarketMood, type MarketStatus, type MarketSummary, type MentionCount, type MentionData, 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 SentimentData, 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, VERSION, SentiSense as default };
+export { type AISummary, APIError, type AnalystAction, type AnalystConsensus, type AnalystEarningsSurprise, type AnalystEstimate, type AnalystEstimatesResponse, AuthenticationError, type ChartData, type ChartDataPoint, type ClusterBuy, type CompanyKpisData, type CongressTrade, type Document, type DocumentSource, 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 GetAnalystActionsOptions, type GetAnalystMarketActivityOptions, type GetEtfInsiderAggregateOptions, type GetInsiderOptions, type GetInsightsOptions, type GetLatestInsightsOptions, type GetPoliticiansOptions, type GetStockInsightsRangeOptions, type GetUserInsightsOptions, type Holder, type InsiderActivityResponse, type InsiderActivitySummary, type InsiderTrade, type Insight, type InsightPreviewResponse, type InstitutionalFlow, type InstitutionalFlowsResponse, type KBEntity, type KpiCoverageEntry, type KpiCoverageResponse, type KpiDataPoint, type KpiSeries, type KpiTypeEntry, type LockedInsight, type MarketMood, type MarketStatus, type MarketSummary, type MentionCount, type MentionData, 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 SentimentData, 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, VERSION, type WeightedConsensus, type WeightedNetFlow, SentiSense as default };

package/dist/index.mjs

@@ -220,6 +220,59 @@ var EntityMetrics = class {
   }
 };
 
+// src/resources/etfs.ts
+var Etfs = class {
+  constructor(client) {
+    this.client = client;
+  }
+  /**
+   * List every ETF tracked by SentiSense, sorted by ticker.
+   */
+  async list() {
+    return this.client.get("/api/v1/etfs");
+  }
+  /**
+   * Get the full holdings composition for an ETF, including per-holding weights
+   * and freshness metadata. Returns 404 for unknown ETFs or commodity-only funds.
+   */
+  async holdings(ticker) {
+    return this.client.get(
+      `/api/v1/etfs/${encodeURIComponent(ticker.toUpperCase())}/holdings`
+    );
+  }
+  /**
+   * Get the holdings-weighted analyst consensus for an ETF. Free users receive
+   * the headline and coverage block; PRO unlocks per-holding `topContributors`.
+   */
+  async analystAggregate(ticker) {
+    return this.client.get(
+      `/api/v1/etfs/${encodeURIComponent(ticker.toUpperCase())}/aggregates/analyst`
+    );
+  }
+  /**
+   * Get the holdings-weighted SEC Form 4 insider aggregate for an ETF over a
+   * configurable trailing window. Free users receive the headline + buy/sell
+   * split; PRO unlocks per-holding `topContributors` with signed contribution.
+   */
+  async insiderAggregate(ticker, options) {
+    return this.client.get(
+      `/api/v1/etfs/${encodeURIComponent(ticker.toUpperCase())}/aggregates/insider`,
+      options
+    );
+  }
+  /**
+   * Get two SentiSense Score readings side-by-side: `constituentsWeighted`
+   * (precomputed daily weighted average across the fund's holdings) and `direct`
+   * (score from mentions of the fund's own ticker). The two can diverge, and the
+   * gap is itself information.
+   */
+  async sentimentAggregate(ticker) {
+    return this.client.get(
+      `/api/v1/etfs/${encodeURIComponent(ticker.toUpperCase())}/aggregates/sentiment`
+    );
+  }
+};
+
 // src/resources/insider.ts
 var Insider = class {
   constructor(client) {
@@ -612,7 +665,7 @@ var Stocks = class {
 };
 
 // src/version.ts
-var VERSION = "0.11.0";
+var VERSION = "0.15.0";
 
 // src/client.ts
 var DEFAULT_BASE_URL = "https://app.sentisense.ai";
@@ -631,6 +684,7 @@ var SentiSense = class {
     this.maxRetries = options.maxRetries ?? DEFAULT_MAX_RETRIES;
     this.stocks = new Stocks(this);
     this.documents = new Documents(this);
+    this.etfs = new Etfs(this);
     this.institutional = new Institutional(this);
     this.insider = new Insider(this);
     this.politicians = new Politicians(this);