sentisense 0.27.0 → 0.28.0

package/README.md

@@ -21,7 +21,9 @@ const client = new SentiSense({ apiKey: "ss_live_YOUR_KEY" });
 const price = await client.stocks.getPrice("AAPL");
 console.log(price.currentPrice);
 
-const flows = await client.institutional.getFlows("2025-02-14");
+// reportDate is optional; omit it to get the latest available quarter
+// (this one returns a wrapper: see "Response shapes" below)
+const flows = await client.institutional.getFlows();
 ```
 
 ## Features
@@ -32,6 +34,65 @@ const flows = await client.institutional.getFlows("2025-02-14");
 - Namespaced API resources (stocks, documents, institutional, etc.)
 - Typed error hierarchy for clean error handling
 
+## Response shapes
+
+Most methods resolve to the payload directly, but two families wrap it.
+
+> **Known issue: some declared return types describe the inner payload rather than the
+> wrapper.** For the methods listed below, the runtime value is the wrapper, so reading the
+> declared shape gives you `undefined` even though it compiles. Cast to the wrapper type
+> (each is exported) until the declarations are corrected in a future release. The runtime
+> behavior is stable and is what is documented here.
+
+**1. Tier-gated endpoints return a preview envelope.** The payload is in `data`, and
+`isPreview` tells you whether it was truncated for your tier. On a truncated response
+`totalCount` carries the untruncated size, so you can render "showing N of M".
+
+Affected: `institutional.getFlows` / `getHolders` / `getActivists`, and all five
+`insights` methods.
+
+```typescript
+import type { InstitutionalFlows, PreviewResponse, TickerHolders } from "sentisense";
+
+const flows = (await client.institutional.getFlows()) as unknown as
+  PreviewResponse<InstitutionalFlows>;
+
+if (flows.isPreview) {
+  console.log(`Preview: ${flows.data.inflows.length} of ${flows.totalCount}`);
+}
+for (const flow of flows.data.inflows) {
+  console.log(flow.ticker, flow.netSharesChange);
+}
+
+// holders nest one level deeper: ticker-level totals plus the rows
+const holders = (await client.institutional.getHolders("AAPL", "2026-06-30")) as unknown as
+  PreviewResponse<TickerHolders>;
+console.log(`${holders.data.holderCount} holders`);
+const newPositions = holders.data.holders.filter((h) => h.changeType === "NEW");
+```
+
+**2. Document endpoints return a search wrapper.** This is not the preview envelope:
+the rows are in `documents` and there is no `isPreview`.
+
+Affected: `documents.getByTicker` / `getByTickerRange` / `getByEntity` / `search` /
+`getBySource`. Also `stocks.getFundamentalsPeriods`, whose periods are in `periods`.
+
+```typescript
+import type { DocumentSearchResponse } from "sentisense";
+
+const results = (await client.documents.search("NVDA earnings", { days: 7 })) as unknown as
+  DocumentSearchResponse;
+
+console.log(`${results.totalCount} matches`);
+for (const doc of results.documents) {
+  console.log(doc.url, doc.averageSentiment);
+}
+```
+
+Everything else, including `stocks.getPrice()`, `documents.getStories()`,
+`insights.types()` and `institutional.getQuarters()`, resolves to the value itself with no
+wrapper and needs no cast.
+
 ## API Reference
 
 ### Stocks
@@ -96,7 +157,7 @@ client.kb.getAllEntities()
 
 ### Analyst Ratings
 
-The **price target cone** (mean, high, low, upside %) and consensus are **free for everyone, full data via API** — we give it away. Upgrade/downgrade feeds and forward EPS estimates are limited on free, unlimited on PRO.
+The **price target cone** (mean, high, low, upside %) and consensus are **free for everyone, full data via API**: we give it away. Upgrade/downgrade feeds and forward EPS estimates are limited on free, unlimited on PRO.
 
 ```typescript
 client.analyst.consensus("AAPL")                        // Price target cone + consensus. Free for everyone, full data.
@@ -139,9 +200,9 @@ try {
   const summary = await client.stocks.getAISummary("AAPL");
 } catch (error) {
   if (error instanceof AuthenticationError) {
-    // 401 or 403 — invalid/missing API key or insufficient tier
+    // 401 or 403: invalid/missing API key or insufficient tier
   } else if (error instanceof RateLimitError) {
-    // 429 — quota exceeded
+    // 429: quota exceeded
   }
 }
 ```

package/dist/index.cjs

@@ -484,7 +484,13 @@ var Institutional = class {
   async getQuarters() {
     return this.client.get("/api/v1/institutional/quarters");
   }
-  /** Get aggregate institutional activity per ticker for a quarter. */
+  /**
+   * Get aggregate institutional activity per ticker for a quarter.
+   *
+   * `reportDate` is optional: omit it to get the latest available quarter, which may be
+   * a still-open one holding only early filers. The response then carries `reportDate`
+   * plus `isPending` and filer coverage counts so a partial quarter is clearly labeled.
+   */
   async getFlows(reportDate, options) {
     return this.client.get("/api/v1/institutional/flows", {
       reportDate,
@@ -771,7 +777,7 @@ var Trackers = class {
 };
 
 // src/version.ts
-var VERSION = "0.27.0";
+var VERSION = "0.28.0";
 
 // src/client.ts
 var DEFAULT_BASE_URL = "https://app.sentisense.ai";

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/errors.ts","../src/resources/analyst.ts","../src/resources/calendar.ts","../src/resources/documents.ts","../src/resources/entityMetrics.ts","../src/resources/etfs.ts","../src/resources/insider.ts","../src/resources/politicians.ts","../src/resources/insights.ts","../src/resources/institutional.ts","../src/resources/kb.ts","../src/resources/marketMood.ts","../src/resources/marketSummary.ts","../src/resources/stocks.ts","../src/resources/trackers.ts","../src/version.ts","../src/client.ts"],"sourcesContent":["export { SentiSense } from \"./client.js\";\nexport { SentiSense as default } from \"./client.js\";\n\nexport type {\n  AnalystConsensus,\n  AnalystAction,\n  AnalystEstimate,\n  AnalystEarningsSurprise,\n  AnalystEstimatesResponse,\n  GetAnalystActionsOptions,\n  GetAnalystMarketActivityOptions,\n} from \"./resources/analyst.js\";\n\nexport type {\n  GetStockInsightsRangeOptions,\n  GetLatestInsightsOptions,\n  GetUserInsightsOptions,\n} from \"./resources/insights.js\";\n\n// ETF aggregate types\nexport type {\n  EtfInfo,\n  EtfHolding,\n  EtfHoldings,\n  EtfAggregateCoverage,\n  WeightedConsensus,\n  EtfAnalystContributor,\n  EtfAnalystAggregate,\n  WeightedNetFlow,\n  EtfInsiderContributor,\n  EtfInsiderAggregate,\n  EtfSentimentReading,\n  EtfSentimentAggregate,\n  GetEtfInsiderAggregateOptions,\n} from \"./resources/etfs.js\";\n\n// KPI types\nexport type {\n  KpiDataPoint,\n  KpiSeries,\n  CompanyKpisData,\n  KpiCoverageEntry,\n  KpiCoverageResponse,\n  KpiTypeEntry,\n} from \"./types.js\";\n\nexport {\n  SentiSenseError,\n  AuthenticationError,\n  NotFoundError,\n  RateLimitError,\n  APIError,\n} from \"./errors.js\";\n\nexport type {\n  SentiSenseOptions,\n  Insight,\n  InsightPreviewResponse,\n  LockedInsight,\n  GetInsightsOptions,\n  InsiderActivitySummary,\n  InsiderActivityResponse,\n  InsiderTrade,\n  ClusterBuy,\n  GetInsiderOptions,\n  AssetMetadata,\n  CongressTrade,\n  PoliticianSummary,\n  PoliticianDetail,\n  GetPoliticiansOptions,\n  EarningsEvent,\n  CalendarMeta,\n  EarningsCalendarResponse,\n  GetEarningsCalendarOptions,\n  PreviewResponse,\n  StockPrice,\n  StockQuote,\n  StockDetail,\n  SimilarStock,\n  StockImage,\n  StockProfile,\n  StockEntity,\n  ChartData,\n  ChartDataPoint,\n  MarketStatus,\n  Fundamentals,\n  FundamentalsPeriod,\n  ShortInterest,\n  FloatInfo,\n  ShortVolume,\n  AISummary,\n  MetricsBreakdown,\n  Document,\n  DocumentSource,\n  SentimentEntry,\n  Story,\n  StoryCluster,\n  Quarter,\n  InstitutionalFlow,\n  InstitutionalFlowsResponse,\n  Holder,\n  InstitutionSummary,\n  InstitutionList,\n  InstitutionListResponse,\n  ListInstitutionsOptions,\n  MetricType,\n  MetricsOptions,\n  MetricDistributionOptions,\n  ServingMetric,\n  MetricDistribution,\n  MentionData,\n  MentionCount,\n  SentimentData,\n  MarketMood,\n  MarketSummary,\n  KBEntity,\n  TrackerListing,\n  TrackerListResponse,\n  TrackerSnapshot,\n  TrackerSnapshotResponse,\n  TrackerTableRow,\n  TrackerMetricValue,\n  TrackerHeadlineMetric,\n  TrackerGeoEntry,\n  TrackerTimeSeriesPoint,\n  TrackerEvent,\n  TrackerSignal,\n  TrackerSourceRef,\n} from \"./types.js\";\n\nexport { VERSION } from \"./version.js\";\n","export class SentiSenseError extends Error {\n  status?: number;\n  code?: string;\n\n  constructor(message: string, status?: number, code?: string) {\n    super(message);\n    this.name = \"SentiSenseError\";\n    this.status = status;\n    this.code = code;\n  }\n}\n\nexport class AuthenticationError extends SentiSenseError {\n  constructor(message: string, status: number, code?: string) {\n    super(message, status, code);\n    this.name = \"AuthenticationError\";\n  }\n}\n\nexport class NotFoundError extends SentiSenseError {\n  constructor(message: string, code?: string) {\n    super(message, 404, code);\n    this.name = \"NotFoundError\";\n  }\n}\n\nexport class RateLimitError extends SentiSenseError {\n  retryAfter?: number;\n\n  constructor(message: string, code?: string, retryAfter?: number) {\n    super(message, 429, code);\n    this.name = \"RateLimitError\";\n    this.retryAfter = retryAfter;\n  }\n}\n\nexport class APIError extends SentiSenseError {\n  constructor(message: string, status: number, code?: string) {\n    super(message, status, code);\n    this.name = \"APIError\";\n  }\n}\n","import type { APIClient } from \"../client.js\";\nimport type { PreviewResponse } from \"../types.js\";\n\nexport interface AnalystConsensus {\n  ticker: string;\n  currentPrice: number | null;\n  targetLow: number | null;\n  targetMean: number | null;\n  targetHigh: number | null;\n  targetMedian: number | null;\n  numberOfAnalysts: number;\n  upsidePercent: number | null;\n  consensusLabel: string | null;\n  recommendationMean: number | null;\n  /** PRO-only; zero in the free preview. */\n  strongBuy: number;\n  /** PRO-only; zero in the free preview. */\n  buy: number;\n  /** PRO-only; zero in the free preview. */\n  hold: number;\n  /** PRO-only; zero in the free preview. */\n  sell: number;\n  /** PRO-only; zero in the free preview. */\n  strongSell: number;\n  updatedAt: string | null;\n}\n\nexport interface AnalystAction {\n  ticker: string;\n  actionDate: string;\n  firm: string;\n  /** UPGRADE, DOWNGRADE, INITIATE, REITERATE, OTHER */\n  actionType: string;\n  fromGrade: string | null;\n  toGrade: string | null;\n}\n\nexport interface AnalystEstimate {\n  /** Fiscal period descriptor (provider-specific shape). */\n  [key: string]: unknown;\n}\n\nexport interface AnalystEarningsSurprise {\n  /** Past report descriptor (provider-specific shape). */\n  [key: string]: unknown;\n}\n\nexport interface AnalystEstimatesResponse {\n  estimates: AnalystEstimate[];\n  surprises: AnalystEarningsSurprise[];\n}\n\nexport interface GetAnalystActionsOptions {\n  /** Days of history to return. Default 90. */\n  lookbackDays?: number;\n}\n\nexport interface GetAnalystMarketActivityOptions {\n  /** Days of history to return. Default 30. */\n  lookbackDays?: number;\n}\n\n/**\n * Wall Street analyst coverage: aggregate price targets, recommendation distribution,\n * recent upgrade/downgrade actions, and forward EPS estimates with earnings surprise history.\n *\n * Free users receive the price target band (low/mean/high + analyst count + consensus label)\n * in full -- it powers the public projection cone. The buy/hold/sell distribution counts\n * and full action/estimate history are PRO-only.\n */\nexport class Analyst {\n  constructor(private client: APIClient) {}\n\n  /**\n   * Get the aggregate Wall Street consensus for a ticker. Returns 404 if no\n   * coverage exists.\n   */\n  async consensus(\n    ticker: string,\n  ): Promise<PreviewResponse<AnalystConsensus>> {\n    return this.client.get(\n      `/api/v1/analyst/${encodeURIComponent(ticker.toUpperCase())}/consensus`,\n    );\n  }\n\n  /**\n   * Get recent analyst upgrade/downgrade actions for a ticker, newest first.\n   * Free users receive the 3 most recent.\n   */\n  async actions(\n    ticker: string,\n    options?: GetAnalystActionsOptions,\n  ): Promise<PreviewResponse<AnalystAction[]>> {\n    return this.client.get(\n      `/api/v1/analyst/${encodeURIComponent(ticker.toUpperCase())}/actions`,\n      options,\n    );\n  }\n\n  /**\n   * Get forward EPS estimates and earnings surprise history for a ticker.\n   * Free users receive 1 estimate (current quarter) plus the 2 most recent surprises.\n   */\n  async estimates(\n    ticker: string,\n  ): Promise<PreviewResponse<AnalystEstimatesResponse>> {\n    return this.client.get(\n      `/api/v1/analyst/${encodeURIComponent(ticker.toUpperCase())}/estimates`,\n    );\n  }\n\n  /**\n   * Get market-wide recent analyst actions across all covered tickers, newest first.\n   * Free users receive the 5 most recent.\n   */\n  async marketActivity(\n    options?: GetAnalystMarketActivityOptions,\n  ): Promise<PreviewResponse<AnalystAction[]>> {\n    return this.client.get(\"/api/v1/analyst/activity\", options);\n  }\n}\n","import type { APIClient } from \"../client.js\";\nimport type {\n  EarningsCalendarResponse,\n  GetEarningsCalendarOptions,\n  PreviewResponse,\n} from \"../types.js\";\n\nexport class Calendar {\n  constructor(private client: APIClient) {}\n\n  /**\n   * Upcoming company earnings, sorted by date.\n   *\n   * Key-required. A FREE key returns the current week (`isPreview: true`); a PRO\n   * key returns the full forward window (about 30 days). Field richness is\n   * identical across tiers: the gate is how far ahead you can see, not which\n   * columns you get. On a preview, `totalCount` is the full-window event count.\n   */\n  async getEarnings(\n    options?: GetEarningsCalendarOptions,\n  ): Promise<PreviewResponse<EarningsCalendarResponse>> {\n    return this.client.get(\"/api/v1/calendar/earnings\", options);\n  }\n}\n","import type { APIClient } from \"../client.js\";\nimport type {\n  Document,\n  DocumentSource,\n  GetByEntityOptions,\n  GetBySourceOptions,\n  GetByTickerOptions,\n  GetByTickerRangeOptions,\n  GetStoriesByTickerOptions,\n  GetStoriesOptions,\n  SearchDocumentsOptions,\n  Story,\n} from \"../types.js\";\n\nexport class Documents {\n  constructor(private client: APIClient) {}\n\n  /** Get document metrics for a stock. */\n  async getByTicker(ticker: string, options?: GetByTickerOptions): Promise<Document[]> {\n    return this.client.get(`/api/v1/documents/ticker/${encodeURIComponent(ticker)}`, options);\n  }\n\n  /** Get document metrics for a stock within a date range. */\n  async getByTickerRange(ticker: string, options: GetByTickerRangeOptions): Promise<Document[]> {\n    return this.client.get(\n      `/api/v1/documents/ticker/${encodeURIComponent(ticker)}/range`,\n      options,\n    );\n  }\n\n  /** Get document metrics for a KB entity. */\n  async getByEntity(entityId: string, options?: GetByEntityOptions): Promise<Document[]> {\n    return this.client.get(\n      `/api/v1/documents/entity/${encodeURIComponent(entityId)}`,\n      options,\n    );\n  }\n\n  /** Smart search with natural language query parsing. */\n  async search(query: string, options?: SearchDocumentsOptions): Promise<Document[]> {\n    return this.client.get(\"/api/v1/documents/search\", { query, ...options });\n  }\n\n  /** Get latest document metrics from a source type. */\n  async getBySource(source: DocumentSource, options?: GetBySourceOptions): Promise<Document[]> {\n    return this.client.get(\n      `/api/v1/documents/source/${encodeURIComponent(source)}`,\n      options,\n    );\n  }\n\n  /** Get AI-curated news story clusters. */\n  async getStories(options?: GetStoriesOptions): Promise<Story[]> {\n    return this.client.get(\"/api/v1/documents/stories\", options);\n  }\n\n  /** Get full story detail by cluster ID. */\n  async getStoryDetail(clusterId: string): Promise<unknown> {\n    return this.client.get(`/api/v1/documents/stories/${encodeURIComponent(clusterId)}`);\n  }\n\n  /** Get stories for a specific stock. */\n  async getStoriesByTicker(\n    ticker: string,\n    options?: GetStoriesByTickerOptions,\n  ): Promise<Story[]> {\n    return this.client.get(\n      `/api/v1/documents/stories/ticker/${encodeURIComponent(ticker)}`,\n      options,\n    );\n  }\n\n}\n","import type { APIClient } from \"../client.js\";\nimport type {\n  EntityMetricsDateRange,\n  GetMentionCountOptions,\n  GetMentionsOptions,\n  GetSentimentBySourceOptions,\n  MentionCount,\n  MentionData,\n  MetricType,\n  MetricsOptions,\n  MetricDistributionOptions,\n  SentimentData,\n  ServingMetric,\n  MetricDistribution,\n} from \"../types.js\";\n\nexport class EntityMetrics {\n  constructor(private client: APIClient) {}\n\n  // ── v2 API methods ──────────────────────────────────────────\n\n  /**\n   * Get time-series metric data for an entity using the v2 Serving Metrics API.\n   *\n   * @param symbol   Ticker symbol (e.g. \"AAPL\") — the backend resolves the entity.\n   * @param options  Metric type and optional time range / resolution.\n   */\n  async getMetrics(\n    symbol: string,\n    options: MetricsOptions = {},\n  ): Promise<ServingMetric[]> {\n    const { metricType = \"sentiment\", startTime, endTime, maxDataPoints } = options;\n    return this.client.get(\n      `/api/v2/metrics/entity/${encodeURIComponent(symbol)}/metric/${encodeURIComponent(metricType)}`,\n      {\n        ...(startTime !== undefined && { startTime }),\n        ...(endTime !== undefined && { endTime }),\n        ...(maxDataPoints !== undefined && { maxDataPoints }),\n      },\n    );\n  }\n\n  /**\n   * Get distribution data for a metric, broken down by a dimension (default: source).\n   *\n   * @param symbol     Ticker symbol (e.g. \"AAPL\").\n   * @param metricType The metric to break down (e.g. \"mentions\", \"sentiment\").\n   * @param options    Optional dimension parameter.\n   */\n  async getDistribution(\n    symbol: string,\n    metricType: MetricType,\n    options: MetricDistributionOptions = {},\n  ): Promise<MetricDistribution> {\n    const { dimension = \"source\" } = options;\n    return this.client.get(\n      `/api/v2/metrics/entity/${encodeURIComponent(symbol)}/distribution/${encodeURIComponent(metricType)}`,\n      { dimension },\n    );\n  }\n\n  // ── Deprecated v1 methods (kept for backward compatibility) ─\n\n  /**\n   * @deprecated Use `getMetrics(symbol, { metricType: \"mentions\" })` instead.\n   */\n  async getMentions(symbol: string, options?: GetMentionsOptions): Promise<MentionData> {\n    return this.client.get(\n      `/api/v1/entity-metrics/stocks/${encodeURIComponent(symbol)}/mentions`,\n      options,\n    );\n  }\n\n  /**\n   * @deprecated Use `getDistribution(symbol, \"mentions\", { dimension: \"source\" })` instead.\n   */\n  async getMentionCountBySource(\n    symbol: string,\n    options?: EntityMetricsDateRange,\n  ): Promise<MentionCount> {\n    return this.client.get(\n      `/api/v1/entity-metrics/stocks/${encodeURIComponent(symbol)}/mentions/count/by-source`,\n      options,\n    );\n  }\n\n  /**\n   * @deprecated Use `getMetrics(symbol, { metricType: \"mentions\" })` instead.\n   */\n  async getMentionCount(symbol: string, options?: GetMentionCountOptions): Promise<MentionCount> {\n    return this.client.get(\n      `/api/v1/entity-metrics/stocks/${encodeURIComponent(symbol)}/mentions/count`,\n      options,\n    );\n  }\n\n  /**\n   * @deprecated Use `getMetrics(symbol, { metricType: \"sentiment\" })` instead.\n   */\n  async getSentiment(symbol: string, options?: EntityMetricsDateRange): Promise<SentimentData> {\n    return this.client.get(\n      `/api/v1/entity-metrics/stocks/${encodeURIComponent(symbol)}/sentiment`,\n      options,\n    );\n  }\n\n  /**\n   * @deprecated Use `getDistribution(symbol, \"sentiment\", { dimension: \"source\" })` instead.\n   */\n  async getSentimentBySource(\n    symbol: string,\n    options?: GetSentimentBySourceOptions,\n  ): Promise<SentimentData> {\n    return this.client.get(\n      `/api/v1/entity-metrics/stocks/${encodeURIComponent(symbol)}/sentiment/by-source`,\n      options,\n    );\n  }\n\n  /**\n   * @deprecated Use `getMetrics(symbol, { metricType: \"sentiment\" })` instead.\n   */\n  async getAverageSentiment(\n    symbol: string,\n    options?: EntityMetricsDateRange,\n  ): Promise<SentimentData> {\n    return this.client.get(\n      `/api/v1/entity-metrics/stocks/${encodeURIComponent(symbol)}/sentiment/average`,\n      options,\n    );\n  }\n}\n","import type { APIClient } from \"../client.js\";\nimport type { PreviewResponse } from \"../types.js\";\n\nexport interface EtfInfo {\n  ticker: string;\n  name: string;\n  kbEntityId: string | null;\n  urlSlug: string | null;\n  issuer: string | null;\n  trackedIndex: string | null;\n  assetClass: string | null;\n}\n\nexport interface EtfHolding {\n  ticker: string;\n  name: string | null;\n  /** Weight in the fund as a percentage (0-100). */\n  weightPct: number;\n  /** ISO date \"YYYY-MM-DD\" — first date this holding appeared in the composition. */\n  firstSeen: string | null;\n}\n\nexport interface EtfHoldings {\n  ticker: string;\n  issuer: string;\n  issuerEndpoint: string | null;\n  /** ISO date \"YYYY-MM-DD\" — composition snapshot date from the issuer. */\n  asOfDate: string;\n  /** Epoch seconds when SentiSense refreshed the composition. */\n  fetchedAt: number | null;\n  /** ISO date \"YYYY-MM-DD\" — when the composition is scheduled to be refreshed next. */\n  nextRefreshDue: string;\n  totalHoldings: number;\n  holdings: EtfHolding[];\n  /** True when this is a top-N view rather than the full fund. */\n  partial?: boolean | null;\n  /** Issuer's reported total holdings when `partial=true`. */\n  totalKnownHoldings?: number | null;\n}\n\nexport interface EtfAggregateCoverage {\n  holdingsCount: number;\n  holdingsCovered: number;\n  /** Sum of weights (0-100) for the covered holdings. */\n  weightCovered: number;\n  partial?: boolean | null;\n  totalKnownHoldings?: number | null;\n}\n\nexport interface WeightedConsensus {\n  upsidePercent: number | null;\n  consensusLabel: string | null;\n  /** Fractions of covered AUM in each bucket. Sums to ~1.0. */\n  distribution: Record<string, number>;\n  totalAnalysts: number;\n}\n\nexport interface EtfAnalystContributor {\n  ticker: string;\n  weightPct: number;\n  upsidePercent: number | null;\n  consensusLabel: string | null;\n  /** Signed contribution to the fund's weighted upside in percentage points. */\n  contributionPp: number;\n}\n\nexport interface EtfAnalystAggregate {\n  ticker: string;\n  /** ISO date \"YYYY-MM-DD\" — composition snapshot date. */\n  asOfDate: string | null;\n  /** Epoch seconds when this rollup was computed. */\n  computedAt: number;\n  coverage: EtfAggregateCoverage;\n  weightedConsensus: WeightedConsensus;\n  /** Top contributors (up to 10) by absolute contribution to the weighted upside. */\n  topContributors: EtfAnalystContributor[];\n}\n\nexport interface WeightedNetFlow {\n  /** Weighted net dollar flow (buys - sells). Negative = net selling. */\n  netDollars: number;\n  buyDollars: number;\n  sellDollars: number;\n  /** Unweighted; for context. */\n  buyTradeCount: number;\n  /** Unweighted; for context. */\n  sellTradeCount: number;\n  distinctInsiderCount: number;\n}\n\nexport interface EtfInsiderContributor {\n  ticker: string;\n  weightPct: number;\n  /** Per-stock net flow over the window (signed). */\n  netDollars: number;\n  /** Signed contribution to the weighted headline. */\n  weightedNetDollars: number;\n  tradeCount: number;\n}\n\nexport interface EtfInsiderAggregate {\n  ticker: string;\n  /** ISO date \"YYYY-MM-DD\" — composition snapshot date. */\n  asOfDate: string | null;\n  /** Epoch seconds when this rollup was computed. */\n  computedAt: number;\n  lookbackDays: number;\n  coverage: EtfAggregateCoverage;\n  weightedNetFlow: WeightedNetFlow;\n  /** Top contributors (up to 10) by absolute weighted-net-dollar contribution. */\n  topContributors: EtfInsiderContributor[];\n}\n\nexport interface EtfSentimentReading {\n  sentiSenseScore: number | null;\n  /** BULLISH / NEUTRAL / BEARISH. */\n  scoreLabel: string;\n  /** Epoch seconds when the underlying metric was produced. */\n  asOfTimestamp: number | null;\n}\n\nexport interface EtfSentimentAggregate {\n  ticker: string;\n  /** ISO date \"YYYY-MM-DD\" — composition snapshot date. */\n  asOfDate: string | null;\n  /** Epoch seconds when this aggregate was assembled. */\n  computedAt: number;\n  coverage: EtfAggregateCoverage;\n  /** Holdings-weighted SentiSense across the fund's constituents. */\n  constituentsWeighted: EtfSentimentReading;\n  /** Direct reading from mentions of the fund's own ticker. Null for low-mention funds. */\n  direct: EtfSentimentReading | null;\n}\n\nexport interface GetEtfInsiderAggregateOptions {\n  /** Trailing window for the trade aggregation. Typical values: 30, 90. Default 30. */\n  lookbackDays?: number;\n}\n\n/**\n * ETF discovery, composition (holdings), and holdings-weighted aggregate views.\n *\n * Funds aren't rated by analysts directly, don't have insiders of their own, and\n * may not get many direct news mentions -- but the companies inside them do. The\n * aggregate endpoints synthesize fund-level views from each constituent's per-stock\n * data, weighted by allocation, with a coverage block so consumers see how much of\n * the fund's AUM the underlying data covered.\n *\n * Beta as of 2026-05-15: starting with a limited set of widely-traded funds.\n */\nexport class Etfs {\n  constructor(private client: APIClient) {}\n\n  /**\n   * List every ETF tracked by SentiSense, sorted by ticker.\n   */\n  async list(): Promise<EtfInfo[]> {\n    return this.client.get(\"/api/v1/etfs\");\n  }\n\n  /**\n   * Get the full holdings composition for an ETF, including per-holding weights\n   * and freshness metadata. Returns 404 for unknown ETFs or commodity-only funds.\n   */\n  async holdings(ticker: string): Promise<EtfHoldings> {\n    return this.client.get(\n      `/api/v1/etfs/${encodeURIComponent(ticker.toUpperCase())}/holdings`,\n    );\n  }\n\n  /**\n   * Get the holdings-weighted analyst consensus for an ETF, including the\n   * top per-holding contributors that drive the weighted upside.\n   */\n  async analystAggregate(\n    ticker: string,\n  ): Promise<PreviewResponse<EtfAnalystAggregate>> {\n    return this.client.get(\n      `/api/v1/etfs/${encodeURIComponent(ticker.toUpperCase())}/aggregates/analyst`,\n    );\n  }\n\n  /**\n   * Get the holdings-weighted SEC Form 4 insider aggregate for an ETF over a\n   * configurable trailing window, including per-holding `topContributors` with\n   * signed contribution to the weighted headline.\n   */\n  async insiderAggregate(\n    ticker: string,\n    options?: GetEtfInsiderAggregateOptions,\n  ): Promise<PreviewResponse<EtfInsiderAggregate>> {\n    return this.client.get(\n      `/api/v1/etfs/${encodeURIComponent(ticker.toUpperCase())}/aggregates/insider`,\n      options,\n    );\n  }\n\n  /**\n   * Get two SentiSense Score readings side-by-side: `constituentsWeighted`\n   * (precomputed daily weighted average across the fund's holdings) and `direct`\n   * (score from mentions of the fund's own ticker). The two can diverge, and the\n   * gap is itself information.\n   */\n  async sentimentAggregate(\n    ticker: string,\n  ): Promise<PreviewResponse<EtfSentimentAggregate>> {\n    return this.client.get(\n      `/api/v1/etfs/${encodeURIComponent(ticker.toUpperCase())}/aggregates/sentiment`,\n    );\n  }\n}\n","import type { APIClient } from \"../client.js\";\nimport type {\n  InsiderActivityResponse,\n  InsiderTrade,\n  ClusterBuy,\n  GetInsiderOptions,\n  PreviewResponse,\n} from \"../types.js\";\n\nexport class Insider {\n  constructor(private client: APIClient) {}\n\n  /**\n   * Get market-wide insider activity: top buys and sells aggregated by ticker.\n   *\n   * PRO-gated. Free/unauthenticated users receive a preview (top 5 per direction)\n   * with `isPreview: true` in the response.\n   */\n  async getActivity(options?: GetInsiderOptions): Promise<PreviewResponse<InsiderActivityResponse>> {\n    return this.client.get(\"/api/v1/insider/activity\", options);\n  }\n\n  /**\n   * Get individual insider transactions for a specific stock.\n   *\n   * PRO-gated. Free users receive a preview of the top 5 transactions.\n   */\n  async getTrades(ticker: string, options?: GetInsiderOptions): Promise<PreviewResponse<InsiderTrade[]>> {\n    return this.client.get(\n      `/api/v1/insider/trades/${encodeURIComponent(ticker.toUpperCase())}`,\n      options,\n    );\n  }\n\n  /**\n   * Get cluster buy signals: stocks where 3+ distinct insiders bought recently.\n   *\n   * PRO-gated. Free users receive a preview of the top 3 signals.\n   */\n  async getClusterBuys(options?: GetInsiderOptions): Promise<PreviewResponse<ClusterBuy[]>> {\n    return this.client.get(\"/api/v1/insider/cluster-buys\", options);\n  }\n}\n","import type { APIClient } from \"../client.js\";\nimport type {\n  CongressTrade,\n  PoliticianSummary,\n  PoliticianDetail,\n  GetPoliticiansOptions,\n  PreviewResponse,\n} from \"../types.js\";\n\nexport class Politicians {\n  constructor(private client: APIClient) {}\n\n  /**\n   * Get recent congressional STOCK Act trading activity across all politicians.\n   *\n   * PRO-gated. Free/unauthenticated users receive a preview (top 5 trades)\n   * with `isPreview: true` in the response.\n   */\n  async getActivity(\n    options?: GetPoliticiansOptions,\n  ): Promise<PreviewResponse<CongressTrade[]>> {\n    return this.client.get(\"/api/v1/politicians/activity\", options);\n  }\n\n  /**\n   * Get congressional trades for a specific stock.\n   *\n   * PRO-gated. Free users receive a preview of the top 3 trades.\n   */\n  async getFilings(\n    ticker: string,\n    options?: GetPoliticiansOptions,\n  ): Promise<PreviewResponse<CongressTrade[]>> {\n    return this.client.get(\n      `/api/v1/politicians/filings/${encodeURIComponent(ticker.toUpperCase())}`,\n      options,\n    );\n  }\n\n  /**\n   * Get all tracked politicians with trading summary statistics.\n   *\n   * PRO-gated. Free users receive a preview of the top 5 members.\n   */\n  async getMembers(): Promise<PreviewResponse<PoliticianSummary[]>> {\n    return this.client.get(\"/api/v1/politicians/members\");\n  }\n\n  /**\n   * Get detailed profile for a single politician: summary, recent trades, top tickers.\n   *\n   * PRO-gated. Free users receive a preview-wrapped response.\n   */\n  async getMember(slug: string): Promise<PreviewResponse<PoliticianDetail>> {\n    return this.client.get(\n      `/api/v1/politicians/member/${encodeURIComponent(slug)}`,\n    );\n  }\n}\n","import type { APIClient } from \"../client.js\";\nimport type {\n  Insight,\n  InsightPreviewResponse,\n  GetInsightsOptions,\n} from \"../types.js\";\n\nexport interface GetStockInsightsRangeOptions {\n  startDate: string;\n  endDate: string;\n  urgency?: \"low\" | \"medium\" | \"high\";\n  insightType?: string;\n}\n\nexport interface GetLatestInsightsOptions {\n  limit?: number;\n  urgency?: \"low\" | \"medium\" | \"high\";\n}\n\nexport interface GetUserInsightsOptions {\n  limit?: number;\n  category?: string;\n}\n\nexport class Insights {\n  constructor(private client: APIClient) {}\n\n  /**\n   * Get AI-generated insights for a specific stock, sorted by urgency then confidence.\n   *\n   * PRO users receive a flat array of Insight objects.\n   * Free/unauthenticated users receive a preview with `isPreview: true`,\n   * the top 3 insights in full, and a `locked` array with metadata-only entries\n   * (type, urgency, timestamp) showing what additional signals exist.\n   */\n  async stock(\n    ticker: string,\n    options?: GetInsightsOptions,\n  ): Promise<Insight[] | InsightPreviewResponse> {\n    return this.client.get(\n      `/api/v1/insights/stock/${encodeURIComponent(ticker.toUpperCase())}`,\n      options,\n    );\n  }\n\n  /**\n   * Get AI insights for a stock within a date range.\n   *\n   * Free users receive the top 3; PRO users receive the full list.\n   * The server returns 400 if `startDate` is after `endDate`.\n   */\n  async stockRange(\n    ticker: string,\n    options: GetStockInsightsRangeOptions,\n  ): Promise<Insight[] | InsightPreviewResponse> {\n    return this.client.get(\n      `/api/v1/insights/stock/${encodeURIComponent(ticker.toUpperCase())}/range`,\n      options,\n    );\n  }\n\n  /**\n   * Get AI-generated market-level insights, sorted by urgency then confidence.\n   *\n   * PRO users receive a flat array of Insight objects.\n   * Free/unauthenticated users receive a preview with `isPreview: true`,\n   * the top 5 insights in full, and a `locked` array with metadata-only entries.\n   */\n  async market(): Promise<Insight[] | InsightPreviewResponse> {\n    return this.client.get(\"/api/v1/insights/market\");\n  }\n\n  /**\n   * Get the latest AI insights across all tracked stocks, newest first.\n   *\n   * Free users receive the top 5; PRO users receive up to `limit` (clamped to 1-200).\n   */\n  async latest(\n    options?: GetLatestInsightsOptions,\n  ): Promise<Insight[] | InsightPreviewResponse> {\n    return this.client.get(\"/api/v1/insights/latest\", options);\n  }\n\n  /**\n   * Get personalized insights for the authenticated user.\n   *\n   * Biased toward the user's watchlist and portfolio when available; falls back\n   * to market-level insights otherwise. API key authentication required.\n   */\n  async user(\n    options?: GetUserInsightsOptions,\n  ): Promise<Insight[] | InsightPreviewResponse> {\n    return this.client.get(\"/api/v1/insights/user\", options);\n  }\n\n  /**\n   * Get available insight types for a specific stock.\n   * No authentication required.\n   *\n   * Returns an array of insight type strings (e.g., `[\"sentiment_shift\", \"options_activity\"]`).\n   */\n  async types(ticker: string): Promise<string[]> {\n    return this.client.get(\n      `/api/v1/insights/stock/${encodeURIComponent(ticker.toUpperCase())}/types`,\n    );\n  }\n}\n","import type { APIClient } from \"../client.js\";\nimport type {\n  GetFlowsOptions,\n  Holder,\n  InstitutionList,\n  InstitutionListResponse,\n  InstitutionalFlowsResponse,\n  ListInstitutionsOptions,\n  Quarter,\n} from \"../types.js\";\n\nexport class Institutional {\n  constructor(private client: APIClient) {}\n\n  /** Get available 13F reporting quarters. */\n  async getQuarters(): Promise<Quarter[]> {\n    return this.client.get(\"/api/v1/institutional/quarters\");\n  }\n\n  /** Get aggregate institutional activity per ticker for a quarter. */\n  async getFlows(reportDate: string, options?: GetFlowsOptions): Promise<InstitutionalFlowsResponse> {\n    return this.client.get(\"/api/v1/institutional/flows\", {\n      reportDate,\n      ...options,\n    });\n  }\n\n  /** Get institutional holders for a specific stock. */\n  async getHolders(ticker: string, reportDate: string): Promise<Holder[]> {\n    return this.client.get(\n      `/api/v1/institutional/holders/${encodeURIComponent(ticker)}`,\n      { reportDate },\n    );\n  }\n\n  /** Get activist investor positions (NEW or INCREASED). */\n  async getActivists(reportDate: string): Promise<Holder[]> {\n    return this.client.get(\"/api/v1/institutional/activist\", { reportDate });\n  }\n\n  /**\n   * Discover institutions: a paginated, AUM-ranked list of filers (slug + metadata)\n   * so you can find what to query without knowing slugs upfront.\n   *\n   * Each institution is rolled up by parent filer, so a multi-filer manager\n   * (e.g. Vanguard) appears once with combined AUM. Summary only; use\n   * `getInstitutionDetail` for a filer's full holdings.\n   *\n   * Requires an API key but does not consume monthly quota (per-minute rate\n   * limits still apply). Returns the unwrapped list payload.\n   */\n  async listInstitutions(options?: ListInstitutionsOptions): Promise<InstitutionList> {\n    const resp = await this.client.get<InstitutionListResponse>(\n      \"/api/v1/institutional/institutions\",\n      { ...options },\n    );\n    return resp.data;\n  }\n\n  /**\n   * Get the full profile, summary stats, and current-quarter holdings for a\n   * specific institutional filer.\n   *\n   * Resolved by URL slug (e.g. `Berkshire-Hathaway`) or numeric SEC CIK.\n   * Free users receive the profile and top 10 holdings; PRO users receive the\n   * full holdings array. Returns 404 if the slug or CIK is unknown.\n   */\n  async getInstitutionDetail(slugOrCik: string): Promise<unknown> {\n    return this.client.get(\n      `/api/v1/institutional/institution/${encodeURIComponent(slugOrCik)}`,\n    );\n  }\n}\n","import type { APIClient } from \"../client.js\";\nimport type { KBEntity } from \"../types.js\";\n\nexport class KB {\n  constructor(private client: APIClient) {}\n\n  /** Get popular entities for search suggestions. */\n  async getPopularEntities(): Promise<KBEntity[]> {\n    return this.client.get(\"/api/v1/kb/entities/popular\");\n  }\n\n  /** Get entity detail with metrics and relationships. */\n  async getEntity(entityId: string): Promise<KBEntity> {\n    return this.client.get(`/api/v1/kb/entities/${encodeURIComponent(entityId)}`);\n  }\n\n  /** Get all tracked entities. */\n  async getAllEntities(): Promise<KBEntity[]> {\n    return this.client.get(\"/api/v1/kb/entities/all\");\n  }\n}\n","import type { APIClient } from \"../client.js\";\nimport type { MarketMood } from \"../types.js\";\n\nexport class MarketMoodResource {\n  constructor(private client: APIClient) {}\n\n  /** Get market mood data (scores, history, sectors). */\n  async get(): Promise<MarketMood> {\n    return this.client.get(\"/api/v2/market-mood\");\n  }\n\n  // TODO: accept a `days` param to control history length (the endpoint supports ?days=N).\n  // TODO: add a sibling `indexes` resource for /api/v1/indexes/{id} (+ /history), e.g. fed-sentiment.\n}\n","import type { APIClient } from \"../client.js\";\nimport type { MarketSummary } from \"../types.js\";\n\nexport class MarketSummaryResource {\n  constructor(private client: APIClient) {}\n\n  /** Get the AI-generated market summary with headline and analysis. */\n  async get(): Promise<MarketSummary> {\n    return this.client.get(\"/api/v1/market-summary\");\n  }\n}\n","import type { APIClient } from \"../client.js\";\nimport type {\n  AISummary,\n  ChartData,\n  ChartDataPoint,\n  CompanyKpisData,\n  FloatInfo,\n  Fundamentals,\n  FundamentalsPeriod,\n  GetAISummaryOptions,\n  GetChartOptions,\n  GetDescriptionsOptions,\n  GetFundamentalsOptions,\n  GetImagesOptions,\n  GetMetricsBreakdownOptions,\n  GetProfileOptions,\n  GetSimilarOptions,\n  KpiCoverageResponse,\n  KpiTypeEntry,\n  MarketStatus,\n  MetricsBreakdown,\n  PreviewResponse,\n  SimilarStock,\n  ShortInterest,\n  ShortVolume,\n  StockDetail,\n  StockEntity,\n  StockImage,\n  StockPrice,\n  StockProfile,\n  StockQuote,\n} from \"../types.js\";\n\nexport class Stocks {\n  constructor(private client: APIClient) {}\n\n  /** List all available ticker symbols. */\n  async list(): Promise<string[]> {\n    return this.client.get(\"/api/v1/stocks\");\n  }\n\n  /** List all stocks with name, kbEntityId, urlSlug. */\n  async listDetailed(): Promise<StockDetail[]> {\n    return this.client.get(\"/api/v1/stocks/detailed\");\n  }\n\n  /** Get popular ticker symbols. */\n  async listPopular(): Promise<string[]> {\n    return this.client.get(\"/api/v1/stocks/popular\");\n  }\n\n  /** Get popular stocks with details. */\n  async listPopularDetailed(): Promise<StockDetail[]> {\n    return this.client.get(\"/api/v1/stocks/popular/detailed\");\n  }\n\n  /** Get real-time price for a single ticker. */\n  async getPrice(ticker: string): Promise<StockPrice> {\n    return this.client.get(\"/api/v1/stocks/price\", { ticker });\n  }\n\n  /**\n   * Get aggregate quote snapshot: live price, today OHLC, 52-week range,\n   * market cap, P/E, EPS TTM, and dividend yield in a single call.\n   * All fields except `ticker` may be null when upstream data is unavailable.\n   */\n  async getQuote(ticker: string): Promise<StockQuote> {\n    return this.client.get(`/api/v1/stocks/${encodeURIComponent(ticker)}/quote`);\n  }\n\n  /** Get real-time prices for multiple tickers. */\n  async getPrices(tickers: string[]): Promise<StockPrice[]> {\n    return this.client.get(\"/api/v1/stocks/prices\", {\n      tickers: tickers.join(\",\"),\n    });\n  }\n\n  /** Get batch company logo URLs. */\n  async getImages(\n    tickers: string[],\n    options?: GetImagesOptions,\n  ): Promise<Record<string, StockImage>> {\n    return this.client.get(\"/api/v1/stocks/images\", {\n      tickers: tickers.join(\",\"),\n      ...options,\n    });\n  }\n\n  /** Get company profiles with branding, market cap, sector. */\n  async getDescriptions(\n    tickers: string[],\n    options?: GetDescriptionsOptions,\n  ): Promise<Record<string, StockProfile>> {\n    return this.client.get(\"/api/v1/stocks/descriptions\", {\n      tickers: tickers.join(\",\"),\n      ...options,\n    });\n  }\n\n  /** Get peer/similar stocks. */\n  async getSimilar(ticker: string, options?: GetSimilarOptions): Promise<SimilarStock[]> {\n    return this.client.get(`/api/v1/stocks/${encodeURIComponent(ticker)}/similar`, options);\n  }\n\n  /** Get company profile (CEO, sector, industry, market data). */\n  async getProfile(ticker: string, options?: GetProfileOptions): Promise<StockProfile> {\n    return this.client.get(`/api/v1/stocks/${encodeURIComponent(ticker)}/profile`, options);\n  }\n\n  /** Get related KB entities (people, products, partners). */\n  async getEntities(ticker: string): Promise<StockEntity[]> {\n    return this.client.get(`/api/v1/stocks/${encodeURIComponent(ticker)}/entities`);\n  }\n\n  /** Get AI-generated stock analysis report. Requires PRO tier. */\n  async getAISummary(ticker: string, options?: GetAISummaryOptions): Promise<AISummary> {\n    return this.client.get(`/api/v1/stocks/${encodeURIComponent(ticker)}/ai-summary`, options);\n  }\n\n  /** Get sentiment/mention metrics breakdown by entity. */\n  async getMetricsBreakdown(\n    ticker: string,\n    metricType: string,\n    options?: GetMetricsBreakdownOptions,\n  ): Promise<MetricsBreakdown> {\n    return this.client.get(\n      `/api/v1/stocks/${encodeURIComponent(ticker)}/metrics/${encodeURIComponent(metricType)}/breakdown`,\n      options,\n    );\n  }\n\n  /**\n   * Get historical OHLCV chart data.\n   *\n   * The API returns a bare array of points; this normalizes it to\n   * `{ ticker, timeframe, data }`. `timeframe` echoes the requested value\n   * (defaulting to \"1M\", matching the server default when omitted).\n   */\n  async getChart(ticker: string, options?: GetChartOptions): Promise<ChartData> {\n    const data = await this.client.get<ChartDataPoint[]>(\"/api/v1/stocks/chart\", {\n      ticker,\n      ...options,\n    });\n    return { ticker, timeframe: options?.timeframe ?? \"1M\", data };\n  }\n\n  /** Get current market open/closed/pre-market/after-hours status. */\n  async getMarketStatus(): Promise<MarketStatus> {\n    return this.client.get(\"/api/v1/stocks/market-status\");\n  }\n\n  /** Get financial statement data. */\n  async getFundamentals(ticker: string, options?: GetFundamentalsOptions): Promise<Fundamentals> {\n    return this.client.get(\"/api/v1/stocks/fundamentals\", { ticker, ...options });\n  }\n\n  /** Get available fiscal periods. */\n  async getFundamentalsPeriods(ticker: string): Promise<FundamentalsPeriod[]> {\n    return this.client.get(\"/api/v1/stocks/fundamentals/periods\", { ticker });\n  }\n\n  /** Get most recent fundamentals snapshot. */\n  async getCurrentFundamentals(ticker: string): Promise<Fundamentals> {\n    return this.client.get(\"/api/v1/stocks/fundamentals/current\", { ticker });\n  }\n\n  /** Get historical revenue data. */\n  async getHistoricalRevenue(ticker: string): Promise<unknown> {\n    return this.client.get(\"/api/v1/stocks/fundamentals/historical/revenue\", { ticker });\n  }\n\n  /** Get short interest metrics (FINRA). */\n  async getShortInterest(ticker: string): Promise<ShortInterest> {\n    return this.client.get(\"/api/v1/stocks/short-interest\", { ticker });\n  }\n\n  /** Get float information. */\n  async getFloat(ticker: string): Promise<FloatInfo> {\n    return this.client.get(\"/api/v1/stocks/float\", { ticker });\n  }\n\n  /** Get short volume trading data. */\n  async getShortVolume(ticker: string): Promise<ShortVolume> {\n    return this.client.get(\"/api/v1/stocks/short-volume\", { ticker });\n  }\n\n  /**\n   * Get company-specific KPI time-series for a ticker. Returns curated GAAP and\n   * non-GAAP metrics from earnings filings (e.g. iPhone unit sales, Tesla deliveries,\n   * AWS revenue).\n   *\n   * Free users receive metadata only with an empty `kpis` list; PRO users receive\n   * the full series. Returns 404 for tickers that do not yet have curated coverage.\n   *\n   * Coverage today: near-complete for the S&P 500 plus extended universe\n   * (~500 tickers). Use `listKpiCoverage()` to enumerate.\n   */\n  async getKpis(ticker: string): Promise<PreviewResponse<CompanyKpisData>> {\n    return this.client.get(\n      `/api/v1/stocks/${encodeURIComponent(ticker.toUpperCase())}/kpis`,\n    );\n  }\n\n  /**\n   * List every ticker with curated KPI coverage. Returns `{count, tickers: [...]}`\n   * with lightweight metadata (ticker, companyName, lastUpdated, kpiCount).\n   * Sorted alphabetically by ticker.\n   *\n   * Auth: API key required, but the call does NOT consume your monthly quota\n   * (rate-limit-per-minute still applies).\n   */\n  async listKpiCoverage(): Promise<KpiCoverageResponse> {\n    return this.client.get(\"/api/v1/stocks/with-kpis\");\n  }\n\n  /**\n   * List the KPI metadata tuples available for a ticker — `id, name, category,\n   * chartType` — without paying the cost of the full series payload. Mirrors\n   * the `/api/v1/insights/stock/{ticker}/types` precedent.\n   *\n   * Auth: API key required, no quota cost. 404 if the ticker has no curated KPIs.\n   */\n  async getKpiTypes(ticker: string): Promise<KpiTypeEntry[]> {\n    return this.client.get(\n      `/api/v1/stocks/${encodeURIComponent(ticker.toUpperCase())}/kpis/types`,\n    );\n  }\n}\n","import type { APIClient } from \"../client.js\";\nimport type {\n  TrackerListing,\n  TrackerListResponse,\n  TrackerSnapshot,\n  TrackerSnapshotResponse,\n} from \"../types.js\";\n\n/**\n * Trackers — observational data products published as a standardized\n * `TrackerSnapshot` envelope. Every tracker (institution rankings,\n * hedge-fund reported returns, social trackers, surveillance dashboards)\n * returns the same shape — consumers write one renderer per `viewType` and\n * get every current and future SentiSense tracker for free.\n *\n * @see TrackerSnapshot\n */\nexport class Trackers {\n  constructor(private client: APIClient) {}\n\n  /**\n   * List every publicly-visible tracker — id, display name, category,\n   * one-line description, and the methodology anchor to link out to.\n   */\n  async list(): Promise<TrackerListResponse> {\n    return this.client.get(\"/api/v1/trackers\");\n  }\n\n  /**\n   * Standardized snapshot envelope for one tracker.\n   *\n   * Returns the envelope as-is: `{ isPreview, previewReason, totalCount?, data }`.\n   * When `data.viewType === \"table\"` the rows live at `data.rows[]`; when\n   * `\"choropleth\"` they live at `data.geo[]`; etc. Dispatch on `viewType`\n   * in your renderer.\n   *\n   * @param trackerId — slug from {@link list}, e.g. `\"institution-concentration\"`.\n   * @param params — provider-specific query params (e.g. `{ scope: \"us\" }` for\n   *   geographically-scoped trackers like hantavirus). Unknown keys are ignored.\n   */\n  async get(\n    trackerId: string,\n    params?: Record<string, string | number | boolean>,\n  ): Promise<TrackerSnapshotResponse> {\n    return this.client.get(`/api/v1/trackers/${trackerId}`, params);\n  }\n}\n\n// Re-export for convenience so callers can `import type { TrackerListing }`\n// from the resource module instead of `../types`.\nexport type {\n  TrackerListing,\n  TrackerListResponse,\n  TrackerSnapshot,\n  TrackerSnapshotResponse,\n};\n","export const VERSION = \"0.27.0\";\n","import {\n  APIError,\n  AuthenticationError,\n  NotFoundError,\n  RateLimitError,\n  SentiSenseError,\n} from \"./errors.js\";\nimport { Analyst } from \"./resources/analyst.js\";\nimport { Calendar } from \"./resources/calendar.js\";\nimport { Documents } from \"./resources/documents.js\";\nimport { EntityMetrics } from \"./resources/entityMetrics.js\";\nimport { Etfs } from \"./resources/etfs.js\";\nimport { Insider } from \"./resources/insider.js\";\nimport { Politicians } from \"./resources/politicians.js\";\nimport { Insights } from \"./resources/insights.js\";\nimport { Institutional } from \"./resources/institutional.js\";\nimport { KB } from \"./resources/kb.js\";\nimport { MarketMoodResource } from \"./resources/marketMood.js\";\nimport { MarketSummaryResource } from \"./resources/marketSummary.js\";\nimport { Stocks } from \"./resources/stocks.js\";\nimport { Trackers } from \"./resources/trackers.js\";\nimport type { SentiSenseOptions } from \"./types.js\";\nimport { VERSION } from \"./version.js\";\n\nconst DEFAULT_BASE_URL = \"https://app.sentisense.ai\";\nconst DEFAULT_TIMEOUT = 30_000;\nconst DEFAULT_MAX_RETRIES = 3;\nconst BASE_DELAY_MS = 1_000;\nconst MAX_DELAY_MS = 60_000;\n\nfunction sleep(ms: number): Promise<void> {\n  return new Promise((resolve) => setTimeout(resolve, ms));\n}\n\n/** @internal HTTP interface exposed to resource classes. */\nexport interface APIClient {\n  get<T = unknown>(path: string, params?: object): Promise<T>;\n  post<T = unknown>(path: string, body: unknown): Promise<T>;\n}\n\nexport class SentiSense implements APIClient {\n  private baseUrl: string;\n  private apiKey: string | undefined;\n  private timeout: number;\n  private maxRetries: number;\n\n  readonly stocks: Stocks;\n  readonly documents: Documents;\n  readonly etfs: Etfs;\n  readonly institutional: Institutional;\n  readonly insider: Insider;\n  readonly politicians: Politicians;\n  readonly insights: Insights;\n  readonly analyst: Analyst;\n  readonly entityMetrics: EntityMetrics;\n  readonly marketMood: MarketMoodResource;\n  readonly marketSummary: MarketSummaryResource;\n  readonly kb: KB;\n  readonly trackers: Trackers;\n  readonly calendar: Calendar;\n\n  constructor(options: SentiSenseOptions = {}) {\n    this.apiKey = options.apiKey;\n    this.baseUrl = (options.baseUrl ?? DEFAULT_BASE_URL).replace(/\\/+$/, \"\");\n    this.timeout = options.timeout ?? DEFAULT_TIMEOUT;\n    this.maxRetries = options.maxRetries ?? DEFAULT_MAX_RETRIES;\n\n    this.stocks = new Stocks(this);\n    this.documents = new Documents(this);\n    this.etfs = new Etfs(this);\n    this.institutional = new Institutional(this);\n    this.insider = new Insider(this);\n    this.politicians = new Politicians(this);\n    this.insights = new Insights(this);\n    this.analyst = new Analyst(this);\n    this.entityMetrics = new EntityMetrics(this);\n    this.marketMood = new MarketMoodResource(this);\n    this.marketSummary = new MarketSummaryResource(this);\n    this.kb = new KB(this);\n    this.trackers = new Trackers(this);\n    this.calendar = new Calendar(this);\n  }\n\n  /** @internal */\n  async get<T = unknown>(path: string, params?: object): Promise<T> {\n    const url = this.buildUrl(path, params);\n    const headers: Record<string, string> = {\n      \"Accept\": \"application/json\",\n    };\n\n    if (this.apiKey) {\n      headers[\"X-SentiSense-API-Key\"] = this.apiKey;\n    }\n\n    // User-Agent is only set in Node.js (browsers disallow it)\n    if (typeof process !== \"undefined\" && process.versions?.node) {\n      headers[\"User-Agent\"] = `sentisense-node/${VERSION}`;\n    }\n\n    let delayMs = 0;\n\n    for (let attempt = 0; attempt <= this.maxRetries; attempt++) {\n      if (delayMs > 0) {\n        await sleep(delayMs);\n        delayMs = 0;\n      }\n\n      const controller = new AbortController();\n      const timer = setTimeout(() => controller.abort(), this.timeout);\n\n      try {\n        const response = await fetch(url, {\n          method: \"GET\",\n          headers,\n          signal: controller.signal,\n        });\n\n        if (!response.ok) {\n          const isRetryable = response.status === 429 || response.status >= 500;\n          if (isRetryable && attempt < this.maxRetries) {\n            if (response.status === 429) {\n              const ra = response.headers.get(\"Retry-After\");\n              delayMs = (ra ? parseInt(ra, 10) : 60) * 1000;\n            } else {\n              delayMs = Math.min(BASE_DELAY_MS * Math.pow(2, attempt), MAX_DELAY_MS) + Math.random() * 1000;\n            }\n            try { await response.body?.cancel(); } catch { /* ignore */ }\n            continue;\n          }\n          await this.handleErrorResponse(response);\n        }\n\n        return (await response.json()) as T;\n      } catch (error) {\n        if (error instanceof SentiSenseError) throw error;\n        if (error instanceof Error && error.name === \"AbortError\") {\n          throw new SentiSenseError(`Request timed out after ${this.timeout}ms`);\n        }\n        throw new SentiSenseError(\n          error instanceof Error ? error.message : \"Unknown error\",\n        );\n      } finally {\n        clearTimeout(timer);\n      }\n    }\n\n    throw new SentiSenseError(\"All retries exhausted\");\n  }\n\n  /** @internal */\n  async post<T = unknown>(path: string, body: unknown): Promise<T> {\n    const url = this.buildUrl(path);\n    const headers: Record<string, string> = {\n      \"Accept\": \"application/json\",\n      \"Content-Type\": \"application/json\",\n    };\n\n    if (this.apiKey) {\n      headers[\"X-SentiSense-API-Key\"] = this.apiKey;\n    }\n\n    if (typeof process !== \"undefined\" && process.versions?.node) {\n      headers[\"User-Agent\"] = `sentisense-node/${VERSION}`;\n    }\n\n    const controller = new AbortController();\n    const timer = setTimeout(() => controller.abort(), this.timeout);\n\n    try {\n      const response = await fetch(url, {\n        method: \"POST\",\n        headers,\n        body: JSON.stringify(body),\n        signal: controller.signal,\n      });\n\n      if (!response.ok) {\n        await this.handleErrorResponse(response);\n      }\n\n      return (await response.json()) as T;\n    } catch (error) {\n      if (error instanceof SentiSenseError) throw error;\n      if (error instanceof Error && error.name === \"AbortError\") {\n        throw new SentiSenseError(`Request timed out after ${this.timeout}ms`);\n      }\n      throw new SentiSenseError(\n        error instanceof Error ? error.message : \"Unknown error\",\n      );\n    } finally {\n      clearTimeout(timer);\n    }\n  }\n\n  private buildUrl(path: string, params?: object): string {\n    const url = new URL(path, this.baseUrl);\n    if (params) {\n      for (const [key, value] of Object.entries(params as Record<string, unknown>)) {\n        if (value !== undefined && value !== null) {\n          url.searchParams.set(key, String(value));\n        }\n      }\n    }\n    return url.toString();\n  }\n\n  private async handleErrorResponse(response: Response): Promise<never> {\n    let body: { error?: string; message?: string } = {};\n    try {\n      body = await response.json();\n    } catch {\n      // Response may not be JSON\n    }\n\n    const message = body.message ?? response.statusText ?? \"API request failed\";\n    const code = body.error;\n\n    switch (response.status) {\n      case 401:\n      case 403:\n        throw new AuthenticationError(message, response.status, code);\n      case 404:\n        throw new NotFoundError(message, code);\n      case 429: {\n        const ra = response.headers.get(\"Retry-After\");\n        throw new RateLimitError(message, code, ra ? parseInt(ra, 10) : undefined);\n      }\n      default:\n        throw new APIError(message, response.status, code);\n    }\n  }\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/index.ts","../src/errors.ts","../src/resources/analyst.ts","../src/resources/calendar.ts","../src/resources/documents.ts","../src/resources/entityMetrics.ts","../src/resources/etfs.ts","../src/resources/insider.ts","../src/resources/politicians.ts","../src/resources/insights.ts","../src/resources/institutional.ts","../src/resources/kb.ts","../src/resources/marketMood.ts","../src/resources/marketSummary.ts","../src/resources/stocks.ts","../src/resources/trackers.ts","../src/version.ts","../src/client.ts"],"sourcesContent":["export { SentiSense } from \"./client.js\";\nexport { SentiSense as default } from \"./client.js\";\n\nexport type {\n  AnalystConsensus,\n  AnalystAction,\n  AnalystEstimate,\n  AnalystEarningsSurprise,\n  AnalystEstimatesResponse,\n  GetAnalystActionsOptions,\n  GetAnalystMarketActivityOptions,\n} from \"./resources/analyst.js\";\n\nexport type {\n  GetStockInsightsRangeOptions,\n  GetLatestInsightsOptions,\n  GetUserInsightsOptions,\n} from \"./resources/insights.js\";\n\n// ETF aggregate types\nexport type {\n  EtfInfo,\n  EtfHolding,\n  EtfHoldings,\n  EtfAggregateCoverage,\n  WeightedConsensus,\n  EtfAnalystContributor,\n  EtfAnalystAggregate,\n  WeightedNetFlow,\n  EtfInsiderContributor,\n  EtfInsiderAggregate,\n  EtfSentimentReading,\n  EtfSentimentAggregate,\n  GetEtfInsiderAggregateOptions,\n} from \"./resources/etfs.js\";\n\n// KPI types\nexport type {\n  KpiDataPoint,\n  KpiSeries,\n  CompanyKpisData,\n  KpiCoverageEntry,\n  KpiCoverageResponse,\n  KpiTypeEntry,\n} from \"./types.js\";\n\nexport {\n  SentiSenseError,\n  AuthenticationError,\n  NotFoundError,\n  RateLimitError,\n  APIError,\n} from \"./errors.js\";\n\nexport type {\n  SentiSenseOptions,\n  Insight,\n  InsightPreviewResponse,\n  LockedInsight,\n  GetInsightsOptions,\n  InsiderActivitySummary,\n  InsiderActivityResponse,\n  InsiderTrade,\n  ClusterBuy,\n  GetInsiderOptions,\n  AssetMetadata,\n  CongressTrade,\n  PoliticianSummary,\n  PoliticianDetail,\n  GetPoliticiansOptions,\n  EarningsEvent,\n  CalendarMeta,\n  EarningsCalendarResponse,\n  GetEarningsCalendarOptions,\n  PreviewResponse,\n  StockPrice,\n  StockQuote,\n  StockDetail,\n  SimilarStock,\n  StockImage,\n  StockProfile,\n  StockEntity,\n  ChartData,\n  ChartDataPoint,\n  MarketStatus,\n  Fundamentals,\n  FundamentalsPeriod,\n  ShortInterest,\n  FloatInfo,\n  ShortVolume,\n  AISummary,\n  MetricsBreakdown,\n  Document,\n  DocumentSource,\n  SentimentEntry,\n  Story,\n  StoryCluster,\n  Quarter,\n  InstitutionalFlow,\n  InstitutionalFlowsResponse,\n  Holder,\n  InstitutionSummary,\n  InstitutionList,\n  InstitutionListResponse,\n  ListInstitutionsOptions,\n  MetricType,\n  MetricsOptions,\n  MetricDistributionOptions,\n  ServingMetric,\n  MetricDistribution,\n  MentionData,\n  MentionCount,\n  SentimentData,\n  MarketMood,\n  MarketSummary,\n  KBEntity,\n  TrackerListing,\n  TrackerListResponse,\n  TrackerSnapshot,\n  TrackerSnapshotResponse,\n  TrackerTableRow,\n  TrackerMetricValue,\n  TrackerHeadlineMetric,\n  TrackerGeoEntry,\n  TrackerTimeSeriesPoint,\n  TrackerEvent,\n  TrackerSignal,\n  TrackerSourceRef,\n} from \"./types.js\";\n\nexport { VERSION } from \"./version.js\";\n","export class SentiSenseError extends Error {\n  status?: number;\n  code?: string;\n\n  constructor(message: string, status?: number, code?: string) {\n    super(message);\n    this.name = \"SentiSenseError\";\n    this.status = status;\n    this.code = code;\n  }\n}\n\nexport class AuthenticationError extends SentiSenseError {\n  constructor(message: string, status: number, code?: string) {\n    super(message, status, code);\n    this.name = \"AuthenticationError\";\n  }\n}\n\nexport class NotFoundError extends SentiSenseError {\n  constructor(message: string, code?: string) {\n    super(message, 404, code);\n    this.name = \"NotFoundError\";\n  }\n}\n\nexport class RateLimitError extends SentiSenseError {\n  retryAfter?: number;\n\n  constructor(message: string, code?: string, retryAfter?: number) {\n    super(message, 429, code);\n    this.name = \"RateLimitError\";\n    this.retryAfter = retryAfter;\n  }\n}\n\nexport class APIError extends SentiSenseError {\n  constructor(message: string, status: number, code?: string) {\n    super(message, status, code);\n    this.name = \"APIError\";\n  }\n}\n","import type { APIClient } from \"../client.js\";\nimport type { PreviewResponse } from \"../types.js\";\n\nexport interface AnalystConsensus {\n  ticker: string;\n  currentPrice: number | null;\n  targetLow: number | null;\n  targetMean: number | null;\n  targetHigh: number | null;\n  targetMedian: number | null;\n  numberOfAnalysts: number;\n  upsidePercent: number | null;\n  consensusLabel: string | null;\n  recommendationMean: number | null;\n  /** PRO-only; zero in the free preview. */\n  strongBuy: number;\n  /** PRO-only; zero in the free preview. */\n  buy: number;\n  /** PRO-only; zero in the free preview. */\n  hold: number;\n  /** PRO-only; zero in the free preview. */\n  sell: number;\n  /** PRO-only; zero in the free preview. */\n  strongSell: number;\n  updatedAt: string | null;\n}\n\nexport interface AnalystAction {\n  ticker: string;\n  actionDate: string;\n  firm: string;\n  /** UPGRADE, DOWNGRADE, INITIATE, REITERATE, OTHER */\n  actionType: string;\n  fromGrade: string | null;\n  toGrade: string | null;\n}\n\nexport interface AnalystEstimate {\n  /** Fiscal period descriptor (provider-specific shape). */\n  [key: string]: unknown;\n}\n\nexport interface AnalystEarningsSurprise {\n  /** Past report descriptor (provider-specific shape). */\n  [key: string]: unknown;\n}\n\nexport interface AnalystEstimatesResponse {\n  estimates: AnalystEstimate[];\n  surprises: AnalystEarningsSurprise[];\n}\n\nexport interface GetAnalystActionsOptions {\n  /** Days of history to return. Default 90. */\n  lookbackDays?: number;\n}\n\nexport interface GetAnalystMarketActivityOptions {\n  /** Days of history to return. Default 30. */\n  lookbackDays?: number;\n}\n\n/**\n * Wall Street analyst coverage: aggregate price targets, recommendation distribution,\n * recent upgrade/downgrade actions, and forward EPS estimates with earnings surprise history.\n *\n * Free users receive the price target band (low/mean/high + analyst count + consensus label)\n * in full -- it powers the public projection cone. The buy/hold/sell distribution counts\n * and full action/estimate history are PRO-only.\n */\nexport class Analyst {\n  constructor(private client: APIClient) {}\n\n  /**\n   * Get the aggregate Wall Street consensus for a ticker. Returns 404 if no\n   * coverage exists.\n   */\n  async consensus(\n    ticker: string,\n  ): Promise<PreviewResponse<AnalystConsensus>> {\n    return this.client.get(\n      `/api/v1/analyst/${encodeURIComponent(ticker.toUpperCase())}/consensus`,\n    );\n  }\n\n  /**\n   * Get recent analyst upgrade/downgrade actions for a ticker, newest first.\n   * Free users receive the 3 most recent.\n   */\n  async actions(\n    ticker: string,\n    options?: GetAnalystActionsOptions,\n  ): Promise<PreviewResponse<AnalystAction[]>> {\n    return this.client.get(\n      `/api/v1/analyst/${encodeURIComponent(ticker.toUpperCase())}/actions`,\n      options,\n    );\n  }\n\n  /**\n   * Get forward EPS estimates and earnings surprise history for a ticker.\n   * Free users receive 1 estimate (current quarter) plus the 2 most recent surprises.\n   */\n  async estimates(\n    ticker: string,\n  ): Promise<PreviewResponse<AnalystEstimatesResponse>> {\n    return this.client.get(\n      `/api/v1/analyst/${encodeURIComponent(ticker.toUpperCase())}/estimates`,\n    );\n  }\n\n  /**\n   * Get market-wide recent analyst actions across all covered tickers, newest first.\n   * Free users receive the 5 most recent.\n   */\n  async marketActivity(\n    options?: GetAnalystMarketActivityOptions,\n  ): Promise<PreviewResponse<AnalystAction[]>> {\n    return this.client.get(\"/api/v1/analyst/activity\", options);\n  }\n}\n","import type { APIClient } from \"../client.js\";\nimport type {\n  EarningsCalendarResponse,\n  GetEarningsCalendarOptions,\n  PreviewResponse,\n} from \"../types.js\";\n\nexport class Calendar {\n  constructor(private client: APIClient) {}\n\n  /**\n   * Upcoming company earnings, sorted by date.\n   *\n   * Key-required. A FREE key returns the current week (`isPreview: true`); a PRO\n   * key returns the full forward window (about 30 days). Field richness is\n   * identical across tiers: the gate is how far ahead you can see, not which\n   * columns you get. On a preview, `totalCount` is the full-window event count.\n   */\n  async getEarnings(\n    options?: GetEarningsCalendarOptions,\n  ): Promise<PreviewResponse<EarningsCalendarResponse>> {\n    return this.client.get(\"/api/v1/calendar/earnings\", options);\n  }\n}\n","import type { APIClient } from \"../client.js\";\nimport type {\n  Document,\n  DocumentSource,\n  GetByEntityOptions,\n  GetBySourceOptions,\n  GetByTickerOptions,\n  GetByTickerRangeOptions,\n  GetStoriesByTickerOptions,\n  GetStoriesOptions,\n  SearchDocumentsOptions,\n  Story,\n} from \"../types.js\";\n\nexport class Documents {\n  constructor(private client: APIClient) {}\n\n  /** Get document metrics for a stock. */\n  async getByTicker(ticker: string, options?: GetByTickerOptions): Promise<Document[]> {\n    return this.client.get(`/api/v1/documents/ticker/${encodeURIComponent(ticker)}`, options);\n  }\n\n  /** Get document metrics for a stock within a date range. */\n  async getByTickerRange(ticker: string, options: GetByTickerRangeOptions): Promise<Document[]> {\n    return this.client.get(\n      `/api/v1/documents/ticker/${encodeURIComponent(ticker)}/range`,\n      options,\n    );\n  }\n\n  /** Get document metrics for a KB entity. */\n  async getByEntity(entityId: string, options?: GetByEntityOptions): Promise<Document[]> {\n    return this.client.get(\n      `/api/v1/documents/entity/${encodeURIComponent(entityId)}`,\n      options,\n    );\n  }\n\n  /** Smart search with natural language query parsing. */\n  async search(query: string, options?: SearchDocumentsOptions): Promise<Document[]> {\n    return this.client.get(\"/api/v1/documents/search\", { query, ...options });\n  }\n\n  /** Get latest document metrics from a source type. */\n  async getBySource(source: DocumentSource, options?: GetBySourceOptions): Promise<Document[]> {\n    return this.client.get(\n      `/api/v1/documents/source/${encodeURIComponent(source)}`,\n      options,\n    );\n  }\n\n  /** Get AI-curated news story clusters. */\n  async getStories(options?: GetStoriesOptions): Promise<Story[]> {\n    return this.client.get(\"/api/v1/documents/stories\", options);\n  }\n\n  /** Get full story detail by cluster ID. */\n  async getStoryDetail(clusterId: string): Promise<unknown> {\n    return this.client.get(`/api/v1/documents/stories/${encodeURIComponent(clusterId)}`);\n  }\n\n  /** Get stories for a specific stock. */\n  async getStoriesByTicker(\n    ticker: string,\n    options?: GetStoriesByTickerOptions,\n  ): Promise<Story[]> {\n    return this.client.get(\n      `/api/v1/documents/stories/ticker/${encodeURIComponent(ticker)}`,\n      options,\n    );\n  }\n\n}\n","import type { APIClient } from \"../client.js\";\nimport type {\n  EntityMetricsDateRange,\n  GetMentionCountOptions,\n  GetMentionsOptions,\n  GetSentimentBySourceOptions,\n  MentionCount,\n  MentionData,\n  MetricType,\n  MetricsOptions,\n  MetricDistributionOptions,\n  SentimentData,\n  ServingMetric,\n  MetricDistribution,\n} from \"../types.js\";\n\nexport class EntityMetrics {\n  constructor(private client: APIClient) {}\n\n  // ── v2 API methods ──────────────────────────────────────────\n\n  /**\n   * Get time-series metric data for an entity using the v2 Serving Metrics API.\n   *\n   * @param symbol   Ticker symbol (e.g. \"AAPL\") — the backend resolves the entity.\n   * @param options  Metric type and optional time range / resolution.\n   */\n  async getMetrics(\n    symbol: string,\n    options: MetricsOptions = {},\n  ): Promise<ServingMetric[]> {\n    const { metricType = \"sentiment\", startTime, endTime, maxDataPoints } = options;\n    return this.client.get(\n      `/api/v2/metrics/entity/${encodeURIComponent(symbol)}/metric/${encodeURIComponent(metricType)}`,\n      {\n        ...(startTime !== undefined && { startTime }),\n        ...(endTime !== undefined && { endTime }),\n        ...(maxDataPoints !== undefined && { maxDataPoints }),\n      },\n    );\n  }\n\n  /**\n   * Get distribution data for a metric, broken down by a dimension (default: source).\n   *\n   * @param symbol     Ticker symbol (e.g. \"AAPL\").\n   * @param metricType The metric to break down (e.g. \"mentions\", \"sentiment\").\n   * @param options    Optional dimension parameter.\n   */\n  async getDistribution(\n    symbol: string,\n    metricType: MetricType,\n    options: MetricDistributionOptions = {},\n  ): Promise<MetricDistribution> {\n    const { dimension = \"source\" } = options;\n    return this.client.get(\n      `/api/v2/metrics/entity/${encodeURIComponent(symbol)}/distribution/${encodeURIComponent(metricType)}`,\n      { dimension },\n    );\n  }\n\n  // ── Deprecated v1 methods (kept for backward compatibility) ─\n\n  /**\n   * @deprecated Use `getMetrics(symbol, { metricType: \"mentions\" })` instead.\n   */\n  async getMentions(symbol: string, options?: GetMentionsOptions): Promise<MentionData> {\n    return this.client.get(\n      `/api/v1/entity-metrics/stocks/${encodeURIComponent(symbol)}/mentions`,\n      options,\n    );\n  }\n\n  /**\n   * @deprecated Use `getDistribution(symbol, \"mentions\", { dimension: \"source\" })` instead.\n   */\n  async getMentionCountBySource(\n    symbol: string,\n    options?: EntityMetricsDateRange,\n  ): Promise<MentionCount> {\n    return this.client.get(\n      `/api/v1/entity-metrics/stocks/${encodeURIComponent(symbol)}/mentions/count/by-source`,\n      options,\n    );\n  }\n\n  /**\n   * @deprecated Use `getMetrics(symbol, { metricType: \"mentions\" })` instead.\n   */\n  async getMentionCount(symbol: string, options?: GetMentionCountOptions): Promise<MentionCount> {\n    return this.client.get(\n      `/api/v1/entity-metrics/stocks/${encodeURIComponent(symbol)}/mentions/count`,\n      options,\n    );\n  }\n\n  /**\n   * @deprecated Use `getMetrics(symbol, { metricType: \"sentiment\" })` instead.\n   */\n  async getSentiment(symbol: string, options?: EntityMetricsDateRange): Promise<SentimentData> {\n    return this.client.get(\n      `/api/v1/entity-metrics/stocks/${encodeURIComponent(symbol)}/sentiment`,\n      options,\n    );\n  }\n\n  /**\n   * @deprecated Use `getDistribution(symbol, \"sentiment\", { dimension: \"source\" })` instead.\n   */\n  async getSentimentBySource(\n    symbol: string,\n    options?: GetSentimentBySourceOptions,\n  ): Promise<SentimentData> {\n    return this.client.get(\n      `/api/v1/entity-metrics/stocks/${encodeURIComponent(symbol)}/sentiment/by-source`,\n      options,\n    );\n  }\n\n  /**\n   * @deprecated Use `getMetrics(symbol, { metricType: \"sentiment\" })` instead.\n   */\n  async getAverageSentiment(\n    symbol: string,\n    options?: EntityMetricsDateRange,\n  ): Promise<SentimentData> {\n    return this.client.get(\n      `/api/v1/entity-metrics/stocks/${encodeURIComponent(symbol)}/sentiment/average`,\n      options,\n    );\n  }\n}\n","import type { APIClient } from \"../client.js\";\nimport type { PreviewResponse } from \"../types.js\";\n\nexport interface EtfInfo {\n  ticker: string;\n  name: string;\n  kbEntityId: string | null;\n  urlSlug: string | null;\n  issuer: string | null;\n  trackedIndex: string | null;\n  assetClass: string | null;\n}\n\nexport interface EtfHolding {\n  ticker: string;\n  name: string | null;\n  /** Weight in the fund as a percentage (0-100). */\n  weightPct: number;\n  /** ISO date \"YYYY-MM-DD\" — first date this holding appeared in the composition. */\n  firstSeen: string | null;\n}\n\nexport interface EtfHoldings {\n  ticker: string;\n  issuer: string;\n  issuerEndpoint: string | null;\n  /** ISO date \"YYYY-MM-DD\" — composition snapshot date from the issuer. */\n  asOfDate: string;\n  /** Epoch seconds when SentiSense refreshed the composition. */\n  fetchedAt: number | null;\n  /** ISO date \"YYYY-MM-DD\" — when the composition is scheduled to be refreshed next. */\n  nextRefreshDue: string;\n  totalHoldings: number;\n  holdings: EtfHolding[];\n  /** True when this is a top-N view rather than the full fund. */\n  partial?: boolean | null;\n  /** Issuer's reported total holdings when `partial=true`. */\n  totalKnownHoldings?: number | null;\n}\n\nexport interface EtfAggregateCoverage {\n  holdingsCount: number;\n  holdingsCovered: number;\n  /** Sum of weights (0-100) for the covered holdings. */\n  weightCovered: number;\n  partial?: boolean | null;\n  totalKnownHoldings?: number | null;\n}\n\nexport interface WeightedConsensus {\n  upsidePercent: number | null;\n  consensusLabel: string | null;\n  /** Fractions of covered AUM in each bucket. Sums to ~1.0. */\n  distribution: Record<string, number>;\n  totalAnalysts: number;\n}\n\nexport interface EtfAnalystContributor {\n  ticker: string;\n  weightPct: number;\n  upsidePercent: number | null;\n  consensusLabel: string | null;\n  /** Signed contribution to the fund's weighted upside in percentage points. */\n  contributionPp: number;\n}\n\nexport interface EtfAnalystAggregate {\n  ticker: string;\n  /** ISO date \"YYYY-MM-DD\" — composition snapshot date. */\n  asOfDate: string | null;\n  /** Epoch seconds when this rollup was computed. */\n  computedAt: number;\n  coverage: EtfAggregateCoverage;\n  weightedConsensus: WeightedConsensus;\n  /** Top contributors (up to 10) by absolute contribution to the weighted upside. */\n  topContributors: EtfAnalystContributor[];\n}\n\nexport interface WeightedNetFlow {\n  /** Weighted net dollar flow (buys - sells). Negative = net selling. */\n  netDollars: number;\n  buyDollars: number;\n  sellDollars: number;\n  /** Unweighted; for context. */\n  buyTradeCount: number;\n  /** Unweighted; for context. */\n  sellTradeCount: number;\n  distinctInsiderCount: number;\n}\n\nexport interface EtfInsiderContributor {\n  ticker: string;\n  weightPct: number;\n  /** Per-stock net flow over the window (signed). */\n  netDollars: number;\n  /** Signed contribution to the weighted headline. */\n  weightedNetDollars: number;\n  tradeCount: number;\n}\n\nexport interface EtfInsiderAggregate {\n  ticker: string;\n  /** ISO date \"YYYY-MM-DD\" — composition snapshot date. */\n  asOfDate: string | null;\n  /** Epoch seconds when this rollup was computed. */\n  computedAt: number;\n  lookbackDays: number;\n  coverage: EtfAggregateCoverage;\n  weightedNetFlow: WeightedNetFlow;\n  /** Top contributors (up to 10) by absolute weighted-net-dollar contribution. */\n  topContributors: EtfInsiderContributor[];\n}\n\nexport interface EtfSentimentReading {\n  sentiSenseScore: number | null;\n  /** BULLISH / NEUTRAL / BEARISH. */\n  scoreLabel: string;\n  /** Epoch seconds when the underlying metric was produced. */\n  asOfTimestamp: number | null;\n}\n\nexport interface EtfSentimentAggregate {\n  ticker: string;\n  /** ISO date \"YYYY-MM-DD\" — composition snapshot date. */\n  asOfDate: string | null;\n  /** Epoch seconds when this aggregate was assembled. */\n  computedAt: number;\n  coverage: EtfAggregateCoverage;\n  /** Holdings-weighted SentiSense across the fund's constituents. */\n  constituentsWeighted: EtfSentimentReading;\n  /** Direct reading from mentions of the fund's own ticker. Null for low-mention funds. */\n  direct: EtfSentimentReading | null;\n}\n\nexport interface GetEtfInsiderAggregateOptions {\n  /** Trailing window for the trade aggregation. Typical values: 30, 90. Default 30. */\n  lookbackDays?: number;\n}\n\n/**\n * ETF discovery, composition (holdings), and holdings-weighted aggregate views.\n *\n * Funds aren't rated by analysts directly, don't have insiders of their own, and\n * may not get many direct news mentions -- but the companies inside them do. The\n * aggregate endpoints synthesize fund-level views from each constituent's per-stock\n * data, weighted by allocation, with a coverage block so consumers see how much of\n * the fund's AUM the underlying data covered.\n *\n * Beta as of 2026-05-15: starting with a limited set of widely-traded funds.\n */\nexport class Etfs {\n  constructor(private client: APIClient) {}\n\n  /**\n   * List every ETF tracked by SentiSense, sorted by ticker.\n   */\n  async list(): Promise<EtfInfo[]> {\n    return this.client.get(\"/api/v1/etfs\");\n  }\n\n  /**\n   * Get the full holdings composition for an ETF, including per-holding weights\n   * and freshness metadata. Returns 404 for unknown ETFs or commodity-only funds.\n   */\n  async holdings(ticker: string): Promise<EtfHoldings> {\n    return this.client.get(\n      `/api/v1/etfs/${encodeURIComponent(ticker.toUpperCase())}/holdings`,\n    );\n  }\n\n  /**\n   * Get the holdings-weighted analyst consensus for an ETF, including the\n   * top per-holding contributors that drive the weighted upside.\n   */\n  async analystAggregate(\n    ticker: string,\n  ): Promise<PreviewResponse<EtfAnalystAggregate>> {\n    return this.client.get(\n      `/api/v1/etfs/${encodeURIComponent(ticker.toUpperCase())}/aggregates/analyst`,\n    );\n  }\n\n  /**\n   * Get the holdings-weighted SEC Form 4 insider aggregate for an ETF over a\n   * configurable trailing window, including per-holding `topContributors` with\n   * signed contribution to the weighted headline.\n   */\n  async insiderAggregate(\n    ticker: string,\n    options?: GetEtfInsiderAggregateOptions,\n  ): Promise<PreviewResponse<EtfInsiderAggregate>> {\n    return this.client.get(\n      `/api/v1/etfs/${encodeURIComponent(ticker.toUpperCase())}/aggregates/insider`,\n      options,\n    );\n  }\n\n  /**\n   * Get two SentiSense Score readings side-by-side: `constituentsWeighted`\n   * (precomputed daily weighted average across the fund's holdings) and `direct`\n   * (score from mentions of the fund's own ticker). The two can diverge, and the\n   * gap is itself information.\n   */\n  async sentimentAggregate(\n    ticker: string,\n  ): Promise<PreviewResponse<EtfSentimentAggregate>> {\n    return this.client.get(\n      `/api/v1/etfs/${encodeURIComponent(ticker.toUpperCase())}/aggregates/sentiment`,\n    );\n  }\n}\n","import type { APIClient } from \"../client.js\";\nimport type {\n  InsiderActivityResponse,\n  InsiderTrade,\n  ClusterBuy,\n  GetInsiderOptions,\n  PreviewResponse,\n} from \"../types.js\";\n\nexport class Insider {\n  constructor(private client: APIClient) {}\n\n  /**\n   * Get market-wide insider activity: top buys and sells aggregated by ticker.\n   *\n   * PRO-gated. Free/unauthenticated users receive a preview (top 5 per direction)\n   * with `isPreview: true` in the response.\n   */\n  async getActivity(options?: GetInsiderOptions): Promise<PreviewResponse<InsiderActivityResponse>> {\n    return this.client.get(\"/api/v1/insider/activity\", options);\n  }\n\n  /**\n   * Get individual insider transactions for a specific stock.\n   *\n   * PRO-gated. Free users receive a preview of the top 5 transactions.\n   */\n  async getTrades(ticker: string, options?: GetInsiderOptions): Promise<PreviewResponse<InsiderTrade[]>> {\n    return this.client.get(\n      `/api/v1/insider/trades/${encodeURIComponent(ticker.toUpperCase())}`,\n      options,\n    );\n  }\n\n  /**\n   * Get cluster buy signals: stocks where 3+ distinct insiders bought recently.\n   *\n   * PRO-gated. Free users receive a preview of the top 3 signals.\n   */\n  async getClusterBuys(options?: GetInsiderOptions): Promise<PreviewResponse<ClusterBuy[]>> {\n    return this.client.get(\"/api/v1/insider/cluster-buys\", options);\n  }\n}\n","import type { APIClient } from \"../client.js\";\nimport type {\n  CongressTrade,\n  PoliticianSummary,\n  PoliticianDetail,\n  GetPoliticiansOptions,\n  PreviewResponse,\n} from \"../types.js\";\n\nexport class Politicians {\n  constructor(private client: APIClient) {}\n\n  /**\n   * Get recent congressional STOCK Act trading activity across all politicians.\n   *\n   * PRO-gated. Free/unauthenticated users receive a preview (top 5 trades)\n   * with `isPreview: true` in the response.\n   */\n  async getActivity(\n    options?: GetPoliticiansOptions,\n  ): Promise<PreviewResponse<CongressTrade[]>> {\n    return this.client.get(\"/api/v1/politicians/activity\", options);\n  }\n\n  /**\n   * Get congressional trades for a specific stock.\n   *\n   * PRO-gated. Free users receive a preview of the top 3 trades.\n   */\n  async getFilings(\n    ticker: string,\n    options?: GetPoliticiansOptions,\n  ): Promise<PreviewResponse<CongressTrade[]>> {\n    return this.client.get(\n      `/api/v1/politicians/filings/${encodeURIComponent(ticker.toUpperCase())}`,\n      options,\n    );\n  }\n\n  /**\n   * Get all tracked politicians with trading summary statistics.\n   *\n   * PRO-gated. Free users receive a preview of the top 5 members.\n   */\n  async getMembers(): Promise<PreviewResponse<PoliticianSummary[]>> {\n    return this.client.get(\"/api/v1/politicians/members\");\n  }\n\n  /**\n   * Get detailed profile for a single politician: summary, recent trades, top tickers.\n   *\n   * PRO-gated. Free users receive a preview-wrapped response.\n   */\n  async getMember(slug: string): Promise<PreviewResponse<PoliticianDetail>> {\n    return this.client.get(\n      `/api/v1/politicians/member/${encodeURIComponent(slug)}`,\n    );\n  }\n}\n","import type { APIClient } from \"../client.js\";\nimport type {\n  Insight,\n  InsightPreviewResponse,\n  GetInsightsOptions,\n} from \"../types.js\";\n\nexport interface GetStockInsightsRangeOptions {\n  startDate: string;\n  endDate: string;\n  urgency?: \"low\" | \"medium\" | \"high\";\n  insightType?: string;\n}\n\nexport interface GetLatestInsightsOptions {\n  limit?: number;\n  urgency?: \"low\" | \"medium\" | \"high\";\n}\n\nexport interface GetUserInsightsOptions {\n  limit?: number;\n  category?: string;\n}\n\nexport class Insights {\n  constructor(private client: APIClient) {}\n\n  /**\n   * Get AI-generated insights for a specific stock, sorted by urgency then confidence.\n   *\n   * PRO users receive a flat array of Insight objects.\n   * Free/unauthenticated users receive a preview with `isPreview: true`,\n   * the top 3 insights in full, and a `locked` array with metadata-only entries\n   * (type, urgency, timestamp) showing what additional signals exist.\n   */\n  async stock(\n    ticker: string,\n    options?: GetInsightsOptions,\n  ): Promise<Insight[] | InsightPreviewResponse> {\n    return this.client.get(\n      `/api/v1/insights/stock/${encodeURIComponent(ticker.toUpperCase())}`,\n      options,\n    );\n  }\n\n  /**\n   * Get AI insights for a stock within a date range.\n   *\n   * Free users receive the top 3; PRO users receive the full list.\n   * The server returns 400 if `startDate` is after `endDate`.\n   */\n  async stockRange(\n    ticker: string,\n    options: GetStockInsightsRangeOptions,\n  ): Promise<Insight[] | InsightPreviewResponse> {\n    return this.client.get(\n      `/api/v1/insights/stock/${encodeURIComponent(ticker.toUpperCase())}/range`,\n      options,\n    );\n  }\n\n  /**\n   * Get AI-generated market-level insights, sorted by urgency then confidence.\n   *\n   * PRO users receive a flat array of Insight objects.\n   * Free/unauthenticated users receive a preview with `isPreview: true`,\n   * the top 5 insights in full, and a `locked` array with metadata-only entries.\n   */\n  async market(): Promise<Insight[] | InsightPreviewResponse> {\n    return this.client.get(\"/api/v1/insights/market\");\n  }\n\n  /**\n   * Get the latest AI insights across all tracked stocks, newest first.\n   *\n   * Free users receive the top 5; PRO users receive up to `limit` (clamped to 1-200).\n   */\n  async latest(\n    options?: GetLatestInsightsOptions,\n  ): Promise<Insight[] | InsightPreviewResponse> {\n    return this.client.get(\"/api/v1/insights/latest\", options);\n  }\n\n  /**\n   * Get personalized insights for the authenticated user.\n   *\n   * Biased toward the user's watchlist and portfolio when available; falls back\n   * to market-level insights otherwise. API key authentication required.\n   */\n  async user(\n    options?: GetUserInsightsOptions,\n  ): Promise<Insight[] | InsightPreviewResponse> {\n    return this.client.get(\"/api/v1/insights/user\", options);\n  }\n\n  /**\n   * Get available insight types for a specific stock.\n   * No authentication required.\n   *\n   * Returns an array of insight type strings (e.g., `[\"sentiment_shift\", \"options_activity\"]`).\n   */\n  async types(ticker: string): Promise<string[]> {\n    return this.client.get(\n      `/api/v1/insights/stock/${encodeURIComponent(ticker.toUpperCase())}/types`,\n    );\n  }\n}\n","import type { APIClient } from \"../client.js\";\nimport type {\n  GetFlowsOptions,\n  Holder,\n  InstitutionList,\n  InstitutionListResponse,\n  InstitutionalFlowsResponse,\n  ListInstitutionsOptions,\n  Quarter,\n} from \"../types.js\";\n\nexport class Institutional {\n  constructor(private client: APIClient) {}\n\n  /** Get available 13F reporting quarters. */\n  async getQuarters(): Promise<Quarter[]> {\n    return this.client.get(\"/api/v1/institutional/quarters\");\n  }\n\n  /**\n   * Get aggregate institutional activity per ticker for a quarter.\n   *\n   * `reportDate` is optional: omit it to get the latest available quarter, which may be\n   * a still-open one holding only early filers. The response then carries `reportDate`\n   * plus `isPending` and filer coverage counts so a partial quarter is clearly labeled.\n   */\n  async getFlows(reportDate?: string, options?: GetFlowsOptions): Promise<InstitutionalFlowsResponse> {\n    return this.client.get(\"/api/v1/institutional/flows\", {\n      reportDate,\n      ...options,\n    });\n  }\n\n  /** Get institutional holders for a specific stock. */\n  async getHolders(ticker: string, reportDate: string): Promise<Holder[]> {\n    return this.client.get(\n      `/api/v1/institutional/holders/${encodeURIComponent(ticker)}`,\n      { reportDate },\n    );\n  }\n\n  /** Get activist investor positions (NEW or INCREASED). */\n  async getActivists(reportDate: string): Promise<Holder[]> {\n    return this.client.get(\"/api/v1/institutional/activist\", { reportDate });\n  }\n\n  /**\n   * Discover institutions: a paginated, AUM-ranked list of filers (slug + metadata)\n   * so you can find what to query without knowing slugs upfront.\n   *\n   * Each institution is rolled up by parent filer, so a multi-filer manager\n   * (e.g. Vanguard) appears once with combined AUM. Summary only; use\n   * `getInstitutionDetail` for a filer's full holdings.\n   *\n   * Requires an API key but does not consume monthly quota (per-minute rate\n   * limits still apply). Returns the unwrapped list payload.\n   */\n  async listInstitutions(options?: ListInstitutionsOptions): Promise<InstitutionList> {\n    const resp = await this.client.get<InstitutionListResponse>(\n      \"/api/v1/institutional/institutions\",\n      { ...options },\n    );\n    return resp.data;\n  }\n\n  /**\n   * Get the full profile, summary stats, and current-quarter holdings for a\n   * specific institutional filer.\n   *\n   * Resolved by URL slug (e.g. `Berkshire-Hathaway`) or numeric SEC CIK.\n   * Free users receive the profile and top 10 holdings; PRO users receive the\n   * full holdings array. Returns 404 if the slug or CIK is unknown.\n   */\n  async getInstitutionDetail(slugOrCik: string): Promise<unknown> {\n    return this.client.get(\n      `/api/v1/institutional/institution/${encodeURIComponent(slugOrCik)}`,\n    );\n  }\n}\n","import type { APIClient } from \"../client.js\";\nimport type { KBEntity } from \"../types.js\";\n\nexport class KB {\n  constructor(private client: APIClient) {}\n\n  /** Get popular entities for search suggestions. */\n  async getPopularEntities(): Promise<KBEntity[]> {\n    return this.client.get(\"/api/v1/kb/entities/popular\");\n  }\n\n  /** Get entity detail with metrics and relationships. */\n  async getEntity(entityId: string): Promise<KBEntity> {\n    return this.client.get(`/api/v1/kb/entities/${encodeURIComponent(entityId)}`);\n  }\n\n  /** Get all tracked entities. */\n  async getAllEntities(): Promise<KBEntity[]> {\n    return this.client.get(\"/api/v1/kb/entities/all\");\n  }\n}\n","import type { APIClient } from \"../client.js\";\nimport type { MarketMood } from \"../types.js\";\n\nexport class MarketMoodResource {\n  constructor(private client: APIClient) {}\n\n  /** Get market mood data (scores, history, sectors). */\n  async get(): Promise<MarketMood> {\n    return this.client.get(\"/api/v2/market-mood\");\n  }\n\n  // TODO: accept a `days` param to control history length (the endpoint supports ?days=N).\n  // TODO: add a sibling `indexes` resource for /api/v1/indexes/{id} (+ /history), e.g. fed-sentiment.\n}\n","import type { APIClient } from \"../client.js\";\nimport type { MarketSummary } from \"../types.js\";\n\nexport class MarketSummaryResource {\n  constructor(private client: APIClient) {}\n\n  /** Get the AI-generated market summary with headline and analysis. */\n  async get(): Promise<MarketSummary> {\n    return this.client.get(\"/api/v1/market-summary\");\n  }\n}\n","import type { APIClient } from \"../client.js\";\nimport type {\n  AISummary,\n  ChartData,\n  ChartDataPoint,\n  CompanyKpisData,\n  FloatInfo,\n  Fundamentals,\n  FundamentalsPeriod,\n  GetAISummaryOptions,\n  GetChartOptions,\n  GetDescriptionsOptions,\n  GetFundamentalsOptions,\n  GetImagesOptions,\n  GetMetricsBreakdownOptions,\n  GetProfileOptions,\n  GetSimilarOptions,\n  KpiCoverageResponse,\n  KpiTypeEntry,\n  MarketStatus,\n  MetricsBreakdown,\n  PreviewResponse,\n  SimilarStock,\n  ShortInterest,\n  ShortVolume,\n  StockDetail,\n  StockEntity,\n  StockImage,\n  StockPrice,\n  StockProfile,\n  StockQuote,\n} from \"../types.js\";\n\nexport class Stocks {\n  constructor(private client: APIClient) {}\n\n  /** List all available ticker symbols. */\n  async list(): Promise<string[]> {\n    return this.client.get(\"/api/v1/stocks\");\n  }\n\n  /** List all stocks with name, kbEntityId, urlSlug. */\n  async listDetailed(): Promise<StockDetail[]> {\n    return this.client.get(\"/api/v1/stocks/detailed\");\n  }\n\n  /** Get popular ticker symbols. */\n  async listPopular(): Promise<string[]> {\n    return this.client.get(\"/api/v1/stocks/popular\");\n  }\n\n  /** Get popular stocks with details. */\n  async listPopularDetailed(): Promise<StockDetail[]> {\n    return this.client.get(\"/api/v1/stocks/popular/detailed\");\n  }\n\n  /** Get real-time price for a single ticker. */\n  async getPrice(ticker: string): Promise<StockPrice> {\n    return this.client.get(\"/api/v1/stocks/price\", { ticker });\n  }\n\n  /**\n   * Get aggregate quote snapshot: live price, today OHLC, 52-week range,\n   * market cap, P/E, EPS TTM, and dividend yield in a single call.\n   * All fields except `ticker` may be null when upstream data is unavailable.\n   */\n  async getQuote(ticker: string): Promise<StockQuote> {\n    return this.client.get(`/api/v1/stocks/${encodeURIComponent(ticker)}/quote`);\n  }\n\n  /** Get real-time prices for multiple tickers. */\n  async getPrices(tickers: string[]): Promise<StockPrice[]> {\n    return this.client.get(\"/api/v1/stocks/prices\", {\n      tickers: tickers.join(\",\"),\n    });\n  }\n\n  /** Get batch company logo URLs. */\n  async getImages(\n    tickers: string[],\n    options?: GetImagesOptions,\n  ): Promise<Record<string, StockImage>> {\n    return this.client.get(\"/api/v1/stocks/images\", {\n      tickers: tickers.join(\",\"),\n      ...options,\n    });\n  }\n\n  /** Get company profiles with branding, market cap, sector. */\n  async getDescriptions(\n    tickers: string[],\n    options?: GetDescriptionsOptions,\n  ): Promise<Record<string, StockProfile>> {\n    return this.client.get(\"/api/v1/stocks/descriptions\", {\n      tickers: tickers.join(\",\"),\n      ...options,\n    });\n  }\n\n  /** Get peer/similar stocks. */\n  async getSimilar(ticker: string, options?: GetSimilarOptions): Promise<SimilarStock[]> {\n    return this.client.get(`/api/v1/stocks/${encodeURIComponent(ticker)}/similar`, options);\n  }\n\n  /** Get company profile (CEO, sector, industry, market data). */\n  async getProfile(ticker: string, options?: GetProfileOptions): Promise<StockProfile> {\n    return this.client.get(`/api/v1/stocks/${encodeURIComponent(ticker)}/profile`, options);\n  }\n\n  /** Get related KB entities (people, products, partners). */\n  async getEntities(ticker: string): Promise<StockEntity[]> {\n    return this.client.get(`/api/v1/stocks/${encodeURIComponent(ticker)}/entities`);\n  }\n\n  /** Get AI-generated stock analysis report. Requires PRO tier. */\n  async getAISummary(ticker: string, options?: GetAISummaryOptions): Promise<AISummary> {\n    return this.client.get(`/api/v1/stocks/${encodeURIComponent(ticker)}/ai-summary`, options);\n  }\n\n  /** Get sentiment/mention metrics breakdown by entity. */\n  async getMetricsBreakdown(\n    ticker: string,\n    metricType: string,\n    options?: GetMetricsBreakdownOptions,\n  ): Promise<MetricsBreakdown> {\n    return this.client.get(\n      `/api/v1/stocks/${encodeURIComponent(ticker)}/metrics/${encodeURIComponent(metricType)}/breakdown`,\n      options,\n    );\n  }\n\n  /**\n   * Get historical OHLCV chart data.\n   *\n   * The API returns a bare array of points; this normalizes it to\n   * `{ ticker, timeframe, data }`. `timeframe` echoes the requested value\n   * (defaulting to \"1M\", matching the server default when omitted).\n   */\n  async getChart(ticker: string, options?: GetChartOptions): Promise<ChartData> {\n    const data = await this.client.get<ChartDataPoint[]>(\"/api/v1/stocks/chart\", {\n      ticker,\n      ...options,\n    });\n    return { ticker, timeframe: options?.timeframe ?? \"1M\", data };\n  }\n\n  /** Get current market open/closed/pre-market/after-hours status. */\n  async getMarketStatus(): Promise<MarketStatus> {\n    return this.client.get(\"/api/v1/stocks/market-status\");\n  }\n\n  /** Get financial statement data. */\n  async getFundamentals(ticker: string, options?: GetFundamentalsOptions): Promise<Fundamentals> {\n    return this.client.get(\"/api/v1/stocks/fundamentals\", { ticker, ...options });\n  }\n\n  /** Get available fiscal periods. */\n  async getFundamentalsPeriods(ticker: string): Promise<FundamentalsPeriod[]> {\n    return this.client.get(\"/api/v1/stocks/fundamentals/periods\", { ticker });\n  }\n\n  /** Get most recent fundamentals snapshot. */\n  async getCurrentFundamentals(ticker: string): Promise<Fundamentals> {\n    return this.client.get(\"/api/v1/stocks/fundamentals/current\", { ticker });\n  }\n\n  /** Get historical revenue data. */\n  async getHistoricalRevenue(ticker: string): Promise<unknown> {\n    return this.client.get(\"/api/v1/stocks/fundamentals/historical/revenue\", { ticker });\n  }\n\n  /** Get short interest metrics (FINRA). */\n  async getShortInterest(ticker: string): Promise<ShortInterest> {\n    return this.client.get(\"/api/v1/stocks/short-interest\", { ticker });\n  }\n\n  /** Get float information. */\n  async getFloat(ticker: string): Promise<FloatInfo> {\n    return this.client.get(\"/api/v1/stocks/float\", { ticker });\n  }\n\n  /** Get short volume trading data. */\n  async getShortVolume(ticker: string): Promise<ShortVolume> {\n    return this.client.get(\"/api/v1/stocks/short-volume\", { ticker });\n  }\n\n  /**\n   * Get company-specific KPI time-series for a ticker. Returns curated GAAP and\n   * non-GAAP metrics from earnings filings (e.g. iPhone unit sales, Tesla deliveries,\n   * AWS revenue).\n   *\n   * Free users receive metadata only with an empty `kpis` list; PRO users receive\n   * the full series. Returns 404 for tickers that do not yet have curated coverage.\n   *\n   * Coverage today: near-complete for the S&P 500 plus extended universe\n   * (~500 tickers). Use `listKpiCoverage()` to enumerate.\n   */\n  async getKpis(ticker: string): Promise<PreviewResponse<CompanyKpisData>> {\n    return this.client.get(\n      `/api/v1/stocks/${encodeURIComponent(ticker.toUpperCase())}/kpis`,\n    );\n  }\n\n  /**\n   * List every ticker with curated KPI coverage. Returns `{count, tickers: [...]}`\n   * with lightweight metadata (ticker, companyName, lastUpdated, kpiCount).\n   * Sorted alphabetically by ticker.\n   *\n   * Auth: API key required, but the call does NOT consume your monthly quota\n   * (rate-limit-per-minute still applies).\n   */\n  async listKpiCoverage(): Promise<KpiCoverageResponse> {\n    return this.client.get(\"/api/v1/stocks/with-kpis\");\n  }\n\n  /**\n   * List the KPI metadata tuples available for a ticker — `id, name, category,\n   * chartType` — without paying the cost of the full series payload. Mirrors\n   * the `/api/v1/insights/stock/{ticker}/types` precedent.\n   *\n   * Auth: API key required, no quota cost. 404 if the ticker has no curated KPIs.\n   */\n  async getKpiTypes(ticker: string): Promise<KpiTypeEntry[]> {\n    return this.client.get(\n      `/api/v1/stocks/${encodeURIComponent(ticker.toUpperCase())}/kpis/types`,\n    );\n  }\n}\n","import type { APIClient } from \"../client.js\";\nimport type {\n  TrackerListing,\n  TrackerListResponse,\n  TrackerSnapshot,\n  TrackerSnapshotResponse,\n} from \"../types.js\";\n\n/**\n * Trackers — observational data products published as a standardized\n * `TrackerSnapshot` envelope. Every tracker (institution rankings,\n * hedge-fund reported returns, social trackers, surveillance dashboards)\n * returns the same shape — consumers write one renderer per `viewType` and\n * get every current and future SentiSense tracker for free.\n *\n * @see TrackerSnapshot\n */\nexport class Trackers {\n  constructor(private client: APIClient) {}\n\n  /**\n   * List every publicly-visible tracker — id, display name, category,\n   * one-line description, and the methodology anchor to link out to.\n   */\n  async list(): Promise<TrackerListResponse> {\n    return this.client.get(\"/api/v1/trackers\");\n  }\n\n  /**\n   * Standardized snapshot envelope for one tracker.\n   *\n   * Returns the envelope as-is: `{ isPreview, previewReason, totalCount?, data }`.\n   * When `data.viewType === \"table\"` the rows live at `data.rows[]`; when\n   * `\"choropleth\"` they live at `data.geo[]`; etc. Dispatch on `viewType`\n   * in your renderer.\n   *\n   * @param trackerId — slug from {@link list}, e.g. `\"institution-concentration\"`.\n   * @param params — provider-specific query params (e.g. `{ scope: \"us\" }` for\n   *   geographically-scoped trackers like hantavirus). Unknown keys are ignored.\n   */\n  async get(\n    trackerId: string,\n    params?: Record<string, string | number | boolean>,\n  ): Promise<TrackerSnapshotResponse> {\n    return this.client.get(`/api/v1/trackers/${trackerId}`, params);\n  }\n}\n\n// Re-export for convenience so callers can `import type { TrackerListing }`\n// from the resource module instead of `../types`.\nexport type {\n  TrackerListing,\n  TrackerListResponse,\n  TrackerSnapshot,\n  TrackerSnapshotResponse,\n};\n","export const VERSION = \"0.28.0\";\n","import {\n  APIError,\n  AuthenticationError,\n  NotFoundError,\n  RateLimitError,\n  SentiSenseError,\n} from \"./errors.js\";\nimport { Analyst } from \"./resources/analyst.js\";\nimport { Calendar } from \"./resources/calendar.js\";\nimport { Documents } from \"./resources/documents.js\";\nimport { EntityMetrics } from \"./resources/entityMetrics.js\";\nimport { Etfs } from \"./resources/etfs.js\";\nimport { Insider } from \"./resources/insider.js\";\nimport { Politicians } from \"./resources/politicians.js\";\nimport { Insights } from \"./resources/insights.js\";\nimport { Institutional } from \"./resources/institutional.js\";\nimport { KB } from \"./resources/kb.js\";\nimport { MarketMoodResource } from \"./resources/marketMood.js\";\nimport { MarketSummaryResource } from \"./resources/marketSummary.js\";\nimport { Stocks } from \"./resources/stocks.js\";\nimport { Trackers } from \"./resources/trackers.js\";\nimport type { SentiSenseOptions } from \"./types.js\";\nimport { VERSION } from \"./version.js\";\n\nconst DEFAULT_BASE_URL = \"https://app.sentisense.ai\";\nconst DEFAULT_TIMEOUT = 30_000;\nconst DEFAULT_MAX_RETRIES = 3;\nconst BASE_DELAY_MS = 1_000;\nconst MAX_DELAY_MS = 60_000;\n\nfunction sleep(ms: number): Promise<void> {\n  return new Promise((resolve) => setTimeout(resolve, ms));\n}\n\n/** @internal HTTP interface exposed to resource classes. */\nexport interface APIClient {\n  get<T = unknown>(path: string, params?: object): Promise<T>;\n  post<T = unknown>(path: string, body: unknown): Promise<T>;\n}\n\nexport class SentiSense implements APIClient {\n  private baseUrl: string;\n  private apiKey: string | undefined;\n  private timeout: number;\n  private maxRetries: number;\n\n  readonly stocks: Stocks;\n  readonly documents: Documents;\n  readonly etfs: Etfs;\n  readonly institutional: Institutional;\n  readonly insider: Insider;\n  readonly politicians: Politicians;\n  readonly insights: Insights;\n  readonly analyst: Analyst;\n  readonly entityMetrics: EntityMetrics;\n  readonly marketMood: MarketMoodResource;\n  readonly marketSummary: MarketSummaryResource;\n  readonly kb: KB;\n  readonly trackers: Trackers;\n  readonly calendar: Calendar;\n\n  constructor(options: SentiSenseOptions = {}) {\n    this.apiKey = options.apiKey;\n    this.baseUrl = (options.baseUrl ?? DEFAULT_BASE_URL).replace(/\\/+$/, \"\");\n    this.timeout = options.timeout ?? DEFAULT_TIMEOUT;\n    this.maxRetries = options.maxRetries ?? DEFAULT_MAX_RETRIES;\n\n    this.stocks = new Stocks(this);\n    this.documents = new Documents(this);\n    this.etfs = new Etfs(this);\n    this.institutional = new Institutional(this);\n    this.insider = new Insider(this);\n    this.politicians = new Politicians(this);\n    this.insights = new Insights(this);\n    this.analyst = new Analyst(this);\n    this.entityMetrics = new EntityMetrics(this);\n    this.marketMood = new MarketMoodResource(this);\n    this.marketSummary = new MarketSummaryResource(this);\n    this.kb = new KB(this);\n    this.trackers = new Trackers(this);\n    this.calendar = new Calendar(this);\n  }\n\n  /** @internal */\n  async get<T = unknown>(path: string, params?: object): Promise<T> {\n    const url = this.buildUrl(path, params);\n    const headers: Record<string, string> = {\n      \"Accept\": \"application/json\",\n    };\n\n    if (this.apiKey) {\n      headers[\"X-SentiSense-API-Key\"] = this.apiKey;\n    }\n\n    // User-Agent is only set in Node.js (browsers disallow it)\n    if (typeof process !== \"undefined\" && process.versions?.node) {\n      headers[\"User-Agent\"] = `sentisense-node/${VERSION}`;\n    }\n\n    let delayMs = 0;\n\n    for (let attempt = 0; attempt <= this.maxRetries; attempt++) {\n      if (delayMs > 0) {\n        await sleep(delayMs);\n        delayMs = 0;\n      }\n\n      const controller = new AbortController();\n      const timer = setTimeout(() => controller.abort(), this.timeout);\n\n      try {\n        const response = await fetch(url, {\n          method: \"GET\",\n          headers,\n          signal: controller.signal,\n        });\n\n        if (!response.ok) {\n          const isRetryable = response.status === 429 || response.status >= 500;\n          if (isRetryable && attempt < this.maxRetries) {\n            if (response.status === 429) {\n              const ra = response.headers.get(\"Retry-After\");\n              delayMs = (ra ? parseInt(ra, 10) : 60) * 1000;\n            } else {\n              delayMs = Math.min(BASE_DELAY_MS * Math.pow(2, attempt), MAX_DELAY_MS) + Math.random() * 1000;\n            }\n            try { await response.body?.cancel(); } catch { /* ignore */ }\n            continue;\n          }\n          await this.handleErrorResponse(response);\n        }\n\n        return (await response.json()) as T;\n      } catch (error) {\n        if (error instanceof SentiSenseError) throw error;\n        if (error instanceof Error && error.name === \"AbortError\") {\n          throw new SentiSenseError(`Request timed out after ${this.timeout}ms`);\n        }\n        throw new SentiSenseError(\n          error instanceof Error ? error.message : \"Unknown error\",\n        );\n      } finally {\n        clearTimeout(timer);\n      }\n    }\n\n    throw new SentiSenseError(\"All retries exhausted\");\n  }\n\n  /** @internal */\n  async post<T = unknown>(path: string, body: unknown): Promise<T> {\n    const url = this.buildUrl(path);\n    const headers: Record<string, string> = {\n      \"Accept\": \"application/json\",\n      \"Content-Type\": \"application/json\",\n    };\n\n    if (this.apiKey) {\n      headers[\"X-SentiSense-API-Key\"] = this.apiKey;\n    }\n\n    if (typeof process !== \"undefined\" && process.versions?.node) {\n      headers[\"User-Agent\"] = `sentisense-node/${VERSION}`;\n    }\n\n    const controller = new AbortController();\n    const timer = setTimeout(() => controller.abort(), this.timeout);\n\n    try {\n      const response = await fetch(url, {\n        method: \"POST\",\n        headers,\n        body: JSON.stringify(body),\n        signal: controller.signal,\n      });\n\n      if (!response.ok) {\n        await this.handleErrorResponse(response);\n      }\n\n      return (await response.json()) as T;\n    } catch (error) {\n      if (error instanceof SentiSenseError) throw error;\n      if (error instanceof Error && error.name === \"AbortError\") {\n        throw new SentiSenseError(`Request timed out after ${this.timeout}ms`);\n      }\n      throw new SentiSenseError(\n        error instanceof Error ? error.message : \"Unknown error\",\n      );\n    } finally {\n      clearTimeout(timer);\n    }\n  }\n\n  private buildUrl(path: string, params?: object): string {\n    const url = new URL(path, this.baseUrl);\n    if (params) {\n      for (const [key, value] of Object.entries(params as Record<string, unknown>)) {\n        if (value !== undefined && value !== null) {\n          url.searchParams.set(key, String(value));\n        }\n      }\n    }\n    return url.toString();\n  }\n\n  private async handleErrorResponse(response: Response): Promise<never> {\n    let body: { error?: string; message?: string } = {};\n    try {\n      body = await response.json();\n    } catch {\n      // Response may not be JSON\n    }\n\n    const message = body.message ?? response.statusText ?? \"API request failed\";\n    const code = body.error;\n\n    switch (response.status) {\n      case 401:\n      case 403:\n        throw new AuthenticationError(message, response.status, code);\n      case 404:\n        throw new NotFoundError(message, code);\n      case 429: {\n        const ra = response.headers.get(\"Retry-After\");\n        throw new RateLimitError(message, code, ra ? parseInt(ra, 10) : undefined);\n      }\n      default:\n        throw new APIError(message, response.status, code);\n    }\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/index.d.mts

@@ -299,10 +299,39 @@ interface Holder {
     sharesChange: number;
     sharesChangePct: number;
 }
-interface InstitutionalFlowsResponse {
+/**
+ * The flows payload itself: what the server puts inside the response envelope.
+ *
+ * Note `institutional.getFlows()` is currently declared as returning this shape directly,
+ * but the endpoint wraps it: the value you get back at runtime is
+ * `{ isPreview, previewReason, data }` with these fields under `data`. Until the
+ * declaration is corrected, read the flows as `(result as unknown as
+ * PreviewResponse<InstitutionalFlows>).data.inflows`.
+ */
+interface InstitutionalFlows {
     inflows: InstitutionalFlow[];
     outflows: InstitutionalFlow[];
+    /**
+     * Quarter these flows are for (ISO date). Populated when `reportDate` is omitted from
+     * the request so the caller knows which quarter the server defaulted to.
+     */
+    reportDate?: string;
+    /**
+     * True when `reportDate` is a still-open 13F filing window (within 45 days of quarter
+     * end), so only early filers are represented and the flows are partial.
+     */
+    isPending?: boolean;
+    /** Distinct 13F filers represented in this quarter. Present only when `isPending`. */
+    filerCount?: number;
+    /**
+     * Distinct filers in the latest fully-filed quarter, as a coverage baseline for a
+     * pending quarter (e.g. `filerCount` 578 of `baselineFilerCount` 8789). Present only
+     * when `isPending`.
+     */
+    baselineFilerCount?: number;
 }
+/** Alias of {@link InstitutionalFlows}; same shape. */
+type InstitutionalFlowsResponse = InstitutionalFlows;
 interface GetFlowsOptions {
     limit?: number;
 }
@@ -627,9 +656,9 @@ interface MarketMood {
 }
 /** AI-generated market summary with headline and analysis. */
 interface MarketSummary {
-    /** Total mentions across all stocks. */
+    /** Not populated by the API (always empty); retained for backward compatibility. */
     totalMentions: number;
-    /** Most active stock tickers by mention volume. */
+    /** Not populated by the API (always empty); retained for backward compatibility. */
     topActiveStocks: string[];
     /** Timestamp when this data was last updated (epoch milliseconds). */
     lastUpdated: number;
@@ -1352,8 +1381,14 @@ declare class Institutional {
     constructor(client: APIClient);
     /** Get available 13F reporting quarters. */
     getQuarters(): Promise<Quarter[]>;
-    /** Get aggregate institutional activity per ticker for a quarter. */
-    getFlows(reportDate: string, options?: GetFlowsOptions): Promise<InstitutionalFlowsResponse>;
+    /**
+     * Get aggregate institutional activity per ticker for a quarter.
+     *
+     * `reportDate` is optional: omit it to get the latest available quarter, which may be
+     * a still-open one holding only early filers. The response then carries `reportDate`
+     * plus `isPending` and filer coverage counts so a partial quarter is clearly labeled.
+     */
+    getFlows(reportDate?: string, options?: GetFlowsOptions): Promise<InstitutionalFlowsResponse>;
     /** Get institutional holders for a specific stock. */
     getHolders(ticker: string, reportDate: string): Promise<Holder[]>;
     /** Get activist investor positions (NEW or INCREASED). */
@@ -1580,6 +1615,6 @@ declare class APIError extends SentiSenseError {
     constructor(message: string, status: number, code?: string);
 }
 
-declare const VERSION = "0.27.0";
+declare const VERSION = "0.28.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, type Document, 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 GetAnalystActionsOptions, type GetAnalystMarketActivityOptions, type GetEarningsCalendarOptions, 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 InstitutionList, type InstitutionListResponse, type InstitutionSummary, type InstitutionalFlow, 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 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, type TrackerEvent, type TrackerGeoEntry, type TrackerHeadlineMetric, type TrackerListResponse, type TrackerListing, type TrackerMetricValue, type TrackerSignal, type TrackerSnapshot, type TrackerSnapshotResponse, type TrackerSourceRef, type TrackerTableRow, type TrackerTimeSeriesPoint, VERSION, type WeightedConsensus, type WeightedNetFlow, SentiSense as default };

package/dist/index.d.ts

@@ -299,10 +299,39 @@ interface Holder {
     sharesChange: number;
     sharesChangePct: number;
 }
-interface InstitutionalFlowsResponse {
+/**
+ * The flows payload itself: what the server puts inside the response envelope.
+ *
+ * Note `institutional.getFlows()` is currently declared as returning this shape directly,
+ * but the endpoint wraps it: the value you get back at runtime is
+ * `{ isPreview, previewReason, data }` with these fields under `data`. Until the
+ * declaration is corrected, read the flows as `(result as unknown as
+ * PreviewResponse<InstitutionalFlows>).data.inflows`.
+ */
+interface InstitutionalFlows {
     inflows: InstitutionalFlow[];
     outflows: InstitutionalFlow[];
+    /**
+     * Quarter these flows are for (ISO date). Populated when `reportDate` is omitted from
+     * the request so the caller knows which quarter the server defaulted to.
+     */
+    reportDate?: string;
+    /**
+     * True when `reportDate` is a still-open 13F filing window (within 45 days of quarter
+     * end), so only early filers are represented and the flows are partial.
+     */
+    isPending?: boolean;
+    /** Distinct 13F filers represented in this quarter. Present only when `isPending`. */
+    filerCount?: number;
+    /**
+     * Distinct filers in the latest fully-filed quarter, as a coverage baseline for a
+     * pending quarter (e.g. `filerCount` 578 of `baselineFilerCount` 8789). Present only
+     * when `isPending`.
+     */
+    baselineFilerCount?: number;
 }
+/** Alias of {@link InstitutionalFlows}; same shape. */
+type InstitutionalFlowsResponse = InstitutionalFlows;
 interface GetFlowsOptions {
     limit?: number;
 }
@@ -627,9 +656,9 @@ interface MarketMood {
 }
 /** AI-generated market summary with headline and analysis. */
 interface MarketSummary {
-    /** Total mentions across all stocks. */
+    /** Not populated by the API (always empty); retained for backward compatibility. */
     totalMentions: number;
-    /** Most active stock tickers by mention volume. */
+    /** Not populated by the API (always empty); retained for backward compatibility. */
     topActiveStocks: string[];
     /** Timestamp when this data was last updated (epoch milliseconds). */
     lastUpdated: number;
@@ -1352,8 +1381,14 @@ declare class Institutional {
     constructor(client: APIClient);
     /** Get available 13F reporting quarters. */
     getQuarters(): Promise<Quarter[]>;
-    /** Get aggregate institutional activity per ticker for a quarter. */
-    getFlows(reportDate: string, options?: GetFlowsOptions): Promise<InstitutionalFlowsResponse>;
+    /**
+     * Get aggregate institutional activity per ticker for a quarter.
+     *
+     * `reportDate` is optional: omit it to get the latest available quarter, which may be
+     * a still-open one holding only early filers. The response then carries `reportDate`
+     * plus `isPending` and filer coverage counts so a partial quarter is clearly labeled.
+     */
+    getFlows(reportDate?: string, options?: GetFlowsOptions): Promise<InstitutionalFlowsResponse>;
     /** Get institutional holders for a specific stock. */
     getHolders(ticker: string, reportDate: string): Promise<Holder[]>;
     /** Get activist investor positions (NEW or INCREASED). */
@@ -1580,6 +1615,6 @@ declare class APIError extends SentiSenseError {
     constructor(message: string, status: number, code?: string);
 }
 
-declare const VERSION = "0.27.0";
+declare const VERSION = "0.28.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, type Document, 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 GetAnalystActionsOptions, type GetAnalystMarketActivityOptions, type GetEarningsCalendarOptions, 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 InstitutionList, type InstitutionListResponse, type InstitutionSummary, type InstitutionalFlow, 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 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, type TrackerEvent, type TrackerGeoEntry, type TrackerHeadlineMetric, type TrackerListResponse, type TrackerListing, type TrackerMetricValue, type TrackerSignal, type TrackerSnapshot, type TrackerSnapshotResponse, type TrackerSourceRef, type TrackerTableRow, type TrackerTimeSeriesPoint, VERSION, type WeightedConsensus, type WeightedNetFlow, SentiSense as default };

package/dist/index.mjs

@@ -451,7 +451,13 @@ var Institutional = class {
   async getQuarters() {
     return this.client.get("/api/v1/institutional/quarters");
   }
-  /** Get aggregate institutional activity per ticker for a quarter. */
+  /**
+   * Get aggregate institutional activity per ticker for a quarter.
+   *
+   * `reportDate` is optional: omit it to get the latest available quarter, which may be
+   * a still-open one holding only early filers. The response then carries `reportDate`
+   * plus `isPending` and filer coverage counts so a partial quarter is clearly labeled.
+   */
   async getFlows(reportDate, options) {
     return this.client.get("/api/v1/institutional/flows", {
       reportDate,
@@ -738,7 +744,7 @@ var Trackers = class {
 };
 
 // src/version.ts
-var VERSION = "0.27.0";
+var VERSION = "0.28.0";
 
 // src/client.ts
 var DEFAULT_BASE_URL = "https://app.sentisense.ai";

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/errors.ts","../src/resources/analyst.ts","../src/resources/calendar.ts","../src/resources/documents.ts","../src/resources/entityMetrics.ts","../src/resources/etfs.ts","../src/resources/insider.ts","../src/resources/politicians.ts","../src/resources/insights.ts","../src/resources/institutional.ts","../src/resources/kb.ts","../src/resources/marketMood.ts","../src/resources/marketSummary.ts","../src/resources/stocks.ts","../src/resources/trackers.ts","../src/version.ts","../src/client.ts"],"sourcesContent":["export class SentiSenseError extends Error {\n  status?: number;\n  code?: string;\n\n  constructor(message: string, status?: number, code?: string) {\n    super(message);\n    this.name = \"SentiSenseError\";\n    this.status = status;\n    this.code = code;\n  }\n}\n\nexport class AuthenticationError extends SentiSenseError {\n  constructor(message: string, status: number, code?: string) {\n    super(message, status, code);\n    this.name = \"AuthenticationError\";\n  }\n}\n\nexport class NotFoundError extends SentiSenseError {\n  constructor(message: string, code?: string) {\n    super(message, 404, code);\n    this.name = \"NotFoundError\";\n  }\n}\n\nexport class RateLimitError extends SentiSenseError {\n  retryAfter?: number;\n\n  constructor(message: string, code?: string, retryAfter?: number) {\n    super(message, 429, code);\n    this.name = \"RateLimitError\";\n    this.retryAfter = retryAfter;\n  }\n}\n\nexport class APIError extends SentiSenseError {\n  constructor(message: string, status: number, code?: string) {\n    super(message, status, code);\n    this.name = \"APIError\";\n  }\n}\n","import type { APIClient } from \"../client.js\";\nimport type { PreviewResponse } from \"../types.js\";\n\nexport interface AnalystConsensus {\n  ticker: string;\n  currentPrice: number | null;\n  targetLow: number | null;\n  targetMean: number | null;\n  targetHigh: number | null;\n  targetMedian: number | null;\n  numberOfAnalysts: number;\n  upsidePercent: number | null;\n  consensusLabel: string | null;\n  recommendationMean: number | null;\n  /** PRO-only; zero in the free preview. */\n  strongBuy: number;\n  /** PRO-only; zero in the free preview. */\n  buy: number;\n  /** PRO-only; zero in the free preview. */\n  hold: number;\n  /** PRO-only; zero in the free preview. */\n  sell: number;\n  /** PRO-only; zero in the free preview. */\n  strongSell: number;\n  updatedAt: string | null;\n}\n\nexport interface AnalystAction {\n  ticker: string;\n  actionDate: string;\n  firm: string;\n  /** UPGRADE, DOWNGRADE, INITIATE, REITERATE, OTHER */\n  actionType: string;\n  fromGrade: string | null;\n  toGrade: string | null;\n}\n\nexport interface AnalystEstimate {\n  /** Fiscal period descriptor (provider-specific shape). */\n  [key: string]: unknown;\n}\n\nexport interface AnalystEarningsSurprise {\n  /** Past report descriptor (provider-specific shape). */\n  [key: string]: unknown;\n}\n\nexport interface AnalystEstimatesResponse {\n  estimates: AnalystEstimate[];\n  surprises: AnalystEarningsSurprise[];\n}\n\nexport interface GetAnalystActionsOptions {\n  /** Days of history to return. Default 90. */\n  lookbackDays?: number;\n}\n\nexport interface GetAnalystMarketActivityOptions {\n  /** Days of history to return. Default 30. */\n  lookbackDays?: number;\n}\n\n/**\n * Wall Street analyst coverage: aggregate price targets, recommendation distribution,\n * recent upgrade/downgrade actions, and forward EPS estimates with earnings surprise history.\n *\n * Free users receive the price target band (low/mean/high + analyst count + consensus label)\n * in full -- it powers the public projection cone. The buy/hold/sell distribution counts\n * and full action/estimate history are PRO-only.\n */\nexport class Analyst {\n  constructor(private client: APIClient) {}\n\n  /**\n   * Get the aggregate Wall Street consensus for a ticker. Returns 404 if no\n   * coverage exists.\n   */\n  async consensus(\n    ticker: string,\n  ): Promise<PreviewResponse<AnalystConsensus>> {\n    return this.client.get(\n      `/api/v1/analyst/${encodeURIComponent(ticker.toUpperCase())}/consensus`,\n    );\n  }\n\n  /**\n   * Get recent analyst upgrade/downgrade actions for a ticker, newest first.\n   * Free users receive the 3 most recent.\n   */\n  async actions(\n    ticker: string,\n    options?: GetAnalystActionsOptions,\n  ): Promise<PreviewResponse<AnalystAction[]>> {\n    return this.client.get(\n      `/api/v1/analyst/${encodeURIComponent(ticker.toUpperCase())}/actions`,\n      options,\n    );\n  }\n\n  /**\n   * Get forward EPS estimates and earnings surprise history for a ticker.\n   * Free users receive 1 estimate (current quarter) plus the 2 most recent surprises.\n   */\n  async estimates(\n    ticker: string,\n  ): Promise<PreviewResponse<AnalystEstimatesResponse>> {\n    return this.client.get(\n      `/api/v1/analyst/${encodeURIComponent(ticker.toUpperCase())}/estimates`,\n    );\n  }\n\n  /**\n   * Get market-wide recent analyst actions across all covered tickers, newest first.\n   * Free users receive the 5 most recent.\n   */\n  async marketActivity(\n    options?: GetAnalystMarketActivityOptions,\n  ): Promise<PreviewResponse<AnalystAction[]>> {\n    return this.client.get(\"/api/v1/analyst/activity\", options);\n  }\n}\n","import type { APIClient } from \"../client.js\";\nimport type {\n  EarningsCalendarResponse,\n  GetEarningsCalendarOptions,\n  PreviewResponse,\n} from \"../types.js\";\n\nexport class Calendar {\n  constructor(private client: APIClient) {}\n\n  /**\n   * Upcoming company earnings, sorted by date.\n   *\n   * Key-required. A FREE key returns the current week (`isPreview: true`); a PRO\n   * key returns the full forward window (about 30 days). Field richness is\n   * identical across tiers: the gate is how far ahead you can see, not which\n   * columns you get. On a preview, `totalCount` is the full-window event count.\n   */\n  async getEarnings(\n    options?: GetEarningsCalendarOptions,\n  ): Promise<PreviewResponse<EarningsCalendarResponse>> {\n    return this.client.get(\"/api/v1/calendar/earnings\", options);\n  }\n}\n","import type { APIClient } from \"../client.js\";\nimport type {\n  Document,\n  DocumentSource,\n  GetByEntityOptions,\n  GetBySourceOptions,\n  GetByTickerOptions,\n  GetByTickerRangeOptions,\n  GetStoriesByTickerOptions,\n  GetStoriesOptions,\n  SearchDocumentsOptions,\n  Story,\n} from \"../types.js\";\n\nexport class Documents {\n  constructor(private client: APIClient) {}\n\n  /** Get document metrics for a stock. */\n  async getByTicker(ticker: string, options?: GetByTickerOptions): Promise<Document[]> {\n    return this.client.get(`/api/v1/documents/ticker/${encodeURIComponent(ticker)}`, options);\n  }\n\n  /** Get document metrics for a stock within a date range. */\n  async getByTickerRange(ticker: string, options: GetByTickerRangeOptions): Promise<Document[]> {\n    return this.client.get(\n      `/api/v1/documents/ticker/${encodeURIComponent(ticker)}/range`,\n      options,\n    );\n  }\n\n  /** Get document metrics for a KB entity. */\n  async getByEntity(entityId: string, options?: GetByEntityOptions): Promise<Document[]> {\n    return this.client.get(\n      `/api/v1/documents/entity/${encodeURIComponent(entityId)}`,\n      options,\n    );\n  }\n\n  /** Smart search with natural language query parsing. */\n  async search(query: string, options?: SearchDocumentsOptions): Promise<Document[]> {\n    return this.client.get(\"/api/v1/documents/search\", { query, ...options });\n  }\n\n  /** Get latest document metrics from a source type. */\n  async getBySource(source: DocumentSource, options?: GetBySourceOptions): Promise<Document[]> {\n    return this.client.get(\n      `/api/v1/documents/source/${encodeURIComponent(source)}`,\n      options,\n    );\n  }\n\n  /** Get AI-curated news story clusters. */\n  async getStories(options?: GetStoriesOptions): Promise<Story[]> {\n    return this.client.get(\"/api/v1/documents/stories\", options);\n  }\n\n  /** Get full story detail by cluster ID. */\n  async getStoryDetail(clusterId: string): Promise<unknown> {\n    return this.client.get(`/api/v1/documents/stories/${encodeURIComponent(clusterId)}`);\n  }\n\n  /** Get stories for a specific stock. */\n  async getStoriesByTicker(\n    ticker: string,\n    options?: GetStoriesByTickerOptions,\n  ): Promise<Story[]> {\n    return this.client.get(\n      `/api/v1/documents/stories/ticker/${encodeURIComponent(ticker)}`,\n      options,\n    );\n  }\n\n}\n","import type { APIClient } from \"../client.js\";\nimport type {\n  EntityMetricsDateRange,\n  GetMentionCountOptions,\n  GetMentionsOptions,\n  GetSentimentBySourceOptions,\n  MentionCount,\n  MentionData,\n  MetricType,\n  MetricsOptions,\n  MetricDistributionOptions,\n  SentimentData,\n  ServingMetric,\n  MetricDistribution,\n} from \"../types.js\";\n\nexport class EntityMetrics {\n  constructor(private client: APIClient) {}\n\n  // ── v2 API methods ──────────────────────────────────────────\n\n  /**\n   * Get time-series metric data for an entity using the v2 Serving Metrics API.\n   *\n   * @param symbol   Ticker symbol (e.g. \"AAPL\") — the backend resolves the entity.\n   * @param options  Metric type and optional time range / resolution.\n   */\n  async getMetrics(\n    symbol: string,\n    options: MetricsOptions = {},\n  ): Promise<ServingMetric[]> {\n    const { metricType = \"sentiment\", startTime, endTime, maxDataPoints } = options;\n    return this.client.get(\n      `/api/v2/metrics/entity/${encodeURIComponent(symbol)}/metric/${encodeURIComponent(metricType)}`,\n      {\n        ...(startTime !== undefined && { startTime }),\n        ...(endTime !== undefined && { endTime }),\n        ...(maxDataPoints !== undefined && { maxDataPoints }),\n      },\n    );\n  }\n\n  /**\n   * Get distribution data for a metric, broken down by a dimension (default: source).\n   *\n   * @param symbol     Ticker symbol (e.g. \"AAPL\").\n   * @param metricType The metric to break down (e.g. \"mentions\", \"sentiment\").\n   * @param options    Optional dimension parameter.\n   */\n  async getDistribution(\n    symbol: string,\n    metricType: MetricType,\n    options: MetricDistributionOptions = {},\n  ): Promise<MetricDistribution> {\n    const { dimension = \"source\" } = options;\n    return this.client.get(\n      `/api/v2/metrics/entity/${encodeURIComponent(symbol)}/distribution/${encodeURIComponent(metricType)}`,\n      { dimension },\n    );\n  }\n\n  // ── Deprecated v1 methods (kept for backward compatibility) ─\n\n  /**\n   * @deprecated Use `getMetrics(symbol, { metricType: \"mentions\" })` instead.\n   */\n  async getMentions(symbol: string, options?: GetMentionsOptions): Promise<MentionData> {\n    return this.client.get(\n      `/api/v1/entity-metrics/stocks/${encodeURIComponent(symbol)}/mentions`,\n      options,\n    );\n  }\n\n  /**\n   * @deprecated Use `getDistribution(symbol, \"mentions\", { dimension: \"source\" })` instead.\n   */\n  async getMentionCountBySource(\n    symbol: string,\n    options?: EntityMetricsDateRange,\n  ): Promise<MentionCount> {\n    return this.client.get(\n      `/api/v1/entity-metrics/stocks/${encodeURIComponent(symbol)}/mentions/count/by-source`,\n      options,\n    );\n  }\n\n  /**\n   * @deprecated Use `getMetrics(symbol, { metricType: \"mentions\" })` instead.\n   */\n  async getMentionCount(symbol: string, options?: GetMentionCountOptions): Promise<MentionCount> {\n    return this.client.get(\n      `/api/v1/entity-metrics/stocks/${encodeURIComponent(symbol)}/mentions/count`,\n      options,\n    );\n  }\n\n  /**\n   * @deprecated Use `getMetrics(symbol, { metricType: \"sentiment\" })` instead.\n   */\n  async getSentiment(symbol: string, options?: EntityMetricsDateRange): Promise<SentimentData> {\n    return this.client.get(\n      `/api/v1/entity-metrics/stocks/${encodeURIComponent(symbol)}/sentiment`,\n      options,\n    );\n  }\n\n  /**\n   * @deprecated Use `getDistribution(symbol, \"sentiment\", { dimension: \"source\" })` instead.\n   */\n  async getSentimentBySource(\n    symbol: string,\n    options?: GetSentimentBySourceOptions,\n  ): Promise<SentimentData> {\n    return this.client.get(\n      `/api/v1/entity-metrics/stocks/${encodeURIComponent(symbol)}/sentiment/by-source`,\n      options,\n    );\n  }\n\n  /**\n   * @deprecated Use `getMetrics(symbol, { metricType: \"sentiment\" })` instead.\n   */\n  async getAverageSentiment(\n    symbol: string,\n    options?: EntityMetricsDateRange,\n  ): Promise<SentimentData> {\n    return this.client.get(\n      `/api/v1/entity-metrics/stocks/${encodeURIComponent(symbol)}/sentiment/average`,\n      options,\n    );\n  }\n}\n","import type { APIClient } from \"../client.js\";\nimport type { PreviewResponse } from \"../types.js\";\n\nexport interface EtfInfo {\n  ticker: string;\n  name: string;\n  kbEntityId: string | null;\n  urlSlug: string | null;\n  issuer: string | null;\n  trackedIndex: string | null;\n  assetClass: string | null;\n}\n\nexport interface EtfHolding {\n  ticker: string;\n  name: string | null;\n  /** Weight in the fund as a percentage (0-100). */\n  weightPct: number;\n  /** ISO date \"YYYY-MM-DD\" — first date this holding appeared in the composition. */\n  firstSeen: string | null;\n}\n\nexport interface EtfHoldings {\n  ticker: string;\n  issuer: string;\n  issuerEndpoint: string | null;\n  /** ISO date \"YYYY-MM-DD\" — composition snapshot date from the issuer. */\n  asOfDate: string;\n  /** Epoch seconds when SentiSense refreshed the composition. */\n  fetchedAt: number | null;\n  /** ISO date \"YYYY-MM-DD\" — when the composition is scheduled to be refreshed next. */\n  nextRefreshDue: string;\n  totalHoldings: number;\n  holdings: EtfHolding[];\n  /** True when this is a top-N view rather than the full fund. */\n  partial?: boolean | null;\n  /** Issuer's reported total holdings when `partial=true`. */\n  totalKnownHoldings?: number | null;\n}\n\nexport interface EtfAggregateCoverage {\n  holdingsCount: number;\n  holdingsCovered: number;\n  /** Sum of weights (0-100) for the covered holdings. */\n  weightCovered: number;\n  partial?: boolean | null;\n  totalKnownHoldings?: number | null;\n}\n\nexport interface WeightedConsensus {\n  upsidePercent: number | null;\n  consensusLabel: string | null;\n  /** Fractions of covered AUM in each bucket. Sums to ~1.0. */\n  distribution: Record<string, number>;\n  totalAnalysts: number;\n}\n\nexport interface EtfAnalystContributor {\n  ticker: string;\n  weightPct: number;\n  upsidePercent: number | null;\n  consensusLabel: string | null;\n  /** Signed contribution to the fund's weighted upside in percentage points. */\n  contributionPp: number;\n}\n\nexport interface EtfAnalystAggregate {\n  ticker: string;\n  /** ISO date \"YYYY-MM-DD\" — composition snapshot date. */\n  asOfDate: string | null;\n  /** Epoch seconds when this rollup was computed. */\n  computedAt: number;\n  coverage: EtfAggregateCoverage;\n  weightedConsensus: WeightedConsensus;\n  /** Top contributors (up to 10) by absolute contribution to the weighted upside. */\n  topContributors: EtfAnalystContributor[];\n}\n\nexport interface WeightedNetFlow {\n  /** Weighted net dollar flow (buys - sells). Negative = net selling. */\n  netDollars: number;\n  buyDollars: number;\n  sellDollars: number;\n  /** Unweighted; for context. */\n  buyTradeCount: number;\n  /** Unweighted; for context. */\n  sellTradeCount: number;\n  distinctInsiderCount: number;\n}\n\nexport interface EtfInsiderContributor {\n  ticker: string;\n  weightPct: number;\n  /** Per-stock net flow over the window (signed). */\n  netDollars: number;\n  /** Signed contribution to the weighted headline. */\n  weightedNetDollars: number;\n  tradeCount: number;\n}\n\nexport interface EtfInsiderAggregate {\n  ticker: string;\n  /** ISO date \"YYYY-MM-DD\" — composition snapshot date. */\n  asOfDate: string | null;\n  /** Epoch seconds when this rollup was computed. */\n  computedAt: number;\n  lookbackDays: number;\n  coverage: EtfAggregateCoverage;\n  weightedNetFlow: WeightedNetFlow;\n  /** Top contributors (up to 10) by absolute weighted-net-dollar contribution. */\n  topContributors: EtfInsiderContributor[];\n}\n\nexport interface EtfSentimentReading {\n  sentiSenseScore: number | null;\n  /** BULLISH / NEUTRAL / BEARISH. */\n  scoreLabel: string;\n  /** Epoch seconds when the underlying metric was produced. */\n  asOfTimestamp: number | null;\n}\n\nexport interface EtfSentimentAggregate {\n  ticker: string;\n  /** ISO date \"YYYY-MM-DD\" — composition snapshot date. */\n  asOfDate: string | null;\n  /** Epoch seconds when this aggregate was assembled. */\n  computedAt: number;\n  coverage: EtfAggregateCoverage;\n  /** Holdings-weighted SentiSense across the fund's constituents. */\n  constituentsWeighted: EtfSentimentReading;\n  /** Direct reading from mentions of the fund's own ticker. Null for low-mention funds. */\n  direct: EtfSentimentReading | null;\n}\n\nexport interface GetEtfInsiderAggregateOptions {\n  /** Trailing window for the trade aggregation. Typical values: 30, 90. Default 30. */\n  lookbackDays?: number;\n}\n\n/**\n * ETF discovery, composition (holdings), and holdings-weighted aggregate views.\n *\n * Funds aren't rated by analysts directly, don't have insiders of their own, and\n * may not get many direct news mentions -- but the companies inside them do. The\n * aggregate endpoints synthesize fund-level views from each constituent's per-stock\n * data, weighted by allocation, with a coverage block so consumers see how much of\n * the fund's AUM the underlying data covered.\n *\n * Beta as of 2026-05-15: starting with a limited set of widely-traded funds.\n */\nexport class Etfs {\n  constructor(private client: APIClient) {}\n\n  /**\n   * List every ETF tracked by SentiSense, sorted by ticker.\n   */\n  async list(): Promise<EtfInfo[]> {\n    return this.client.get(\"/api/v1/etfs\");\n  }\n\n  /**\n   * Get the full holdings composition for an ETF, including per-holding weights\n   * and freshness metadata. Returns 404 for unknown ETFs or commodity-only funds.\n   */\n  async holdings(ticker: string): Promise<EtfHoldings> {\n    return this.client.get(\n      `/api/v1/etfs/${encodeURIComponent(ticker.toUpperCase())}/holdings`,\n    );\n  }\n\n  /**\n   * Get the holdings-weighted analyst consensus for an ETF, including the\n   * top per-holding contributors that drive the weighted upside.\n   */\n  async analystAggregate(\n    ticker: string,\n  ): Promise<PreviewResponse<EtfAnalystAggregate>> {\n    return this.client.get(\n      `/api/v1/etfs/${encodeURIComponent(ticker.toUpperCase())}/aggregates/analyst`,\n    );\n  }\n\n  /**\n   * Get the holdings-weighted SEC Form 4 insider aggregate for an ETF over a\n   * configurable trailing window, including per-holding `topContributors` with\n   * signed contribution to the weighted headline.\n   */\n  async insiderAggregate(\n    ticker: string,\n    options?: GetEtfInsiderAggregateOptions,\n  ): Promise<PreviewResponse<EtfInsiderAggregate>> {\n    return this.client.get(\n      `/api/v1/etfs/${encodeURIComponent(ticker.toUpperCase())}/aggregates/insider`,\n      options,\n    );\n  }\n\n  /**\n   * Get two SentiSense Score readings side-by-side: `constituentsWeighted`\n   * (precomputed daily weighted average across the fund's holdings) and `direct`\n   * (score from mentions of the fund's own ticker). The two can diverge, and the\n   * gap is itself information.\n   */\n  async sentimentAggregate(\n    ticker: string,\n  ): Promise<PreviewResponse<EtfSentimentAggregate>> {\n    return this.client.get(\n      `/api/v1/etfs/${encodeURIComponent(ticker.toUpperCase())}/aggregates/sentiment`,\n    );\n  }\n}\n","import type { APIClient } from \"../client.js\";\nimport type {\n  InsiderActivityResponse,\n  InsiderTrade,\n  ClusterBuy,\n  GetInsiderOptions,\n  PreviewResponse,\n} from \"../types.js\";\n\nexport class Insider {\n  constructor(private client: APIClient) {}\n\n  /**\n   * Get market-wide insider activity: top buys and sells aggregated by ticker.\n   *\n   * PRO-gated. Free/unauthenticated users receive a preview (top 5 per direction)\n   * with `isPreview: true` in the response.\n   */\n  async getActivity(options?: GetInsiderOptions): Promise<PreviewResponse<InsiderActivityResponse>> {\n    return this.client.get(\"/api/v1/insider/activity\", options);\n  }\n\n  /**\n   * Get individual insider transactions for a specific stock.\n   *\n   * PRO-gated. Free users receive a preview of the top 5 transactions.\n   */\n  async getTrades(ticker: string, options?: GetInsiderOptions): Promise<PreviewResponse<InsiderTrade[]>> {\n    return this.client.get(\n      `/api/v1/insider/trades/${encodeURIComponent(ticker.toUpperCase())}`,\n      options,\n    );\n  }\n\n  /**\n   * Get cluster buy signals: stocks where 3+ distinct insiders bought recently.\n   *\n   * PRO-gated. Free users receive a preview of the top 3 signals.\n   */\n  async getClusterBuys(options?: GetInsiderOptions): Promise<PreviewResponse<ClusterBuy[]>> {\n    return this.client.get(\"/api/v1/insider/cluster-buys\", options);\n  }\n}\n","import type { APIClient } from \"../client.js\";\nimport type {\n  CongressTrade,\n  PoliticianSummary,\n  PoliticianDetail,\n  GetPoliticiansOptions,\n  PreviewResponse,\n} from \"../types.js\";\n\nexport class Politicians {\n  constructor(private client: APIClient) {}\n\n  /**\n   * Get recent congressional STOCK Act trading activity across all politicians.\n   *\n   * PRO-gated. Free/unauthenticated users receive a preview (top 5 trades)\n   * with `isPreview: true` in the response.\n   */\n  async getActivity(\n    options?: GetPoliticiansOptions,\n  ): Promise<PreviewResponse<CongressTrade[]>> {\n    return this.client.get(\"/api/v1/politicians/activity\", options);\n  }\n\n  /**\n   * Get congressional trades for a specific stock.\n   *\n   * PRO-gated. Free users receive a preview of the top 3 trades.\n   */\n  async getFilings(\n    ticker: string,\n    options?: GetPoliticiansOptions,\n  ): Promise<PreviewResponse<CongressTrade[]>> {\n    return this.client.get(\n      `/api/v1/politicians/filings/${encodeURIComponent(ticker.toUpperCase())}`,\n      options,\n    );\n  }\n\n  /**\n   * Get all tracked politicians with trading summary statistics.\n   *\n   * PRO-gated. Free users receive a preview of the top 5 members.\n   */\n  async getMembers(): Promise<PreviewResponse<PoliticianSummary[]>> {\n    return this.client.get(\"/api/v1/politicians/members\");\n  }\n\n  /**\n   * Get detailed profile for a single politician: summary, recent trades, top tickers.\n   *\n   * PRO-gated. Free users receive a preview-wrapped response.\n   */\n  async getMember(slug: string): Promise<PreviewResponse<PoliticianDetail>> {\n    return this.client.get(\n      `/api/v1/politicians/member/${encodeURIComponent(slug)}`,\n    );\n  }\n}\n","import type { APIClient } from \"../client.js\";\nimport type {\n  Insight,\n  InsightPreviewResponse,\n  GetInsightsOptions,\n} from \"../types.js\";\n\nexport interface GetStockInsightsRangeOptions {\n  startDate: string;\n  endDate: string;\n  urgency?: \"low\" | \"medium\" | \"high\";\n  insightType?: string;\n}\n\nexport interface GetLatestInsightsOptions {\n  limit?: number;\n  urgency?: \"low\" | \"medium\" | \"high\";\n}\n\nexport interface GetUserInsightsOptions {\n  limit?: number;\n  category?: string;\n}\n\nexport class Insights {\n  constructor(private client: APIClient) {}\n\n  /**\n   * Get AI-generated insights for a specific stock, sorted by urgency then confidence.\n   *\n   * PRO users receive a flat array of Insight objects.\n   * Free/unauthenticated users receive a preview with `isPreview: true`,\n   * the top 3 insights in full, and a `locked` array with metadata-only entries\n   * (type, urgency, timestamp) showing what additional signals exist.\n   */\n  async stock(\n    ticker: string,\n    options?: GetInsightsOptions,\n  ): Promise<Insight[] | InsightPreviewResponse> {\n    return this.client.get(\n      `/api/v1/insights/stock/${encodeURIComponent(ticker.toUpperCase())}`,\n      options,\n    );\n  }\n\n  /**\n   * Get AI insights for a stock within a date range.\n   *\n   * Free users receive the top 3; PRO users receive the full list.\n   * The server returns 400 if `startDate` is after `endDate`.\n   */\n  async stockRange(\n    ticker: string,\n    options: GetStockInsightsRangeOptions,\n  ): Promise<Insight[] | InsightPreviewResponse> {\n    return this.client.get(\n      `/api/v1/insights/stock/${encodeURIComponent(ticker.toUpperCase())}/range`,\n      options,\n    );\n  }\n\n  /**\n   * Get AI-generated market-level insights, sorted by urgency then confidence.\n   *\n   * PRO users receive a flat array of Insight objects.\n   * Free/unauthenticated users receive a preview with `isPreview: true`,\n   * the top 5 insights in full, and a `locked` array with metadata-only entries.\n   */\n  async market(): Promise<Insight[] | InsightPreviewResponse> {\n    return this.client.get(\"/api/v1/insights/market\");\n  }\n\n  /**\n   * Get the latest AI insights across all tracked stocks, newest first.\n   *\n   * Free users receive the top 5; PRO users receive up to `limit` (clamped to 1-200).\n   */\n  async latest(\n    options?: GetLatestInsightsOptions,\n  ): Promise<Insight[] | InsightPreviewResponse> {\n    return this.client.get(\"/api/v1/insights/latest\", options);\n  }\n\n  /**\n   * Get personalized insights for the authenticated user.\n   *\n   * Biased toward the user's watchlist and portfolio when available; falls back\n   * to market-level insights otherwise. API key authentication required.\n   */\n  async user(\n    options?: GetUserInsightsOptions,\n  ): Promise<Insight[] | InsightPreviewResponse> {\n    return this.client.get(\"/api/v1/insights/user\", options);\n  }\n\n  /**\n   * Get available insight types for a specific stock.\n   * No authentication required.\n   *\n   * Returns an array of insight type strings (e.g., `[\"sentiment_shift\", \"options_activity\"]`).\n   */\n  async types(ticker: string): Promise<string[]> {\n    return this.client.get(\n      `/api/v1/insights/stock/${encodeURIComponent(ticker.toUpperCase())}/types`,\n    );\n  }\n}\n","import type { APIClient } from \"../client.js\";\nimport type {\n  GetFlowsOptions,\n  Holder,\n  InstitutionList,\n  InstitutionListResponse,\n  InstitutionalFlowsResponse,\n  ListInstitutionsOptions,\n  Quarter,\n} from \"../types.js\";\n\nexport class Institutional {\n  constructor(private client: APIClient) {}\n\n  /** Get available 13F reporting quarters. */\n  async getQuarters(): Promise<Quarter[]> {\n    return this.client.get(\"/api/v1/institutional/quarters\");\n  }\n\n  /** Get aggregate institutional activity per ticker for a quarter. */\n  async getFlows(reportDate: string, options?: GetFlowsOptions): Promise<InstitutionalFlowsResponse> {\n    return this.client.get(\"/api/v1/institutional/flows\", {\n      reportDate,\n      ...options,\n    });\n  }\n\n  /** Get institutional holders for a specific stock. */\n  async getHolders(ticker: string, reportDate: string): Promise<Holder[]> {\n    return this.client.get(\n      `/api/v1/institutional/holders/${encodeURIComponent(ticker)}`,\n      { reportDate },\n    );\n  }\n\n  /** Get activist investor positions (NEW or INCREASED). */\n  async getActivists(reportDate: string): Promise<Holder[]> {\n    return this.client.get(\"/api/v1/institutional/activist\", { reportDate });\n  }\n\n  /**\n   * Discover institutions: a paginated, AUM-ranked list of filers (slug + metadata)\n   * so you can find what to query without knowing slugs upfront.\n   *\n   * Each institution is rolled up by parent filer, so a multi-filer manager\n   * (e.g. Vanguard) appears once with combined AUM. Summary only; use\n   * `getInstitutionDetail` for a filer's full holdings.\n   *\n   * Requires an API key but does not consume monthly quota (per-minute rate\n   * limits still apply). Returns the unwrapped list payload.\n   */\n  async listInstitutions(options?: ListInstitutionsOptions): Promise<InstitutionList> {\n    const resp = await this.client.get<InstitutionListResponse>(\n      \"/api/v1/institutional/institutions\",\n      { ...options },\n    );\n    return resp.data;\n  }\n\n  /**\n   * Get the full profile, summary stats, and current-quarter holdings for a\n   * specific institutional filer.\n   *\n   * Resolved by URL slug (e.g. `Berkshire-Hathaway`) or numeric SEC CIK.\n   * Free users receive the profile and top 10 holdings; PRO users receive the\n   * full holdings array. Returns 404 if the slug or CIK is unknown.\n   */\n  async getInstitutionDetail(slugOrCik: string): Promise<unknown> {\n    return this.client.get(\n      `/api/v1/institutional/institution/${encodeURIComponent(slugOrCik)}`,\n    );\n  }\n}\n","import type { APIClient } from \"../client.js\";\nimport type { KBEntity } from \"../types.js\";\n\nexport class KB {\n  constructor(private client: APIClient) {}\n\n  /** Get popular entities for search suggestions. */\n  async getPopularEntities(): Promise<KBEntity[]> {\n    return this.client.get(\"/api/v1/kb/entities/popular\");\n  }\n\n  /** Get entity detail with metrics and relationships. */\n  async getEntity(entityId: string): Promise<KBEntity> {\n    return this.client.get(`/api/v1/kb/entities/${encodeURIComponent(entityId)}`);\n  }\n\n  /** Get all tracked entities. */\n  async getAllEntities(): Promise<KBEntity[]> {\n    return this.client.get(\"/api/v1/kb/entities/all\");\n  }\n}\n","import type { APIClient } from \"../client.js\";\nimport type { MarketMood } from \"../types.js\";\n\nexport class MarketMoodResource {\n  constructor(private client: APIClient) {}\n\n  /** Get market mood data (scores, history, sectors). */\n  async get(): Promise<MarketMood> {\n    return this.client.get(\"/api/v2/market-mood\");\n  }\n\n  // TODO: accept a `days` param to control history length (the endpoint supports ?days=N).\n  // TODO: add a sibling `indexes` resource for /api/v1/indexes/{id} (+ /history), e.g. fed-sentiment.\n}\n","import type { APIClient } from \"../client.js\";\nimport type { MarketSummary } from \"../types.js\";\n\nexport class MarketSummaryResource {\n  constructor(private client: APIClient) {}\n\n  /** Get the AI-generated market summary with headline and analysis. */\n  async get(): Promise<MarketSummary> {\n    return this.client.get(\"/api/v1/market-summary\");\n  }\n}\n","import type { APIClient } from \"../client.js\";\nimport type {\n  AISummary,\n  ChartData,\n  ChartDataPoint,\n  CompanyKpisData,\n  FloatInfo,\n  Fundamentals,\n  FundamentalsPeriod,\n  GetAISummaryOptions,\n  GetChartOptions,\n  GetDescriptionsOptions,\n  GetFundamentalsOptions,\n  GetImagesOptions,\n  GetMetricsBreakdownOptions,\n  GetProfileOptions,\n  GetSimilarOptions,\n  KpiCoverageResponse,\n  KpiTypeEntry,\n  MarketStatus,\n  MetricsBreakdown,\n  PreviewResponse,\n  SimilarStock,\n  ShortInterest,\n  ShortVolume,\n  StockDetail,\n  StockEntity,\n  StockImage,\n  StockPrice,\n  StockProfile,\n  StockQuote,\n} from \"../types.js\";\n\nexport class Stocks {\n  constructor(private client: APIClient) {}\n\n  /** List all available ticker symbols. */\n  async list(): Promise<string[]> {\n    return this.client.get(\"/api/v1/stocks\");\n  }\n\n  /** List all stocks with name, kbEntityId, urlSlug. */\n  async listDetailed(): Promise<StockDetail[]> {\n    return this.client.get(\"/api/v1/stocks/detailed\");\n  }\n\n  /** Get popular ticker symbols. */\n  async listPopular(): Promise<string[]> {\n    return this.client.get(\"/api/v1/stocks/popular\");\n  }\n\n  /** Get popular stocks with details. */\n  async listPopularDetailed(): Promise<StockDetail[]> {\n    return this.client.get(\"/api/v1/stocks/popular/detailed\");\n  }\n\n  /** Get real-time price for a single ticker. */\n  async getPrice(ticker: string): Promise<StockPrice> {\n    return this.client.get(\"/api/v1/stocks/price\", { ticker });\n  }\n\n  /**\n   * Get aggregate quote snapshot: live price, today OHLC, 52-week range,\n   * market cap, P/E, EPS TTM, and dividend yield in a single call.\n   * All fields except `ticker` may be null when upstream data is unavailable.\n   */\n  async getQuote(ticker: string): Promise<StockQuote> {\n    return this.client.get(`/api/v1/stocks/${encodeURIComponent(ticker)}/quote`);\n  }\n\n  /** Get real-time prices for multiple tickers. */\n  async getPrices(tickers: string[]): Promise<StockPrice[]> {\n    return this.client.get(\"/api/v1/stocks/prices\", {\n      tickers: tickers.join(\",\"),\n    });\n  }\n\n  /** Get batch company logo URLs. */\n  async getImages(\n    tickers: string[],\n    options?: GetImagesOptions,\n  ): Promise<Record<string, StockImage>> {\n    return this.client.get(\"/api/v1/stocks/images\", {\n      tickers: tickers.join(\",\"),\n      ...options,\n    });\n  }\n\n  /** Get company profiles with branding, market cap, sector. */\n  async getDescriptions(\n    tickers: string[],\n    options?: GetDescriptionsOptions,\n  ): Promise<Record<string, StockProfile>> {\n    return this.client.get(\"/api/v1/stocks/descriptions\", {\n      tickers: tickers.join(\",\"),\n      ...options,\n    });\n  }\n\n  /** Get peer/similar stocks. */\n  async getSimilar(ticker: string, options?: GetSimilarOptions): Promise<SimilarStock[]> {\n    return this.client.get(`/api/v1/stocks/${encodeURIComponent(ticker)}/similar`, options);\n  }\n\n  /** Get company profile (CEO, sector, industry, market data). */\n  async getProfile(ticker: string, options?: GetProfileOptions): Promise<StockProfile> {\n    return this.client.get(`/api/v1/stocks/${encodeURIComponent(ticker)}/profile`, options);\n  }\n\n  /** Get related KB entities (people, products, partners). */\n  async getEntities(ticker: string): Promise<StockEntity[]> {\n    return this.client.get(`/api/v1/stocks/${encodeURIComponent(ticker)}/entities`);\n  }\n\n  /** Get AI-generated stock analysis report. Requires PRO tier. */\n  async getAISummary(ticker: string, options?: GetAISummaryOptions): Promise<AISummary> {\n    return this.client.get(`/api/v1/stocks/${encodeURIComponent(ticker)}/ai-summary`, options);\n  }\n\n  /** Get sentiment/mention metrics breakdown by entity. */\n  async getMetricsBreakdown(\n    ticker: string,\n    metricType: string,\n    options?: GetMetricsBreakdownOptions,\n  ): Promise<MetricsBreakdown> {\n    return this.client.get(\n      `/api/v1/stocks/${encodeURIComponent(ticker)}/metrics/${encodeURIComponent(metricType)}/breakdown`,\n      options,\n    );\n  }\n\n  /**\n   * Get historical OHLCV chart data.\n   *\n   * The API returns a bare array of points; this normalizes it to\n   * `{ ticker, timeframe, data }`. `timeframe` echoes the requested value\n   * (defaulting to \"1M\", matching the server default when omitted).\n   */\n  async getChart(ticker: string, options?: GetChartOptions): Promise<ChartData> {\n    const data = await this.client.get<ChartDataPoint[]>(\"/api/v1/stocks/chart\", {\n      ticker,\n      ...options,\n    });\n    return { ticker, timeframe: options?.timeframe ?? \"1M\", data };\n  }\n\n  /** Get current market open/closed/pre-market/after-hours status. */\n  async getMarketStatus(): Promise<MarketStatus> {\n    return this.client.get(\"/api/v1/stocks/market-status\");\n  }\n\n  /** Get financial statement data. */\n  async getFundamentals(ticker: string, options?: GetFundamentalsOptions): Promise<Fundamentals> {\n    return this.client.get(\"/api/v1/stocks/fundamentals\", { ticker, ...options });\n  }\n\n  /** Get available fiscal periods. */\n  async getFundamentalsPeriods(ticker: string): Promise<FundamentalsPeriod[]> {\n    return this.client.get(\"/api/v1/stocks/fundamentals/periods\", { ticker });\n  }\n\n  /** Get most recent fundamentals snapshot. */\n  async getCurrentFundamentals(ticker: string): Promise<Fundamentals> {\n    return this.client.get(\"/api/v1/stocks/fundamentals/current\", { ticker });\n  }\n\n  /** Get historical revenue data. */\n  async getHistoricalRevenue(ticker: string): Promise<unknown> {\n    return this.client.get(\"/api/v1/stocks/fundamentals/historical/revenue\", { ticker });\n  }\n\n  /** Get short interest metrics (FINRA). */\n  async getShortInterest(ticker: string): Promise<ShortInterest> {\n    return this.client.get(\"/api/v1/stocks/short-interest\", { ticker });\n  }\n\n  /** Get float information. */\n  async getFloat(ticker: string): Promise<FloatInfo> {\n    return this.client.get(\"/api/v1/stocks/float\", { ticker });\n  }\n\n  /** Get short volume trading data. */\n  async getShortVolume(ticker: string): Promise<ShortVolume> {\n    return this.client.get(\"/api/v1/stocks/short-volume\", { ticker });\n  }\n\n  /**\n   * Get company-specific KPI time-series for a ticker. Returns curated GAAP and\n   * non-GAAP metrics from earnings filings (e.g. iPhone unit sales, Tesla deliveries,\n   * AWS revenue).\n   *\n   * Free users receive metadata only with an empty `kpis` list; PRO users receive\n   * the full series. Returns 404 for tickers that do not yet have curated coverage.\n   *\n   * Coverage today: near-complete for the S&P 500 plus extended universe\n   * (~500 tickers). Use `listKpiCoverage()` to enumerate.\n   */\n  async getKpis(ticker: string): Promise<PreviewResponse<CompanyKpisData>> {\n    return this.client.get(\n      `/api/v1/stocks/${encodeURIComponent(ticker.toUpperCase())}/kpis`,\n    );\n  }\n\n  /**\n   * List every ticker with curated KPI coverage. Returns `{count, tickers: [...]}`\n   * with lightweight metadata (ticker, companyName, lastUpdated, kpiCount).\n   * Sorted alphabetically by ticker.\n   *\n   * Auth: API key required, but the call does NOT consume your monthly quota\n   * (rate-limit-per-minute still applies).\n   */\n  async listKpiCoverage(): Promise<KpiCoverageResponse> {\n    return this.client.get(\"/api/v1/stocks/with-kpis\");\n  }\n\n  /**\n   * List the KPI metadata tuples available for a ticker — `id, name, category,\n   * chartType` — without paying the cost of the full series payload. Mirrors\n   * the `/api/v1/insights/stock/{ticker}/types` precedent.\n   *\n   * Auth: API key required, no quota cost. 404 if the ticker has no curated KPIs.\n   */\n  async getKpiTypes(ticker: string): Promise<KpiTypeEntry[]> {\n    return this.client.get(\n      `/api/v1/stocks/${encodeURIComponent(ticker.toUpperCase())}/kpis/types`,\n    );\n  }\n}\n","import type { APIClient } from \"../client.js\";\nimport type {\n  TrackerListing,\n  TrackerListResponse,\n  TrackerSnapshot,\n  TrackerSnapshotResponse,\n} from \"../types.js\";\n\n/**\n * Trackers — observational data products published as a standardized\n * `TrackerSnapshot` envelope. Every tracker (institution rankings,\n * hedge-fund reported returns, social trackers, surveillance dashboards)\n * returns the same shape — consumers write one renderer per `viewType` and\n * get every current and future SentiSense tracker for free.\n *\n * @see TrackerSnapshot\n */\nexport class Trackers {\n  constructor(private client: APIClient) {}\n\n  /**\n   * List every publicly-visible tracker — id, display name, category,\n   * one-line description, and the methodology anchor to link out to.\n   */\n  async list(): Promise<TrackerListResponse> {\n    return this.client.get(\"/api/v1/trackers\");\n  }\n\n  /**\n   * Standardized snapshot envelope for one tracker.\n   *\n   * Returns the envelope as-is: `{ isPreview, previewReason, totalCount?, data }`.\n   * When `data.viewType === \"table\"` the rows live at `data.rows[]`; when\n   * `\"choropleth\"` they live at `data.geo[]`; etc. Dispatch on `viewType`\n   * in your renderer.\n   *\n   * @param trackerId — slug from {@link list}, e.g. `\"institution-concentration\"`.\n   * @param params — provider-specific query params (e.g. `{ scope: \"us\" }` for\n   *   geographically-scoped trackers like hantavirus). Unknown keys are ignored.\n   */\n  async get(\n    trackerId: string,\n    params?: Record<string, string | number | boolean>,\n  ): Promise<TrackerSnapshotResponse> {\n    return this.client.get(`/api/v1/trackers/${trackerId}`, params);\n  }\n}\n\n// Re-export for convenience so callers can `import type { TrackerListing }`\n// from the resource module instead of `../types`.\nexport type {\n  TrackerListing,\n  TrackerListResponse,\n  TrackerSnapshot,\n  TrackerSnapshotResponse,\n};\n","export const VERSION = \"0.27.0\";\n","import {\n  APIError,\n  AuthenticationError,\n  NotFoundError,\n  RateLimitError,\n  SentiSenseError,\n} from \"./errors.js\";\nimport { Analyst } from \"./resources/analyst.js\";\nimport { Calendar } from \"./resources/calendar.js\";\nimport { Documents } from \"./resources/documents.js\";\nimport { EntityMetrics } from \"./resources/entityMetrics.js\";\nimport { Etfs } from \"./resources/etfs.js\";\nimport { Insider } from \"./resources/insider.js\";\nimport { Politicians } from \"./resources/politicians.js\";\nimport { Insights } from \"./resources/insights.js\";\nimport { Institutional } from \"./resources/institutional.js\";\nimport { KB } from \"./resources/kb.js\";\nimport { MarketMoodResource } from \"./resources/marketMood.js\";\nimport { MarketSummaryResource } from \"./resources/marketSummary.js\";\nimport { Stocks } from \"./resources/stocks.js\";\nimport { Trackers } from \"./resources/trackers.js\";\nimport type { SentiSenseOptions } from \"./types.js\";\nimport { VERSION } from \"./version.js\";\n\nconst DEFAULT_BASE_URL = \"https://app.sentisense.ai\";\nconst DEFAULT_TIMEOUT = 30_000;\nconst DEFAULT_MAX_RETRIES = 3;\nconst BASE_DELAY_MS = 1_000;\nconst MAX_DELAY_MS = 60_000;\n\nfunction sleep(ms: number): Promise<void> {\n  return new Promise((resolve) => setTimeout(resolve, ms));\n}\n\n/** @internal HTTP interface exposed to resource classes. */\nexport interface APIClient {\n  get<T = unknown>(path: string, params?: object): Promise<T>;\n  post<T = unknown>(path: string, body: unknown): Promise<T>;\n}\n\nexport class SentiSense implements APIClient {\n  private baseUrl: string;\n  private apiKey: string | undefined;\n  private timeout: number;\n  private maxRetries: number;\n\n  readonly stocks: Stocks;\n  readonly documents: Documents;\n  readonly etfs: Etfs;\n  readonly institutional: Institutional;\n  readonly insider: Insider;\n  readonly politicians: Politicians;\n  readonly insights: Insights;\n  readonly analyst: Analyst;\n  readonly entityMetrics: EntityMetrics;\n  readonly marketMood: MarketMoodResource;\n  readonly marketSummary: MarketSummaryResource;\n  readonly kb: KB;\n  readonly trackers: Trackers;\n  readonly calendar: Calendar;\n\n  constructor(options: SentiSenseOptions = {}) {\n    this.apiKey = options.apiKey;\n    this.baseUrl = (options.baseUrl ?? DEFAULT_BASE_URL).replace(/\\/+$/, \"\");\n    this.timeout = options.timeout ?? DEFAULT_TIMEOUT;\n    this.maxRetries = options.maxRetries ?? DEFAULT_MAX_RETRIES;\n\n    this.stocks = new Stocks(this);\n    this.documents = new Documents(this);\n    this.etfs = new Etfs(this);\n    this.institutional = new Institutional(this);\n    this.insider = new Insider(this);\n    this.politicians = new Politicians(this);\n    this.insights = new Insights(this);\n    this.analyst = new Analyst(this);\n    this.entityMetrics = new EntityMetrics(this);\n    this.marketMood = new MarketMoodResource(this);\n    this.marketSummary = new MarketSummaryResource(this);\n    this.kb = new KB(this);\n    this.trackers = new Trackers(this);\n    this.calendar = new Calendar(this);\n  }\n\n  /** @internal */\n  async get<T = unknown>(path: string, params?: object): Promise<T> {\n    const url = this.buildUrl(path, params);\n    const headers: Record<string, string> = {\n      \"Accept\": \"application/json\",\n    };\n\n    if (this.apiKey) {\n      headers[\"X-SentiSense-API-Key\"] = this.apiKey;\n    }\n\n    // User-Agent is only set in Node.js (browsers disallow it)\n    if (typeof process !== \"undefined\" && process.versions?.node) {\n      headers[\"User-Agent\"] = `sentisense-node/${VERSION}`;\n    }\n\n    let delayMs = 0;\n\n    for (let attempt = 0; attempt <= this.maxRetries; attempt++) {\n      if (delayMs > 0) {\n        await sleep(delayMs);\n        delayMs = 0;\n      }\n\n      const controller = new AbortController();\n      const timer = setTimeout(() => controller.abort(), this.timeout);\n\n      try {\n        const response = await fetch(url, {\n          method: \"GET\",\n          headers,\n          signal: controller.signal,\n        });\n\n        if (!response.ok) {\n          const isRetryable = response.status === 429 || response.status >= 500;\n          if (isRetryable && attempt < this.maxRetries) {\n            if (response.status === 429) {\n              const ra = response.headers.get(\"Retry-After\");\n              delayMs = (ra ? parseInt(ra, 10) : 60) * 1000;\n            } else {\n              delayMs = Math.min(BASE_DELAY_MS * Math.pow(2, attempt), MAX_DELAY_MS) + Math.random() * 1000;\n            }\n            try { await response.body?.cancel(); } catch { /* ignore */ }\n            continue;\n          }\n          await this.handleErrorResponse(response);\n        }\n\n        return (await response.json()) as T;\n      } catch (error) {\n        if (error instanceof SentiSenseError) throw error;\n        if (error instanceof Error && error.name === \"AbortError\") {\n          throw new SentiSenseError(`Request timed out after ${this.timeout}ms`);\n        }\n        throw new SentiSenseError(\n          error instanceof Error ? error.message : \"Unknown error\",\n        );\n      } finally {\n        clearTimeout(timer);\n      }\n    }\n\n    throw new SentiSenseError(\"All retries exhausted\");\n  }\n\n  /** @internal */\n  async post<T = unknown>(path: string, body: unknown): Promise<T> {\n    const url = this.buildUrl(path);\n    const headers: Record<string, string> = {\n      \"Accept\": \"application/json\",\n      \"Content-Type\": \"application/json\",\n    };\n\n    if (this.apiKey) {\n      headers[\"X-SentiSense-API-Key\"] = this.apiKey;\n    }\n\n    if (typeof process !== \"undefined\" && process.versions?.node) {\n      headers[\"User-Agent\"] = `sentisense-node/${VERSION}`;\n    }\n\n    const controller = new AbortController();\n    const timer = setTimeout(() => controller.abort(), this.timeout);\n\n    try {\n      const response = await fetch(url, {\n        method: \"POST\",\n        headers,\n        body: JSON.stringify(body),\n        signal: controller.signal,\n      });\n\n      if (!response.ok) {\n        await this.handleErrorResponse(response);\n      }\n\n      return (await response.json()) as T;\n    } catch (error) {\n      if (error instanceof SentiSenseError) throw error;\n      if (error instanceof Error && error.name === \"AbortError\") {\n        throw new SentiSenseError(`Request timed out after ${this.timeout}ms`);\n      }\n      throw new SentiSenseError(\n        error instanceof Error ? error.message : \"Unknown error\",\n      );\n    } finally {\n      clearTimeout(timer);\n    }\n  }\n\n  private buildUrl(path: string, params?: object): string {\n    const url = new URL(path, this.baseUrl);\n    if (params) {\n      for (const [key, value] of Object.entries(params as Record<string, unknown>)) {\n        if (value !== undefined && value !== null) {\n          url.searchParams.set(key, String(value));\n        }\n      }\n    }\n    return url.toString();\n  }\n\n  private async handleErrorResponse(response: Response): Promise<never> {\n    let body: { error?: string; message?: string } = {};\n    try {\n      body = await response.json();\n    } catch {\n      // Response may not be JSON\n    }\n\n    const message = body.message ?? response.statusText ?? \"API request failed\";\n    const code = body.error;\n\n    switch (response.status) {\n      case 401:\n      case 403:\n        throw new AuthenticationError(message, response.status, code);\n      case 404:\n        throw new NotFoundError(message, code);\n      case 429: {\n        const ra = response.headers.get(\"Retry-After\");\n        throw new RateLimitError(message, code, ra ? parseInt(ra, 10) : undefined);\n      }\n      default:\n        throw new APIError(message, response.status, code);\n    }\n  }\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/errors.ts","../src/resources/analyst.ts","../src/resources/calendar.ts","../src/resources/documents.ts","../src/resources/entityMetrics.ts","../src/resources/etfs.ts","../src/resources/insider.ts","../src/resources/politicians.ts","../src/resources/insights.ts","../src/resources/institutional.ts","../src/resources/kb.ts","../src/resources/marketMood.ts","../src/resources/marketSummary.ts","../src/resources/stocks.ts","../src/resources/trackers.ts","../src/version.ts","../src/client.ts"],"sourcesContent":["export class SentiSenseError extends Error {\n  status?: number;\n  code?: string;\n\n  constructor(message: string, status?: number, code?: string) {\n    super(message);\n    this.name = \"SentiSenseError\";\n    this.status = status;\n    this.code = code;\n  }\n}\n\nexport class AuthenticationError extends SentiSenseError {\n  constructor(message: string, status: number, code?: string) {\n    super(message, status, code);\n    this.name = \"AuthenticationError\";\n  }\n}\n\nexport class NotFoundError extends SentiSenseError {\n  constructor(message: string, code?: string) {\n    super(message, 404, code);\n    this.name = \"NotFoundError\";\n  }\n}\n\nexport class RateLimitError extends SentiSenseError {\n  retryAfter?: number;\n\n  constructor(message: string, code?: string, retryAfter?: number) {\n    super(message, 429, code);\n    this.name = \"RateLimitError\";\n    this.retryAfter = retryAfter;\n  }\n}\n\nexport class APIError extends SentiSenseError {\n  constructor(message: string, status: number, code?: string) {\n    super(message, status, code);\n    this.name = \"APIError\";\n  }\n}\n","import type { APIClient } from \"../client.js\";\nimport type { PreviewResponse } from \"../types.js\";\n\nexport interface AnalystConsensus {\n  ticker: string;\n  currentPrice: number | null;\n  targetLow: number | null;\n  targetMean: number | null;\n  targetHigh: number | null;\n  targetMedian: number | null;\n  numberOfAnalysts: number;\n  upsidePercent: number | null;\n  consensusLabel: string | null;\n  recommendationMean: number | null;\n  /** PRO-only; zero in the free preview. */\n  strongBuy: number;\n  /** PRO-only; zero in the free preview. */\n  buy: number;\n  /** PRO-only; zero in the free preview. */\n  hold: number;\n  /** PRO-only; zero in the free preview. */\n  sell: number;\n  /** PRO-only; zero in the free preview. */\n  strongSell: number;\n  updatedAt: string | null;\n}\n\nexport interface AnalystAction {\n  ticker: string;\n  actionDate: string;\n  firm: string;\n  /** UPGRADE, DOWNGRADE, INITIATE, REITERATE, OTHER */\n  actionType: string;\n  fromGrade: string | null;\n  toGrade: string | null;\n}\n\nexport interface AnalystEstimate {\n  /** Fiscal period descriptor (provider-specific shape). */\n  [key: string]: unknown;\n}\n\nexport interface AnalystEarningsSurprise {\n  /** Past report descriptor (provider-specific shape). */\n  [key: string]: unknown;\n}\n\nexport interface AnalystEstimatesResponse {\n  estimates: AnalystEstimate[];\n  surprises: AnalystEarningsSurprise[];\n}\n\nexport interface GetAnalystActionsOptions {\n  /** Days of history to return. Default 90. */\n  lookbackDays?: number;\n}\n\nexport interface GetAnalystMarketActivityOptions {\n  /** Days of history to return. Default 30. */\n  lookbackDays?: number;\n}\n\n/**\n * Wall Street analyst coverage: aggregate price targets, recommendation distribution,\n * recent upgrade/downgrade actions, and forward EPS estimates with earnings surprise history.\n *\n * Free users receive the price target band (low/mean/high + analyst count + consensus label)\n * in full -- it powers the public projection cone. The buy/hold/sell distribution counts\n * and full action/estimate history are PRO-only.\n */\nexport class Analyst {\n  constructor(private client: APIClient) {}\n\n  /**\n   * Get the aggregate Wall Street consensus for a ticker. Returns 404 if no\n   * coverage exists.\n   */\n  async consensus(\n    ticker: string,\n  ): Promise<PreviewResponse<AnalystConsensus>> {\n    return this.client.get(\n      `/api/v1/analyst/${encodeURIComponent(ticker.toUpperCase())}/consensus`,\n    );\n  }\n\n  /**\n   * Get recent analyst upgrade/downgrade actions for a ticker, newest first.\n   * Free users receive the 3 most recent.\n   */\n  async actions(\n    ticker: string,\n    options?: GetAnalystActionsOptions,\n  ): Promise<PreviewResponse<AnalystAction[]>> {\n    return this.client.get(\n      `/api/v1/analyst/${encodeURIComponent(ticker.toUpperCase())}/actions`,\n      options,\n    );\n  }\n\n  /**\n   * Get forward EPS estimates and earnings surprise history for a ticker.\n   * Free users receive 1 estimate (current quarter) plus the 2 most recent surprises.\n   */\n  async estimates(\n    ticker: string,\n  ): Promise<PreviewResponse<AnalystEstimatesResponse>> {\n    return this.client.get(\n      `/api/v1/analyst/${encodeURIComponent(ticker.toUpperCase())}/estimates`,\n    );\n  }\n\n  /**\n   * Get market-wide recent analyst actions across all covered tickers, newest first.\n   * Free users receive the 5 most recent.\n   */\n  async marketActivity(\n    options?: GetAnalystMarketActivityOptions,\n  ): Promise<PreviewResponse<AnalystAction[]>> {\n    return this.client.get(\"/api/v1/analyst/activity\", options);\n  }\n}\n","import type { APIClient } from \"../client.js\";\nimport type {\n  EarningsCalendarResponse,\n  GetEarningsCalendarOptions,\n  PreviewResponse,\n} from \"../types.js\";\n\nexport class Calendar {\n  constructor(private client: APIClient) {}\n\n  /**\n   * Upcoming company earnings, sorted by date.\n   *\n   * Key-required. A FREE key returns the current week (`isPreview: true`); a PRO\n   * key returns the full forward window (about 30 days). Field richness is\n   * identical across tiers: the gate is how far ahead you can see, not which\n   * columns you get. On a preview, `totalCount` is the full-window event count.\n   */\n  async getEarnings(\n    options?: GetEarningsCalendarOptions,\n  ): Promise<PreviewResponse<EarningsCalendarResponse>> {\n    return this.client.get(\"/api/v1/calendar/earnings\", options);\n  }\n}\n","import type { APIClient } from \"../client.js\";\nimport type {\n  Document,\n  DocumentSource,\n  GetByEntityOptions,\n  GetBySourceOptions,\n  GetByTickerOptions,\n  GetByTickerRangeOptions,\n  GetStoriesByTickerOptions,\n  GetStoriesOptions,\n  SearchDocumentsOptions,\n  Story,\n} from \"../types.js\";\n\nexport class Documents {\n  constructor(private client: APIClient) {}\n\n  /** Get document metrics for a stock. */\n  async getByTicker(ticker: string, options?: GetByTickerOptions): Promise<Document[]> {\n    return this.client.get(`/api/v1/documents/ticker/${encodeURIComponent(ticker)}`, options);\n  }\n\n  /** Get document metrics for a stock within a date range. */\n  async getByTickerRange(ticker: string, options: GetByTickerRangeOptions): Promise<Document[]> {\n    return this.client.get(\n      `/api/v1/documents/ticker/${encodeURIComponent(ticker)}/range`,\n      options,\n    );\n  }\n\n  /** Get document metrics for a KB entity. */\n  async getByEntity(entityId: string, options?: GetByEntityOptions): Promise<Document[]> {\n    return this.client.get(\n      `/api/v1/documents/entity/${encodeURIComponent(entityId)}`,\n      options,\n    );\n  }\n\n  /** Smart search with natural language query parsing. */\n  async search(query: string, options?: SearchDocumentsOptions): Promise<Document[]> {\n    return this.client.get(\"/api/v1/documents/search\", { query, ...options });\n  }\n\n  /** Get latest document metrics from a source type. */\n  async getBySource(source: DocumentSource, options?: GetBySourceOptions): Promise<Document[]> {\n    return this.client.get(\n      `/api/v1/documents/source/${encodeURIComponent(source)}`,\n      options,\n    );\n  }\n\n  /** Get AI-curated news story clusters. */\n  async getStories(options?: GetStoriesOptions): Promise<Story[]> {\n    return this.client.get(\"/api/v1/documents/stories\", options);\n  }\n\n  /** Get full story detail by cluster ID. */\n  async getStoryDetail(clusterId: string): Promise<unknown> {\n    return this.client.get(`/api/v1/documents/stories/${encodeURIComponent(clusterId)}`);\n  }\n\n  /** Get stories for a specific stock. */\n  async getStoriesByTicker(\n    ticker: string,\n    options?: GetStoriesByTickerOptions,\n  ): Promise<Story[]> {\n    return this.client.get(\n      `/api/v1/documents/stories/ticker/${encodeURIComponent(ticker)}`,\n      options,\n    );\n  }\n\n}\n","import type { APIClient } from \"../client.js\";\nimport type {\n  EntityMetricsDateRange,\n  GetMentionCountOptions,\n  GetMentionsOptions,\n  GetSentimentBySourceOptions,\n  MentionCount,\n  MentionData,\n  MetricType,\n  MetricsOptions,\n  MetricDistributionOptions,\n  SentimentData,\n  ServingMetric,\n  MetricDistribution,\n} from \"../types.js\";\n\nexport class EntityMetrics {\n  constructor(private client: APIClient) {}\n\n  // ── v2 API methods ──────────────────────────────────────────\n\n  /**\n   * Get time-series metric data for an entity using the v2 Serving Metrics API.\n   *\n   * @param symbol   Ticker symbol (e.g. \"AAPL\") — the backend resolves the entity.\n   * @param options  Metric type and optional time range / resolution.\n   */\n  async getMetrics(\n    symbol: string,\n    options: MetricsOptions = {},\n  ): Promise<ServingMetric[]> {\n    const { metricType = \"sentiment\", startTime, endTime, maxDataPoints } = options;\n    return this.client.get(\n      `/api/v2/metrics/entity/${encodeURIComponent(symbol)}/metric/${encodeURIComponent(metricType)}`,\n      {\n        ...(startTime !== undefined && { startTime }),\n        ...(endTime !== undefined && { endTime }),\n        ...(maxDataPoints !== undefined && { maxDataPoints }),\n      },\n    );\n  }\n\n  /**\n   * Get distribution data for a metric, broken down by a dimension (default: source).\n   *\n   * @param symbol     Ticker symbol (e.g. \"AAPL\").\n   * @param metricType The metric to break down (e.g. \"mentions\", \"sentiment\").\n   * @param options    Optional dimension parameter.\n   */\n  async getDistribution(\n    symbol: string,\n    metricType: MetricType,\n    options: MetricDistributionOptions = {},\n  ): Promise<MetricDistribution> {\n    const { dimension = \"source\" } = options;\n    return this.client.get(\n      `/api/v2/metrics/entity/${encodeURIComponent(symbol)}/distribution/${encodeURIComponent(metricType)}`,\n      { dimension },\n    );\n  }\n\n  // ── Deprecated v1 methods (kept for backward compatibility) ─\n\n  /**\n   * @deprecated Use `getMetrics(symbol, { metricType: \"mentions\" })` instead.\n   */\n  async getMentions(symbol: string, options?: GetMentionsOptions): Promise<MentionData> {\n    return this.client.get(\n      `/api/v1/entity-metrics/stocks/${encodeURIComponent(symbol)}/mentions`,\n      options,\n    );\n  }\n\n  /**\n   * @deprecated Use `getDistribution(symbol, \"mentions\", { dimension: \"source\" })` instead.\n   */\n  async getMentionCountBySource(\n    symbol: string,\n    options?: EntityMetricsDateRange,\n  ): Promise<MentionCount> {\n    return this.client.get(\n      `/api/v1/entity-metrics/stocks/${encodeURIComponent(symbol)}/mentions/count/by-source`,\n      options,\n    );\n  }\n\n  /**\n   * @deprecated Use `getMetrics(symbol, { metricType: \"mentions\" })` instead.\n   */\n  async getMentionCount(symbol: string, options?: GetMentionCountOptions): Promise<MentionCount> {\n    return this.client.get(\n      `/api/v1/entity-metrics/stocks/${encodeURIComponent(symbol)}/mentions/count`,\n      options,\n    );\n  }\n\n  /**\n   * @deprecated Use `getMetrics(symbol, { metricType: \"sentiment\" })` instead.\n   */\n  async getSentiment(symbol: string, options?: EntityMetricsDateRange): Promise<SentimentData> {\n    return this.client.get(\n      `/api/v1/entity-metrics/stocks/${encodeURIComponent(symbol)}/sentiment`,\n      options,\n    );\n  }\n\n  /**\n   * @deprecated Use `getDistribution(symbol, \"sentiment\", { dimension: \"source\" })` instead.\n   */\n  async getSentimentBySource(\n    symbol: string,\n    options?: GetSentimentBySourceOptions,\n  ): Promise<SentimentData> {\n    return this.client.get(\n      `/api/v1/entity-metrics/stocks/${encodeURIComponent(symbol)}/sentiment/by-source`,\n      options,\n    );\n  }\n\n  /**\n   * @deprecated Use `getMetrics(symbol, { metricType: \"sentiment\" })` instead.\n   */\n  async getAverageSentiment(\n    symbol: string,\n    options?: EntityMetricsDateRange,\n  ): Promise<SentimentData> {\n    return this.client.get(\n      `/api/v1/entity-metrics/stocks/${encodeURIComponent(symbol)}/sentiment/average`,\n      options,\n    );\n  }\n}\n","import type { APIClient } from \"../client.js\";\nimport type { PreviewResponse } from \"../types.js\";\n\nexport interface EtfInfo {\n  ticker: string;\n  name: string;\n  kbEntityId: string | null;\n  urlSlug: string | null;\n  issuer: string | null;\n  trackedIndex: string | null;\n  assetClass: string | null;\n}\n\nexport interface EtfHolding {\n  ticker: string;\n  name: string | null;\n  /** Weight in the fund as a percentage (0-100). */\n  weightPct: number;\n  /** ISO date \"YYYY-MM-DD\" — first date this holding appeared in the composition. */\n  firstSeen: string | null;\n}\n\nexport interface EtfHoldings {\n  ticker: string;\n  issuer: string;\n  issuerEndpoint: string | null;\n  /** ISO date \"YYYY-MM-DD\" — composition snapshot date from the issuer. */\n  asOfDate: string;\n  /** Epoch seconds when SentiSense refreshed the composition. */\n  fetchedAt: number | null;\n  /** ISO date \"YYYY-MM-DD\" — when the composition is scheduled to be refreshed next. */\n  nextRefreshDue: string;\n  totalHoldings: number;\n  holdings: EtfHolding[];\n  /** True when this is a top-N view rather than the full fund. */\n  partial?: boolean | null;\n  /** Issuer's reported total holdings when `partial=true`. */\n  totalKnownHoldings?: number | null;\n}\n\nexport interface EtfAggregateCoverage {\n  holdingsCount: number;\n  holdingsCovered: number;\n  /** Sum of weights (0-100) for the covered holdings. */\n  weightCovered: number;\n  partial?: boolean | null;\n  totalKnownHoldings?: number | null;\n}\n\nexport interface WeightedConsensus {\n  upsidePercent: number | null;\n  consensusLabel: string | null;\n  /** Fractions of covered AUM in each bucket. Sums to ~1.0. */\n  distribution: Record<string, number>;\n  totalAnalysts: number;\n}\n\nexport interface EtfAnalystContributor {\n  ticker: string;\n  weightPct: number;\n  upsidePercent: number | null;\n  consensusLabel: string | null;\n  /** Signed contribution to the fund's weighted upside in percentage points. */\n  contributionPp: number;\n}\n\nexport interface EtfAnalystAggregate {\n  ticker: string;\n  /** ISO date \"YYYY-MM-DD\" — composition snapshot date. */\n  asOfDate: string | null;\n  /** Epoch seconds when this rollup was computed. */\n  computedAt: number;\n  coverage: EtfAggregateCoverage;\n  weightedConsensus: WeightedConsensus;\n  /** Top contributors (up to 10) by absolute contribution to the weighted upside. */\n  topContributors: EtfAnalystContributor[];\n}\n\nexport interface WeightedNetFlow {\n  /** Weighted net dollar flow (buys - sells). Negative = net selling. */\n  netDollars: number;\n  buyDollars: number;\n  sellDollars: number;\n  /** Unweighted; for context. */\n  buyTradeCount: number;\n  /** Unweighted; for context. */\n  sellTradeCount: number;\n  distinctInsiderCount: number;\n}\n\nexport interface EtfInsiderContributor {\n  ticker: string;\n  weightPct: number;\n  /** Per-stock net flow over the window (signed). */\n  netDollars: number;\n  /** Signed contribution to the weighted headline. */\n  weightedNetDollars: number;\n  tradeCount: number;\n}\n\nexport interface EtfInsiderAggregate {\n  ticker: string;\n  /** ISO date \"YYYY-MM-DD\" — composition snapshot date. */\n  asOfDate: string | null;\n  /** Epoch seconds when this rollup was computed. */\n  computedAt: number;\n  lookbackDays: number;\n  coverage: EtfAggregateCoverage;\n  weightedNetFlow: WeightedNetFlow;\n  /** Top contributors (up to 10) by absolute weighted-net-dollar contribution. */\n  topContributors: EtfInsiderContributor[];\n}\n\nexport interface EtfSentimentReading {\n  sentiSenseScore: number | null;\n  /** BULLISH / NEUTRAL / BEARISH. */\n  scoreLabel: string;\n  /** Epoch seconds when the underlying metric was produced. */\n  asOfTimestamp: number | null;\n}\n\nexport interface EtfSentimentAggregate {\n  ticker: string;\n  /** ISO date \"YYYY-MM-DD\" — composition snapshot date. */\n  asOfDate: string | null;\n  /** Epoch seconds when this aggregate was assembled. */\n  computedAt: number;\n  coverage: EtfAggregateCoverage;\n  /** Holdings-weighted SentiSense across the fund's constituents. */\n  constituentsWeighted: EtfSentimentReading;\n  /** Direct reading from mentions of the fund's own ticker. Null for low-mention funds. */\n  direct: EtfSentimentReading | null;\n}\n\nexport interface GetEtfInsiderAggregateOptions {\n  /** Trailing window for the trade aggregation. Typical values: 30, 90. Default 30. */\n  lookbackDays?: number;\n}\n\n/**\n * ETF discovery, composition (holdings), and holdings-weighted aggregate views.\n *\n * Funds aren't rated by analysts directly, don't have insiders of their own, and\n * may not get many direct news mentions -- but the companies inside them do. The\n * aggregate endpoints synthesize fund-level views from each constituent's per-stock\n * data, weighted by allocation, with a coverage block so consumers see how much of\n * the fund's AUM the underlying data covered.\n *\n * Beta as of 2026-05-15: starting with a limited set of widely-traded funds.\n */\nexport class Etfs {\n  constructor(private client: APIClient) {}\n\n  /**\n   * List every ETF tracked by SentiSense, sorted by ticker.\n   */\n  async list(): Promise<EtfInfo[]> {\n    return this.client.get(\"/api/v1/etfs\");\n  }\n\n  /**\n   * Get the full holdings composition for an ETF, including per-holding weights\n   * and freshness metadata. Returns 404 for unknown ETFs or commodity-only funds.\n   */\n  async holdings(ticker: string): Promise<EtfHoldings> {\n    return this.client.get(\n      `/api/v1/etfs/${encodeURIComponent(ticker.toUpperCase())}/holdings`,\n    );\n  }\n\n  /**\n   * Get the holdings-weighted analyst consensus for an ETF, including the\n   * top per-holding contributors that drive the weighted upside.\n   */\n  async analystAggregate(\n    ticker: string,\n  ): Promise<PreviewResponse<EtfAnalystAggregate>> {\n    return this.client.get(\n      `/api/v1/etfs/${encodeURIComponent(ticker.toUpperCase())}/aggregates/analyst`,\n    );\n  }\n\n  /**\n   * Get the holdings-weighted SEC Form 4 insider aggregate for an ETF over a\n   * configurable trailing window, including per-holding `topContributors` with\n   * signed contribution to the weighted headline.\n   */\n  async insiderAggregate(\n    ticker: string,\n    options?: GetEtfInsiderAggregateOptions,\n  ): Promise<PreviewResponse<EtfInsiderAggregate>> {\n    return this.client.get(\n      `/api/v1/etfs/${encodeURIComponent(ticker.toUpperCase())}/aggregates/insider`,\n      options,\n    );\n  }\n\n  /**\n   * Get two SentiSense Score readings side-by-side: `constituentsWeighted`\n   * (precomputed daily weighted average across the fund's holdings) and `direct`\n   * (score from mentions of the fund's own ticker). The two can diverge, and the\n   * gap is itself information.\n   */\n  async sentimentAggregate(\n    ticker: string,\n  ): Promise<PreviewResponse<EtfSentimentAggregate>> {\n    return this.client.get(\n      `/api/v1/etfs/${encodeURIComponent(ticker.toUpperCase())}/aggregates/sentiment`,\n    );\n  }\n}\n","import type { APIClient } from \"../client.js\";\nimport type {\n  InsiderActivityResponse,\n  InsiderTrade,\n  ClusterBuy,\n  GetInsiderOptions,\n  PreviewResponse,\n} from \"../types.js\";\n\nexport class Insider {\n  constructor(private client: APIClient) {}\n\n  /**\n   * Get market-wide insider activity: top buys and sells aggregated by ticker.\n   *\n   * PRO-gated. Free/unauthenticated users receive a preview (top 5 per direction)\n   * with `isPreview: true` in the response.\n   */\n  async getActivity(options?: GetInsiderOptions): Promise<PreviewResponse<InsiderActivityResponse>> {\n    return this.client.get(\"/api/v1/insider/activity\", options);\n  }\n\n  /**\n   * Get individual insider transactions for a specific stock.\n   *\n   * PRO-gated. Free users receive a preview of the top 5 transactions.\n   */\n  async getTrades(ticker: string, options?: GetInsiderOptions): Promise<PreviewResponse<InsiderTrade[]>> {\n    return this.client.get(\n      `/api/v1/insider/trades/${encodeURIComponent(ticker.toUpperCase())}`,\n      options,\n    );\n  }\n\n  /**\n   * Get cluster buy signals: stocks where 3+ distinct insiders bought recently.\n   *\n   * PRO-gated. Free users receive a preview of the top 3 signals.\n   */\n  async getClusterBuys(options?: GetInsiderOptions): Promise<PreviewResponse<ClusterBuy[]>> {\n    return this.client.get(\"/api/v1/insider/cluster-buys\", options);\n  }\n}\n","import type { APIClient } from \"../client.js\";\nimport type {\n  CongressTrade,\n  PoliticianSummary,\n  PoliticianDetail,\n  GetPoliticiansOptions,\n  PreviewResponse,\n} from \"../types.js\";\n\nexport class Politicians {\n  constructor(private client: APIClient) {}\n\n  /**\n   * Get recent congressional STOCK Act trading activity across all politicians.\n   *\n   * PRO-gated. Free/unauthenticated users receive a preview (top 5 trades)\n   * with `isPreview: true` in the response.\n   */\n  async getActivity(\n    options?: GetPoliticiansOptions,\n  ): Promise<PreviewResponse<CongressTrade[]>> {\n    return this.client.get(\"/api/v1/politicians/activity\", options);\n  }\n\n  /**\n   * Get congressional trades for a specific stock.\n   *\n   * PRO-gated. Free users receive a preview of the top 3 trades.\n   */\n  async getFilings(\n    ticker: string,\n    options?: GetPoliticiansOptions,\n  ): Promise<PreviewResponse<CongressTrade[]>> {\n    return this.client.get(\n      `/api/v1/politicians/filings/${encodeURIComponent(ticker.toUpperCase())}`,\n      options,\n    );\n  }\n\n  /**\n   * Get all tracked politicians with trading summary statistics.\n   *\n   * PRO-gated. Free users receive a preview of the top 5 members.\n   */\n  async getMembers(): Promise<PreviewResponse<PoliticianSummary[]>> {\n    return this.client.get(\"/api/v1/politicians/members\");\n  }\n\n  /**\n   * Get detailed profile for a single politician: summary, recent trades, top tickers.\n   *\n   * PRO-gated. Free users receive a preview-wrapped response.\n   */\n  async getMember(slug: string): Promise<PreviewResponse<PoliticianDetail>> {\n    return this.client.get(\n      `/api/v1/politicians/member/${encodeURIComponent(slug)}`,\n    );\n  }\n}\n","import type { APIClient } from \"../client.js\";\nimport type {\n  Insight,\n  InsightPreviewResponse,\n  GetInsightsOptions,\n} from \"../types.js\";\n\nexport interface GetStockInsightsRangeOptions {\n  startDate: string;\n  endDate: string;\n  urgency?: \"low\" | \"medium\" | \"high\";\n  insightType?: string;\n}\n\nexport interface GetLatestInsightsOptions {\n  limit?: number;\n  urgency?: \"low\" | \"medium\" | \"high\";\n}\n\nexport interface GetUserInsightsOptions {\n  limit?: number;\n  category?: string;\n}\n\nexport class Insights {\n  constructor(private client: APIClient) {}\n\n  /**\n   * Get AI-generated insights for a specific stock, sorted by urgency then confidence.\n   *\n   * PRO users receive a flat array of Insight objects.\n   * Free/unauthenticated users receive a preview with `isPreview: true`,\n   * the top 3 insights in full, and a `locked` array with metadata-only entries\n   * (type, urgency, timestamp) showing what additional signals exist.\n   */\n  async stock(\n    ticker: string,\n    options?: GetInsightsOptions,\n  ): Promise<Insight[] | InsightPreviewResponse> {\n    return this.client.get(\n      `/api/v1/insights/stock/${encodeURIComponent(ticker.toUpperCase())}`,\n      options,\n    );\n  }\n\n  /**\n   * Get AI insights for a stock within a date range.\n   *\n   * Free users receive the top 3; PRO users receive the full list.\n   * The server returns 400 if `startDate` is after `endDate`.\n   */\n  async stockRange(\n    ticker: string,\n    options: GetStockInsightsRangeOptions,\n  ): Promise<Insight[] | InsightPreviewResponse> {\n    return this.client.get(\n      `/api/v1/insights/stock/${encodeURIComponent(ticker.toUpperCase())}/range`,\n      options,\n    );\n  }\n\n  /**\n   * Get AI-generated market-level insights, sorted by urgency then confidence.\n   *\n   * PRO users receive a flat array of Insight objects.\n   * Free/unauthenticated users receive a preview with `isPreview: true`,\n   * the top 5 insights in full, and a `locked` array with metadata-only entries.\n   */\n  async market(): Promise<Insight[] | InsightPreviewResponse> {\n    return this.client.get(\"/api/v1/insights/market\");\n  }\n\n  /**\n   * Get the latest AI insights across all tracked stocks, newest first.\n   *\n   * Free users receive the top 5; PRO users receive up to `limit` (clamped to 1-200).\n   */\n  async latest(\n    options?: GetLatestInsightsOptions,\n  ): Promise<Insight[] | InsightPreviewResponse> {\n    return this.client.get(\"/api/v1/insights/latest\", options);\n  }\n\n  /**\n   * Get personalized insights for the authenticated user.\n   *\n   * Biased toward the user's watchlist and portfolio when available; falls back\n   * to market-level insights otherwise. API key authentication required.\n   */\n  async user(\n    options?: GetUserInsightsOptions,\n  ): Promise<Insight[] | InsightPreviewResponse> {\n    return this.client.get(\"/api/v1/insights/user\", options);\n  }\n\n  /**\n   * Get available insight types for a specific stock.\n   * No authentication required.\n   *\n   * Returns an array of insight type strings (e.g., `[\"sentiment_shift\", \"options_activity\"]`).\n   */\n  async types(ticker: string): Promise<string[]> {\n    return this.client.get(\n      `/api/v1/insights/stock/${encodeURIComponent(ticker.toUpperCase())}/types`,\n    );\n  }\n}\n","import type { APIClient } from \"../client.js\";\nimport type {\n  GetFlowsOptions,\n  Holder,\n  InstitutionList,\n  InstitutionListResponse,\n  InstitutionalFlowsResponse,\n  ListInstitutionsOptions,\n  Quarter,\n} from \"../types.js\";\n\nexport class Institutional {\n  constructor(private client: APIClient) {}\n\n  /** Get available 13F reporting quarters. */\n  async getQuarters(): Promise<Quarter[]> {\n    return this.client.get(\"/api/v1/institutional/quarters\");\n  }\n\n  /**\n   * Get aggregate institutional activity per ticker for a quarter.\n   *\n   * `reportDate` is optional: omit it to get the latest available quarter, which may be\n   * a still-open one holding only early filers. The response then carries `reportDate`\n   * plus `isPending` and filer coverage counts so a partial quarter is clearly labeled.\n   */\n  async getFlows(reportDate?: string, options?: GetFlowsOptions): Promise<InstitutionalFlowsResponse> {\n    return this.client.get(\"/api/v1/institutional/flows\", {\n      reportDate,\n      ...options,\n    });\n  }\n\n  /** Get institutional holders for a specific stock. */\n  async getHolders(ticker: string, reportDate: string): Promise<Holder[]> {\n    return this.client.get(\n      `/api/v1/institutional/holders/${encodeURIComponent(ticker)}`,\n      { reportDate },\n    );\n  }\n\n  /** Get activist investor positions (NEW or INCREASED). */\n  async getActivists(reportDate: string): Promise<Holder[]> {\n    return this.client.get(\"/api/v1/institutional/activist\", { reportDate });\n  }\n\n  /**\n   * Discover institutions: a paginated, AUM-ranked list of filers (slug + metadata)\n   * so you can find what to query without knowing slugs upfront.\n   *\n   * Each institution is rolled up by parent filer, so a multi-filer manager\n   * (e.g. Vanguard) appears once with combined AUM. Summary only; use\n   * `getInstitutionDetail` for a filer's full holdings.\n   *\n   * Requires an API key but does not consume monthly quota (per-minute rate\n   * limits still apply). Returns the unwrapped list payload.\n   */\n  async listInstitutions(options?: ListInstitutionsOptions): Promise<InstitutionList> {\n    const resp = await this.client.get<InstitutionListResponse>(\n      \"/api/v1/institutional/institutions\",\n      { ...options },\n    );\n    return resp.data;\n  }\n\n  /**\n   * Get the full profile, summary stats, and current-quarter holdings for a\n   * specific institutional filer.\n   *\n   * Resolved by URL slug (e.g. `Berkshire-Hathaway`) or numeric SEC CIK.\n   * Free users receive the profile and top 10 holdings; PRO users receive the\n   * full holdings array. Returns 404 if the slug or CIK is unknown.\n   */\n  async getInstitutionDetail(slugOrCik: string): Promise<unknown> {\n    return this.client.get(\n      `/api/v1/institutional/institution/${encodeURIComponent(slugOrCik)}`,\n    );\n  }\n}\n","import type { APIClient } from \"../client.js\";\nimport type { KBEntity } from \"../types.js\";\n\nexport class KB {\n  constructor(private client: APIClient) {}\n\n  /** Get popular entities for search suggestions. */\n  async getPopularEntities(): Promise<KBEntity[]> {\n    return this.client.get(\"/api/v1/kb/entities/popular\");\n  }\n\n  /** Get entity detail with metrics and relationships. */\n  async getEntity(entityId: string): Promise<KBEntity> {\n    return this.client.get(`/api/v1/kb/entities/${encodeURIComponent(entityId)}`);\n  }\n\n  /** Get all tracked entities. */\n  async getAllEntities(): Promise<KBEntity[]> {\n    return this.client.get(\"/api/v1/kb/entities/all\");\n  }\n}\n","import type { APIClient } from \"../client.js\";\nimport type { MarketMood } from \"../types.js\";\n\nexport class MarketMoodResource {\n  constructor(private client: APIClient) {}\n\n  /** Get market mood data (scores, history, sectors). */\n  async get(): Promise<MarketMood> {\n    return this.client.get(\"/api/v2/market-mood\");\n  }\n\n  // TODO: accept a `days` param to control history length (the endpoint supports ?days=N).\n  // TODO: add a sibling `indexes` resource for /api/v1/indexes/{id} (+ /history), e.g. fed-sentiment.\n}\n","import type { APIClient } from \"../client.js\";\nimport type { MarketSummary } from \"../types.js\";\n\nexport class MarketSummaryResource {\n  constructor(private client: APIClient) {}\n\n  /** Get the AI-generated market summary with headline and analysis. */\n  async get(): Promise<MarketSummary> {\n    return this.client.get(\"/api/v1/market-summary\");\n  }\n}\n","import type { APIClient } from \"../client.js\";\nimport type {\n  AISummary,\n  ChartData,\n  ChartDataPoint,\n  CompanyKpisData,\n  FloatInfo,\n  Fundamentals,\n  FundamentalsPeriod,\n  GetAISummaryOptions,\n  GetChartOptions,\n  GetDescriptionsOptions,\n  GetFundamentalsOptions,\n  GetImagesOptions,\n  GetMetricsBreakdownOptions,\n  GetProfileOptions,\n  GetSimilarOptions,\n  KpiCoverageResponse,\n  KpiTypeEntry,\n  MarketStatus,\n  MetricsBreakdown,\n  PreviewResponse,\n  SimilarStock,\n  ShortInterest,\n  ShortVolume,\n  StockDetail,\n  StockEntity,\n  StockImage,\n  StockPrice,\n  StockProfile,\n  StockQuote,\n} from \"../types.js\";\n\nexport class Stocks {\n  constructor(private client: APIClient) {}\n\n  /** List all available ticker symbols. */\n  async list(): Promise<string[]> {\n    return this.client.get(\"/api/v1/stocks\");\n  }\n\n  /** List all stocks with name, kbEntityId, urlSlug. */\n  async listDetailed(): Promise<StockDetail[]> {\n    return this.client.get(\"/api/v1/stocks/detailed\");\n  }\n\n  /** Get popular ticker symbols. */\n  async listPopular(): Promise<string[]> {\n    return this.client.get(\"/api/v1/stocks/popular\");\n  }\n\n  /** Get popular stocks with details. */\n  async listPopularDetailed(): Promise<StockDetail[]> {\n    return this.client.get(\"/api/v1/stocks/popular/detailed\");\n  }\n\n  /** Get real-time price for a single ticker. */\n  async getPrice(ticker: string): Promise<StockPrice> {\n    return this.client.get(\"/api/v1/stocks/price\", { ticker });\n  }\n\n  /**\n   * Get aggregate quote snapshot: live price, today OHLC, 52-week range,\n   * market cap, P/E, EPS TTM, and dividend yield in a single call.\n   * All fields except `ticker` may be null when upstream data is unavailable.\n   */\n  async getQuote(ticker: string): Promise<StockQuote> {\n    return this.client.get(`/api/v1/stocks/${encodeURIComponent(ticker)}/quote`);\n  }\n\n  /** Get real-time prices for multiple tickers. */\n  async getPrices(tickers: string[]): Promise<StockPrice[]> {\n    return this.client.get(\"/api/v1/stocks/prices\", {\n      tickers: tickers.join(\",\"),\n    });\n  }\n\n  /** Get batch company logo URLs. */\n  async getImages(\n    tickers: string[],\n    options?: GetImagesOptions,\n  ): Promise<Record<string, StockImage>> {\n    return this.client.get(\"/api/v1/stocks/images\", {\n      tickers: tickers.join(\",\"),\n      ...options,\n    });\n  }\n\n  /** Get company profiles with branding, market cap, sector. */\n  async getDescriptions(\n    tickers: string[],\n    options?: GetDescriptionsOptions,\n  ): Promise<Record<string, StockProfile>> {\n    return this.client.get(\"/api/v1/stocks/descriptions\", {\n      tickers: tickers.join(\",\"),\n      ...options,\n    });\n  }\n\n  /** Get peer/similar stocks. */\n  async getSimilar(ticker: string, options?: GetSimilarOptions): Promise<SimilarStock[]> {\n    return this.client.get(`/api/v1/stocks/${encodeURIComponent(ticker)}/similar`, options);\n  }\n\n  /** Get company profile (CEO, sector, industry, market data). */\n  async getProfile(ticker: string, options?: GetProfileOptions): Promise<StockProfile> {\n    return this.client.get(`/api/v1/stocks/${encodeURIComponent(ticker)}/profile`, options);\n  }\n\n  /** Get related KB entities (people, products, partners). */\n  async getEntities(ticker: string): Promise<StockEntity[]> {\n    return this.client.get(`/api/v1/stocks/${encodeURIComponent(ticker)}/entities`);\n  }\n\n  /** Get AI-generated stock analysis report. Requires PRO tier. */\n  async getAISummary(ticker: string, options?: GetAISummaryOptions): Promise<AISummary> {\n    return this.client.get(`/api/v1/stocks/${encodeURIComponent(ticker)}/ai-summary`, options);\n  }\n\n  /** Get sentiment/mention metrics breakdown by entity. */\n  async getMetricsBreakdown(\n    ticker: string,\n    metricType: string,\n    options?: GetMetricsBreakdownOptions,\n  ): Promise<MetricsBreakdown> {\n    return this.client.get(\n      `/api/v1/stocks/${encodeURIComponent(ticker)}/metrics/${encodeURIComponent(metricType)}/breakdown`,\n      options,\n    );\n  }\n\n  /**\n   * Get historical OHLCV chart data.\n   *\n   * The API returns a bare array of points; this normalizes it to\n   * `{ ticker, timeframe, data }`. `timeframe` echoes the requested value\n   * (defaulting to \"1M\", matching the server default when omitted).\n   */\n  async getChart(ticker: string, options?: GetChartOptions): Promise<ChartData> {\n    const data = await this.client.get<ChartDataPoint[]>(\"/api/v1/stocks/chart\", {\n      ticker,\n      ...options,\n    });\n    return { ticker, timeframe: options?.timeframe ?? \"1M\", data };\n  }\n\n  /** Get current market open/closed/pre-market/after-hours status. */\n  async getMarketStatus(): Promise<MarketStatus> {\n    return this.client.get(\"/api/v1/stocks/market-status\");\n  }\n\n  /** Get financial statement data. */\n  async getFundamentals(ticker: string, options?: GetFundamentalsOptions): Promise<Fundamentals> {\n    return this.client.get(\"/api/v1/stocks/fundamentals\", { ticker, ...options });\n  }\n\n  /** Get available fiscal periods. */\n  async getFundamentalsPeriods(ticker: string): Promise<FundamentalsPeriod[]> {\n    return this.client.get(\"/api/v1/stocks/fundamentals/periods\", { ticker });\n  }\n\n  /** Get most recent fundamentals snapshot. */\n  async getCurrentFundamentals(ticker: string): Promise<Fundamentals> {\n    return this.client.get(\"/api/v1/stocks/fundamentals/current\", { ticker });\n  }\n\n  /** Get historical revenue data. */\n  async getHistoricalRevenue(ticker: string): Promise<unknown> {\n    return this.client.get(\"/api/v1/stocks/fundamentals/historical/revenue\", { ticker });\n  }\n\n  /** Get short interest metrics (FINRA). */\n  async getShortInterest(ticker: string): Promise<ShortInterest> {\n    return this.client.get(\"/api/v1/stocks/short-interest\", { ticker });\n  }\n\n  /** Get float information. */\n  async getFloat(ticker: string): Promise<FloatInfo> {\n    return this.client.get(\"/api/v1/stocks/float\", { ticker });\n  }\n\n  /** Get short volume trading data. */\n  async getShortVolume(ticker: string): Promise<ShortVolume> {\n    return this.client.get(\"/api/v1/stocks/short-volume\", { ticker });\n  }\n\n  /**\n   * Get company-specific KPI time-series for a ticker. Returns curated GAAP and\n   * non-GAAP metrics from earnings filings (e.g. iPhone unit sales, Tesla deliveries,\n   * AWS revenue).\n   *\n   * Free users receive metadata only with an empty `kpis` list; PRO users receive\n   * the full series. Returns 404 for tickers that do not yet have curated coverage.\n   *\n   * Coverage today: near-complete for the S&P 500 plus extended universe\n   * (~500 tickers). Use `listKpiCoverage()` to enumerate.\n   */\n  async getKpis(ticker: string): Promise<PreviewResponse<CompanyKpisData>> {\n    return this.client.get(\n      `/api/v1/stocks/${encodeURIComponent(ticker.toUpperCase())}/kpis`,\n    );\n  }\n\n  /**\n   * List every ticker with curated KPI coverage. Returns `{count, tickers: [...]}`\n   * with lightweight metadata (ticker, companyName, lastUpdated, kpiCount).\n   * Sorted alphabetically by ticker.\n   *\n   * Auth: API key required, but the call does NOT consume your monthly quota\n   * (rate-limit-per-minute still applies).\n   */\n  async listKpiCoverage(): Promise<KpiCoverageResponse> {\n    return this.client.get(\"/api/v1/stocks/with-kpis\");\n  }\n\n  /**\n   * List the KPI metadata tuples available for a ticker — `id, name, category,\n   * chartType` — without paying the cost of the full series payload. Mirrors\n   * the `/api/v1/insights/stock/{ticker}/types` precedent.\n   *\n   * Auth: API key required, no quota cost. 404 if the ticker has no curated KPIs.\n   */\n  async getKpiTypes(ticker: string): Promise<KpiTypeEntry[]> {\n    return this.client.get(\n      `/api/v1/stocks/${encodeURIComponent(ticker.toUpperCase())}/kpis/types`,\n    );\n  }\n}\n","import type { APIClient } from \"../client.js\";\nimport type {\n  TrackerListing,\n  TrackerListResponse,\n  TrackerSnapshot,\n  TrackerSnapshotResponse,\n} from \"../types.js\";\n\n/**\n * Trackers — observational data products published as a standardized\n * `TrackerSnapshot` envelope. Every tracker (institution rankings,\n * hedge-fund reported returns, social trackers, surveillance dashboards)\n * returns the same shape — consumers write one renderer per `viewType` and\n * get every current and future SentiSense tracker for free.\n *\n * @see TrackerSnapshot\n */\nexport class Trackers {\n  constructor(private client: APIClient) {}\n\n  /**\n   * List every publicly-visible tracker — id, display name, category,\n   * one-line description, and the methodology anchor to link out to.\n   */\n  async list(): Promise<TrackerListResponse> {\n    return this.client.get(\"/api/v1/trackers\");\n  }\n\n  /**\n   * Standardized snapshot envelope for one tracker.\n   *\n   * Returns the envelope as-is: `{ isPreview, previewReason, totalCount?, data }`.\n   * When `data.viewType === \"table\"` the rows live at `data.rows[]`; when\n   * `\"choropleth\"` they live at `data.geo[]`; etc. Dispatch on `viewType`\n   * in your renderer.\n   *\n   * @param trackerId — slug from {@link list}, e.g. `\"institution-concentration\"`.\n   * @param params — provider-specific query params (e.g. `{ scope: \"us\" }` for\n   *   geographically-scoped trackers like hantavirus). Unknown keys are ignored.\n   */\n  async get(\n    trackerId: string,\n    params?: Record<string, string | number | boolean>,\n  ): Promise<TrackerSnapshotResponse> {\n    return this.client.get(`/api/v1/trackers/${trackerId}`, params);\n  }\n}\n\n// Re-export for convenience so callers can `import type { TrackerListing }`\n// from the resource module instead of `../types`.\nexport type {\n  TrackerListing,\n  TrackerListResponse,\n  TrackerSnapshot,\n  TrackerSnapshotResponse,\n};\n","export const VERSION = \"0.28.0\";\n","import {\n  APIError,\n  AuthenticationError,\n  NotFoundError,\n  RateLimitError,\n  SentiSenseError,\n} from \"./errors.js\";\nimport { Analyst } from \"./resources/analyst.js\";\nimport { Calendar } from \"./resources/calendar.js\";\nimport { Documents } from \"./resources/documents.js\";\nimport { EntityMetrics } from \"./resources/entityMetrics.js\";\nimport { Etfs } from \"./resources/etfs.js\";\nimport { Insider } from \"./resources/insider.js\";\nimport { Politicians } from \"./resources/politicians.js\";\nimport { Insights } from \"./resources/insights.js\";\nimport { Institutional } from \"./resources/institutional.js\";\nimport { KB } from \"./resources/kb.js\";\nimport { MarketMoodResource } from \"./resources/marketMood.js\";\nimport { MarketSummaryResource } from \"./resources/marketSummary.js\";\nimport { Stocks } from \"./resources/stocks.js\";\nimport { Trackers } from \"./resources/trackers.js\";\nimport type { SentiSenseOptions } from \"./types.js\";\nimport { VERSION } from \"./version.js\";\n\nconst DEFAULT_BASE_URL = \"https://app.sentisense.ai\";\nconst DEFAULT_TIMEOUT = 30_000;\nconst DEFAULT_MAX_RETRIES = 3;\nconst BASE_DELAY_MS = 1_000;\nconst MAX_DELAY_MS = 60_000;\n\nfunction sleep(ms: number): Promise<void> {\n  return new Promise((resolve) => setTimeout(resolve, ms));\n}\n\n/** @internal HTTP interface exposed to resource classes. */\nexport interface APIClient {\n  get<T = unknown>(path: string, params?: object): Promise<T>;\n  post<T = unknown>(path: string, body: unknown): Promise<T>;\n}\n\nexport class SentiSense implements APIClient {\n  private baseUrl: string;\n  private apiKey: string | undefined;\n  private timeout: number;\n  private maxRetries: number;\n\n  readonly stocks: Stocks;\n  readonly documents: Documents;\n  readonly etfs: Etfs;\n  readonly institutional: Institutional;\n  readonly insider: Insider;\n  readonly politicians: Politicians;\n  readonly insights: Insights;\n  readonly analyst: Analyst;\n  readonly entityMetrics: EntityMetrics;\n  readonly marketMood: MarketMoodResource;\n  readonly marketSummary: MarketSummaryResource;\n  readonly kb: KB;\n  readonly trackers: Trackers;\n  readonly calendar: Calendar;\n\n  constructor(options: SentiSenseOptions = {}) {\n    this.apiKey = options.apiKey;\n    this.baseUrl = (options.baseUrl ?? DEFAULT_BASE_URL).replace(/\\/+$/, \"\");\n    this.timeout = options.timeout ?? DEFAULT_TIMEOUT;\n    this.maxRetries = options.maxRetries ?? DEFAULT_MAX_RETRIES;\n\n    this.stocks = new Stocks(this);\n    this.documents = new Documents(this);\n    this.etfs = new Etfs(this);\n    this.institutional = new Institutional(this);\n    this.insider = new Insider(this);\n    this.politicians = new Politicians(this);\n    this.insights = new Insights(this);\n    this.analyst = new Analyst(this);\n    this.entityMetrics = new EntityMetrics(this);\n    this.marketMood = new MarketMoodResource(this);\n    this.marketSummary = new MarketSummaryResource(this);\n    this.kb = new KB(this);\n    this.trackers = new Trackers(this);\n    this.calendar = new Calendar(this);\n  }\n\n  /** @internal */\n  async get<T = unknown>(path: string, params?: object): Promise<T> {\n    const url = this.buildUrl(path, params);\n    const headers: Record<string, string> = {\n      \"Accept\": \"application/json\",\n    };\n\n    if (this.apiKey) {\n      headers[\"X-SentiSense-API-Key\"] = this.apiKey;\n    }\n\n    // User-Agent is only set in Node.js (browsers disallow it)\n    if (typeof process !== \"undefined\" && process.versions?.node) {\n      headers[\"User-Agent\"] = `sentisense-node/${VERSION}`;\n    }\n\n    let delayMs = 0;\n\n    for (let attempt = 0; attempt <= this.maxRetries; attempt++) {\n      if (delayMs > 0) {\n        await sleep(delayMs);\n        delayMs = 0;\n      }\n\n      const controller = new AbortController();\n      const timer = setTimeout(() => controller.abort(), this.timeout);\n\n      try {\n        const response = await fetch(url, {\n          method: \"GET\",\n          headers,\n          signal: controller.signal,\n        });\n\n        if (!response.ok) {\n          const isRetryable = response.status === 429 || response.status >= 500;\n          if (isRetryable && attempt < this.maxRetries) {\n            if (response.status === 429) {\n              const ra = response.headers.get(\"Retry-After\");\n              delayMs = (ra ? parseInt(ra, 10) : 60) * 1000;\n            } else {\n              delayMs = Math.min(BASE_DELAY_MS * Math.pow(2, attempt), MAX_DELAY_MS) + Math.random() * 1000;\n            }\n            try { await response.body?.cancel(); } catch { /* ignore */ }\n            continue;\n          }\n          await this.handleErrorResponse(response);\n        }\n\n        return (await response.json()) as T;\n      } catch (error) {\n        if (error instanceof SentiSenseError) throw error;\n        if (error instanceof Error && error.name === \"AbortError\") {\n          throw new SentiSenseError(`Request timed out after ${this.timeout}ms`);\n        }\n        throw new SentiSenseError(\n          error instanceof Error ? error.message : \"Unknown error\",\n        );\n      } finally {\n        clearTimeout(timer);\n      }\n    }\n\n    throw new SentiSenseError(\"All retries exhausted\");\n  }\n\n  /** @internal */\n  async post<T = unknown>(path: string, body: unknown): Promise<T> {\n    const url = this.buildUrl(path);\n    const headers: Record<string, string> = {\n      \"Accept\": \"application/json\",\n      \"Content-Type\": \"application/json\",\n    };\n\n    if (this.apiKey) {\n      headers[\"X-SentiSense-API-Key\"] = this.apiKey;\n    }\n\n    if (typeof process !== \"undefined\" && process.versions?.node) {\n      headers[\"User-Agent\"] = `sentisense-node/${VERSION}`;\n    }\n\n    const controller = new AbortController();\n    const timer = setTimeout(() => controller.abort(), this.timeout);\n\n    try {\n      const response = await fetch(url, {\n        method: \"POST\",\n        headers,\n        body: JSON.stringify(body),\n        signal: controller.signal,\n      });\n\n      if (!response.ok) {\n        await this.handleErrorResponse(response);\n      }\n\n      return (await response.json()) as T;\n    } catch (error) {\n      if (error instanceof SentiSenseError) throw error;\n      if (error instanceof Error && error.name === \"AbortError\") {\n        throw new SentiSenseError(`Request timed out after ${this.timeout}ms`);\n      }\n      throw new SentiSenseError(\n        error instanceof Error ? error.message : \"Unknown error\",\n      );\n    } finally {\n      clearTimeout(timer);\n    }\n  }\n\n  private buildUrl(path: string, params?: object): string {\n    const url = new URL(path, this.baseUrl);\n    if (params) {\n      for (const [key, value] of Object.entries(params as Record<string, unknown>)) {\n        if (value !== undefined && value !== null) {\n          url.searchParams.set(key, String(value));\n        }\n      }\n    }\n    return url.toString();\n  }\n\n  private async handleErrorResponse(response: Response): Promise<never> {\n    let body: { error?: string; message?: string } = {};\n    try {\n      body = await response.json();\n    } catch {\n      // Response may not be JSON\n    }\n\n    const message = body.message ?? response.statusText ?? \"API request failed\";\n    const code = body.error;\n\n    switch (response.status) {\n      case 401:\n      case 403:\n        throw new AuthenticationError(message, response.status, code);\n      case 404:\n        throw new NotFoundError(message, code);\n      case 429: {\n        const ra = response.headers.get(\"Retry-After\");\n        throw new RateLimitError(message, code, ra ? parseInt(ra, 10) : undefined);\n      }\n      default:\n        throw new APIError(message, response.status, code);\n    }\n  }\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sentisense",
-  "version": "0.27.0",
+  "version": "0.28.0",
   "description": "Official JavaScript/TypeScript SDK for the SentiSense market intelligence API",
   "author": "SentiSense <support@sentisense.ai>",
   "license": "MIT",