@mastra/azure 0.0.0

package/CHANGELOG.md

@@ -0,0 +1,12 @@
+# @mastra/azure
+
+## 0.2.0-alpha.0
+
+### Minor Changes
+
+- Add `@mastra/azure`, exporting an Azure Blob Storage `WorkspaceFilesystem` provider via `@mastra/azure/blob` with support for connection string, account key, SAS token, `DefaultAzureCredential`, and anonymous auth, plus prefix namespacing and read-only mode. ([#15217](https://github.com/mastra-ai/mastra/pull/15217))
+
+### Patch Changes
+
+- Updated dependencies [[`c04417b`](https://github.com/mastra-ai/mastra/commit/c04417ba0a2e4ded66da4352331ef29cd4bd1d79), [`cf25a03`](https://github.com/mastra-ai/mastra/commit/cf25a03132164b9dc1e5dccf7394824e33007c51), [`ba6b0c5`](https://github.com/mastra-ai/mastra/commit/ba6b0c51bfce358554fd33c7f2bcd5593633f2ff)]:
+  - @mastra/core@1.29.0-alpha.3

package/dist/blob/filesystem/index.d.ts

@@ -0,0 +1,119 @@
+/**
+ * Azure Blob Storage Filesystem Provider
+ *
+ * A filesystem implementation backed by Azure Blob Storage.
+ */
+import type { ContainerClient } from '@azure/storage-blob';
+import type { FileContent, FileStat, FileEntry, ReadOptions, WriteOptions, ListOptions, RemoveOptions, CopyOptions, FilesystemInfo, FilesystemMountConfig, FilesystemIcon, ProviderStatus, MastraFilesystemOptions } from '@mastra/core/workspace';
+import { MastraFilesystem } from '@mastra/core/workspace';
+/**
+ * Azure Blob mount configuration.
+ * Returned by AzureBlobFilesystem.getMountConfig() for FUSE mounting in sandboxes.
+ */
+export interface AzureBlobMountConfig extends FilesystemMountConfig {
+    type: 'azure-blob';
+    container: string;
+    accountName?: string;
+    accountKey?: string;
+    sasToken?: string;
+    connectionString?: string;
+    useDefaultCredential?: boolean;
+    endpoint?: string;
+    readOnly?: boolean;
+}
+export interface AzureBlobFilesystemOptions extends MastraFilesystemOptions {
+    /** Unique identifier for this filesystem instance */
+    id?: string;
+    /** Azure Blob container name */
+    container: string;
+    /** Human-friendly display name for the UI */
+    displayName?: string;
+    /** Icon identifier for the UI (defaults to 'azure-blob') */
+    icon?: FilesystemIcon;
+    /** Description shown in tooltips */
+    description?: string;
+    /** Storage account name (required unless using connectionString) */
+    accountName?: string;
+    /** Storage account key */
+    accountKey?: string;
+    /** SAS token for authentication */
+    sasToken?: string;
+    /** Full connection string (takes priority over accountName/accountKey) */
+    connectionString?: string;
+    /**
+     * Use DefaultAzureCredential from @azure/identity for authentication.
+     * Supports Managed Identity, Azure CLI, environment variables, etc.
+     * Requires @azure/identity to be installed as a peer dependency.
+     */
+    useDefaultCredential?: boolean;
+    /** Optional prefix for all keys (acts like a subdirectory) */
+    prefix?: string;
+    /** Mount as read-only (blocks write operations, mounts read-only in sandboxes) */
+    readOnly?: boolean;
+    /**
+     * Custom endpoint URL.
+     * Used for local development with Azurite emulator.
+     */
+    endpoint?: string;
+}
+export declare class AzureBlobFilesystem extends MastraFilesystem {
+    readonly id: string;
+    readonly name = "AzureBlobFilesystem";
+    readonly provider = "azure-blob";
+    readonly readOnly?: boolean;
+    status: ProviderStatus;
+    readonly displayName?: string;
+    readonly icon: FilesystemIcon;
+    readonly description?: string;
+    private readonly containerName;
+    private readonly accountName?;
+    private readonly accountKey?;
+    private readonly sasToken?;
+    private readonly connectionString?;
+    private readonly useDefaultCredential;
+    private readonly prefix;
+    private readonly endpoint?;
+    private _containerClient;
+    constructor(options: AzureBlobFilesystemOptions);
+    /**
+     * Get the underlying ContainerClient for direct access to Azure Blob APIs.
+     *
+     * Use this when you need features not exposed through the WorkspaceFilesystem
+     * interface (e.g., SAS URL generation, lease management, etc.).
+     *
+     * This is async because DefaultAzureCredential requires a dynamic import.
+     * For non-DefaultAzureCredential auth methods, the promise resolves immediately.
+     */
+    getContainer(): Promise<ContainerClient>;
+    getMountConfig(): AzureBlobMountConfig;
+    getInfo(): FilesystemInfo<{
+        container: string;
+        endpoint?: string;
+        prefix?: string;
+    }>;
+    getInstructions(): string;
+    private getContainerClient;
+    private getReadyContainer;
+    private toKey;
+    private handleError;
+    private assertWritable;
+    readFile(path: string, options?: ReadOptions): Promise<string | Buffer>;
+    writeFile(path: string, content: FileContent, options?: WriteOptions): Promise<void>;
+    appendFile(path: string, content: FileContent): Promise<void>;
+    deleteFile(path: string, options?: RemoveOptions): Promise<void>;
+    copyFile(src: string, dest: string, options?: CopyOptions): Promise<void>;
+    moveFile(src: string, dest: string, options?: CopyOptions): Promise<void>;
+    mkdir(_path: string, _options?: {
+        recursive?: boolean;
+    }): Promise<void>;
+    rmdir(path: string, options?: RemoveOptions): Promise<void>;
+    private deleteBlobBatch;
+    readdir(path: string, options?: ListOptions): Promise<FileEntry[]>;
+    exists(path: string): Promise<boolean>;
+    stat(path: string): Promise<FileStat>;
+    isFile(path: string): Promise<boolean>;
+    isDirectory(path: string): Promise<boolean>;
+    init(): Promise<void>;
+    destroy(): Promise<void>;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/blob/filesystem/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/blob/filesystem/index.ts"],"names":[],"mappings":"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"}

package/dist/blob/index.cjs

@@ -0,0 +1,16 @@
+'use strict';
+
+var chunkLLH5EI3J_cjs = require('../chunk-LLH5EI3J.cjs');
+
+
+
+Object.defineProperty(exports, "AzureBlobFilesystem", {
+  enumerable: true,
+  get: function () { return chunkLLH5EI3J_cjs.AzureBlobFilesystem; }
+});
+Object.defineProperty(exports, "azureBlobFilesystemProvider", {
+  enumerable: true,
+  get: function () { return chunkLLH5EI3J_cjs.azureBlobFilesystemProvider; }
+});
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/blob/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.cjs"}

package/dist/blob/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @mastra/azure/blob - Azure Blob Storage Filesystem Provider
+ *
+ * A filesystem implementation backed by Azure Blob Storage.
+ */
+export { AzureBlobFilesystem, type AzureBlobFilesystemOptions, type AzureBlobMountConfig } from './filesystem/index.js';
+export { azureBlobFilesystemProvider } from './provider.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/blob/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/blob/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,mBAAmB,EAAE,KAAK,0BAA0B,EAAE,KAAK,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAC/G,OAAO,EAAE,2BAA2B,EAAE,MAAM,YAAY,CAAC"}

package/dist/blob/index.js

@@ -0,0 +1,3 @@
+export { AzureBlobFilesystem, azureBlobFilesystemProvider } from '../chunk-VFZDLQDB.js';
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/blob/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.js"}

package/dist/blob/provider.d.ts

@@ -0,0 +1,4 @@
+import type { FilesystemProvider } from '@mastra/core/editor';
+import type { AzureBlobFilesystemOptions } from './filesystem/index.js';
+export declare const azureBlobFilesystemProvider: FilesystemProvider<AzureBlobFilesystemOptions>;
+//# sourceMappingURL=provider.d.ts.map

package/dist/blob/provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../../src/blob/provider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAE9D,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,cAAc,CAAC;AAE/D,eAAO,MAAM,2BAA2B,EAAE,kBAAkB,CAAC,0BAA0B,CAwBtF,CAAC"}