sentisense 0.2.0 → 0.4.0

package/README.md

@@ -72,11 +72,22 @@ client.institutional.getActivists("2025-02-14")
 ### Entity Metrics
 
 ```typescript
-client.entityMetrics.getMentions("AAPL")
-client.entityMetrics.getSentiment("AAPL")
-client.entityMetrics.getAverageSentiment("AAPL")
+// Time-series metrics (v2 API)
+client.entityMetrics.getMetrics("AAPL", { metricType: "sentiment" })
+client.entityMetrics.getMetrics("AAPL", {
+  metricType: "mentions",
+  startTime: Date.now() - 7 * 86400000,
+  endTime: Date.now(),
+  maxDataPoints: 100,
+})
+
+// Distribution by source
+client.entityMetrics.getDistribution("AAPL", "sentiment")
+client.entityMetrics.getDistribution("AAPL", "mentions", { dimension: "source" })
 ```
 
+Available metric types: `mentions`, `sentiment`, `sentisense_score`, `social_dominance`, `creators`.
+
 ### Knowledge Base
 
 ```typescript

package/dist/index.cjs

@@ -117,42 +117,87 @@ var EntityMetrics = class {
   constructor(client) {
     this.client = client;
   }
-  /** Get mention data for a stock. */
+  // ── v2 API methods ──────────────────────────────────────────
+  /**
+   * Get time-series metric data for an entity using the v2 Serving Metrics API.
+   *
+   * @param symbol   Ticker symbol (e.g. "AAPL") — the backend resolves the entity.
+   * @param options  Metric type and optional time range / resolution.
+   */
+  async getMetrics(symbol, options = {}) {
+    const { metricType = "sentiment", startTime, endTime, maxDataPoints } = options;
+    return this.client.get(
+      `/api/v2/metrics/entity/${encodeURIComponent(symbol)}/metric/${encodeURIComponent(metricType)}`,
+      {
+        ...startTime !== void 0 && { startTime },
+        ...endTime !== void 0 && { endTime },
+        ...maxDataPoints !== void 0 && { maxDataPoints }
+      }
+    );
+  }
+  /**
+   * Get distribution data for a metric, broken down by a dimension (default: source).
+   *
+   * @param symbol     Ticker symbol (e.g. "AAPL").
+   * @param metricType The metric to break down (e.g. "mentions", "sentiment").
+   * @param options    Optional dimension parameter.
+   */
+  async getDistribution(symbol, metricType, options = {}) {
+    const { dimension = "source" } = options;
+    return this.client.get(
+      `/api/v2/metrics/entity/${encodeURIComponent(symbol)}/distribution/${encodeURIComponent(metricType)}`,
+      { dimension }
+    );
+  }
+  // ── Deprecated v1 methods (kept for backward compatibility) ─
+  /**
+   * @deprecated Use `getMetrics(symbol, { metricType: "mentions" })` instead.
+   */
   async getMentions(symbol, options) {
     return this.client.get(
       `/api/v1/entity-metrics/stocks/${encodeURIComponent(symbol)}/mentions`,
       options
     );
   }
-  /** Get mention counts broken down by source. */
+  /**
+   * @deprecated Use `getDistribution(symbol, "mentions", { dimension: "source" })` instead.
+   */
   async getMentionCountBySource(symbol, options) {
     return this.client.get(
       `/api/v1/entity-metrics/stocks/${encodeURIComponent(symbol)}/mentions/count/by-source`,
       options
     );
   }
-  /** Get total mention count. */
+  /**
+   * @deprecated Use `getMetrics(symbol, { metricType: "mentions" })` instead.
+   */
   async getMentionCount(symbol, options) {
     return this.client.get(
       `/api/v1/entity-metrics/stocks/${encodeURIComponent(symbol)}/mentions/count`,
       options
     );
   }
-  /** Get sentiment data for a stock. */
+  /**
+   * @deprecated Use `getMetrics(symbol, { metricType: "sentiment" })` instead.
+   */
   async getSentiment(symbol, options) {
     return this.client.get(
       `/api/v1/entity-metrics/stocks/${encodeURIComponent(symbol)}/sentiment`,
       options
     );
   }
-  /** Get sentiment broken down by source. */
+  /**
+   * @deprecated Use `getDistribution(symbol, "sentiment", { dimension: "source" })` instead.
+   */
   async getSentimentBySource(symbol, options) {
     return this.client.get(
       `/api/v1/entity-metrics/stocks/${encodeURIComponent(symbol)}/sentiment/by-source`,
       options
     );
   }
-  /** Get average sentiment score. */
+  /**
+   * @deprecated Use `getMetrics(symbol, { metricType: "sentiment" })` instead.
+   */
   async getAverageSentiment(symbol, options) {
     return this.client.get(
       `/api/v1/entity-metrics/stocks/${encodeURIComponent(symbol)}/sentiment/average`,
@@ -331,7 +376,7 @@ var Stocks = class {
 };
 
 // src/version.ts
-var VERSION = "0.1.2";
+var VERSION = "0.4.0";
 
 // src/client.ts
 var DEFAULT_BASE_URL = "https://app.sentisense.ai";

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/errors.ts","../src/resources/documents.ts","../src/resources/entityMetrics.ts","../src/resources/institutional.ts","../src/resources/kb.ts","../src/resources/marketMood.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  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  Story,\n  StoryCluster,\n  Quarter,\n  InstitutionalFlow,\n  InstitutionalFlowsResponse,\n  Holder,\n  MentionData,\n  MentionCount,\n  SentimentData,\n  MarketMood,\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 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  SentimentData,\n} from \"../types.js\";\n\nexport class EntityMetrics {\n  constructor(private client: APIClient) {}\n\n  /** Get mention data for a stock. */\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  /** Get mention counts broken down by source. */\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  /** Get total mention count. */\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  /** Get sentiment data for a stock. */\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  /** Get sentiment broken down by source. */\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  /** Get average sentiment score. */\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  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 {\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.1.2\";\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 { Institutional } from \"./resources/institutional.js\";\nimport { KB } from \"./resources/kb.js\";\nimport { MarketMoodResource } from \"./resources/marketMood.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 entityMetrics: EntityMetrics;\n  readonly marketMood: MarketMoodResource;\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.entityMetrics = new EntityMetrics(this);\n    this.marketMood = new MarketMoodResource(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\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/institutional.ts","../src/resources/kb.ts","../src/resources/marketMood.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  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  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 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  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 {\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.4.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 { Institutional } from \"./resources/institutional.js\";\nimport { KB } from \"./resources/kb.js\";\nimport { MarketMoodResource } from \"./resources/marketMood.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 entityMetrics: EntityMetrics;\n  readonly marketMood: MarketMoodResource;\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.entityMetrics = new EntityMetrics(this);\n    this.marketMood = new MarketMoodResource(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\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":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACAO,IAAM,kBAAN,cAA8B,MAAM;AAAA,EAIzC,YAAY,SAAiB,QAAiB,MAAe;AAC3D,UAAM,OAAO;AACb,SAAK,OAAO;AACZ,SAAK,SAAS;AACd,SAAK,OAAO;AAAA,EACd;AACF;AAEO,IAAM,sBAAN,cAAkC,gBAAgB;AAAA,EACvD,YAAY,SAAiB,QAAgB,MAAe;AAC1D,UAAM,SAAS,QAAQ,IAAI;AAC3B,SAAK,OAAO;AAAA,EACd;AACF;AAEO,IAAM,gBAAN,cAA4B,gBAAgB;AAAA,EACjD,YAAY,SAAiB,MAAe;AAC1C,UAAM,SAAS,KAAK,IAAI;AACxB,SAAK,OAAO;AAAA,EACd;AACF;AAEO,IAAM,iBAAN,cAA6B,gBAAgB;AAAA,EAClD,YAAY,SAAiB,MAAe;AAC1C,UAAM,SAAS,KAAK,IAAI;AACxB,SAAK,OAAO;AAAA,EACd;AACF;AAEO,IAAM,WAAN,cAAuB,gBAAgB;AAAA,EAC5C,YAAY,SAAiB,QAAgB,MAAe;AAC1D,UAAM,SAAS,QAAQ,IAAI;AAC3B,SAAK,OAAO;AAAA,EACd;AACF;;;ACxBO,IAAM,YAAN,MAAgB;AAAA,EACrB,YAAoB,QAAmB;AAAnB;AAAA,EAAoB;AAAA;AAAA,EAGxC,MAAM,YAAY,QAAgB,SAAmD;AACnF,WAAO,KAAK,OAAO,IAAI,4BAA4B,mBAAmB,MAAM,CAAC,IAAI,OAAO;AAAA,EAC1F;AAAA;AAAA,EAGA,MAAM,iBAAiB,QAAgB,SAAuD;AAC5F,WAAO,KAAK,OAAO;AAAA,MACjB,4BAA4B,mBAAmB,MAAM,CAAC;AAAA,MACtD;AAAA,IACF;AAAA,EACF;AAAA;AAAA,EAGA,MAAM,YAAY,UAAkB,SAAmD;AACrF,WAAO,KAAK,OAAO;AAAA,MACjB,4BAA4B,mBAAmB,QAAQ,CAAC;AAAA,MACxD;AAAA,IACF;AAAA,EACF;AAAA;AAAA,EAGA,MAAM,OAAO,OAAe,SAAuD;AACjF,WAAO,KAAK,OAAO,IAAI,4BAA4B,EAAE,OAAO,GAAG,QAAQ,CAAC;AAAA,EAC1E;AAAA;AAAA,EAGA,MAAM,YAAY,QAAwB,SAAmD;AAC3F,WAAO,KAAK,OAAO;AAAA,MACjB,4BAA4B,mBAAmB,MAAM,CAAC;AAAA,MACtD;AAAA,IACF;AAAA,EACF;AAAA;AAAA,EAGA,MAAM,WAAW,SAA+C;AAC9D,WAAO,KAAK,OAAO,IAAI,6BAA6B,OAAO;AAAA,EAC7D;AAAA;AAAA,EAGA,MAAM,mBACJ,QACA,SACkB;AAClB,WAAO,KAAK,OAAO;AAAA,MACjB,oCAAoC,mBAAmB,MAAM,CAAC;AAAA,MAC9D;AAAA,IACF;AAAA,EACF;AAEF;;;ACnDO,IAAM,gBAAN,MAAoB;AAAA,EACzB,YAAoB,QAAmB;AAAnB;AAAA,EAAoB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUxC,MAAM,WACJ,QACA,UAA0B,CAAC,GACD;AAC1B,UAAM,EAAE,aAAa,aAAa,WAAW,SAAS,cAAc,IAAI;AACxE,WAAO,KAAK,OAAO;AAAA,MACjB,0BAA0B,mBAAmB,MAAM,CAAC,WAAW,mBAAmB,UAAU,CAAC;AAAA,MAC7F;AAAA,QACE,GAAI,cAAc,UAAa,EAAE,UAAU;AAAA,QAC3C,GAAI,YAAY,UAAa,EAAE,QAAQ;AAAA,QACvC,GAAI,kBAAkB,UAAa,EAAE,cAAc;AAAA,MACrD;AAAA,IACF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASA,MAAM,gBACJ,QACA,YACA,UAAqC,CAAC,GACT;AAC7B,UAAM,EAAE,YAAY,SAAS,IAAI;AACjC,WAAO,KAAK,OAAO;AAAA,MACjB,0BAA0B,mBAAmB,MAAM,CAAC,iBAAiB,mBAAmB,UAAU,CAAC;AAAA,MACnG,EAAE,UAAU;AAAA,IACd;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,MAAM,YAAY,QAAgB,SAAoD;AACpF,WAAO,KAAK,OAAO;AAAA,MACjB,iCAAiC,mBAAmB,MAAM,CAAC;AAAA,MAC3D;AAAA,IACF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,wBACJ,QACA,SACuB;AACvB,WAAO,KAAK,OAAO;AAAA,MACjB,iCAAiC,mBAAmB,MAAM,CAAC;AAAA,MAC3D;AAAA,IACF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,gBAAgB,QAAgB,SAAyD;AAC7F,WAAO,KAAK,OAAO;AAAA,MACjB,iCAAiC,mBAAmB,MAAM,CAAC;AAAA,MAC3D;AAAA,IACF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,aAAa,QAAgB,SAA0D;AAC3F,WAAO,KAAK,OAAO;AAAA,MACjB,iCAAiC,mBAAmB,MAAM,CAAC;AAAA,MAC3D;AAAA,IACF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,qBACJ,QACA,SACwB;AACxB,WAAO,KAAK,OAAO;AAAA,MACjB,iCAAiC,mBAAmB,MAAM,CAAC;AAAA,MAC3D;AAAA,IACF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,oBACJ,QACA,SACwB;AACxB,WAAO,KAAK,OAAO;AAAA,MACjB,iCAAiC,mBAAmB,MAAM,CAAC;AAAA,MAC3D;AAAA,IACF;AAAA,EACF;AACF;;;AC3HO,IAAM,gBAAN,MAAoB;AAAA,EACzB,YAAoB,QAAmB;AAAnB;AAAA,EAAoB;AAAA;AAAA,EAGxC,MAAM,cAAkC;AACtC,WAAO,KAAK,OAAO,IAAI,gCAAgC;AAAA,EACzD;AAAA;AAAA,EAGA,MAAM,SAAS,YAAoB,SAAgE;AACjG,WAAO,KAAK,OAAO,IAAI,+BAA+B;AAAA,MACpD;AAAA,MACA,GAAG;AAAA,IACL,CAAC;AAAA,EACH;AAAA;AAAA,EAGA,MAAM,WAAW,QAAgB,YAAuC;AACtE,WAAO,KAAK,OAAO;AAAA,MACjB,iCAAiC,mBAAmB,MAAM,CAAC;AAAA,MAC3D,EAAE,WAAW;AAAA,IACf;AAAA,EACF;AAAA;AAAA,EAGA,MAAM,aAAa,YAAuC;AACxD,WAAO,KAAK,OAAO,IAAI,kCAAkC,EAAE,WAAW,CAAC;AAAA,EACzE;AACF;;;ACjCO,IAAM,KAAN,MAAS;AAAA,EACd,YAAoB,QAAmB;AAAnB;AAAA,EAAoB;AAAA;AAAA,EAGxC,MAAM,qBAA0C;AAC9C,WAAO,KAAK,OAAO,IAAI,6BAA6B;AAAA,EACtD;AAAA;AAAA,EAGA,MAAM,UAAU,UAAqC;AACnD,WAAO,KAAK,OAAO,IAAI,uBAAuB,mBAAmB,QAAQ,CAAC,EAAE;AAAA,EAC9E;AAAA;AAAA,EAGA,MAAM,iBAAsC;AAC1C,WAAO,KAAK,OAAO,IAAI,yBAAyB;AAAA,EAClD;AACF;;;ACjBO,IAAM,qBAAN,MAAyB;AAAA,EAC9B,YAAoB,QAAmB;AAAnB;AAAA,EAAoB;AAAA;AAAA,EAGxC,MAAM,MAA2B;AAC/B,WAAO,KAAK,OAAO,IAAI,qBAAqB;AAAA,EAC9C;AACF;;;ACgBO,IAAM,SAAN,MAAa;AAAA,EAClB,YAAoB,QAAmB;AAAnB;AAAA,EAAoB;AAAA;AAAA,EAGxC,MAAM,OAA0B;AAC9B,WAAO,KAAK,OAAO,IAAI,gBAAgB;AAAA,EACzC;AAAA;AAAA,EAGA,MAAM,eAAuC;AAC3C,WAAO,KAAK,OAAO,IAAI,yBAAyB;AAAA,EAClD;AAAA;AAAA,EAGA,MAAM,cAAiC;AACrC,WAAO,KAAK,OAAO,IAAI,wBAAwB;AAAA,EACjD;AAAA;AAAA,EAGA,MAAM,sBAA8C;AAClD,WAAO,KAAK,OAAO,IAAI,iCAAiC;AAAA,EAC1D;AAAA;AAAA,EAGA,MAAM,SAAS,QAAqC;AAClD,WAAO,KAAK,OAAO,IAAI,wBAAwB,EAAE,OAAO,CAAC;AAAA,EAC3D;AAAA;AAAA,EAGA,MAAM,UAAU,SAAwD;AACtE,WAAO,KAAK,OAAO,IAAI,yBAAyB;AAAA,MAC9C,SAAS,QAAQ,KAAK,GAAG;AAAA,IAC3B,CAAC;AAAA,EACH;AAAA;AAAA,EAGA,MAAM,UACJ,SACA,SACqC;AACrC,WAAO,KAAK,OAAO,IAAI,yBAAyB;AAAA,MAC9C,SAAS,QAAQ,KAAK,GAAG;AAAA,MACzB,GAAG;AAAA,IACL,CAAC;AAAA,EACH;AAAA;AAAA,EAGA,MAAM,gBACJ,SACA,SACuC;AACvC,WAAO,KAAK,OAAO,IAAI,+BAA+B;AAAA,MACpD,SAAS,QAAQ,KAAK,GAAG;AAAA,MACzB,GAAG;AAAA,IACL,CAAC;AAAA,EACH;AAAA;AAAA,EAGA,MAAM,WAAW,QAAgB,SAAqD;AACpF,WAAO,KAAK,OAAO,IAAI,kBAAkB,mBAAmB,MAAM,CAAC,YAAY,OAAO;AAAA,EACxF;AAAA;AAAA,EAGA,MAAM,WAAW,QAAgB,SAAoD;AACnF,WAAO,KAAK,OAAO,IAAI,kBAAkB,mBAAmB,MAAM,CAAC,YAAY,OAAO;AAAA,EACxF;AAAA;AAAA,EAGA,MAAM,YAAY,QAAwC;AACxD,WAAO,KAAK,OAAO,IAAI,kBAAkB,mBAAmB,MAAM,CAAC,WAAW;AAAA,EAChF;AAAA;AAAA,EAGA,MAAM,aAAa,QAAgB,SAAmD;AACpF,WAAO,KAAK,OAAO,IAAI,kBAAkB,mBAAmB,MAAM,CAAC,eAAe,OAAO;AAAA,EAC3F;AAAA;AAAA,EAGA,MAAM,oBACJ,QACA,YACA,SAC2B;AAC3B,WAAO,KAAK,OAAO;AAAA,MACjB,kBAAkB,mBAAmB,MAAM,CAAC,YAAY,mBAAmB,UAAU,CAAC;AAAA,MACtF;AAAA,IACF;AAAA,EACF;AAAA;AAAA,EAGA,MAAM,SAAS,QAAgB,SAA+C;AAC5E,WAAO,KAAK,OAAO,IAAI,wBAAwB,EAAE,QAAQ,GAAG,QAAQ,CAAC;AAAA,EACvE;AAAA;AAAA,EAGA,MAAM,kBAAyC;AAC7C,WAAO,KAAK,OAAO,IAAI,8BAA8B;AAAA,EACvD;AAAA;AAAA,EAGA,MAAM,gBAAgB,QAAgB,SAAyD;AAC7F,WAAO,KAAK,OAAO,IAAI,+BAA+B,EAAE,QAAQ,GAAG,QAAQ,CAAC;AAAA,EAC9E;AAAA;AAAA,EAGA,MAAM,uBAAuB,QAA+C;AAC1E,WAAO,KAAK,OAAO,IAAI,uCAAuC,EAAE,OAAO,CAAC;AAAA,EAC1E;AAAA;AAAA,EAGA,MAAM,uBAAuB,QAAuC;AAClE,WAAO,KAAK,OAAO,IAAI,uCAAuC,EAAE,OAAO,CAAC;AAAA,EAC1E;AAAA;AAAA,EAGA,MAAM,oBAAoB,QAAkC;AAC1D,WAAO,KAAK,OAAO,IAAI,iDAAiD,EAAE,OAAO,CAAC;AAAA,EACpF;AAAA;AAAA,EAGA,MAAM,qBAAqB,QAAkC;AAC3D,WAAO,KAAK,OAAO,IAAI,kDAAkD,EAAE,OAAO,CAAC;AAAA,EACrF;AAAA;AAAA,EAGA,MAAM,iBAAiB,QAAwC;AAC7D,WAAO,KAAK,OAAO,IAAI,iCAAiC,EAAE,OAAO,CAAC;AAAA,EACpE;AAAA;AAAA,EAGA,MAAM,SAAS,QAAoC;AACjD,WAAO,KAAK,OAAO,IAAI,wBAAwB,EAAE,OAAO,CAAC;AAAA,EAC3D;AAAA;AAAA,EAGA,MAAM,eAAe,QAAsC;AACzD,WAAO,KAAK,OAAO,IAAI,+BAA+B,EAAE,OAAO,CAAC;AAAA,EAClE;AACF;;;ACpKO,IAAM,UAAU;;;ACgBvB,IAAM,mBAAmB;AACzB,IAAM,kBAAkB;AAOjB,IAAM,aAAN,MAAsC;AAAA,EAY3C,YAAY,UAA6B,CAAC,GAAG;AAC3C,SAAK,SAAS,QAAQ;AACtB,SAAK,WAAW,QAAQ,WAAW,kBAAkB,QAAQ,QAAQ,EAAE;AACvE,SAAK,UAAU,QAAQ,WAAW;AAElC,SAAK,SAAS,IAAI,OAAO,IAAI;AAC7B,SAAK,YAAY,IAAI,UAAU,IAAI;AACnC,SAAK,gBAAgB,IAAI,cAAc,IAAI;AAC3C,SAAK,gBAAgB,IAAI,cAAc,IAAI;AAC3C,SAAK,aAAa,IAAI,mBAAmB,IAAI;AAC7C,SAAK,KAAK,IAAI,GAAG,IAAI;AAAA,EACvB;AAAA;AAAA,EAGA,MAAM,IAAiB,MAAc,QAA6B;AAChE,UAAM,MAAM,KAAK,SAAS,MAAM,MAAM;AACtC,UAAM,UAAkC,CAAC;AAEzC,QAAI,KAAK,QAAQ;AACf,cAAQ,sBAAsB,IAAI,KAAK;AAAA,IACzC;AAGA,QAAI,OAAO,YAAY,eAAe,QAAQ,UAAU,MAAM;AAC5D,cAAQ,YAAY,IAAI,mBAAmB,OAAO;AAAA,IACpD;AAEA,UAAM,aAAa,IAAI,gBAAgB;AACvC,UAAM,QAAQ,WAAW,MAAM,WAAW,MAAM,GAAG,KAAK,OAAO;AAE/D,QAAI;AACF,YAAM,WAAW,MAAM,MAAM,KAAK;AAAA,QAChC,QAAQ;AAAA,QACR;AAAA,QACA,QAAQ,WAAW;AAAA,MACrB,CAAC;AAED,UAAI,CAAC,SAAS,IAAI;AAChB,cAAM,KAAK,oBAAoB,QAAQ;AAAA,MACzC;AAEA,aAAQ,MAAM,SAAS,KAAK;AAAA,IAC9B,SAAS,OAAO;AACd,UAAI,iBAAiB,gBAAiB,OAAM;AAC5C,UAAI,iBAAiB,SAAS,MAAM,SAAS,cAAc;AACzD,cAAM,IAAI,gBAAgB,2BAA2B,KAAK,OAAO,IAAI;AAAA,MACvE;AACA,YAAM,IAAI;AAAA,QACR,iBAAiB,QAAQ,MAAM,UAAU;AAAA,MAC3C;AAAA,IACF,UAAE;AACA,mBAAa,KAAK;AAAA,IACpB;AAAA,EACF;AAAA,EAEQ,SAAS,MAAc,QAAyB;AACtD,UAAM,MAAM,IAAI,IAAI,MAAM,KAAK,OAAO;AACtC,QAAI,QAAQ;AACV,iBAAW,CAAC,KAAK,KAAK,KAAK,OAAO,QAAQ,MAAiC,GAAG;AAC5E,YAAI,UAAU,UAAa,UAAU,MAAM;AACzC,cAAI,aAAa,IAAI,KAAK,OAAO,KAAK,CAAC;AAAA,QACzC;AAAA,MACF;AAAA,IACF;AACA,WAAO,IAAI,SAAS;AAAA,EACtB;AAAA,EAEA,MAAc,oBAAoB,UAAoC;AACpE,QAAI,OAA6C,CAAC;AAClD,QAAI;AACF,aAAO,MAAM,SAAS,KAAK;AAAA,IAC7B,QAAQ;AAAA,IAER;AAEA,UAAM,UAAU,KAAK,WAAW,SAAS,cAAc;AACvD,UAAM,OAAO,KAAK;AAElB,YAAQ,SAAS,QAAQ;AAAA,MACvB,KAAK;AAAA,MACL,KAAK;AACH,cAAM,IAAI,oBAAoB,SAAS,SAAS,QAAQ,IAAI;AAAA,MAC9D,KAAK;AACH,cAAM,IAAI,cAAc,SAAS,IAAI;AAAA,MACvC,KAAK;AACH,cAAM,IAAI,eAAe,SAAS,IAAI;AAAA,MACxC;AACE,cAAM,IAAI,SAAS,SAAS,SAAS,QAAQ,IAAI;AAAA,IACrD;AAAA,EACF;AACF;","names":[]}

package/dist/index.d.mts

@@ -111,6 +111,14 @@ interface GetFundamentalsOptions {
     fiscalYear?: number;
 }
 type DocumentSource = "news" | "reddit" | "x" | "substack";
+/** Per-entity sentiment classification with resolved entity details. */
+interface SentimentEntry {
+    ticker: string | null;
+    name: string | null;
+    entityId: string;
+    entityType: string;
+    sentiment: string;
+}
 /** Document object with sentiment metrics and metadata. */
 interface Document {
     id: string;
@@ -119,7 +127,7 @@ interface Document {
     published: number;
     averageSentiment: number;
     reliability: number;
-    sentimentMap: Record<string, string>;
+    sentiment: SentimentEntry[];
 }
 /** Story cluster with title, sentiment, and metrics. */
 interface StoryCluster {
@@ -135,7 +143,7 @@ interface Story {
     tickers: string[];
     primaryEntityNames: string[];
     impactScore: number;
-    representativeTimestamp: number;
+    brokeAt: number;
 }
 interface GetByTickerOptions {
     source?: DocumentSource;
@@ -211,25 +219,60 @@ interface InstitutionalFlowsResponse {
 interface GetFlowsOptions {
     limit?: number;
 }
+/** Supported metric types for the v2 Serving Metrics API. */
+type MetricType = "mentions" | "sentiment" | "sentisense_score" | "social_dominance" | "creators";
+/** Options for `EntityMetrics.getMetrics()`. */
+interface MetricsOptions {
+    /** Metric to retrieve. Defaults to `"sentiment"`. */
+    metricType?: MetricType;
+    /** Start of the time range (epoch milliseconds). */
+    startTime?: number;
+    /** End of the time range (epoch milliseconds). */
+    endTime?: number;
+    /** Maximum number of data points to return. */
+    maxDataPoints?: number;
+}
+/** Options for `EntityMetrics.getDistribution()`. */
+interface MetricDistributionOptions {
+    /** Dimension to break the metric down by. Defaults to `"source"`. */
+    dimension?: string;
+}
+/** A single data point returned by the v2 time-series metrics endpoint. */
+interface ServingMetric {
+    timestamp: number;
+    value: number;
+    [key: string]: unknown;
+}
+/** Distribution data returned by the v2 distribution endpoint. */
+interface MetricDistribution {
+    [key: string]: unknown;
+}
+/** @deprecated Use `ServingMetric[]` from the v2 API instead. */
 interface MentionData {
     [key: string]: unknown;
 }
+/** @deprecated Use `ServingMetric[]` from the v2 API instead. */
 interface MentionCount {
     [key: string]: unknown;
 }
+/** @deprecated Use `ServingMetric[]` from the v2 API instead. */
 interface SentimentData {
     [key: string]: unknown;
 }
+/** @deprecated */
 interface EntityMetricsDateRange {
     startDate?: string;
     endDate?: string;
 }
+/** @deprecated */
 interface GetMentionsOptions extends EntityMetricsDateRange {
     source?: DocumentSource;
 }
+/** @deprecated */
 interface GetMentionCountOptions extends EntityMetricsDateRange {
     source?: DocumentSource;
 }
+/** @deprecated */
 interface GetSentimentBySourceOptions {
     date?: string;
 }
@@ -264,17 +307,44 @@ declare class Documents {
 declare class EntityMetrics {
     private client;
     constructor(client: APIClient);
-    /** Get mention data for a stock. */
+    /**
+     * Get time-series metric data for an entity using the v2 Serving Metrics API.
+     *
+     * @param symbol   Ticker symbol (e.g. "AAPL") — the backend resolves the entity.
+     * @param options  Metric type and optional time range / resolution.
+     */
+    getMetrics(symbol: string, options?: MetricsOptions): Promise<ServingMetric[]>;
+    /**
+     * Get distribution data for a metric, broken down by a dimension (default: source).
+     *
+     * @param symbol     Ticker symbol (e.g. "AAPL").
+     * @param metricType The metric to break down (e.g. "mentions", "sentiment").
+     * @param options    Optional dimension parameter.
+     */
+    getDistribution(symbol: string, metricType: MetricType, options?: MetricDistributionOptions): Promise<MetricDistribution>;
+    /**
+     * @deprecated Use `getMetrics(symbol, { metricType: "mentions" })` instead.
+     */
     getMentions(symbol: string, options?: GetMentionsOptions): Promise<MentionData>;
-    /** Get mention counts broken down by source. */
+    /**
+     * @deprecated Use `getDistribution(symbol, "mentions", { dimension: "source" })` instead.
+     */
     getMentionCountBySource(symbol: string, options?: EntityMetricsDateRange): Promise<MentionCount>;
-    /** Get total mention count. */
+    /**
+     * @deprecated Use `getMetrics(symbol, { metricType: "mentions" })` instead.
+     */
     getMentionCount(symbol: string, options?: GetMentionCountOptions): Promise<MentionCount>;
-    /** Get sentiment data for a stock. */
+    /**
+     * @deprecated Use `getMetrics(symbol, { metricType: "sentiment" })` instead.
+     */
     getSentiment(symbol: string, options?: EntityMetricsDateRange): Promise<SentimentData>;
-    /** Get sentiment broken down by source. */
+    /**
+     * @deprecated Use `getDistribution(symbol, "sentiment", { dimension: "source" })` instead.
+     */
     getSentimentBySource(symbol: string, options?: GetSentimentBySourceOptions): Promise<SentimentData>;
-    /** Get average sentiment score. */
+    /**
+     * @deprecated Use `getMetrics(symbol, { metricType: "sentiment" })` instead.
+     */
     getAverageSentiment(symbol: string, options?: EntityMetricsDateRange): Promise<SentimentData>;
 }
 
@@ -399,6 +469,6 @@ declare class APIError extends SentiSenseError {
     constructor(message: string, status: number, code?: string);
 }
 
-declare const VERSION = "0.1.2";
+declare const VERSION = "0.4.0";
 
-export { type AISummary, APIError, AuthenticationError, type ChartData, type ChartDataPoint, type Document, type DocumentSource, type FloatInfo, type Fundamentals, type FundamentalsPeriod, type Holder, type InstitutionalFlow, type InstitutionalFlowsResponse, type KBEntity, type MarketMood, type MarketStatus, type MentionCount, type MentionData, type MetricsBreakdown, NotFoundError, type Quarter, RateLimitError, SentiSense, SentiSenseError, type SentiSenseOptions, type SentimentData, 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 Document, type DocumentSource, type FloatInfo, type Fundamentals, type FundamentalsPeriod, type Holder, type InstitutionalFlow, type InstitutionalFlowsResponse, type KBEntity, type MarketMood, type MarketStatus, 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 };

package/dist/index.d.ts

@@ -111,6 +111,14 @@ interface GetFundamentalsOptions {
     fiscalYear?: number;
 }
 type DocumentSource = "news" | "reddit" | "x" | "substack";
+/** Per-entity sentiment classification with resolved entity details. */
+interface SentimentEntry {
+    ticker: string | null;
+    name: string | null;
+    entityId: string;
+    entityType: string;
+    sentiment: string;
+}
 /** Document object with sentiment metrics and metadata. */
 interface Document {
     id: string;
@@ -119,7 +127,7 @@ interface Document {
     published: number;
     averageSentiment: number;
     reliability: number;
-    sentimentMap: Record<string, string>;
+    sentiment: SentimentEntry[];
 }
 /** Story cluster with title, sentiment, and metrics. */
 interface StoryCluster {
@@ -135,7 +143,7 @@ interface Story {
     tickers: string[];
     primaryEntityNames: string[];
     impactScore: number;
-    representativeTimestamp: number;
+    brokeAt: number;
 }
 interface GetByTickerOptions {
     source?: DocumentSource;
@@ -211,25 +219,60 @@ interface InstitutionalFlowsResponse {
 interface GetFlowsOptions {
     limit?: number;
 }
+/** Supported metric types for the v2 Serving Metrics API. */
+type MetricType = "mentions" | "sentiment" | "sentisense_score" | "social_dominance" | "creators";
+/** Options for `EntityMetrics.getMetrics()`. */
+interface MetricsOptions {
+    /** Metric to retrieve. Defaults to `"sentiment"`. */
+    metricType?: MetricType;
+    /** Start of the time range (epoch milliseconds). */
+    startTime?: number;
+    /** End of the time range (epoch milliseconds). */
+    endTime?: number;
+    /** Maximum number of data points to return. */
+    maxDataPoints?: number;
+}
+/** Options for `EntityMetrics.getDistribution()`. */
+interface MetricDistributionOptions {
+    /** Dimension to break the metric down by. Defaults to `"source"`. */
+    dimension?: string;
+}
+/** A single data point returned by the v2 time-series metrics endpoint. */
+interface ServingMetric {
+    timestamp: number;
+    value: number;
+    [key: string]: unknown;
+}
+/** Distribution data returned by the v2 distribution endpoint. */
+interface MetricDistribution {
+    [key: string]: unknown;
+}
+/** @deprecated Use `ServingMetric[]` from the v2 API instead. */
 interface MentionData {
     [key: string]: unknown;
 }
+/** @deprecated Use `ServingMetric[]` from the v2 API instead. */
 interface MentionCount {
     [key: string]: unknown;
 }
+/** @deprecated Use `ServingMetric[]` from the v2 API instead. */
 interface SentimentData {
     [key: string]: unknown;
 }
+/** @deprecated */
 interface EntityMetricsDateRange {
     startDate?: string;
     endDate?: string;
 }
+/** @deprecated */
 interface GetMentionsOptions extends EntityMetricsDateRange {
     source?: DocumentSource;
 }
+/** @deprecated */
 interface GetMentionCountOptions extends EntityMetricsDateRange {
     source?: DocumentSource;
 }
+/** @deprecated */
 interface GetSentimentBySourceOptions {
     date?: string;
 }
@@ -264,17 +307,44 @@ declare class Documents {
 declare class EntityMetrics {
     private client;
     constructor(client: APIClient);
-    /** Get mention data for a stock. */
+    /**
+     * Get time-series metric data for an entity using the v2 Serving Metrics API.
+     *
+     * @param symbol   Ticker symbol (e.g. "AAPL") — the backend resolves the entity.
+     * @param options  Metric type and optional time range / resolution.
+     */
+    getMetrics(symbol: string, options?: MetricsOptions): Promise<ServingMetric[]>;
+    /**
+     * Get distribution data for a metric, broken down by a dimension (default: source).
+     *
+     * @param symbol     Ticker symbol (e.g. "AAPL").
+     * @param metricType The metric to break down (e.g. "mentions", "sentiment").
+     * @param options    Optional dimension parameter.
+     */
+    getDistribution(symbol: string, metricType: MetricType, options?: MetricDistributionOptions): Promise<MetricDistribution>;
+    /**
+     * @deprecated Use `getMetrics(symbol, { metricType: "mentions" })` instead.
+     */
     getMentions(symbol: string, options?: GetMentionsOptions): Promise<MentionData>;
-    /** Get mention counts broken down by source. */
+    /**
+     * @deprecated Use `getDistribution(symbol, "mentions", { dimension: "source" })` instead.
+     */
     getMentionCountBySource(symbol: string, options?: EntityMetricsDateRange): Promise<MentionCount>;
-    /** Get total mention count. */
+    /**
+     * @deprecated Use `getMetrics(symbol, { metricType: "mentions" })` instead.
+     */
     getMentionCount(symbol: string, options?: GetMentionCountOptions): Promise<MentionCount>;
-    /** Get sentiment data for a stock. */
+    /**
+     * @deprecated Use `getMetrics(symbol, { metricType: "sentiment" })` instead.
+     */
     getSentiment(symbol: string, options?: EntityMetricsDateRange): Promise<SentimentData>;
-    /** Get sentiment broken down by source. */
+    /**
+     * @deprecated Use `getDistribution(symbol, "sentiment", { dimension: "source" })` instead.
+     */
     getSentimentBySource(symbol: string, options?: GetSentimentBySourceOptions): Promise<SentimentData>;
-    /** Get average sentiment score. */
+    /**
+     * @deprecated Use `getMetrics(symbol, { metricType: "sentiment" })` instead.
+     */
     getAverageSentiment(symbol: string, options?: EntityMetricsDateRange): Promise<SentimentData>;
 }
 
@@ -399,6 +469,6 @@ declare class APIError extends SentiSenseError {
     constructor(message: string, status: number, code?: string);
 }
 
-declare const VERSION = "0.1.2";
+declare const VERSION = "0.4.0";
 
-export { type AISummary, APIError, AuthenticationError, type ChartData, type ChartDataPoint, type Document, type DocumentSource, type FloatInfo, type Fundamentals, type FundamentalsPeriod, type Holder, type InstitutionalFlow, type InstitutionalFlowsResponse, type KBEntity, type MarketMood, type MarketStatus, type MentionCount, type MentionData, type MetricsBreakdown, NotFoundError, type Quarter, RateLimitError, SentiSense, SentiSenseError, type SentiSenseOptions, type SentimentData, 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 Document, type DocumentSource, type FloatInfo, type Fundamentals, type FundamentalsPeriod, type Holder, type InstitutionalFlow, type InstitutionalFlowsResponse, type KBEntity, type MarketMood, type MarketStatus, 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 };

package/dist/index.mjs

@@ -84,42 +84,87 @@ var EntityMetrics = class {
   constructor(client) {
     this.client = client;
   }
-  /** Get mention data for a stock. */
+  // ── v2 API methods ──────────────────────────────────────────
+  /**
+   * Get time-series metric data for an entity using the v2 Serving Metrics API.
+   *
+   * @param symbol   Ticker symbol (e.g. "AAPL") — the backend resolves the entity.
+   * @param options  Metric type and optional time range / resolution.
+   */
+  async getMetrics(symbol, options = {}) {
+    const { metricType = "sentiment", startTime, endTime, maxDataPoints } = options;
+    return this.client.get(
+      `/api/v2/metrics/entity/${encodeURIComponent(symbol)}/metric/${encodeURIComponent(metricType)}`,
+      {
+        ...startTime !== void 0 && { startTime },
+        ...endTime !== void 0 && { endTime },
+        ...maxDataPoints !== void 0 && { maxDataPoints }
+      }
+    );
+  }
+  /**
+   * Get distribution data for a metric, broken down by a dimension (default: source).
+   *
+   * @param symbol     Ticker symbol (e.g. "AAPL").
+   * @param metricType The metric to break down (e.g. "mentions", "sentiment").
+   * @param options    Optional dimension parameter.
+   */
+  async getDistribution(symbol, metricType, options = {}) {
+    const { dimension = "source" } = options;
+    return this.client.get(
+      `/api/v2/metrics/entity/${encodeURIComponent(symbol)}/distribution/${encodeURIComponent(metricType)}`,
+      { dimension }
+    );
+  }
+  // ── Deprecated v1 methods (kept for backward compatibility) ─
+  /**
+   * @deprecated Use `getMetrics(symbol, { metricType: "mentions" })` instead.
+   */
   async getMentions(symbol, options) {
     return this.client.get(
       `/api/v1/entity-metrics/stocks/${encodeURIComponent(symbol)}/mentions`,
       options
     );
   }
-  /** Get mention counts broken down by source. */
+  /**
+   * @deprecated Use `getDistribution(symbol, "mentions", { dimension: "source" })` instead.
+   */
   async getMentionCountBySource(symbol, options) {
     return this.client.get(
       `/api/v1/entity-metrics/stocks/${encodeURIComponent(symbol)}/mentions/count/by-source`,
       options
     );
   }
-  /** Get total mention count. */
+  /**
+   * @deprecated Use `getMetrics(symbol, { metricType: "mentions" })` instead.
+   */
   async getMentionCount(symbol, options) {
     return this.client.get(
       `/api/v1/entity-metrics/stocks/${encodeURIComponent(symbol)}/mentions/count`,
       options
     );
   }
-  /** Get sentiment data for a stock. */
+  /**
+   * @deprecated Use `getMetrics(symbol, { metricType: "sentiment" })` instead.
+   */
   async getSentiment(symbol, options) {
     return this.client.get(
       `/api/v1/entity-metrics/stocks/${encodeURIComponent(symbol)}/sentiment`,
       options
     );
   }
-  /** Get sentiment broken down by source. */
+  /**
+   * @deprecated Use `getDistribution(symbol, "sentiment", { dimension: "source" })` instead.
+   */
   async getSentimentBySource(symbol, options) {
     return this.client.get(
       `/api/v1/entity-metrics/stocks/${encodeURIComponent(symbol)}/sentiment/by-source`,
       options
     );
   }
-  /** Get average sentiment score. */
+  /**
+   * @deprecated Use `getMetrics(symbol, { metricType: "sentiment" })` instead.
+   */
   async getAverageSentiment(symbol, options) {
     return this.client.get(
       `/api/v1/entity-metrics/stocks/${encodeURIComponent(symbol)}/sentiment/average`,
@@ -298,7 +343,7 @@ var Stocks = class {
 };
 
 // src/version.ts
-var VERSION = "0.1.2";
+var VERSION = "0.4.0";
 
 // src/client.ts
 var DEFAULT_BASE_URL = "https://app.sentisense.ai";

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/errors.ts","../src/resources/documents.ts","../src/resources/entityMetrics.ts","../src/resources/institutional.ts","../src/resources/kb.ts","../src/resources/marketMood.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 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  SentimentData,\n} from \"../types.js\";\n\nexport class EntityMetrics {\n  constructor(private client: APIClient) {}\n\n  /** Get mention data for a stock. */\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  /** Get mention counts broken down by source. */\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  /** Get total mention count. */\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  /** Get sentiment data for a stock. */\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  /** Get sentiment broken down by source. */\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  /** Get average sentiment score. */\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  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 {\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.1.2\";\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 { Institutional } from \"./resources/institutional.js\";\nimport { KB } from \"./resources/kb.js\";\nimport { MarketMoodResource } from \"./resources/marketMood.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 entityMetrics: EntityMetrics;\n  readonly marketMood: MarketMoodResource;\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.entityMetrics = new EntityMetrics(this);\n    this.marketMood = new MarketMoodResource(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\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/institutional.ts","../src/resources/kb.ts","../src/resources/marketMood.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 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  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 {\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.4.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 { Institutional } from \"./resources/institutional.js\";\nimport { KB } from \"./resources/kb.js\";\nimport { MarketMoodResource } from \"./resources/marketMood.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 entityMetrics: EntityMetrics;\n  readonly marketMood: MarketMoodResource;\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.entityMetrics = new EntityMetrics(this);\n    this.marketMood = new MarketMoodResource(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\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":[]}

package/package.json

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