@azure/storage-file-datalake 12.30.0 → 12.31.0

package/README.md

@@ -423,6 +423,7 @@ for await (const path of paths) {
 ```ts snippet:ReadmeSampleDownloadFile_Node
 import { DataLakeServiceClient } from "@azure/storage-file-datalake";
 import { DefaultAzureCredential } from "@azure/identity";
+import { buffer } from "node:stream/consumers";
 
 const account = "<account>";
 const datalakeServiceClient = new DataLakeServiceClient(
@@ -439,23 +440,11 @@ const fileClient = fileSystemClient.getFileClient(fileName);
 // In Node.js, get downloaded data by accessing downloadResponse.readableStreamBody
 const downloadResponse = await fileClient.read();
 if (downloadResponse.readableStreamBody) {
-  const downloaded = await streamToBuffer(downloadResponse.readableStreamBody);
+  // Download the raw bytes of the file. Use `text` from "node:stream/consumers"
+  // instead if you want to read the content as a string directly.
+  const downloaded = await buffer(downloadResponse.readableStreamBody);
   console.log("Downloaded file content:", downloaded.toString());
 }
-
-// [Node.js only] A helper method used to read a Node.js readable stream into a Buffer.
-async function streamToBuffer(readableStream: NodeJS.ReadableStream): Promise<Buffer> {
-  return new Promise((resolve, reject) => {
-    const chunks: Buffer[] = [];
-    readableStream.on("data", (data) => {
-      chunks.push(data instanceof Buffer ? data : Buffer.from(data));
-    });
-    readableStream.on("end", () => {
-      resolve(Buffer.concat(chunks));
-    });
-    readableStream.on("error", reject);
-  });
-}
 ```
 
 ### Download a file and convert it to a string (Browsers)

package/dist/browser/clients.d.ts

@@ -1,12 +1,13 @@
 import type { TokenCredential } from "@azure/core-auth";
 import type { RequestBodyType as HttpRequestBody } from "@azure/core-rest-pipeline";
 import type { Pipeline } from "./Pipeline.js";
+import { Tags } from "@azure/storage-blob";
 import { AnonymousCredential } from "@azure/storage-common";
 import { StorageSharedKeyCredential } from "./credentials/StorageSharedKeyCredential.js";
 import type { Readable } from "node:stream";
 import type { UserDelegationKey } from "@azure/storage-common";
 import { DataLakeLeaseClient } from "./DataLakeLeaseClient.js";
-import type { DataLakeClientConfig, DataLakeFileClientOptions, DataLakePathClientOptions, DirectoryCreateIfNotExistsOptions, DirectoryCreateIfNotExistsResponse, DirectoryCreateOptions, DirectoryCreateResponse, DirectoryGenerateSasUrlOptions, FileAppendOptions, FileAppendResponse, FileCreateIfNotExistsOptions, FileCreateIfNotExistsResponse, FileCreateOptions, FileCreateResponse, FileExpiryMode, FileFlushOptions, FileFlushResponse, FileGenerateSasUrlOptions, FileParallelUploadOptions, FileQueryOptions, FileReadOptions, FileReadResponse, FileReadToBufferOptions, FileSetExpiryOptions, FileSetExpiryResponse, FileUploadResponse, Metadata, PathAccessControlItem, PathChangeAccessControlRecursiveOptions, PathChangeAccessControlRecursiveResponse, PathCreateIfNotExistsOptions, PathCreateIfNotExistsResponse, PathCreateOptions, PathCreateResponse, PathDeleteIfExistsResponse, PathDeleteOptions, PathDeleteResponse, PathExistsOptions, PathGetAccessControlOptions, PathGetAccessControlResponse, PathGetPropertiesOptions, PathGetPropertiesResponse, PathHttpHeaders, PathMoveOptions, PathMoveResponse, PathPermissions, PathResourceTypeModel, PathSetAccessControlOptions, PathSetAccessControlResponse, PathSetHttpHeadersOptions, PathSetHttpHeadersResponse, PathSetMetadataOptions, PathSetMetadataResponse, PathSetPermissionsOptions, PathSetPermissionsResponse, RemovePathAccessControlItem } from "./models.js";
+import type { DataLakeClientConfig, DataLakeFileClientOptions, DataLakePathClientOptions, DirectoryCreateIfNotExistsOptions, DirectoryCreateIfNotExistsResponse, DirectoryCreateOptions, DirectoryCreateResponse, DirectoryGenerateSasUrlOptions, FileAppendOptions, FileAppendResponse, FileCreateIfNotExistsOptions, FileCreateIfNotExistsResponse, FileCreateOptions, FileCreateResponse, FileExpiryMode, FileFlushOptions, FileFlushResponse, FileGenerateSasUrlOptions, FileParallelUploadOptions, FileQueryOptions, FileReadOptions, FileReadResponse, FileReadToBufferOptions, FileSetExpiryOptions, FileSetExpiryResponse, FileUploadResponse, Metadata, PathAccessControlItem, PathChangeAccessControlRecursiveOptions, PathChangeAccessControlRecursiveResponse, PathCreateIfNotExistsOptions, PathCreateIfNotExistsResponse, PathCreateOptions, PathCreateResponse, PathDeleteIfExistsResponse, PathDeleteOptions, PathDeleteResponse, PathExistsOptions, PathGetAccessControlOptions, PathGetAccessControlResponse, PathGetPropertiesOptions, PathGetPropertiesResponse, PathGetSystemPropertiesOptions, PathGetSystemPropertiesResponse, PathGetTagsOptions, PathGetTagsResponse, PathHttpHeaders, PathMoveOptions, PathMoveResponse, PathPermissions, PathResourceTypeModel, PathSetAccessControlOptions, PathSetAccessControlResponse, PathSetHttpHeadersOptions, PathSetHttpHeadersResponse, PathSetMetadataOptions, PathSetMetadataResponse, PathSetPermissionsOptions, PathSetPermissionsResponse, PathSetTagsOptions, PathSetTagsResponse, RemovePathAccessControlItem } from "./models.js";
 import { StorageClient } from "./StorageClient.js";
 /**
  * A DataLakePathClient represents a URL to the Azure Storage path (directory or file).
@@ -178,6 +179,15 @@ export declare class DataLakePathClient extends StorageClient {
      * @param options - Optional. Options when setting path permissions.
      */
     setPermissions(permissions: PathPermissions, options?: PathSetPermissionsOptions): Promise<PathSetPermissionsResponse>;
+    /**
+     * Returns all standard HTTP properties, and system properties
+     * for the path (directory or file).
+     *
+     * @see https://learn.microsoft.com/en-us/rest/api/storageservices/datalakestoragegen2/path/get-properties?view=rest-storageservices-datalakestoragegen2-2019-12-12
+     *
+     * @param options - Optional. Options when getting path properties.
+     */
+    getSystemProperties(options?: PathGetSystemPropertiesOptions): Promise<PathGetSystemPropertiesResponse>;
     /**
      * Returns all user-defined metadata, standard HTTP properties, and system properties
      * for the path (directory or file).
@@ -216,6 +226,22 @@ export declare class DataLakePathClient extends StorageClient {
      * @param options - Optional. Options when setting path metadata.
      */
     setMetadata(metadata?: Metadata, options?: PathSetMetadataOptions): Promise<PathSetMetadataResponse>;
+    /**
+     * Gets the tags associated with the underlying path.
+     *
+     * @param options -
+     */
+    getTags(options?: PathGetTagsOptions): Promise<PathGetTagsResponse>;
+    /**
+     * Sets tags on the underlying path.
+     * A path can have up to 10 tags. Tag keys must be between 1 and 128 characters.  Tag values must be between 0 and 256 characters.
+     * Valid tag key and value characters include lower and upper case letters, digits (0-9),
+     * space (' '), plus ('+'), minus ('-'), period ('.'), forward slash ('/'), colon (':'), equals ('='), and underscore ('_').
+     *
+     * @param tags -
+     * @param options -
+     */
+    setTags(tags: Tags, options?: PathSetTagsOptions): Promise<PathSetTagsResponse>;
     /**
      * Move directory or file within same file system.
      *
@@ -416,6 +442,7 @@ export declare class DataLakeFileClient extends DataLakePathClient {
      * ```ts snippet:ReadmeSampleDownloadFile_Node
      * import { DataLakeServiceClient } from "@azure/storage-file-datalake";
      * import { DefaultAzureCredential } from "@azure/identity";
+     * import { buffer } from "node:stream/consumers";
      *
      * const account = "<account>";
      * const datalakeServiceClient = new DataLakeServiceClient(
@@ -432,23 +459,11 @@ export declare class DataLakeFileClient extends DataLakePathClient {
      * // In Node.js, get downloaded data by accessing downloadResponse.readableStreamBody
      * const downloadResponse = await fileClient.read();
      * if (downloadResponse.readableStreamBody) {
-     *   const downloaded = await streamToBuffer(downloadResponse.readableStreamBody);
+     *   // Download the raw bytes of the file. Use `text` from "node:stream/consumers"
+     *   // instead if you want to read the content as a string directly.
+     *   const downloaded = await buffer(downloadResponse.readableStreamBody);
      *   console.log("Downloaded file content:", downloaded.toString());
      * }
-     *
-     * // [Node.js only] A helper method used to read a Node.js readable stream into a Buffer.
-     * async function streamToBuffer(readableStream: NodeJS.ReadableStream): Promise<Buffer> {
-     *   return new Promise((resolve, reject) => {
-     *     const chunks: Buffer[] = [];
-     *     readableStream.on("data", (data) => {
-     *       chunks.push(data instanceof Buffer ? data : Buffer.from(data));
-     *     });
-     *     readableStream.on("end", () => {
-     *       resolve(Buffer.concat(chunks));
-     *     });
-     *     readableStream.on("error", reject);
-     *   });
-     * }
      * ```
      *
      * Example usage (browser):
@@ -595,6 +610,7 @@ export declare class DataLakeFileClient extends DataLakePathClient {
      *
      * ```ts snippet:ReadmeSampleQueryFile_Node
      * import { DataLakeServiceClient } from "@azure/storage-file-datalake";
+     * import { buffer } from "node:stream/consumers";
      *
      * const account = "<account>";
      * const sas = "<sas token>";
@@ -610,22 +626,10 @@ export declare class DataLakeFileClient extends DataLakePathClient {
      * // Query and convert a file to a string
      * const queryResponse = await fileClient.query("select * from BlobStorage");
      * if (queryResponse.readableStreamBody) {
-     *   const responseBuffer = await streamToBuffer(queryResponse.readableStreamBody);
-     *   const downloaded = responseBuffer.toString();
-     *   console.log(`Query file content: ${downloaded}`);
-     * }
-     *
-     * async function streamToBuffer(readableStream: NodeJS.ReadableStream): Promise<Buffer> {
-     *   return new Promise((resolve, reject) => {
-     *     const chunks: Buffer[] = [];
-     *     readableStream.on("data", (data) => {
-     *       chunks.push(data instanceof Buffer ? data : Buffer.from(data));
-     *     });
-     *     readableStream.on("end", () => {
-     *       resolve(Buffer.concat(chunks));
-     *     });
-     *     readableStream.on("error", reject);
-     *   });
+     *   // Read the response bytes. Use `text` from "node:stream/consumers" instead
+     *   // if you want the response as a string directly.
+     *   const responseBuffer = await buffer(queryResponse.readableStreamBody);
+     *   console.log(`Query file content: ${responseBuffer.toString()}`);
      * }
      * ```
      *

package/dist/browser/clients.d.ts.map

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

package/dist/browser/clients.js

@@ -426,6 +426,32 @@ export class DataLakePathClient extends StorageClient {
             }));
         });
     }
+    /**
+     * Returns all standard HTTP properties, and system properties
+     * for the path (directory or file).
+     *
+     * @see https://learn.microsoft.com/en-us/rest/api/storageservices/datalakestoragegen2/path/get-properties?view=rest-storageservices-datalakestoragegen2-2019-12-12
+     *
+     * @param options - Optional. Options when getting path properties.
+     */
+    async getSystemProperties(options = {}) {
+        return tracingClient.withSpan("DataLakePathClient-getSystemProperties", options, async (updatedOptions) => {
+            const response = assertResponse(await this.pathContext.getProperties({
+                ...updatedOptions,
+                action: "getStatus",
+                upn: options.userPrincipalName,
+                leaseAccessConditions: options.conditions,
+                modifiedAccessConditions: options.conditions,
+                abortSignal: options.abortSignal,
+            }));
+            return {
+                ...response,
+                _response: response._response,
+                isDirectory: response.resourceType === "directory",
+                permissions: toPermissions(response.permissions),
+            };
+        });
+    }
     /**
      * Returns all user-defined metadata, standard HTTP properties, and system properties
      * for the path (directory or file).
@@ -492,6 +518,36 @@ export class DataLakePathClient extends StorageClient {
             });
         });
     }
+    /**
+     * Gets the tags associated with the underlying path.
+     *
+     * @param options -
+     */
+    async getTags(options = {}) {
+        return tracingClient.withSpan("DataLakePathClient-getTags", options, async (updatedOptions) => {
+            return this.blobClient.getTags({
+                ...options,
+                tracingOptions: updatedOptions.tracingOptions,
+            });
+        });
+    }
+    /**
+     * Sets tags on the underlying path.
+     * A path can have up to 10 tags. Tag keys must be between 1 and 128 characters.  Tag values must be between 0 and 256 characters.
+     * Valid tag key and value characters include lower and upper case letters, digits (0-9),
+     * space (' '), plus ('+'), minus ('-'), period ('.'), forward slash ('/'), colon (':'), equals ('='), and underscore ('_').
+     *
+     * @param tags -
+     * @param options -
+     */
+    async setTags(tags, options = {}) {
+        return tracingClient.withSpan("DataLakePathClient-setTags", options, async (updatedOptions) => {
+            return this.blobClient.setTags(tags, {
+                ...options,
+                tracingOptions: updatedOptions.tracingOptions,
+            });
+        });
+    }
     async move(destinationPathOrFileSystem, destinationPathOrOptions, options) {
         let destinationFileSystem = this.fileSystemName;
         let destinationPath = destinationPathOrFileSystem;
@@ -755,6 +811,7 @@ export class DataLakeFileClient extends DataLakePathClient {
      * ```ts snippet:ReadmeSampleDownloadFile_Node
      * import { DataLakeServiceClient } from "@azure/storage-file-datalake";
      * import { DefaultAzureCredential } from "@azure/identity";
+     * import { buffer } from "node:stream/consumers";
      *
      * const account = "<account>";
      * const datalakeServiceClient = new DataLakeServiceClient(
@@ -771,23 +828,11 @@ export class DataLakeFileClient extends DataLakePathClient {
      * // In Node.js, get downloaded data by accessing downloadResponse.readableStreamBody
      * const downloadResponse = await fileClient.read();
      * if (downloadResponse.readableStreamBody) {
-     *   const downloaded = await streamToBuffer(downloadResponse.readableStreamBody);
+     *   // Download the raw bytes of the file. Use `text` from "node:stream/consumers"
+     *   // instead if you want to read the content as a string directly.
+     *   const downloaded = await buffer(downloadResponse.readableStreamBody);
      *   console.log("Downloaded file content:", downloaded.toString());
      * }
-     *
-     * // [Node.js only] A helper method used to read a Node.js readable stream into a Buffer.
-     * async function streamToBuffer(readableStream: NodeJS.ReadableStream): Promise<Buffer> {
-     *   return new Promise((resolve, reject) => {
-     *     const chunks: Buffer[] = [];
-     *     readableStream.on("data", (data) => {
-     *       chunks.push(data instanceof Buffer ? data : Buffer.from(data));
-     *     });
-     *     readableStream.on("end", () => {
-     *       resolve(Buffer.concat(chunks));
-     *     });
-     *     readableStream.on("error", reject);
-     *   });
-     * }
      * ```
      *
      * Example usage (browser):
@@ -1202,6 +1247,7 @@ export class DataLakeFileClient extends DataLakePathClient {
      *
      * ```ts snippet:ReadmeSampleQueryFile_Node
      * import { DataLakeServiceClient } from "@azure/storage-file-datalake";
+     * import { buffer } from "node:stream/consumers";
      *
      * const account = "<account>";
      * const sas = "<sas token>";
@@ -1217,22 +1263,10 @@ export class DataLakeFileClient extends DataLakePathClient {
      * // Query and convert a file to a string
      * const queryResponse = await fileClient.query("select * from BlobStorage");
      * if (queryResponse.readableStreamBody) {
-     *   const responseBuffer = await streamToBuffer(queryResponse.readableStreamBody);
-     *   const downloaded = responseBuffer.toString();
-     *   console.log(`Query file content: ${downloaded}`);
-     * }
-     *
-     * async function streamToBuffer(readableStream: NodeJS.ReadableStream): Promise<Buffer> {
-     *   return new Promise((resolve, reject) => {
-     *     const chunks: Buffer[] = [];
-     *     readableStream.on("data", (data) => {
-     *       chunks.push(data instanceof Buffer ? data : Buffer.from(data));
-     *     });
-     *     readableStream.on("end", () => {
-     *       resolve(Buffer.concat(chunks));
-     *     });
-     *     readableStream.on("error", reject);
-     *   });
+     *   // Read the response bytes. Use `text` from "node:stream/consumers" instead
+     *   // if you want the response as a string directly.
+     *   const responseBuffer = await buffer(queryResponse.readableStreamBody);
+     *   console.log(`Query file content: ${responseBuffer.toString()}`);
      * }
      * ```
      *