microsoft-kiota-abstractions

Added

• Added a warning message in the CLI when using preview languages. #4316
• Added support for handling untyped Json content in C#,Golang, TypeScript and Java. #2319
• Added TypeScript type check suppression to .ts files where unused imports cause build fail in projects which use noUnusedLocals: true compiler option. #4397
• Fixed TypeScript generation bug when returning enums from endpoints. #4426

Changed

• Fixed Go generation bug when dealing with scalar collection body. #4380
• Fixed a bug where multiple Visual Studio Code instances would make the extension install/update fail. #3686
• Fixed a bug where models properties named "additionalData" or "BackingStore" would be ignored. #4224
• PREVIEW: Renamed the config commands to workspace. #4310
• PREVIEW: Moved preview configuration files to the .kiota directory. #4310
• PREVIEW: Moved the copy descriptions to dedicated folders. #4310
• PREVIEW: Renamed the config to workspace file. #4310
• Fixed a bug where TypeScript generation would consider boolean argument as empty when false. #4103
• Changed Csharp code generation to put braces on new lines (where it makes sense). #4347
• Fixed a bug where some no-content status codes would be considered structured (301, 302, 303, 307) when described. #4190
• TypeScript is now a preview language!

Added

• Added support for the new kiota config commands under a feature flag. #3356
• Added the init command as part of the experience revamp of #3356
• Added uri-form encoded serialization for Python. #2075
• Added support for multipart form data request body in Python. #3030
• Added support for Enums or collection of enum values as root of the payload. #1042

Changed

• BREAKING - Removed the async suffix from request adapter methods in TypeScript. microsoft/kiota-typescript#992
• Fixed mantis for bitwise enums in Go. #3936
• Keyword in enum names for go should not be escaped. #2877
• Generator method code reduction in Python. #3695
• Fixed a bug with URI template generation for required parameters when they differ between operations. #4148
• Fixed return doc comments for Go/Java/CSharp/TypeScript.
• Fixed type names in doc comments and deprecation noticed across languages.
• Added thrown exceptions in doc comments for Go/CSharp/Java/TypeScript. #3811
• Fixed missing type/method names in deprecation comments.#4186
• Fixed cref tags not closed in doc comments in CSharp generation.
• Deduplicates 4XX and 5XX error mappings when they map to the same type to reduce emitted code. #4025
• 📢📢📢 Java generation is now stable! 🚀🚀🚀 special thanks to @andreaTP (Red Hat) for all the help.
• Fixed bug where stream responses would generate incorrect partial paging code. #4207
• Sanitize Accept and Content-Type headers during generation. #4211
• Fixed a bug in enum default value generator for TypeScript. #4216
• Generate enum array for query parameters. #4225

Added

Changed

• Fixed an issue where domain expiration for apis.guru would lead to search failures

Added

Changed

• Java - Self-extraction of query parameters instead of using reflection. #3965
• Fixed a bug where the discriminator validation rule would report false positives on nullable union types.
• Fixed a bug where constructors and model names where clashing in Go. #3920
• Fixed a bug where the order of enum declaration might results in a missing enum type. #3935
• Fixed java generating compound types with underscore in the name. #3824
• Fixed syntax for ES/TS lint enable/disable

Added

Changed

• Fixed a regression introduced by #3760 in 1.9.0 and its previews where indexer parameter name would be wrong leading to invalid URLs. #3901
• Fixed a bug in the vscode extension where the "Paste API Manifest" button would not be able to parse the manifest.
• Enhance the way Enums are expressed in Typescript. #2105
• Fixed missing dependency version in info command. [#3894](https://github.com/microsoft/kiota/issues/3894

Added

• Added --content-type option for requests with multiple allowed content types. (CLI)

Changed

• Request builders are now in the index file to simplify imports and reduce generated code in TypeScript. #3799
• Groups request builders and inline request/response bodies in the same file in TypeScript.
• Groups all reusable models in a single file in TypeScript. #3843
• Fixed a bug where reserved name rename would not rename objects properly. #3609
• Switched to a Jammy Chiseled base image for docker containers.
• Moved the withUrlMethod of TypeScript in the base package. #3812
• Fixed a bug where path parameters deduplication would create collisions on sub path segments. #3757
• Moved from net7 to net8.
• Removed windows OS from docker multi-platform image to align with dotnet changes.
• Fixed a bug where the emitted CSharp would not be compatible with netstandad2.0. #3829
• Fixed a bug where import statements for additionalDataHolder and enumSet are missing when BackingStore is enabled in java. #3643
• Fixed an issue where Kiota's regex's might time out. #3797
• Fixed a bug where getBackingStore method body was malformed for java. #3643
• Fixed a bug where serialize method will not write additional data when backingStore is enabled for java. #3643
• Fixed a bug where paths with parameters in the same position but different names would make generation fail. #3756
• Fixed a bug where a property named constructor would make generation fail. #3756
• Removed reflection for Java enum deserialization. microsoft/kiota-java#843
• Added support for AnyOf arrays. #3786
• Fixed a bug where property names that matched reserved type would be replaced in dotnet.
• Fixed pass by value for contentType param in Go requestInfo.SetStreamContentAndContentType#3830
• Fixed parsing of DateOnly values generated in request executors #3679
• Fixes generation of default values names for go constructor functions #3436
• [Java] Removed the usage of reflection in ApiClientBuilder kiota-java#923
• Fixed a bug where path parameter type was not correctly detected during generation. [#3791](https://github.com/microsoft/kiota/issues/3791

Added

• 📢📢📢 Python generation is now stable! 🚀🚀🚀
• 📢📢📢 PHP generation is now stable! 🚀🚀🚀
• Added support for enum query parameter types. #2490
• Added settings in the vscode extension for: backingStore, additionalData, excludeBackwardCompatible, cleanOutput, clearCache, serializers, deserializers, disabledValidationRules, structuredMimeTypes. #3355
• Support for primary error message in PHP #3276
• Added support for multiple content type request bodies. #3377
• Added support for multiple content type responses. #3377
• Support for primary error message in Python #3277
• Added a json output for the kiota info command

Changed

• Set serialization name for path parameters for use with url templating in Python. #3612
• Include the type which a promise resolves to in PHPDocs for PHP. #3542
• Added null check for null content type instances when getting deprecation information #3588
• Aligns header management in Python with other languages. #3430
• Fixed parameters that are in camelcase to snakecase in Python. #3525
• Fixed missing imports for method parameters that are query parameters.
• Replaces the use of "new" by "override" and "virtual" in CSharp models.
• Fixed a bug where namespaces segment names might contain special characters. #3599
• Fixed a bug in validation rules where form data would wrongfully warn for arrays. #3569
• Fixed a bug where content type parameter would be missing for TypeScript, Java, PHP, Python, Ruby and Go. #3610
• Fixed query parameters type mapping for arrays. #3354
• The lock file now contains the relative path to the description in case of local path. #3151
• Fixes a bug where query parameters would be missing in CSharp for ebc clients. #3583
• Fixed bug where base64url and decimal types would not be generated properly in Java.
• Fixed a bug where object properties would not be serialized in TypeScript. #3596
• Fixed bug where symbol name cleanup would not work on forward single quotes characters #3426.
• Fixed a bug where a "models" API path segment in the description would derail generation. #3400
• Changes to the configuration of RequestInformation are preserved instead of being overwritten. #3401.
• Fix bug where import statements in typescript wasn't using import type notation for types that are erased at runtime. #3190
• The structured content type generation parameter now supports prioritization with q=value syntax. #3377
• Fixed bug where Tilde char convert to Enum member name properly in C#. #3500
• Restore backing store feature for typescript. #2613
• Fixed default code documentation for RequestBodyContentType method parameter

Added

• Added support for tracing in Python. #1872
• Added auto-generated comment for TypeScript generation. #3244
• Added a new switch to exclude all assets generated only for backward compatibility. #2952
• Added support for tracing (OpenTelemetry) in PHP. #1871

Changed

• Fixed class name casings when reference in the errorMappings in PHP.
• Removed --json-no-indent option in favor of RAW_JSON output format which does the same job. (CLI)
• Fixed imports for enum type properties with default values in Python. #3367
• Updated constructor for request builders in Python to set passed path parameters. #3352
• Fixed inherited type definition generation where some cases would not generate properly. #2745
• Fixed naming convention for inline response types. #2952
• Localhost based descriptions are not cached anymore to facilitate development workflows. #3316
• Fixed a bug where the hints would miss quotes for paths and always use the API manifest. #3342
• Fixed a bug where inline composed types for components schemas would have the wrong name. #3067
• Fixed a bug where the casing of properties serialization name would be normalized. kiota-serialization-json-dotnet#131
• Changed parameter order in with_url method body to match the signature of RequestBuilder constructor in Python. #3328
• Removed redundant undefined qualifier in TypeScript for properties. #3244
• The default status code response is now used as 4XX and 5XX when those class responses are not provided in the description. #3245
• Adds codes files in typescript to reduce number of generated files. #2116
• Fix null reference exception when a parameter is defined without a schema. (CLI).
• Log a message to stderr if a request is skipped due to missing data. (CLI) #2210
• Fixes code file generation in typescript #3419
• Writes fully qualified name of custom types when a type with a similar name exists in the class in PHP.
• Rename composed type wrapper when class already exists in the namespace. [#2964](https://github.com/microsoft/kiota/issues/2964

Changed

• Hotfix release for pipeline failing because of Microsoft.OpenApi.ApiManifest preview dependency

NOTE: this release failed for every platform other than docker. We addressed the pipeline failure and it'll become shortly available to every platform under version 1.6.1.

Added

• Added support for raw URL in the fluent API surface in CSharp, Go, Java, PHP, Python, Ruby, TypeScript. #3199
• Added support for external documentation links within descriptions in Python. #2041
• Added support for API manifests. #3104
• Added support for reserved path parameters. #2320
• Added support for csv enum values in enums using a mask in Go.
• Added support for x-ms-enum-flags extension in Generator to enable generation of bitwise(flagged) enum values#3237.
• Added support for mapping primary error messages in CSharp, Go, Java, and TypeScript. #3066

Changed

• Fixed an issue where dependencies would not show up for any other language than CSharp in the vscode extension. #3226
• Multiple fixes to guarantee idempotency of subsequent runs. #2442
• Fixed issue with generating classes with Aliases(PHP)microsoftgraph/msgraph-beta-sdk-php#197
• Flattens the models namespaces in Ruby to avoid circular dependencies.
• Adds ObjectId as a reserved keyword in Ruby to have memory management issues.
• Replace Javax annotations in favor of Jakarta annotations for Java code generation. #2810
• RequestExecuters call overload methods reducing code generation size for Java. #3150
• Remove URISyntaxException from Java generated RequestExecutors and RequestGenerators. #3149
• Adds 'Generated' annotation to generated Enums and Classes for Java. #3106
• Fixes uuid conversion to string value in PathParameters in Go. #3106
• Fixes a bug with incorrect reserved models renaming that occurs sometimes depending on the order of type processing microsoftgraph/msgraph-sdk-dotnet/issues/2084
• Work around a System.ComandLine bug where adjacent matching command names would crash the CLI parser (CLI). microsoftgraph/msgraph-cli#316 microsoftgraph/msgraph-cli#320, dotnet/command-line-api#2260
• Aggregate typescript import statements by source #3232
• Fixes a bug in dotnet where enums types would not be fully disambiguated when initialized in constructor with default values and existing conflicting property exists [#3233]
• Fixes a bug in generation of flagged enum properties and their serializer/deserializer functions in typescript [https://github.com/microsoft/kiota/issues/3260]
• Fixes missing EnumSet types in method parameter and return types in Java [https://github.com/microsoft/kiota/issues/3272]

Added

• Added the title of the API in the VSCode tree view. #2779
• Added capability to serialize and deserialize UUIDs in typescript#40
• Added auto-generation header comment for class and enums in CSharp #2886
• Added support for multipart form data request body in CSharp, Go, Java, and TypeScript. #220
• Added support for base64 encoded properties in TypeScript.
• Added support for type specific (non string) indexers parameters. #2594

Changed

• Fixed missing type comments in many cases. #2868
• Fixed a bug where duplicate enum entries in the description would lead to duplicate members. #2352
• Sunset app.kiota.dev in favour of the VSCode extension. #2934
• Use schematized types for 206 response codes instead of binary. #2880
• Type names are not changed to first char upper case in comments in some cases.
• Fixed a bug where the show command would display an upgrade warning.
• Updated getEnumValues method name to getCollectionOfEnumValues in TypeScript. #2907
• Added Method to the list of CSharpReservedClassNames. #2939
• Changed generation to use aggregate type for TimeSpan values in java #2069
• Fixed generation of properties with identical names after symbol cleanup. #2869
• Use import type syntax in Typescript for all code that will be erased from output at runtime. [#2959](https://github.com/microsoft/kiota/issues/2959

Added

• Added support for Composed types (De)Serialization for Python Generation. #1813
• Added support for deprecation annotations in C#, Java, TypeScript and Go. #2605
• Added a message to update kiota when using an outdated version. #2099

Changed

• Fixed an issue with query parameter name normalization in Ruby and Python. #2825
• Fixed serialization of scalar members in union types for C#, Go, Java. #2462
• Fixes an issue where class to interface replacement in TypeScript would be flaky. #2676
• Deprecated Visual Studio OpenAPI reference packages.
• Fixed a bug where TypeScript errors would loose inheritance to base error definition.
• Fixed a bug where types trimming would be too aggressive.
• Fixed a bug where base property detection would be broken resulting in duplicate properties in inheritance trees.
• Fixes a bug where classes ending up with Id would have the wrong names.
• Fixed a bug where default enum values would not fail to build in TypeScript. #2615
• Replaced response handler parameter by request option to reduce generated code size in TypeScript. #1855
• Fixed a bug where a stackoverflow exception occurs when inlined schemas have self-references 2656
• Fixed nil safety while type casting values in collections in Go
• Moved common RequestBuilder ((request_adapter, url_template and path_parameters)) and RequestConfiguration(headers, options) properties to respective base classes in Python.2440
• Fixed a bug where escaped package names would not be lowercased in Java.
• Fix failing PHP integration tests 2378
• Prevents method overloading for go getters and setters with different values. #2719
• Fixed PHP request executor methods that return enums.
• Allow configuration of the number of threads via the environment variable KIOTA_GENERATION_MAXDEGREEOFPARALLELISM.
• Fixes regression where enum options would be renamed in CSharp.
• Add locking to writing to log files.

Changed

• Changed python model classes to dataclasses. #2684
• Fix issue with command conflicts causing CLI crashes. (Shell)
• Fix build error by splitting the ambiguous --file option into --input-file and --output-file. (Shell)
• Fixed including unused imports in Go #2699
• Fixed a bug where error response type with primitive types would cause compile errors in dotnet #2651
• Fixed a bug where CSharp generation would fail if the input openApi contained schemas named 'TimeOnly' or 'DateOnly' 2671
• Updated the reserved types for CSharp to include 'Stream' and 'Date' should be reserved names in CSharp 2369
• Fix issue with request builders with parameters being excluded from commands output. (Shell)
• Fixed a bug in setting default enum values fails if the symbol has been sanitized and the symbol only contains special characters 2360
• Fixed issue where duplicate query parameter names per path were added to the URL template. Now only distinct query parameter names are added. 2725

Added

• 📢📢📢 Go is now a stable language!
• Added typescript interfaces for models and request config params. #1013 and #1521
• Added automatic loading of the lock file for the extension so quick edits of clients are supported.
• Added a warning message when clients get upgraded from one kiota version to another. #2598
• Added trimming of derived types that are not being used by the client. #2543
• Added support for merging schemas of AllOf > 2. #2438
• Added operation selection in the vscode extension. #2556
• Added Chinese translations to vscode extension.
• Added an action to open documentation in the vscode extension. #2562

Changed

• Fixed issue where implements for error classes were not copied when inlining classes.
• Moved the common properties to a base class and remove properties(RequestAdapter, UrlTemplate and PathParameters) for the request builders and options and headers for RequestConfig classes PHP.2439
• Fixed bugs with imports for PHP Generation.
• Indexers replacement are now at the same level as the original indexer. e.g client.userById("id").messagesById("id")... is now client.users.withId("id").messages.withId("id")....
• Fixed a bug where arrays with empty items definitions would still project properties. #2502
• Fixed a bug where multiple single path parameters at the same level would produce invalid url templates.
• Fixed a bug where steps count would be increasing on nav back in the extension. #2553
• Fixed a bug where java path parameters wouldn't build.
• Fixed a bug where extension would not reset generation information on new search. #2540
• Fixed a bug where the extension would not select nodes when loading from lock file with no filters. #2542
• Fixed a bug where the extension would fail to generate for the root path. #2536
• Fixed a bug where properties copied from parent to child classes would not be cloned.
• Fixed a bug where Java discriminator mapping would use the mapping name instead of the type name.
• Fixed a bug where filters for nodes with same-level single path parameters with different names would not work anymore.
• Fixed a bug where replacing reserved names would not propagate the rename to the inner child elements map of the parent class.
• Fixed a bug where descriptions with multiple server URLs would use the HTTP one instead of HTTPs. #2336
• Fixed a bug where backing store properties would be sometimes duplicated in derived classes.
• Write PHP URL templates in request builders using single quoted strings to prevent need to escape $-prefixed names e.g. $count, $ref, $value

Added

• Added Visual Studio Code preview extension. #2333
• Added support for searching in forks for API descriptions in GitHub. #2429
• Added the ability to filter on operations. #2431

Changed

• Fixed a bug where UUID type is not correctly passed to deserialization method due to snake casing of primitive type names.
• Fixed a bug where unescaped query parameters are not correctly matched to the original name due to python convention of snake casing parameter names.
• Fixed a bug where date types annotations and guid's were not correctly translated in Python
• Fixed the extension of downloaded files when using the default path. #2316
• Fixed a bug where lookup of reference ids failed for AllOf more than one level up.
• Fixed a bug where a CLI client would not set the content types for requests. (Shell)
• Fixed linting errors by re-ordering methods and properties in Python.
• Fixed a bug where requests with bodies would fail in Ruby. #2473
• Changed python import mechanism to facilitate code completion. #2380
• Fixed a bug where discriminator methods were missing possible types in Python #2381
• Fixed a bug where boolean or number enums would be mapped to enums instead of primitive types. #2367
• Fixed a bug where CSharp inherited constructor name was incorrect. #2351
• Fixed a bug where java refiner would emit method's parameters types without normalizing the name.
• Fixed a bug where java refiner would emit incorrect returning types and error mappings without normalizing the name.
• Changed the name of the static query parameter factory method from addQueryParameters to createQueryParameters in PHP
• Fixed a bug where java writer would emit incorrect serialization values for escaped enums
• Fixed a bug where java writer would emit incorrect type names in case of compound types
• Fixed a bug where go refiner would emit incorrect code when inlining error parents
• Fixed a bug where inline type names would not be sanitized. #2368
• Fixed a bug in PHP where the base URL path parameter key didn't match the URI template.
• Changed invalid schema behavior, invalid properties are now ignored with a warning instead of failed. #2089
• Fixed a bug where java refiner would not normalize inherited class names and interface types.
• Fixed a bug where search based commands would not match exact matches when additional results are available.
• Fixed a bug where imported classes and enums would not be disambiguated when they have the same name in dotnet.
• Fixed a bug where escaping enum names resulted in a loss of the original enum name. #2488
• Fixed a bug where properties names are not correctly normalized in Go.

• 📢📢📢 Kiota is Generally Available with C# as a first stable language and more to follow soon! 🚀🚀🚀

Changed

• Fixed a bug where byte and binary types would be wrongly mapped. #2357
• Fixed a bug where go refiner would fail with a null reference.
• Fixes a bug where request builders would be incorrectly generated due to inconsistent suffix generation
• Fixed a bug where PHP model getAdditionalData() would not return nullable types.
• Fixed bug in request options PHPDoc type.
• Fixed a bug where java refiner would emit enums without normalizing the name.
• Fixed bug in request configuration class constructor PHPDoc.
• Fixed a bug where ruby refiner would emit enums without normalizing the name.

Added

• Added constructors and query parameter factory methods to request configuration classes and constructors to query parameter classes in PHP.
• Added support for relative server URL. #2278
• Added restoration of the kiota-lock when the generation fails with clean output. #2292

Changed

• Fixed a generation issue in TypeScript where static methods imports could collide.
• Fixed a generation issue in Go with the accept headers definition.
• Fixed a generation issue in Go and TypeScript with UUID properties.
• Fixed issue with wrong imports for PHP. #2049
• Fix issue where discriminator types were never getting imported for PHP. #2049
• Fix issue where class aliasing was never working as expected for PHP. #2049
• Fixed colliding imports for factory methods in TypeScript. #2009
• Switched to lazy loading module imports in Python. #2007
• Caters for type names being used from System namespace in CSharp generation #2021
• Fixed wrong send request method name for collections in Python. #2057
• Implemented request builders with no parameters as properties in Python. #2024

Added

• Added description validation rules to help users get the best client experience. #2019
• Added support for external documentation links on request execution methods. #2036
• Added support for multi-valued headers in CSharp, TypeScript, Go, and Java. #2032

Changed

• Unblocks nuget release by removing file triggering credscan.

Changed

• Unblocks nuget release by removing file triggering credscan.

Changed

• Fixes publishing workflow missing workload restore commands.

Changed

• Fixed a bug where readonly properties would fail to deserialize for TypeScript.
• Fixed a bug where array buffers nullability would wrongly be defined for TypeScript.
• Fixed a bug where parameter comments would appear in summary tag comments in dotnet. #1945
• Fixed a bug in PHP generation where request bodies would not serialize single elements properly. #1937
• Fixed a bug where request information would always be set from scalar. #1965
• Fixed a bug where path parameters would be missing if no operation was present at the segment the parameter is defined. #1940
• Fixed a bug where nested classes with long names caused compilation errors for java generated libraries. #1949
• Removed use of anonymous classes in java generated libraries to reduce the number of java classes created at compilation time. #1980
• Fixed a bug where generation would result in wrong indentation in some classes for Python [#1996]((https://github.com/microsoft/kiota/issues/1996).
• Fixed a bug where error class modules were hardcoded for Python [#1999]((https://github.com/microsoft/kiota/issues/1999)
• Fixed a bug where generation would sometimes result in wrong original names for query parameters in Python [#2000]((https://github.com/microsoft/kiota/issues/2000).
• Fixed a bug where Java would fail to compile for endpoints that return collections.

Added

• Added support for GitHub based API search.#1866
• Added login/logout commands to access API descriptions in private GitHub repositories. #1983
• Added support for scalar request bodies Python #1571
• Sets property defaults in constructor and removes duplicate properties defined in base types from model serialization and deserialization methods in Python. #1726
• Added support for scalar request bodies in PHP #1937
• Added accept header for all schematized requests Python. #1617
• Added optional backing store support for PHP. #1976
• Fixed a bug where OdataErrors had wrong inherited class name in Python.
• Fixed a bug where empty path parameters dictionary would throw an error in request builders in Python.