The Azure SDK team is pleased to announce our December 2023 client library releases.

40 packages released this month.

Stable Packages (20)

  • Cognitive Search

  • Communication Call Automation

  • Communication Chat

  • Communication Identity

  • Communication JobRouter

  • Communication Sms

  • Core - Client - Core Rest Pipeline

  • Resource Management - App Service

  • Resource Management - Chaos

  • Resource Management - Confluent

  • Resource Management - Container Service

  • Resource Management - Data Factory

  • Resource Management - Databricks

  • Resource Management - Managed Grafana

  • Resource Management - Mobile Network

  • Resource Management - Nginx

  • Resource Management - Palo Alto Networks - Next Generation Firewall

  • Resource Management - Quota

  • Resource Management - Recovery Services Backup

  • Resource Management - Service Networking

Patch Updates (3)

  • Core - Client - HTTP

  • Core - Client - Rest

  • Identity

Beta Packages (16)

  • Azure AI Document Intelligence

  • Communication Chat

  • Communication Phone Numbers

  • Dev Center

  • Event Grid

  • Monitor Query

  • OpenAI

  • Resource Management - BareMetal Infrastructure

  • Resource Management - Container Registry

  • Resource Management - Container Service

  • Resource Management - Cosmos DB

  • Resource Management - Event Grid

  • Resource Management - Hybrid Compute

  • Resource Management - Hybrid Container Service

  • Resource Management - Network Analytics

  • Resource Management - Postgresql

Release highlights

Azure AI Document Intelligence 1.0.0-beta.1 Changelog

Features Added

This marks the first preview of @azure-rest/ai-document-intelligence Rest Level Client Library for the Azure AI Document Intelligence service (formerly known as Form Recognizer). Please refer to the Readme and samples for more details.

Cognitive Search 12.0.0 Changelog

Breaking Changes

  • Minor type changes
  • All nullable optional properties can no longer be assigned null. Use undefined instead.
  • Updated specific property types for enhanced precision, replacing any with more defined types.
  • Narrowed some enum property types to the respective string literal union
  • BlobIndexerDataToExtract
  • BlobIndexerImageAction
  • BlobIndexerParsingMode
  • BlobIndexerPDFTextRotationAlgorithm
  • CustomEntityLookupSkillLanguage
  • EntityCategory
  • EntityRecognitionSkillLanguage
  • ImageAnalysisSkillLanguage
  • ImageDetail
  • IndexerExecutionEnvironment
  • KeyPhraseExtractionSkillLanguage
  • OcrSkillLanguage
  • RegexFlags
  • SearchIndexerDataSourceType
  • SentimentSkillLanguage
  • SplitSkillLanguage
  • TextSplitMode
  • TextTranslationSkillLanguage
  • VisualFeature
  • Removed KnownLexicalAnalyzerName as a duplicate of KnownAnalyzerNames
  • Removed KnownCharFilterName as a duplicate of KnownCharFilterNames
  • Removed KnownTokenFilterName as a duplicate of KnownTokenFilterNames
  • Removed SearchRequest as a duplicate of SearchRequestOptions
  • Added type narrowing for response types based on selected fields
  • For types that are generic on a model type, the model type is now constrained to extend object

Features Added

  • Added support for vector search
  • Added support for semantic search and reranking
  • New SearchIndexerSkills
  • EntityLinkingSkill
  • EntityRecognitionSkillV3
  • PIIDetectionSkill
  • SentimentSkillV3

Communication Call Automation 1.1.0 Changelog

Features Added

  • Mid Call actions support overriding callback url.
  • Cancel Add Participant Invitation.
  • Support transfer a participant in a group call to another participant.
  • Add Custom Context payload to Transfer and AddParticipant API.

Communication Chat 1.4.0 Changelog

Features Added

  • Added ChatAttachment object that contains properties for inline images incoming from Teams Chat Threads.
  • Updated to @azure/communication-signaling@1.0.0-beta.22 with inline image support

Communication Chat 1.5.0-beta.1 Changelog

Breaking Changes

  • Updated ChatAttachment properties
  • The url property becomes optional.
  • The contentType property has been removed.
  • AttachmentType Renaming: AttachmentType has been renamed to ChatAttachmentType, with its enums simplified to image, file, and unknown, replacing the previous teamsInlineImage, teamsImage, and file.

Communication Identity 1.3.0 Changelog

Features Added

  • Introduction of new scopes for token generation.
  • chat.join (Access to Chat APIs but without the authorization to create, delete or update chat threads)
  • (A more limited version of chat.join that doesn’t allow to add or remove participants)
  • voip.join (Access to Calling APIs but without the authorization to start new calls)
  • Added a new API version 2023_10_01 that is now the default API version.

Communication JobRouter 1.0.0 Changelog

Features Added

This is the initial release of the @azure-rest version of Job Router SDK. There was a previous preview SDK under a different package named @azure/communication-job-router which will be deprecated.

Using AzureCommunicationRoutingServiceClient:

  • Upsert, get, list and delete DistributionPolicy.
  • Upsert, get, list and delete RouterQueue.
  • Upsert, get, list and delete ClassificationPolicy.
  • Upsert, get, list and delete ExceptionPolicy.
  • Upsert, get, list and delete RouterJob.
  • RouterJob can be created and updated with different matching modes: QueueAndMatchMode, ScheduleAndSuspendMode and SuspendMode.
  • Reclassify a RouterJob.
  • Close a RouterJob.
  • Complete a RouterJob.
  • Cancel a RouterJob.
  • Unassign a RouterJob.
  • Get the position of a RouterJob in a queue.
  • Upsert, get, list and delete RouterWorker.
  • Accept an offer.
  • Decline an offer.
  • Get queue statistics.

Communication Phone Numbers 1.3.0-beta.2 Changelog

Features Added

  • Adding format fields to number lookup result
  • Support format-only search for number lookup feature

Communication Sms 1.1.0 Changelog

Features Added

  • With the dropping of support for Node.js versions that are no longer in LTS, the dependency on @types/node has been updated to version 12. Read our support policy for more details.
  • Migrated from using @azure/core-http to @azure/core-rest-pipeline for the handling of HTTP requests. See Azure Core v1 vs v2 for more on the difference and benefits of the move.
  • Updated our internal core package dependencies to their latest versions in order to add support for Opentelemetry 1.0.0 which is compatible with the latest versions of our other client libraries.
  • Changed TS compilation target to ES2017 in order to produce smaller bundles and use more native platform features.

Core - Client - Core Rest Pipeline 1.13.0 Changelog

Features Added

  • Add multipartPolicy and MultipartRequestBody to allow for making multipart requests.
  • Add createFile and createFileFromStream to allow creation of File objects for multipart/form-data requests.

Core - Client - HTTP 3.0.4 Changelog

Other Changes

  • Trim leading and trailing whitespace from header values.

Core - Client - Rest 1.1.5 Changelog

Bugs Fixed

  • Keeps request body of raw bytes for requests with application/octet-stream content type.

Core - Client - Rest 1.1.6 Changelog

Features Added

  • Add an overload for createRestError to accept PathUncheckedResponse only.

Dev Center 1.0.0-beta.3 Changelog

Breaking Changes

  • Environments client now works with “environment definitions” instead of “catalog items”
  • Creating a new environment requires passing environmentDefinitionName instead of catalogItemName
  • Creating a new environment requires passing an additional parameter catalogName

Event Grid 5.1.0-beta.1 Changelog

Breaking Changes

  • The interfaces RequestOptions, ReleaseOptions, RejectOptions, ClientOptions, AcknowledgeOptions have been removed.
  • In the FailedLockToken interface, the properties errorCode & errorDescription have been removed and replaced with new property error of type ErrorModel.

Please refer PR #27666 for further details.

Features Added

  • In the EventGridClient class, a new API renewCloudEventLocks has been added.
  • In the EventGridClient class, for the publishCloudEvent API, a new option binaryMode has been added. This enables the users to send in the binary encoded event.
  • For the ReleaseCloudEventsOptions interface, a new property releaseDelayInSeconds has been added.

Identity 3.4.1 Changelog

Bugs Fixed

  • Fixed regressions introduced by 3.4.0 #27761

Monitor Query 1.2.0-beta.3 Changelog

Other Changes

  • The Monitor Query service has done some internal changes and we have updated the service versions. A detailed list of changes could be found at PR #27825.

OpenAI 1.0.0-beta.8 Changelog

Features Added

  • -1106 model feature support for gpt-35-turbo and gpt-4-turbo, including use of seed, system_fingerprint, parallel function calling via tools, “JSON mode” for guaranteed function outputs, and more
  • dall-e-3 image generation capabilities via getImages, featuring higher model quality, automatic prompt revisions by gpt-4, and customizable quality/style settings
  • Greatly expanded “On Your Data” capabilities in Azure OpenAI, including many new data source options and authentication mechanisms
  • Early support for gpt-4-vision-preview, which allows the hybrid use of text and images as input to enable scenarios like “describe this image for me”
  • Support for Azure enhancements to gpt-4-vision-preview results that include grounding and OCR features

Breaking Changes

ChatMessage changes:

  • The singular ChatMessage type has been replaced by ChatRequestMessage and ChatResponseMessage, the former of which is a union of special message structures such as ChatRequestSystemMessage and ChatRequestUserMessage.


  • Azure OpenAI now uses dall-e-3 model deployments for its image generation API and such a valid deployment must be provided to the GetImageGenerations method.

On Your Data:

  • The AzureExtensionChatConfiguration type has been updated to inline the parameters of the extension into the configuration object itself.

Resource Management - App Service 14.1.0 Changelog

Resource Management - BareMetal Infrastructure 1.0.0-beta.2 Changelog

Resource Management - Chaos 1.0.0 Changelog

Resource Management - Confluent 3.0.0 Changelog

Resource Management - Container Registry 11.0.0-beta.3 Changelog

Resource Management - Container Service 19.5.0-beta.1 Changelog

Resource Management - Container Service 19.5.0 Changelog

Resource Management - Cosmos DB 15.6.0-beta.1 Changelog

Resource Management - Data Factory 12.0.0 Changelog

Resource Management - Databricks 3.0.0 Changelog

Resource Management - Event Grid 14.2.0-beta.2 Changelog

Resource Management - Hybrid Compute 3.1.0-beta.3 Changelog

Resource Management - Hybrid Container Service 1.0.0-beta.3 Changelog

Resource Management - Managed Grafana 1.1.0 Changelog

Resource Management - Mobile Network 4.0.0 Changelog

Resource Management - Network Analytics 1.0.0-beta.1 Changelog

Resource Management - Nginx 3.0.0 Changelog

Resource Management - Palo Alto Networks - Next Generation Firewall 1.1.0 Changelog

Resource Management - Postgresql 8.0.0-beta.4 Changelog

Resource Management - Quota 1.0.0 Changelog

Resource Management - Recovery Services Backup 12.0.0 Changelog

Resource Management - Service Networking 1.0.0 Changelog

Latest Releases

View all the latest versions of JavaScript packages here.

Installation Instructions

To install the packages, copy and paste the below into a terminal.

$> npm install @azure-rest/ai-document-intelligence@1.0.0-beta.1
$> npm install @azure-rest/communication-job-router@1.0.0
$> npm install @azure-rest/core-client@1.1.5
$> npm install @azure-rest/core-client@1.1.6
$> npm install @azure-rest/developer-devcenter@1.0.0-beta.3
$> npm install @azure/arm-appservice@14.1.0
$> npm install @azure/arm-baremetalinfrastructure@1.0.0-beta.2
$> npm install @azure/arm-chaos@1.0.0
$> npm install @azure/arm-confluent@3.0.0
$> npm install @azure/arm-containerregistry@11.0.0-beta.3
$> npm install @azure/arm-containerservice@19.5.0-beta.1
$> npm install @azure/arm-containerservice@19.5.0
$> npm install @azure/arm-cosmosdb@15.6.0-beta.1
$> npm install @azure/arm-dashboard@1.1.0
$> npm install @azure/arm-databricks@3.0.0
$> npm install @azure/arm-datafactory@12.0.0
$> npm install @azure/arm-eventgrid@14.2.0-beta.2
$> npm install @azure/arm-hybridcompute@3.1.0-beta.3
$> npm install @azure/arm-hybridcontainerservice@1.0.0-beta.3
$> npm install @azure/arm-mobilenetwork@4.0.0
$> npm install @azure/arm-networkanalytics@1.0.0-beta.1
$> npm install @azure/arm-nginx@3.0.0
$> npm install @azure/arm-paloaltonetworksngfw@1.1.0
$> npm install @azure/arm-postgresql-flexible@8.0.0-beta.4
$> npm install @azure/arm-quota@1.0.0
$> npm install @azure/arm-recoveryservicesbackup@12.0.0
$> npm install @azure/arm-servicenetworking@1.0.0
$> npm install @azure/communication-call-automation@1.1.0
$> npm install @azure/communication-chat@1.4.0
$> npm install @azure/communication-chat@1.5.0-beta.1
$> npm install @azure/communication-identity@1.3.0
$> npm install @azure/communication-phone-numbers@1.3.0-beta.2
$> npm install @azure/communication-sms@1.1.0
$> npm install @azure/core-http@3.0.4
$> npm install @azure/core-rest-pipeline@1.13.0
$> npm install @azure/eventgrid@5.1.0-beta.1
$> npm install @azure/identity@3.4.1
$> npm install @azure/monitor-query@1.2.0-beta.3
$> npm install @azure/openai@1.0.0-beta.8
$> npm install @azure/search-documents@12.0.0


If you have a bug or feature request for one of the libraries, please post an issue at the azure-sdk-for-js repository