cloudflare 6.3.0 → 6.5.0

package/src/resources/workflows/instances/status.ts

@@ -33,7 +33,8 @@ export interface StatusEditResponse {
     | 'terminated'
     | 'complete'
     | 'waitingForPause'
-    | 'waiting';
+    | 'waiting'
+    | 'rollingBack';
 
   /**
    * Accepts ISO 8601 with no timezone offsets and in UTC.
@@ -41,33 +42,82 @@ export interface StatusEditResponse {
   timestamp: string;
 }
 
-export interface StatusEditParams {
-  /**
-   * Path param
-   */
-  account_id: string;
+export type StatusEditParams =
+  | StatusEditParams.Variant0
+  | StatusEditParams.Variant1
+  | StatusEditParams.Variant2
+  | StatusEditParams.Variant3;
 
-  /**
-   * Body param: Apply action to instance.
-   */
-  status: 'resume' | 'pause' | 'terminate' | 'restart';
+export declare namespace StatusEditParams {
+  export interface Variant0 {
+    /**
+     * Path param
+     */
+    account_id: string;
 
-  /**
-   * Body param: Step to restart from. Only applicable when status is "restart".
-   */
-  from?: StatusEditParams.From;
-}
+    /**
+     * Body param
+     */
+    status: 'pause';
+  }
 
-export namespace StatusEditParams {
-  /**
-   * Step to restart from. Only applicable when status is "restart".
-   */
-  export interface From {
-    name: string;
+  export interface Variant1 {
+    /**
+     * Path param
+     */
+    account_id: string;
+
+    /**
+     * Body param
+     */
+    status: 'resume';
+  }
+
+  export interface Variant2 {
+    /**
+     * Path param
+     */
+    account_id: string;
+
+    /**
+     * Body param
+     */
+    status: 'terminate';
+
+    /**
+     * Body param: Run rollback before terminating.
+     */
+    rollback?: boolean;
+  }
+
+  export interface Variant3 {
+    /**
+     * Path param
+     */
+    account_id: string;
+
+    /**
+     * Body param
+     */
+    status: 'restart';
+
+    /**
+     * Body param: Step to restart from.
+     */
+    from?: Variant3.From;
+  }
+
+  export namespace Variant3 {
+    /**
+     * Step to restart from.
+     */
+    export interface From {
+      name: string;
 
-    count?: number;
+      count?: number;
 
-    type?: 'do' | 'sleep' | 'waitForEvent';
+      type?: 'do' | 'sleep' | 'waitForEvent';
+    }
   }
 }
 

package/src/resources/workflows/versions.ts

@@ -38,6 +38,24 @@ export class Versions extends APIResource {
       ) as Core.APIPromise<{ result: VersionGetResponse }>
     )._thenUnwrap((obj) => obj.result);
   }
+
+  /**
+   * Retrieves the graph visualization of a workflow version.
+   */
+  graph(
+    workflowName: string,
+    versionId: string,
+    params: VersionGraphParams,
+    options?: Core.RequestOptions,
+  ): Core.APIPromise<VersionGraphResponse> {
+    const { account_id } = params;
+    return (
+      this._client.get(
+        `/accounts/${account_id}/workflows/${workflowName}/versions/${versionId}/graph`,
+        options,
+      ) as Core.APIPromise<{ result: VersionGraphResponse }>
+    )._thenUnwrap((obj) => obj.result);
+  }
 }
 
 export class VersionListResponsesV4PagePaginationArray extends V4PagePaginationArray<VersionListResponse> {}
@@ -96,6 +114,409 @@ export namespace VersionGetResponse {
   }
 }
 
+export interface VersionGraphResponse {
+  id: string;
+
+  class_name: string;
+
+  created_on: string;
+
+  /**
+   * Versioned workflow graph payload.
+   */
+  graph: VersionGraphResponse.Graph | null;
+
+  modified_on: string;
+
+  workflow_id: string;
+}
+
+export namespace VersionGraphResponse {
+  /**
+   * Versioned workflow graph payload.
+   */
+  export interface Graph {
+    version: number;
+
+    /**
+     * A parsed workflow entrypoint with its step graph.
+     */
+    workflow: Graph.Workflow;
+  }
+
+  export namespace Graph {
+    /**
+     * A parsed workflow entrypoint with its step graph.
+     */
+    export interface Workflow {
+      class_name: string;
+
+      functions: { [key: string]: Workflow.Functions };
+
+      nodes: Array<
+        | Workflow.UnionMember0
+        | Workflow.UnionMember1
+        | Workflow.UnionMember2
+        | Workflow.UnionMember3
+        | Workflow.UnionMember4
+        | Workflow.UnionMember5
+        | Workflow.UnionMember6
+        | Workflow.UnionMember7
+        | Workflow.UnionMember8
+        | Workflow.UnionMember9
+        | Workflow.UnionMember10
+        | Workflow.UnionMember11
+        | Workflow.UnionMember12
+        | Workflow.UnionMember13
+      >;
+
+      /**
+       * Shape descriptor for JSON payloads.
+       */
+      payload?: Workflow.Payload.Type | Workflow.Payload.UnionMember1;
+    }
+
+    export namespace Workflow {
+      export interface Functions {
+        name: string;
+
+        /**
+         * Child nodes (recursive).
+         */
+        nodes: Array<unknown>;
+
+        type: 'function_def';
+      }
+
+      export interface UnionMember0 {
+        /**
+         * Duration as milliseconds (number) or human-readable string.
+         */
+        duration: number | string;
+
+        name: string;
+
+        type: 'step_sleep';
+
+        resolves?: number;
+
+        starts?: number;
+      }
+
+      export interface UnionMember1 {
+        /**
+         * Configuration for a step (retries and timeout).
+         */
+        config: UnionMember1.Config;
+
+        name: string;
+
+        /**
+         * Child nodes (recursive).
+         */
+        nodes: Array<unknown>;
+
+        type: 'step_do';
+
+        resolves?: number;
+
+        starts?: number;
+      }
+
+      export namespace UnionMember1 {
+        /**
+         * Configuration for a step (retries and timeout).
+         */
+        export interface Config {
+          /**
+           * Retry policy for a step.
+           */
+          retries: Config.Retries;
+
+          /**
+           * Duration as milliseconds (number) or human-readable string.
+           */
+          timeout: number | string;
+        }
+
+        export namespace Config {
+          /**
+           * Retry policy for a step.
+           */
+          export interface Retries {
+            /**
+             * Backoff strategy for step retries.
+             */
+            backoff: 'constant' | 'linear' | 'exponential';
+
+            /**
+             * Duration as milliseconds (number) or human-readable string.
+             */
+            delay: number | string;
+
+            limit: number;
+          }
+        }
+      }
+
+      export interface UnionMember2 {
+        name: string;
+
+        /**
+         * Options for a waitForEvent step.
+         */
+        options: UnionMember2.Options | null;
+
+        type: 'step_wait_for_event';
+
+        /**
+         * Shape descriptor for JSON payloads.
+         */
+        payload?: UnionMember2.Type | UnionMember2.UnionMember1;
+
+        resolves?: number;
+
+        starts?: number;
+      }
+
+      export namespace UnionMember2 {
+        /**
+         * Options for a waitForEvent step.
+         */
+        export interface Options {
+          event_type: string;
+
+          /**
+           * Duration as milliseconds (number) or human-readable string.
+           */
+          timeout: number | string;
+        }
+
+        export interface Type {
+          type: 'unknown';
+        }
+
+        export interface UnionMember1 {
+          /**
+           * Nested JsonShape fields (recursive structure).
+           */
+          fields: { [key: string]: unknown };
+
+          type: 'object';
+        }
+      }
+
+      export interface UnionMember3 {
+        name: string;
+
+        timestamp: string;
+
+        type: 'step_sleep_until';
+
+        resolves?: number;
+
+        starts?: number;
+      }
+
+      export interface UnionMember4 {
+        /**
+         * Child nodes (recursive).
+         */
+        nodes: Array<unknown>;
+
+        type: 'loop';
+      }
+
+      export interface UnionMember5 {
+        /**
+         * Parallel execution strategy.
+         */
+        kind: 'all' | 'any' | 'all_settled' | 'race';
+
+        /**
+         * Child nodes (recursive).
+         */
+        nodes: Array<unknown>;
+
+        type: 'parallel';
+      }
+
+      export interface UnionMember6 {
+        catch_block: UnionMember6.CatchBlock | null;
+
+        finally_block: UnionMember6.FinallyBlock | null;
+
+        try_block: UnionMember6.TryBlock | null;
+
+        type: 'try';
+      }
+
+      export namespace UnionMember6 {
+        export interface CatchBlock {
+          /**
+           * Child nodes (recursive).
+           */
+          nodes: Array<unknown>;
+
+          type: 'block';
+        }
+
+        export interface FinallyBlock {
+          /**
+           * Child nodes (recursive).
+           */
+          nodes: Array<unknown>;
+
+          type: 'block';
+        }
+
+        export interface TryBlock {
+          /**
+           * Child nodes (recursive).
+           */
+          nodes: Array<unknown>;
+
+          type: 'block';
+        }
+      }
+
+      export interface UnionMember7 {
+        /**
+         * Child nodes (recursive).
+         */
+        nodes: Array<unknown>;
+
+        type: 'block';
+      }
+
+      export interface UnionMember8 {
+        branches: Array<UnionMember8.Branch>;
+
+        type: 'if';
+      }
+
+      export namespace UnionMember8 {
+        export interface Branch {
+          condition: string | null;
+
+          /**
+           * Child nodes (recursive).
+           */
+          nodes: Array<unknown>;
+        }
+      }
+
+      export interface UnionMember9 {
+        branches: Array<UnionMember9.Branch>;
+
+        discriminant: string;
+
+        type: 'switch';
+      }
+
+      export namespace UnionMember9 {
+        export interface Branch {
+          condition: string | null;
+
+          /**
+           * Child nodes (recursive).
+           */
+          nodes: Array<unknown>;
+        }
+      }
+
+      export interface UnionMember10 {
+        class_name: string;
+
+        functions: { [key: string]: UnionMember10.Functions };
+
+        /**
+         * Child nodes (recursive).
+         */
+        nodes: Array<unknown>;
+
+        type: 'start';
+
+        /**
+         * Shape descriptor for JSON payloads.
+         */
+        payload?: UnionMember10.Type | UnionMember10.UnionMember1;
+      }
+
+      export namespace UnionMember10 {
+        export interface Functions {
+          name: string;
+
+          /**
+           * Child nodes (recursive).
+           */
+          nodes: Array<unknown>;
+
+          type: 'function_def';
+        }
+
+        export interface Type {
+          type: 'unknown';
+        }
+
+        export interface UnionMember1 {
+          /**
+           * Nested JsonShape fields (recursive structure).
+           */
+          fields: { [key: string]: unknown };
+
+          type: 'object';
+        }
+      }
+
+      export interface UnionMember11 {
+        name: string;
+
+        type: 'function_call';
+
+        resolves?: number;
+
+        starts?: number;
+      }
+
+      export interface UnionMember12 {
+        name: string;
+
+        /**
+         * Child nodes (recursive).
+         */
+        nodes: Array<unknown>;
+
+        type: 'function_def';
+      }
+
+      export interface UnionMember13 {
+        /**
+         * Break or return from a loop.
+         */
+        kind: 'break' | 'return';
+
+        type: 'break';
+      }
+
+      export namespace Payload {
+        export interface Type {
+          type: 'unknown';
+        }
+
+        export interface UnionMember1 {
+          /**
+           * Nested JsonShape fields (recursive structure).
+           */
+          fields: { [key: string]: unknown };
+
+          type: 'object';
+        }
+      }
+    }
+  }
+}
+
 export interface VersionListParams extends V4PagePaginationArrayParams {
   /**
    * Path param
@@ -107,14 +528,20 @@ export interface VersionGetParams {
   account_id: string;
 }
 
+export interface VersionGraphParams {
+  account_id: string;
+}
+
 Versions.VersionListResponsesV4PagePaginationArray = VersionListResponsesV4PagePaginationArray;
 
 export declare namespace Versions {
   export {
     type VersionListResponse as VersionListResponse,
     type VersionGetResponse as VersionGetResponse,
+    type VersionGraphResponse as VersionGraphResponse,
     VersionListResponsesV4PagePaginationArray as VersionListResponsesV4PagePaginationArray,
     type VersionListParams as VersionListParams,
     type VersionGetParams as VersionGetParams,
+    type VersionGraphParams as VersionGraphParams,
   };
 }

package/src/resources/workflows/workflows.ts

@@ -6,6 +6,8 @@ import * as VersionsAPI from './versions';
 import {
   VersionGetParams,
   VersionGetResponse,
+  VersionGraphParams,
+  VersionGraphResponse,
   VersionListParams,
   VersionListResponse,
   VersionListResponsesV4PagePaginationArray,
@@ -23,6 +25,8 @@ import {
   InstanceListParams,
   InstanceListResponse,
   InstanceListResponsesV4PagePaginationArray,
+  InstanceStepParams,
+  InstanceStepResponse,
   Instances as InstancesAPIInstances,
 } from './instances/instances';
 import { V4PagePaginationArray, type V4PagePaginationArrayParams } from '../../pagination';
@@ -137,6 +141,8 @@ export interface WorkflowListResponse {
   script_name: string;
 
   triggered_on: string | null;
+
+  schedules?: Array<WorkflowListResponse.Schedule>;
 }
 
 export namespace WorkflowListResponse {
@@ -149,6 +155,8 @@ export namespace WorkflowListResponse {
 
     queued?: number;
 
+    rollingBack?: number;
+
     running?: number;
 
     terminated?: number;
@@ -157,6 +165,12 @@ export namespace WorkflowListResponse {
 
     waitingForPause?: number;
   }
+
+  export interface Schedule {
+    cron: string;
+
+    next_instance: string;
+  }
 }
 
 export interface WorkflowDeleteResponse {
@@ -181,6 +195,8 @@ export interface WorkflowGetResponse {
   script_name: string;
 
   triggered_on: string | null;
+
+  schedules?: Array<WorkflowGetResponse.Schedule>;
 }
 
 export namespace WorkflowGetResponse {
@@ -193,6 +209,8 @@ export namespace WorkflowGetResponse {
 
     queued?: number;
 
+    rollingBack?: number;
+
     running?: number;
 
     terminated?: number;
@@ -201,6 +219,12 @@ export namespace WorkflowGetResponse {
 
     waitingForPause?: number;
   }
+
+  export interface Schedule {
+    cron: string;
+
+    next_instance: string;
+  }
 }
 
 export interface WorkflowUpdateParams {
@@ -223,12 +247,21 @@ export interface WorkflowUpdateParams {
    * Body param
    */
   limits?: WorkflowUpdateParams.Limits;
+
+  /**
+   * Body param
+   */
+  schedules?: Array<WorkflowUpdateParams.Schedule>;
 }
 
 export namespace WorkflowUpdateParams {
   export interface Limits {
     steps?: number;
   }
+
+  export interface Schedule {
+    cron: string;
+  }
 }
 
 export interface WorkflowListParams extends V4PagePaginationArrayParams {
@@ -277,20 +310,24 @@ export declare namespace Workflows {
     type InstanceListResponse as InstanceListResponse,
     type InstanceBulkResponse as InstanceBulkResponse,
     type InstanceGetResponse as InstanceGetResponse,
+    type InstanceStepResponse as InstanceStepResponse,
     InstanceListResponsesV4PagePaginationArray as InstanceListResponsesV4PagePaginationArray,
     InstanceBulkResponsesSinglePage as InstanceBulkResponsesSinglePage,
     type InstanceCreateParams as InstanceCreateParams,
     type InstanceListParams as InstanceListParams,
     type InstanceBulkParams as InstanceBulkParams,
     type InstanceGetParams as InstanceGetParams,
+    type InstanceStepParams as InstanceStepParams,
   };
 
   export {
     Versions as Versions,
     type VersionListResponse as VersionListResponse,
     type VersionGetResponse as VersionGetResponse,
+    type VersionGraphResponse as VersionGraphResponse,
     VersionListResponsesV4PagePaginationArray as VersionListResponsesV4PagePaginationArray,
     type VersionListParams as VersionListParams,
     type VersionGetParams as VersionGetParams,
+    type VersionGraphParams as VersionGraphParams,
   };
 }