@azure/arm-storage 16.1.1 → 17.0.0-alpha.20211111.1

package/esm/lro/requestUtils.js

@@ -0,0 +1,73 @@
+/*
+ * Copyright (c) Microsoft Corporation.
+ * Licensed under the MIT License.
+ *
+ * Code generated by Microsoft (R) AutoRest Code Generator.
+ * Changes may cause incorrect behavior and will be lost if the code is regenerated.
+ */
+/**
+ * Detects where the continuation token is and returns it. Notice that azure-asyncoperation
+ * must be checked first before the other location headers because there are scenarios
+ * where both azure-asyncoperation and location could be present in the same response but
+ * azure-asyncoperation should be the one to use for polling.
+ */
+export function getPollingUrl(rawResponse, defaultPath) {
+    var _a, _b, _c;
+    return ((_c = (_b = (_a = getAzureAsyncOperation(rawResponse)) !== null && _a !== void 0 ? _a : getLocation(rawResponse)) !== null && _b !== void 0 ? _b : getOperationLocation(rawResponse)) !== null && _c !== void 0 ? _c : defaultPath);
+}
+function getLocation(rawResponse) {
+    return rawResponse.headers["location"];
+}
+function getOperationLocation(rawResponse) {
+    return rawResponse.headers["operation-location"];
+}
+function getAzureAsyncOperation(rawResponse) {
+    return rawResponse.headers["azure-asyncoperation"];
+}
+export function inferLroMode(requestPath, requestMethod, rawResponse) {
+    if (getAzureAsyncOperation(rawResponse) !== undefined) {
+        return {
+            mode: "AzureAsync",
+            resourceLocation: requestMethod === "PUT"
+                ? requestPath
+                : requestMethod === "POST"
+                    ? getLocation(rawResponse)
+                    : undefined
+        };
+    }
+    else if (getLocation(rawResponse) !== undefined ||
+        getOperationLocation(rawResponse) !== undefined) {
+        return {
+            mode: "Location"
+        };
+    }
+    else if (["PUT", "PATCH"].includes(requestMethod)) {
+        return {
+            mode: "Body"
+        };
+    }
+    return {};
+}
+export class RestError extends Error {
+    constructor(message, statusCode) {
+        super(message);
+        this.name = "RestError";
+        this.statusCode = statusCode;
+        Object.setPrototypeOf(this, RestError.prototype);
+    }
+}
+export function isUnexpectedInitialResponse(rawResponse) {
+    const code = rawResponse.statusCode;
+    if (![203, 204, 202, 201, 200, 500].includes(code)) {
+        throw new RestError(`Received unexpected HTTP status code ${code} in the initial response. This may indicate a server issue.`, code);
+    }
+    return false;
+}
+export function isUnexpectedPollingResponse(rawResponse) {
+    const code = rawResponse.statusCode;
+    if (![202, 201, 200, 500].includes(code)) {
+        throw new RestError(`Received unexpected HTTP status code ${code} while polling. This may indicate a server issue.`, code);
+    }
+    return false;
+}
+//# sourceMappingURL=requestUtils.js.map

package/esm/lro/requestUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"requestUtils.js","sourceRoot":"","sources":["../../src/lro/requestUtils.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAOH;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAC3B,WAAwB,EACxB,WAAmB;;IAEnB,OAAO,CACL,MAAA,MAAA,MAAA,sBAAsB,CAAC,WAAW,CAAC,mCACnC,WAAW,CAAC,WAAW,CAAC,mCACxB,oBAAoB,CAAC,WAAW,CAAC,mCACjC,WAAW,CACZ,CAAC;AACJ,CAAC;AAED,SAAS,WAAW,CAAC,WAAwB;IAC3C,OAAO,WAAW,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;AACzC,CAAC;AAED,SAAS,oBAAoB,CAAC,WAAwB;IACpD,OAAO,WAAW,CAAC,OAAO,CAAC,oBAAoB,CAAC,CAAC;AACnD,CAAC;AAED,SAAS,sBAAsB,CAAC,WAAwB;IACtD,OAAO,WAAW,CAAC,OAAO,CAAC,sBAAsB,CAAC,CAAC;AACrD,CAAC;AAED,MAAM,UAAU,YAAY,CAC1B,WAAmB,EACnB,aAAqB,EACrB,WAAwB;IAExB,IAAI,sBAAsB,CAAC,WAAW,CAAC,KAAK,SAAS,EAAE;QACrD,OAAO;YACL,IAAI,EAAE,YAAY;YAClB,gBAAgB,EACd,aAAa,KAAK,KAAK;gBACrB,CAAC,CAAC,WAAW;gBACb,CAAC,CAAC,aAAa,KAAK,MAAM;oBAC1B,CAAC,CAAC,WAAW,CAAC,WAAW,CAAC;oBAC1B,CAAC,CAAC,SAAS;SAChB,CAAC;KACH;SAAM,IACL,WAAW,CAAC,WAAW,CAAC,KAAK,SAAS;QACtC,oBAAoB,CAAC,WAAW,CAAC,KAAK,SAAS,EAC/C;QACA,OAAO;YACL,IAAI,EAAE,UAAU;SACjB,CAAC;KACH;SAAM,IAAI,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,QAAQ,CAAC,aAAa,CAAC,EAAE;QACnD,OAAO;YACL,IAAI,EAAE,MAAM;SACb,CAAC;KACH;IACD,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,MAAM,OAAO,SAAU,SAAQ,KAAK;IAElC,YAAY,OAAe,EAAE,UAAkB;QAC7C,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,WAAW,CAAC;QACxB,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAE7B,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IACnD,CAAC;CACF;AAED,MAAM,UAAU,2BAA2B,CAAC,WAAwB;IAClE,MAAM,IAAI,GAAG,WAAW,CAAC,UAAU,CAAC;IACpC,IAAI,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE;QAClD,MAAM,IAAI,SAAS,CACjB,wCAAwC,IAAI,6DAA6D,EACzG,IAAI,CACL,CAAC;KACH;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,2BAA2B,CAAC,WAAwB;IAClE,MAAM,IAAI,GAAG,WAAW,CAAC,UAAU,CAAC;IACpC,IAAI,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE;QACxC,MAAM,IAAI,SAAS,CACjB,wCAAwC,IAAI,mDAAmD,EAC/F,IAAI,CACL,CAAC;KACH;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/esm/lro/stateMachine.d.ts

@@ -0,0 +1,18 @@
+import { LroResourceLocationConfig, GetLroStatusFromResponse, LongRunningOperation, LroConfig, LroStatus, PollerConfig, RawResponse, ResumablePollOperationState } from "./models";
+/**
+ * creates a stepping function that maps an LRO state to another.
+ */
+export declare function createGetLroStatusFromResponse<TResult>(lroPrimitives: LongRunningOperation<TResult>, config: LroConfig, lroResourceLocationConfig?: LroResourceLocationConfig): GetLroStatusFromResponse<TResult>;
+/**
+ * Creates a polling operation that returns a LRO state.
+ */
+export declare function createPollForLROStatus<TResult>(lroPrimitives: LongRunningOperation<TResult>, config: LroConfig): (pollingURL: string, pollerConfig: PollerConfig) => Promise<LroStatus<TResult>>;
+/**
+ * Creates a callback to be used to initialize the polling operation state.
+ * @param state - of the polling operation
+ * @param operationSpec - of the LRO
+ * @param callback - callback to be called when the operation is done
+ * @returns callback that initializes the state of the polling operation
+ */
+export declare function createInitializeState<TResult>(state: ResumablePollOperationState<TResult>, requestPath: string, requestMethod: string): (rawResponse: RawResponse, flatResponse: unknown) => boolean;
+//# sourceMappingURL=stateMachine.d.ts.map

package/esm/lro/stateMachine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stateMachine.d.ts","sourceRoot":"","sources":["../../src/lro/stateMachine.ts"],"names":[],"mappings":"AAiBA,OAAO,EACL,yBAAyB,EACzB,wBAAwB,EACxB,oBAAoB,EACpB,SAAS,EACT,SAAS,EACT,YAAY,EACZ,WAAW,EACX,2BAA2B,EAC5B,MAAM,UAAU,CAAC;AAQlB;;GAEG;AACH,wBAAgB,8BAA8B,CAAC,OAAO,EACpD,aAAa,EAAE,oBAAoB,CAAC,OAAO,CAAC,EAC5C,MAAM,EAAE,SAAS,EACjB,yBAAyB,CAAC,EAAE,yBAAyB,GACpD,wBAAwB,CAAC,OAAO,CAAC,CAmBnC;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAC5C,aAAa,EAAE,oBAAoB,CAAC,OAAO,CAAC,EAC5C,MAAM,EAAE,SAAS,GAChB,CACD,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,YAAY,KACvB,OAAO,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAmB/B;AAcD;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAC3C,KAAK,EAAE,2BAA2B,CAAC,OAAO,CAAC,EAC3C,WAAW,EAAE,MAAM,EACnB,aAAa,EAAE,MAAM,GACpB,CAAC,WAAW,EAAE,WAAW,EAAE,YAAY,EAAE,OAAO,KAAK,OAAO,CAsB9D"}

package/esm/lro/stateMachine.js

@@ -0,0 +1,84 @@
+/*
+ * Copyright (c) Microsoft Corporation.
+ * Licensed under the MIT License.
+ *
+ * Code generated by Microsoft (R) AutoRest Code Generator.
+ * Changes may cause incorrect behavior and will be lost if the code is regenerated.
+ */
+import { __awaiter } from "tslib";
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT license.
+import { processAzureAsyncOperationResult } from "./azureAsyncPolling";
+import { isBodyPollingDone, processBodyPollingOperationResult } from "./bodyPolling";
+import { processLocationPollingOperationResult } from "./locationPolling";
+import { processPassthroughOperationResult } from "./passthrough";
+import { getPollingUrl, inferLroMode, isUnexpectedInitialResponse } from "./requestUtils";
+/**
+ * creates a stepping function that maps an LRO state to another.
+ */
+export function createGetLroStatusFromResponse(lroPrimitives, config, lroResourceLocationConfig) {
+    switch (config.mode) {
+        case "AzureAsync": {
+            return processAzureAsyncOperationResult(lroPrimitives, config.resourceLocation, lroResourceLocationConfig);
+        }
+        case "Location": {
+            return processLocationPollingOperationResult;
+        }
+        case "Body": {
+            return processBodyPollingOperationResult;
+        }
+        default: {
+            return processPassthroughOperationResult;
+        }
+    }
+}
+/**
+ * Creates a polling operation that returns a LRO state.
+ */
+export function createPollForLROStatus(lroPrimitives, config) {
+    return (path, pollerConfig) => __awaiter(this, void 0, void 0, function* () {
+        const response = yield lroPrimitives.sendPollRequest(config, path);
+        const retryAfter = response.rawResponse.headers["retry-after"];
+        if (retryAfter !== undefined) {
+            const retryAfterInMs = parseInt(retryAfter);
+            pollerConfig.intervalInMs = isNaN(retryAfterInMs)
+                ? calculatePollingIntervalFromDate(new Date(retryAfter), pollerConfig.intervalInMs)
+                : retryAfterInMs;
+        }
+        return response;
+    });
+}
+function calculatePollingIntervalFromDate(retryAfterDate, defaultIntervalInMs) {
+    const timeNow = Math.floor(new Date().getTime());
+    const retryAfterTime = retryAfterDate.getTime();
+    if (timeNow < retryAfterTime) {
+        return retryAfterTime - timeNow;
+    }
+    return defaultIntervalInMs;
+}
+/**
+ * Creates a callback to be used to initialize the polling operation state.
+ * @param state - of the polling operation
+ * @param operationSpec - of the LRO
+ * @param callback - callback to be called when the operation is done
+ * @returns callback that initializes the state of the polling operation
+ */
+export function createInitializeState(state, requestPath, requestMethod) {
+    return (rawResponse, flatResponse) => {
+        if (isUnexpectedInitialResponse(rawResponse))
+            return true;
+        state.initialRawResponse = rawResponse;
+        state.isStarted = true;
+        state.pollingURL = getPollingUrl(state.initialRawResponse, requestPath);
+        state.config = inferLroMode(requestPath, requestMethod, state.initialRawResponse);
+        /** short circuit polling if body polling is done in the initial request */
+        if (state.config.mode === undefined ||
+            (state.config.mode === "Body" &&
+                isBodyPollingDone(state.initialRawResponse))) {
+            state.result = flatResponse;
+            state.isCompleted = true;
+        }
+        return Boolean(state.isCompleted);
+    };
+}
+//# sourceMappingURL=stateMachine.js.map

package/esm/lro/stateMachine.js.map

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