@graph8/sdk 0.7.1 → 0.7.2

package/dist/index.mjs

@@ -468,21 +468,30 @@ var createSequencesClient = (apiKey, apiUrl) => {
         query: params
       });
     },
-    /** Add contacts to a sequence (V2 queuing). Live or drafted sequences only. */
-    async add(config) {
+    /**
+     * Add contacts to a sequence (V2 queuing). Live or drafted sequences only.
+     * Pass `idempotencyKey` to make a retry safe — the same key returns the
+     * first result instead of re-enrolling on a 5xx-then-success (A6).
+     */
+    async add(config, idempotencyKey) {
       const resp = await request(
         baseUrl,
         `/api/v1/sequences/${config.sequenceId}/contacts`,
         apiKey,
-        { method: "POST", body: { contact_ids: config.contactIds, list_id: config.listId } }
+        { method: "POST", body: { contact_ids: config.contactIds, list_id: config.listId }, idempotencyKey }
       );
       return resp.data ?? resp;
     },
-    /** Create a new sequence with optional steps + channels. */
-    async create(payload) {
+    /**
+     * Create a new sequence with optional steps + channels. Pass `idempotencyKey`
+     * to make a retry safe — the same key returns the first result instead of
+     * creating a duplicate sequence on a 5xx-then-success (A6).
+     */
+    async create(payload, idempotencyKey) {
       const resp = await request(baseUrl, "/api/v1/sequences", apiKey, {
         method: "POST",
-        body: payload
+        body: payload,
+        idempotencyKey
       });
       return resp.data ?? resp;
     },
@@ -511,33 +520,43 @@ var createSequencesClient = (apiKey, apiUrl) => {
       });
       return resp.data ?? resp;
     },
-    /** Run/start a DRAFTED sequence (V2 orchestration). */
-    async run(sequenceId) {
+    /**
+     * Run/start a DRAFTED sequence (V2 orchestration). Pass `idempotencyKey` to
+     * make a retry safe — the same key won't re-trigger the run on a
+     * 5xx-then-success (A6).
+     */
+    async run(sequenceId, idempotencyKey) {
       const resp = await request(
         baseUrl,
         `/api/v1/sequences/${sequenceId}/run`,
         apiKey,
-        { method: "POST" }
+        { method: "POST", idempotencyKey }
       );
       return resp.data ?? resp;
     },
-    /** Pause a live sequence. */
-    async pause(sequenceId) {
+    /**
+     * Pause a live sequence. Pass `idempotencyKey` to make a retry safe — the
+     * same key won't double-apply on a 5xx-then-success (A6).
+     */
+    async pause(sequenceId, idempotencyKey) {
       const resp = await request(
         baseUrl,
         `/api/v1/sequences/${sequenceId}/pause`,
         apiKey,
-        { method: "POST" }
+        { method: "POST", idempotencyKey }
       );
       return resp.data ?? resp;
     },
-    /** Resume a paused sequence. */
-    async resume(sequenceId) {
+    /**
+     * Resume a paused sequence. Pass `idempotencyKey` to make a retry safe — the
+     * same key won't double-apply on a 5xx-then-success (A6).
+     */
+    async resume(sequenceId, idempotencyKey) {
       const resp = await request(
         baseUrl,
         `/api/v1/sequences/${sequenceId}/resume`,
         apiKey,
-        { method: "POST" }
+        { method: "POST", idempotencyKey }
       );
       return resp.data ?? resp;
     },