sentisense 0.53.0 → 0.55.0

package/dist/index.mjs

@@ -33,6 +33,13 @@ var RateLimitError = class extends SentiSenseError {
     this.retryAfter = retryAfter;
   }
 };
+var TemporarilyUnavailableError = class extends SentiSenseError {
+  constructor(message, retryAfter, code) {
+    super(message, 503, code);
+    this.name = "TemporarilyUnavailableError";
+    this.retryAfter = retryAfter;
+  }
+};
 var APIError = class extends SentiSenseError {
   constructor(message, status, code) {
     super(message, status, code);
@@ -54,6 +61,38 @@ var Analyst = class {
       `/api/v1/analyst/${encodeURIComponent(ticker.toUpperCase())}/consensus`
     );
   }
+  /**
+   * Get daily consensus observations, ordered by `snapshotDate` ascending.
+   * Each row describes the target fields as observed on that date. When
+   * `countsObserved` is `false`, the vendor panel did not come back that day and the
+   * distribution counts are carried forward.
+   *
+   * A PRO key receives the requested window. A FREE key receives the last 30 days;
+   * `targetMedian`, `recommendationMean`, and the five distribution fields are `null`.
+   * The envelope's `totalCount` still sizes the full requested window.
+   */
+  async consensusHistory(ticker, options) {
+    return this.client.get(
+      `/api/v1/analyst/${encodeURIComponent(ticker.toUpperCase())}/consensus/history`,
+      options
+    );
+  }
+  /**
+   * Get factual call history as recorded when a stock moved 20% or more over five
+   * sessions, newest move first by `moveEndDate`.
+   *
+   * PRO receives full moves and calls. FREE receives the newest move with up to five
+   * calls and all move-level counts intact. The envelope's `totalCount` counts all
+   * available moves before the limit. A known stock with no qualifying move returns
+   * an empty `moves` array. Each call includes `analystName`: it is `null`, never
+   * absent, when the publisher named nobody.
+   */
+  async calledIt(ticker, options) {
+    return this.client.get(
+      `/api/v1/analyst/${encodeURIComponent(ticker.toUpperCase())}/called-it`,
+      options
+    );
+  }
   /**
    * Get recent analyst upgrade/downgrade actions for a ticker, newest first.
    * Free users receive the 3 most recent.
@@ -286,6 +325,52 @@ var Earnings = class {
   async getRecent(options) {
     return this.client.get("/api/v1/earnings/recent", options);
   }
+  /**
+   * Measured price reactions to a ticker's last earnings reports, newest first.
+   *
+   * Use this after {@link getRecent} when you need one company's realized
+   * post-report history. `client.calendar.getEarnings()` is the forward-looking
+   * schedule instead. This endpoint returns its payload directly, without a
+   * preview envelope, and every API key receives the full series.
+   *
+   * `timing` is always present on each row and can be `null` when the reacting
+   * session was inferred rather than observed.
+   */
+  async getReactions(ticker) {
+    return this.client.get(
+      `/api/v1/stocks/${encodeURIComponent(ticker.toUpperCase())}/earnings/reactions`
+    );
+  }
+  /**
+   * Market-wide earnings outcomes and realized reaction statistics.
+   *
+   * Use this for aggregate beat, miss, inline, and post-report move rates.
+   * {@link getRecent} returns individual recent reports, while
+   * `client.calendar.getEarnings()` covers upcoming dates. The response uses
+   * the preview envelope, but every API key receives the full body and
+   * `isPreview` is always `false`.
+   *
+   * `baseline` and `deviation` are omitted for long-span windows, and rates can
+   * be `null` when their denominator is zero.
+   */
+  async getStatistics(options) {
+    return this.client.get("/api/v1/earnings/statistics", options);
+  }
+  /**
+   * Important recently reported and upcoming earnings in one ranking.
+   *
+   * Use this to prioritize a cross-ticker sweep. Follow reported rows with
+   * {@link getReactions} for realized history; use {@link getRecent} for an
+   * unranked recent feed or `client.calendar.getEarnings()` for the broader
+   * forward schedule.
+   *
+   * A PRO key receives the full ranking. A FREE key receives the first three
+   * rows in each section with `totalInWindow` left intact. Optional row fields
+   * are omitted when null, so check them before use.
+   */
+  async getRanked(options) {
+    return this.client.get("/api/v1/earnings/ranked", options);
+  }
 };
 
 // src/resources/entityMetrics.ts
@@ -1014,7 +1099,7 @@ var Stocks = class {
    * 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.
+   * (900+ tickers). Use `listKpiCoverage()` to enumerate.
    */
   async getKpis(ticker) {
     return this.client.get(
@@ -1215,7 +1300,7 @@ var Trackers = class {
 };
 
 // src/version.ts
-var VERSION = "0.53.0";
+var VERSION = "0.55.0";
 
 // src/client.ts
 var DEFAULT_BASE_URL = "https://app.sentisense.ai";
@@ -1314,12 +1399,23 @@ var SentiSense = class {
         if (!response.ok) {
           const isRetryable = response.status === 429 || response.status >= 500;
           if (isRetryable && attempt < this.maxRetries) {
-            if (response.status === 429) {
-              delayMs = retryAfterSeconds(
+            if (response.status === 429 || response.status === 503) {
+              const requestedS = retryAfterSeconds(
                 response.headers.get("Retry-After"),
                 RATE_LIMIT_FALLBACK_WAIT_S,
-                MAX_RATE_LIMIT_WAIT_S
-              ) * 1e3;
+                Number.POSITIVE_INFINITY
+              );
+              if (requestedS > MAX_RATE_LIMIT_WAIT_S) {
+                try {
+                  await response.body?.cancel();
+                } catch {
+                }
+                throw new TemporarilyUnavailableError(
+                  `Server asked for a ${Math.round(requestedS)}s wait, longer than this client's ${MAX_RATE_LIMIT_WAIT_S}s budget`,
+                  requestedS
+                );
+              }
+              delayMs = requestedS * 1e3;
             } else {
               delayMs = Math.min(BASE_DELAY_MS * Math.pow(2, attempt), MAX_DELAY_MS) + Math.random() * 1e3;
             }
@@ -1429,6 +1525,7 @@ export {
   RateLimitError,
   SentiSense,
   SentiSenseError,
+  TemporarilyUnavailableError,
   VERSION,
   SentiSense as default
 };