Smithy Changelog

1.37.0 (2023-08-22)

Features

Formatted operation errors onto multiple lines (#1933)
Added support for creating specific TreeType to smithy-syntax (#1925)
Added validator for services with noAuth trait (#1929)
Added ServiceIndex method for noAuth scheme (#1924)
Added warning on addition of required trait (#1923)
Added versioning for API Gateway defaults (#1916)
Added support for enum map keys with OpenApi 3.1.0 (#1905)
Added support for suppressions to smithy-diff (#1861)
Added specificationExtension trait for OpenAPI extensions (#1609)
Added conditionKeyValue and conditionKeysResolvedByService traits (#1677)

Documentation

Updated getAuthSchemes javadoc (#1930)
Clarified default and clientOptional traits (#1920)
Fixed version numbers in smithy-build.json examples (#1918)
Clarified ordering of auth schemes in ServiceIndex (#1915)
Included prelude in spec (#1913)

Bug Fixes

Fixed assembler addTraits for some resource models (#1927)

1.36.0 (2023-08-03)

Features

Allowed disabling format on integers when converting to OpenAPI (#1904)
Added intEnum support when converting to OpenAPI (#1898)
Added support for overriding validation severity (#1890)
Added disableDefaultValues option when converting to OpenAPI (#1887)
Updated brew workflow to use new smithy tap (#1897)
Added progress tracker and message for CLI while cloning a template (#1888)
Updated init command to honor quiet setting (#1889)
Updated appearance of smithy init list output (#1901)
Added exceptions for invalid paths in template definition (#1907)
Added Cache template directory in init command (#1896)
Check for existing directory when creating template with init (#1885)

Documentation

Clarified constraint trait enforcement (#1902)
Better document trait merging (#1895)
Updated docs to use new smithy-lang tap (#1893)
Added naming recommendations (#1892)

Bug Fixes

Fixed NPE when docId is null when ServiceTrait.equals is called (#1903)
Fixed off-by-one issues in TokenTree and TreeCursor (#1891)
Fixed snapshot dependency resolution (#1884)

Other

Use standard output for regular messages (#1894)

1.35.0 (2023-07-27)

Features

Enabled support for SNAPSHOT dependencies (#1853, #1857, #1884)
Enabled default mode for smithy diff rather than failing when not set (#1856)
Added warning to mis-cased standard HTTP verbs (#1862)
Relaxed type constraints for pageSize property of the @paginated trait (#1866)
Improved message for invalid .errors entries (#1867)
Added docId property to aws.api#service trait (#1863, #1872, #1881, #1882)
Improved validation for http binding protocols (#1873)
Expanded valid targets of @httpPayload (#1876)

Documentation

Updated documentation around timestamp and added more specificity to the definition (#1858)

Bug Fixes

Removed unrecognized models from sources (#1851, #1860)
Updated the content type of list & map shapes with the @httpPayload trait to document content type (#1840)
Fixed IDL serializer which would write emtpy apply statements to mixed in members of enums (#1865)
Fixed indentation when formatting text blocks (#1875)
Added resource files to source jars (#1877, #1880)
Fixed a potential resource leak by using a try with resources (#1878)

Other

Migrated to using Gradle 8.2.1 to build Smithy. This should have no impactful downstream effects (#1849)
Moved repository into smithy-lang organization and updated resources accordingly (#1852, #1854)

1.34.0 (2023-07-10)

Features

Added a default template for the smithy init command, making specifying templates optional (#1843)
Updated the model loader to skip unrecognized non-Smithy JSON files (#1846)

Bug Fixes

Fixed basic HTTP authentication when resolving dependencies in the Smithy CLI (#1838)
Fixed a bug when deduping ChangedNullability events (#1839)

Documentation

Replaced implementation docs with the awesome-smithy repository (#1845)
Removed support for fractional seconds from the http-date timestamp format (#1847)
Rephrased optional fractional precision and no UTC offset support for the date-time timestamp format (#1835)

1.33.0 (2023-06-21)

Features

Extended event ids for AddedOperationError, RemovedOperationError, AddedEntityBinding and RemovedEntityBinding diff events (#1797, #1803)
Added enum values to ids for ChangedEnumTrait diff events (#1807)
Added init command to Smithy CLI (#1802, #1825, #1832)
Added smithy-syntax package and smithy format command to Smithy CLI (#1830)

Bug Fixes

Fixed duplicated events for ChangedNullability alongside the AddedInputTrait / RemovedInputTrait (#1806)
Updated request compression trait protocol tests with regard to HTTP bindings and respective specification (#1831)

Documentation

Added smithy-dafny to code generators table (#1813)
Updated stale docs around MissingPaginatedTrait (#1814)
Fixed grammar rendering (#1815)
Updated recommendation for HTTP status code (#1818)
Fixed selector example (#1824)
Added note about how constraint traits affect backward compatibility (#1826)
Added guide on disabling authentication (#1791)

1.32.0 (2023-06-06)

Features

Refactor parsing and validation of list and map shapes. This improved validation output when unexpected members were present in these shapes (#1782)
Updated smithy-build to output projection failures only after all plugins finish running (failed or otherwise) (#1762)
Added new pluggable validation-event decorator capability. This allows for customizing of validation events through a service provider interface (#1774)
Added new diff-evaluator to emit events for when the @required trait is added to existing structures without a default (##1781)
Improved validation output for @default collisions (#1780)
Updated @httpQuery trait validation to prevent query-literal and query-param conflicts (#1786)
Updated default pagination flags to improve missing-pagination validation (#1764)
Updated SdkServiceIdValidator to emit DANGER events instead of ERROR events (#1772)
Updated ChangedEnumTrait evaluator to include specific ids, in order to differentiate specific events (#1787)
Added protocol tests to validate http-label escaping in the restXml protocol (#1759)
Added support for @externalDocs trait when converting operations in the OpenAPI converter (#1767)
Updated a handful of specifications in the smithy-grammar to improve parsability (#1788, #1790, #1792, #1793, #1800)

Bug Fixes

Fixed migrate CLI command to properly upgrade 1/1.0 models to 2/2.0 (#1579, #1769)
Fixed application of enum-mixins on empty enums (#1794)
Fixed handling of dangling doc-comments in structures (#1776)
Fixed several smithy-grammar typos and consistency issues (#1783)

Documentation

Added a warning about the limitations of request-validation in API-Gateway (#1765)
Updated CLI installation guide for Windows to be more idiomatic (#1757)
Updated protocol documentation pages to indicate support for the @requestCompression trait (#1763)

1.31.0 (2023-04-25)

Features

Added @requestCompression trait which indicates whether an operation supports compressed requests (#1748)
Improved IDL parser and added basic error recovery (#1733)
Added restJson1 protocol test for a list of structures missing a required key (#1735)
Added ability to order the output of the IDL serializer (#1727)

Bug Fixes

Updated conversion from string shape with @enum trait to enum shape to convert internal tag to @internal trait (#1739)

Documentation

Added documentation for changeStringEnumsToEnumShapes transformation (#1740)

1.30.0 (2023-04-10)

Features

Updated smithy-diff and smithy-build to use pretty validation output and color theming options (#1712)
Added --mode flag to smithy diff command with support for aribtrary, project, and git modes (#1724, #1721, #1718)
Added --flatten flag to AST command which flattens and removes mixins from the model (#1723)
Expose functions to make ruleEvaluator more flexible to support coverage checking (#1681)

Bug Fixes

Updated mixins to allow multiple mixins to override the same member if they all target the same shape (#1715)
Fixed an issue where source file names impacted the ordering of metadata (#1716)
Fixed error messages for invalid operation input/output bindings (#1728)
Fixed bugs in smithy-rules-engine boolEquals and stringEquals which could cause unexpected results when visitors are invoked (#1681)
Remove unnecessary member from aws.iam#actionName (#1726)

Documentation

Added guide on how to install the Smithy CLI (#1697)
Added examples of how smithy validators can be used to prevent common bugs and enforce common style (#1702)
Added clarification on meaning and use of @httpApiKeyAuth scheme property (#1714)
Reduced IDL ambiguity by replacing *SP with [SP] (#1711)

1.29.0 (2023-04-03)

Features

Added EnumTrait validation protocol test (#1679)
Added process based plugins to Smithy build (#1672)
Added GenerateOperationDirective to generate operation shapes separate from resources and services (#1676)
Added :root and :in selectors (#1690)
Added --show-traits to select command (#1692)
Added includePreludeShapes in model plugin (#1693)
Added aws.iam#actionName trait to override using the API operation name (#1679)
Improved resource property validation and error messages (#1694)
Improved CLI outputs for validation commands (#1695)
Optimized identity and neighbor selectors (#1691)
Refactored CLI to remove --severity from some commands (#1700)
Removed unused positional [] from diff command (#1703)

Bug Fixes

Ensured that the ValidationEvent listener gets all events when batch inclusions are used (#1698)
Fixed cp-R for linux, xcopy for windows in smithy-cli installers (#1686)
Fixed allowUnknownTraits for projection with import (#1685)
Fixed reversed parameters in diff message for RemovedOperationError (#1689)
Fixed hierarchical event ids lost when specifying a custom linter validator id or severity level (#1705)
Improved handling additionalSchema targeting an invalid shape (#1708)
Reduced IDL ambiguity by replacing *WS with [WS] (#1699)

Documentation

Added compatibility note to evolving models (#1669)
Fixed mixins usage examples in style guide (#1670)
Fixed type in primitive root-level example (#1687)
Removed recommendation to implement presence tracking when handling default values (#1682)
Removed OperationBody indefinite repetition in IDL (#1707)

1.28.1 (2023-03-09)

Features

Added a suite of compliance tests for selectors (#1643)

Bug Fixes

Fixed an issue with generating CloudFormation Resource Schemas when using the @nestedProperties trait (#1641)
Fixed an issue where enum shapes could not be used as resource identifiers (#1644)
Fixed an issue when comparing event ids for deprecated shapes (#1640)
Fixed an issue where "core" validation events were not suppressible (#1646)
Fixed an issue with NodeMapper's handling of lists of generic types (#1635)
Fixed various typos of the word "ignore", including for the NodeMapper.WhenMissing enum (#1652)
Fixed an issue where enum members were flagged by the MissingSensitiveTrait validator (#1661)
Updated the validation messages for uniqueItems malformed request tests (#1639)
Updated the validation messages for enum malformed request tests to not return internal values (#1658)
Fixed various issues with protocol tests (#1642, #1648, #1645)

1.28.0 (2023-02-24)

Features

Add client-only protocol tests for fractional second parsing (#1627)
Add protocol test for omitting empty http-query lists (#1629)
Add support for JSON Schema draft2020-12 (#1617)
Add hierarchical eventIds (#1527, #1631)
Preserve tag order in generated OpenAPI specification (#1604)
Add shapes generation order in CodegenDirector (#1615)

Bug Fixes

Remove reflected input values from validation protocol tests (#1622)
Fail ExamplesTraitValidator when both output and error are defined (#1599)
Fix mixin cycles being incorrectly detected (#1628)
Fix warnings in AST Loader for Resource and Operation Shapes with mixins (#1626)
Fix referenced components removed in openapi schema (#1595)
Fix OR condition in scoped attribute selector (#1618)
Fix passthroughBehavior casing on x-amzn-apigateway-integration (#1619)

Documentation

Clarify rules for escaping shapes bound to URIs (#1630)
Document Tree Sitter implementation (#1621)
Clarify handling of date-time offsets (#1597)
Add Smithy code generation guide (#1586, #1592)

1.27.2 (2023-01-30)

Features

Implement Comparable interface for TagObject and ExternalDocumentation (#1589)
Relax rule engine validation to support test auth schemes (#1590)
Ensure that AuthSchemes added to Endpoint builder retain parameter ordering (#1591)
Add intEnum coverage on map of string list (#1596)

Bug Fixes

Add source location to synthetic Enum trait (#1580)

Documentation

Minor fix to restJson1 docs (#1587)

1.27.1 (2023-01-11)

Features

Update protocol tests with datetime offset coverage (#1502)
Add protocol tests to cover @range for short, long and integer shapes (#1515)
Add exclude/include tranforms using selectors (#1534)
Add a parseArn test case for resources with : and / (#1537)
Move CDS warmup to the CLI directly (#1553)
Allow error rename and disallow error rename for all AWS protocols (#1554)
Add details to ModifiedTrait event id (#1560)

Bug Fixes

Fix deterministic order of properties (#1555)
Fix datetime offset restXml payload (#1559)
Fix RestJsonQueryStringEscaping protocol test (#1562)
Fix RestJsonAllQueryStringTypes protocol test (#1564)
Fix Upgrade1to2Command for Set shape (#1569)
Fix parameters to builder (#1571)

Documentation

Fix typo for NOTE under breaking change rules (#1552)

1.27.0 (2022-12-15)

Features

Add tests for ACCEPT * (#1365)
Test content-type modeled inputs without body (#1399)
Improve member not targeting a property error message to better hint at fix (#1501)
Add typechecking to EndpointRuleset build (#1507)
Add warnings for private access on traits (#1508)
Tweak class caching in node (de)serializers. (#1518, #1530)
Add Maven dependency resolution to the CLI (#1526)
Add details to TraitBreakingChange EventId (#1538)

Bug Fixes

Fix dedicated io transform leaving unused shapes (#1419)
Fix return type of substring method (#1504)
Fix quoted text grammar and parsing (#1535)
Fix backwards compatibility rules for the paginated trait (#1549)

Documentation

Make it clearer that assembly-name stripping is not a MUST in restJson1 (#1493)
Clarify service-level pagination configuration (#1514)
Document it is generally breaking to add/remove input trait (#1519)
Fix grammar for MapMembers (#1520)
Clarify that metadata has no namespace (#1521)
Update trailing line break, list member grammar (#1533)
Fix MapMembers grammar and update test (#1536)

1.26.4 (2022-11-22)

Bug Fixes

Fixed updating mixins when replacing shapes in transforms (1509)

1.26.3 (2022-11-17)

Features

Moved useIntegerType to jsonschema (1495)
Added intEnum protocol tests (1492)
Added timestampFormat protocol tests on target shapes (1440)
Added MissingSensitiveTraitValidator (1364)

Bug Fixes

Fixed applying protocol tests to correct operations (1477)
Fixed cfn-mutability for inherited identifiers (1465)
Fixed Resource shape properties Type entry (1415)

Documentation

Updated links to point to smithy.io (1497)
Fixed docs and fail on additional doc warnings (1496)
Fixed AbstractCodeWriter documentation (1490)

1.26.2 (2022-11-07)

Bug Fixes

Add missing regions and fix typo in partitions.json (#1487)

1.26.1 (2022-10-31)

Features

Added support for hierarchical event IDs in validation events, allowing for more granular suppression (#1466)
Removed the pattern from the @suppress trait's entry list, allowing them to match all validator IDs (#1455)
Added the ability to lint based on word boundaries for the ReservedWords validator (#1461)
Added a toNode method to the Partition class in smithy-rules-engine (#1449)
Added a warning when smithy-diff detects changes to traits that do not have definitions loaded (#1468)
Improved validation for members that target nullable shapes (#1454, 1460)
Added a hook to the CodegenDirector to allow for customization before shape generation (#1469)
Updated model assembling to always attempt model interop transforms (#1435)

Bug Fixes

Fixed a bug where transforms would not remove enum members (#1442, #1447)
Fixed a bug where documentation comments were dropped if they occurred after a member using the default value syntactic sugar (1459)
Fixed an issue where resource identifier collisions would cause a model to fail loading (#1453, #1474)
Added @private to the local traits for the AWS HttpConfiguration shape (#1445)
Fixed an issue with behavior defined in an awsQuery protocol test (#1444)
Fixed several protocol tests in the awsJson1_1 protocol test suite (#1392)
Fixed an incorrect application of the @httpMalformedRequestTests trait (#1467)

Documentation

Clarified streaming trait values and semantics (#1458)
Updated the identifier ABNF and parser (#1464)

1.26.0 (2022-10-10)

Features

Add support for missing authorizer members (#1426)
Add intEnum DirectedCodegen (#1434)
Add Smithy Rules Engine (unstable) (#1356)

Documentation

Fix intEnum example (#1432)
Fix javadoc for CodegenDirector.simplifyModelForServiceCodegen (#1433)

1.25.2 (2022-09-28)

Bug Fixes

Revert "Enforce private on traits (#1406)" (#1428)
Remove aws query compatible protocol test (#1424)

1.25.1 (2022-09-23)

Features

Warn when box trait found on union member (#1420)
Warn when default used with union member target (#1418)
Simplify ShapeId caching (#1411)
Update smithy-diff for strings with the enum trait to enum shapes (#1409)
Add support for 1.0 downgrades and serialization (#1403 and #1410)
Add AwsQueryCompatible trait (#1314)

Bug Fixes

Only emit deprecation of enum trait in 2.0 models (#1421)
Enforce private on traits (#1406)
Fix apply statement parsing and ABNF (#1414)
Add test for synthetic box traits on mixins (#1404)

Documentation

Add some clarifications to revised default value design doc (#1413)
Revise default value design doc to match recent updates (#1412)
Fix typo in migration guide (#1405)

1.25.0 (2022-09-13)

Made many improvements for Smithy 1.0 and 2.0 interoperability. (1394)

Features

Default traits can now coexist with required trais. This indicates that a member should be serialized, but it is a protocol-specific decision if and how this is enforced. This was a pattern that occurred in Smithy 1.0 models when a member was required and targeted a shape with a zero value.
Default traits can be added to root-level shapes. Any structure member that targets a shape marked with the default trait must repeat the default on the member. This removes the action at a distance problem observed in Smithy IDL 1.0 where a root level shape implicitly introduced a default zero value, and to know if that's the case for any member, you had to look through from the member to the target shape. This change allows us to know if a root level shape was boxed in IDL 1.0 too (root shapes with no default or a default set to anything other than the zero value was boxed).
Added the @addedDefault trait which is used to indicate that a @default trait was added to a member after it was initially released. This can be used by tooling to make an appropriate determination if generating a non-nullable type for the member is a backward compatible change. For example, if a generator only uses default zero values to generate non-nullable types, then the removal of the required trait and addition of a default trait would be a breaking change for them, so they can use addedDefault to ignore the default trait.
Add new NullableIndex modes for testing if a member is nullable based on the supported features of the generator. For example, some generators only make members non-optional when the member is set to the zero value of a type, so there is a NullableIndex check mode for that and other use cases.
When loading IDL 2.0 models, we will now patch synthetic box traits onto shapes that would have been considered boxed in Smithy IDL 1.0. This improves further interop with tooling that has not yet adopted Smithy IDL 2 or that hasn't yet migrated to use the NullableIndex abstraction.
When loading 1.0 models, rather than dropping the default trait from a member when the range trait of a shape is invalid for its zero value, we now instead emit only a warning for this specific case. This prevents changing the type and also doesn't lose the range constraint.
The Primitive* shapes in the prelude are no longer deprecated, and they now have a @default trait on them set to the zero value of the type. This makes these traits function exactly as they did in Smithy 1.0 models. Any member that targets one of these primitive prelude shapes must now also repeat the zero value of the target shape.
Added an optional nullability report to smithy-build that shows the computed nullability semantics of each member in a model. This can be used to better understand nullability semantics.
Added method to NumberNode to detect if it is set to zero. (#1385)
In ChangeShapeType transform, ignored types changes to same type. (#1397)

Bug fixes

Updated smithy-diff to not emit events when diffing a 1.0 model against the 2.0 serialized version of the model. This means that changes to the box trait are ignored unless the change impacts the nullability of the shape. Special handling was added to detect breaking changes with the default trait too (you can't change a default value of a root-level shape for example, you cannot change a default value of a shape to or from the zero value of a type as this might break code generators, etc). (1394)
smithy-diff is no longer reporting expected set shape to list shape transitions. Sets are deprecated and models are encouraged to migrate from sets to lists with the @uniqueItems trait. (1383)

Documentation

Fix operationOutputSuffix in example code snippet (#1393)
Fix ABNF grammar of inlined structure (1377)

1.24.0 (2022-08-30)

Features

Made string enum to enum shape transform opt-in in CodegenDirector. (#1370)
Updated @httpResponseCode to not be applicable to @input structures. (#1359)
Made some improvements in smithy-build. (#1366)

Bug fixes

Filtered out synthetic traits from build info. (#1374)
Fixed a log message when unable to convert string enum to enum shape. (#1372)

Documentation

Updated Smithy IDL ABNF Docs. (#1357)

1.23.1 (2022-08-18)

Features

Added new methods to help deserializing object nodes (#1350)
Added several (unstable) traits for endpoint resolution in the new smithy-rules-engine package (#1248)

Bug fixes

Fixed an issue where validation events were emitted twice (#1362)
Fixed a bug that was causing errors loading 1.0 models with @enum traits (#1358)
Fixed PostUnionWithJsonName and MalformedAcceptWithGenericString protocol test. (#1361, #1360)
Added missing readonly traits on HTTP GET tests (#1354)

Documentation

Fixed several documentation issues (#1355, #1353, #1349, #1347, #1346, #1345)

1.23.0 (2022-08-10)

Features

Added version 2.0 of the Smithy IDL. (#1317, #1312, #1318)
Added mixins for all shape types. (#889, #1025, #1139, #1323)
Added resource properties to version 2.0 of Smithy IDL. (#1213)
Added target elision for mixins/resources. (#1231)
Added inline operation IO shapes. (#963, #962, #1007)
Added validation for multiple IDL versions. (#917)
Added IDL 1.0 to 2.0 model migration tool. (#1175)
Added enum shapes. (#1088, #1114, #1133, #1313)
Added @clientOptional trait. (#1052, #1264)
Multiple traits can now be applied in a single apply statement. (#885)
Commas are now optional in the IDL. (#772, #776, #1166)
Added @default trait. (#1019, #1286, #1021, #1048, #920)
Sets can no longer be used in 2.0 models. Use a list with the @uniqueItems trait instead. Sets can still be used in 1.0 models, though a warning will be emitted. The SetShape in smithy-model is a subclass of ListShape, so new code generators can simply treat any SetShape like a ListShape. (#1292)
Migrated traits packages to use Smithy IDL definitions instead of JSON AST. (#1207)
Added @cfnDefaultValue trait (#1285)

Bug fixes

Made streaming blobs required/default. (#1209)
Fixed TextIndex to handle synthetic traits. (#1206)
Removed duplicate aws.protocols model file. (#1310)
Removed empty trait block serialization. (#1240)
Fixed trait source locations. (#1146, #1157)

Documentation

Added documentation for IDL 2.0 and changed location of 1.0 docs. (#1302, #1057)
Added IDL 1.0 to 2.0 migration guide. (#1065, #1074)
Updated the doc highlighter for IDL 2.0. (#1251)
Added documentation to IAM trait enums. (#1322)

1.22.0 (2022-06-30)

Breaking changes

Disallowed @sensitive trait on members. It must be applied the shape targeted by members. (#1226)
Deprecated set in favor of @uniqueItems. @uniqueItems can no longer target float, double and document. (#1278)

Features

Added breakingChanges property to @trait to specify more complex backward compatibility rules. (#1193)
Added automatic casing detection to CamelCaseValidator. (#1217)
Added --quiet flag to all CLI commands. (#1257)
Added CodeWriter support to pull named parameters from CodeSections. (#1256)
Added stack trace comment support to code writer. (#1198)
Added an automatic topological sorting of shape in DirectedCodegen. (#1214)
Updated CodegenDirector to generate shapes before generating service. (#1289)
Updated CodegenDirector to automatically use SymbolProvider.cache. (#1233)
Made SmithyIntegrations available from CodegenContext. (#1237)
Added helper to convert Symbol to SymbolReference. (#1220)
Updated NodeDiff to sort results to make them easier to understand. (#1238)
Implemented Comparable in SourceLocation. (#1192)
Added missing validation to ensure that unions have at least one member. (#1229)
Added validation to forbid impossibly recursive shapes. (#1200, #1212, #1253, #1269)
Added validation to warn when HTTP 204/205 responses have bodies. (#1254, #1276)
Added validation to forbid sparse maps with httpPrefixHeaders. (#1268)
Added ability to serialize the prelude. (#1275)
Added protocol tests for httpResponseCode. (#1241)

Bug fixes

Enabled the PostUnionWithJsonName protocol test. (#1239)
Fixed the MalformedAcceptWithGenericString compliance test. (#1243)

Documentation

Added definition for value equality for @uniqueItems. (#1278)
Added documentation for Smithy Server Generator for TypeScript. (#1119)
Added link to Smithy Diff from Evolving Models guide. (#1208)
Fixed constraint traits doc regarding non-structure members. (#1205)
Fixed typo in uniqueItems warning. (#1201)
Clarified @deprecated javadocs in smithy-codegen-core. (#1197)
Clarified Selectors documentation. (#1196)
Clarified meaning of Language in implementations. (#1191)
Clarified that constraint traits cascade for all members. (#1205)
Removed jsonName note from awsJson protocols. (#1279)

1.21.0 (2022-04-13)

Features

Added DirectedCodegen to make codegen simpler. (#1167, #1180)
Add ability to register interceptors with delegator. (#1165)
Optimized deprecated trait validation. (#1162)
Used ConcurrentSkipListMap in Model for knowledge instead of synchornized IdentityMap. (#1161)

Documentation

Added http and eventStreamHttp properties to AWS protocols. (#1172)

1.19.0 (2022-03-21)

Features

Disallowed requiresLength trait in output. (#1155, #1152)
Added validation that code in http trait is between 100 and 999. (#1156)
Added validation that uri in http trait uses ASCII characters. (#1154)
Allowed jsonName trait on union members. (#1153)
Improved Dockerfile support. (#1140)
Added support for conditions and loops to AbstractCodeWriter. (#1144)
Added a warning for missing ^ or $ anchors in @pattern trait. (#1141)
Added a validator to catch usage of non-inclusive words. (#931)
Added new classes for code writing and delegation, which deprecates the software.amazon.smithy.codegen.core.writer package. (#1131)
Added a warning for using @sensitive trait on members, which will be removed in IDL 2.0. (#1132)

Documentation

Documented the supported OpenAPI version. (#1151)
Added links to Scala generator and plugin. (#1145)

1.18.1 (2022-03-10)

Features

Downgraded set type violations from ERROR to WARNING to give consumers more time to convert these sets to lists. These will be upgraded to ERROR again in a future release. (#1125)

Bug Fixes

Fixed backwards compatibility of CodeWriter and created a new basic implementation of AbstractCodeWriter named SimpleCodeWriter. (#1123)
Fixed a bug in AbstractCodeWriter where indenting the next line would not be preserved after popping a state. (#1129)
Fixed a bug in AbstractCodeWriter where text could sometimes be lost due to lazy StringBuilder construction. (#1128)
Fixed a null pointer exception in ModelAssembler after calling reset(). (#1124)

Documentation

Removed examples showing @sensitive on structure members, which is deprecated in IDL 2.0. (#1127)

1.18.0 (2022-03-07)

Breaking changes

Sets can now only contain byte, short, integer, long, bigInteger, bigDecimal, and string shapes. Sets with other types of values are either difficult to implement in various programming languages (for example, sets of floats in Rust), or highly problematic for client/server use cases. Clients that are out of sync with a service model could receive structures or unions from a service, not recognize new members and drop them, causing the hash codes of members of the set to collide, and this would result in the client discarding set entries. For example, a service might return a set of 3 structures, but when clients deserialize them, they drop unknown members, and the set contains fewer than 3 entries.

Existing models that already use a set of other types will need to migrate to use a list rather than a set, and they will need to implement any necessary uniqueness checks server-side as needed. (#1106)

NOTE: This restriction was downgraded to a WARNING in 1.18.1
Removed unused UseShapeWriterObserver and related features. (#1117)

Features

Added interfaces for Codegen integrations, interceptors, and contexts. (#1109, #1118)
Added support for typed sections, prependers and appenders, and more explicit newline control to CodeWriter. (#1110)
Added built-in Symbol and Call formatters, a typed context, and debug info to CodeWriter. (#1095, #1104)
Added a DependencyTracker for Symbols. (#1107)
Rewrote CodeFormatter to be easier to understand and evolve. (#1104)
Exposed CodegenWriter's DocumentationWriter. (#1083)
Improved error messages from SmithyBuilder. (#1100)
Reduced copies made in smithy-codegen-core and smithy-build. (#1103)
Added non-optional method for @httpMalformedRequestTest uris. (#1108)
Added multi-code-unit characters to @length validation tests. (#1092)
Added malformed request tests for set types. (#1094)
Clarified a message for @httpPayload binding errors. (#1113)
Deprecated onSectionAppend and onSectionPrepend. (#1110)

Bug Fixes

Fixed an incorrect warning when the errors property was set on a service. (#1120)
Fixed various issues in protocol tests. (#1084, #1040)
Fixed a failing code path in SmithyBuild. (#1100)

Documentation

Added note about escaping \ in @pattern. (#1091)
Clarified error serialization behavior for @restJson1. (#1099)
Clarified defaulting behavior of @httpResponseCode. (#1111)
Clarified behavior of the sources plugin. (#977)
Clarified how @length interacts with UTF-8 encoding. (#1089)
Fixed an @idRef example. (#1087)

Other

Migrated to using Gradle 7.3.3 to build Smithy. This should have no impactful downstream effects. (#1085)

1.17.0 (2022-02-04)

Bug Fixes

Updated @streaming validation for protocols that support @httpPayload. (#1076)

Features

Added ability to serialize the JMESPath AST. (#1059)
Update CodeWriter to add getters and ability to copy settings. (#1067)

Documentation

Clarified outputToken. (#1056)
Removed repeated words. (#1063)
Clarified server behavior for query parameter deserialization. (#1080)

Other

Updated traits to preserve the original Node value from the model. (#1047)

1.16.3 (2022-01-13)

Bug Fixes

Removed @internal from the @unitType trait. (#1054)
Fixed JMESPath and-expression evaluation to correctly provide the result of the left expression when it is falsey. #1053
Fixed quoted string headers restJson1 response protocol test. #1049

1.16.2 (2022-01-10)

Features

Renamed StutteredShapeName validator to RepeatingShapeName and added an exactMatch configuration to let it more precisely prevent problematic models. (#1041)
Reduced the severity of HttpBindingsMissing events for services that do not use protocols that support the @http trait. (#1044)
Added unwrite() to CodeWriter. (#1038)

Bug Fixes

Fixed the RestJsonInputUnionWithUnitMember protocol test. (#1042)

Documentation

Updated the documentation for pagination. (#1043)

1.16.1 (2022-01-06)

Features

Make smithy.api#Unit easier to adopt by excluding direct relationships between it and operation inputs and outputs. (#1034)

Bug Fixes

Fixed character escaping in a restJson1 protocol test. (#1035)

1.16.0 (2022-01-03)

Features

Added smithy.api#Unit and @input and @output traits. (#980, #1005)
Removed support for collection values for @httpPrefixHeaders. (#1022)
Added a protocol test for handling path segments that contain regex expressions. (#1018)

Bug Fixes

Removed jsonName from the awsJson protocol tests and documentation. (#1026)
Reverted changes to timestamp list header serialization protocol tests. (#1023)
Fixed links in the search results of Smithy's javadocs. (#1009)
Fixed duplication of validation events for conflicting names. (#999)

Documentation

Added links to Kotlin and Swift generators. (#1020)
Clarified matching of URIs where greedy labels have no matching segment. (#1013)

Other

Added minor optimizations. (#1028, #1027, #1004)
Added Apple silicon target for smithy-cli. (#1012)
Updated smithy-cli to use JDK 17. (#1003)

1.15.0 (2021-12-02)

Features

Added protocol tests for quoted strings in headers. (#986)

Bug Fixes

Fixed filterSuppressions transform's handling of members. (#989)
Fixed http-content-type protocol tests. (#993)

Documentation

Fixed documentation regarding @length and @auth traits. (#988, #997)
Added documentation for httpMalformedRequestTests. (#973)

Other

Upgraded to use version 0.6.0 of the Smithy Gradle Plugin. (#996)
Reduced number of copies builders need to make when building up immutable objects. (#995)
Ensured InputStreams in loader are closed. (#991)

1.14.1 (2021-11-15)

Features

Updated the @aws.protocols#httpChecksum trait to use uppercase algorithm names. (#982)

Bug Fixes

Fixed an issue where JSON Schema conversion wouldn't remove out-of-service references before deconflicting. (#978)
Fixed IAM condition key inference not using the @aws.iam#iamResource trait. (#981)

1.14.0 (2021-11-10)

Features

Added the @aws.protocols#httpChecksum trait to describe checksumming behavior for operations. (#972)

Bug Fixes

Fixed a bug that used a JSON pointer instead of names when generating CloudFormation Resource Schema required properties. (#971)

Documentation

Clarified parsing of members marked with the @httpQueryParams trait. (#957)

1.13.1 (2021-11-02)

Bug Fixes

Fixed a bug that caused the apply transform to not run its projections. (#969)

Documentation

Clarified uri label and greedy label documentation. (#965, #968)

1.13.0 (2021-10-29)

Features

Added a filterSuppressions model transform. (#940)
Updated selector attributes to be stricter. (#946)
Added support for generating the required property when generating CloudFormation Resource Schemas. (#937)
Added support for generating the handlers property when generating CloudFormation Resource Schemas. (#939)
Added the @aws.iam#iamResource trait to indicate properties of a Smithy resource in AWS IAM. (#948)
Added the @aws.iam#supportedPrincipleTypes trait to indicate which IAM principal types can use a service or operation. (#941)
Updated model serializers to allow for serializing the prelude. (#955)
Updated JSON Schema conversion to maintain property order. (#932)
Improved @httpApiKeyAuth description when converting to OpenAPI. (#934)
Updated the error message received when http request body content issues are encountered. (#959)
Updated request tests for restJson1 query strings. (#933, #958)
Added protocol tests for restJson1 content types. (#924, #945)

Bug Fixes

Fixed issues in model loading that required a service version property. (#936)
Fixed an issue that where CORS headers in OpenAPI conversions were not case-insensitive. (#950)
Fixed various issues in protocol tests. (#930, #933, #935, #944, #949, #954)

Documentation

Clarified host-related settings in the @httpRequestTests trait documentation. (#951)
Clarified uri samples and descriptions. (#960)
Fixed some issues in documentation. (#952)

1.12.0 (2021-10-05)

Features

Added support for binding common errors to a service shape. (#919)
Loosened the requirement of setting a version property when defining a service. (#918)
Updated smithy-build to fail when a build plugin cannot be found. (#909)
Added a changeTypes build transform. (#912)
Added support for replacing simple shapes in ModelTransformer. (#900)
Added a scheme property to the @httpApiKeyAuth trait. (#893)
Added support for specifying errors in the @examples trait. (#888)
Added multi-character newline support in CodeWriter. (#892)
Updated semantic validation of modeled OPTIONS operations. (#890)
Added several malformed request protocol tests. (#879, #882, #881, #898, #901, #905, #908)
Added protocol tests for path prefixes. (#899)

Bug Fixes

Fixed how NodeMapper handles generic params. (#912)
Fixed how the CLI logs messages and interacts with logging levels. (#910)

Documentation

Updated guidance on ordering of set shapes. (#875)
Clarify that event streams contain modeled errors. (#891)
Added an index that lists all traits. (#876)
Fixed various documentation issues. (#884, #911, #927)

1.11.0 (2021-08-03)

Features

Updated CORS header configuration when converting to OpenAPI while using sigv4 or restJson1. (#868)
Added the (unstable) httpMalformedRequestTests trait to validate service behavior around malformed requests. (#871)
Added smithy-diff error when an enum entry is inserted. (#873)
Added a restXml protocol test. (#866)
Added a httpChecksumRequired protocol test. (#869)

Bug Fixes

Updated NodeMapper to properly handle sourceLocation for traits. (#865)
Removed warning when an operation using the HTTP PATCH method is marked with the @idempotent trait. (#867)
Fixed several issues where a sourceLocation wasn't propagated for traits. (#864)

Documentation

Fixed various documentation issues. (#870, #874)

1.10.0 (2021-07-14)

Features

Loosened the requirement of setting an error property when configuring aws.api#clientEndpointDiscovery trait. (#850)
Added a restJson1 protocol test. (#845)
Added a warning when using the OpenAPI conversion jsonAdd setting to alter schemas. (#851)
Added the httpChecksum trait. (#843)

Bug Fixes

Revert "Tightened substitution pattern for Fn::Sub to match CloudFormation." (#858)
Fixed an issue where cors trait additionalExposedHeaders were not added to gateway responses. (#852)
Fixed various issues in protocol tests. (#849, #855, #857)

Documentation

Clarified behavior for the aws.api#service trait's sdkId member. (#848)
Fixed various typos. (#853, #859)

1.9.1 (2021-06-28)

Bug Fixes

Fixed a number of protocol tests related to non-numeric floats. (#844)
Tightened substitution pattern for Fn::Sub to match CloudFormation. (#842)

1.9.0 (2021-06-23)

Features

Added a common validation model for use in server SDKs. (#813)
Added support for cross platform builds of the CLI. (#832)
Validate the contents of protocol test bodies for known media types. (#822, #835)
Updated support for non-numeric floating-point values in several places. (#828)
Added several restJson protocol tests. (#684)
Added several restXml protocol tests. (#804)
Added and updated several awsQuery and ec2Query protocol tests. (#815, #833)
Added several document type protocol tests. (#810)

Bug Fixes

Fixed a NullPointerException when loading a config and no parent path is present. (#814)

AWS Customizations

Added s3UnwrappedXmlOutput trait, which defines when an S3 operation does not use the protocol standard XML wrapper. (#839)

Documentation

Added an overview of known Smithy implementations and projects. (#830, #831)
Improved the documentation for the restXml. (#827)
Improved the documentation for the awsQuery. (#827)
Improved the documentation for the ec2Query protocol. (#823, #827, #836)
Added more context for documentation types. (#818)
Fixed several minor documentation issues. (#816, #818, #837, #840)

1.8.0 (2021-05-20)

Features

Added awsQueryError trait, which defines the value in the Code distinguishing field. (#807)
Added methods to get shapes by type and trait. (#806)
Improved performance. (#805)
Improved percent-encoding tests and doumentation. (#803)
Added double format to epoch-seconds timestamps when converting to OpenAPI. (#802)
Improved CLI output. (#800, #801)

Bug Fixes

Fixed awsQuery protocol test to show distinction from ignored @xmlNamespace trait. (#799)

1.7.2 (2021-05-11)

Bug Fixes

Fixed a bug where unions would cause CloudFormation schema conversion to fail. (#794)
Fixed an incorrect restXml protocol test. (#795)

1.7.1 (2021-05-07)

Features

Added the recommended structure member trait, which indicates that a structure member SHOULD be set. (#745)
Added support for service renames when using the flattenNamespaces transformer. (#760)
Set additionalProperties to false for CloudFormation objects. (#764)
Improved model validation debugging by stopping validation when an ERROR occurs while loading models. (#775)
Added validation warning when a hostPrefix contains a label that does not end in a period. (#779)
Added and updated several @restXml protocol test. (#744, #755, #757, #777, #766, #789)
Added and updated several @restJson1 protocol test. (#747, #755, #765, #790)

Bug Fixes

Fixed number parsing in the IDL, using BigDecimal or BigInteger where needed. (#766)
Fixed Gradle 7 builds. (#758)
Added Document type to list of inherently boxed shapes. (#749)
Reordered TraitService SPI entries for readability. (#742)

AWS Customizations

Added missing name properties to aws.iam#ConditionKeyType enum. (#759)

Documentation

Fixed selector_expression and comment in ABNF for Smithy IDL. (#771, #771)
Documented conflict resolution of HTTP query params. (#783)
Documented precedence of constraint traits. (#784)

Other

Upgraded to use version 0.5.3 of the Smithy Gradle Plugin. (#791)

1.7.0 (2021-03-12)

Features

Added the rename property to the service shape to disambiguate shape name conflicts in the service closure. (#734)
Added the httpQueryParams trait that binds a map of key-value pairs to query string parameters. (#735)
Improved the usability of code for building and running Selectors. (#726)
Added several protocol tests for behavior around null serialization. (#728)

Documentation

Added missing documentation for some trait models. (#737)
Fixed awsQuery and ec2Query list serialization examples. (#732)

1.6.1 (2021-02-23)

Features

Added the renameShapes build transform to rename shapes within a model. (#721)

Bug Fixes

Fixed several issues in protocol tests around @endpoint. (#720)

1.6.0 (2021-02-22)

Features

Added support for checking backwards compatibility for diffs of trait contents. (#716)
Added support for adding CORS configurations to API Gateway HTTP APIs. (#670)
Relaxed constraints on the @httpPayload trait, allowing it to target list, set, and map shapes. (#679)
- Targeting these shapes is invalid for operations utilizing the aws.protocols traits. (#679, #683)
Added validation to ensure a payloadFormatVersion is set when generating an API Gateway HTTP API. (#688)
Added vendorParamsShape to protocol test cases to support validating a test case's vendorParams values are configured properly. (#702)
Added the ability to validate resolved hosts to protocol tests. (#707)
Added backwards compatibility checking to smithy-diff for the @paginated trait. (#716)
Added tags and appliesTo to protocol test definitions for better categorization and grouping. (#696)
Added several protocol tests for the endpoint and hostLabel traits. (#708)
Added several @restXml protocol tests. (#689, #690, #678, #694)

Bug Fixes

Fixed an issue that produced duplicate entries in the security list of a converted OpenAPI document. (#687)
Fixed an issue where alphanumericOnlyRefs was not fully satisfied when generating synthesized shapes. (#695)
Fixed several issues in IDL parsing where duplicate bindings were allowed incorrectly. (#714)
Fixed several issues in protocol tests around serialization of empty contents. (#692)
Fixed an issue where parameters in a diff error message were swapped. (#713)
Fixed an issue in a restXml protocol test. (#715)

AWS Customizations

Added a configuration definition for use validating vendorParams in AWS protocol tests. (#705)
Added tests and documentation for some required Amazon S3 customizations. (#709)
Added tests and documentation for required Amazon Glacier customizations. (#704)
Added a test and documentation for the required Amazon API Gateway customization. (#706)
Added a test and documentation for the required Amazon Machine Learning customization. (#707)

Documentation

Improved the documentation for the awsJson1_0 and awsJson1_1 protocols. (#698)
Improved the documentation for the awsQuery and ec2Query protocols. (#700)
Clarified that Smithy requires support for fractional seconds for the http-date value of @timestampFormat. (#672)
Added missing shape documentation for some waiters related shapes. (#711)
Fixed several minor documentation issues. (#681, #693, #697, #701, #708, #717)

Other

Migrated to using Gradle 6 to build Smithy. This should have no impactful downstream effects. (#194)
Migrated to using main from master for the default branch. This should have no impactful downstream effects. (#685)

1.5.1 (2020-12-21)

Bug Fixes

Fixed several issues related to building and running on Windows. (#671)
Fixed an issue loading the jsonAdd map from configuration for the cloudformation plugin. (#673)
Fixed an issue where API Gateway REST APIs would have greedy label parameter names rendered into OpenAPI with a + suffix. (#674)

1.5.0 (2020-12-10)

Features

Added the endpointPrefix property to the @aws.api#service trait. (#663)
Added support for tags and deprecated members to @waitable definitions. (#652)
Added validation for @httpHeader trait values. (#650)
Add required property for requestBody when converting to OpenAPI. (#655)
Added more helper methods to OperationIndex. (#657)

Bug Fixes

Ensure that names in the @waitable trait are unique in the closure of the service. (#645)
Fixed a regression with @aws.apigateway#authorizors behavior when setting the customAuthType property without having set its type property. (#613)
Fixed an issue where modeled headers were not populated in to Access-Control-Expose-Headers in CORS responses. (#659)
Added missing deprecated member to @enum definitions in the prelude model. (#651)
Fixed an issue with the conversion of greedy label parameter names in to OpenAPI. (#641)
Fixed an issue in CodeWriter.popState where it would not honor custom expression start characters. (#648)
Fixed a potential NullPointerException when validating the @examples trait. (#642)
Fixed issues with some @awsQuery and @ec2Query protocol test responses. (#653)
Fixed an issue where the removeTraitDefinitions build transform was not registered with the SPI. (#660)
Fixed an issue where using an environment variable in smithy-build.json would consume an extra preceding character when performing a replacement. (#662)

Documentation

Update @waitable documentation to specify using jitter and account for overflows. (#656)
Added examples and clarified documentation for several HTTP traits, most importantly @httpLabel and @httpQuery. (#654)
Clarified various aspects of the @xmlNamespace trait documentation. (#643)
Clarified @waitable documentation. (#646, #664)
Clarified that the @pattern trait does not implicitly match an entire string. (#649)
Fixed various examples in the specification. (#639)

Cleanup

Sort TopDownIndex contents to provide deterministic results. (#667)
Improved error messages when an unknown annotation trait is encountered. (#644)
Added smithy-diff error when the @idempotencyTrait token is removed from a shape. (#640)

1.4.0 (2020-11-20)

Features

New Packages

Added smithy-jmespath, a dependency-less, JMESPath parser with a rich AST that can be used in code generation, and performs static analysis of expressions. (#621)
Added smithy-waiters, containing the @waitable trait. This provides information that clients can use to poll until a desired state is reached, or it is determined that state cannot be reached. (#623)
Added smithy-aws-cloudformation-traits, containing several (unstable) traits that indicate CloudFormation resources and the additional metadata about their properties. (#579)
Added smithy-aws-cloudformation, containing the (unstable) "cloudformation" build tool that, given a model decorated with traits from aws.cloudformation, will generate CloudFormation Resource Schemas. (#622)

Other Features

Added support for patternProperties when generating JSON Schema. (#611)
Added more utility methods to the CodeWriter. (#624)
Added validation for @sensitive trait when applied to members. (#609)
Added support for retrieving full paths to the outputToken and items pagination members. (#628)
Added a warning for @enum entries without names. (#610)
Added support for generating an integer OpenAPI type. (#632)
Improved smithy-diff evaluation of changing member targets. (#630)
Updated pagination tokens to support being map shapes. (#629)

Bug Fixes

Fixed a bug where URIs would be declared conflicting if the differed through the @endpoint trait. (#626)
Fixed a bug that would allow the @aws.auth#sigv4 trait's name property to be empty. (#635)
Updated protocol tests for @sparse trait. (#620, #631)
Fixed a bug with the interaction of CodeWriter.writeInline with sections. (#617)

Documentation

Fixed links for protocol test suites. (#615)
Added example and test for composing with CodeWriter. (#619)
Clarified that @enum values cannot be empty. (#633)
Clarified binary data in protocol tests. (#634)

Cleanup

Lowered severity of validation that a pageSize member is marked @required. (#612)

1.3.0 (2020-10-20)

Features

Added several CodegenWriter and related abstractions to simplify creating code generators. (#587)
Added the @sparse trait to the Prelude. (#599)
Added the NullableIndex to help check if a shape can be set to null. (#599)
Added support for API Gateway API key usage plans. (#603, #605)
Added the sortMembers model transform to reorder the members of structures and unions. (#588)
Add description property to operations when converting to OpenAPI. (#589)

Bug Fixes

Fixed an issue where the flattenNamespaces build transform was not registered with the SPI. (#593)

Optimizations

Optimized the reverse NeighborProvider for memory usage. (#590)
Optimized model validation event aggregation for memory usage. (#595)

Documentation

Clarified that map keys, set values, and union members cannot be null. (#596)
Clarified enum names and their usage. (#601)
Added an example dependency to OpenAPI conversion. (#594)
Improve and clean up formatting. (#585, #597, #598)

Cleanup

Updated service, resource, and operation shapes to maintain the order of bound resource and operation shapes. (#602)
Updated the sources build plugin to create an empty manifest if there are no source models. (#607)
Deprecated the BoxIndex. (#599)
Added enum names for httpApiKeyLocation in the Prelude. (#606)

1.2.0 (2020-09-30)

Features

Added information to the ModelDiff.Result indicating how events have changed between the diff'd models. (#574)
Added a media type parser and validation for the @mediaType trait. (#582)
Added additional default CORS headers and configuration for OpenAPI conversions. (#583)
Added the flattenNamespaces build transform to flatten the namespaces of shapes connected to a specified service in a model in to a target namespace. (#572)
Added runCommand functionality to smithy-utils. (#580)
Added a TriConsumer to smithy-utils. (#581)
Added support for the @httpResponseCode trait in the HttpBindingIndex. (#571)
Added protocol tests for the @httpResponseCode trait. (#573)

Bug Fixes

Fixed several issues that would cause Smithy to fail when running on Windows. (#575, #576, #577)
Fixed a bug where a union shape marked as an @httpPayload would throw an exception when trying to resolve its content-type. (#584)
Fixed a bug in OpenAPI conversions where tags were not passed through unless set in the supportedTags list, even when the tags setting was enabled. (#570)

1.1.0 (2020-09-16)

Features

Added the removeTraitDefinitions build transform to remove trait definitions from models but leave instances intact. (#558)
Added payload binding validation to HTTP DELETE operations. (#566)
Updated SmithyDiff to emit events when traits are changed. (#561)

Bug Fixes

Fixed an issue where some StringListTrait instances could lose SourceLocation information. (#564)
Fixed some issues in protocol tests. (#560, #563)

Cleanup

Model components are now deduplicated based on location and value. (#565)
Normalize URL import filenames for better deduplication and reporting. (#562)

1.0.11 (2020-09-10)

Features

Added a reverse-topological knowledge index to aid in code generation for languages that require types to be defined before they are referenced. (#545, #53)
Added the @httpResponseCode trait to indicate that a structure member represents an HTTP response status code. (#546)
Added (unstable) support for generating a "Trace File" to link code generated artifacts back to their modeled source. (#552)
Added the :topdown selector that matches shapes hierarchically. (#539)
Added validation for the cloudTrailEventSource property of the @aws.api#service trait. (#550)
Updated shape builders to properly update their member ShapeIds if the ShapeId of the builder changes. (#556)
Added several more XML related protocol tests. (#547)

Bug Fixes

Fixed a bug where the PaginatedIndex did not properly support resolving paths. (#554)

Documentation

Clarified the documentation for the cloudTrailEventSource property of the @aws.api#service trait. (#550)
Clarified that the @aws.api#arn trait has no impact on OpenAPI conversions. (#555)

1.0.10 (2020-08-26)

Features

Added a validation event when a syntactic shape ID is found that does not target an actual shape in the model. (#542)

Bug Fixes

Fixed a bug where forward reference resolution would use the incorrect namespace when resolving operation and resource bindings. (#543)

Cleanup

Deprecated the reflection-based creation pattern for KnowledgeIndex implementations. (#541)

1.0.9 (2020-08-21)

Features

Allow conflicting shape definitions if the fully built shapes are equivalent. (#520)
Added the @internal trait to the prelude. (#531)
Added the excludeShapesByTrait build transform that will remove any shapes marked with one or more of the specified traits. (#531)
Improved support for newlines and indentation in CodeWriter. (#529)
Added support for configuring the expression starting character in CodeWriter. (#529)
Added payloadFormatVersion property for API Gateway integrations. (#527)
Add deprecated property to operations when converting to OpenAPI. (#535)
Added several more protocol tests. (#528, #536)

Bug Fixes

Fixed the selector for the @httpQuery trait. (#534)
Fixed the selector for the @httpPrefixHeaders trait. (#533)
Fixed some issues in protocol tests. (#526)

Cleanup

Removed the abbreviation property from the @aws.api#service trait. (#532)
Simplified prelude model loading. (#524)
Further simplified overall model loading. (#525)

1.0.8 (2020-07-31)

Features

Updated Walker to provide a stable sort for shapes. (#511)
Improved support for loading ValidationEvents via NodeMapper. (#518, #516)
Added the ability to disableFromNode via NodeMapper. (#505)

Bug Fixes

Fixed several issues in protocol tests. (#502, #507)

Cleanup

Stopped raising validation errors and running validation with RenameShapes transformer. (#512)
Simplified conflict handling for shapes. (#514)
Simplified duplicate member detection and handling. (#513)

1.0.7 (2020-07-16)

Features

Use the @title trait to improve generated documentation for JSON Schema unions that use "oneOf". (#485)
Added and updated several protocol tests for restJson1. (#490)
Added and updated several protocol tests for awsJson1_1. (#484, #493)
Added protocol tests for awsJson1_0. (#496)

Bug Fixes

Fixed a bug where passthroughBehavior was misspelled as passThroughBehavior in APIGateway OpenAPI output for integrations and mock integrations. (#495)
Fixed a bug where only the last line in a multiline doc comment on a member would be successfully parsed. (#498)
Fixed several issues in protocol tests. (#473, #476, #481, #491)

Documentation

Refactored the specification to better explain the semantic model and its representations. (#497, #482)
Clarified guidance on using @mediaType. (#500)
Removed outdated namespace guidance. (#487)
Fixed several minor issues. (#494)

Cleanup

Disallowed problematic identifiers misusing _. (#499)
Moved validation of members with the @httpLabel trait being marked required to the selector. (#480)

1.0.6 (2020-06-24)

Features

Update structure and union shapes so member order is maintained as part of the contract. (#465)
Add validation for document types in protocols. (#474)
Provide suggestions for invalid Shape ID targets if a close match is found. (#466)
Added message templates and trait binding to the EmitEachSelector. (#467)
Added ability to add traits directly to the ModelAssembler. (#470)
Convert awsJson1_1 protocol tests to Smithy IDL. (#472)
Update decimal values in protocol tests. (#471)

Documentation

Update quick start guide with more examples. (#462)

Bug Fixes

Fixed issues allowing document types in @httpHeader and @httpPrefixHeaders traits. (#474)

1.0.5 (2020-06-05)

Bug Fixes

Fixed a bug in loading IDL files where resolving a forward reference that needed another forward reference would throw an exception. (#458)
Fixed a bug where smithy-build imports were not resolved relative to their smithy-build.json. (#457)
Fixed a bug where the PREFIX_HEADERS HTTP binding location would not default its timestamp format to HTTP_DATE. (#456)

1.0.4 (2020-05-29)

Features

Ensure that when a property is removed from a JSON schema object, that a corresponding "required" entry is also removed. (#452)
Added the (unstable) @httpChecksumRequired trait to indicate an operation requires a checksum in its HTTP request. (#433, #453)

Bug Fixes

Fixed a bug in OpenApi conversion where removing authentication for an operation would result in the operation inheriting the global "security" configuration instead of having it set to none. (#451)

Documentation

Added examples of building models to various guides. (#449)
Fixed various documentation issues. (#449)

1.0.3 (2020-05-26)

Bug Fixes

Prevent parsing overly deep Node values (#442)
Fix an issue with the OpenAPI conversion where synthesized structure inputs reference required properties that were removed. (#443)

1.0.2 (2020-05-18)

Bug Fixes

Fix an issue that would squash exceptions thrown for invalid suppressions. (#440)

1.0.1 (2020-05-13)

Features

The smithy.api#httpPayload trait can now target document shapes. (#431)
Updated the IDL grammar to include many previously enforced parsing rules. (#434)
Added the select command to the CLI to print out shapes from a model that match a selector. (#430)
Added the ast command to the CLI to convert 0 or more Smithy models into a JSON AST. (#435)
Added a Dockerfile for building Smithy as a Docker image. (#427)

Optimizations

The Smithy IDL parser has been rewritten and optimized. (#434)
Generate a class data share to speed up the CLI. (#429)

Bug Fixes

Fix several ambiguities and issues in the IDL grammar. (#434)
JSON pretty printing of the AST now uses 4 spaces for indentation. (#435)
Fix CLI --help output alignment. (#429)

1.0.0 (2020-05-04)

Note: Changes marked with "[BC]" are breaking changes more accurately described in the specific section. A list of further intended breaking changes have a specific section near the end of this entry.

Features

General

The model format version has been updated to 1.0 and contains several updates: [BC] (#357, #381)
- The JSON AST representation requires describing annotation traits as {} instead of true.
- Annotation traits in the IDL are now provided as @foo or @foo(). Explicit @foo(true) and @foo(null) support was removed.
Smithy models can now be serialized to the IDL. (#284)
Added a Node-based object mapper to simplify the process of building and using Java components from Smithy Nodes. (#301)
- Many packages have seen significant updates to use this functionality. (#305, #364)
Made error messages clearer when encountering duplicate shapes. (#324)
Model loaders now warn on additional shape properties instead of fail. (#374)
Added expect* methods to the base Shape. (#314)
Added @SmithyUnstableApi, @SmithyInternalApi and @SmithyGenerated Java annotations. (#297)
NodeValidationVisitors are marked as internal and/or unstable. (#375)
The $version control statement can now be set to only a major version (e.g., "1") to indicate that an implementation must support a version >= 1 and < 2. $version can now be set to major.minor (e.g., "1.1") to indicate that an implementation must support a version >= 1.1 and < 2.

Trait updates

Individual protocols are now defined as individual traits that are annotated with the protocolDefinition trait. [BC] (#273, #280, #379, #390)
- Previously listed AWS protocols now have trait implementations.
Individual authentication schemes are now defined as individual traits that are annotated with the authDefinition trait. [BC] (#273, #280)
- Previously listed authentication schemes now have trait implementations.
The smithy.api#enum trait is now a list of enum definitions instead of a map of string keys to enum definitions to improve clarity and encourage adding more properties to definitions. [BC] (#326)
The aws.api#streaming trait is now applied to shapes directly instead of members. [BC] (#340)
The smithy.api#eventStream trait has been removed. Event streams are now indicated by applying the smithy.api#streaming trait to unions. [BC] (#365)
The smithy.api#requiresLength trait has been split out of the smithy.api#streaming trait to improve clarity around event stream modeling. [BC] (#368)
The smithy.api#externalDocumentation trait is now a map instead of a single string to allow for multiple links per trait. [BC] (#363)
Added the smithy.api#noReplace trait to indicate a PUT lifecycle operation cannot replace the existing resource. (#351)
Added the smithy.api#unstable trait to indicate a shape MAY change. (#290)
Simplified aws.api#unsignedPayload to be an annotation. [BC] (#270)
Annotation traits are now lossless when loaded with additional properties, meaning they will contain those properties when serialized. (#385)

Selector updates

Selectors have received significant updates: (#388)

Attribute selectors can now evaluate scoped comparisons using @foo: to define a scope and @{bar} to define a context value. (#391)
And logic, via &&, has been added to allow multiple attribute comparisons. (#391)
Support for selecting nested trait properties with |, including list/object values and object keys, was added.
An opt-in trait relationship has been added. (#384)
The recursive neighbor selector, ~>, has been added. (#386)
A not equal comparison, !=, was added.
An exists comparison, ?=, was added. (#391)
Support for numbers in attribute selectors was added.
Numeric comparisons (>, >=, <, <=) were added.
The (length) function property was added. (#391)
Attribute selectors now support CSV values, allowing matching on one or more target values.
The :each selector is now :is for clarity. [BC]
The :of selector is now removed. Use reverse neighbors instead (e.g., member :test(< structure)). [BC]
The semantics of the :not selector have changed significantly. :not(list > member > string) now means "do not match list shapes that target strings", whereas this previously meant, "do not match string shapes targeted by lists". [BC]
Shape IDs with members must now be quoted. [BC]
Selector parsing and evaluating now tolerates unknown relationship types. (#377)

Validation updates

Services must now contain a closure of shapes that have case-insensitively unique names. [BC] (#337)
suppressions has been updated to now only suppress validation events that occur for an entire namespace or across the entire model. The @suppress trait was added to suppress validation events for a specific shape. [BC] (#397).
The UnreferencedShape validator has moved to smithy-model and is now always run. [BC] (#319)
EmitEachSelector and EmitNoneSelector were moved from smithy-linters into smithy-model.

JSON Schema conversion

The conversion to JSON schema was significantly overhauled. [BC] (#274)

Configuration for the build plugin was significantly overhauled. [BC] (#364)
The strategy for shape inlining has been changed. [BC]
The strategy for naming shapes and handling shape id conflicts has been changed. [BC]
Output schema error detection was improved.
The Java API surface has been reduced. [BC]
Added the ability to select schemas from a document using a JSON pointer.

OpenAPI conversion

The conversion to OpenAPI was significantly overhauled. [BC] (#275)

Configuration for the build plugin was significantly overhauled. [BC] (#364)
Protocol conversion was updated to utilize the new traits. (#275, #392)
Schemas are now generated for requests and responses instead of being inlined. [BC]
Fixed several issues with CORS integrations.

API Gateway OpenAPI conversion

The API Gateway specific OpenAPI mappers have been updated. [BC] (#367)

The ApiGatewayMapper interface was added, allowing mappers to control which API Gateway API type(s) they support.
Fixed several issues with CORS integrations. (#370)
Added support for JSON Patch-like OpenAPI schema changes based on JSON Pointers. (#293)
Added support for event streams in OpenAPI conversion. (#334)

Bug Fixes

Fixed an issue in JSON schema conversion where member traits were dropped in some scenarios. (#274)
Fixed an issue where authorization headers were not properly added to CORS configurations. (#328)
Fixed an issue where operation response headers were being applied to error responses in OpenAPI conversions. (#275)
Fixed an issue where apply statements wouldn't resolve target shapes properly in some cases. (#287)
Fixed an issue with the selector for the smithy.api#title trait. (#387)
Fixed several issues with the smithy.api#httpApiKeyAuth trait and its related conversions. (#291)
Fixed a bug with timestamp validation in specific versions of Java. (#316)

Optimizations

The TraitTargetValidator now performs as few checks on and selections of the entire model. (#389)
The dependency on jackson-core was replaced with a vendored version of minimal-json to reduce the chances of dependency conflicts. [BC] (#323)
Sped up model loading time by loading JSON models before IDL models to reduce forward reference lookups. (#287)

Breaking changes

All changes listed in this heading and any sub-headings are breaking changes.

The BooleanTrait abstract class in smithy-model was renamed AnnotationTrait. (#381)
The traits in the aws.apigateway namespace have moved from smithy-aws-traits to the smithy-aws-apigateway-traits package for more granular use. (#322)
- Tooling that referenced these traits has also been updated.
The traits in the aws.iam namespace have moved from smithy-aws-traits to the smithy-aws-iam-traits package for more granular use. (#322)
- Tooling that referenced these traits has also been updated.
The aws.api#ec2QueryName trait has moved to aws.protocols#ec2QueryName. (#286)
The aws.api#unsignedPayload trait has moved to aws.auth#unsignedPayload . (#286)
The smithy-codegen-freemarker package has been removed. (#382)
Traits can no longer be applied to public Smithy Prelude shapes. (#317)
Smithy's Pattern class is renamed to SmithyPattern to remove the conflict with Java's regex Pattern class. (#315)
Removed the Triple class from smithy-utils. (#313)
Normalized class names for OpenAPI SecurityScemeConverter implementations. (#291)
Removed alias functionality from software.amazon.smithy.build.SmithyBuildPlugin and software.amazon.smithy.build.ProjectionTransformer. (#409)
Removed software.amazon.smithy.model.shapes.Shape#visitor and software.amazon.smithy.model.shapes.ShapeVisitor$Builder. Use software.amazon.smithy.model.shapes.ShapeVisitor$Default instead. (#413)
software.amazon.smithy.model.Model#getTraitDefinitions and getTraitShapes were removed in favor of software.amazon.smithy.model.Model#getShapesWithTrait. (#412)

Deprecation cleanup

The deprecated IDL operation syntax has been removed (#373)
The deprecated NodeFactory interface has been removed. (#265)
The deprecated ShapeIndex class and all related APIs have been removed. (#266)
Support for the deprecated 0.4.0 model version has been removed. (#267)
The aws.api#service trait no longer supports the deprecated sdkServiceId, arnService, or productName properties. (#268)
The deprecated TemplateEngine and DefaultDataTemplateEngine have been removed. (#268)
The deprecated smithy.validators and smithy.suppressions are no longer used as aliases for validators and suppressions. (#268)
The smithy.api#references and smithy.api#idRef traits no longer support relative shape IDs. (#268)

Documentation

A significant overhaul of the specification and guides has been completed. This includes a better flow to the spec, more complete guides, deeper documentation of AWS specific components, and a complete redesign. Many direct links to components of the documentation will have changed.

0.9.9 (2020-04-01)

Bug Fixes

Add security to individual operations in OpenAPI conversion (#329)
Fix an issue with header casing for x-api-key integration with API Gateway (#330)
Fix discrepancies in smithy-aws-protocol-tests (#333, #335, #349)

0.9.8 (2020-03-26)

Features

Add RenameShapes model transformer (#318)
Build ValidationEvents are now sorted (#263)
Smithy CLI logging improvements (#263)
Model builds fail early when syntax errors occur (#264)
Warn when a deprecated trait is applied to a shape (#279)

Bug Fixes

Fix behavior of schemaDocumentExtensions when converting to OpenAPI (#320)
Fix discrepancies in smithy-aws-protocol-tests (#309, #321)
Properly format test case results (#271)
Fix dropping one character text block lines (#285)

Optimizations

Builds run parallel projections in parallel only if there are more than one (#263)
Run Smithy test suites as parameterized tests (#263)

Cleanup

Migrate protocol tests to new operation syntax (#260)
Build protocol tests with the Smithy Gradle plugin (#263)
Deprecate using explicitly smithy.api for trait removal (#306)

0.9.7 (2020-01-15)

Features

Updated Operation syntax in the Smithy IDL (#253)
Updated specification for XML traits (#242)
Add the @aws.api#ec2QueryName-trait trait (#251)
Add AWS protocol test models (#246, #247, #250, #255, and #258)

Optimizations

Use URLConnection cache setting in ModelAssembler (#244)

Bug Fixes

Use list of string for queryParams in the httpRequestTests trait (#240)

0.9.6 (2020-01-02)

Features

Allow XML maps to be flattened (#205)
Add and remove shape members to model automatically (#206)
Deprecate ShapeIndex in favor of Model (#209)
Allow the sensitive trait to be applied to all but operations, services, and resources (#212)
Added 0.5.0 IDL and AST format (#213)
Allow min to equal max in range trait (#216)
Added validation for length trait values (#217)
Limit streaming trait to top-level members (#221)
Added protocol compliance test traits (#226)
Added ability to configure timestamp validation (#229)
Moved TemplateEngine implementation into FreeMarker implementation (#230)
Added BoxIndex (#234)
Added more expect methods to Shape and Model (#237)

Optimizations

Update smithy-build to be streaming (#211)

Bug Fixes

Prevent bad list, set, and map recursion (#204)
Properly allow omitting endpoint discovery operation inputs (#220)

0.9.5 (2019-11-11)

Features

Allow overriding state management in CodeWriter (#186)
Allow the xmlFlattened trait to be applied to members (#191)
Add helper to determine HTTP-based timestamp formats (#193)
Allow specifying XML namespace prefixes (#195)
Add SymbolContainer, an abstraction over Symbols that enables easily creating and aggregating Symbols (#202)

Bug Fixes

Escape popped state content (#187)
Make shape ID serialization consistent (#196)
Exclude private members targeted in JSON schema converters (#199)
Fix naming collisions in JSON schema output (#200)
Update equals to included typed bag parents (#201)

0.9.4 (2019-10-09)

Features

Add support for AWS Client Endpoint Discovery (#165)
Refactor event streams to target members (#171)
Add support for aliasing referenced Symbols (#168)
Add support for Symbols to introduce dependencies (#169)
Add ability to manually escape reserved words in ReservedWordSymbolProvider (#174)
Add method to gather dependencies for Symbols (#170)
Add a caching SymbolProvider (#167)
Improve the usability of CodeWroter#openBlock (#175)
Improve the usability of PluginContext (#181)

Optimizations

Disable URLConnection cache in CLI (#180)

Bug Fixes

Fix issue with generated authentication for CORS checks (#179)
Set the defaultTimestampFormat to epoch-seconds for aws.rest-json protocols in OpenAPI (#184)

0.9.3 (2019-09-16)

Features

Clean up CodeWriter modifiers (#143)
Add typed ObjectNode member expectation functions (#144)
Add expectShapeId for fully-qualified shape ID (#147)
Add helper to EnumTrait to check if it has names (#148)
Add Symbol references (#149)
Add ReservedWords builder for simpler construction (#150)
Allow using path expressions in paginator outputs (#152)
Add method to get non-trait shapes (#153)
Add method to write class resource to manifest (#157)
Allow authType to be specified (#160)

Bug Fixes

Fix collection and gradle doc issues (#145)
Make AuthorizerDefinition definition private (#146)
Fix put handling on ResourceShape (#158)
Fix parse error when apply is at eof (#159)
Prevent list/set member from targeting container (#162)
Allow model assembling from symlink model files / directory (#163)

Files

CHANGELOG.md

Latest commit

History

CHANGELOG.md

File metadata and controls

Smithy Changelog

1.37.0 (2023-08-22)

Features

Documentation

Bug Fixes

1.36.0 (2023-08-03)

Features

Documentation

Bug Fixes

Other

1.35.0 (2023-07-27)

Features

Documentation

Bug Fixes

Other

1.34.0 (2023-07-10)

Features

Bug Fixes

Documentation

1.33.0 (2023-06-21)

Features

Bug Fixes

Documentation

1.32.0 (2023-06-06)

Features

Bug Fixes

Documentation

1.31.0 (2023-04-25)

Features

Bug Fixes

Documentation

1.30.0 (2023-04-10)

Features

Bug Fixes

Documentation

1.29.0 (2023-04-03)

Features

Bug Fixes

Documentation

1.28.1 (2023-03-09)

Features

Bug Fixes

1.28.0 (2023-02-24)

Features

Bug Fixes

Documentation

1.27.2 (2023-01-30)

Features

Bug Fixes

Documentation

1.27.1 (2023-01-11)

Features

Bug Fixes

Documentation

1.27.0 (2022-12-15)

Features

Bug Fixes

Documentation

1.26.4 (2022-11-22)

Bug Fixes

1.26.3 (2022-11-17)

Features

Bug Fixes

Documentation

1.26.2 (2022-11-07)

Bug Fixes

1.26.1 (2022-10-31)

Features

Bug Fixes

Documentation

1.26.0 (2022-10-10)

Features

Documentation

1.25.2 (2022-09-28)