@graph8/sdk 0.7.1 → 0.7.2

package/dist/index.d.mts

@@ -2794,22 +2794,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. */
@@ -3206,14 +3224,14 @@ declare class G8 {
             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/index.d.ts

@@ -2794,22 +2794,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. */
@@ -3206,14 +3224,14 @@ declare class G8 {
             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/index.js

@@ -503,21 +503,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;
     },
@@ -546,33 +555,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;
     },