CHANGELOG.md

Change Log - @typespec/rest

This log was last generated on Tue, 07 Feb 2023 21:56:17 GMT and should not be manually modified.

0.40.0

Tue, 07 Feb 2023 21:56:17 GMT

Updates

• Give KeysOf and ParentKeysOf friendly name to dedupe parameters
• Removed @segmentSeparator, @produces and @consumes decorators. Removed getSegmentSeparator, getProduces and getConsumes functions.
• Allow @route and @autoRoute to be used together.

0.39.0

Fri, 13 Jan 2023 00:05:26 GMT

Patches

• Support query/header/path encoding options
• Generate recursive update schemas with optional properties for resource update operation

0.38.1

Wed, 14 Dec 2022 20:34:58 GMT

Patches

• Fix: Broken doc comment causing IDE build to not show errors

0.38.0

Wed, 07 Dec 2022 17:21:52 GMT

Minor changes

• Internal: update to use new getTypeName and getNamespaceString helper
• Add validation for @route to prevent @route used twice on the same operation/interface/namespace
• Add support for multiple services
• Uptake changes to compiler api to support Scalars
• Add @actionSegment decorator. Deprecate @segmentSeparator.
• Update ResourceLocation to extends url instead of deprecated uri
• Validate multipart/form-data request body is a Model
• Deprecation Updated the HttpOperationParameters interface to include a new body field replacing the bodyType and bodyParameter.

Patches

• Add typespec docs on decorators
• Update docs.
• Update dependencies

0.19.0

Sat, 12 Nov 2022 00:14:04 GMT

Minor changes

• Declare decorators in typespec using extern dec
• Add MetadataInfo.getEffectivePayloadType helper
• Deprecate write visibility
• Allow @route and @resetRoute to accept a shared property to suppress route uniqueness validation.

Patches

• Fix: Issue with duplicate key in spread models
• Move duplicate-parent-key check from the parentResource decorator to a linting rule

0.18.0

Wed, 12 Oct 2022 21:12:35 GMT

Minor changes

• Empty object as a response will not produce a 204 response anymore
• Feature: Add isContentTypeHeader helper.
• Implement automatic visibility transformations
• BREAKING Remove @discriminator decorator. (Moved to @typespec/compiler)
• Disallow optional path params even if they have a default value
• Add support for overloads(Using @overload decorator)
• Reorganization of http data accessor. getAllRoutes is now deprecated and replaced with getAllHttpServices
• ResourceLocation<T> is uri

Patches

• Remove workaround for issue microsoft#1069
• Detect unannotated path parameters that are specified in route path

0.17.0

Thu, 08 Sep 2022 01:04:53 GMT

Minor changes

• Deprecation: Mark @produces and @consumes as deprecated
• Uptake changes to compiler with current projection
• Update decororator state key to allow multiple instance of library to work together.
• React to Type suffix removal
• BREAKING CHANGE Rename Page to CollectionWithNextLink
• Fix doc for route and move autoRoute to rest library
• Api: Service Authentication oauth2 flow scopes is now an object with value and description

Patches

• Api: Route resolution take projection into account
• Guard against uninitialized parent type in parentResource decorator
• Support more kinds of unions, fix various union bugs, and add support for @discriminator on unions

0.16.0

Thu, 11 Aug 2022 19:05:23 GMT

Minor changes

• Add new @useAuth decorator providing support to define service authentication
• Uptake changes to type relations
• Update resource operation interfaces to configure Create and Update model properties correctly
• Support set of unannotated parameters as request body
• Add friendly name for Page as TPage
• Make OkResponse non-generic
• Remove groupName from OperationDetails
• Emit diagnostic when defining @path property that is optional without a default value
• Update route resolution logic to be more consistent. If service namespace is provided use routes under otherwise use routes directly at the global namespace level(do not go into the nested namespaces)
• Internal: Uptake new compiler helpers to work with template types

Patches

• Add a @resource decorator to simplify how one defines resource types and specifies the collection (segment) name
• Add ResourceCreateOrReplace type and createsOrReplaces decorator to model an "upsert" operation
• Improve cloneKeyProperties implementation so that original model type is not affected
• Ensure that all @key properties turned into @path parameters by KeysOf are required even if the original is optional
• Operations with a body and no verb will default route to POST
• Add ResourceLocation<T> to mark a property as containing a link to a specific resource type
• Make response descriptions more consistent

Updates

• readme.md documentation change

0.15.1

Fri, 08 Jul 2022 23:22:57 GMT

Patches

• $consumes decorator better validation
• Add @collectionAction decorator for defining collection-level resource actions
• Make string literal "Content-Type" header check case-insensitive

0.15.0

Mon, 13 Jun 2022 23:42:28 GMT

Minor changes

• Uptake changes to compiler with decorator validator helpers
• Update accessor functions getAllRoutes, getContentTypes, etc. to follow the new Accessor pattern which return any encountered diagnostics along with the expected value
• Uptake changes to decorator context
• Added @server decorator to specify namespace endpoints
• Fix decorator and functions not belonging to a namespace

Patches

• Properly exclude operation templates when scanning for routes
• Skip templated operations when scanning for operation routes
• Enable customization of route segment separators in autoRoutes

Updates

• Upgrade to TS4.7

0.14.0

Fri, 06 May 2022 17:19:57 GMT

Minor changes

• Add RouteOptions and AutoRouteOptions types to enable customization of automatic route generation when calling getAllRoutes
• Uptake mixes -> extends rename
• Remove node 14 support

Patches

• Fix issue where empty response model with children would result in 204"
• Add validation to Resource interface to ensure TError is an error type

0.13.0

Thu, 31 Mar 2022 17:10:49 GMT

Minor changes

• Handle error type being passed to KeyOf model
• Add validation when using Resource interfaces when missing @key on resource
• Add logic to interpret the http responses.

Patches

• Fix issue with empty routes in namespace/interface and operation causing path with '//'
• Support browser builds
• Raise a diagnostic when a resource type specifies a parent type which holds the same key name.

0.12.0

Wed, 09 Mar 2022 17:42:09 GMT

Minor changes

• Move @key decorator to core

Patches

• Filter out string literal typed path parameters when generating routes automatically

0.11.0

Tue, 15 Feb 2022 22:35:02 GMT

Minor changes

• Add validation to decorators

0.10.0

Mon, 14 Feb 2022 03:01:07 GMT

Minor changes

• refactor status code handling to http library
• Update decorators to take in api change

Patches

• Bump dependency versions

0.9.0

Fri, 04 Feb 2022 18:00:18 GMT

Minor changes

• Add support for discriminator decorator
• Internals: switch to internal path manipulation
• Added shared logic to resolve http operation parameters and validate compatibility(duplicate bodies)
• Added Validation for uniqueness of operation by verb and path
• Added @head decorator to describe head http verb operation
• Validate http verb decorators(@get, @post, etc.) do not receive any argument
• Expose response template in Http library and refactor
• Add statusCode decorator for http status code
• **Validate @route decorator is used only once
• Update typespec dependencies to peerDependencies

Patches

• Move @key, @parentResource, and @copyResourceKeyParameters decorators into TypeSpec.Rest
• Operations marked with @action will now default to POST verb unless another verb has been explicitly specified
• Add interfaces for modelling extension and singleton resources
• Fix Duplicate @key on model properties will produce diagnostic instead of exception

0.8.0

Thu, 16 Dec 2021 08:02:20 GMT

Minor changes

• Add TypeSpec.Http.PlainData

Patches

• Adding @CreateOrUpdate (PUT) and standard operation in REST.
• camelCase operations
• Add new route scanning functionality which provides the same capabilities (both explicit and autogenerated routes) to normal operations and those defined inside of interfaces

Updates

• Formatting changes

0.7.1

Wed, 01 Dec 2021 22:56:11 GMT

Patches

• Add README

0.7.0

Thu, 18 Nov 2021 13:58:15 GMT

Minor changes

• Refactor REST and HTTP decorators and split them into TypeSpec.Rest and TypeSpec.Http, respectively

Patches

• Add new TypeSpec.Rest.Resource namespace for new resource modelling pattern
• Add documentation strings to models and operations

0.6.4

Thu, 11 Nov 2021 21:46:21 GMT

Version update only

0.6.3

Thu, 28 Oct 2021 21:17:50 GMT

Patches

• Remove management.azure.com service host default

0.6.2

Fri, 15 Oct 2021 21:33:37 GMT

Patches

• Strongly defined diagnostics

0.6.1

Fri, 17 Sep 2021 00:49:37 GMT

Version update only

0.6.0

Sat, 21 Aug 2021 00:04:02 GMT

Minor changes

• Introduce naming convention $name for JavaScript-defined TypeSpec functions and decorators

0.5.1

Fri, 13 Aug 2021 19:10:21 GMT

Patches

• Add isHeader functionality to discover if a property is a header property

0.5.0

Tue, 10 Aug 2021 20:23:04 GMT

Minor changes

• Rename package to @typespec/rest

0.4.1

Mon, 09 Aug 2021 21:14:12 GMT

Version update only

0.4.0

Mon, 02 Aug 2021 18:17:00 GMT

Minor changes

• Rename ADL to TypeSpec

0.3.2

Wed, 28 Jul 2021 19:40:06 GMT

Patches

• Add additional api to support code generation and host property

0.3.1

Fri, 09 Jul 2021 20:21:06 GMT

Version update only

0.3.0

Thu, 24 Jun 2021 03:57:43 GMT

Minor changes

• Add semantic error recovery

0.2.1

Tue, 18 May 2021 23:43:31 GMT

Version update only

0.2.0

Thu, 06 May 2021 14:56:01 GMT

Minor changes

• Implement alias and enum, remove model =

Patches

• Added New type NoContentResponse
• Replace several internal compiler errors with diagnostics

0.1.2

Tue, 20 Apr 2021 15:23:29 GMT

Initial release