@graph8/sdk 0.294.0 → 0.295.1

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.0";
+export declare const SDK_VERSION = "0.295.1";
 /** Value of the `X-G8-Client` header every SDK request carries (I-13). */
-export declare const SDK_CLIENT_ID = "js-sdk/0.294.0";
+export declare const SDK_CLIENT_ID = "js-sdk/0.295.1";

package/docs/api/appointments.md

@@ -598,7 +598,7 @@ Body fields (`CreateEventTypeRequest`):
 
 | Field | Type | Required | Description |
 |---|---|---|---|
-| `body.length` | `integer` | yes |  |
+| `body.length` | `integer` | yes | min 5, max 525600 |
 | `body.slug` | `string` | yes |  |
 | `body.title` | `string` | yes |  |
 | `body.after_event_buffer` | `integer` | no | default `0` |
@@ -636,7 +636,7 @@ Body fields (`CreateEventTypeRequest`):
 **Example**
 
 ```ts
-const result = await g8.api.appointments.createEventType({ body: { length: 1, slug: "example", title: "Example" } });
+const result = await g8.api.appointments.createEventType({ body: { length: 5, slug: "example", title: "Example" } });
 ```
 
 ---
@@ -3335,7 +3335,7 @@ Body fields (`UpdateEventTypeRequest`):
 | `body.event_name` | `string \| null` | no |  |
 | `body.hidden` | `boolean \| null` | no |  |
 | `body.layouts` | `Array<string> \| null` | no |  |
-| `body.length` | `integer \| null` | no |  |
+| `body.length` | `integer \| null` | no | min 5, max 525600 |
 | `body.locations` | `Array<Record<string, unknown>> \| null` | no |  |
 | `body.metadata` | `Record<string, unknown> \| null` | no |  |
 | `body.minimum_booking_notice` | `integer \| null` | no |  |

package/docs/api/quotes.d.ts

@@ -379,7 +379,6 @@ export interface QuotesOperations {
   get_company_revenue_summary_stripe_companies__company_id__revenue_summary_get: {
     input: {
     path: {
-      /** graph8 company id. */
       company_id: number;
     };
     headers?: {
@@ -396,7 +395,6 @@ export interface QuotesOperations {
   get_company_stripe_invoices_stripe_companies__company_id__invoices_get: {
     input: {
     path: {
-      /** graph8 company id. */
       company_id: number;
     };
     query?: {
@@ -418,7 +416,6 @@ export interface QuotesOperations {
   get_company_stripe_subscriptions_stripe_companies__company_id__subscriptions_get: {
     input: {
     path: {
-      /** graph8 company id. */
       company_id: number;
     };
     headers?: {
@@ -1254,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;
@@ -1269,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",
   },
@@ -898,7 +899,7 @@ Total paid, MRR, invoice count and customer-since date for one company.
 
 | Field | Type | Required | Description |
 |---|---|---|---|
-| `path.company_id` | `integer` | yes | graph8 company id. |
+| `path.company_id` | `integer` | yes |  |
 
 **Returns** `ApiResponse_BillingPayload_`: the envelope `{ data: BillingPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
 
@@ -929,7 +930,7 @@ A company's Stripe invoice history, newest first.
 
 | Field | Type | Required | Description |
 |---|---|---|---|
-| `path.company_id` | `integer` | yes | graph8 company id. |
+| `path.company_id` | `integer` | yes |  |
 | `query.page` | `integer` | no | 1-based page. default `1` |
 | `query.limit` | `integer` | no | default `50` |
 
@@ -968,7 +969,7 @@ A company's current Stripe subscriptions, through its customer mapping.
 
 | Field | Type | Required | Description |
 |---|---|---|---|
-| `path.company_id` | `integer` | yes | graph8 company id. |
+| `path.company_id` | `integer` | yes |  |
 
 **Returns** `ApiResponse_BillingListPayload_`: the envelope `{ data: BillingListPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
 

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.0",
+  "version": "0.295.1",
   "description": "graph8 SDK - CRM, enrichment, sequences, campaigns, and tracking for B2B",
   "license": "MIT",
   "author": "graph8 <support@graph8.com> (https://graph8.com)",