@azure/storage-blob dependency causes TypeScript compilation error

[ostracod]

• Package Name: @azure/storage-blob
• Package Version: 12.32.0
• Operating system: macOS 26.4.1
• nodejs
  • version: 20.19.3
• browser
  • name/version:
• typescript
  • version: 5.9.3
• Is the bug related to documentation in
  • README.md
  • source code documentation
  • SDK API docs on https://learn.microsoft.com

Describe the bug
When compiling a TypeScript application with the @azure/storage-blob dependency, the TypeScript compiler throws this error:

node_modules/@azure/storage-common/dist/commonjs/bufferHelpers.d.ts:1:15 - error TS2305: Module '"@azure/core-rest-pipeline"' has no exported member 'NodeBuffer'.

1 import type { NodeBuffer } from "@azure/core-rest-pipeline";

To Reproduce
Create a project directory containing these files:

• package.json

  {
    "scripts": {
      "build": "tsc"
    },
    "dependencies": {
      "@azure/storage-blob": "12.32.0",
      "@types/node": "22.19.3",
      "typescript": "5.9.3"
    }
  }
  

• tsconfig.json

  {
    "compilerOptions": {
      "module": "commonjs",
      "target": "es6",
      "outDir": "dist",
      "baseUrl": ".",
      "paths": {
        "*": ["src/*"]
      }
    },
    "include": [
      "src/**/*.ts"
    ],
    "exclude": [
      "node_modules",
    ]
  }
  

• src/index.ts

  import { BlobServiceClient } from '@azure/storage-blob';
  console.log(BlobServiceClient);
  

From inside the project directory, run npm install and npm run build.

Expected behavior
The TypeScript compiler should not throw an error.

Additional context
This bug does not occur when using @azure/storage-blob version 12.29.1. We would appreciate if you could fix this TypeScript problem, since our team would like to stay up-to-date with the latest version of @azure/storage-blob.

[jeremymeng]

taking an initial look

[github-actions]

Agentic Issue Triage

Summary: azure/storage-blob v12.32.0 causes a TypeScript compilation error because azure/storage-common imports NodeBuffer from azure/core-rest-pipeline, but that type is no longer exported in the resolved version. The issue was introduced between v12.29.1 (working) and v12.32.0 (broken).

Issue Details

Package: azure/storage-blob v12.32.0
Affected API: azure/storage-common bufferHelpers.d.ts — NodeBuffer import from azure/core-rest-pipeline
Scenarios:

• Compiling any TypeScript project that depends on azure/storage-blob v12.32.0 fails with error TS2305: Module has no exported member 'NodeBuffer'
• The error originates in a transitive dependency (azure/storage-common), not in user code
• The issue does not occur with v12.29.1

Root ask: Fix the TypeScript compilation error so users can stay on the latest version.

Debugging / Reproduction Notes

The error is:

node_modules/.../bufferHelpers.d.ts:1:15 - error TS2305: Module 'core-rest-pipeline' has no exported member 'NodeBuffer'.

This is a type-level incompatibility: azure/storage-common imports NodeBuffer from azure/core-rest-pipeline, but the resolved version of that package no longer exports it.

Suggested investigation steps:

1. Check the core-rest-pipeline changelog to identify when NodeBuffer was removed from exports.
2. Verify which version of core-rest-pipeline is resolved when installing storage-blob v12.32.0 via npm.
3. Determine whether NodeBuffer should be restored to core-rest-pipeline exports, or storage-common should be updated to stop importing it from that location.

Label Confidence

• Category: Client — data-plane client library (sdk/storage/), not management-plane
• Service: Storage — azure/storage-blob lives in sdk/storage/
• Confidence: High — explicit package reference, unambiguous service directory, clearly a client SDK issue; matches label patterns seen in similar storage issues

Owner Routing

• Matched CODEOWNERS entry: # ServiceLabel: %Storage (line 299) — matched on %Storage label alone
• AzureSdkOwners: none listed for this entry
• ServiceOwners: none listed (the /sdk/storage/ path line lists PR routing owners only; no # ServiceOwners: block is present for this ServiceLabel)
• Routing action: Added needs-team-triage label; no assignment or ping made
• Scan notes (bottom-to-top): First encountered # ServiceLabel: %Service Attention %Storage (line 1485) — skipped, requires both %Service Attention and %Storage but issue lacks %Service Attention. Next match was # ServiceLabel: %Storage (line 299) — all required labels present, stopped here.

Generated by Agentic Triage for issue #38846 · ● 7M · ◷

[jeremymeng]

@ostracod thank you very much for the report! We missed publishing the new version of @azure/core-rest-pipeline. It will be released shortly today.

[ostracod]

@jeremymeng Thanks for the quick response! I look forward to using the fix.

[jeremymeng]

@ostracod we just released @azure/core-rest-pipeline v1.24.0. Please try re-installing/updating your dependencies

[ostracod]

@jeremymeng I just verified after reinstalling @azure/storage-blob 12.32.0 that the project compiles with no errors. Thanks for fixing the problem!