@graph8/sdk 0.262.0 → 0.264.0

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

package/docs/api/clickHouse.d.ts

@@ -65,7 +65,7 @@ export interface ClickhouseMashupRequest {
   limit?: number;
   /** Which mashup PK to filter by. */
   mode: "by_upid" | "by_hem" | "by_domain";
-  /** Which mashup table to read. 'joined' returns the lighter denormalized mashup_new with both profiles partially populated. */
+  /** Which mashup table to read. 'joined' returns the denormalized contact+company record from the current mashup build (mashup.v3_enriched_for_os); by_domain mode only. */
   profile?: "b2b" | "b2c" | "joined";
   /** Up to 100 key values (UP_IDs, HEMs, or domains). */
   values: Array<string>;

package/docs/api/clickHouse.md

@@ -58,7 +58,7 @@ Body fields (`ClickhouseMashupRequest`):
 | `body.mode` | `"by_upid" \| "by_hem" \| "by_domain"` | yes | Which mashup PK to filter by. |
 | `body.values` | `Array<string>` | yes | Up to 100 key values (UP_IDs, HEMs, or domains). min items 1, max items 100 |
 | `body.limit` | `integer` | no | default `1000`, min 1, max 1000 |
-| `body.profile` | `"b2b" \| "b2c" \| "joined"` | no | Which mashup table to read. 'joined' returns the lighter denormalized mashup_new with both profiles partially populated. default `"b2b"` |
+| `body.profile` | `"b2b" \| "b2c" \| "joined"` | no | Which mashup table to read. 'joined' returns the denormalized contact+company record from the current mashup build (mashup.v3_enriched_for_os); by_domain mode only. default `"b2b"` |
 
 **Returns** `ApiResponse_ClickhouseMashupResponse_`: the envelope `{ data: ClickhouseMashupResponse, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
 

package/docs/api/webhooks.d.ts

@@ -203,6 +203,8 @@ export interface PaginationMeta {
 export interface WebhookCreateRequest {
   /** Event types to subscribe to */
   events: Array<string>;
+  /** Per-object field filter for crm.record.updated: {object_slug: [field_slug]}. When set for an object, an update delivery fires only if a watched field's value changed. Omit or leave empty to fire on any change. Ignored for events other than crm.record.updated. */
+  field_filters?: Record<string, Array<string>> | null;
   /** Human-readable name */
   name?: string | null;
   /** Target URL for webhook delivery */
@@ -230,6 +232,8 @@ export interface WebhookEventResponse {
 export interface WebhookResponse {
   created_at?: string | null;
   events?: Array<string>;
+  /** Per-object field filter for crm.record.updated: {object_slug: [field_slug]}. When set for an object, an update delivery fires only if a watched field's value changed. Omit or leave empty to fire on any change. Ignored for events other than crm.record.updated. */
+  field_filters?: Record<string, Array<string>> | null;
   id: string;
   is_active?: boolean;
   name?: string | null;
@@ -242,6 +246,8 @@ export interface WebhookResponse {
 export interface WebhookUpdateRequest {
   /** Event types to subscribe to */
   events?: Array<string> | null;
+  /** Per-object field filter for crm.record.updated: {object_slug: [field_slug]}. When set for an object, an update delivery fires only if a watched field's value changed. Omit or leave empty to fire on any change. Ignored for events other than crm.record.updated. */
+  field_filters?: Record<string, Array<string>> | null;
   /** Whether the webhook is active */
   is_active?: boolean | null;
   /** Human-readable name */

package/docs/api/webhooks.md

@@ -58,6 +58,7 @@ Body fields (`WebhookCreateRequest`):
 |---|---|---|---|
 | `body.events` | `Array<string>` | yes | Event types to subscribe to |
 | `body.url` | `string` | yes | Target URL for webhook delivery |
+| `body.field_filters` | `Record<string, Array<string>> \| null` | no | Per-object field filter for crm.record.updated: {object_slug: [field_slug]}. When set for an object, an update delivery fires only if a watched field's value changed. Omit or leave empty to fire on any change. Ignored for events other than crm.record.updated. |
 | `body.name` | `string \| null` | no | Human-readable name |
 
 **Returns** `ApiResponse_WebhookResponse_`: the envelope `{ data: WebhookResponse, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
@@ -72,6 +73,7 @@ Other envelope fields: `pagination` (PaginationMeta).
 | `url` | `string` | yes |  |
 | `created_at` | `string \| null` | no |  |
 | `events` | `Array<string>` | no | default `[]` |
+| `field_filters` | `Record<string, Array<string>> \| null` | no | Per-object field filter for crm.record.updated: {object_slug: [field_slug]}. When set for an object, an update delivery fires only if a watched field's value changed. Omit or leave empty to fire on any change. Ignored for events other than crm.record.updated. |
 | `is_active` | `boolean` | no | default `true` |
 | `name` | `string \| null` | no |  |
 | `secret` | `string \| null` | no | Only returned on create and rotate-secret |
@@ -147,6 +149,7 @@ Other envelope fields: `pagination` (PaginationMeta).
 | `url` | `string` | yes |  |
 | `created_at` | `string \| null` | no |  |
 | `events` | `Array<string>` | no | default `[]` |
+| `field_filters` | `Record<string, Array<string>> \| null` | no | Per-object field filter for crm.record.updated: {object_slug: [field_slug]}. When set for an object, an update delivery fires only if a watched field's value changed. Omit or leave empty to fire on any change. Ignored for events other than crm.record.updated. |
 | `is_active` | `boolean` | no | default `true` |
 | `name` | `string \| null` | no |  |
 | `secret` | `string \| null` | no | Only returned on create and rotate-secret |
@@ -274,6 +277,7 @@ Other envelope fields: `pagination` (PaginationMeta).
 | `url` | `string` | yes |  |
 | `created_at` | `string \| null` | no |  |
 | `events` | `Array<string>` | no | default `[]` |
+| `field_filters` | `Record<string, Array<string>> \| null` | no | Per-object field filter for crm.record.updated: {object_slug: [field_slug]}. When set for an object, an update delivery fires only if a watched field's value changed. Omit or leave empty to fire on any change. Ignored for events other than crm.record.updated. |
 | `is_active` | `boolean` | no | default `true` |
 | `name` | `string \| null` | no |  |
 | `secret` | `string \| null` | no | Only returned on create and rotate-secret |
@@ -318,6 +322,7 @@ Other envelope fields: `pagination` (PaginationMeta).
 | `url` | `string` | yes |  |
 | `created_at` | `string \| null` | no |  |
 | `events` | `Array<string>` | no | default `[]` |
+| `field_filters` | `Record<string, Array<string>> \| null` | no | Per-object field filter for crm.record.updated: {object_slug: [field_slug]}. When set for an object, an update delivery fires only if a watched field's value changed. Omit or leave empty to fire on any change. Ignored for events other than crm.record.updated. |
 | `is_active` | `boolean` | no | default `true` |
 | `name` | `string \| null` | no |  |
 | `secret` | `string \| null` | no | Only returned on create and rotate-secret |
@@ -357,6 +362,7 @@ Body fields (`WebhookUpdateRequest`):
 | Field | Type | Required | Description |
 |---|---|---|---|
 | `body.events` | `Array<string> \| null` | no | Event types to subscribe to |
+| `body.field_filters` | `Record<string, Array<string>> \| null` | no | Per-object field filter for crm.record.updated: {object_slug: [field_slug]}. When set for an object, an update delivery fires only if a watched field's value changed. Omit or leave empty to fire on any change. Ignored for events other than crm.record.updated. |
 | `body.is_active` | `boolean \| null` | no | Whether the webhook is active |
 | `body.name` | `string \| null` | no | Human-readable name |
 | `body.url` | `string \| null` | no | Target URL for webhook delivery |
@@ -373,6 +379,7 @@ Other envelope fields: `pagination` (PaginationMeta).
 | `url` | `string` | yes |  |
 | `created_at` | `string \| null` | no |  |
 | `events` | `Array<string>` | no | default `[]` |
+| `field_filters` | `Record<string, Array<string>> \| null` | no | Per-object field filter for crm.record.updated: {object_slug: [field_slug]}. When set for an object, an update delivery fires only if a watched field's value changed. Omit or leave empty to fire on any change. Ignored for events other than crm.record.updated. |
 | `is_active` | `boolean` | no | default `true` |
 | `name` | `string \| null` | no |  |
 | `secret` | `string \| null` | no | Only returned on create and rotate-secret |

package/package.json

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