sentisense 0.6.0 → 0.7.1

package/dist/index.cjs

@@ -53,9 +53,10 @@ var NotFoundError = class extends SentiSenseError {
   }
 };
 var RateLimitError = class extends SentiSenseError {
-  constructor(message, code) {
+  constructor(message, code, retryAfter) {
     super(message, 429, code);
     this.name = "RateLimitError";
+    this.retryAfter = retryAfter;
   }
 };
 var APIError = class extends SentiSenseError {
@@ -245,6 +246,93 @@ var Insider = class {
   }
 };
 
+// src/resources/politicians.ts
+var Politicians = class {
+  constructor(client) {
+    this.client = client;
+  }
+  /**
+   * Get recent congressional STOCK Act trading activity across all politicians.
+   *
+   * PRO-gated. Free/unauthenticated users receive a preview (top 5 trades)
+   * with `isPreview: true` in the response.
+   */
+  async getActivity(options) {
+    return this.client.get("/api/v1/politicians/activity", options);
+  }
+  /**
+   * Get congressional trades for a specific stock.
+   *
+   * PRO-gated. Free users receive a preview of the top 3 trades.
+   */
+  async getFilings(ticker, options) {
+    return this.client.get(
+      `/api/v1/politicians/filings/${encodeURIComponent(ticker.toUpperCase())}`,
+      options
+    );
+  }
+  /**
+   * Get all tracked politicians with trading summary statistics.
+   *
+   * PRO-gated. Free users receive a preview of the top 5 members.
+   */
+  async getMembers() {
+    return this.client.get("/api/v1/politicians/members");
+  }
+  /**
+   * Get detailed profile for a single politician: summary, recent trades, top tickers.
+   *
+   * PRO-gated. Free users receive a preview-wrapped response.
+   */
+  async getMember(slug) {
+    return this.client.get(
+      `/api/v1/politicians/member/${encodeURIComponent(slug)}`
+    );
+  }
+};
+
+// src/resources/insights.ts
+var Insights = class {
+  constructor(client) {
+    this.client = client;
+  }
+  /**
+   * Get AI-generated insights for a specific stock, sorted by urgency then confidence.
+   *
+   * PRO users receive a flat array of Insight objects.
+   * Free/unauthenticated users receive a preview with `isPreview: true`,
+   * the top 3 insights in full, and a `locked` array with metadata-only entries
+   * (type, urgency, timestamp) showing what additional signals exist.
+   */
+  async stock(ticker, options) {
+    return this.client.get(
+      `/api/v1/insights/stock/${encodeURIComponent(ticker.toUpperCase())}`,
+      options
+    );
+  }
+  /**
+   * Get AI-generated market-level insights, sorted by urgency then confidence.
+   *
+   * PRO users receive a flat array of Insight objects.
+   * Free/unauthenticated users receive a preview with `isPreview: true`,
+   * the top 5 insights in full, and a `locked` array with metadata-only entries.
+   */
+  async market() {
+    return this.client.get("/api/v1/insights/market");
+  }
+  /**
+   * Get available insight types for a specific stock.
+   * No authentication required.
+   *
+   * Returns an array of insight type strings (e.g., `["sentiment_shift", "options_activity"]`).
+   */
+  async types(ticker) {
+    return this.client.get(
+      `/api/v1/insights/stock/${encodeURIComponent(ticker.toUpperCase())}/types`
+    );
+  }
+};
+
 // src/resources/institutional.ts
 var Institutional = class {
   constructor(client) {
@@ -426,20 +514,29 @@ var Stocks = class {
 };
 
 // src/version.ts
-var VERSION = "0.5.0";
+var VERSION = "0.7.1";
 
 // src/client.ts
 var DEFAULT_BASE_URL = "https://app.sentisense.ai";
 var DEFAULT_TIMEOUT = 3e4;
+var DEFAULT_MAX_RETRIES = 3;
+var BASE_DELAY_MS = 1e3;
+var MAX_DELAY_MS = 6e4;
+function sleep(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
 var SentiSense = class {
   constructor(options = {}) {
     this.apiKey = options.apiKey;
     this.baseUrl = (options.baseUrl ?? DEFAULT_BASE_URL).replace(/\/+$/, "");
     this.timeout = options.timeout ?? DEFAULT_TIMEOUT;
+    this.maxRetries = options.maxRetries ?? DEFAULT_MAX_RETRIES;
     this.stocks = new Stocks(this);
     this.documents = new Documents(this);
     this.institutional = new Institutional(this);
     this.insider = new Insider(this);
+    this.politicians = new Politicians(this);
+    this.insights = new Insights(this);
     this.entityMetrics = new EntityMetrics(this);
     this.marketMood = new MarketMoodResource(this);
     this.marketSummary = new MarketSummaryResource(this);
@@ -457,29 +554,51 @@ var SentiSense = class {
     if (typeof process !== "undefined" && process.versions?.node) {
       headers["User-Agent"] = `sentisense-node/${VERSION}`;
     }
-    const controller = new AbortController();
-    const timer = setTimeout(() => controller.abort(), this.timeout);
-    try {
-      const response = await fetch(url, {
-        method: "GET",
-        headers,
-        signal: controller.signal
-      });
-      if (!response.ok) {
-        await this.handleErrorResponse(response);
+    let delayMs = 0;
+    for (let attempt = 0; attempt <= this.maxRetries; attempt++) {
+      if (delayMs > 0) {
+        await sleep(delayMs);
+        delayMs = 0;
       }
-      return await response.json();
-    } catch (error) {
-      if (error instanceof SentiSenseError) throw error;
-      if (error instanceof Error && error.name === "AbortError") {
-        throw new SentiSenseError(`Request timed out after ${this.timeout}ms`);
+      const controller = new AbortController();
+      const timer = setTimeout(() => controller.abort(), this.timeout);
+      try {
+        const response = await fetch(url, {
+          method: "GET",
+          headers,
+          signal: controller.signal
+        });
+        if (!response.ok) {
+          const isRetryable = response.status === 429 || response.status >= 500;
+          if (isRetryable && attempt < this.maxRetries) {
+            if (response.status === 429) {
+              const ra = response.headers.get("Retry-After");
+              delayMs = (ra ? parseInt(ra, 10) : 60) * 1e3;
+            } else {
+              delayMs = Math.min(BASE_DELAY_MS * Math.pow(2, attempt), MAX_DELAY_MS) + Math.random() * 1e3;
+            }
+            try {
+              await response.body?.cancel();
+            } catch {
+            }
+            continue;
+          }
+          await this.handleErrorResponse(response);
+        }
+        return await response.json();
+      } catch (error) {
+        if (error instanceof SentiSenseError) throw error;
+        if (error instanceof Error && error.name === "AbortError") {
+          throw new SentiSenseError(`Request timed out after ${this.timeout}ms`);
+        }
+        throw new SentiSenseError(
+          error instanceof Error ? error.message : "Unknown error"
+        );
+      } finally {
+        clearTimeout(timer);
       }
-      throw new SentiSenseError(
-        error instanceof Error ? error.message : "Unknown error"
-      );
-    } finally {
-      clearTimeout(timer);
     }
+    throw new SentiSenseError("All retries exhausted");
   }
   buildUrl(path, params) {
     const url = new URL(path, this.baseUrl);
@@ -506,8 +625,10 @@ var SentiSense = class {
         throw new AuthenticationError(message, response.status, code);
       case 404:
         throw new NotFoundError(message, code);
-      case 429:
-        throw new RateLimitError(message, code);
+      case 429: {
+        const ra = response.headers.get("Retry-After");
+        throw new RateLimitError(message, code, ra ? parseInt(ra, 10) : void 0);
+      }
       default:
         throw new APIError(message, response.status, code);
     }

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/errors.ts","../src/resources/documents.ts","../src/resources/entityMetrics.ts","../src/resources/insider.ts","../src/resources/institutional.ts","../src/resources/kb.ts","../src/resources/marketMood.ts","../src/resources/marketSummary.ts","../src/resources/stocks.ts","../src/version.ts","../src/client.ts"],"sourcesContent":["export { SentiSense } from \"./client.js\";\nexport { SentiSense as default } from \"./client.js\";\n\nexport {\n  SentiSenseError,\n  AuthenticationError,\n  NotFoundError,\n  RateLimitError,\n  APIError,\n} from \"./errors.js\";\n\nexport type {\n  SentiSenseOptions,\n  InsiderActivitySummary,\n  InsiderActivityResponse,\n  InsiderTrade,\n  ClusterBuy,\n  GetInsiderOptions,\n  StockPrice,\n  StockDetail,\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  MetricType,\n  MetricsOptions,\n  MetricDistributionOptions,\n  ServingMetric,\n  MetricDistribution,\n  MentionData,\n  MentionCount,\n  SentimentData,\n  MarketMood,\n  MarketSummary,\n  KBEntity,\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  constructor(message: string, code?: string) {\n    super(message, 429, code);\n    this.name = \"RateLimitError\";\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 {\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 {\n  InsiderActivityResponse,\n  InsiderTrade,\n  ClusterBuy,\n  GetInsiderOptions,\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<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<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<ClusterBuy[]> {\n    return this.client.get(\"/api/v1/insider/cluster-buys\", options);\n  }\n}\n","import type { APIClient } from \"../client.js\";\nimport type {\n  GetFlowsOptions,\n  Holder,\n  InstitutionalFlowsResponse,\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","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","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  FloatInfo,\n  Fundamentals,\n  FundamentalsPeriod,\n  GetAISummaryOptions,\n  GetChartOptions,\n  GetDescriptionsOptions,\n  GetFundamentalsOptions,\n  GetImagesOptions,\n  GetMetricsBreakdownOptions,\n  GetProfileOptions,\n  GetSimilarOptions,\n  MarketStatus,\n  MetricsBreakdown,\n  ShortInterest,\n  ShortVolume,\n  StockDetail,\n  StockEntity,\n  StockImage,\n  StockPrice,\n  StockProfile,\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  /** Get real-time prices for multiple tickers. */\n  async getPrices(tickers: string[]): Promise<Record<string, 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<StockDetail[]> {\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  /** Get historical OHLCV chart data. */\n  async getChart(ticker: string, options?: GetChartOptions): Promise<ChartData> {\n    return this.client.get(\"/api/v1/stocks/chart\", { ticker, ...options });\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 P/E, P/B, P/S ratios. */\n  async getHistoricalRatios(ticker: string): Promise<unknown> {\n    return this.client.get(\"/api/v1/stocks/fundamentals/historical/ratios\", { 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","export const VERSION = \"0.5.0\";\n","import {\n  APIError,\n  AuthenticationError,\n  NotFoundError,\n  RateLimitError,\n  SentiSenseError,\n} from \"./errors.js\";\nimport { Documents } from \"./resources/documents.js\";\nimport { EntityMetrics } from \"./resources/entityMetrics.js\";\nimport { Insider } from \"./resources/insider.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 type { SentiSenseOptions } from \"./types.js\";\nimport { VERSION } from \"./version.js\";\n\nconst DEFAULT_BASE_URL = \"https://app.sentisense.ai\";\nconst DEFAULT_TIMEOUT = 30_000;\n\n/** @internal HTTP interface exposed to resource classes. */\nexport interface APIClient {\n  get<T = unknown>(path: string, params?: object): Promise<T>;\n}\n\nexport class SentiSense implements APIClient {\n  private baseUrl: string;\n  private apiKey: string | undefined;\n  private timeout: number;\n\n  readonly stocks: Stocks;\n  readonly documents: Documents;\n  readonly institutional: Institutional;\n  readonly insider: Insider;\n  readonly entityMetrics: EntityMetrics;\n  readonly marketMood: MarketMoodResource;\n  readonly marketSummary: MarketSummaryResource;\n  readonly kb: KB;\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\n    this.stocks = new Stocks(this);\n    this.documents = new Documents(this);\n    this.institutional = new Institutional(this);\n    this.insider = new Insider(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  }\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    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        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        throw new RateLimitError(message, code);\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/documents.ts","../src/resources/entityMetrics.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/version.ts","../src/client.ts"],"sourcesContent":["export { SentiSense } from \"./client.js\";\nexport { SentiSense as default } from \"./client.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  CongressTrade,\n  PoliticianSummary,\n  PoliticianDetail,\n  GetPoliticiansOptions,\n  PreviewResponse,\n  StockPrice,\n  StockDetail,\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  MetricType,\n  MetricsOptions,\n  MetricDistributionOptions,\n  ServingMetric,\n  MetricDistribution,\n  MentionData,\n  MentionCount,\n  SentimentData,\n  MarketMood,\n  MarketSummary,\n  KBEntity,\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 {\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 {\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 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-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 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  InstitutionalFlowsResponse,\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","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","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  FloatInfo,\n  Fundamentals,\n  FundamentalsPeriod,\n  GetAISummaryOptions,\n  GetChartOptions,\n  GetDescriptionsOptions,\n  GetFundamentalsOptions,\n  GetImagesOptions,\n  GetMetricsBreakdownOptions,\n  GetProfileOptions,\n  GetSimilarOptions,\n  MarketStatus,\n  MetricsBreakdown,\n  ShortInterest,\n  ShortVolume,\n  StockDetail,\n  StockEntity,\n  StockImage,\n  StockPrice,\n  StockProfile,\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  /** 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<StockDetail[]> {\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  /** Get historical OHLCV chart data. */\n  async getChart(ticker: string, options?: GetChartOptions): Promise<ChartData> {\n    return this.client.get(\"/api/v1/stocks/chart\", { ticker, ...options });\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 P/E, P/B, P/S ratios. */\n  async getHistoricalRatios(ticker: string): Promise<unknown> {\n    return this.client.get(\"/api/v1/stocks/fundamentals/historical/ratios\", { 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","export const VERSION = \"0.7.1\";\n","import {\n  APIError,\n  AuthenticationError,\n  NotFoundError,\n  RateLimitError,\n  SentiSenseError,\n} from \"./errors.js\";\nimport { Documents } from \"./resources/documents.js\";\nimport { EntityMetrics } from \"./resources/entityMetrics.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 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}\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 institutional: Institutional;\n  readonly insider: Insider;\n  readonly politicians: Politicians;\n  readonly insights: Insights;\n  readonly entityMetrics: EntityMetrics;\n  readonly marketMood: MarketMoodResource;\n  readonly marketSummary: MarketSummaryResource;\n  readonly kb: KB;\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.institutional = new Institutional(this);\n    this.insider = new Insider(this);\n    this.politicians = new Politicians(this);\n    this.insights = new Insights(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  }\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  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

@@ -2,6 +2,7 @@ interface SentiSenseOptions {
     apiKey?: string;
     baseUrl?: string;
     timeout?: number;
+    maxRetries?: number;
 }
 interface StockPrice {
     ticker: string;
@@ -270,6 +271,65 @@ interface GetInsiderOptions {
     /** Number of days to look back (1–365). Defaults to 90. */
     lookbackDays?: number;
 }
+/** A congressional STOCK Act trade disclosure. */
+interface CongressTrade {
+    politicianName: string;
+    firstName: string;
+    lastName: string;
+    chamber: "SENATE" | "HOUSE";
+    party: string;
+    state: string;
+    bioguideId: string;
+    imageUrl: string | null;
+    ticker: string;
+    assetDescription: string;
+    assetType: "Stock" | "ETF";
+    transactionType: "PURCHASE" | "SALE" | "EXCHANGE" | "OTHER";
+    transactionDate: string;
+    disclosureDate: string;
+    disclosureDelayDays: number;
+    /** Raw STOCK Act range (e.g., "$1,001 - $15,000"). */
+    amountRange: string;
+    amountMin: number;
+    amountMax: number;
+    owner: "Self" | "Spouse" | "Child" | "Joint";
+    urlSlug: string;
+    sentimentScore: number | null;
+}
+/** Summary statistics for a tracked politician. */
+interface PoliticianSummary {
+    urlSlug: string;
+    displayName: string;
+    firstName: string;
+    lastName: string;
+    chamber: "SENATE" | "HOUSE";
+    party: string;
+    state: string;
+    bioguideId: string;
+    imageUrl: string | null;
+    kbEntityId: string | null;
+    totalTrades: number;
+    purchaseCount: number;
+    saleCount: number;
+    latestTradeDate: string | null;
+    sentimentScore: number | null;
+}
+/** Detailed politician profile with recent trades and top tickers. */
+interface PoliticianDetail {
+    profile: PoliticianSummary;
+    recentTrades: CongressTrade[];
+    topTickers: string[];
+}
+interface GetPoliticiansOptions {
+    /** Number of days to look back (1-365). Defaults to 90. */
+    lookbackDays?: number;
+}
+/** Generic preview wrapper used by PRO-gated endpoints. */
+interface PreviewResponse<T> {
+    isPreview: boolean;
+    previewReason: "LOGIN_REQUIRED" | "PRO_REQUIRED" | null;
+    data: T;
+}
 /** Supported metric types for the v2 Serving Metrics API. */
 type MetricType = "mentions" | "sentiment" | "sentisense_score" | "social_dominance" | "creators";
 /** Options for `EntityMetrics.getMetrics()`. */
@@ -345,6 +405,45 @@ interface MarketSummary {
     /** Timestamp when the AI summary was generated (epoch seconds, may be null). */
     generatedAt: number | null;
 }
+/** A single AI-generated trading insight. */
+interface Insight {
+    /** Category of the signal (e.g., `"insider_buy_signal"`, `"institutional_position_change"`, `"volume_anomaly_high"`). */
+    insightType: string;
+    /** Full AI-generated description of the signal. */
+    insightText: string;
+    /** Model confidence score (0.0–1.0). */
+    confidence: number;
+    /** Signal priority: `"low"`, `"medium"`, or `"high"`. */
+    urgency: "low" | "medium" | "high";
+    /** When this insight was generated (epoch seconds). */
+    generatedAt: number;
+    /** Source document references (may be null). */
+    docRefs?: Record<string, unknown>[] | null;
+    /** JSON string with additional signal metadata (may be null). */
+    metadata?: string | null;
+}
+/** A locked insight entry shown to free users: metadata only, no insight text. */
+interface LockedInsight {
+    insightType: string;
+    urgency: string;
+    generatedAt: number;
+}
+/** Preview response returned to free/unauthenticated users on insights endpoints. */
+interface InsightPreviewResponse {
+    isPreview: true;
+    previewReason: "LOGIN_REQUIRED" | "PRO_REQUIRED";
+    /** Full insight objects for the top N results. */
+    insights: Insight[];
+    /** Metadata-only entries for the remaining signals. */
+    locked: LockedInsight[];
+}
+/** Options for `Insights.stock()`. */
+interface GetInsightsOptions {
+    /** Filter by urgency level: `"low"`, `"medium"`, or `"high"`. */
+    urgency?: string;
+    /** Filter by insight type (e.g., `"insider_buy_signal"`). */
+    insightType?: string;
+}
 interface KBEntity {
     entityId: string;
     name: string;
@@ -425,19 +524,78 @@ declare class Insider {
      * PRO-gated. Free/unauthenticated users receive a preview (top 5 per direction)
      * with `isPreview: true` in the response.
      */
-    getActivity(options?: GetInsiderOptions): Promise<InsiderActivityResponse>;
+    getActivity(options?: GetInsiderOptions): Promise<PreviewResponse<InsiderActivityResponse>>;
     /**
      * Get individual insider transactions for a specific stock.
      *
      * PRO-gated. Free users receive a preview of the top 5 transactions.
      */
-    getTrades(ticker: string, options?: GetInsiderOptions): Promise<InsiderTrade[]>;
+    getTrades(ticker: string, options?: GetInsiderOptions): Promise<PreviewResponse<InsiderTrade[]>>;
     /**
      * Get cluster buy signals: stocks where 3+ distinct insiders bought recently.
      *
      * PRO-gated. Free users receive a preview of the top 3 signals.
      */
-    getClusterBuys(options?: GetInsiderOptions): Promise<ClusterBuy[]>;
+    getClusterBuys(options?: GetInsiderOptions): Promise<PreviewResponse<ClusterBuy[]>>;
+}
+
+declare class Politicians {
+    private client;
+    constructor(client: APIClient);
+    /**
+     * Get recent congressional STOCK Act trading activity across all politicians.
+     *
+     * PRO-gated. Free/unauthenticated users receive a preview (top 5 trades)
+     * with `isPreview: true` in the response.
+     */
+    getActivity(options?: GetPoliticiansOptions): Promise<PreviewResponse<CongressTrade[]>>;
+    /**
+     * Get congressional trades for a specific stock.
+     *
+     * PRO-gated. Free users receive a preview of the top 3 trades.
+     */
+    getFilings(ticker: string, options?: GetPoliticiansOptions): Promise<PreviewResponse<CongressTrade[]>>;
+    /**
+     * Get all tracked politicians with trading summary statistics.
+     *
+     * PRO-gated. Free users receive a preview of the top 5 members.
+     */
+    getMembers(): Promise<PreviewResponse<PoliticianSummary[]>>;
+    /**
+     * Get detailed profile for a single politician: summary, recent trades, top tickers.
+     *
+     * PRO-gated. Free users receive a preview-wrapped response.
+     */
+    getMember(slug: string): Promise<PreviewResponse<PoliticianDetail>>;
+}
+
+declare class Insights {
+    private client;
+    constructor(client: APIClient);
+    /**
+     * Get AI-generated insights for a specific stock, sorted by urgency then confidence.
+     *
+     * PRO users receive a flat array of Insight objects.
+     * Free/unauthenticated users receive a preview with `isPreview: true`,
+     * the top 3 insights in full, and a `locked` array with metadata-only entries
+     * (type, urgency, timestamp) showing what additional signals exist.
+     */
+    stock(ticker: string, options?: GetInsightsOptions): Promise<Insight[] | InsightPreviewResponse>;
+    /**
+     * Get AI-generated market-level insights, sorted by urgency then confidence.
+     *
+     * PRO users receive a flat array of Insight objects.
+     * Free/unauthenticated users receive a preview with `isPreview: true`,
+     * the top 5 insights in full, and a `locked` array with metadata-only entries.
+     */
+    market(): Promise<Insight[] | InsightPreviewResponse>;
+    /**
+     * Get available insight types for a specific stock.
+     * No authentication required.
+     *
+     * Returns an array of insight type strings (e.g., `["sentiment_shift", "options_activity"]`).
+     */
+    types(ticker: string): Promise<string[]>;
 }
 
 declare class Institutional {
@@ -492,7 +650,7 @@ declare class Stocks {
     /** Get real-time price for a single ticker. */
     getPrice(ticker: string): Promise<StockPrice>;
     /** Get real-time prices for multiple tickers. */
-    getPrices(tickers: string[]): Promise<Record<string, StockPrice>>;
+    getPrices(tickers: string[]): Promise<StockPrice[]>;
     /** Get batch company logo URLs. */
     getImages(tickers: string[], options?: GetImagesOptions): Promise<Record<string, StockImage>>;
     /** Get company profiles with branding, market cap, sector. */
@@ -537,10 +695,13 @@ declare class SentiSense implements APIClient {
     private baseUrl;
     private apiKey;
     private timeout;
+    private maxRetries;
     readonly stocks: Stocks;
     readonly documents: Documents;
     readonly institutional: Institutional;
     readonly insider: Insider;
+    readonly politicians: Politicians;
+    readonly insights: Insights;
     readonly entityMetrics: EntityMetrics;
     readonly marketMood: MarketMoodResource;
     readonly marketSummary: MarketSummaryResource;
@@ -564,12 +725,13 @@ declare class NotFoundError extends SentiSenseError {
     constructor(message: string, code?: string);
 }
 declare class RateLimitError extends SentiSenseError {
-    constructor(message: string, code?: string);
+    retryAfter?: number;
+    constructor(message: string, code?: string, retryAfter?: number);
 }
 declare class APIError extends SentiSenseError {
     constructor(message: string, status: number, code?: string);
 }
 
-declare const VERSION = "0.5.0";
+declare const VERSION = "0.7.1";
 
-export { type AISummary, APIError, AuthenticationError, type ChartData, type ChartDataPoint, type ClusterBuy, type Document, type DocumentSource, type FloatInfo, type Fundamentals, type FundamentalsPeriod, type GetInsiderOptions, type Holder, type InsiderActivityResponse, type InsiderActivitySummary, type InsiderTrade, type InstitutionalFlow, type InstitutionalFlowsResponse, type KBEntity, type MarketMood, type MarketStatus, type MarketSummary, type MentionCount, type MentionData, type MetricDistribution, type MetricDistributionOptions, type MetricType, type MetricsBreakdown, type MetricsOptions, NotFoundError, type Quarter, RateLimitError, SentiSense, SentiSenseError, type SentiSenseOptions, type SentimentData, type SentimentEntry, type ServingMetric, type ShortInterest, type ShortVolume, type StockDetail, type StockEntity, type StockImage, type StockPrice, type StockProfile, type Story, type StoryCluster, VERSION, SentiSense as default };
+export { type AISummary, APIError, AuthenticationError, type ChartData, type ChartDataPoint, type ClusterBuy, type CongressTrade, type Document, type DocumentSource, type FloatInfo, type Fundamentals, type FundamentalsPeriod, type GetInsiderOptions, type GetInsightsOptions, type GetPoliticiansOptions, type Holder, type InsiderActivityResponse, type InsiderActivitySummary, type InsiderTrade, type Insight, type InsightPreviewResponse, type InstitutionalFlow, type InstitutionalFlowsResponse, type KBEntity, 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 StockDetail, type StockEntity, type StockImage, type StockPrice, type StockProfile, type Story, type StoryCluster, VERSION, SentiSense as default };

package/dist/index.d.ts

@@ -2,6 +2,7 @@ interface SentiSenseOptions {
     apiKey?: string;
     baseUrl?: string;
     timeout?: number;
+    maxRetries?: number;
 }
 interface StockPrice {
     ticker: string;
@@ -270,6 +271,65 @@ interface GetInsiderOptions {
     /** Number of days to look back (1–365). Defaults to 90. */
     lookbackDays?: number;
 }
+/** A congressional STOCK Act trade disclosure. */
+interface CongressTrade {
+    politicianName: string;
+    firstName: string;
+    lastName: string;
+    chamber: "SENATE" | "HOUSE";
+    party: string;
+    state: string;
+    bioguideId: string;
+    imageUrl: string | null;
+    ticker: string;
+    assetDescription: string;
+    assetType: "Stock" | "ETF";
+    transactionType: "PURCHASE" | "SALE" | "EXCHANGE" | "OTHER";
+    transactionDate: string;
+    disclosureDate: string;
+    disclosureDelayDays: number;
+    /** Raw STOCK Act range (e.g., "$1,001 - $15,000"). */
+    amountRange: string;
+    amountMin: number;
+    amountMax: number;
+    owner: "Self" | "Spouse" | "Child" | "Joint";
+    urlSlug: string;
+    sentimentScore: number | null;
+}
+/** Summary statistics for a tracked politician. */
+interface PoliticianSummary {
+    urlSlug: string;
+    displayName: string;
+    firstName: string;
+    lastName: string;
+    chamber: "SENATE" | "HOUSE";
+    party: string;
+    state: string;
+    bioguideId: string;
+    imageUrl: string | null;
+    kbEntityId: string | null;
+    totalTrades: number;
+    purchaseCount: number;
+    saleCount: number;
+    latestTradeDate: string | null;
+    sentimentScore: number | null;
+}
+/** Detailed politician profile with recent trades and top tickers. */
+interface PoliticianDetail {
+    profile: PoliticianSummary;
+    recentTrades: CongressTrade[];
+    topTickers: string[];
+}
+interface GetPoliticiansOptions {
+    /** Number of days to look back (1-365). Defaults to 90. */
+    lookbackDays?: number;
+}
+/** Generic preview wrapper used by PRO-gated endpoints. */
+interface PreviewResponse<T> {
+    isPreview: boolean;
+    previewReason: "LOGIN_REQUIRED" | "PRO_REQUIRED" | null;
+    data: T;
+}
 /** Supported metric types for the v2 Serving Metrics API. */
 type MetricType = "mentions" | "sentiment" | "sentisense_score" | "social_dominance" | "creators";
 /** Options for `EntityMetrics.getMetrics()`. */
@@ -345,6 +405,45 @@ interface MarketSummary {
     /** Timestamp when the AI summary was generated (epoch seconds, may be null). */
     generatedAt: number | null;
 }
+/** A single AI-generated trading insight. */
+interface Insight {
+    /** Category of the signal (e.g., `"insider_buy_signal"`, `"institutional_position_change"`, `"volume_anomaly_high"`). */
+    insightType: string;
+    /** Full AI-generated description of the signal. */
+    insightText: string;
+    /** Model confidence score (0.0–1.0). */
+    confidence: number;
+    /** Signal priority: `"low"`, `"medium"`, or `"high"`. */
+    urgency: "low" | "medium" | "high";
+    /** When this insight was generated (epoch seconds). */
+    generatedAt: number;
+    /** Source document references (may be null). */
+    docRefs?: Record<string, unknown>[] | null;
+    /** JSON string with additional signal metadata (may be null). */
+    metadata?: string | null;
+}
+/** A locked insight entry shown to free users: metadata only, no insight text. */
+interface LockedInsight {
+    insightType: string;
+    urgency: string;
+    generatedAt: number;
+}
+/** Preview response returned to free/unauthenticated users on insights endpoints. */
+interface InsightPreviewResponse {
+    isPreview: true;
+    previewReason: "LOGIN_REQUIRED" | "PRO_REQUIRED";
+    /** Full insight objects for the top N results. */
+    insights: Insight[];
+    /** Metadata-only entries for the remaining signals. */
+    locked: LockedInsight[];
+}
+/** Options for `Insights.stock()`. */
+interface GetInsightsOptions {
+    /** Filter by urgency level: `"low"`, `"medium"`, or `"high"`. */
+    urgency?: string;
+    /** Filter by insight type (e.g., `"insider_buy_signal"`). */
+    insightType?: string;
+}
 interface KBEntity {
     entityId: string;
     name: string;
@@ -425,19 +524,78 @@ declare class Insider {
      * PRO-gated. Free/unauthenticated users receive a preview (top 5 per direction)
      * with `isPreview: true` in the response.
      */
-    getActivity(options?: GetInsiderOptions): Promise<InsiderActivityResponse>;
+    getActivity(options?: GetInsiderOptions): Promise<PreviewResponse<InsiderActivityResponse>>;
     /**
      * Get individual insider transactions for a specific stock.
      *
      * PRO-gated. Free users receive a preview of the top 5 transactions.
      */
-    getTrades(ticker: string, options?: GetInsiderOptions): Promise<InsiderTrade[]>;
+    getTrades(ticker: string, options?: GetInsiderOptions): Promise<PreviewResponse<InsiderTrade[]>>;
     /**
      * Get cluster buy signals: stocks where 3+ distinct insiders bought recently.
      *
      * PRO-gated. Free users receive a preview of the top 3 signals.
      */
-    getClusterBuys(options?: GetInsiderOptions): Promise<ClusterBuy[]>;
+    getClusterBuys(options?: GetInsiderOptions): Promise<PreviewResponse<ClusterBuy[]>>;
+}
+
+declare class Politicians {
+    private client;
+    constructor(client: APIClient);
+    /**
+     * Get recent congressional STOCK Act trading activity across all politicians.
+     *
+     * PRO-gated. Free/unauthenticated users receive a preview (top 5 trades)
+     * with `isPreview: true` in the response.
+     */
+    getActivity(options?: GetPoliticiansOptions): Promise<PreviewResponse<CongressTrade[]>>;
+    /**
+     * Get congressional trades for a specific stock.
+     *
+     * PRO-gated. Free users receive a preview of the top 3 trades.
+     */
+    getFilings(ticker: string, options?: GetPoliticiansOptions): Promise<PreviewResponse<CongressTrade[]>>;
+    /**
+     * Get all tracked politicians with trading summary statistics.
+     *
+     * PRO-gated. Free users receive a preview of the top 5 members.
+     */
+    getMembers(): Promise<PreviewResponse<PoliticianSummary[]>>;
+    /**
+     * Get detailed profile for a single politician: summary, recent trades, top tickers.
+     *
+     * PRO-gated. Free users receive a preview-wrapped response.
+     */
+    getMember(slug: string): Promise<PreviewResponse<PoliticianDetail>>;
+}
+
+declare class Insights {
+    private client;
+    constructor(client: APIClient);
+    /**
+     * Get AI-generated insights for a specific stock, sorted by urgency then confidence.
+     *
+     * PRO users receive a flat array of Insight objects.
+     * Free/unauthenticated users receive a preview with `isPreview: true`,
+     * the top 3 insights in full, and a `locked` array with metadata-only entries
+     * (type, urgency, timestamp) showing what additional signals exist.
+     */
+    stock(ticker: string, options?: GetInsightsOptions): Promise<Insight[] | InsightPreviewResponse>;
+    /**
+     * Get AI-generated market-level insights, sorted by urgency then confidence.
+     *
+     * PRO users receive a flat array of Insight objects.
+     * Free/unauthenticated users receive a preview with `isPreview: true`,
+     * the top 5 insights in full, and a `locked` array with metadata-only entries.
+     */
+    market(): Promise<Insight[] | InsightPreviewResponse>;
+    /**
+     * Get available insight types for a specific stock.
+     * No authentication required.
+     *
+     * Returns an array of insight type strings (e.g., `["sentiment_shift", "options_activity"]`).
+     */
+    types(ticker: string): Promise<string[]>;
 }
 
 declare class Institutional {
@@ -492,7 +650,7 @@ declare class Stocks {
     /** Get real-time price for a single ticker. */
     getPrice(ticker: string): Promise<StockPrice>;
     /** Get real-time prices for multiple tickers. */
-    getPrices(tickers: string[]): Promise<Record<string, StockPrice>>;
+    getPrices(tickers: string[]): Promise<StockPrice[]>;
     /** Get batch company logo URLs. */
     getImages(tickers: string[], options?: GetImagesOptions): Promise<Record<string, StockImage>>;
     /** Get company profiles with branding, market cap, sector. */
@@ -537,10 +695,13 @@ declare class SentiSense implements APIClient {
     private baseUrl;
     private apiKey;
     private timeout;
+    private maxRetries;
     readonly stocks: Stocks;
     readonly documents: Documents;
     readonly institutional: Institutional;
     readonly insider: Insider;
+    readonly politicians: Politicians;
+    readonly insights: Insights;
     readonly entityMetrics: EntityMetrics;
     readonly marketMood: MarketMoodResource;
     readonly marketSummary: MarketSummaryResource;
@@ -564,12 +725,13 @@ declare class NotFoundError extends SentiSenseError {
     constructor(message: string, code?: string);
 }
 declare class RateLimitError extends SentiSenseError {
-    constructor(message: string, code?: string);
+    retryAfter?: number;
+    constructor(message: string, code?: string, retryAfter?: number);
 }
 declare class APIError extends SentiSenseError {
     constructor(message: string, status: number, code?: string);
 }
 
-declare const VERSION = "0.5.0";
+declare const VERSION = "0.7.1";
 
-export { type AISummary, APIError, AuthenticationError, type ChartData, type ChartDataPoint, type ClusterBuy, type Document, type DocumentSource, type FloatInfo, type Fundamentals, type FundamentalsPeriod, type GetInsiderOptions, type Holder, type InsiderActivityResponse, type InsiderActivitySummary, type InsiderTrade, type InstitutionalFlow, type InstitutionalFlowsResponse, type KBEntity, type MarketMood, type MarketStatus, type MarketSummary, type MentionCount, type MentionData, type MetricDistribution, type MetricDistributionOptions, type MetricType, type MetricsBreakdown, type MetricsOptions, NotFoundError, type Quarter, RateLimitError, SentiSense, SentiSenseError, type SentiSenseOptions, type SentimentData, type SentimentEntry, type ServingMetric, type ShortInterest, type ShortVolume, type StockDetail, type StockEntity, type StockImage, type StockPrice, type StockProfile, type Story, type StoryCluster, VERSION, SentiSense as default };
+export { type AISummary, APIError, AuthenticationError, type ChartData, type ChartDataPoint, type ClusterBuy, type CongressTrade, type Document, type DocumentSource, type FloatInfo, type Fundamentals, type FundamentalsPeriod, type GetInsiderOptions, type GetInsightsOptions, type GetPoliticiansOptions, type Holder, type InsiderActivityResponse, type InsiderActivitySummary, type InsiderTrade, type Insight, type InsightPreviewResponse, type InstitutionalFlow, type InstitutionalFlowsResponse, type KBEntity, 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 StockDetail, type StockEntity, type StockImage, type StockPrice, type StockProfile, type Story, type StoryCluster, VERSION, SentiSense as default };

package/dist/index.mjs

@@ -20,9 +20,10 @@ var NotFoundError = class extends SentiSenseError {
   }
 };
 var RateLimitError = class extends SentiSenseError {
-  constructor(message, code) {
+  constructor(message, code, retryAfter) {
     super(message, 429, code);
     this.name = "RateLimitError";
+    this.retryAfter = retryAfter;
   }
 };
 var APIError = class extends SentiSenseError {
@@ -212,6 +213,93 @@ var Insider = class {
   }
 };
 
+// src/resources/politicians.ts
+var Politicians = class {
+  constructor(client) {
+    this.client = client;
+  }
+  /**
+   * Get recent congressional STOCK Act trading activity across all politicians.
+   *
+   * PRO-gated. Free/unauthenticated users receive a preview (top 5 trades)
+   * with `isPreview: true` in the response.
+   */
+  async getActivity(options) {
+    return this.client.get("/api/v1/politicians/activity", options);
+  }
+  /**
+   * Get congressional trades for a specific stock.
+   *
+   * PRO-gated. Free users receive a preview of the top 3 trades.
+   */
+  async getFilings(ticker, options) {
+    return this.client.get(
+      `/api/v1/politicians/filings/${encodeURIComponent(ticker.toUpperCase())}`,
+      options
+    );
+  }
+  /**
+   * Get all tracked politicians with trading summary statistics.
+   *
+   * PRO-gated. Free users receive a preview of the top 5 members.
+   */
+  async getMembers() {
+    return this.client.get("/api/v1/politicians/members");
+  }
+  /**
+   * Get detailed profile for a single politician: summary, recent trades, top tickers.
+   *
+   * PRO-gated. Free users receive a preview-wrapped response.
+   */
+  async getMember(slug) {
+    return this.client.get(
+      `/api/v1/politicians/member/${encodeURIComponent(slug)}`
+    );
+  }
+};
+
+// src/resources/insights.ts
+var Insights = class {
+  constructor(client) {
+    this.client = client;
+  }
+  /**
+   * Get AI-generated insights for a specific stock, sorted by urgency then confidence.
+   *
+   * PRO users receive a flat array of Insight objects.
+   * Free/unauthenticated users receive a preview with `isPreview: true`,
+   * the top 3 insights in full, and a `locked` array with metadata-only entries
+   * (type, urgency, timestamp) showing what additional signals exist.
+   */
+  async stock(ticker, options) {
+    return this.client.get(
+      `/api/v1/insights/stock/${encodeURIComponent(ticker.toUpperCase())}`,
+      options
+    );
+  }
+  /**
+   * Get AI-generated market-level insights, sorted by urgency then confidence.
+   *
+   * PRO users receive a flat array of Insight objects.
+   * Free/unauthenticated users receive a preview with `isPreview: true`,
+   * the top 5 insights in full, and a `locked` array with metadata-only entries.
+   */
+  async market() {
+    return this.client.get("/api/v1/insights/market");
+  }
+  /**
+   * Get available insight types for a specific stock.
+   * No authentication required.
+   *
+   * Returns an array of insight type strings (e.g., `["sentiment_shift", "options_activity"]`).
+   */
+  async types(ticker) {
+    return this.client.get(
+      `/api/v1/insights/stock/${encodeURIComponent(ticker.toUpperCase())}/types`
+    );
+  }
+};
+
 // src/resources/institutional.ts
 var Institutional = class {
   constructor(client) {
@@ -393,20 +481,29 @@ var Stocks = class {
 };
 
 // src/version.ts
-var VERSION = "0.5.0";
+var VERSION = "0.7.1";
 
 // src/client.ts
 var DEFAULT_BASE_URL = "https://app.sentisense.ai";
 var DEFAULT_TIMEOUT = 3e4;
+var DEFAULT_MAX_RETRIES = 3;
+var BASE_DELAY_MS = 1e3;
+var MAX_DELAY_MS = 6e4;
+function sleep(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
 var SentiSense = class {
   constructor(options = {}) {
     this.apiKey = options.apiKey;
     this.baseUrl = (options.baseUrl ?? DEFAULT_BASE_URL).replace(/\/+$/, "");
     this.timeout = options.timeout ?? DEFAULT_TIMEOUT;
+    this.maxRetries = options.maxRetries ?? DEFAULT_MAX_RETRIES;
     this.stocks = new Stocks(this);
     this.documents = new Documents(this);
     this.institutional = new Institutional(this);
     this.insider = new Insider(this);
+    this.politicians = new Politicians(this);
+    this.insights = new Insights(this);
     this.entityMetrics = new EntityMetrics(this);
     this.marketMood = new MarketMoodResource(this);
     this.marketSummary = new MarketSummaryResource(this);
@@ -424,29 +521,51 @@ var SentiSense = class {
     if (typeof process !== "undefined" && process.versions?.node) {
       headers["User-Agent"] = `sentisense-node/${VERSION}`;
     }
-    const controller = new AbortController();
-    const timer = setTimeout(() => controller.abort(), this.timeout);
-    try {
-      const response = await fetch(url, {
-        method: "GET",
-        headers,
-        signal: controller.signal
-      });
-      if (!response.ok) {
-        await this.handleErrorResponse(response);
+    let delayMs = 0;
+    for (let attempt = 0; attempt <= this.maxRetries; attempt++) {
+      if (delayMs > 0) {
+        await sleep(delayMs);
+        delayMs = 0;
       }
-      return await response.json();
-    } catch (error) {
-      if (error instanceof SentiSenseError) throw error;
-      if (error instanceof Error && error.name === "AbortError") {
-        throw new SentiSenseError(`Request timed out after ${this.timeout}ms`);
+      const controller = new AbortController();
+      const timer = setTimeout(() => controller.abort(), this.timeout);
+      try {
+        const response = await fetch(url, {
+          method: "GET",
+          headers,
+          signal: controller.signal
+        });
+        if (!response.ok) {
+          const isRetryable = response.status === 429 || response.status >= 500;
+          if (isRetryable && attempt < this.maxRetries) {
+            if (response.status === 429) {
+              const ra = response.headers.get("Retry-After");
+              delayMs = (ra ? parseInt(ra, 10) : 60) * 1e3;
+            } else {
+              delayMs = Math.min(BASE_DELAY_MS * Math.pow(2, attempt), MAX_DELAY_MS) + Math.random() * 1e3;
+            }
+            try {
+              await response.body?.cancel();
+            } catch {
+            }
+            continue;
+          }
+          await this.handleErrorResponse(response);
+        }
+        return await response.json();
+      } catch (error) {
+        if (error instanceof SentiSenseError) throw error;
+        if (error instanceof Error && error.name === "AbortError") {
+          throw new SentiSenseError(`Request timed out after ${this.timeout}ms`);
+        }
+        throw new SentiSenseError(
+          error instanceof Error ? error.message : "Unknown error"
+        );
+      } finally {
+        clearTimeout(timer);
       }
-      throw new SentiSenseError(
-        error instanceof Error ? error.message : "Unknown error"
-      );
-    } finally {
-      clearTimeout(timer);
     }
+    throw new SentiSenseError("All retries exhausted");
   }
   buildUrl(path, params) {
     const url = new URL(path, this.baseUrl);
@@ -473,8 +592,10 @@ var SentiSense = class {
         throw new AuthenticationError(message, response.status, code);
       case 404:
         throw new NotFoundError(message, code);
-      case 429:
-        throw new RateLimitError(message, code);
+      case 429: {
+        const ra = response.headers.get("Retry-After");
+        throw new RateLimitError(message, code, ra ? parseInt(ra, 10) : void 0);
+      }
       default:
         throw new APIError(message, response.status, code);
     }

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/errors.ts","../src/resources/documents.ts","../src/resources/entityMetrics.ts","../src/resources/insider.ts","../src/resources/institutional.ts","../src/resources/kb.ts","../src/resources/marketMood.ts","../src/resources/marketSummary.ts","../src/resources/stocks.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  constructor(message: string, code?: string) {\n    super(message, 429, code);\n    this.name = \"RateLimitError\";\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 {\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 {\n  InsiderActivityResponse,\n  InsiderTrade,\n  ClusterBuy,\n  GetInsiderOptions,\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<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<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<ClusterBuy[]> {\n    return this.client.get(\"/api/v1/insider/cluster-buys\", options);\n  }\n}\n","import type { APIClient } from \"../client.js\";\nimport type {\n  GetFlowsOptions,\n  Holder,\n  InstitutionalFlowsResponse,\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","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","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  FloatInfo,\n  Fundamentals,\n  FundamentalsPeriod,\n  GetAISummaryOptions,\n  GetChartOptions,\n  GetDescriptionsOptions,\n  GetFundamentalsOptions,\n  GetImagesOptions,\n  GetMetricsBreakdownOptions,\n  GetProfileOptions,\n  GetSimilarOptions,\n  MarketStatus,\n  MetricsBreakdown,\n  ShortInterest,\n  ShortVolume,\n  StockDetail,\n  StockEntity,\n  StockImage,\n  StockPrice,\n  StockProfile,\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  /** Get real-time prices for multiple tickers. */\n  async getPrices(tickers: string[]): Promise<Record<string, 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<StockDetail[]> {\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  /** Get historical OHLCV chart data. */\n  async getChart(ticker: string, options?: GetChartOptions): Promise<ChartData> {\n    return this.client.get(\"/api/v1/stocks/chart\", { ticker, ...options });\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 P/E, P/B, P/S ratios. */\n  async getHistoricalRatios(ticker: string): Promise<unknown> {\n    return this.client.get(\"/api/v1/stocks/fundamentals/historical/ratios\", { 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","export const VERSION = \"0.5.0\";\n","import {\n  APIError,\n  AuthenticationError,\n  NotFoundError,\n  RateLimitError,\n  SentiSenseError,\n} from \"./errors.js\";\nimport { Documents } from \"./resources/documents.js\";\nimport { EntityMetrics } from \"./resources/entityMetrics.js\";\nimport { Insider } from \"./resources/insider.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 type { SentiSenseOptions } from \"./types.js\";\nimport { VERSION } from \"./version.js\";\n\nconst DEFAULT_BASE_URL = \"https://app.sentisense.ai\";\nconst DEFAULT_TIMEOUT = 30_000;\n\n/** @internal HTTP interface exposed to resource classes. */\nexport interface APIClient {\n  get<T = unknown>(path: string, params?: object): Promise<T>;\n}\n\nexport class SentiSense implements APIClient {\n  private baseUrl: string;\n  private apiKey: string | undefined;\n  private timeout: number;\n\n  readonly stocks: Stocks;\n  readonly documents: Documents;\n  readonly institutional: Institutional;\n  readonly insider: Insider;\n  readonly entityMetrics: EntityMetrics;\n  readonly marketMood: MarketMoodResource;\n  readonly marketSummary: MarketSummaryResource;\n  readonly kb: KB;\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\n    this.stocks = new Stocks(this);\n    this.documents = new Documents(this);\n    this.institutional = new Institutional(this);\n    this.insider = new Insider(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  }\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    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        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        throw new RateLimitError(message, code);\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/documents.ts","../src/resources/entityMetrics.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/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 {\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 {\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 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-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 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  InstitutionalFlowsResponse,\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","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","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  FloatInfo,\n  Fundamentals,\n  FundamentalsPeriod,\n  GetAISummaryOptions,\n  GetChartOptions,\n  GetDescriptionsOptions,\n  GetFundamentalsOptions,\n  GetImagesOptions,\n  GetMetricsBreakdownOptions,\n  GetProfileOptions,\n  GetSimilarOptions,\n  MarketStatus,\n  MetricsBreakdown,\n  ShortInterest,\n  ShortVolume,\n  StockDetail,\n  StockEntity,\n  StockImage,\n  StockPrice,\n  StockProfile,\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  /** 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<StockDetail[]> {\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  /** Get historical OHLCV chart data. */\n  async getChart(ticker: string, options?: GetChartOptions): Promise<ChartData> {\n    return this.client.get(\"/api/v1/stocks/chart\", { ticker, ...options });\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 P/E, P/B, P/S ratios. */\n  async getHistoricalRatios(ticker: string): Promise<unknown> {\n    return this.client.get(\"/api/v1/stocks/fundamentals/historical/ratios\", { 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","export const VERSION = \"0.7.1\";\n","import {\n  APIError,\n  AuthenticationError,\n  NotFoundError,\n  RateLimitError,\n  SentiSenseError,\n} from \"./errors.js\";\nimport { Documents } from \"./resources/documents.js\";\nimport { EntityMetrics } from \"./resources/entityMetrics.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 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}\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 institutional: Institutional;\n  readonly insider: Insider;\n  readonly politicians: Politicians;\n  readonly insights: Insights;\n  readonly entityMetrics: EntityMetrics;\n  readonly marketMood: MarketMoodResource;\n  readonly marketSummary: MarketSummaryResource;\n  readonly kb: KB;\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.institutional = new Institutional(this);\n    this.insider = new Insider(this);\n    this.politicians = new Politicians(this);\n    this.insights = new Insights(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  }\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  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,12 +1,12 @@
 {
   "name": "sentisense",
-  "version": "0.6.0",
+  "version": "0.7.1",
   "description": "Official JavaScript/TypeScript SDK for the SentiSense market intelligence API",
   "author": "SentiSense <support@sentisense.ai>",
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "https://github.com/SentiSenseApp/sentisense-node.git"
+    "url": "git+https://github.com/SentiSenseApp/sentisense-node.git"
   },
   "homepage": "https://sentisense.ai",
   "bugs": {