@graph8/sdk 0.7.1 → 0.7.2

package/dist/react.d.mts

@@ -2757,22 +2757,40 @@ declare const createSequencesClient: (apiKey: string, apiUrl?: string) => {
         data: SequenceContactItem[];
         pagination?: PaginationMeta;
     }>;
-    /** Add contacts to a sequence (V2 queuing). Live or drafted sequences only. */
-    add(config: AddToSequenceConfig): Promise<SequenceActionResult>;
-    /** Create a new sequence with optional steps + channels. */
-    create(payload: SequenceCreateParams): Promise<SequenceCreateResult>;
+    /**
+     * 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).
+     */
+    add(config: AddToSequenceConfig, idempotencyKey?: string): Promise<SequenceActionResult>;
+    /**
+     * 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).
+     */
+    create(payload: SequenceCreateParams, idempotencyKey?: string): Promise<SequenceCreateResult>;
     /** Update sequence metadata. Rejected (409) if sequence is in a transitional status. */
     update(sequenceId: string, fields: SequenceUpdateParams): Promise<SequenceActionResult>;
     /** Update a single step within a sequence. */
     updateStep(sequenceId: string, stepId: string, fields: SequenceStepUpdateParams): Promise<SequenceActionResult>;
     /** Soft-delete (archive) a sequence. */
     delete(sequenceId: string): Promise<SequenceActionResult>;
-    /** Run/start a DRAFTED sequence (V2 orchestration). */
-    run(sequenceId: string): Promise<SequenceActionResult>;
-    /** Pause a live sequence. */
-    pause(sequenceId: string): Promise<SequenceActionResult>;
-    /** Resume a paused sequence. */
-    resume(sequenceId: string): Promise<SequenceActionResult>;
+    /**
+     * 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).
+     */
+    run(sequenceId: string, idempotencyKey?: string): Promise<SequenceActionResult>;
+    /**
+     * Pause a live sequence. Pass `idempotencyKey` to make a retry safe — the
+     * same key won't double-apply on a 5xx-then-success (A6).
+     */
+    pause(sequenceId: string, idempotencyKey?: string): Promise<SequenceActionResult>;
+    /**
+     * Resume a paused sequence. Pass `idempotencyKey` to make a retry safe — the
+     * same key won't double-apply on a 5xx-then-success (A6).
+     */
+    resume(sequenceId: string, idempotencyKey?: string): Promise<SequenceActionResult>;
     /** Read-only sequence preview with all steps + channels (no enrollment). */
     preview(sequenceId: string): Promise<SequencePreview>;
     /** Comprehensive analytics for a sequence. */
@@ -3184,14 +3202,14 @@ declare const useG8: () => {
                 data: SequenceContactItem[];
                 pagination?: PaginationMeta;
             }>;
-            add(config: AddToSequenceConfig): Promise<SequenceActionResult>;
-            create(payload: SequenceCreateParams): Promise<SequenceCreateResult>;
+            add(config: AddToSequenceConfig, idempotencyKey?: string): Promise<SequenceActionResult>;
+            create(payload: SequenceCreateParams, idempotencyKey?: string): Promise<SequenceCreateResult>;
             update(sequenceId: string, fields: SequenceUpdateParams): Promise<SequenceActionResult>;
             updateStep(sequenceId: string, stepId: string, fields: SequenceStepUpdateParams): Promise<SequenceActionResult>;
             delete(sequenceId: string): Promise<SequenceActionResult>;
-            run(sequenceId: string): Promise<SequenceActionResult>;
-            pause(sequenceId: string): Promise<SequenceActionResult>;
-            resume(sequenceId: string): Promise<SequenceActionResult>;
+            run(sequenceId: string, idempotencyKey?: string): Promise<SequenceActionResult>;
+            pause(sequenceId: string, idempotencyKey?: string): Promise<SequenceActionResult>;
+            resume(sequenceId: string, idempotencyKey?: string): Promise<SequenceActionResult>;
             preview(sequenceId: string): Promise<SequencePreview>;
             analytics(sequenceId: string): Promise<SequenceAnalytics>;
         };

package/dist/react.d.ts

@@ -2757,22 +2757,40 @@ declare const createSequencesClient: (apiKey: string, apiUrl?: string) => {
         data: SequenceContactItem[];
         pagination?: PaginationMeta;
     }>;
-    /** Add contacts to a sequence (V2 queuing). Live or drafted sequences only. */
-    add(config: AddToSequenceConfig): Promise<SequenceActionResult>;
-    /** Create a new sequence with optional steps + channels. */
-    create(payload: SequenceCreateParams): Promise<SequenceCreateResult>;
+    /**
+     * 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).
+     */
+    add(config: AddToSequenceConfig, idempotencyKey?: string): Promise<SequenceActionResult>;
+    /**
+     * 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).
+     */
+    create(payload: SequenceCreateParams, idempotencyKey?: string): Promise<SequenceCreateResult>;
     /** Update sequence metadata. Rejected (409) if sequence is in a transitional status. */
     update(sequenceId: string, fields: SequenceUpdateParams): Promise<SequenceActionResult>;
     /** Update a single step within a sequence. */
     updateStep(sequenceId: string, stepId: string, fields: SequenceStepUpdateParams): Promise<SequenceActionResult>;
     /** Soft-delete (archive) a sequence. */
     delete(sequenceId: string): Promise<SequenceActionResult>;
-    /** Run/start a DRAFTED sequence (V2 orchestration). */
-    run(sequenceId: string): Promise<SequenceActionResult>;
-    /** Pause a live sequence. */
-    pause(sequenceId: string): Promise<SequenceActionResult>;
-    /** Resume a paused sequence. */
-    resume(sequenceId: string): Promise<SequenceActionResult>;
+    /**
+     * 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).
+     */
+    run(sequenceId: string, idempotencyKey?: string): Promise<SequenceActionResult>;
+    /**
+     * Pause a live sequence. Pass `idempotencyKey` to make a retry safe — the
+     * same key won't double-apply on a 5xx-then-success (A6).
+     */
+    pause(sequenceId: string, idempotencyKey?: string): Promise<SequenceActionResult>;
+    /**
+     * Resume a paused sequence. Pass `idempotencyKey` to make a retry safe — the
+     * same key won't double-apply on a 5xx-then-success (A6).
+     */
+    resume(sequenceId: string, idempotencyKey?: string): Promise<SequenceActionResult>;
     /** Read-only sequence preview with all steps + channels (no enrollment). */
     preview(sequenceId: string): Promise<SequencePreview>;
     /** Comprehensive analytics for a sequence. */
@@ -3184,14 +3202,14 @@ declare const useG8: () => {
                 data: SequenceContactItem[];
                 pagination?: PaginationMeta;
             }>;
-            add(config: AddToSequenceConfig): Promise<SequenceActionResult>;
-            create(payload: SequenceCreateParams): Promise<SequenceCreateResult>;
+            add(config: AddToSequenceConfig, idempotencyKey?: string): Promise<SequenceActionResult>;
+            create(payload: SequenceCreateParams, idempotencyKey?: string): Promise<SequenceCreateResult>;
             update(sequenceId: string, fields: SequenceUpdateParams): Promise<SequenceActionResult>;
             updateStep(sequenceId: string, stepId: string, fields: SequenceStepUpdateParams): Promise<SequenceActionResult>;
             delete(sequenceId: string): Promise<SequenceActionResult>;
-            run(sequenceId: string): Promise<SequenceActionResult>;
-            pause(sequenceId: string): Promise<SequenceActionResult>;
-            resume(sequenceId: string): Promise<SequenceActionResult>;
+            run(sequenceId: string, idempotencyKey?: string): Promise<SequenceActionResult>;
+            pause(sequenceId: string, idempotencyKey?: string): Promise<SequenceActionResult>;
+            resume(sequenceId: string, idempotencyKey?: string): Promise<SequenceActionResult>;
             preview(sequenceId: string): Promise<SequencePreview>;
             analytics(sequenceId: string): Promise<SequenceAnalytics>;
         };

package/dist/react.js

@@ -487,21 +487,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;
     },
@@ -530,33 +539,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;
     },