@azure/storage-file-share 12.9.1-alpha.20220330.1 → 12.10.0-alpha.20220419.3

package/CHANGELOG.md

@@ -1,14 +1,17 @@
 # Release History
 
-## 12.9.1 (Unreleased)
+## 12.10.0-beta.1 (2022-04-19)
 
 ### Features Added
 
-### Breaking Changes
+- Added support for service version 2021-06-08.
+- Added ability to maintain a file's current last write time when calling ShareFileClient.uploadRange() and ShareFileClient.uploadRangeFromURL().
+- Added ability to specify a file or directory's change time when calling ShareFileClient.create(), ShareDirectoryClient.create(), ShareFileClient.setProperties(), ShareDirectoryClient.setProperties(), ShareFileClient.resize(), ShareFileClient.rename() and ShareDirectoryClient.rename().
+- Added ability to specify content-type on a file when calling ShareFileClient.rename().
 
 ### Bugs Fixed
 
-### Other Changes
+- Add `react-native` mapping to ESM entry point
 
 ## 12.9.0 (2022-03-11)
 

package/dist/index.js

@@ -334,8 +334,8 @@ function ipRangeToString(ipRange) {
 
 // Copyright (c) Microsoft Corporation.
 // Licensed under the MIT license.
-const SDK_VERSION = "12.9.1";
-const SERVICE_VERSION = "2021-04-10";
+const SDK_VERSION = "12.10.0-beta.1";
+const SERVICE_VERSION = "2021-06-08";
 const FILE_MAX_SIZE_BYTES = 4 * 1024 * 1024 * 1024 * 1024; // 4TB
 const FILE_RANGE_MAX_SIZE_BYTES = 4 * 1024 * 1024; // 4MB
 const DEFAULT_MAX_DOWNLOAD_RETRY_REQUESTS = 5;
@@ -369,6 +369,8 @@ const HeaderConstants = {
     X_MS_COPY_SOURCE: "x-ms-copy-source",
     X_MS_DATE: "x-ms-date",
 };
+const FileAttributesPreserve = "Preserve";
+const FileAttributesNone = "None";
 const StorageFileLoggingAllowedHeaderNames = [
     "Access-Control-Allow-Origin",
     "Cache-Control",
@@ -5861,6 +5863,13 @@ const FileUploadRangeHeaders = {
                     name: "Boolean"
                 }
             },
+            fileLastWriteTime: {
+                serializedName: "x-ms-file-last-write-time",
+                xmlName: "x-ms-file-last-write-time",
+                type: {
+                    name: "DateTimeRfc1123"
+                }
+            },
             errorCode: {
                 serializedName: "x-ms-error-code",
                 xmlName: "x-ms-error-code",
@@ -5942,6 +5951,13 @@ const FileUploadRangeFromURLHeaders = {
                     name: "Boolean"
                 }
             },
+            fileLastWriteTime: {
+                serializedName: "x-ms-file-last-write-time",
+                xmlName: "x-ms-file-last-write-time",
+                type: {
+                    name: "DateTimeRfc1123"
+                }
+            },
             errorCode: {
                 serializedName: "x-ms-error-code",
                 xmlName: "x-ms-error-code",
@@ -6634,7 +6650,7 @@ const timeoutInSeconds = {
 const version = {
     parameterPath: "version",
     mapper: {
-        defaultValue: "2021-04-10",
+        defaultValue: "2021-06-08",
         isConstant: true,
         serializedName: "x-ms-version",
         type: {
@@ -7104,10 +7120,9 @@ const fileAttributes = {
     }
 };
 const fileCreatedOn = {
-    parameterPath: "fileCreatedOn",
+    parameterPath: ["options", "fileCreatedOn"],
     mapper: {
         serializedName: "x-ms-file-creation-time",
-        required: true,
         xmlName: "x-ms-file-creation-time",
         type: {
             name: "String"
@@ -7115,16 +7130,25 @@ const fileCreatedOn = {
     }
 };
 const fileLastWriteOn = {
-    parameterPath: "fileLastWriteOn",
+    parameterPath: ["options", "fileLastWriteOn"],
     mapper: {
         serializedName: "x-ms-file-last-write-time",
-        required: true,
         xmlName: "x-ms-file-last-write-time",
         type: {
             name: "String"
         }
     }
 };
+const fileChangeOn = {
+    parameterPath: ["options", "fileChangeOn"],
+    mapper: {
+        serializedName: "x-ms-file-change-time",
+        xmlName: "x-ms-file-change-time",
+        type: {
+            name: "String"
+        }
+    }
+};
 const include1 = {
     parameterPath: ["options", "include"],
     mapper: {
@@ -7292,6 +7316,16 @@ const fileLastWriteTime = {
         }
     }
 };
+const fileChangeTime = {
+    parameterPath: ["options", "copyFileSmbInfo", "fileChangeTime"],
+    mapper: {
+        serializedName: "x-ms-file-change-time",
+        xmlName: "x-ms-file-change-time",
+        type: {
+            name: "String"
+        }
+    }
+};
 const fileContentLength = {
     parameterPath: "fileContentLength",
     mapper: {
@@ -7492,6 +7526,17 @@ const contentMD5 = {
         }
     }
 };
+const fileLastWrittenMode = {
+    parameterPath: ["options", "fileLastWrittenMode"],
+    mapper: {
+        serializedName: "x-ms-file-last-write-time",
+        xmlName: "x-ms-file-last-write-time",
+        type: {
+            name: "Enum",
+            allowedValues: ["Now", "Preserve"]
+        }
+    }
+};
 const copySource = {
     parameterPath: "copySource",
     mapper: {
@@ -8506,15 +8551,11 @@ class Directory {
      * Creates a new directory under the specified share or parent directory.
      * @param fileAttributes If specified, the provided file attributes shall be set. Default value:
      *                       ‘Archive’ for file and ‘Directory’ for directory. ‘None’ can also be specified as default.
-     * @param fileCreatedOn Creation time for the file/directory. Default value: Now.
-     * @param fileLastWriteOn Last write time for the file/directory. Default value: Now.
      * @param options The options parameters.
      */
-    create(fileAttributes, fileCreatedOn, fileLastWriteOn, options) {
+    create(fileAttributes, options) {
         const operationArguments = {
             fileAttributes,
-            fileCreatedOn,
-            fileLastWriteOn,
             options: coreHttp__namespace.operationOptionsToRequestOptionsBase(options || {})
         };
         return this.client.sendOperationRequest(operationArguments, createOperationSpec$1);
@@ -8546,15 +8587,11 @@ class Directory {
      * Sets properties on the directory.
      * @param fileAttributes If specified, the provided file attributes shall be set. Default value:
      *                       ‘Archive’ for file and ‘Directory’ for directory. ‘None’ can also be specified as default.
-     * @param fileCreatedOn Creation time for the file/directory. Default value: Now.
-     * @param fileLastWriteOn Last write time for the file/directory. Default value: Now.
      * @param options The options parameters.
      */
-    setProperties(fileAttributes, fileCreatedOn, fileLastWriteOn, options) {
+    setProperties(fileAttributes, options) {
         const operationArguments = {
             fileAttributes,
-            fileCreatedOn,
-            fileLastWriteOn,
             options: coreHttp__namespace.operationOptionsToRequestOptionsBase(options || {})
         };
         return this.client.sendOperationRequest(operationArguments, setPropertiesOperationSpec);
@@ -8640,7 +8677,8 @@ const createOperationSpec$1 = {
         filePermissionKey1,
         fileAttributes,
         fileCreatedOn,
-        fileLastWriteOn
+        fileLastWriteOn,
+        fileChangeOn
     ],
     isXML: true,
     serializer: xmlSerializer$1
@@ -8710,7 +8748,8 @@ const setPropertiesOperationSpec = {
         filePermissionKey1,
         fileAttributes,
         fileCreatedOn,
-        fileLastWriteOn
+        fileLastWriteOn,
+        fileChangeOn
     ],
     isXML: true,
     serializer: xmlSerializer$1
@@ -8861,7 +8900,8 @@ const renameOperationSpec$1 = {
         destinationLeaseId,
         fileAttributes1,
         fileCreationTime,
-        fileLastWriteTime
+        fileLastWriteTime,
+        fileChangeTime
     ],
     isXML: true,
     serializer: xmlSerializer$1
@@ -8888,16 +8928,12 @@ class File {
      * @param fileContentLength Specifies the maximum size for the file, up to 4 TB.
      * @param fileAttributes If specified, the provided file attributes shall be set. Default value:
      *                       ‘Archive’ for file and ‘Directory’ for directory. ‘None’ can also be specified as default.
-     * @param fileCreatedOn Creation time for the file/directory. Default value: Now.
-     * @param fileLastWriteOn Last write time for the file/directory. Default value: Now.
      * @param options The options parameters.
      */
-    create(fileContentLength, fileAttributes, fileCreatedOn, fileLastWriteOn, options) {
+    create(fileContentLength, fileAttributes, options) {
         const operationArguments = {
             fileContentLength,
             fileAttributes,
-            fileCreatedOn,
-            fileLastWriteOn,
             options: coreHttp__namespace.operationOptionsToRequestOptionsBase(options || {})
         };
         return this.client.sendOperationRequest(operationArguments, createOperationSpec);
@@ -8937,15 +8973,11 @@ class File {
      * Sets HTTP headers on the file.
      * @param fileAttributes If specified, the provided file attributes shall be set. Default value:
      *                       ‘Archive’ for file and ‘Directory’ for directory. ‘None’ can also be specified as default.
-     * @param fileCreatedOn Creation time for the file/directory. Default value: Now.
-     * @param fileLastWriteOn Last write time for the file/directory. Default value: Now.
      * @param options The options parameters.
      */
-    setHttpHeaders(fileAttributes, fileCreatedOn, fileLastWriteOn, options) {
+    setHttpHeaders(fileAttributes, options) {
         const operationArguments = {
             fileAttributes,
-            fileCreatedOn,
-            fileLastWriteOn,
             options: coreHttp__namespace.operationOptionsToRequestOptionsBase(options || {})
         };
         return this.client.sendOperationRequest(operationArguments, setHttpHeadersOperationSpec);
@@ -9158,6 +9190,7 @@ const createOperationSpec = {
         fileAttributes,
         fileCreatedOn,
         fileLastWriteOn,
+        fileChangeOn,
         fileContentLength,
         fileTypeConstant,
         fileContentType,
@@ -9272,6 +9305,7 @@ const setHttpHeadersOperationSpec = {
         fileAttributes,
         fileCreatedOn,
         fileLastWriteOn,
+        fileChangeOn,
         fileContentType,
         fileContentEncoding,
         fileContentLanguage,
@@ -9427,7 +9461,8 @@ const uploadRangeOperationSpec = {
         range1,
         fileRangeWrite,
         contentLength,
-        contentMD5
+        contentMD5,
+        fileLastWrittenMode
     ],
     contentType: "application/octet-stream",
     isXML: true,
@@ -9453,6 +9488,7 @@ const uploadRangeFromURLOperationSpec = {
         leaseId,
         range1,
         contentLength,
+        fileLastWrittenMode,
         copySource,
         sourceRange,
         fileRangeWriteFromUrl,
@@ -9517,6 +9553,7 @@ const startCopyOperationSpec = {
         fileAttributes1,
         fileCreationTime,
         fileLastWriteTime,
+        fileChangeTime,
         copySource,
         filePermissionCopyMode,
         ignoreReadOnly1,
@@ -9631,7 +9668,9 @@ const renameOperationSpec = {
         destinationLeaseId,
         fileAttributes1,
         fileCreationTime,
-        fileLastWriteTime
+        fileLastWriteTime,
+        fileChangeTime,
+        fileContentType
     ],
     isXML: true,
     serializer: xmlSerializer
@@ -10351,7 +10390,7 @@ function convertTracingToRequestOptionsBase(options) {
  * Changes may cause incorrect behavior and will be lost if the code is regenerated.
  */
 const packageName = "azure-storage-file-share";
-const packageVersion = "12.9.1";
+const packageVersion = "12.10.0-beta.1";
 class StorageClientContext extends coreHttp__namespace.ServiceClient {
     /**
      * Initializes a new instance of the StorageClientContext class.
@@ -10377,7 +10416,7 @@ class StorageClientContext extends coreHttp__namespace.ServiceClient {
         // Parameter assignments
         this.url = url;
         // Assigning values to Constant parameters
-        this.version = options.version || "2021-04-10";
+        this.version = options.version || "2021-06-08";
         this.fileRangeWriteFromUrl = options.fileRangeWriteFromUrl || "update";
     }
 }
@@ -11141,6 +11180,9 @@ function fileCreationTimeToString(time) {
 function fileLastWriteTimeToString(time) {
     return time instanceof Date ? truncatedISO8061Date(time) : time;
 }
+function fileChangeTimeToString(time) {
+    return time instanceof Date ? truncatedISO8061Date(time) : time;
+}
 
 // Copyright (c) Microsoft Corporation.
 /**
@@ -12342,7 +12384,9 @@ class ShareDirectoryClient extends StorageClient {
                 attributes.directory = true;
                 options.fileAttributes = attributes;
             }
-            return await this.context.create(fileAttributesToString(options.fileAttributes), fileCreationTimeToString(options.creationTime), fileLastWriteTimeToString(options.lastWriteTime), Object.assign({ abortSignal: options.abortSignal, metadata: options.metadata, filePermission: options.filePermission, filePermissionKey: options.filePermissionKey }, convertTracingToRequestOptionsBase(updatedOptions)));
+            return await this.context.create(options.fileAttributes
+                ? fileAttributesToString(options.fileAttributes)
+                : FileAttributesNone, Object.assign({ abortSignal: options.abortSignal, metadata: options.metadata, filePermission: options.filePermission, filePermissionKey: options.filePermissionKey, fileChangeOn: fileChangeTimeToString(options.changeTime), fileCreatedOn: fileCreationTimeToString(options.creationTime), fileLastWriteOn: fileLastWriteTimeToString(options.lastWriteTime) }, convertTracingToRequestOptionsBase(updatedOptions)));
         }
         catch (e) {
             span.setStatus({
@@ -12398,7 +12442,9 @@ class ShareDirectoryClient extends StorageClient {
         const { span, updatedOptions } = createSpan("ShareDirectoryClient-setProperties", properties);
         try {
             properties = validateAndSetDefaultsForFileAndDirectorySetPropertiesCommonOptions(properties);
-            return await this.context.setProperties(fileAttributesToString(properties.fileAttributes), fileCreationTimeToString(properties.creationTime), fileLastWriteTimeToString(properties.lastWriteTime), Object.assign({ abortSignal: properties.abortSignal, filePermission: properties.filePermission, filePermissionKey: properties.filePermissionKey }, convertTracingToRequestOptionsBase(updatedOptions)));
+            return await this.context.setProperties(properties.fileAttributes
+                ? fileAttributesToString(properties.fileAttributes)
+                : FileAttributesPreserve, Object.assign({ abortSignal: properties.abortSignal, filePermission: properties.filePermission, filePermissionKey: properties.filePermissionKey, fileChangeOn: fileChangeTimeToString(updatedOptions.changeTime), fileCreatedOn: fileCreationTimeToString(properties.creationTime), fileLastWriteOn: fileLastWriteTimeToString(properties.lastWriteTime) }, convertTracingToRequestOptionsBase(updatedOptions)));
         }
         catch (e) {
             span.setStatus({
@@ -13362,14 +13408,10 @@ class ShareFileClient extends StorageClient {
                 throw new RangeError(`File size must >= 0 and < ${FILE_MAX_SIZE_BYTES}.`);
             }
             options = validateAndSetDefaultsForFileAndDirectoryCreateCommonOptions(options);
-            if (!options.fileAttributes) {
-                // Note: It would be Archive in service side if None is set.
-                const attributes = new FileSystemAttributes();
-                attributes.none = true;
-                options.fileAttributes = attributes;
-            }
             options.fileHttpHeaders = options.fileHttpHeaders || {};
-            return await this.context.create(size, fileAttributesToString(options.fileAttributes), fileCreationTimeToString(options.creationTime), fileLastWriteTimeToString(options.lastWriteTime), Object.assign({ abortSignal: options.abortSignal, fileHttpHeaders: options.fileHttpHeaders, metadata: options.metadata, filePermission: options.filePermission, filePermissionKey: options.filePermissionKey, leaseAccessConditions: options.leaseAccessConditions }, convertTracingToRequestOptionsBase(updatedOptions)));
+            return await this.context.create(size, options.fileAttributes
+                ? fileAttributesToString(options.fileAttributes)
+                : FileAttributesNone, Object.assign({ abortSignal: options.abortSignal, fileHttpHeaders: options.fileHttpHeaders, metadata: options.metadata, filePermission: options.filePermission, filePermissionKey: options.filePermissionKey, fileChangeOn: fileChangeTimeToString(options.changeTime), fileCreatedOn: fileCreationTimeToString(options.creationTime), fileLastWriteOn: fileLastWriteTimeToString(options.lastWriteTime), leaseAccessConditions: options.leaseAccessConditions }, convertTracingToRequestOptionsBase(updatedOptions)));
         }
         catch (e) {
             span.setStatus({
@@ -13578,7 +13620,9 @@ class ShareFileClient extends StorageClient {
         try {
             properties = validateAndSetDefaultsForFileAndDirectorySetPropertiesCommonOptions(properties);
             properties.fileHttpHeaders = properties.fileHttpHeaders || {};
-            return await this.context.setHttpHeaders(fileAttributesToString(properties.fileAttributes), fileCreationTimeToString(properties.creationTime), fileLastWriteTimeToString(properties.lastWriteTime), Object.assign({ abortSignal: properties.abortSignal, fileHttpHeaders: properties.fileHttpHeaders, filePermission: properties.filePermission, filePermissionKey: properties.filePermissionKey, leaseAccessConditions: properties.leaseAccessConditions }, convertTracingToRequestOptionsBase(updatedOptions)));
+            return await this.context.setHttpHeaders(properties.fileAttributes
+                ? fileAttributesToString(properties.fileAttributes)
+                : FileAttributesPreserve, Object.assign({ abortSignal: properties.abortSignal, fileHttpHeaders: properties.fileHttpHeaders, filePermission: properties.filePermission, filePermissionKey: properties.filePermissionKey, leaseAccessConditions: properties.leaseAccessConditions, fileChangeOn: fileChangeTimeToString(properties.changeTime), fileCreatedOn: fileCreationTimeToString(properties.creationTime), fileLastWriteOn: fileLastWriteTimeToString(properties.lastWriteTime) }, convertTracingToRequestOptionsBase(updatedOptions)));
         }
         catch (e) {
             span.setStatus({
@@ -13683,7 +13727,9 @@ class ShareFileClient extends StorageClient {
         try {
             // FileAttributes, filePermission, createTime, lastWriteTime will all be preserved
             options = validateAndSetDefaultsForFileAndDirectorySetPropertiesCommonOptions(options);
-            return await this.context.setHttpHeaders(fileAttributesToString(options.fileAttributes), fileCreationTimeToString(options.creationTime), fileLastWriteTimeToString(options.lastWriteTime), Object.assign({ abortSignal: options.abortSignal, fileHttpHeaders, filePermission: options.filePermission, filePermissionKey: options.filePermissionKey, leaseAccessConditions: options.leaseAccessConditions }, convertTracingToRequestOptionsBase(updatedOptions)));
+            return await this.context.setHttpHeaders(options.fileAttributes
+                ? fileAttributesToString(options.fileAttributes)
+                : FileAttributesPreserve, Object.assign({ abortSignal: options.abortSignal, fileHttpHeaders, filePermission: options.filePermission, filePermissionKey: options.filePermissionKey, leaseAccessConditions: options.leaseAccessConditions, fileCreatedOn: fileCreationTimeToString(options.creationTime), fileLastWriteOn: fileLastWriteTimeToString(options.lastWriteTime), fileChangeOn: fileChangeTimeToString(options.changeTime) }, convertTracingToRequestOptionsBase(updatedOptions)));
         }
         catch (e) {
             span.setStatus({
@@ -13715,7 +13761,7 @@ class ShareFileClient extends StorageClient {
             }
             // FileAttributes, filePermission, createTime, lastWriteTime will all be preserved.
             options = validateAndSetDefaultsForFileAndDirectorySetPropertiesCommonOptions(options);
-            return await this.context.setHttpHeaders(fileAttributesToString(options.fileAttributes), fileCreationTimeToString(options.creationTime), fileLastWriteTimeToString(options.lastWriteTime), Object.assign({ abortSignal: options.abortSignal, fileContentLength: length, filePermission: options.filePermission, filePermissionKey: options.filePermissionKey, leaseAccessConditions: options.leaseAccessConditions }, convertTracingToRequestOptionsBase(updatedOptions)));
+            return await this.context.setHttpHeaders(fileAttributesToString(options.fileAttributes), Object.assign({ abortSignal: options.abortSignal, fileContentLength: length, filePermission: options.filePermission, filePermissionKey: options.filePermissionKey, leaseAccessConditions: options.leaseAccessConditions, fileChangeOn: fileChangeTimeToString(options.changeTime), fileCreatedOn: fileCreationTimeToString(options.creationTime), fileLastWriteOn: fileLastWriteTimeToString(options.lastWriteTime) }, convertTracingToRequestOptionsBase(updatedOptions)));
         }
         catch (e) {
             span.setStatus({
@@ -13796,7 +13842,7 @@ class ShareFileClient extends StorageClient {
             }
             return await this.context.uploadRange(rangeToString({ count: contentLength, offset }), "update", contentLength, Object.assign(Object.assign({ abortSignal: options.abortSignal, contentMD5: options.contentMD5, requestOptions: {
                     onUploadProgress: options.onProgress,
-                }, body: body }, convertTracingToRequestOptionsBase(updatedOptions)), { leaseAccessConditions: options.leaseAccessConditions }));
+                }, body: body }, convertTracingToRequestOptionsBase(updatedOptions)), { leaseAccessConditions: options.leaseAccessConditions, fileLastWrittenMode: options.fileLastWrittenMode }));
         }
         catch (e) {
             span.setStatus({
@@ -13828,7 +13874,7 @@ class ShareFileClient extends StorageClient {
             if (count <= 0 || count > FILE_RANGE_MAX_SIZE_BYTES) {
                 throw new RangeError(`count must be > 0 and <= ${FILE_RANGE_MAX_SIZE_BYTES} bytes`);
             }
-            return await this.context.uploadRangeFromURL(rangeToString({ offset: destOffset, count }), sourceURL, 0, Object.assign(Object.assign({ abortSignal: options.abortSignal, sourceRange: rangeToString({ offset: sourceOffset, count }), sourceModifiedAccessConditions: options.sourceConditions, copySourceAuthorization: httpAuthorizationToString(options.sourceAuthorization) }, options), convertTracingToRequestOptionsBase(updatedOptions)));
+            return await this.context.uploadRangeFromURL(rangeToString({ offset: destOffset, count }), sourceURL, 0, Object.assign(Object.assign({ abortSignal: options.abortSignal, sourceRange: rangeToString({ offset: sourceOffset, count }), sourceModifiedAccessConditions: options.sourceConditions, copySourceAuthorization: httpAuthorizationToString(options.sourceAuthorization), fileLastWrittenMode: options.fileLastWrittenMode }, options), convertTracingToRequestOptionsBase(updatedOptions)));
         }
         catch (e) {
             span.setStatus({
@@ -13855,7 +13901,7 @@ class ShareFileClient extends StorageClient {
             if (offset < 0 || contentLength <= 0) {
                 throw new RangeError(`offset must >= 0 and contentLength must be > 0`);
             }
-            return await this.context.uploadRange(rangeToString({ count: contentLength, offset }), "clear", 0, Object.assign(Object.assign({ abortSignal: options.abortSignal }, convertTracingToRequestOptionsBase(updatedOptions)), { leaseAccessConditions: options.leaseAccessConditions }));
+            return await this.context.uploadRange(rangeToString({ count: contentLength, offset }), "clear", 0, Object.assign(Object.assign({ abortSignal: options.abortSignal }, convertTracingToRequestOptionsBase(updatedOptions)), { leaseAccessConditions: options.leaseAccessConditions, fileLastWrittenMode: options.fileLastWrittenMode }));
         }
         catch (e) {
             span.setStatus({
@@ -14668,6 +14714,10 @@ class ShareFileClient extends StorageClient {
                     ? {
                         destinationLeaseId: updatedOptions.destinationLeaseAccessConditions.leaseId,
                     }
+                    : undefined, fileHttpHeaders: options.contentType
+                    ? {
+                        fileContentType: options.contentType,
+                    }
                     : undefined }));
             return {
                 destinationFileClient: destFile,