Azure SDK for JavaScript (August 2026)
The Azure SDK team is pleased to announce our August 2026 client library releases.
53 packages released this month.
Stable Packages (29)
-
AI Projects
-
Azure Monitor OpenTelemetry
-
Communication Common
-
Cosmos DB
-
IoT Device Update
-
Resource Management - Automation
-
Resource Management - Compute
-
Resource Management - Computelimit
-
Resource Management - Connected Cache
-
Resource Management - Consumption
-
Resource Management - Container Service
-
Resource Management - Container Service Fleet
-
Resource Management - Content Delivery Network
-
Resource Management - Data Box Edge
-
Resource Management - Discovery
-
Resource Management - Elastic
-
Resource Management - Event Hubs
-
Resource Management - Front Door
-
Resource Management - Hybrid Kubernetes
-
Resource Management - IoT Operations
-
Resource Management - Kusto
-
Resource Management - NetApp Files
-
Resource Management - Network Function
-
Resource Management - Relay
-
Resource Management - Resource Graph
-
Resource Management - Service Bus
-
Storage Common
-
Voice Live
-
unknown
Patch Updates (1)
- Resource Management - Policy
Beta Packages (20)
-
Content Understanding
-
Cosmos DB
-
OpenTelemetry Exporter
-
Resource Management - Cloud Health
-
Resource Management - Compute Fleet
-
Resource Management - Compute Recommender
-
Resource Management - Compute-Bulkactions
-
Resource Management - Confluent
-
Resource Management - Container Service
-
Resource Management - Containerserviceaimanager
-
Resource Management - Containerservicepreparedimgspec
-
Resource Management - Fabric
-
Resource Management - Hardware Security Modules
-
Resource Management - Hybrid Compute
-
Resource Management - IoT Hub
-
Resource Management - NetApp Files
-
Storage - Blobs
-
Storage - Files Share
-
Storage - Queues
-
TypeSpec HTTP Runtime
Release highlights
AI Projects 2.4.0 Changelog
Features Added
- Added
JobOperationStateandJobPollertypes, exposing thejobIdof a queued job on the pollers returned by the beta job creation operations. - Added
project.agents.patchAgentObjectfor merge-patching agent endpoint configuration and agent card metadata. - Added
ToolSearchToolboxToolas a generally availabletoolbox_searchtool type onproject.toolboxes, letting an agent discover a toolbox’s tools at run time instead of binding every tool up front. - Added
statusproperty andAgentIdentityStatustype onAgentIdentityto report whether an agent instance identity or agent blueprint is active or disabled. - Added
TaskGenerationDataGenerationJobOptionsas atask_generationjob type onproject.beta.datasetsfor generating multiturn evaluation test cases. - Added
max_stallstoOptimizationOptionsto cap the number of consecutive reflective minibatch rejections before an optimization job stops early. - Added generation provenance and input-quality advisories to
project.beta.evaluators:generation_job_idandwarningsonEvaluatorVersion, andinput_quality_warningsonEvaluatorGenerationJob. The advisories are surfaced asRubricGenerationInputQualityWarningvalues.
Breaking Changes
- Changed the beta job creation operations
project.beta.agents.createOptimizationJob,project.beta.datasets.createGenerationJob, andproject.beta.evaluators.createGenerationJobinto long-running operations. Each now returns a poller instead of a promise, and resolves to the job result (OptimizationJobResult,DataGenerationJobResult, andEvaluatorVersionrespectively) rather than the queued job. CallpollUntilDone()to await completion, orsubmitted()to continue once the job is queued. Each operation also accepts a newupdateIntervalInMsoption to control the polling interval. The queued job’s id is available aspoller.operationState?.jobIdoncesubmitted()resolves, so it can still be passed to the paired get, cancel, and delete operations.
Azure Monitor OpenTelemetry 1.19.0 Changelog
Bugs Fixed
- Fixed
APPLICATIONINSIGHTS_INSTRUMENTATION_LOGGING_LEVEL=NONEnot disabling log collection.NONEnow skips registering the log instrumentations entirely, so no logs are collected. #39400
Features Added
- Live Metrics (QuickPulse) now honors the
APPLICATIONINSIGHTS_AUTHENTICATION_STRINGenvironment variable for Azure Active Directory (AAD) authentication as a fallback when no explicit credential is supplied. #39445 - Added support for collecting
consolelogs via the@opentelemetry/instrumentation-consolepackage. Enable it withinstrumentationOptions: { console: { enabled: true } }(disabled by default). #39400
Communication Common 2.5.0 Changelog
Features Added
AzureCommunicationTokenCredentialnow supports encrypted/opaque access tokens that cannot be decoded (e.g. for enterprise Entra users):tokenRefreshermay return anAccessToken({ token, expiresOnTimestamp }) and the static constructor accepts anAccessToken, allowing the expiry to be supplied explicitly instead of decoded from the token. This is the recommended way to supply encrypted/opaque tokens.- A token that cannot be decoded is now accepted as-is and assigned a fallback expiry, instead of throwing at construction as it did previously; only an empty token is rejected.
- Added
undecodableTokenExpiryIntervalInSecondstoCommunicationTokenRefreshOptionsto configure the lifetime assumed for an undecodable token without an explicit expiry (default 600 seconds).
Bugs Fixed
- Fixed
dispose()not always cancelling the scheduled proactive token refresh, which could trigger a token refresh after the credential was disposed. - A token that decodes successfully but has no
expclaim no longer yields aNaNexpiry; it now uses the fallback expiry.
Content Understanding 1.2.0-beta.3 Changelog
Features Added
- Added support for service API version
2026-06-01-preview, which is the default service API version for this beta package. - Added inline analysis convenience APIs
ContentUnderstandingClient.analyzeInlineandanalyzeBinaryInline, available only with service API version2026-06-01-preview. These returnAnalysisResultin a single HTTP 200 response (no LRO polling), are capped at 5 pages per request, and surface service failures asRestError: HTTP 4xx/5xx responses (for example a 400InvalidRequestwithinnererror.code = "InputPageCountExceeded"when the 5-page limit is exceeded) carry the real HTTP status code and the parsed service error code / body, while an HTTP 200 with a non-Succeededoperation state is surfaced ascode: "InlineAnalyzeOperationFailed"— matching the completed-LRO analyze behavior. Options bags:AnalyzeInlineOptionalParams,AnalyzeBinaryInlineOptionalParams. See analyzeInline.ts and analyzeBinaryInline.ts. - Added semantic chunking for custom analyzers in
2026-06-01-preview: configureContentAnalyzerConfig.chunkingStrategywithSemanticChunkingStrategy(for examplemaxTokens) when creating an analyzer, then readDocumentContent.chunks(DocumentChunkspans into markdown) from the analysis result. Supporting types:ChunkingStrategy,ChunkingStrategyKind,ChunkingStrategyUnion. See analyzeChunking.ts. - Added analyzer workflow selection via
ContentAnalyzerConfig.workflow/ContentAnalyzerWorkflowfor2026-06-01-preview. Omitworkflow(or set"default") for standard field extraction, or set"agentic"when an answer must be built from evidence across the document (one input file per request; advanced contextualization rate). See createAnalyzerWorkflow.ts. - Added signature detection via
DocumentSignature/DocumentContent.signaturesfor2026-06-01-preview(for example withprebuilt-layout). See detectSignatures.ts and analyzeConfigs.ts. - Added in-page segmentation opt-in via
ContentAnalyzerConfig.allowInPageSegmentsfor2026-06-01-preview. Used withenableSegment, this allows classification segments to split within a page (for example an invoice and a statement on the same page) instead of only at page boundaries. Exposed on results viaDocumentContent.segments: DocumentContentSegment[](companion to the existingAudioVisualContent.segments). See classifyInPageSegments.ts. - Added embedded document metadata via
AnalysisContent.metadata: Record<string, string>for2026-06-01-preview(author, title, contentType, createdAt, and so on, returned byprebuilt-layout). See extractDocumentMetadata.ts. - Added analysis diagnostics via
AnalysisResult.infos: ErrorModel[]for2026-06-01-preview. The collection exposes service information asErrorModelvalues for troubleshooting. See analyzeDiagnostics.ts. - Updated
toLlmInput(preview) to emit analysis-result metadata (AnalysisContent.metadata) under ametadata:front-matter block. See toLlmInput.ts. - Aligned
toLlmInputYAML front matter output with the current CU service contract: the top-levelcontentType:key is nowmimeType:and rendersAnalysisContent.mimeType(for exampleapplication/pdf,audio/mpeg,video/mp4) instead of the discriminator (document/audioVisual); therai_warnings:key is nowwarnings:. Both are preview API changes from1.2.0-beta.1; not a stable-breaking change. toLlmInput(preview) now preserves caller-suppliednullvalues and empty collections incustomMetadata:nullrenders as YAMLnull, empty objects render as{}, and empty arrays render as[]. Previously nulls and empty containers were silently dropped from the emitted front matter.- Hardened
toLlmInput(preview) YAML front-matter emission against untrusted multi-line values. Continuation lines are now indented to match the current mapping depth, so a caller-supplied or service-extracted metadata value whose content contains a---line cannot terminate the front matter early. - Added
AnalysisResult.usage: UsageDetailsto expose analyze usage/metering details on both LRO (analyze/analyzeBinary) and inline (analyzeInline/analyzeBinaryInline) results — available on the completed poller’sAnalysisResultor on the inline response. LRO callers can still access usage viapoller.operationState?.usage; both accessors now return the same object. - Re-exported
RestErrorandisRestErrorfrom@azure/core-rest-pipeline(#39007).
Cosmos DB 4.10.0-beta.1 Changelog
Features Added
- Added a semantic reranking API. Use
Container.semanticRerank(rerankContext, documents, options)to score and reorder documents by relevance via the Cosmos DB Inference Service. Configure it throughenablePreviewFeatures.semanticRerankonCosmosClientOptions:inferenceEndpoint(required) and an optionalinferenceRequestTimeout(ms, default 5000) single-attempt timeout that fails with HTTP 408 when exceeded. Requires AAD authentication. The result and any thrown error includeCosmosDiagnosticsfor the operation. - Added
enablePreviewFeaturestoCosmosClientOptions, a dictionary for opting into preview features of the SDK.
Bugs Fixed
- #38087 Made
boundingBoxoptional on theSpatialIndextype. Bounding boxes are only required for geometry spatial indexes, not geography ones. - Fixed cross-partition queries making a redundant
/pkrangesmetadata call on every query. Queries now reuse the shared partition key range cache (worst for hybrid queries, which previously fetched ranges per component query). The cache is also made failure-safe so a transient fetch error no longer poisons later lookups. - #39115 Fixed continuation token handling for
enableQueryControlqueries. Resuming now routes through the query plan instead of forwarding the SDK-internal composite token to the gateway, avoiding an extra failing call and theMalformedContinuationTokenerror.
Cosmos DB 4.10.0 Changelog
Bugs Fixed
- #38087 Made
boundingBoxoptional on theSpatialIndextype. Bounding boxes are only required for geometry spatial indexes, not geography ones. - Fixed cross-partition queries making a redundant
/pkrangesmetadata call on every query. Queries now reuse the shared partition key range cache (worst for hybrid queries, which previously fetched ranges per component query). The cache is also made failure-safe so a transient fetch error no longer poisons later lookups. - #39115 Fixed continuation token handling for
enableQueryControlqueries. Resuming now routes through the query plan instead of forwarding the SDK-internal composite token to the gateway, avoiding an extra failing call and theMalformedContinuationTokenerror.
Features Added
- Added a semantic reranking API. Use
Container.semanticRerank(rerankContext, documents, options)to score and reorder documents by relevance via the Cosmos DB Inference Service. Configure it throughenablePreviewFeatures.semanticRerankonCosmosClientOptions:inferenceEndpoint(required) and an optionalinferenceRequestTimeout(ms, default 5000) single-attempt timeout that fails with HTTP 408 when exceeded. Requires AAD authentication. The result and any thrown error includeCosmosDiagnosticsfor the operation. - Added
enablePreviewFeaturestoCosmosClientOptions, a dictionary for opting into preview features of the SDK.
IoT Device Update 1.1.0 Changelog
Features Added
- Initial stable release of the Azure Device Update for IoT Hub client library for JavaScript, generated from TypeSpec.
- Added support for API version
2026-06-01, including the new optionaldownloadSecurityproperty onDeploymentso callers can choose the protocol the device should use when downloading update payload (defaults to"https").
OpenTelemetry Exporter 1.0.0-beta.44 Changelog
Bugs Fixed
- Persist telemetry for later retry when no HTTP response is received. #39277
Resource Management - Automation 11.0.0 Changelog
Resource Management - Cloud Health 1.0.0-beta.3 Changelog
Resource Management - Compute 25.0.0 Changelog
Resource Management - Compute Fleet 2.0.0-beta.3 Changelog
Resource Management - Compute Recommender 1.1.0-beta.1 Changelog
Resource Management - Compute-Bulkactions 1.0.0-beta.1 Changelog
Resource Management - Compute-Bulkactions 1.0.0-beta.2 Changelog
Resource Management - Computelimit 1.3.0 Changelog
Resource Management - Confluent 4.0.0-beta.2 Changelog
Resource Management - Connected Cache 1.0.0 Changelog
Resource Management - Consumption 10.0.0 Changelog
Resource Management - Container Service 25.4.0 Changelog
Resource Management - Container Service 25.5.0-beta.1 Changelog
Resource Management - Container Service Fleet 2.1.0 Changelog
Resource Management - Containerserviceaimanager 1.0.0-beta.1 Changelog
Resource Management - Containerservicepreparedimgspec 1.0.0-beta.1 Changelog
Resource Management - Content Delivery Network 10.0.0 Changelog
Resource Management - Data Box Edge 3.0.0 Changelog
Resource Management - Discovery 1.0.0 Changelog
Resource Management - Elastic 3.0.0 Changelog
Resource Management - Event Hubs 6.0.0 Changelog
Resource Management - Fabric 1.1.0-beta.1 Changelog
Resource Management - Front Door 6.0.0 Changelog
Resource Management - Hardware Security Modules 3.0.0-beta.1 Changelog
Resource Management - Hybrid Compute 5.0.0-beta.3 Changelog
Resource Management - Hybrid Kubernetes 3.0.0 Changelog
Resource Management - IoT Hub 7.0.0-beta.3 Changelog
Resource Management - IoT Operations 2.1.0 Changelog
Resource Management - Kusto 9.0.0 Changelog
Resource Management - NetApp Files 24.2.0 Changelog
Resource Management - NetApp Files 25.0.0-beta.2 Changelog
Resource Management - Network Function 3.0.0 Changelog
Resource Management - Policy 7.0.1 Changelog
Resource Management - Relay 4.0.0 Changelog
Resource Management - Resource Graph 5.0.0 Changelog
Resource Management - Service Bus 7.0.0 Changelog
Storage - Blobs 12.34.0-beta.1 Changelog
Features Added
- Added support for service version 2026-10-06.
- Added
accessTier,accessTierInferred,accessTierChangedOn, andsmartAccessTierto the blob download response. - Added an opt-in Apache Arrow response format for
listBlobsFlatandlistBlobsByHierarchy(setresponseFormattoStorageResponseFormat.Arrow), plus a newendBeforelist option. The default remains XML.
Storage - Files Share 12.33.0-beta.1 Changelog
Bugs Fixed
- Stopped exporting the internal-only
FileDownloadOptionalParamsandFileUploadRangeFromURLOptionalParamstypes, which are not referenced by any public API.
Features Added
- Added support for service version 2026-10-06.
- Added
ShareFileClient.listRanges()andShareFileClient.listRangesDiff()to list file ranges as a paginated async iterable with continuation-token support. - Deprecated
ShareFileClient.getRangeList()andShareFileClient.getRangeListDiff()in favor oflistRanges()andlistRangesDiff().
Storage - Queues 12.32.0-beta.1 Changelog
Other Changes
- Migrated to TypeSpec-based code generation PR #38224
Storage Common 12.5.0 Changelog
Bugs Fixed
- Fixed the ESM build of the CRC64 checksum calculator crashing (
TypeError [ERR_INVALID_ARG_VALUE]fromimport.meta.url) when an ESM consumer is bundled to CommonJS with a Node-targeted bundler such as esbuild. Because the WebAssembly module is base64-embedded, none of the Emscripten-generated filesystem/URL machinery is reachable, so theimport.meta.urlpolyfill,node:*imports,require('fs')/require('path')reads, and the shell/web read hooks have been removed fromcrc64.js. The ESM, browser, and react-native builds are now identical, and the CommonJS copy differs only by its export statement. Issue #39057.
Features Added
- add
storageRedirectRangeHeaderPolicy - Added the
StorageResponseFormatenum (Auto,Xml,Arrow), re-exported by@azure/storage-blobto opt into the Apache Arrow response format when listing blobs.
TypeSpec HTTP Runtime 0.3.8 Changelog
Features Added
- Added an optional
internalproperty toClientOptionsforgetClient, carrying anoDefaultAcceptHeaderflag (defaults tofalse). When set totrue, the client no longer adds a defaultAccept: application/jsonrequest header to operations that do not otherwise specify one, allowing operations that expect no response body to omit theAcceptheader. This option is intended for use by generated clients. PR #39291
Voice Live 1.1.0 Changelog
Features Added
- Added
ClientEventInputTextDeltaandClientEventInputTextDoneclient events (input_text.delta/input_text.done, plus the correspondingKnownClientEventTypemembers) for streaming input text content into a conversation item. - Added Azure realtime native voices via
AzureRealtimeNativeVoice(andAzureRealtimeNativeVoiceName), including theKnownAzureRealtimeNativeVoiceNameenum of service-known voice names.AzureRealtimeNativeVoiceis now part of theVoiceunion. - Added echo-cancellation reference configuration:
AudioEchoCancellation.channelsandAudioEchoCancellation.referenceSource, plus theEchoCancellationReferenceSourcetype andKnownEchoCancellationReferenceSourceenum. - Added
ServerEventResponseInvocationDelta(andKnownServerEventType.ResponseInvocationDelta) for passthrough hosted-agent invocation SSE payloads. - Added
ResponseCreateParams.invokeInputto supply input data for hosted-agent invocation. - Added
ResponseSession.expiresAt: aDatefor the server-assigned session expiration. It is read-only and cannot be changed withsession.update. - Re-exported
RestErrorandisRestErrorfrom@azure/core-rest-pipeline.
Breaking Changes
- API version updated from
2026-04-10to2026-07-15. - Renamed
RequestImageContentPart.urltoRequestImageContentPart.imageUrlto align the SDK model with theimage_urlwire shape.
unknown 1.0.0 Changelog
Features Added
- Initial stable release of the Azure AI Discovery client library for JavaScript, exposing
WorkspaceClient(conversations, investigations, tasks, tools) andBookshelfClient(knowledge bases).
unknown 1.0.0 Changelog
Breaking Changes
- The package name changed from
@azure-rest/ai-translation-documentto@azure/ai-translation-document. - The REST-level client (RLC) surface (
client.path(...).post(...)) has been replaced with a modeled client surface exposingDocumentTranslationClientandSingleDocumentTranslationClient. See the README for migration examples.
Migration guide
- Install the new package: replace
@azure-rest/ai-translation-documentwith@azure/ai-translation-document. - Create the client: the default export factory is replaced by named clients.
- import DocumentTranslator from "@azure-rest/ai-translation-document";
- const client = DocumentTranslator(endpoint, credential);
+ import { DocumentTranslationClient } from "@azure/ai-translation-document";
+ const client = new DocumentTranslationClient(endpoint, credential);
- Call operations: replace the
path(...).method()pattern with typed methods.
- await client.path("/document/batches").post({ body: { inputs } });
+ await client.startTranslation({ inputs });
- Single document translation: use
SingleDocumentTranslationClient.
- import DocumentTranslator from "@azure-rest/ai-translation-document";
- const client = DocumentTranslator(endpoint, credential);
- await client.path("/document:translate").post({ ... });
+ import { SingleDocumentTranslationClient } from "@azure/ai-translation-document";
+ const client = new SingleDocumentTranslationClient(endpoint, credential);
+ await client.translate(targetLanguage, content);
- Responses: results are returned as typed objects and errors are thrown as
RestError, instead of checkingresponse.statuson a raw HTTP response.
Features Added
- Added support for the
2026-03-01service API version. - Added
deploymentNametoTargetInputandDocumentStatusto support translating with a custom translation model. - Added
deploymentNameparameter to single document translation. - Added support for translating text within images:
translateTextWithinImageon batch and single document translation, and image-scan fields (imageCharacterDetected,imageCharged,totalImageScansSucceeded,totalImageScansFailed) onDocumentStatus.
unknown 1.0.0 Changelog
Features Added
- Added secure, cross-platform executable resolution and process-launching primitives for Node.js. #39279
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/ai-content-understanding@1.2.0-beta.3
$> npm install @azure/ai-discovery@1.0.0
$> npm install @azure/ai-projects@2.4.0
$> npm install @azure/ai-translation-document@1.0.0
$> npm install @azure/ai-voicelive@1.1.0
$> npm install @azure/arm-automation@11.0.0
$> npm install @azure/arm-cdn@10.0.0
$> npm install @azure/arm-cloudhealth@1.0.0-beta.3
$> npm install @azure/arm-compute@25.0.0
$> npm install @azure/arm-compute-bulkactions@1.0.0-beta.1
$> npm install @azure/arm-compute-bulkactions@1.0.0-beta.2
$> npm install @azure/arm-computefleet@2.0.0-beta.3
$> npm install @azure/arm-computelimit@1.3.0
$> npm install @azure/arm-computerecommender@1.1.0-beta.1
$> npm install @azure/arm-confluent@4.0.0-beta.2
$> npm install @azure/arm-connectedcache@1.0.0
$> npm install @azure/arm-consumption@10.0.0
$> npm install @azure/arm-containerservice@25.4.0
$> npm install @azure/arm-containerservice@25.5.0-beta.1
$> npm install @azure/arm-containerserviceaimanager@1.0.0-beta.1
$> npm install @azure/arm-containerservicefleet@2.1.0
$> npm install @azure/arm-containerservicepreparedimgspec@1.0.0-beta.1
$> npm install @azure/arm-databoxedge@3.0.0
$> npm install @azure/arm-discovery@1.0.0
$> npm install @azure/arm-elastic@3.0.0
$> npm install @azure/arm-eventhub@6.0.0
$> npm install @azure/arm-fabric@1.1.0-beta.1
$> npm install @azure/arm-frontdoor@6.0.0
$> npm install @azure/arm-hardwaresecuritymodules@3.0.0-beta.1
$> npm install @azure/arm-hybridcompute@5.0.0-beta.3
$> npm install @azure/arm-hybridkubernetes@3.0.0
$> npm install @azure/arm-iothub@7.0.0-beta.3
$> npm install @azure/arm-iotoperations@2.1.0
$> npm install @azure/arm-kusto@9.0.0
$> npm install @azure/arm-netapp@24.2.0
$> npm install @azure/arm-netapp@25.0.0-beta.2
$> npm install @azure/arm-networkfunction@3.0.0
$> npm install @azure/arm-policy@7.0.1
$> npm install @azure/arm-relay@4.0.0
$> npm install @azure/arm-resourcegraph@5.0.0
$> npm install @azure/arm-servicebus@7.0.0
$> npm install @azure/communication-common@2.5.0
$> npm install @azure/core-process@1.0.0
$> npm install @azure/cosmos@4.10.0-beta.1
$> npm install @azure/cosmos@4.10.0
$> npm install @azure/iot-device-update@1.1.0
$> npm install @azure/monitor-opentelemetry@1.19.0
$> npm install @azure/monitor-opentelemetry-exporter@1.0.0-beta.44
$> npm install @azure/storage-blob@12.34.0-beta.1
$> npm install @azure/storage-common@12.5.0
$> npm install @azure/storage-file-share@12.33.0-beta.1
$> npm install @azure/storage-queue@12.32.0-beta.1
$> npm install @typespec/ts-http-runtime@0.3.8
Feedback
If you have a bug or feature request for one of the libraries, please post an issue at the azure-sdk-for-js repository