@graph8/sdk 0.294.1 → 0.295.2

package/dist/types/version.d.ts

@@ -5,6 +5,6 @@
  * both together (the version-parity gate already pins package.json, the
  * lockfile and the CHANGELOG to each other).
  */
-export declare const SDK_VERSION = "0.294.1";
+export declare const SDK_VERSION = "0.295.2";
 /** Value of the `X-G8-Client` header every SDK request carries (I-13). */
-export declare const SDK_CLIENT_ID = "js-sdk/0.294.1";
+export declare const SDK_CLIENT_ID = "js-sdk/0.295.2";

package/docs/api/dialerAnalytics.d.ts

@@ -37,6 +37,8 @@ export interface DialerAnalyticsOperations {
       start_date?: string | null;
       /** End date (YYYY-MM-DD) */
       end_date?: string | null;
+      /** Viewer's IANA timezone (e.g. Asia/Karachi). start_date/end_date and the daily buckets are read as calendar days in it. Omit for UTC days. */
+      tz?: string | null;
     };
     headers?: {
       "X-Org-Id"?: string | null;
@@ -58,6 +60,8 @@ export interface DialerAnalyticsOperations {
       start_date?: string | null;
       /** End date (YYYY-MM-DD). Defaults to today. */
       end_date?: string | null;
+      /** Viewer's IANA timezone (e.g. Asia/Karachi). start_date/end_date and the daily buckets are read as calendar days in it. Omit for UTC days. */
+      tz?: string | null;
     };
     headers?: {
       "X-Org-Id"?: string | null;
@@ -81,6 +85,8 @@ export interface DialerAnalyticsOperations {
       start_date?: string | null;
       /** End date (YYYY-MM-DD) */
       end_date?: string | null;
+      /** Viewer's IANA timezone (e.g. Asia/Karachi). start_date/end_date and the daily buckets are read as calendar days in it. Omit for UTC days. */
+      tz?: string | null;
     };
     headers?: {
       "X-Org-Id"?: string | null;
@@ -102,6 +108,8 @@ export interface DialerAnalyticsOperations {
       start_date?: string | null;
       /** End date (YYYY-MM-DD) */
       end_date?: string | null;
+      /** Viewer's IANA timezone (e.g. Asia/Karachi). start_date/end_date and the daily buckets are read as calendar days in it. Omit for UTC days. */
+      tz?: string | null;
     };
     headers?: {
       "X-Org-Id"?: string | null;

package/docs/api/dialerAnalytics.md

@@ -54,6 +54,7 @@ If neither is provided, defaults to today.
 | `query.period` | `"today" \| "week" \| "month" \| null` | no | Time period preset (fallback if no dates) |
 | `query.start_date` | `string \| null` | no | Start date (YYYY-MM-DD) |
 | `query.end_date` | `string \| null` | no | End date (YYYY-MM-DD) |
+| `query.tz` | `string \| null` | no | Viewer's IANA timezone (e.g. Asia/Karachi). start_date/end_date and the daily buckets are read as calendar days in it. Omit for UTC days. |
 | `headers.X-Org-Id` | `string \| null` | no |  |
 
 **Returns** `DialerAnalyticsResponse`: the envelope `{ data: Record<string, unknown> | Array<unknown>, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
@@ -86,7 +87,8 @@ yesterday (for trends), daily breakdown, disposition distribution,
 personal bests, and current streak.
 
 Pass `sdr_email` to view another SDR's performance (e.g. as a manager).
-Pass `start_date`/`end_date` for a custom date range.
+Pass `start_date`/`end_date` for a custom date range; personal bests and
+the streak are then measured within that range too.
 
 **Input**
 
@@ -95,6 +97,7 @@ Pass `start_date`/`end_date` for a custom date range.
 | `query.sdr_email` | `string \| null` | no | SDR email to view. Defaults to current user. |
 | `query.start_date` | `string \| null` | no | Start date (YYYY-MM-DD). Defaults to today. |
 | `query.end_date` | `string \| null` | no | End date (YYYY-MM-DD). Defaults to today. |
+| `query.tz` | `string \| null` | no | Viewer's IANA timezone (e.g. Asia/Karachi). start_date/end_date and the daily buckets are read as calendar days in it. Omit for UTC days. |
 | `headers.X-Org-Id` | `string \| null` | no |  |
 
 **Returns** `DialerAnalyticsResponse`: the envelope `{ data: Record<string, unknown> | Array<unknown>, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
@@ -133,6 +136,7 @@ handling, value delivery, closing technique) and a daily quality trend.
 | `query.days` | `integer` | no | Rolling window in days default `30` |
 | `query.start_date` | `string \| null` | no | Start date (YYYY-MM-DD) |
 | `query.end_date` | `string \| null` | no | End date (YYYY-MM-DD) |
+| `query.tz` | `string \| null` | no | Viewer's IANA timezone (e.g. Asia/Karachi). start_date/end_date and the daily buckets are read as calendar days in it. Omit for UTC days. |
 | `headers.X-Org-Id` | `string \| null` | no |  |
 
 **Returns** `DialerAnalyticsResponse`: the envelope `{ data: Record<string, unknown> | Array<unknown>, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
@@ -170,6 +174,7 @@ Used for the leaderboard quality column.
 | `query.days` | `integer` | no | Rolling window in days default `30` |
 | `query.start_date` | `string \| null` | no | Start date (YYYY-MM-DD) |
 | `query.end_date` | `string \| null` | no | End date (YYYY-MM-DD) |
+| `query.tz` | `string \| null` | no | Viewer's IANA timezone (e.g. Asia/Karachi). start_date/end_date and the daily buckets are read as calendar days in it. Omit for UTC days. |
 | `headers.X-Org-Id` | `string \| null` | no |  |
 
 **Returns** `DialerAnalyticsResponse`: the envelope `{ data: Record<string, unknown> | Array<unknown>, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.

package/docs/api/quotes.d.ts

@@ -1251,7 +1251,9 @@ export interface QuoteContactCreateRequest {
  *
  * Mirrors ``CreateQuoteDTO``. At least one of ``signer_contact_id`` or
  * ``signer_email`` is required. ``line_items`` must be non-empty —
- * zero-line quotes can't be invoiced.
+ * zero-line quotes can't be invoiced. ``deal_id`` is required: every new
+ * quote must be linked to an existing deal (422 otherwise); the company
+ * defaults to the deal's company when omitted.
  */
 export interface QuoteCreateRequest {
   accepted_payment_methods?: (Array<"ach" | "credit_card" | "wire">) | null;
@@ -1266,7 +1268,7 @@ export interface QuoteCreateRequest {
   contract_months?: number | null;
   contract_start_date?: string | null;
   currency?: string;
-  deal_id?: string | null;
+  deal_id: string;
   line_items: Array<QuoteLineItemRequest>;
   marketing_rights?: (Array<"logo" | "quote" | "case_study">) | null;
   mashup_company_id?: number | null;

package/docs/api/quotes.md

@@ -354,6 +354,7 @@ Body fields (`QuoteCreateRequest`):
 
 | Field | Type | Required | Description |
 |---|---|---|---|
+| `body.deal_id` | `string` | yes |  |
 | `body.line_items` | `Array<QuoteLineItemRequest>` | yes | min items 1 |
 | `body.title` | `string` | yes | min length 1, max length 500 |
 | `body.accepted_payment_methods` | `Array<"ach" \| "credit_card" \| "wire"> \| null` | no |  |
@@ -368,7 +369,6 @@ Body fields (`QuoteCreateRequest`):
 | `body.contract_months` | `number \| null` | no | min 0.1, max 120 |
 | `body.contract_start_date` | `string \| null` | no |  |
 | `body.currency` | `string` | no | default `"USD"`, min length 3, max length 3 |
-| `body.deal_id` | `string \| null` | no |  |
 | `body.marketing_rights` | `Array<"logo" \| "quote" \| "case_study"> \| null` | no |  |
 | `body.mashup_company_id` | `integer \| null` | no |  |
 | `body.notes` | `string \| null` | no | max length 10000 |
@@ -406,6 +406,7 @@ Other envelope fields: `pagination` (PaginationMeta).
 // external: reaches real people (sends email/SMS, places a call, launches a send); the SDK never blindly retries it; confirm with a human first.
 const result = await g8.api.quotes.createQuote({
   body: {
+    deal_id: "id",
     line_items: [{ product_name: "Example", unit_amount: 0 }],
     title: "Example",
   },

package/docs/api/scraping.d.ts

@@ -261,7 +261,7 @@ export interface SubmitScrapeRequest {
   requirement: string;
   /** Re-run rows that already have a result. */
   rescrape?: boolean;
-  /** Limit the run to these rows. */
+  /** Limit the run to these rows. Omit it to run every row; an empty list is rejected. */
   row_ids?: Array<number> | null;
   /** Cold start: add these as rows in `source_column` before scraping. */
   seed_targets?: Array<string> | null;

package/docs/api/scraping.md

@@ -327,7 +327,7 @@ Body fields (`SubmitScrapeRequest`):
 | `body.params` | `Record<string, unknown>` | no |  |
 | `body.preview` | `boolean` | no | Hold the run behind a 5-row preview. Leave it on for a first run. default `true` |
 | `body.rescrape` | `boolean` | no | Re-run rows that already have a result. default `false` |
-| `body.row_ids` | `Array<integer> \| null` | no | Limit the run to these rows. |
+| `body.row_ids` | `Array<integer> \| null` | no | Limit the run to these rows. Omit it to run every row; an empty list is rejected. |
 | `body.seed_targets` | `Array<string> \| null` | no | Cold start: add these as rows in `source_column` before scraping. |
 | `body.source_column` | `string \| null` | no | Column holding the values to scrape from. |
 | `body.staging_table_id` | `string \| null` | no | Staging table to read from and write into. |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@graph8/sdk",
-  "version": "0.294.1",
+  "version": "0.295.2",
   "description": "graph8 SDK - CRM, enrichment, sequences, campaigns, and tracking for B2B",
   "license": "MIT",
   "author": "graph8 <support@graph8.com> (https://graph8.com)",