@tsed/openspec 8.0.1 → 8.0.3

package/src/openspec2/OpenSpec2.ts

@@ -0,0 +1,73 @@
+import {OpenSpecExternalDocs} from "../common/OpenSpecExternalDocs.js";
+import {OpenSpecHash} from "../common/OpenSpecHash.js";
+import {OpenSpecInfo} from "../common/OpenSpecInfo.js";
+import {OpenSpecSecurity} from "../common/OpenSpecSecurity.js";
+import {OpenSpecTag} from "../common/OpenSpecTag.js";
+import {OS2BodyParameter, OS2QueryParameter} from "./OS2Parameter.js";
+import {OS2Paths} from "./OS2Paths.js";
+import {OS2Response} from "./OS2Response.js";
+import {OS2Schema} from "./OS2Schema.js";
+import {OS2Security} from "./OS2Security.js";
+
+export interface OpenSpec2 {
+  /**
+   * Specifies the Swagger Specification version being used. It can be used by the Swagger UI and other clients to interpret the API listing. The value MUST be "2.0".
+   */
+  swagger: string;
+  /**
+   * Provides metadata about the API. The metadata can be used by the clients if needed.
+   */
+  info?: OpenSpecInfo;
+  /**
+   * The host (name or ip) serving the API. This MUST be the host only and does not include the scheme nor sub-paths. It MAY include a port. If the host is not included, the host serving the documentation is to be used (including the port). The host does not support [path templating](https://github.com/OAI/OpenAPI-Specification/blob/master/versions/2.0.md#pathTemplating).
+   */
+  host?: string;
+  /**
+   * The base path on which the API is served, which is relative to the host. If it is not included, the API is served directly under the host. The value MUST start with a leading slash (/). The basePath does not support path [path templating](https://github.com/OAI/OpenAPI-Specification/blob/master/versions/2.0.md#pathTemplating).
+   */
+  basePath?: string;
+  /**
+   * The transfer protocol of the API. Values MUST be from the list: `http`, `https`, `ws`, `wss`. If the schemes is not included, the default scheme to be used is the one used to access the Swagger definition itself.
+   */
+  schemes?: ("http" | "https" | "ws" | "wss")[];
+  /**
+   * A list of MIME types the APIs can consume. This is global to all APIs but can be overridden on specific API calls. Value MUST be as described under [Mime Types](https://github.com/OAI/OpenAPI-Specification/blob/master/versions/2.0.md#mimeTypes).
+   */
+  consumes?: string[];
+  /**
+   * A list of MIME types the APIs can produce. This is global to all APIs but can be overridden on specific API calls. Value MUST be as described under [Mime Types](https://github.com/OAI/OpenAPI-Specification/blob/master/versions/2.0.md#mimeTypes).
+   */
+  produces?: string[];
+  /**
+   * The available paths and operations for the API.
+   */
+  paths?: OpenSpecHash<OS2Paths>;
+  /**
+   * An object to hold data types produced and consumed by operations.
+   */
+  definitions?: OpenSpecHash<OS2Schema>;
+  /**
+   * An object to hold parameters that can be used across operations. This property does not define global parameters for all operations.
+   */
+  parameters?: OpenSpecHash<OS2BodyParameter | OS2QueryParameter>;
+  /**
+   * An object to hold responses that can be used across operations. This property does not define global responses for all operations.
+   */
+  responses?: OpenSpecHash<OS2Response>;
+  /**
+   * A declaration of which security schemes are applied for the API as a whole. The list of values describes alternative security schemes that can be used (that is, there is a logical OR between the security requirements). Individual operations can override this definition.
+   */
+  security?: OpenSpecSecurity;
+  /**
+   * Security scheme definitions that can be used across the specification.
+   */
+  securityDefinitions?: OpenSpecHash<OS2Security>;
+  /**
+   * A list of tags used by the specification with additional metadata. The order of the tags can be used to reflect on their order by the parsing tools. Not all tags that are used by the Operation Object must be declared. The tags that are not declared may be organized randomly or based on the tools' logic. Each tag name in the list MUST be unique.
+   */
+  tags?: OpenSpecTag[];
+  /**
+   * Additional external documentation.
+   */
+  externalDocs?: OpenSpecExternalDocs;
+}

package/src/openspec3/OS3Callbacks.ts

@@ -0,0 +1,5 @@
+import {OpenSpecHash} from "../common/OpenSpecHash.js";
+import {OS3Paths} from "./OS3Paths.js";
+import {OS3Schema} from "./OS3Schema.js";
+
+export type OS3Callbacks<Schema = OS3Schema> = OpenSpecHash<OpenSpecHash<OS3Paths<Schema>>>;

package/src/openspec3/OS3Components.ts

@@ -0,0 +1,49 @@
+import {OpenSpecHash} from "../common/OpenSpecHash.js";
+import {OS3Callbacks} from "./OS3Callbacks.js";
+import {OS3Example} from "./OS3Example.js";
+import {OS3Header} from "./OS3Header.js";
+import {OS3Link} from "./OS3Link.js";
+import {OS3Parameter} from "./OS3Parameter.js";
+import {OS3RequestBody} from "./OS3RequestBody.js";
+import {OS3Response} from "./OS3Response.js";
+import {OS3Schema} from "./OS3Schema.js";
+import {OS3Security} from "./OS3Security.js";
+
+export interface OS3Components<Schema = OS3Schema> {
+  /**
+   * An object to hold reusable [Schema Objects](https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.0.1.md#schemaObject).
+   */
+  schemas?: OpenSpecHash<Schema>;
+  /**
+   * An object to hold reusable [Response Objects](https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.0.1.md#responseObject).
+   */
+  responses?: OpenSpecHash<OS3Response<Schema>>;
+  /**
+   * An object to hold reusable [Parameter Objects](https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.0.1.md#parameterObject).
+   */
+  parameters?: OpenSpecHash<OS3Parameter<Schema>>;
+  /**
+   * An object to hold reusable [Example Objects](https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.0.1.md#exampleObject).
+   */
+  examples?: OpenSpecHash<OS3Example>;
+  /**
+   * An object to hold reusable [Request Body Objects](https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.0.1.md#requestBodyObject).
+   */
+  requestBodies?: OpenSpecHash<OS3RequestBody<Schema>>;
+  /**
+   * An object to hold reusable [Header Objects](https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.0.1.md#headerObject).
+   */
+  headers?: OpenSpecHash<OS3Header<Schema>>;
+  /**
+   * An object to hold reusable [Security Scheme Objects](https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.0.1.md#securitySchemeObject).
+   */
+  securitySchemes?: OpenSpecHash<OS3Security>;
+  /**
+   * An object to hold reusable [Link Objects](https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.0.1.md#linkObject).
+   */
+  links?: OpenSpecHash<OS3Link>;
+  /**
+   * An object to hold reusable [Callback Objects](https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.0.1.md#callbackObject).
+   */
+  callbacks?: OS3Callbacks;
+}

package/src/openspec3/OS3Encoding.ts

@@ -0,0 +1,25 @@
+import {OpenSpecHash} from "../common/OpenSpecHash.js";
+import {OS3Header} from "./OS3Header.js";
+
+export interface OS3Encoding {
+  /**
+   * The `Content-Type` for encoding a specific property. Default value depends on the property type: for `string` with `format` being `binary` – `application/octet-stream`; for other primitive types – `text/plain`; for `object` - application/json; for `array` – the default is defined based on the inner type. The value can be a specific media type (e.g. `application/json`), a wildcard media type (e.g. `image/*`), or a comma-separated list of the two types.
+   */
+  contentType?: string;
+  /**
+   * A map allowing additional information to be provided as headers, for example `Content-Disposition`. `Content-Type` is described separately and SHALL be ignored in this section. This property SHALL be ignored if the request body media type is not a multipart.
+   */
+  headers?: OpenSpecHash<OS3Header>;
+  /**
+   * Describes how a specific property value will be serialized depending on its type. See [Parameter Object](https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.0.1.md#parameterObject) for details on the `[style](https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.0.1.md#parameterStyle)` property. The behavior follows the same values as `query` parameters, including default values. This property SHALL be ignored if the request body media type is not `application/x-www-form-urlencoded`.
+   */
+  style?: string;
+  /**
+   * When this is true, property values of type `array` or `object` generate separate parameters for each value of the array, or key-value-pair of the map. For other types of properties this property has no effect. When `[style](https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.0.1.md#parameterStyle)` is `form`, the default value is true. For all other styles, the default value is `false`. This property SHALL be ignored if the request body media type is not `application/x-www-form-urlencoded`.
+   */
+  explode?: boolean;
+  /**
+   * Determines whether the parameter value SHOULD allow reserved characters, as defined by [RFC3986](https://tools.ietf.org/html/rfc3986#section-2.2) `:/?#[]@!$&'()*+,;=` to be included without percent-encoding. The default value is `false`. This property SHALL be ignored if the request body media type is not `application/x-www-form-urlencoded`.
+   */
+  allowReserved?: boolean;
+}

package/src/openspec3/OS3Example.ts

@@ -0,0 +1,19 @@
+export interface OS3Example {
+  /**
+   * Short description for the example.
+   */
+  summary?: string;
+  /**
+   * Long description for the example. CommonMark syntax MAY be used for rich text representation.
+   */
+  description?: string;
+  /**
+   * Embedded literal example. The `value` field and `externalValue` field are mutually exclusive. To represent examples of media types that cannot naturally represented in JSON or YAML, use a string value to contain the example, escaping where necessary.
+   */
+  value?: any;
+  /**
+   * A URL that points to the literal example. This provides the capability to reference examples that cannot easily be included in JSON or YAML documents.
+   * The `value` field and `externalValue` field are mutually exclusive.
+   */
+  externalValue?: string;
+}

package/src/openspec3/OS3Flows.ts

@@ -0,0 +1,49 @@
+export interface OS3Flow {
+  /**
+   * The URL to be used for obtaining refresh tokens. This MUST be in the form of a URL.
+   */
+  refreshUrl?: string;
+  /**
+   * The available scopes for the OAuth2 security scheme. A map between the scope name and a short description for it.
+   */
+  scopes: {[key: string]: string};
+}
+
+export interface OS3FlowImplicit extends OS3Flow {
+  /**
+   * The authorization URL to be used for this flow. This MUST be in the form of a URL.
+   */
+  authorizationUrl: string;
+}
+
+export interface OS3FlowPassword extends OS3Flow {
+  /**
+   * The token URL to be used for this flow. This MUST be in the form of a URL.
+   */
+  tokenUrl: string;
+}
+
+export interface OS3FlowClientCredentials extends OS3Flow {
+  /**
+   * The token URL to be used for this flow. This MUST be in the form of a URL.
+   */
+  tokenUrl: string;
+}
+
+export interface OS3FlowAuthorizationCode extends OS3Flow {
+  /**
+   * The authorization URL to be used for this flow. This MUST be in the form of a URL.
+   */
+  authorizationUrl: string;
+  /**
+   * The token URL to be used for this flow. This MUST be in the form of a URL.
+   */
+  tokenUrl: string;
+}
+
+export interface OS3Flows {
+  implicit?: OS3FlowImplicit;
+  password?: OS3FlowPassword;
+  clientCredentials?: OS3FlowClientCredentials;
+  authorizationCode?: OS3FlowAuthorizationCode;
+}

package/src/openspec3/OS3Header.ts

@@ -0,0 +1,18 @@
+import {OpenSpecExternalDocs} from "../common/OpenSpecExternalDocs.js";
+import {OpenSpecRef} from "../common/OpenSpecRef.js";
+import {OS3Schema} from "./OS3Schema.js";
+
+export interface OS3Header<Schema = OS3Schema> {
+  /**
+   * A description of the header. CommonMark syntax MAY be used for rich text representation.
+   */
+  description?: string;
+  /**
+   * The schema defining the type used for the header.
+   */
+  schema?: Schema | OpenSpecRef;
+  /**
+   * Additional external documentation for this tag.
+   */
+  externalDocs?: OpenSpecExternalDocs;
+}

package/src/openspec3/OS3Link.ts

@@ -0,0 +1,25 @@
+import {OpenSpecHash} from "../common/OpenSpecHash.js";
+import {OS3Server} from "./OS3Server.js";
+
+export interface OS3Link {
+  /**
+   * A relative or absolute reference to an OAS operation. This field is mutually exclusive of the operationId field, and MUST point to an Operation Object. Relative operationRef values MAY be used to locate an existing Operation Object in the OpenAPI definition.
+   */
+  operationRef?: string;
+  /**
+   * The name of an existing, resolvable OAS operation, as defined with a unique operationId. This field is mutually exclusive of the operationRef field.
+   */
+  operationId?: string;
+  /**
+   * A map representing parameters to pass to an operation as specified with operationId or identified via operationRef. The key is the parameter name to be used, whereas the value can be a constant or an expression to be evaluated and passed to the linked operation. The parameter name can be qualified using the parameter location [{in}.]{name} for operations that use the same [parameter name](https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.0.1.md#parameterIn) in different locations (e.g. path.id).
+   */
+  parameters?: OpenSpecHash<any>;
+  /**
+   * A description of the link. CommonMark syntax MAY be used for rich text representation.
+   */
+  description?: string;
+  /**
+   * A server object to be used by the target operation.
+   */
+  server?: OS3Server;
+}

package/src/openspec3/OS3MediaType.ts

@@ -0,0 +1,24 @@
+import {OpenSpecHash} from "../common/OpenSpecHash.js";
+import {OpenSpecRef} from "../common/OpenSpecRef.js";
+import {OS3Encoding} from "./OS3Encoding.js";
+import {OS3Example} from "./OS3Example.js";
+import {OS3Schema} from "./OS3Schema.js";
+
+export interface OS3MediaType<Schema = OS3Schema> {
+  /**
+   * The schema defining the type used for the request body.
+   */
+  schema?: Schema | OpenSpecRef;
+  /**
+   * Example of the media type. The example object SHOULD be in the correct format as specified by the media type. The example field is mutually exclusive of the examples field. Furthermore, if referencing a schema which contains an example, the example value SHALL override the example provided by the schema.
+   */
+  example?: any;
+  /**
+   * Examples of the media type. Each example object SHOULD match the media type and specified schema if present. The examples field is mutually exclusive of the example field. Furthermore, if referencing a schema which contains an example, the examples value SHALL override the example provided by the schema.
+   */
+  examples?: OpenSpecHash<OS3Example | OpenSpecRef>;
+  /**
+   * A map between a property name and its encoding information. The key, being the property name, MUST exist in the schema as a property. The encoding object SHALL only apply to requestBody objects when the media type is `multipart` or `application/x-www-form-urlencoded`.
+   */
+  encoding?: OpenSpecHash<OS3Encoding>;
+}

package/src/openspec3/OS3Operation.ts

@@ -0,0 +1,70 @@
+import {OpenSpecExternalDocs} from "../common/OpenSpecExternalDocs.js";
+import {OpenSpecHash} from "../common/OpenSpecHash.js";
+import {OpenSpecSecurity} from "../common/OpenSpecSecurity.js";
+import {OS3Callbacks} from "./OS3Callbacks.js";
+import {OS3Parameter} from "./OS3Parameter.js";
+import {OS3RequestBody} from "./OS3RequestBody.js";
+import {OS3Response} from "./OS3Response.js";
+import {OS3Schema} from "./OS3Schema.js";
+import {OS3Server} from "./OS3Server.js";
+
+export interface OS3Operation<Schema = OS3Schema, Parameter = OS3Parameter<Schema>, Response = OpenSpecHash<OS3Response<Schema>>> {
+  /**
+   * Unique string used to identify the operation. The id MUST be unique among all operations described in the API. Tools and libraries MAY use the operationId to uniquely identify an operation, therefore, it is RECOMMENDED to follow common programming naming conventions.
+   */
+  operationId: string;
+  /**
+   * A verbose explanation of the operation behavior. CommonMark syntax MAY be used for rich text representation.
+   */
+  description?: string;
+  /**
+   * A short summary of what the operation does.
+   */
+  summary?: string;
+  /**
+   * A list of tags for API documentation control. Tags can be used for logical grouping of operations by resources or any other qualifier.
+   */
+  tags?: string[];
+  /**
+   * Additional external documentation for this operation.
+   */
+  externalDocs?: OpenSpecExternalDocs;
+  /**
+   * A list of parameters that are applicable for this operation. If a parameter is already defined at the [Path Item](https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.0.1.md#pathItemParameters),
+   * the new definition will override it but can never remove it.
+   * The list MUST NOT include duplicated parameters. A unique parameter is defined by a combination of a [name](https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.0.1.md#parameterName) and (location)[https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.0.1.md#parameterIn].
+   * The list can use the [Reference Object](https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.0.1.md#referenceObject) to link to parameters that are defined at the [OpenAPI Object's components/parameters](https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.0.1.md#componentsParameters).
+   */
+  parameters?: Parameter[];
+  /**
+   * The request body applicable for this operation.
+   * The requestBody is only supported in HTTP methods where the HTTP 1.1 specification [RFC7231](https://tools.ietf.org/html/rfc7231#section-4.3.1) has explicitly defined semantics for request bodies.
+   * In other cases where the HTTP spec is vague, requestBody SHALL be ignored by consumers.
+   */
+  requestBody?: OS3RequestBody<Schema>;
+  /**
+   * The list of possible responses as they are returned from executing this operation.
+   */
+  responses: Response;
+  /**
+   * Declares this operation to be deprecated. Consumers SHOULD refrain from usage of the declared operation. Default value is false.
+   */
+  deprecated?: boolean;
+  /**
+   * A declaration of which security mechanisms can be used for this operation. The list of values includes alternative security requirement objects that can be used.
+   * Only one of the security requirement objects need to be satisfied to authorize a request.
+   * This definition overrides any declared top-level [security](https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.0.1.md#oasSecurity). To remove a top-level security declaration, an empty array can be used.
+   */
+  security?: OpenSpecSecurity;
+  /**
+   * An alternative server array to service this operation. If an alternative server object is specified at the Path Item Object or Root level, it will be overridden by this value.
+   */
+  servers?: OS3Server[];
+  /**
+   * A map of possible out-of band callbacks related to the parent operation.
+   * The key is a unique identifier for the [Callback Object](https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.0.1.md#callbackObject).
+   * Each value in the map is a Callback Object that describes a request that may be initiated by the API provider and the expected responses.
+   * The key value used to identify the callback object is an expression, evaluated at runtime, that identifies a URL to use for the callback operation.
+   */
+  callbacks?: OS3Callbacks<Schema>;
+}

package/src/openspec3/OS3Parameter.ts

@@ -0,0 +1,83 @@
+import {OpenSpecHash} from "../common/OpenSpecHash.js";
+import {OpenSpecRef} from "../common/OpenSpecRef.js";
+import {OS3Example} from "./OS3Example.js";
+import {OS3MediaType} from "./OS3MediaType.js";
+import {OS3Schema} from "./OS3Schema.js";
+
+export type OS3StyleParameter = "matrix" | "label" | "form" | "simple" | "spaceDelimited" | "pipeDelimited" | "deepObject";
+
+export interface OS3Parameter<Schema = OS3Schema> {
+  /**
+   *The name of the parameter. Parameter names are case sensitive.
+   *
+   * - If [`in`](https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.0.1.md#parameterIn) is `"path"`, the `name` field MUST correspond to the associated [path](https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.0.1.md#pathsPath) segment from the path field in the [Paths Object](https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.0.1.md#pathsObject). See [Path Templating](https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.0.1.md#pathTemplating) for further information.
+   * - If [`in`](https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.0.1.md#parameterIn) is `"header"` and the `name` field is `"Accept"`, `"Content-Type"` or `"Authorization"`, the parameter definition SHALL be ignored.
+   * - For all other cases, the `name` corresponds to the parameter name used by the [`in`](https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.0.1.md#parameterIn) property.
+   */
+  name: string;
+  /**
+   * The location of the parameter. Possible values are `"query"`, `"header"`, `"path"` or `"cookie"`.
+   */
+  in: "path" | "query" | "header" | "cookie";
+  /**
+   * Determines whether this parameter is mandatory. If the [parameter location](Determines whether this parameter is mandatory.
+   * If the parameter location is `"path"`, this property is **REQUIRED** and its value MUST be `true`.
+   * Otherwise, the property MAY be included and its default value is false.) is `"path"`, this property is **REQUIRED** and its value MUST be `true`.
+   * Otherwise, the property MAY be included and its default value is `false`.
+   */
+  required: boolean;
+  /**
+   * A brief description of the parameter. This could contain examples of use. CommonMark syntax MAY be used for rich text representation.
+   */
+  description?: string;
+  /**
+   * Specifies that a parameter is deprecated and SHOULD be transitioned out of usage.
+   */
+  deprecated?: boolean;
+  /**
+   * Sets the ability to pass empty-valued parameters.
+   * This is valid only for query parameters and allows sending a parameter with an empty value.
+   * Default value is `false`.
+   * If style is used, and if behavior is `n/a` (cannot be serialized), the value of `allowEmptyValue` SHALL be ignored.
+   */
+  allowEmptyValue?: boolean;
+  /**
+   * The schema defining the type used for the parameter.
+   */
+  schema?: OS3Schema | OpenSpecRef;
+  /**
+   * Describes how the parameter value will be serialized depending on the type of the parameter value.
+   * Default values (based on value of in): for `query` - `form`; for `path` - `simple`; for `header` - `simple`; for `cookie` - `form`.
+   * See [style values](https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.0.1.md#style-values).
+   */
+  style?: OS3StyleParameter;
+  /**
+   * When this is true, parameter values of type array or object generate separate parameters for each value of the array or key-value pair of the map.
+   * For other types of parameters this property has no effect. When style is form, the default value is true. For all other styles, the default value is false.
+   */
+  explode?: boolean;
+  /**
+   * Determines whether the parameter value SHOULD allow reserved characters, as defined by [RFC3986](https://tools.ietf.org/html/rfc3986#section-2.2) `:/?#[]@!$&'()*+,;=` to be included without percent-encoding.
+   * This property only applies to parameters with an `in` value of `query`. The default value is `false`.
+   */
+  allowReserved?: boolean;
+  /**
+   * Example of the media type.
+   * The `example` SHOULD match the specified schema and encoding properties if present.
+   * The `example` field is mutually exclusive of the `examples` field.
+   * Furthermore, if referencing a `schema` which contains an example, the `example` value SHALL override the example provided by the schema.
+   * To represent examples of media types that cannot naturally be represented in JSON or YAML, a string value can contain the example with escaping where necessary.
+   */
+  example?: any;
+  /**
+   * Examples of the media type.
+   * Each example SHOULD contain a value in the correct format as specified in the parameter encoding.
+   * The `examples` field is mutually exclusive of the `example` field.
+   * Furthermore, if referencing a `schema` which contains an example, the examples value SHALL override the example provided by the schema.
+   */
+  examples?: OpenSpecHash<OS3Example | OpenSpecRef>;
+  /***
+   * A map containing the representations for the parameter. The key is the media type and the value describes it. The map MUST only contain one entry.
+   */
+  content?: OpenSpecHash<OS3MediaType>;
+}

package/src/openspec3/OS3Paths.ts

@@ -0,0 +1,29 @@
+import {OpenSpecPath} from "../common/OpenSpecPath.js";
+import {OpenSpecRef} from "../common/OpenSpecRef.js";
+import {OS3Operation} from "./OS3Operation.js";
+import {OS3Parameter} from "./OS3Parameter.js";
+import {OS3Schema} from "./OS3Schema.js";
+import {OS3Server} from "./OS3Server.js";
+
+export interface OS3Paths<Schema = OS3Schema> extends OpenSpecPath<OS3Operation<Schema>> {
+  /**
+   * An optional, string summary, intended to apply to all operations in this path.
+   */
+  summary?: string;
+  /**
+   * An optional, string description, intended to apply to all operations in this path. CommonMark syntax MAY be used for rich text representation.
+   */
+  description?: string;
+  /**
+   * A definition of a TRACE operation on this path.
+   */
+  trace?: OS3Operation<Schema>;
+  /**
+   * An alternative server array to service all operations in this path.
+   */
+  servers?: OS3Server[];
+  /**
+   * A list of parameters that are applicable for all the operations described under this path. These parameters can be overridden at the operation level, but cannot be removed there. The list MUST NOT include duplicated parameters. A unique parameter is defined by a combination of a name and location. The list can use the Reference Object to link to parameters that are defined at the OpenAPI Object's components/parameters.
+   */
+  parameters?: (OS3Parameter<Schema> | OpenSpecRef)[];
+}

package/src/openspec3/OS3RequestBody.ts

@@ -0,0 +1,22 @@
+import {OpenSpecHash} from "../common/OpenSpecHash.js";
+import {OpenSpecRef} from "../common/OpenSpecRef.js";
+import {OS3Example} from "./OS3Example.js";
+import {OS3MediaType} from "./OS3MediaType.js";
+import {OS3Schema} from "./OS3Schema.js";
+
+export interface OS3RequestBody<Schema = OS3Schema> {
+  /**
+   * A brief description of the request body. This could contain examples of use. CommonMark syntax MAY be used for rich text representation.
+   */
+  description?: string;
+  /**
+   * A map containing descriptions of potential request body. The key is a media type or [media type range](https://tools.ietf.org/html/rfc7231#appendix-D) and the value describes it. For responses that match multiple keys, only the most specific key is applicable. e.g. text/plain overrides text/*
+   */
+  content?: OpenSpecHash<OS3MediaType<Schema>>;
+  /**
+   * Determines if the request body is required in the request. Defaults to false.
+   */
+  required?: boolean;
+
+  examples?: OpenSpecHash<OS3Example | OpenSpecRef>;
+}

package/src/openspec3/OS3Response.ts

@@ -0,0 +1,25 @@
+import {OpenSpecHash} from "../common/OpenSpecHash.js";
+import {OpenSpecRef} from "../common/OpenSpecRef.js";
+import {OS3Header} from "./OS3Header.js";
+import {OS3Link} from "./OS3Link.js";
+import {OS3MediaType} from "./OS3MediaType.js";
+import {OS3Schema} from "./OS3Schema.js";
+
+export interface OS3Response<Schema = OS3Schema, Header = OS3Header<Schema>> {
+  /**
+   * A short description of the response. CommonMark syntax MAY be used for rich text representation.
+   */
+  description: string;
+  /**
+   * Maps a header name to its definition. [RFC7230](https://tools.ietf.org/html/rfc7230#page-22) states header names are case insensitive. If a response header is defined with the name "Content-Type", it SHALL be ignored.
+   */
+  headers?: OpenSpecHash<Header>;
+  /**
+   * A map containing descriptions of potential response payloads. The key is a media type or [media type range](https://tools.ietf.org/html/rfc7231#appendix-D) and the value describes it. For responses that match multiple keys, only the most specific key is applicable. e.g. text/plain overrides text/*
+   */
+  content?: OpenSpecHash<OS3MediaType<Schema>>;
+  /**
+   * A map of operations links that can be followed from the response. The key of the map is a short name for the link, following the naming constraints of the names for [Component Objects](https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.0.1.md#componentsObject).
+   */
+  links?: OpenSpecHash<OS3Link | OpenSpecRef>;
+}

package/src/openspec3/OS3Schema.ts

@@ -0,0 +1,51 @@
+import {OpenSpecExternalDocs} from "../common/OpenSpecExternalDocs.js";
+import {OpenSpecBaseJsonSchema, OpenSpecJsonSchema} from "../common/OpenSpecJsonSchema.js";
+import {OpenSpecRef} from "../common/OpenSpecRef.js";
+import {OpenSpecXML} from "../common/OpenSpecXML.js";
+
+export interface OS3BaseSchema extends OpenSpecBaseJsonSchema {
+  /**
+   * Required if type is "array". Describes the type of items in the array.
+   */
+  items?: OS3Schema | OpenSpecRef;
+}
+
+export interface OS3Schema extends OpenSpecJsonSchema<OS3Schema> {
+  /**
+   * Inline or referenced schema MUST be of a [Schema Object](https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.0.1.md#schemaObject) and not a standard JSON Schema.
+   */
+  oneOf?: (OS3Schema | OpenSpecRef)[];
+  /**
+   * Inline or referenced schema MUST be of a [Schema Object](https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.0.1.md#schemaObject) and not a standard JSON Schema.
+   */
+  anyOf?: (OS3Schema | OpenSpecRef)[];
+  /**
+   * Inline or referenced schema MUST be of a [Schema Object](https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.0.1.md#schemaObject) and not a standard JSON Schema.
+   */
+  not?: OS3Schema | OpenSpecRef;
+  /**
+   * Allows sending a null value for the defined schema. Default value is false.
+   */
+  nullable?: boolean;
+  /**
+   * Adds support for polymorphism.
+   * The discriminator is the schema property name that is used to differentiate between other schema that inherit this schema. The property name used MUST be defined at this schema and it MUST be in the required property list. When used, the value MUST be the name of this schema or any schema that inherits it.
+   */
+  discriminator?: string;
+  /**
+   * Relevant only for Schema "properties" definitions. Declares the property as "read only". This means that it MAY be sent as part of a response but MUST NOT be sent as part of the request. Properties marked as readOnly being true SHOULD NOT be in the required list of the defined schema. Default value is false.
+   */
+  readOnly?: boolean;
+  /**
+   * Relevant only for Schema "properties" definitions. Declares the property as "write only". Therefore, it MAY be sent as part of a request but SHOULD NOT be sent as part of the response. If the property is marked as writeOnly being true and is in the required list, the required will take effect on the request only. A property MUST NOT be marked as both readOnly and writeOnly being true. Default value is false.
+   */
+  writeOnly?: boolean;
+  /**
+   * This MAY be used only on properties schemas. It has no effect on root schemas. Adds Additional metadata to describe the XML representation format of this property.
+   */
+  xml?: OpenSpecXML;
+  /**
+   * Additional external documentation for this schema.
+   */
+  externalDocs?: OpenSpecExternalDocs;
+}

package/src/openspec3/OS3Security.ts

@@ -0,0 +1,63 @@
+import {OS3Flows} from "./OS3Flows.js";
+
+export interface OS3SecurityBase {
+  /**
+   * The type of the security scheme
+   */
+  type: "apiKey" | "oauth2" | "http" | "openIdConnect";
+  /**
+   *
+   */
+  description?: string;
+}
+
+export interface OS3SecurityApiKey extends OS3SecurityBase {
+  /**
+   * The type of the security scheme
+   */
+  type: "apiKey";
+  /**
+   * The name of the header, query or cookie parameter to be used.
+   */
+  name: string;
+  /**
+   * The location of the API key. Valid values are `query`, `header` or `cookie`.
+   */
+  in: "query" | "header" | "cookie";
+}
+
+export interface OS3SecurityOAuth2 extends OS3SecurityBase {
+  /**
+   * The type of the security scheme
+   */
+  type: "oauth2";
+  /**
+   * An object containing configuration information for the flow types supported.
+   */
+  flows: OS3Flows;
+}
+
+export interface OS3SecurityOpenIDConnect extends OS3SecurityBase {
+  /**
+   * The type of the security scheme
+   */
+  type: "openIdConnect";
+  openIdConnectUrl: string;
+}
+
+export interface OS3SecurityHTTP extends OS3SecurityBase {
+  /**
+   * The type of the security scheme
+   */
+  type: "http";
+  /**
+   * The name of the HTTP Authorization scheme to be used in the [Authorization header as defined in RFC7235](https://tools.ietf.org/html/rfc7235#section-5.1).
+   */
+  scheme: string;
+  /**
+   * A hint to the client to identify how the bearer token is formatted. Bearer tokens are usually generated by an authorization server, so this information is primarily for documentation purposes.
+   */
+  bearerFormat?: string;
+}
+
+export type OS3Security = OS3SecurityApiKey | OS3SecurityHTTP | OS3SecurityOAuth2 | OS3SecurityOpenIDConnect;