From 1a687903e1926f07966f39e242bc72ebfb38b162 Mon Sep 17 00:00:00 2001 From: frankkilcommins Date: Wed, 5 Jun 2024 22:02:47 +0000 Subject: [PATCH] Update ReSpec versions Signed-off-by: GitHub --- arazzo/latest.html | 37 +++++++++++++++++++++++-------------- arazzo/v1.0.0.html | 37 +++++++++++++++++++++++-------------- 2 files changed, 46 insertions(+), 28 deletions(-) diff --git a/arazzo/latest.html b/arazzo/latest.html index 71ef025701..1c1607c9d5 100644 --- a/arazzo/latest.html +++ b/arazzo/latest.html @@ -228,7 +228,7 @@

Source Description Object

Describes a source description (such as an OpenAPI description) that will be referenced by one or more workflows described within an Arazzo Description.

-

An object storing a map between named description keys and location URLs to the source descriptions (such as an OpenAPI description) this Arazzo Description SHALL apply to. Each source location string MUST be in the form of a URI-reference as defined by RFC3986 section 4.1.

+

An object storing a map between named description keys and location URLs to the source descriptions (such as an OpenAPI description) this Arazzo Description SHALL apply to. Each source location string MUST be in the form of a URI-reference as defined by [[!RFC3986]].

Fixed Fields

@@ -247,7 +247,7 @@ - + @@ -363,7 +363,7 @@ tokenExpires:$steps.loginStep.outputs.tokenExpires

Step Object

-

Describes a single workflow step which MAY be a call to an API operation (OpenAPI Operation Object or another Workflow Object.

+

Describes a single workflow step which MAY be a call to an API operation (OpenAPI Operation Object or another Workflow Object).

Fixed Fields

url stringREQUIRED. A URL to a source description to be used by a workflow. If a relative reference is used, it MUST be in the form of a URI-reference as defined by RFC3986 section 4.2.REQUIRED. A URL to a source description to be used by a workflow. If a relative reference is used, it MUST be in the form of a URI-reference as defined by [[!RFC3986]].
type
@@ -594,7 +594,7 @@ # assertions to determine if this success action should be executed-context:$response.bodycondition:$[?count(@.pets)>0] - type:JSONPath + type:jsonpath

Failure Action Object

A single failure action which describes an action to take upon failure of a workflow step. There are three possible values for the type field.

@@ -636,7 +636,7 @@
- + @@ -788,6 +788,11 @@ + + + + + @@ -820,7 +825,7 @@
  • simple - where basic literals, operators, and loose comparisons are used in combination with Runtime Expressions.
  • regex - where a regex pattern is applied on the supplied context. The context is defined by a Runtime Expression.
    • -
  • jsonpath - where a JSON Path expression is applied. The root node context is defined by a Runtime Expression.
    • +
  • jsonpath - where a JSONPath expression is applied. The root node context is defined by a Runtime Expression.
  • xpath - where an XPath expression is applied. The root node context is defined by a Runtime Expression.

Literals

@@ -929,12 +934,12 @@
- + - +
retryAfter numberA non-negative decimal indicating the seconds to delay after the step failure before another attempt SHALL be made. Note: if an HTTP Retry-After response header was returned to a step from a targeted operation, then it SHOULD overrule this particular field value. This field only applies when the type field value is "retry" or "function".A non-negative decimal indicating the seconds to delay after the step failure before another attempt SHALL be made. Note: if an HTTP Retry-After response header was returned to a step from a targeted operation, then it SHOULD overrule this particular field value. This field only applies when the type field value is "retry" or "function".
retryLimit
reference{expression}REQUIRED. A runtime expression used to reference the desired object.
value string Sets a value of the referenced parameter. This is only applicable for parameter object references.
condition stringREQUIRED. The condition to apply. Conditions can be simple (e.g. $statusCode == 200 which applies a operator on a value obtained from a runtime expression), or a regex, or a JSONPath expression. For regex and JSONPath, the type and context MUST be specified.REQUIRED. The condition to apply. Conditions can be simple (e.g. $statusCode == 200 which applies an operator on a value obtained from a runtime expression), or a regex, or a JSONPath expression. For regex or JSONPath, the type and context MUST be specified.
type string | Criterion Expression Type ObjectThe type of condition to be applied. If specified, the options allowed are simple, regex, jsonpath or xpath. If omitted, then the condition is assumed to be simple, which at most combines literals, operators and Runtime Expressions. If jsonpath, then the expression MUST conform to JSON Path. If xpath the expression MUST conform to XML Path Language 3.1. Should other variants of JSON Path or XPath be required, then a Criterion Expression Type Object MUST be specified.The type of condition to be applied. If specified, the options allowed are simple, regex, jsonpath or xpath. If omitted, then the condition is assumed to be simple, which at most combines literals, operators and Runtime Expressions. If jsonpath, then the expression MUST conform to JSONPath. If xpath the expression MUST conform to XML Path Language 3.1. Should other variants of JSONPath or XPath be required, then a Criterion Expression Type Object MUST be specified.
@@ -959,10 +964,10 @@

Criterion Expression Type Object

An object used to describe the type and version of an expression used within a Criterion Object. If this object is not defined, then the following defaults apply:

-

Defining this object gives the ability to utilize tooling compatible with older versions of either JSON Path or XPath.

+

Defining this object gives the ability to utilize tooling compatible with older versions of either JSONPath or XPath.

Fixed Fields
@@ -981,13 +986,13 @@
Fixed Fields
- +
version stringREQUIRED. A short hand string representing the version of the expression type being used. The allowed values for JSON Path are draft-goessner-dispatch-jsonpath-00. The allowed values for XPath are xpath-30, xpath-20, or xpath-10.REQUIRED. A short hand string representing the version of the expression type being used. The allowed values for JSONPath are draft-goessner-dispatch-jsonpath-00. The allowed values for XPath are xpath-30, xpath-20, or xpath-10.

This object MAY be extended with Specification Extensions.

Criterion Expression Type Example

-

JSON Path Example

+

JSONPath Example


   type: jsonpath
   version: draft-goessner-dispatch-jsonpath-00
@@ -1019,9 +1024,13 @@ 
Fixed Fields

 Any
 A value representing the request body payload. The value can be a literal value or can contain Runtime Expressions which MUST be evaluated prior to calling the referenced operation. To represent examples of media types that cannot be naturally represented in JSON or YAML, use a string value to contain the example, escaping where necessary.
 
+
+ replacements
+[Payload Replacement Object]
+A list of locations and values to set within a payload.
+
 
 
-
 replacements | [Payload Replacement Object] | A list of locations and values to set within a payload.

 
This object MAY be extended with Specification Extensions.

RequestBody Object Example

JSON Templated Example

@@ -1225,7 +1234,7 @@

Specification Extensions

The extensions may or may not be supported by the available tooling, but those may be extended as well to add requested support (if tools are internal or open-sourced).

Security Considerations

The Arazzo Specification does not enforce a security mechanism. Security is left to the implementer, though TLS, specifically HTTPS may be recommended for exchanging sensitive workflows.

-

Arazzo Descriptions can be JSON or YAML values. As such, all security considerations defined in RFC 8259 and within YAML version 1.2 apply.

+

Arazzo Descriptions can be JSON or YAML values. As such, all security considerations defined in RFC8259 and within YAML version 1.2 apply.

Arazzo Descriptions are frequently written by untrusted third parties, to be deployed on public Internet servers. Processing an Arazzo Description can cause both safe and unsafe operations to be performed on arbitrary network resources. It is the responsibility of the description consumer to ensure that the operations performed are not harmful.

IANA Considerations

The proposed MIME media types for the Arazzo Specification are described below.

diff --git a/arazzo/v1.0.0.html b/arazzo/v1.0.0.html index 71ef025701..1c1607c9d5 100644 --- a/arazzo/v1.0.0.html +++ b/arazzo/v1.0.0.html @@ -228,7 +228,7 @@

Source Description Object

Describes a source description (such as an OpenAPI description) that will be referenced by one or more workflows described within an Arazzo Description.

-

An object storing a map between named description keys and location URLs to the source descriptions (such as an OpenAPI description) this Arazzo Description SHALL apply to. Each source location string MUST be in the form of a URI-reference as defined by RFC3986 section 4.1.

+

An object storing a map between named description keys and location URLs to the source descriptions (such as an OpenAPI description) this Arazzo Description SHALL apply to. Each source location string MUST be in the form of a URI-reference as defined by [[!RFC3986]].

Fixed Fields

@@ -247,7 +247,7 @@ - + @@ -363,7 +363,7 @@ tokenExpires:$steps.loginStep.outputs.tokenExpires

Step Object

-

Describes a single workflow step which MAY be a call to an API operation (OpenAPI Operation Object or another Workflow Object.

+

Describes a single workflow step which MAY be a call to an API operation (OpenAPI Operation Object or another Workflow Object).

Fixed Fields

url stringREQUIRED. A URL to a source description to be used by a workflow. If a relative reference is used, it MUST be in the form of a URI-reference as defined by RFC3986 section 4.2.REQUIRED. A URL to a source description to be used by a workflow. If a relative reference is used, it MUST be in the form of a URI-reference as defined by [[!RFC3986]].
type
@@ -594,7 +594,7 @@ # assertions to determine if this success action should be executed-context:$response.bodycondition:$[?count(@.pets)>0] - type:JSONPath + type:jsonpath

Failure Action Object

A single failure action which describes an action to take upon failure of a workflow step. There are three possible values for the type field.

@@ -636,7 +636,7 @@
- + @@ -788,6 +788,11 @@ + + + + + @@ -820,7 +825,7 @@
  • simple - where basic literals, operators, and loose comparisons are used in combination with Runtime Expressions.
  • regex - where a regex pattern is applied on the supplied context. The context is defined by a Runtime Expression.
    • -
  • jsonpath - where a JSON Path expression is applied. The root node context is defined by a Runtime Expression.
    • +
  • jsonpath - where a JSONPath expression is applied. The root node context is defined by a Runtime Expression.
  • xpath - where an XPath expression is applied. The root node context is defined by a Runtime Expression.

Literals

@@ -929,12 +934,12 @@
- + - +
retryAfter numberA non-negative decimal indicating the seconds to delay after the step failure before another attempt SHALL be made. Note: if an HTTP Retry-After response header was returned to a step from a targeted operation, then it SHOULD overrule this particular field value. This field only applies when the type field value is "retry" or "function".A non-negative decimal indicating the seconds to delay after the step failure before another attempt SHALL be made. Note: if an HTTP Retry-After response header was returned to a step from a targeted operation, then it SHOULD overrule this particular field value. This field only applies when the type field value is "retry" or "function".
retryLimit
reference{expression}REQUIRED. A runtime expression used to reference the desired object.
value string Sets a value of the referenced parameter. This is only applicable for parameter object references.
condition stringREQUIRED. The condition to apply. Conditions can be simple (e.g. $statusCode == 200 which applies a operator on a value obtained from a runtime expression), or a regex, or a JSONPath expression. For regex and JSONPath, the type and context MUST be specified.REQUIRED. The condition to apply. Conditions can be simple (e.g. $statusCode == 200 which applies an operator on a value obtained from a runtime expression), or a regex, or a JSONPath expression. For regex or JSONPath, the type and context MUST be specified.
type string | Criterion Expression Type ObjectThe type of condition to be applied. If specified, the options allowed are simple, regex, jsonpath or xpath. If omitted, then the condition is assumed to be simple, which at most combines literals, operators and Runtime Expressions. If jsonpath, then the expression MUST conform to JSON Path. If xpath the expression MUST conform to XML Path Language 3.1. Should other variants of JSON Path or XPath be required, then a Criterion Expression Type Object MUST be specified.The type of condition to be applied. If specified, the options allowed are simple, regex, jsonpath or xpath. If omitted, then the condition is assumed to be simple, which at most combines literals, operators and Runtime Expressions. If jsonpath, then the expression MUST conform to JSONPath. If xpath the expression MUST conform to XML Path Language 3.1. Should other variants of JSONPath or XPath be required, then a Criterion Expression Type Object MUST be specified.
@@ -959,10 +964,10 @@

Criterion Expression Type Object

An object used to describe the type and version of an expression used within a Criterion Object. If this object is not defined, then the following defaults apply:

-

Defining this object gives the ability to utilize tooling compatible with older versions of either JSON Path or XPath.

+

Defining this object gives the ability to utilize tooling compatible with older versions of either JSONPath or XPath.

Fixed Fields
@@ -981,13 +986,13 @@
Fixed Fields
- +
version stringREQUIRED. A short hand string representing the version of the expression type being used. The allowed values for JSON Path are draft-goessner-dispatch-jsonpath-00. The allowed values for XPath are xpath-30, xpath-20, or xpath-10.REQUIRED. A short hand string representing the version of the expression type being used. The allowed values for JSONPath are draft-goessner-dispatch-jsonpath-00. The allowed values for XPath are xpath-30, xpath-20, or xpath-10.

This object MAY be extended with Specification Extensions.

Criterion Expression Type Example

-

JSON Path Example

+

JSONPath Example


   type: jsonpath
   version: draft-goessner-dispatch-jsonpath-00
@@ -1019,9 +1024,13 @@ 
Fixed Fields

 Any
 A value representing the request body payload. The value can be a literal value or can contain Runtime Expressions which MUST be evaluated prior to calling the referenced operation. To represent examples of media types that cannot be naturally represented in JSON or YAML, use a string value to contain the example, escaping where necessary.
 
+
+ replacements
+[Payload Replacement Object]
+A list of locations and values to set within a payload.
+
 
 
-
 replacements | [Payload Replacement Object] | A list of locations and values to set within a payload.

 
This object MAY be extended with Specification Extensions.

RequestBody Object Example

JSON Templated Example

@@ -1225,7 +1234,7 @@

Specification Extensions

The extensions may or may not be supported by the available tooling, but those may be extended as well to add requested support (if tools are internal or open-sourced).

Security Considerations

The Arazzo Specification does not enforce a security mechanism. Security is left to the implementer, though TLS, specifically HTTPS may be recommended for exchanging sensitive workflows.

-

Arazzo Descriptions can be JSON or YAML values. As such, all security considerations defined in RFC 8259 and within YAML version 1.2 apply.

+

Arazzo Descriptions can be JSON or YAML values. As such, all security considerations defined in RFC8259 and within YAML version 1.2 apply.

Arazzo Descriptions are frequently written by untrusted third parties, to be deployed on public Internet servers. Processing an Arazzo Description can cause both safe and unsafe operations to be performed on arbitrary network resources. It is the responsibility of the description consumer to ensure that the operations performed are not harmful.

IANA Considerations

The proposed MIME media types for the Arazzo Specification are described below.