@salesforce/lds-adapters-analytics-wave 1.404.0-dev1 → 1.404.0-dev4

package/src/raml/api.raml

@@ -1432,6 +1432,135 @@ types:
           - Running
           - Success
           - Warning
+  DataflowJobNodeStageCollectionRepresentation:
+    description: A collection of Dataflow Job Node Stages.
+    type: object
+    properties:
+      dataflowjobId:
+        description: The ID of the associated DataflowJob.
+        type: string
+      foundCount:
+        description: The number of stages that were found (only present in batch mode).
+        type: integer | nil
+        required: false # TODO Hand-rolled W-8253396
+      nextPageUrl:
+        description: URL for the next page of stages (null if no more pages).
+        type: string | nil
+        required: false # TODO Hand-rolled W-8253396
+      nodeId:
+        description: The ID of the associated DataflowJobNode.
+        type: string
+      notFoundStageIds:
+        description: List of stage IDs that were not found (only present in batch
+          mode, empty if all found).
+        type: array # TODO Hand-rolled union types on arrays (#19 on https://salesforce.quip.com/NxVhAkxL6RTW)
+        items:
+          type: string
+        required: false # TODO Hand-rolled W-8253396
+      requestedStageIds:
+        description: The list of requested stage IDs (only present in batch mode).
+        type: array # TODO Hand-rolled union types on arrays (#19 on https://salesforce.quip.com/NxVhAkxL6RTW)
+        items:
+          type: string
+        required: false # TODO Hand-rolled W-8253396
+      stages:
+        description: Collection of recipe stages.
+        type: array
+        items:
+          type: DataflowJobNodeStageRepresentation
+      totalStages:
+        description: The total number of stages for this node.
+        type: integer | nil
+      url:
+        description: URL to get the collection of recipe stages.
+        type: string
+  DataflowJobNodeStageParentsRepresentation:
+    description: Parent stage information for a Recipe Stage.
+    type: object
+    properties:
+      allParentStageIds:
+        description: List of all ancestor stage IDs (transitive closure).
+        type: array # TODO Hand-rolled union types on arrays (#19 on https://salesforce.quip.com/NxVhAkxL6RTW)
+        items:
+          type: string
+      dataflowjobId:
+        description: The ID of the associated DataflowJob.
+        type: string
+      nodeId:
+        description: The ID of the associated DataflowJobNode.
+        type: string
+      parentStageIds:
+        description: List of immediate parent stage IDs.
+        type: array # TODO Hand-rolled union types on arrays (#19 on https://salesforce.quip.com/NxVhAkxL6RTW)
+        items:
+          type: string
+      stageId:
+        description: The Spark stage ID.
+        type: string
+  DataflowJobNodeStageRepresentation:
+    description: Wave recipe stage representation.
+    type: object
+    properties:
+      allParentStageIds:
+        description: List of all ancestor stage IDs (transitive closure).
+        type: array # TODO Hand-rolled union types on arrays (#19 on https://salesforce.quip.com/NxVhAkxL6RTW)
+        items:
+          type: string
+      createdDate:
+        description: The creation date of the stage record.
+        type: string | nil
+        required: false # TODO Hand-rolled W-8253396
+      dataflowjobId:
+        description: The ID of the associated DataflowJob.
+        type: string
+      durationMillis:
+        description: The duration of the stage in milliseconds.
+        type: integer | nil
+      failureReason:
+        description: The failure reason if the stage failed.
+        type: string | nil
+        required: false # TODO Hand-rolled W-8253396
+      id:
+        description: The unique ID of the stage record.
+        type: string
+      lastModifiedDate:
+        description: The last modified date of the stage record.
+        type: string | nil
+        required: false # TODO Hand-rolled W-8253396
+      nodeId:
+        description: The ID of the associated DataflowJobNode.
+        type: string
+      parentStageIds:
+        description: List of immediate parent stage IDs.
+        type: array # TODO Hand-rolled union types on arrays (#19 on https://salesforce.quip.com/NxVhAkxL6RTW)
+        items:
+          type: string
+      recipeNodeApiNames:
+        description: The recipe node API name(s) associated with this stage.
+        type: string | nil
+      rowsIn:
+        description: The number of input rows processed by the stage.
+        type: integer | nil
+      rowsOut:
+        description: The number of output rows produced by the stage.
+        type: integer | nil
+      stageId:
+        description: The Spark stage ID (e.g., '187', '95').
+        type: string
+      stageMetricsJson:
+        description: The full stage metrics as JSON (only included in single-stage
+          GET).
+        type: string | nil
+        required: false # TODO Hand-rolled W-8253396
+      status:
+        description: The status of the stage execution.
+        type: string
+        enum:
+          - Failed
+          - Succeeded
+      url:
+        description: URL to retrieve this stage resource.
+        type: string | nil
   DataflowRepresentation:
     description: Wave dataflow asset representation.
     discriminatorValue: Dataflow
@@ -6670,6 +6799,92 @@ types:
       nodeId:
         type: string
         required: true
+  /dataflowjobs/{dataflowjobId}/nodes/{nodeId}/stages:
+    get:
+      description: 'Get a collection of Dataflow Job Node Stages for a specific
+        DataflowJobNode. Supports two modes: (1) List all stages with pagination
+        and filtering, or (2) Batch get specific stages by providing stageIds parameter.'
+      responses:
+        '200':
+          description: Success
+          body:
+            application/json:
+              type: DataflowJobNodeStageCollectionRepresentation
+      queryParameters:
+        includeMetrics:
+          description: 'If true, include stageMetricsJson in response. Default:
+            false'
+          type: boolean
+          required: false
+        pageSize:
+          description: Number of stages per page (default 25). Only used on first
+            page request.
+          type: integer
+          required: false
+        pageToken:
+          description: Encoded cursor for pagination. Returned in nextPageUrl from
+            previous page. When provided, retrieves next page of results. Only used
+            in list mode.
+          type: string
+          required: false
+        stageIds:
+          description: List of stage IDs to fetch (max 100). When provided, switches
+            to batch mode and ignores pagination/filter params.
+          type: array
+          required: false
+          items:
+            type: string
+            (oas-collectionFormat): csv
+        status:
+          description: Filter by status (e.g., 'succeeded', 'failed'). Case-insensitive.
+            Only used in list mode.
+          type: string
+          required: false
+    uriParameters:
+      dataflowjobId:
+        type: string
+        required: true
+      nodeId:
+        type: string
+        required: true
+  /dataflowjobs/{dataflowjobId}/nodes/{nodeId}/stages/{stageId}:
+    get:
+      description: Get a single Dataflow Job Node Stage with full metrics.
+      responses:
+        '200':
+          description: Success
+          body:
+            application/json:
+              type: DataflowJobNodeStageRepresentation
+    uriParameters:
+      dataflowjobId:
+        type: string
+        required: true
+      nodeId:
+        type: string
+        required: true
+      stageId:
+        type: string
+        required: true
+  /dataflowjobs/{dataflowjobId}/nodes/{nodeId}/stages/{stageId}/parents:
+    get:
+      description: Get parent stages for a Dataflow Job Node Stage.
+      responses:
+        '200':
+          description: Success
+          body:
+            application/json:
+              type: DataflowJobNodeStageParentsRepresentation
+    uriParameters:
+      dataflowjobId:
+        type: string
+        required: true
+      nodeId:
+        type: string
+        required: true
+      stageId:
+        type: string
+        required: true
   /datasets:
     get:
       description: Get a collection of dataset resource representations.

package/src/raml/luvio.raml

@@ -27,6 +27,14 @@ types:
     (luvio.ttl): 10080000
   DataflowJobNodeCollectionRepresentation:
     (luvio.ttl): 300
+  DataflowJobNodeStageRepresentation:
+    (luvio.ttl): 300
+    (luvio.key):
+      id: stageId
+  DataflowJobNodeStageParentsRepresentation:
+    (luvio.ttl): 300
+    (luvio.key):
+      id: stageId
   DependencyRepresentation:
     (luvio.ttl): 300
   DatasetCollectionRepresentation:
@@ -207,6 +215,22 @@ types:
         name: getDataflowJobNode
       (luvio.key):
         id: urlParams.nodeId
+  /dataflowjobs/{dataflowjobId}/nodes/{nodeId}/stages:
+    get:
+      (luvio.adapter):
+        name: getDataflowJobNodeStages
+  /dataflowjobs/{dataflowjobId}/nodes/{nodeId}/stages/{stageId}:
+    get:
+      (luvio.adapter):
+        name: getDataflowJobNodeStage
+      (luvio.key):
+        id: urlParams.stageId
+  /dataflowjobs/{dataflowjobId}/nodes/{nodeId}/stages/{stageId}/parents:
+    get:
+      (luvio.adapter):
+        name: getDataflowJobNodeStageParents
+      (luvio.key):
+        id: urlParams.stageId
   /datasets:
     get:
       (luvio.adapter):