featurebase-node 0.14.1 → 0.14.2

package/src/resources/reports.ts

@@ -65,10 +65,13 @@ export class Reports extends APIResource {
    *
    * 1. Pick a `metric` and `aggregation` from the datasets catalog
    *    (`GET /v2/reports/datasets`). Counts use `count`; duration metrics support
-   *    `avg`, `median`, `min`, `max` and `percentile` (pass `percentile: 95` for
-   *    p95); rate metrics use `value`.
+   *    `sum`, `avg`, `median`, `min`, `max`, `range` and `percentile` (pass
+   *    `percentile: 95` for p95); rate metrics use `value`.
    * 2. Set the reporting window with `startDate` / `endDate` (ISO 8601) and a
    *    `granularity` (`hour`, `day`, `week`, `month`) for the returned time series.
+   *    Reporting data is available from **July 12, 2026**. Windows ending earlier
+   *    are rejected; crossing windows are clamped to that boundary in the requested
+   *    timezone.
    * 3. Optionally narrow with `filters` — a rule
    *    (`{ "kind": "rule", "fieldId": "...", "operator": "in", "value": [...] }`) or
    *    an `and`/`or` group of rules. Attribute IDs and allowed operators come from
@@ -84,8 +87,8 @@ export class Reports extends APIResource {
    * {
    *   "metric": "new_conversations",
    *   "aggregation": "count",
-   *   "startDate": "2026-06-01",
-   *   "endDate": "2026-06-30",
+   *   "startDate": "2026-07-12",
+   *   "endDate": "2026-07-15",
    *   "granularity": "day",
    *   "groupBy": "conversation.channel",
    *   "filters": {
@@ -121,10 +124,10 @@ export class Reports extends APIResource {
    * ```ts
    * const response = await client.reports.query({
    *   aggregation: 'count',
-   *   endDate: '2026-06-30',
+   *   endDate: '2026-07-15',
    *   granularity: 'day',
    *   metric: 'new_conversations',
-   *   startDate: '2026-06-01',
+   *   startDate: '2026-07-12',
    * });
    * ```
    */
@@ -275,6 +278,12 @@ export interface ReportAttribute {
 
   name: string;
 
+  /**
+   * Whether the filter uses the latest mutable state, an immutable historical
+   * action/snapshot, or a metric-dependent mapping.
+   */
+  semantics: 'current_state' | 'historical_action' | 'historical_snapshot' | 'dynamic_metric_mapped';
+
   /**
    * Whether the attribute can be used in `filters` rules.
    */
@@ -405,12 +414,24 @@ export interface ReportMetric {
    */
   id: string;
 
-  allowedAggregations: Array<'count' | 'sum' | 'avg' | 'median' | 'min' | 'max' | 'percentile' | 'value'>;
+  allowedAggregations: Array<
+    'count' | 'sum' | 'avg' | 'median' | 'min' | 'max' | 'range' | 'percentile' | 'value'
+  >;
 
   description: string;
 
   name: string;
 
+  /**
+   * Attribute IDs this specific metric accepts in filter expressions.
+   */
+  supportedFilterAttributeIds: Array<string>;
+
+  /**
+   * Attribute IDs this specific metric accepts as `groupBy` or `segmentBy`.
+   */
+  supportedGroupByDimensions: Array<string>;
+
   /**
    * Which `view` values `POST /v2/reports/query` accepts for this metric. Most
    * metrics support `standard` and `hourly_heatmap`; conversation-flow metrics are
@@ -555,6 +576,8 @@ export interface ReportQueryResponse {
 
   segmentData?: Array<ReportSegmentDatum>;
 
+  table?: ReportQueryResponse.Table;
+
   timeSeries?: Array<ReportTimeSeriesDatum>;
 }
 
@@ -565,7 +588,7 @@ export namespace ReportQueryResponse {
      * aggregations — see the `allowedAggregations` field in the
      * `GET /v2/reports/datasets` catalog.
      */
-    aggregation: 'count' | 'sum' | 'avg' | 'median' | 'min' | 'max' | 'percentile' | 'value';
+    aggregation: 'count' | 'sum' | 'avg' | 'median' | 'min' | 'max' | 'range' | 'percentile' | 'value';
 
     datasetId: string;
 
@@ -603,6 +626,98 @@ export namespace ReportQueryResponse {
 
     sortOrder?: number;
   }
+
+  export interface Table {
+    columns: Array<Table.Column>;
+
+    key: string;
+
+    mode: 'aggregate' | 'records';
+
+    page: number;
+
+    pageSize: number;
+
+    rows: Array<Table.Row>;
+
+    totalRows: number;
+
+    sort?: Table.Sort;
+
+    summaryRows?: Array<Table.SummaryRow>;
+  }
+
+  export namespace Table {
+    export interface Column {
+      id: string;
+
+      kind: 'dimension' | 'metric' | 'record_attribute';
+
+      label: string;
+
+      sortable: boolean;
+
+      unit: 'count' | 'percentage' | 'duration_ms' | 'number' | 'text' | 'datetime';
+
+      align?: 'left' | 'right';
+
+      sticky?: boolean;
+
+      summary?: 'sum' | 'weighted_rate' | 'none';
+
+      valueType?: string;
+    }
+
+    export interface Row {
+      id: string;
+
+      cells: { [key: string]: Row.Cells };
+    }
+
+    export namespace Row {
+      export interface Cells {
+        display: string;
+
+        denominator?: number;
+
+        numerator?: number;
+
+        raw?: unknown;
+
+        sortValue?: string | number | null;
+
+        value?: unknown;
+      }
+    }
+
+    export interface Sort {
+      columnId: string;
+
+      direction: 'asc' | 'desc';
+    }
+
+    export interface SummaryRow {
+      id: string;
+
+      cells: { [key: string]: SummaryRow.Cells };
+    }
+
+    export namespace SummaryRow {
+      export interface Cells {
+        display: string;
+
+        denominator?: number;
+
+        numerator?: number;
+
+        raw?: unknown;
+
+        sortValue?: string | number | null;
+
+        value?: unknown;
+      }
+    }
+  }
 }
 
 export interface ReportListDatasetsParams {
@@ -619,10 +734,11 @@ export interface ReportQueryParams {
    * subset of aggregations — see the `allowedAggregations` field in the
    * `GET /v2/reports/datasets` catalog.
    */
-  aggregation: 'count' | 'sum' | 'avg' | 'median' | 'min' | 'max' | 'percentile' | 'value';
+  aggregation: 'count' | 'sum' | 'avg' | 'median' | 'min' | 'max' | 'range' | 'percentile' | 'value';
 
   /**
    * Body param: End of the reporting window (ISO 8601 date or datetime, inclusive).
+   * Windows ending before 2026-07-12 are rejected.
    */
   endDate: string;
 
@@ -639,7 +755,8 @@ export interface ReportQueryParams {
 
   /**
    * Body param: Start of the reporting window (ISO 8601 date or datetime,
-   * inclusive).
+   * inclusive). Reporting data is available from 2026-07-12; crossing windows are
+   * clamped to that boundary.
    */
   startDate: string;
 

package/src/resources/users/contacts/contacts.ts

@@ -140,7 +140,7 @@ export class Contacts extends APIResource {
    * | `subscribedToChangelog` | boolean | No                  | Whether subscribed to changelog         |
    * | `locale`                | string  | No                  | Contact locale/language                 |
    * | `phone`                 | string  | No                  | Contact phone number                    |
-   * | `roles`                 | array   | No                  | Role IDs to assign                      |
+   * | `roles`                 | array   | No                  | Role (User Tag) names to assign         |
    * | `userHash`              | string  | No                  | HMAC hash for identity verification     |
    * | `createdAt`             | string  | No                  | When the contact was created (ISO 8601) |
    *
@@ -994,7 +994,7 @@ export interface ContactCreateOrUpdateParams {
   profilePicture?: string | null;
 
   /**
-   * Body param: Array of role IDs to assign to the contact
+   * Body param: Array of role (User Tag) names to assign to the contact
    */
   roles?: Array<string>;
 

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = '0.14.1'; // x-release-please-version
+export const VERSION = '0.14.2'; // x-release-please-version

package/version.d.mts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.14.1";
+export declare const VERSION = "0.14.2";
 //# sourceMappingURL=version.d.mts.map

package/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.14.1";
+export declare const VERSION = "0.14.2";
 //# sourceMappingURL=version.d.ts.map

package/version.js

@@ -1,5 +1,5 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.VERSION = void 0;
-exports.VERSION = '0.14.1'; // x-release-please-version
+exports.VERSION = '0.14.2'; // x-release-please-version
 //# sourceMappingURL=version.js.map

package/version.mjs

@@ -1,2 +1,2 @@
-export const VERSION = '0.14.1'; // x-release-please-version
+export const VERSION = '0.14.2'; // x-release-please-version
 //# sourceMappingURL=version.mjs.map