@basaltkit/storage-azure 1.0.0 → 1.0.1

package/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2026 Machize Contributors
+Copyright (c) 2026 Basalt Contributors
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/README.md

@@ -1,3 +1,9 @@
+<p align="center">
+  <a href="https://basaltkit-docs.pages.dev">
+    <img src="https://basaltkit-docs.pages.dev/social-card.png" alt="Basalt" width="440">
+  </a>
+</p>
+
 # @basaltkit/storage-azure
 
 An **Azure Blob Storage** driver for [`@basaltkit/storage`](https://www.npmjs.com/package/@basaltkit/storage): stores files in Azure Blob without changing your app code. You need this module when you run on Azure and want Blob Storage instead of S3, GCS, or local disk.

package/dist/index.d.ts

@@ -1,7 +1,6 @@
-import { StorageDriver, PutOptions } from '@basaltkit/storage';
-
+import { type PutOptions, type StorageDriver } from '@basaltkit/storage';
 /** The subset of an `@azure/storage-blob` BlockBlobClient this driver uses. */
-interface AzureBlobLike {
+export interface AzureBlobLike {
     uploadData(data: Buffer, options?: {
         blobHTTPHeaders?: {
             blobContentType?: string;
@@ -18,7 +17,7 @@ interface AzureBlobLike {
     }): Promise<string>;
 }
 /** The subset of an `@azure/storage-blob` ContainerClient this driver uses. */
-interface AzureContainerLike {
+export interface AzureContainerLike {
     getBlockBlobClient(path: string): AzureBlobLike;
     listBlobsFlat(options?: {
         prefix?: string;
@@ -26,7 +25,7 @@ interface AzureContainerLike {
         name: string;
     }>;
 }
-interface AzureDriverOptions {
+export interface AzureDriverOptions {
     container: string;
     connectionString?: string;
     /** Injectable container — defaults to `@azure/storage-blob`. Tests pass a fake. */
@@ -37,7 +36,7 @@ interface AzureDriverOptions {
  * (an optional peer dependency) via an injectable container client, so its
  * logic is unit-tested without touching Azure.
  */
-declare class AzureBlobStorageDriver implements StorageDriver {
+export declare class AzureBlobStorageDriver implements StorageDriver {
     private readonly options;
     readonly name = "azure";
     private containerPromise;
@@ -51,5 +50,3 @@ declare class AzureBlobStorageDriver implements StorageDriver {
     disconnect(): Promise<void>;
     private container;
 }
-
-export { type AzureBlobLike, AzureBlobStorageDriver, type AzureContainerLike, type AzureDriverOptions };

package/dist/index.js

@@ -1,54 +1,65 @@
-// src/index.ts
-import { StorageFileNotFoundError } from "@basaltkit/storage";
-var isNotFound = (error) => error?.statusCode === 404 || error?.code === "BlobNotFound";
-var AzureBlobStorageDriver = class {
-  constructor(options) {
-    this.options = options;
-  }
-  options;
-  name = "azure";
-  containerPromise;
-  async put(path, content, options) {
-    const data = Buffer.isBuffer(content) ? content : Buffer.from(content);
-    await (await this.container()).getBlockBlobClient(path).uploadData(data, options?.contentType !== void 0 ? { blobHTTPHeaders: { blobContentType: options.contentType } } : {});
-  }
-  async get(path) {
-    try {
-      return await (await this.container()).getBlockBlobClient(path).downloadToBuffer();
-    } catch (error) {
-      if (isNotFound(error)) throw new StorageFileNotFoundError(path);
-      throw error;
-    }
-  }
-  async exists(path) {
-    return (await this.container()).getBlockBlobClient(path).exists();
-  }
-  async delete(path) {
-    const result = await (await this.container()).getBlockBlobClient(path).deleteIfExists();
-    return result.succeeded;
-  }
-  async list(prefix) {
-    const names = [];
-    for await (const blob of (await this.container()).listBlobsFlat({ prefix })) names.push(blob.name);
-    return names;
-  }
-  async temporaryUrl(path, expiresInMs) {
-    return (await this.container()).getBlockBlobClient(path).generateSasUrl({ permissions: "r", expiresOn: new Date(Date.now() + expiresInMs) });
-  }
-  async disconnect() {
-  }
-  container() {
-    if (!this.containerPromise) {
-      this.containerPromise = this.options.client ? Promise.resolve(this.options.client) : (async () => {
-        if (!this.options.connectionString) throw new Error("connectionString is required for the Azure driver.");
-        const specifier = "@azure/storage-blob";
-        const mod = await import(specifier);
-        return mod.BlobServiceClient.fromConnectionString(this.options.connectionString).getContainerClient(this.options.container);
-      })();
-    }
-    return this.containerPromise;
-  }
-};
-export {
-  AzureBlobStorageDriver
-};
+import { StorageFileNotFoundError } from '@basaltkit/storage';
+const isNotFound = (error) => error?.statusCode === 404 ||
+    error?.code === 'BlobNotFound';
+/**
+ * Azure Blob Storage driver for `@basaltkit/storage`. Uses `@azure/storage-blob`
+ * (an optional peer dependency) via an injectable container client, so its
+ * logic is unit-tested without touching Azure.
+ */
+export class AzureBlobStorageDriver {
+    options;
+    name = 'azure';
+    containerPromise;
+    constructor(options) {
+        this.options = options;
+    }
+    async put(path, content, options) {
+        const data = Buffer.isBuffer(content) ? content : Buffer.from(content);
+        await (await this.container())
+            .getBlockBlobClient(path)
+            .uploadData(data, options?.contentType !== undefined ? { blobHTTPHeaders: { blobContentType: options.contentType } } : {});
+    }
+    async get(path) {
+        try {
+            return await (await this.container()).getBlockBlobClient(path).downloadToBuffer();
+        }
+        catch (error) {
+            if (isNotFound(error))
+                throw new StorageFileNotFoundError(path);
+            throw error;
+        }
+    }
+    async exists(path) {
+        return (await this.container()).getBlockBlobClient(path).exists();
+    }
+    async delete(path) {
+        const result = await (await this.container()).getBlockBlobClient(path).deleteIfExists();
+        return result.succeeded;
+    }
+    async list(prefix) {
+        const names = [];
+        for await (const blob of (await this.container()).listBlobsFlat({ prefix }))
+            names.push(blob.name);
+        return names;
+    }
+    async temporaryUrl(path, expiresInMs) {
+        return (await this.container())
+            .getBlockBlobClient(path)
+            .generateSasUrl({ permissions: 'r', expiresOn: new Date(Date.now() + expiresInMs) });
+    }
+    async disconnect() { }
+    container() {
+        if (!this.containerPromise) {
+            this.containerPromise = this.options.client
+                ? Promise.resolve(this.options.client)
+                : (async () => {
+                    if (!this.options.connectionString)
+                        throw new Error('connectionString is required for the Azure driver.');
+                    const specifier = '@azure/storage-blob';
+                    const mod = (await import(specifier));
+                    return mod.BlobServiceClient.fromConnectionString(this.options.connectionString).getContainerClient(this.options.container);
+                })();
+        }
+        return this.containerPromise;
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@basaltkit/storage-azure",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "Azure Blob Storage driver for @basaltkit/storage — put/get/list/delete/SAS URLs over @azure/storage-blob, with an injectable client for testing.",
   "license": "MIT",
   "type": "module",
@@ -14,16 +14,15 @@
     "dist"
   ],
   "dependencies": {
-    "@basaltkit/storage": "^1.0.0"
+    "@basaltkit/storage": "^1.2.1"
   },
   "peerDependencies": {
     "@azure/storage-blob": "^12.0.0"
   },
   "devDependencies": {
-    "@types/node": "^22.15.0",
-    "tsup": "^8.4.0",
-    "typescript": "^5.8.0",
-    "vitest": "^3.1.0",
+    "@types/node": "^26.3.0",
+    "typescript": "^7.0.2",
+    "vitest": "^4.1.11",
     "@basaltkit/tsconfig": "^0.24.0"
   },
   "publishConfig": {
@@ -31,11 +30,11 @@
   },
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/Zebedeu/basalt.git",
+    "url": "git+https://github.com/basaltkit/basalt.git",
     "directory": "packages/storage-azure"
   },
-  "homepage": "https://github.com/Zebedeu/basalt/tree/main/packages/storage-azure#readme",
-  "bugs": "https://github.com/Zebedeu/basalt/issues",
+  "homepage": "https://github.com/basaltkit/basalt/tree/main/packages/storage-azure#readme",
+  "bugs": "https://github.com/basaltkit/basalt/issues",
   "keywords": [
     "basalt",
     "typescript",
@@ -44,7 +43,7 @@
     "blob"
   ],
   "scripts": {
-    "build": "tsup src/index.ts --format esm --dts --clean",
+    "build": "tsc -p tsconfig.build.json",
     "test": "vitest run",
     "typecheck": "tsc --noEmit"
   }