sentisense 0.8.0 → 0.11.0

package/dist/index.d.ts

@@ -10,14 +10,42 @@ interface StockPrice {
     change: number;
     changePercent: number;
     previousClose: number;
+    /** Unix timestamp in milliseconds of the price quote. */
     timestamp: number;
 }
+/** Aggregate quote snapshot from GET /api/v1/stocks/{ticker}/quote. */
+interface StockQuote {
+    ticker: string;
+    currentPrice: number | null;
+    change: number | null;
+    changePercent: number | null;
+    volume: number | null;
+    open: number | null;
+    dayHigh: number | null;
+    dayLow: number | null;
+    previousClose: number | null;
+    week52High: number | null;
+    week52Low: number | null;
+    marketCap: number | null;
+    peRatio: number | null;
+    epsTTM: number | null;
+    dividendYield: number | null;
+    timestamp: number | null;
+    extendedHours: boolean | null;
+}
 interface StockDetail {
     ticker: string;
     name: string;
     kbEntityId?: string;
     urlSlug?: string;
 }
+interface SimilarStock {
+    symbol: string;
+    name: string;
+    kbEntityId?: string;
+    price: number | null;
+    changePercent: number | null;
+}
 interface StockImage {
     iconUrl: string | null;
     logoUrl: string | null;
@@ -136,6 +164,7 @@ interface StoryCluster {
     title: string;
     clusterSize: number;
     averageSentiment: number;
+    /** Unix timestamp in seconds. */
     createdAt: number;
 }
 interface Story {
@@ -144,6 +173,7 @@ interface Story {
     tickers: string[];
     primaryEntityNames: string[];
     impactScore: number;
+    /** Unix timestamp in seconds when the story first broke. */
     brokeAt: number;
 }
 interface GetByTickerOptions {
@@ -202,6 +232,16 @@ interface InstitutionalFlow {
     hedgeFundNetChange: number;
     activistActivity: boolean;
     reportDate: string;
+    /**
+     * Quarterly average closing price used to weight the dollar flow.
+     * Null when no price is cached for this (quarter, ticker) yet.
+     */
+    avgClosePrice?: number | null;
+    /**
+     * Dollar-weighted net flow: `netSharesChange × avgClosePrice`. 0 when
+     * `avgClosePrice` is missing — fall back to displaying `netSharesChange`.
+     */
+    dollarFlowUsd: number;
 }
 interface Holder {
     filerCik: string;
@@ -350,6 +390,7 @@ interface MetricDistributionOptions {
 }
 /** A single data point returned by the v2 time-series metrics endpoint. */
 interface ServingMetric {
+    /** Unix timestamp in seconds. */
     timestamp: number;
     value: number;
     [key: string]: unknown;
@@ -444,12 +485,157 @@ interface GetInsightsOptions {
     /** Filter by insight type (e.g., `"insider_buy_signal"`). */
     insightType?: string;
 }
+/** One period value in a KPI time series. */
+interface KpiDataPoint {
+    /** e.g. "Q2 FY2026" */
+    period: string;
+    /** ISO date, e.g. "2025-12-27" */
+    date: string;
+    value: number;
+    /** Preliminary flag; often null. */
+    isEstimate?: boolean | null;
+}
+/** A single KPI time series for a company. */
+interface KpiSeries {
+    /** Stable per-ticker identifier, e.g. "iphone_revenue". */
+    id: string;
+    /** Human-readable name, e.g. "iPhone Revenue". */
+    name: string;
+    /** Logical category, e.g. "product_revenue", "segment_revenue". */
+    category: string;
+    /** Unit of measurement, e.g. "USD". */
+    unit: string;
+    /** Display hint, e.g. "currency_abbreviated". */
+    displayFormat: string;
+    /** Default chart type, e.g. "bar" or "line". */
+    chartType: string;
+    /** Time-series data points. */
+    values: KpiDataPoint[];
+    /** Citation for the source filing. */
+    sourceRef?: string;
+    /** Set when the company has stopped reporting this metric. */
+    discontinued?: boolean;
+    /** Optional human-readable note about discontinuation. */
+    discontinuedNote?: string;
+}
+/** Full KPI payload for a company. Returned by `client.stocks.getKpis`. */
+interface CompanyKpisData {
+    ticker: string;
+    companyName: string;
+    cik?: string;
+    lastUpdated: string;
+    kpis: KpiSeries[];
+}
+/** Lightweight coverage entry. Returned by `client.stocks.listKpiCoverage`. */
+interface KpiCoverageEntry {
+    ticker: string;
+    companyName: string;
+    lastUpdated: string;
+    kpiCount: number;
+}
+/** Coverage listing envelope: count + list of covered tickers. */
+interface KpiCoverageResponse {
+    count: number;
+    tickers: KpiCoverageEntry[];
+}
+/** Lightweight KPI metadata tuple. Returned by `client.stocks.getKpiTypes`. */
+interface KpiTypeEntry {
+    id: string;
+    name: string;
+    category: string;
+    chartType: string;
+}
 interface KBEntity {
     entityId: string;
     name: string;
     [key: string]: unknown;
 }
 
+interface AnalystConsensus {
+    ticker: string;
+    currentPrice: number | null;
+    targetLow: number | null;
+    targetMean: number | null;
+    targetHigh: number | null;
+    targetMedian: number | null;
+    numberOfAnalysts: number;
+    upsidePercent: number | null;
+    consensusLabel: string | null;
+    recommendationMean: number | null;
+    /** PRO-only; zero in the free preview. */
+    strongBuy: number;
+    /** PRO-only; zero in the free preview. */
+    buy: number;
+    /** PRO-only; zero in the free preview. */
+    hold: number;
+    /** PRO-only; zero in the free preview. */
+    sell: number;
+    /** PRO-only; zero in the free preview. */
+    strongSell: number;
+    updatedAt: string | null;
+}
+interface AnalystAction {
+    ticker: string;
+    actionDate: string;
+    firm: string;
+    /** UPGRADE, DOWNGRADE, INITIATE, REITERATE, OTHER */
+    actionType: string;
+    fromGrade: string | null;
+    toGrade: string | null;
+}
+interface AnalystEstimate {
+    /** Fiscal period descriptor (provider-specific shape). */
+    [key: string]: unknown;
+}
+interface AnalystEarningsSurprise {
+    /** Past report descriptor (provider-specific shape). */
+    [key: string]: unknown;
+}
+interface AnalystEstimatesResponse {
+    estimates: AnalystEstimate[];
+    surprises: AnalystEarningsSurprise[];
+}
+interface GetAnalystActionsOptions {
+    /** Days of history to return. Default 90. */
+    lookbackDays?: number;
+}
+interface GetAnalystMarketActivityOptions {
+    /** Days of history to return. Default 30. */
+    lookbackDays?: number;
+}
+/**
+ * Wall Street analyst coverage: aggregate price targets, recommendation distribution,
+ * recent upgrade/downgrade actions, and forward EPS estimates with earnings surprise history.
+ *
+ * Free users receive the price target band (low/mean/high + analyst count + consensus label)
+ * in full -- it powers the public projection cone. The buy/hold/sell distribution counts
+ * and full action/estimate history are PRO-only.
+ */
+declare class Analyst {
+    private client;
+    constructor(client: APIClient);
+    /**
+     * Get the aggregate Wall Street consensus for a ticker. Returns 404 if no
+     * coverage exists.
+     */
+    consensus(ticker: string): Promise<PreviewResponse<AnalystConsensus>>;
+    /**
+     * Get recent analyst upgrade/downgrade actions for a ticker, newest first.
+     * Free users receive the 3 most recent.
+     */
+    actions(ticker: string, options?: GetAnalystActionsOptions): Promise<PreviewResponse<AnalystAction[]>>;
+    /**
+     * Get forward EPS estimates and earnings surprise history for a ticker.
+     * Free users receive 1 estimate (current quarter) plus the 2 most recent surprises.
+     */
+    estimates(ticker: string): Promise<PreviewResponse<AnalystEstimatesResponse>>;
+    /**
+     * Get market-wide recent analyst actions across all covered tickers, newest first.
+     * Free users receive the 5 most recent.
+     */
+    marketActivity(options?: GetAnalystMarketActivityOptions): Promise<PreviewResponse<AnalystAction[]>>;
+}
+
 declare class Documents {
     private client;
     constructor(client: APIClient);
@@ -569,6 +755,20 @@ declare class Politicians {
     getMember(slug: string): Promise<PreviewResponse<PoliticianDetail>>;
 }
 
+interface GetStockInsightsRangeOptions {
+    startDate: string;
+    endDate: string;
+    urgency?: "low" | "medium" | "high";
+    insightType?: string;
+}
+interface GetLatestInsightsOptions {
+    limit?: number;
+    urgency?: "low" | "medium" | "high";
+}
+interface GetUserInsightsOptions {
+    limit?: number;
+    category?: string;
+}
 declare class Insights {
     private client;
     constructor(client: APIClient);
@@ -581,6 +781,13 @@ declare class Insights {
      * (type, urgency, timestamp) showing what additional signals exist.
      */
     stock(ticker: string, options?: GetInsightsOptions): Promise<Insight[] | InsightPreviewResponse>;
+    /**
+     * Get AI insights for a stock within a date range.
+     *
+     * Free users receive the top 3; PRO users receive the full list.
+     * The server returns 400 if `startDate` is after `endDate`.
+     */
+    stockRange(ticker: string, options: GetStockInsightsRangeOptions): Promise<Insight[] | InsightPreviewResponse>;
     /**
      * Get AI-generated market-level insights, sorted by urgency then confidence.
      *
@@ -589,6 +796,19 @@ declare class Insights {
      * the top 5 insights in full, and a `locked` array with metadata-only entries.
      */
     market(): Promise<Insight[] | InsightPreviewResponse>;
+    /**
+     * Get the latest AI insights across all tracked stocks, newest first.
+     *
+     * Free users receive the top 5; PRO users receive up to `limit` (clamped to 1-200).
+     */
+    latest(options?: GetLatestInsightsOptions): Promise<Insight[] | InsightPreviewResponse>;
+    /**
+     * Get personalized insights for the authenticated user.
+     *
+     * Biased toward the user's watchlist and portfolio when available; falls back
+     * to market-level insights otherwise. API key authentication required.
+     */
+    user(options?: GetUserInsightsOptions): Promise<Insight[] | InsightPreviewResponse>;
     /**
      * Get available insight types for a specific stock.
      * No authentication required.
@@ -609,6 +829,15 @@ declare class Institutional {
     getHolders(ticker: string, reportDate: string): Promise<Holder[]>;
     /** Get activist investor positions (NEW or INCREASED). */
     getActivists(reportDate: string): Promise<Holder[]>;
+    /**
+     * Get the full profile, summary stats, and current-quarter holdings for a
+     * specific institutional filer.
+     *
+     * Resolved by URL slug (e.g. `Berkshire-Hathaway`) or numeric SEC CIK.
+     * Free users receive the profile and top 10 holdings; PRO users receive the
+     * full holdings array. Returns 404 if the slug or CIK is unknown.
+     */
+    getInstitutionDetail(slugOrCik: string): Promise<unknown>;
 }
 
 declare class KB {
@@ -649,6 +878,12 @@ declare class Stocks {
     listPopularDetailed(): Promise<StockDetail[]>;
     /** Get real-time price for a single ticker. */
     getPrice(ticker: string): Promise<StockPrice>;
+    /**
+     * Get aggregate quote snapshot: live price, today OHLC, 52-week range,
+     * market cap, P/E, EPS TTM, and dividend yield in a single call.
+     * All fields except `ticker` may be null when upstream data is unavailable.
+     */
+    getQuote(ticker: string): Promise<StockQuote>;
     /** Get real-time prices for multiple tickers. */
     getPrices(tickers: string[]): Promise<StockPrice[]>;
     /** Get batch company logo URLs. */
@@ -656,7 +891,7 @@ declare class Stocks {
     /** Get company profiles with branding, market cap, sector. */
     getDescriptions(tickers: string[], options?: GetDescriptionsOptions): Promise<Record<string, StockProfile>>;
     /** Get peer/similar stocks. */
-    getSimilar(ticker: string, options?: GetSimilarOptions): Promise<StockDetail[]>;
+    getSimilar(ticker: string, options?: GetSimilarOptions): Promise<SimilarStock[]>;
     /** Get company profile (CEO, sector, industry, market data). */
     getProfile(ticker: string, options?: GetProfileOptions): Promise<StockProfile>;
     /** Get related KB entities (people, products, partners). */
@@ -685,11 +920,41 @@ declare class Stocks {
     getFloat(ticker: string): Promise<FloatInfo>;
     /** Get short volume trading data. */
     getShortVolume(ticker: string): Promise<ShortVolume>;
+    /**
+     * Get company-specific KPI time-series for a ticker. Returns curated GAAP and
+     * non-GAAP metrics from earnings filings (e.g. iPhone unit sales, Tesla deliveries,
+     * AWS revenue).
+     *
+     * Free users receive metadata only with an empty `kpis` list; PRO users receive
+     * the full series. Returns 404 for tickers that do not yet have curated coverage.
+     *
+     * Coverage today: near-complete for the S&P 500 plus extended universe
+     * (~500 tickers). Use `listKpiCoverage()` to enumerate.
+     */
+    getKpis(ticker: string): Promise<PreviewResponse<CompanyKpisData>>;
+    /**
+     * List every ticker with curated KPI coverage. Returns `{count, tickers: [...]}`
+     * with lightweight metadata (ticker, companyName, lastUpdated, kpiCount).
+     * Sorted alphabetically by ticker.
+     *
+     * Auth: API key required, but the call does NOT consume your monthly quota
+     * (rate-limit-per-minute still applies). [COMP-421]
+     */
+    listKpiCoverage(): Promise<KpiCoverageResponse>;
+    /**
+     * List the KPI metadata tuples available for a ticker — `id, name, category,
+     * chartType` — without paying the cost of the full series payload. Mirrors
+     * the `/api/v1/insights/stock/{ticker}/types` precedent.
+     *
+     * Auth: API key required, no quota cost. 404 if the ticker has no curated KPIs.
+     */
+    getKpiTypes(ticker: string): Promise<KpiTypeEntry[]>;
 }
 
 /** @internal HTTP interface exposed to resource classes. */
 interface APIClient {
     get<T = unknown>(path: string, params?: object): Promise<T>;
+    post<T = unknown>(path: string, body: unknown): Promise<T>;
 }
 declare class SentiSense implements APIClient {
     private baseUrl;
@@ -702,6 +967,7 @@ declare class SentiSense implements APIClient {
     readonly insider: Insider;
     readonly politicians: Politicians;
     readonly insights: Insights;
+    readonly analyst: Analyst;
     readonly entityMetrics: EntityMetrics;
     readonly marketMood: MarketMoodResource;
     readonly marketSummary: MarketSummaryResource;
@@ -709,6 +975,8 @@ declare class SentiSense implements APIClient {
     constructor(options?: SentiSenseOptions);
     /** @internal */
     get<T = unknown>(path: string, params?: object): Promise<T>;
+    /** @internal */
+    post<T = unknown>(path: string, body: unknown): Promise<T>;
     private buildUrl;
     private handleErrorResponse;
 }
@@ -732,6 +1000,6 @@ declare class APIError extends SentiSenseError {
     constructor(message: string, status: number, code?: string);
 }
 
-declare const VERSION = "0.8.0";
+declare const VERSION = "0.11.0";
 
-export { type AISummary, APIError, AuthenticationError, type ChartData, type ChartDataPoint, type ClusterBuy, type CongressTrade, type Document, type DocumentSource, type FloatInfo, type Fundamentals, type FundamentalsPeriod, type GetInsiderOptions, type GetInsightsOptions, type GetPoliticiansOptions, type Holder, type InsiderActivityResponse, type InsiderActivitySummary, type InsiderTrade, type Insight, type InsightPreviewResponse, type InstitutionalFlow, type InstitutionalFlowsResponse, type KBEntity, type LockedInsight, type MarketMood, type MarketStatus, type MarketSummary, type MentionCount, type MentionData, type MetricDistribution, type MetricDistributionOptions, type MetricType, type MetricsBreakdown, type MetricsOptions, NotFoundError, type PoliticianDetail, type PoliticianSummary, type PreviewResponse, type Quarter, RateLimitError, SentiSense, SentiSenseError, type SentiSenseOptions, type SentimentData, type SentimentEntry, type ServingMetric, type ShortInterest, type ShortVolume, type StockDetail, type StockEntity, type StockImage, type StockPrice, type StockProfile, type Story, type StoryCluster, VERSION, SentiSense as default };
+export { type AISummary, APIError, type AnalystAction, type AnalystConsensus, type AnalystEarningsSurprise, type AnalystEstimate, type AnalystEstimatesResponse, AuthenticationError, type ChartData, type ChartDataPoint, type ClusterBuy, type CompanyKpisData, type CongressTrade, type Document, type DocumentSource, type FloatInfo, type Fundamentals, type FundamentalsPeriod, type GetAnalystActionsOptions, type GetAnalystMarketActivityOptions, type GetInsiderOptions, type GetInsightsOptions, type GetLatestInsightsOptions, type GetPoliticiansOptions, type GetStockInsightsRangeOptions, type GetUserInsightsOptions, type Holder, type InsiderActivityResponse, type InsiderActivitySummary, type InsiderTrade, type Insight, type InsightPreviewResponse, type InstitutionalFlow, type InstitutionalFlowsResponse, type KBEntity, type KpiCoverageEntry, type KpiCoverageResponse, type KpiDataPoint, type KpiSeries, type KpiTypeEntry, type LockedInsight, type MarketMood, type MarketStatus, type MarketSummary, type MentionCount, type MentionData, type MetricDistribution, type MetricDistributionOptions, type MetricType, type MetricsBreakdown, type MetricsOptions, NotFoundError, type PoliticianDetail, type PoliticianSummary, type PreviewResponse, type Quarter, RateLimitError, SentiSense, SentiSenseError, type SentiSenseOptions, type SentimentData, type SentimentEntry, type ServingMetric, type ShortInterest, type ShortVolume, type SimilarStock, type StockDetail, type StockEntity, type StockImage, type StockPrice, type StockProfile, type StockQuote, type Story, type StoryCluster, VERSION, SentiSense as default };

package/dist/index.mjs

@@ -33,6 +33,48 @@ var APIError = class extends SentiSenseError {
   }
 };
 
+// src/resources/analyst.ts
+var Analyst = class {
+  constructor(client) {
+    this.client = client;
+  }
+  /**
+   * Get the aggregate Wall Street consensus for a ticker. Returns 404 if no
+   * coverage exists.
+   */
+  async consensus(ticker) {
+    return this.client.get(
+      `/api/v1/analyst/${encodeURIComponent(ticker.toUpperCase())}/consensus`
+    );
+  }
+  /**
+   * Get recent analyst upgrade/downgrade actions for a ticker, newest first.
+   * Free users receive the 3 most recent.
+   */
+  async actions(ticker, options) {
+    return this.client.get(
+      `/api/v1/analyst/${encodeURIComponent(ticker.toUpperCase())}/actions`,
+      options
+    );
+  }
+  /**
+   * Get forward EPS estimates and earnings surprise history for a ticker.
+   * Free users receive 1 estimate (current quarter) plus the 2 most recent surprises.
+   */
+  async estimates(ticker) {
+    return this.client.get(
+      `/api/v1/analyst/${encodeURIComponent(ticker.toUpperCase())}/estimates`
+    );
+  }
+  /**
+   * Get market-wide recent analyst actions across all covered tickers, newest first.
+   * Free users receive the 5 most recent.
+   */
+  async marketActivity(options) {
+    return this.client.get("/api/v1/analyst/activity", options);
+  }
+};
+
 // src/resources/documents.ts
 var Documents = class {
   constructor(client) {
@@ -277,6 +319,18 @@ var Insights = class {
       options
     );
   }
+  /**
+   * Get AI insights for a stock within a date range.
+   *
+   * Free users receive the top 3; PRO users receive the full list.
+   * The server returns 400 if `startDate` is after `endDate`.
+   */
+  async stockRange(ticker, options) {
+    return this.client.get(
+      `/api/v1/insights/stock/${encodeURIComponent(ticker.toUpperCase())}/range`,
+      options
+    );
+  }
   /**
    * Get AI-generated market-level insights, sorted by urgency then confidence.
    *
@@ -287,6 +341,23 @@ var Insights = class {
   async market() {
     return this.client.get("/api/v1/insights/market");
   }
+  /**
+   * Get the latest AI insights across all tracked stocks, newest first.
+   *
+   * Free users receive the top 5; PRO users receive up to `limit` (clamped to 1-200).
+   */
+  async latest(options) {
+    return this.client.get("/api/v1/insights/latest", options);
+  }
+  /**
+   * Get personalized insights for the authenticated user.
+   *
+   * Biased toward the user's watchlist and portfolio when available; falls back
+   * to market-level insights otherwise. API key authentication required.
+   */
+  async user(options) {
+    return this.client.get("/api/v1/insights/user", options);
+  }
   /**
    * Get available insight types for a specific stock.
    * No authentication required.
@@ -327,6 +398,19 @@ var Institutional = class {
   async getActivists(reportDate) {
     return this.client.get("/api/v1/institutional/activist", { reportDate });
   }
+  /**
+   * Get the full profile, summary stats, and current-quarter holdings for a
+   * specific institutional filer.
+   *
+   * Resolved by URL slug (e.g. `Berkshire-Hathaway`) or numeric SEC CIK.
+   * Free users receive the profile and top 10 holdings; PRO users receive the
+   * full holdings array. Returns 404 if the slug or CIK is unknown.
+   */
+  async getInstitutionDetail(slugOrCik) {
+    return this.client.get(
+      `/api/v1/institutional/institution/${encodeURIComponent(slugOrCik)}`
+    );
+  }
 };
 
 // src/resources/kb.ts
@@ -395,6 +479,14 @@ var Stocks = class {
   async getPrice(ticker) {
     return this.client.get("/api/v1/stocks/price", { ticker });
   }
+  /**
+   * Get aggregate quote snapshot: live price, today OHLC, 52-week range,
+   * market cap, P/E, EPS TTM, and dividend yield in a single call.
+   * All fields except `ticker` may be null when upstream data is unavailable.
+   */
+  async getQuote(ticker) {
+    return this.client.get(`/api/v1/stocks/${encodeURIComponent(ticker)}/quote`);
+  }
   /** Get real-time prices for multiple tickers. */
   async getPrices(tickers) {
     return this.client.get("/api/v1/stocks/prices", {
@@ -478,10 +570,49 @@ var Stocks = class {
   async getShortVolume(ticker) {
     return this.client.get("/api/v1/stocks/short-volume", { ticker });
   }
+  /**
+   * Get company-specific KPI time-series for a ticker. Returns curated GAAP and
+   * non-GAAP metrics from earnings filings (e.g. iPhone unit sales, Tesla deliveries,
+   * AWS revenue).
+   *
+   * Free users receive metadata only with an empty `kpis` list; PRO users receive
+   * the full series. Returns 404 for tickers that do not yet have curated coverage.
+   *
+   * Coverage today: near-complete for the S&P 500 plus extended universe
+   * (~500 tickers). Use `listKpiCoverage()` to enumerate.
+   */
+  async getKpis(ticker) {
+    return this.client.get(
+      `/api/v1/stocks/${encodeURIComponent(ticker.toUpperCase())}/kpis`
+    );
+  }
+  /**
+   * List every ticker with curated KPI coverage. Returns `{count, tickers: [...]}`
+   * with lightweight metadata (ticker, companyName, lastUpdated, kpiCount).
+   * Sorted alphabetically by ticker.
+   *
+   * Auth: API key required, but the call does NOT consume your monthly quota
+   * (rate-limit-per-minute still applies). [COMP-421]
+   */
+  async listKpiCoverage() {
+    return this.client.get("/api/v1/stocks/with-kpis");
+  }
+  /**
+   * List the KPI metadata tuples available for a ticker — `id, name, category,
+   * chartType` — without paying the cost of the full series payload. Mirrors
+   * the `/api/v1/insights/stock/{ticker}/types` precedent.
+   *
+   * Auth: API key required, no quota cost. 404 if the ticker has no curated KPIs.
+   */
+  async getKpiTypes(ticker) {
+    return this.client.get(
+      `/api/v1/stocks/${encodeURIComponent(ticker.toUpperCase())}/kpis/types`
+    );
+  }
 };
 
 // src/version.ts
-var VERSION = "0.8.0";
+var VERSION = "0.11.0";
 
 // src/client.ts
 var DEFAULT_BASE_URL = "https://app.sentisense.ai";
@@ -504,6 +635,7 @@ var SentiSense = class {
     this.insider = new Insider(this);
     this.politicians = new Politicians(this);
     this.insights = new Insights(this);
+    this.analyst = new Analyst(this);
     this.entityMetrics = new EntityMetrics(this);
     this.marketMood = new MarketMoodResource(this);
     this.marketSummary = new MarketSummaryResource(this);
@@ -567,6 +699,44 @@ var SentiSense = class {
     }
     throw new SentiSenseError("All retries exhausted");
   }
+  /** @internal */
+  async post(path, body) {
+    const url = this.buildUrl(path);
+    const headers = {
+      "Accept": "application/json",
+      "Content-Type": "application/json"
+    };
+    if (this.apiKey) {
+      headers["X-SentiSense-API-Key"] = this.apiKey;
+    }
+    if (typeof process !== "undefined" && process.versions?.node) {
+      headers["User-Agent"] = `sentisense-node/${VERSION}`;
+    }
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), this.timeout);
+    try {
+      const response = await fetch(url, {
+        method: "POST",
+        headers,
+        body: JSON.stringify(body),
+        signal: controller.signal
+      });
+      if (!response.ok) {
+        await this.handleErrorResponse(response);
+      }
+      return await response.json();
+    } catch (error) {
+      if (error instanceof SentiSenseError) throw error;
+      if (error instanceof Error && error.name === "AbortError") {
+        throw new SentiSenseError(`Request timed out after ${this.timeout}ms`);
+      }
+      throw new SentiSenseError(
+        error instanceof Error ? error.message : "Unknown error"
+      );
+    } finally {
+      clearTimeout(timer);
+    }
+  }
   buildUrl(path, params) {
     const url = new URL(path, this.baseUrl);
     if (params) {