{
  "schema": "https://ai-atoms.com/schemas/skill-v1.json",
  "type": "skill",
  "id": "skill/azure-storage-blob-ts",
  "version": "1.0.1",
  "name": "Azure Storage Blob Ts",
  "description": "Azure Blob Storage JavaScript/TypeScript SDK (@azure/storage-blob) for blob operations. Use for uploading, downloading, listing, and managing blobs and containers. Supports block blobs, append blobs, page blobs, SAS tokens, and streaming. Triggers: \"blob storage\", \"@azure/storage-blob\", \"BlobServiceClient\", \"ContainerClient\", \"upload blob\", \"download blob\", \"SAS token\", \"block blob\".",
  "system_prompt_fragment": "# @azure/storage-blob (TypeScript/JavaScript)\n\nSDK for Azure Blob Storage operations — upload, download, list, and manage blobs and containers.\n\n## Installation\n\n```bash\nnpm install @azure/storage-blob @azure/identity\n```\n\n**Current Version**: 12.x  \n**Node.js**: >= 18.0.0\n\n## Environment Variables\n\n```bash\nAZURE_STORAGE_ACCOUNT_NAME=<account-name>\nAZURE_STORAGE_ACCOUNT_KEY=<account-key>\n# OR connection string\nAZURE_STORAGE_CONNECTION_STRING=DefaultEndpointsProtocol=https;AccountName=...\n```\n\n## Authentication\n\n### DefaultAzureCredential (Recommended)\n\n```typescript\nimport { BlobServiceClient } from \"@azure/storage-blob\";\nimport { DefaultAzureCredential } from \"@azure/identity\";\n\nconst accountName = process.env.AZURE_STORAGE_ACCOUNT_NAME!;\nconst client = new BlobServiceClient(\n  `https://${accountName}.blob.core.windows.net`,\n  new DefaultAzureCredential()\n);\n```\n\n### Connection String\n\n```typescript\nimport { BlobServiceClient } from \"@azure/storage-blob\";\n\nconst client = BlobServiceClient.fromConnectionString(\n  process.env.AZURE_STORAGE_CONNECTION_STRING!\n);\n```\n\n### StorageSharedKeyCredential (Node.js only)\n\n```typescript\nimport { BlobServiceClient, StorageSharedKeyCredential } from \"@azure/storage-blob\";\n\nconst accountName = process.env.AZURE_STORAGE_ACCOUNT_NAME!;\nconst accountKey = process.env.AZURE_STORAGE_ACCOUNT_KEY!;\n\nconst sharedKeyCredential = new StorageSharedKeyCredential(accountName, accountKey);\nconst client = new BlobServiceClient(\n  `https://${accountName}.blob.core.windows.net`,\n  sharedKeyCredential\n);\n```\n\n### SAS Token\n\n```typescript\nimport { BlobServiceClient } from \"@azure/storage-blob\";\n\nconst accountName = process.env.AZURE_STORAGE_ACCOUNT_NAME!;\nconst sasToken = process.env.AZURE_STORAGE_SAS_TOKEN!; // starts with \"?\"\n\nconst client = new BlobServiceClient(\n  `https://${accountName}.blob.core.windows.net${sasToken}`\n);\n```\n\n## Client Hierarchy\n\n```\nBlobServiceClient (account level)\n└── ContainerClient (container level)\n    └── BlobClient (blob level)\n        ├── BlockBlobClient (block blobs - most common)\n        ├── AppendBlobClient (append-only blobs)\n        └── PageBlobClient (page blobs - VHDs)\n```\n\n## Container Operations\n\n### Create Container\n\n```typescript\nconst containerClient = client.getContainerClient(\"my-container\");\nawait containerClient.create();\n\n// Or create if not exists\nawait containerClient.createIfNotExists();\n```\n\n### List Containers\n\n```typescript\nfor await (const container of client.listContainers()) {\n  console.log(container.name);\n}\n\n// With prefix filter\nfor await (const container of client.listContainers({ prefix: \"logs-\" })) {\n  console.log(container.name);\n}\n```\n\n### Delete Container\n\n```typescript\nawait containerClient.delete();\n// Or delete if exists\nawait containerClient.deleteIfExists();\n```\n\n## Blob Operations\n\n### Upload Blob (Simple)\n\n```typescript\nconst containerClient = client.getContainerClient(\"my-container\");\nconst blockBlobClient = containerClient.getBlockBlobClient(\"my-file.txt\");\n\n// Upload string\nawait blockBlobClient.upload(\"Hello, World!\", 13);\n\n// Upload Buffer\nconst buffer = Buffer.from(\"Hello, World!\");\nawait blockBlobClient.upload(buffer, buffer.length);\n```\n\n### Upload from File (Node.js only)\n\n```typescript\nconst blockBlobClient = containerClient.getBlockBlobClient(\"uploaded-file.txt\");\nawait blockBlobClient.uploadFile(\"/path/to/local/file.txt\");\n```\n\n### Upload from Stream (Node.js only)\n\n```typescript\nimport * as fs from \"fs\";\n\nconst blockBlobClient = containerClient.getBlockBlobClient(\"streamed-file.txt\");\nconst readStream = fs.createReadStream(\"/path/to/local/file.txt\");\n\nawait blockBlobClient.uploadStream(readStream, 4 * 1024 * 1024, 5, {\n  // bufferSize: 4MB, maxConcurrency: 5\n  onProgress: (progress) => console.log(`Uploaded ${progress.loadedBytes} bytes`),\n});\n```\n\n### Upload from Browser\n\n```typescript\nconst blockBlobClient = containerClient.getBlockBlobClient(\"browser-upload.txt\");\n\n// From File input\nconst fileInput = document.getElementById(\"fileInput\") as HTMLInputElement;\nconst file = fileInput.files![0];\nawait blockBlobClient.uploadData(file);\n\n// From Blob/ArrayBuffer\nconst arrayBuffer = new ArrayBuffer(1024);\nawait blockBlobClient.uploadData(arrayBuffer);\n```\n\n### Download Blob\n\n```typescript\nconst blobClient = containerClient.getBlobClient(\"my-file.txt\");\nconst downloadResponse = await blobClient.download();\n\n// Read as string (browser & Node.js)\nconst downloaded = await streamToText(downloadResponse.readableStreamBody!);\n\nasync function streamToText(readable: NodeJS.ReadableStream): Promise<string> {\n  const chunks: Buffer[] = [];\n  for await (const chunk of readable) {\n    chunks.push(Buffer.from(chunk));\n  }\n  return Buffer.concat(chunks).toString(\"utf-8\");\n}\n```\n\n### Download to File (Node.js only)\n\n```typescript\nconst blockBlobClient = containerClient.getBlockBlobClient(\"my-file.txt\");\nawait blockBlobClient.downloadToFile(\"/path/to/local/destination.txt\");\n```\n\n### Download to Buffer (Node.js only)\n\n```typescript\nconst blockBlobClient = containerClient.getBlockBlobClient(\"my-file.txt\");\nconst buffer = await blockBlobClient.downloadToBuffer();\nconsole.log(buffer.toString());\n```\n\n### List Blobs\n\n```typescript\n// List all blobs\nfor await (const blob of containerClient.listBlobsFlat()) {\n  console.log(blob.name, blob.properties.contentLength);\n}\n\n// List with prefix\nfor await (const blob of containerClient.listBlobsFlat({ prefix: \"logs/\" })) {\n  console.log(blob.name);\n}\n\n// List by hierarchy (virtual directories)\nfor await (const item of containerClient.listBlobsByHierarchy(\"/\")) {\n  if (item.kind === \"prefix\") {\n    console.log(`Directory: ${item.name}`);\n  } else {\n    console.log(`Blob: ${item.name}`);\n  }\n}\n```\n\n### Delete Blob\n\n```typescript\nconst blobClient = containerClient.getBlobClient(\"my-file.txt\");\nawait blobClient.delete();\n\n// Delete if exists\nawait blobClient.deleteIfExists();\n\n// Delete with snapshots\nawait blobClient.delete({ deleteSnapshots: \"include\" });\n```\n\n### Copy Blob\n\n```typescript\nconst sourceBlobClient = containerClient.getBlobClient(\"source.txt\");\nconst destBlobClient = containerClient.getBlobClient(\"destination.txt\");\n\n// Start copy operation\nconst copyPoller = await destBlobClient.beginCopyFromURL(sourceBlobClient.url);\nawait copyPoller.pollUntilDone();\n```\n\n## Blob Properties & Metadata\n\n### Get Properties\n\n```typescript\nconst blobClient = containerClient.getBlobClient(\"my-file.txt\");\nconst properties = await blobClient.getProperties();\n\nconsole.log(\"Content-Type:\", properties.contentType);\nconsole.log(\"Content-Length:\", properties.contentLength);\nconsole.log(\"Last Modified:\", properties.lastModified);\nconsole.log(\"ETag:\", properties.etag);\n```\n\n### Set Metadata\n\n```typescript\nawait blobClient.setMetadata({\n  author: \"John Doe\",\n  category: \"documents\",\n});\n```\n\n### Set HTTP Headers\n\n```typescript\nawait blobClient.setHTTPHeaders({\n  blobContentType: \"text/plain\",\n  blobCacheControl: \"max-age=3600\",\n  blobContentDisposition: \"attachment; filename=download.txt\",\n});\n```\n\n## SAS Token Generation (Node.js only)\n\n### Generate Blob SAS\n\n```typescript\nimport {\n  BlobSASPermissions,\n  generateBlobSASQueryParameters,\n  StorageSharedKeyCredential,\n} from \"@azure/storage-blob\";\n\nconst sharedKeyCredential = new StorageSharedKeyCredential(accountName, accountKey);\n\nconst sasToken = generateBlobSASQueryParameters(\n  {\n    containerName: \"my-container\",\n    blobName: \"my-file.txt\",\n    permissions: BlobSASPermissions.parse(\"r\"), // read only\n    startsOn: new Date(),\n    expiresOn: new Date(Date.now() + 3600 * 1000), // 1 hour\n  },\n  sharedKeyCredential\n).toString();\n\nconst sasUrl = `https://${accountName}.blob.core.windows.net/my-container/my-file.txt?${sasToken}`;\n```\n\n### Generate Container SAS\n\n```typescript\nimport { ContainerSASPermissions, generateBlobSASQueryParameters } from \"@azure/storage-blob\";\n\nconst sasToken = generateBlobSASQueryParameters(\n  {\n    containerName: \"my-container\",\n    permissions: ContainerSASPermissions.parse(\"racwdl\"), // read, add, create, write, delete, list\n    expiresOn: new Date(Date.now() + 24 * 3600 * 1000), // 24 hours\n  },\n  sharedKeyCredential\n).toString();\n```\n\n### Generate Account SAS\n\n```typescript\nimport {\n  AccountSASPermissions,\n  AccountSASResourceTypes,\n  AccountSASServices,\n  generateAccountSASQueryParameters,\n} from \"@azure/storage-blob\";\n\nconst sasToken = generateAccountSASQueryParameters(\n  {\n    services: AccountSASServices.parse(\"b\").toString(), // blob\n    resourceTypes: AccountSASResourceTypes.parse(\"sco\").toString(), // service, container, object\n    permissions: AccountSASPermissions.parse(\"rwdlacupi\"), // all permissions\n    expiresOn: new Date(Date.now() + 24 * 3600 * 1000),\n  },\n  sharedKeyCredential\n).toString();\n```\n\n## Blob Types\n\n### Block Blob (Default)\n\nMost common type for text and binary files.\n\n```typescript\nconst blockBlobClient = containerClient.getBlockBlobClient(\"document.pdf\");\nawait blockBlobClient.uploadFile(\"/path/to/document.pdf\");\n```\n\n### Append Blob\n\nOptimized for append operations (logs, audit trails).\n\n```typescript\nconst appendBlobClient = containerClient.getAppendBlobClient(\"app.log\");\n\n// Create the append blob\nawait appendBlobClient.create();\n\n// Append data\nawait appendBlobClient.appendBlock(\"Log entry 1\\n\", 12);\nawait appendBlobClient.appendBlock(\"Log entry 2\\n\", 12);\n```\n\n### Page Blob\n\nFixed-size blobs for random read/write (VHDs).\n\n```typescript\nconst pageBlobClient = containerClient.getPageBlobClient(\"disk.vhd\");\n\n// Create 512-byte aligned page blob\nawait pageBlobClient.create(1024 * 1024); // 1MB\n\n// Write pages (must be 512-byte aligned)\nconst buffer = Buffer.alloc(512);\nawait pageBlobClient.uploadPages(buffer, 0, 512);\n```\n\n## Error Handling\n\n```typescript\nimport { RestError } from \"@azure/storage-blob\";\n\ntry {\n  await containerClient.create();\n} catch (error) {\n  if (error instanceof RestError) {\n    switch (error.statusCode) {\n      case 404:\n        console.log(\"Container not found\");\n        break;\n      case 409:\n        console.log(\"Container already exists\");\n        break;\n      case 403:\n        console.log(\"Access denied\");\n        break;\n      default:\n        console.error(`Storage error ${error.statusCode}: ${error.message}`);\n    }\n  }\n  throw error;\n}\n```\n\n## TypeScript Types Reference\n\n```typescript\nimport {\n  // Clients\n  BlobServiceClient,\n  ContainerClient,\n  BlobClient,\n  BlockBlobClient,\n  AppendBlobClient,\n  PageBlobClient,\n\n  // Authentication\n  StorageSharedKeyCredential,\n  AnonymousCredential,\n\n  // SAS\n  BlobSASPermissions,\n  ContainerSASPermissions,\n  AccountSASPermissions,\n  AccountSASServices,\n  AccountSASResourceTypes,\n  generateBlobSASQueryParameters,\n  generateAccountSASQueryParameters,\n\n  // Options & Responses\n  BlobDownloadResponseParsed,\n  BlobUploadCommonResponse,\n  ContainerCreateResponse,\n  BlobItem,\n  ContainerItem,\n\n  // Errors\n  RestError,\n} from \"@azure/storage-blob\";\n```\n\n## Best Practices\n\n1. **Use DefaultAzureCredential** — Prefer AAD over connection strings/keys\n2. **Use streaming for large files** — `uploadStream`/`downloadToFile` for files > 256MB\n3. **Set appropriate content types** — Use `setHTTPHeaders` for correct MIME types\n4. **Use SAS tokens for client access** — Generate short-lived tokens for browser uploads\n5. **Handle errors gracefully** — Check `RestError.statusCode` for specific handling\n6. **Use `*IfNotExists` methods** — For idempotent container/blob creation\n7. **Close clients** — Not required but good practice in long-running apps\n\n## Platform Differences\n\n| Feature | Node.js | Browser |\n|---------|---------|---------|\n| `StorageSharedKeyCredential` | ✅ | ❌ |\n| `uploadFile()` | ✅ | ❌ |\n| `uploadStream()` | ✅ | ❌ |\n| `downloadToFile()` | ✅ | ❌ |\n| `downloadToBuffer()` | ✅ | ❌ |\n| `uploadData()` | ✅ | ✅ |\n| SAS generation | ✅ | ❌ |\n| DefaultAzureCredential | ✅ | ❌ |\n| Anonymous/SAS access | ✅ | ✅ |\n\n## When to Use\nThis skill is applicable to execute the workflow or actions described in the overview.",
  "applicable_domains": [
    "devops"
  ],
  "category": "devops",
  "invocation": [
    "/azure-storage-blob-ts"
  ],
  "authored_by": "claudeskills.in community",
  "source_url": "https://claudeskills.in/skill/azure-storage-blob-ts",
  "provenance": {
    "source": "claudeskills.in",
    "source_url": "https://claudeskills.in/skill/azure-storage-blob-ts",
    "license": "unknown",
    "imported_at": "2026-09-03",
    "notes": "Aggregated by claudeskills.in from community GitHub lists."
  },
  "tags": [
    "claudeskills",
    "devops"
  ],
  "lifecycle": "draft"
}