@graph8/sdk 0.14.0 → 0.16.0

package/dist/index.mjs

@@ -846,6 +846,8 @@ var KNOWN_WEBHOOK_EVENTS = [
   "engagement.email_bounced",
   "engagement.email_skipped",
   "engagement.call_dispatched",
+  "engagement.call_connected",
+  "engagement.call_graded",
   "engagement.sms_sent",
   "engagement.sms_replied",
   "engagement.whatsapp_sent",
@@ -856,7 +858,12 @@ var KNOWN_WEBHOOK_EVENTS = [
   "engagement.linkedin_connection_accepted",
   "meeting.booked",
   "meeting.cancelled",
-  "meeting.rescheduled"
+  "meeting.rescheduled",
+  "deal.won",
+  "crm.record.created",
+  "crm.record.updated",
+  "crm.record.archived",
+  "crm.record.restored"
 ];
 var WebhookSignatureError = class extends Error {
   constructor(message) {
@@ -1541,8 +1548,32 @@ var createObjectsClient = (apiKey, apiUrl) => {
   const encode = (value) => encodeURIComponent(value);
   return {
     /** List the custom object types in your workspace. */
-    async list() {
-      return request(baseUrl, "/api/v1/objects", apiKey);
+    async list(params = {}) {
+      const query = params.include_archived ? "?include_archived=true" : "";
+      return request(baseUrl, `/api/v1/objects${query}`, apiKey);
+    },
+    /** Create a native custom object. Requires objects:manage and Admin access. */
+    async create(input) {
+      const resp = await request(baseUrl, "/api/v1/objects", apiKey, {
+        method: "POST",
+        body: input
+      });
+      return resp.data;
+    },
+    /** Rename, archive or restore an object while preserving its slug and data. */
+    async update(objectSlug, input) {
+      const resp = await request(baseUrl, `/api/v1/objects/${encode(objectSlug)}`, apiKey, {
+        method: "PATCH",
+        body: input
+      });
+      return resp.data;
+    },
+    /** Archive the object without deleting records; restore with update({ is_archived: false }). */
+    async archive(objectSlug) {
+      const resp = await request(baseUrl, `/api/v1/objects/${encode(objectSlug)}`, apiKey, {
+        method: "DELETE"
+      });
+      return resp.data;
     },
     /** Fetch one object type by slug. */
     async get(objectSlug) {
@@ -1554,10 +1585,35 @@ var createObjectsClient = (apiKey, apiUrl) => {
       return resp.data ?? resp;
     },
     /** The object's attributes — the schema its records must satisfy. */
-    async listAttributes(objectSlug) {
-      return request(baseUrl, `/api/v1/objects/${encode(objectSlug)}/attributes`, apiKey);
+    async listAttributes(objectSlug, params = {}) {
+      const query = params.include_archived ? "?include_archived=true" : "";
+      return request(baseUrl, `/api/v1/objects/${encode(objectSlug)}/attributes${query}`, apiKey);
     },
-    /** Paginated records with their current values. Archived records are excluded. */
+    /** Create a field using the same schema rules as the customer UI. */
+    async createAttribute(objectSlug, input) {
+      const resp = await request(baseUrl, `/api/v1/objects/${encode(objectSlug)}/attributes`, apiKey, {
+        method: "POST",
+        body: input
+      });
+      return resp.data;
+    },
+    /** Edit or restore a field; its type and slug are immutable. */
+    async updateAttribute(objectSlug, attributeSlug, input) {
+      const resp = await request(baseUrl, `/api/v1/objects/${encode(objectSlug)}/attributes/${encode(attributeSlug)}`, apiKey, {
+        method: "PATCH",
+        body: input
+      });
+      return resp.data;
+    },
+    /** Archive without deleting values; restore with updateAttribute({ is_archived: false }). */
+    async archiveAttribute(objectSlug, attributeSlug) {
+      const resp = await request(baseUrl, `/api/v1/objects/${encode(objectSlug)}/attributes/${encode(attributeSlug)}`, apiKey, {
+        method: "DELETE"
+      });
+      return resp.data;
+    },
+    /** Paginated custom records or canonical deals with current values and revisions.
+     * Deal totals and related references respect current record access. */
     async listRecords(objectSlug, params = {}) {
       const query = {};
       if (params.page != null) query.page = params.page;
@@ -1581,7 +1637,24 @@ var createObjectsClient = (apiKey, apiUrl) => {
       );
       return resp.data ?? resp;
     },
-    /** Fetch one record with its currently active values. */
+    /** Match a unique single-value key, creating or updating while preserving omitted fields. */
+    async upsertRecord(objectSlug, matchingAttribute, values, options = {}) {
+      const resp = await request(
+        baseUrl,
+        `/api/v1/objects/${encode(objectSlug)}/records/upsert`,
+        apiKey,
+        { method: "POST", body: {
+          matching_attribute: matchingAttribute,
+          values,
+          ...options.expectedRevision !== void 0 ? { expected_revision: options.expectedRevision } : {}
+        } }
+      );
+      return resp.data;
+    },
+    /** Fetch one custom record, canonical contact/company, or deal by its stable graph8 ID.
+     * Deals retain their UUIDs and expose company, primary-contact and contact_ids references only
+     * when permitted. Generic deal mutations are not yet supported.
+     */
     async getRecord(objectSlug, recordId) {
       const resp = await request(
         baseUrl,
@@ -1595,15 +1668,24 @@ var createObjectsClient = (apiKey, apiUrl) => {
      * required attributes you omit are left alone rather than reported missing.
      * Sending an explicit `null` CLEARS that attribute.
      *
-     * Values are versioned rather than overwritten, so the previous value stays
-     * readable through `history`.
+     * Custom values retain generations through `history`. Canonical contacts and
+     * companies require expectedRevision from a fresh read and expose recorded
+     * mutations through `changes`. They do not yet support appendValues/removeValues.
      */
     async updateRecord(objectSlug, recordId, values, options) {
       const resp = await request(
         baseUrl,
         `/api/v1/objects/${encode(objectSlug)}/records/${encode(recordId)}`,
         apiKey,
-        { method: "PATCH", body: { values, ...options?.expectedRevision === void 0 ? {} : { expected_revision: options.expectedRevision } } }
+        {
+          method: "PATCH",
+          body: {
+            values,
+            ...options?.expectedRevision === void 0 ? {} : { expected_revision: options.expectedRevision },
+            ...options?.appendValues === void 0 ? {} : { append_values: options.appendValues },
+            ...options?.removeValues === void 0 ? {} : { remove_values: options.removeValues }
+          }
+        }
       );
       return resp.data ?? resp;
     },
@@ -1642,6 +1724,19 @@ var createObjectsClient = (apiKey, apiUrl) => {
         { query: limit != null ? { limit } : void 0 }
       );
       return resp.data ?? resp;
+    },
+    /** Recorded custom-record or canonical contact/company mutations. Pass next_cursor to continue.
+     * Canonical history respects current access/privacy; archived records and older
+     * unrecorded writes are not reconstructed. Store unavailability returns 503.
+     */
+    async changes(objectSlug, recordId, options = {}) {
+      const resp = await request(
+        baseUrl,
+        `/api/v1/objects/${encode(objectSlug)}/records/${encode(recordId)}/changes`,
+        apiKey,
+        { query: options }
+      );
+      return resp.data ?? resp;
     }
   };
 };