@azure-rest/ai-translation-document 1.0.0-beta.1

package/CHANGELOG.md

@@ -0,0 +1,23 @@
+# Release History
+## 1.0.0-beta.1 (2024-06-27)
+- Initial release. Please see the README and wiki for information on the new design.
+
+Version 1.0.0-beta.1 is preview of our efforts in creating a client library that is developer-friendly, idiomatic 
+to the JS/TS ecosystem, and as consistent across different languages and platforms as possible. 
+
+This package's 
+[documentation](https://github.com/Azure/azure-sdk-for-js/blob/main/sdk/translation/ai-translation-document-rest/README.md) 
+and 
+[samples](https://github.com/Azure/azure-sdk-for-js/blob/main/sdk/translation/ai-translation-document-rest/samples) 
+demonstrate the new API.
+
+### Features Added
+- Added support for Synchronous document translation - [translate-document API](https://learn.microsoft.com/azure/ai-services/translator/document-translation/reference/translate-document)
+- Added support for Batch Translation - [start Translation API](https://learn.microsoft.com/azure/ai-services/translator/document-translation/reference/start-batch-translation)
+- Added support for Get Translations Status - [get translations status API](https://learn.microsoft.com/azure/ai-services/translator/document-translation/reference/get-translations-status)
+- Added support for Get Translation Status - [get translation status API](https://learn.microsoft.com/azure/ai-services/translator/document-translation/reference/get-translation-status)
+- Added support for Get Documents Status - [get documents status API](https://learn.microsoft.com/azure/ai-services/translator/document-translation/reference/get-documents-status)
+- Added support for Get Document Status - [get document status API](https://learn.microsoft.com/azure/ai-services/translator/document-translation/reference/get-document-status)
+- Added support for Cancel Translation - [cancel translation API](https://learn.microsoft.com/azure/ai-services/translator/document-translation/reference/cancel-translation)
+- Added support for Get Supported Document Formats - [get supported document formats API](https://learn.microsoft.com/azure/ai-services/translator/document-translation/reference/get-supported-document-formats)
+- Added support for Get Supported Glossary Formats - [get supported glossary formats API](https://learn.microsoft.com/azure/ai-services/translator/document-translation/reference/get-supported-glossary-formats)

package/README.md

@@ -0,0 +1,346 @@
+# DocumentTranslation REST client library for JavaScript
+
+Document Translation is a cloud-based machine translation feature of the Azure AI Translator service. You can translate multiple and complex documents across all supported languages and dialects while preserving original document structure and data format. The Document translation API supports two translation processes:
+
+Asynchronous batch translation supports the processing of multiple documents and large files. The batch translation process requires an Azure Blob storage account with storage containers for your source and translated documents.
+
+Synchronous single file supports the processing of single file translations. The file translation process doesn't require an Azure Blob storage account. The final response contains the translated document and is returned directly to the calling client.
+
+The following operations are supported by the Document Translation feature:
+
+- **Synchronous document translation**: Used to synchronously translate a single document. The method doesn't require an Azure Blob storage account.
+
+- **Start batch translation**: Used to execute an asynchronous batch translation request. The method requires an Azure Blob storage account with storage containers for your source and translated documents.
+
+- **Get status for all translation jobs**: Used to request a list and the status of all translation jobs submitted by the user (associated with the resource).
+
+- **Get status for a specific translation job**: Used to request the status of a specific translation job. The response includes the overall job status and the status for documents that are being translated as part of that job.
+
+- **Get status for all documents**: Used to request the status for all documents in a translation job.
+
+- **Get status for a specific document**: This returns the status for a specific document in a job as indicated in the request by the id and documentId query parameters.
+
+- **Cancel translation**: This cancels a translation job that is currently processing or queued (pending) as indicated in the request by the id query parameter. An operation isn't canceled if already completed, failed, or still canceling. In those instances, a bad request is returned. Completed translations can't be canceled and are charged.
+
+- **Get supported formats**: This returns a list of document or glossary formats supported by the Document Translation feature. The list includes common file extensions and content-type if using the upload API.
+
+Key links:
+
+- [Source code](https://github.com/Azure/azure-sdk-for-js/tree/main/sdk/translation/ai-translation-document-rest)
+- [Package (NPM)](https://www.npmjs.com/package/@azure-rest/ai-translation-document)
+- [Samples](https://github.com/Azure/azure-sdk-for-js/tree/main/sdk/translation/ai-translation-document-rest/samples)
+
+## Getting started
+
+### Currently supported environments
+
+- LTS versions of Node.js
+- Latest versions of Edge, Chrome, Safar and Firefox
+
+### Prerequisites
+
+- An existing Translator service or Cognitive Services resource. More info on [Pre-requisites][pre_requisities].
+
+### Install the `@azure-rest/ai-translation-document` package
+
+Install the Document Translation REST client library for JavaScript with `npm`:
+
+```bash
+npm install @azure-rest/ai-translation-document
+```
+
+#### Create a Translator service resource
+
+You can create Translator resource following [Create a Translator resource][translator_resource_create].
+
+### Create a `DocumentTranslationClient` using an endpoint URL and API key `KeyCredential`
+
+Once you have the value for API key, create a credential
+```typescript
+const credentials = { key: apiKey ?? "" };
+```
+
+With the value of the `KeyCredential` you can create the `DocumentTranslationClient` using the `createClient` method of [documentTranslationClient_class]:
+
+```typescript
+const client = createClient(endpoint, credentials);
+```
+
+## Examples
+
+The following section provides several code snippets using the `client`, and covers the main features present in this client library.
+
+### Synchronous Document Translation
+
+Used to synchronously translate a single document. The method doesn't require an Azure Blob storage account.
+
+```typescript
+console.log("== Synchronous Document Translation ==");
+const client = createClient(endpoint, credentials);
+const options: DocumentTranslateParameters = {
+  queryParameters: {
+    targetLanguage: "hi",
+  },
+  contentType: "multipart/form-data",
+  body: [
+    {
+      name: "document",
+      body: "This is a test.",
+      filename: "test-input.txt",
+      contentType: "text/html",
+    },
+  ],
+};
+
+const response = await client.path("/document:translate").post(options);
+if (isUnexpected(response)) {
+  throw response.body;
+}
+console.log('Response code: ' + response.status + ', Response body: ' + response.body); 
+```
+
+### Batch Document Translation
+Used to execute an asynchronous batch translation request. The method requires an Azure Blob storage account with storage containers for your source and translated documents.
+
+```typescript
+console.log("== Batch Document Translation ==");
+const client = createClient(endpoint, credentials);
+
+const sourceUrl = await createSourceContainer(ONE_TEST_DOCUMENTS);
+const sourceInput = createSourceInput(sourceUrl);
+const targetUrl = await createTargetContainer();
+const targetInput = createTargetInput(targetUrl, "fr");
+const batchRequest = createBatchRequest(sourceInput, [targetInput]);
+
+//Start translation
+const batchRequests = {inputs: [batchRequest]};
+const poller = await client.path("/document/batches").post({
+body: batchRequests
+}); 
+const id = getTranslationOperationID(poller.headers["operation-location"]);
+console.log('Translation started and the operationID is: ' + id);
+```
+
+### Cancel Document Translation
+This cancels a translation job that is currently processing or queued (pending) as indicated in the request by the id query parameter. An operation isn't canceled if already completed, failed, or still canceling. In those instances, a bad request is returned. Completed translations can't be canceled and are charged.
+
+```typescript
+console.log("== Cancel Translation ==");
+const client = createClient(endpoint, credentials);
+
+const sourceUrl = await createSourceContainer(ONE_TEST_DOCUMENTS);
+const sourceInput = createSourceInput(sourceUrl);
+const targetUrl = await createTargetContainer();
+const targetInput = createTargetInput(targetUrl, "fr");
+const batchRequest = createBatchRequest(sourceInput, [targetInput]);
+
+//Start translation
+const batchRequests = {inputs: [batchRequest]};
+const poller = await client.path("/document/batches").post({
+body: batchRequests
+}); 
+const id = getTranslationOperationID(poller.headers["operation-location"]);
+
+//Cancel translation
+await client.path("/document/batches/{id}", id).delete();
+
+//get translation status and verify the job is cancelled, cancelling or notStarted
+const response = await client.path("/document/batches/{id}", id).get();
+if (isUnexpected(response)) {
+  throw response.body;
+}
+console.log("The status after cancelling the batch operation is:" + response.body.status);
+```
+
+### Get Documents Status
+Used to request the status for all documents in a translation job.
+
+```typescript
+console.log("== Gets Documents Status ==");
+const client = createClient(endpoint, credentials);
+
+const sourceUrl = await createSourceContainer(ONE_TEST_DOCUMENTS);
+const sourceInput = createSourceInput(sourceUrl);
+const targetUrl = await createTargetContainer();
+const targetInput = createTargetInput(targetUrl, "fr");
+const batchRequest = createBatchRequest(sourceInput, [targetInput]);
+
+//Start translation
+const batchRequests = {inputs: [batchRequest]};
+const response = await StartTranslationAndWait(client, batchRequests); 
+
+const operationLocationUrl = response.headers["operation-location"]
+const operationId = getTranslationOperationID(operationLocationUrl);
+
+//get Documents Status
+const documentResponse = await client.path("/document/batches/{id}/documents", operationId).get();
+if (isUnexpected(documentResponse)) {
+  throw documentResponse.body;
+}
+
+const responseBody = documentResponse.body;
+for (const documentStatus of responseBody.value) {
+    console.log("Document Status is: " + documentStatus.status);
+    console.log("Characters charged is: " + documentStatus.characterCharged);
+    break;          
+}
+```
+
+### Get Document Status
+This returns the status for a specific document in a job as indicated in the request by the id and documentId query parameters.
+
+```typescript
+console.log("== Get Document Status ==");
+const client = createClient(endpoint, credentials);
+
+const sourceUrl = await createSourceContainer(ONE_TEST_DOCUMENTS);
+const sourceInput = createSourceInput(sourceUrl);
+const targetUrl = await createTargetContainer();
+const targetInput = createTargetInput(targetUrl, "fr");
+const batchRequest = createBatchRequest(sourceInput, [targetInput]);
+
+//Start translation
+const batchRequests = {inputs: [batchRequest]};
+const response = await StartTranslationAndWait(client, batchRequests); 
+const operationLocationUrl = response.headers["operation-location"]
+const operationId = getTranslationOperationID(operationLocationUrl);
+
+//get Documents Status
+const documentResponse = await client.path("/document/batches/{id}/documents", operationId).get();
+if (isUnexpected(documentResponse)) {
+  throw documentResponse.body;
+}
+
+const responseBody = documentResponse.body;
+for (const document of responseBody.value) {
+    //get document status
+    const documentStatus = await client.path("/document/batches/{id}/documents/{documentId}", operationId, document.id).get();
+    console.log("Document Status = " + documentStatus.status);
+    const documentStatusOutput = documentStatus.body as DocumentStatusOutput;
+    console.log("Document ID = " +documentStatusOutput.id);
+    console.log("Document source path = " + documentStatusOutput.sourcePath);
+    console.log("Document path = " + documentStatusOutput.path);
+    console.log("Target language = " + documentStatusOutput.to);
+    console.log("Document created dateTime = " + documentStatusOutput.createdDateTimeUtc);
+    console.log("Document last action date time = " + documentStatusOutput.lastActionDateTimeUtc);        
+}
+```
+
+### Get Translations Status
+Used to request a list and the status of all translation jobs submitted by the user (associated with the resource).
+
+```typescript
+console.log("== Get Translations Status ==");
+  const client = createClient(endpoint, credentials);
+
+  const sourceUrl = await createSourceContainer(ONE_TEST_DOCUMENTS);
+  const sourceInput = createSourceInput(sourceUrl);
+  const targetUrl = await createTargetContainer();
+  const targetInput = createTargetInput(targetUrl, "fr");
+  const batchRequest = createBatchRequest(sourceInput, [targetInput]);
+  
+  //Start translation
+  const batchRequests = {inputs: [batchRequest]};
+  const translationResponse = await StartTranslationAndWait(client, batchRequests); 
+  const operationLocationUrl = translationResponse.headers["operation-location"]
+  const operationId = getTranslationOperationID(operationLocationUrl);  
+
+  //get Translation Statusby ID filter
+  const queryParams = {
+      ids: [operationId]
+    };    
+  const response = await client.path("/document/batches").get({
+      queryParameters: queryParams 
+    });
+  if (isUnexpected(response)) {
+    throw response.body;
+  }  
+  const responseBody = response.body;
+  for (const translationStatus of responseBody.value) {
+    console.log("Translation ID = " + translationStatus.id);
+    console.log("Translation Status = " + translationStatus.status);
+    console.log("Translation createdDateTimeUtc = " + translationStatus.createdDateTimeUtc);
+    console.log("Translation lastActionDateTimeUtc = " + translationStatus.lastActionDateTimeUtc);
+    console.log("Total documents submitted for translation = " + translationStatus.summary.total);
+    console.log("Total characters charged = " + translationStatus.summary.totalCharacterCharged);
+  }  
+```
+
+### Get Translation Status
+Used to request the status of a specific translation job. The response includes the overall job status and the status for documents that are being translated as part of that job.
+
+```typescript
+console.log("== Get Translation Status ==");
+const client = createClient(endpoint, credentials);
+
+const sourceUrl = await createSourceContainer(ONE_TEST_DOCUMENTS);
+const sourceInput = createSourceInput(sourceUrl);
+const targetUrl = await createTargetContainer();
+const targetInput = createTargetInput(targetUrl, "fr");
+const batchRequest = createBatchRequest(sourceInput, [targetInput]);
+
+//Start translation
+const batchRequests = {inputs: [batchRequest]};
+const translationResponse = await StartTranslationAndWait(client, batchRequests); 
+
+const operationLocationUrl = translationResponse.headers["operation-location"]
+const operationId = getTranslationOperationID(operationLocationUrl);  
+
+//get Translation Status
+const response = await client.path("/document/batches/{id}",operationId).get() as GetTranslationStatus200Response;
+if (isUnexpected(response)) {
+    throw response.body;
+}
+
+console.log("Translation ID = " + response.body.id);
+console.log("Translation Status = " + response.body.status);
+console.log("Translation createdDateTimeUtc = " + response.body.createdDateTimeUtc);
+console.log("Translation lastActionDateTimeUtc = " + response.body.lastActionDateTimeUtc);
+console.log("Total documents submitted for translation = " + response.body.summary.total);
+console.log("Total characters charged = " + response.body.summary.totalCharacterCharged);
+```
+
+
+### Get Supported Formats
+
+This returns a list of document or glossary formats supported by the Document Translation feature. The list includes common file extensions and content-type if using the upload API.
+
+```typescript
+console.log("== List Supported Format Types ==");
+
+const documentTranslationClient = DocumentTranslationClient(endpoint);
+const response = await documentTranslationClient.path("/document/formats").get();
+
+const fileFormatTypes = response.body;
+fileFormatTypes.value.forEach((fileFormatType: { format: any; contentTypes: any; fileExtensions: any; }) => {
+console.log(fileFormatType.format);
+console.log(fileFormatType.contentTypes);
+console.log(fileFormatType.fileExtensions);
+});
+```
+
+## Troubleshooting
+
+When you interact with the Translator Service using the DocumentTranslator client library, errors returned by the Translator service correspond to the same HTTP status codes returned for REST API requests.
+
+For example, if you submit a translation request without a target translate language, a `400` error is returned, indicating "Bad Request".
+
+You can find the different error codes returned by the service in the [Service Documentation][service_errors].
+
+### Logging
+
+Enabling logging may help uncover useful information about failures. In order to see a log of HTTP requests and responses, set the `AZURE_LOG_LEVEL` environment variable to `info`. Alternatively, logging can be enabled at runtime by calling `setLogLevel` in the `@azure/logger`:
+
+```javascript
+const { setLogLevel } = require("@azure/logger");
+
+setLogLevel("info");
+```
+
+For more detailed instructions on how to enable logs, you can look at the [@azure/logger package docs](https://github.com/Azure/azure-sdk-for-js/tree/main/sdk/core/logger).
+Please refer to the service documentation for a conceptual discussion of [languages][languages_doc].
+
+[service_errors]: https://learn.microsoft.com/azure/ai-services/translator/document-translation/how-to-guides/use-rest-api-programmatically?tabs=csharp#common-http-status-codes
+[translator_resource_create]: https://learn.microsoft.com/azure/cognitive-services/Translator/create-translator-resource
+[documentTranslationClient_class]: https://github.com/Azure/azure-sdk-for-js/blob/main/sdk/translation/ai-translation-document-rest/src/documentTranslationClient.ts
+[pre_requisities]: https://learn.microsoft.com/azure/ai-services/translator/document-translation/how-to-guides/use-rest-api-programmatically?tabs=csharp#prerequisites

package/dist/index.js

@@ -0,0 +1,299 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var coreClient = require('@azure-rest/core-client');
+var logger$1 = require('@azure/logger');
+var corePaging = require('@azure/core-paging');
+var coreLro = require('@azure/core-lro');
+var coreRestPipeline = require('@azure/core-rest-pipeline');
+
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT license.
+const logger = logger$1.createClientLogger("ai-translation-document");
+
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT license.
+/**
+ * Initialize a new instance of `DocumentTranslationClient`
+ * @param endpointParam - Supported document Translation endpoint, protocol and hostname, for example: https://{TranslatorResourceName}.cognitiveservices.azure.com/translator.
+ * @param credentials - uniquely identify client credential
+ * @param options - the parameter for all optional parameters
+ */
+function createClient(endpointParam, credentials, options = {}) {
+    var _a, _b, _c, _d, _e, _f, _g, _h, _j;
+    const endpointUrl = (_b = (_a = options.endpoint) !== null && _a !== void 0 ? _a : options.baseUrl) !== null && _b !== void 0 ? _b : `${endpointParam}/translator`;
+    options.apiVersion = (_c = options.apiVersion) !== null && _c !== void 0 ? _c : "2024-05-01";
+    const userAgentInfo = `azsdk-js-ai-translation-document-rest/1.0.0-beta.1`;
+    const userAgentPrefix = options.userAgentOptions && options.userAgentOptions.userAgentPrefix
+        ? `${options.userAgentOptions.userAgentPrefix} ${userAgentInfo}`
+        : `${userAgentInfo}`;
+    options = Object.assign(Object.assign({}, options), { userAgentOptions: {
+            userAgentPrefix,
+        }, loggingOptions: {
+            logger: (_e = (_d = options.loggingOptions) === null || _d === void 0 ? void 0 : _d.logger) !== null && _e !== void 0 ? _e : logger.info,
+        }, credentials: {
+            scopes: (_g = (_f = options.credentials) === null || _f === void 0 ? void 0 : _f.scopes) !== null && _g !== void 0 ? _g : ["https://cognitiveservices.azure.com/.default"],
+            apiKeyHeaderName: (_j = (_h = options.credentials) === null || _h === void 0 ? void 0 : _h.apiKeyHeaderName) !== null && _j !== void 0 ? _j : "Ocp-Apim-Subscription-Key",
+        } });
+    const client = coreClient.getClient(endpointUrl, credentials, options);
+    return client;
+}
+
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT license.
+const responseMap = {
+    "POST /document:translate": ["200"],
+    "GET /document/batches": ["200"],
+    "POST /document/batches": ["202"],
+    "GET /document/batches/{id}/documents/{documentId}": ["200"],
+    "GET /document/batches/{id}": ["200"],
+    "DELETE /document/batches/{id}": ["200"],
+    "GET /document/batches/{id}/documents": ["200"],
+    "GET /document/formats": ["200"],
+};
+function isUnexpected(response) {
+    const lroOriginal = response.headers["x-ms-original-url"];
+    const url = new URL(lroOriginal !== null && lroOriginal !== void 0 ? lroOriginal : response.request.url);
+    const method = response.request.method;
+    let pathDetails = responseMap[`${method} ${url.pathname}`];
+    if (!pathDetails) {
+        pathDetails = getParametrizedPathSuccess(method, url.pathname);
+    }
+    return !pathDetails.includes(response.status);
+}
+function getParametrizedPathSuccess(method, path) {
+    var _a, _b, _c, _d;
+    const pathParts = path.split("/");
+    // Traverse list to match the longest candidate
+    // matchedLen: the length of candidate path
+    // matchedValue: the matched status code array
+    let matchedLen = -1, matchedValue = [];
+    // Iterate the responseMap to find a match
+    for (const [key, value] of Object.entries(responseMap)) {
+        // Extracting the path from the map key which is in format
+        // GET /path/foo
+        if (!key.startsWith(method)) {
+            continue;
+        }
+        const candidatePath = getPathFromMapKey(key);
+        // Get each part of the url path
+        const candidateParts = candidatePath.split("/");
+        // track if we have found a match to return the values found.
+        let found = true;
+        for (let i = candidateParts.length - 1, j = pathParts.length - 1; i >= 1 && j >= 1; i--, j--) {
+            if (((_a = candidateParts[i]) === null || _a === void 0 ? void 0 : _a.startsWith("{")) && ((_b = candidateParts[i]) === null || _b === void 0 ? void 0 : _b.indexOf("}")) !== -1) {
+                const start = candidateParts[i].indexOf("}") + 1, end = (_c = candidateParts[i]) === null || _c === void 0 ? void 0 : _c.length;
+                // If the current part of the candidate is a "template" part
+                // Try to use the suffix of pattern to match the path
+                // {guid} ==> $
+                // {guid}:export ==> :export$
+                const isMatched = new RegExp(`${(_d = candidateParts[i]) === null || _d === void 0 ? void 0 : _d.slice(start, end)}`).test(pathParts[j] || "");
+                if (!isMatched) {
+                    found = false;
+                    break;
+                }
+                continue;
+            }
+            // If the candidate part is not a template and
+            // the parts don't match mark the candidate as not found
+            // to move on with the next candidate path.
+            if (candidateParts[i] !== pathParts[j]) {
+                found = false;
+                break;
+            }
+        }
+        // We finished evaluating the current candidate parts
+        // Update the matched value if and only if we found the longer pattern
+        if (found && candidatePath.length > matchedLen) {
+            matchedLen = candidatePath.length;
+            matchedValue = value;
+        }
+    }
+    return matchedValue;
+}
+function getPathFromMapKey(mapKey) {
+    const pathStart = mapKey.indexOf("/");
+    return mapKey.slice(pathStart);
+}
+
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT license.
+/**
+ * Helper to paginate results from an initial response that follows the specification of Autorest `x-ms-pageable` extension
+ * @param client - Client to use for sending the next page requests
+ * @param initialResponse - Initial response containing the nextLink and current page of elements
+ * @param customGetPage - Optional - Function to define how to extract the page and next link to be used to paginate the results
+ * @returns - PagedAsyncIterableIterator to iterate the elements
+ */
+function paginate(client, initialResponse, options = {}) {
+    let firstRun = true;
+    const itemName = "value";
+    const nextLinkName = "nextLink";
+    const { customGetPage } = options;
+    const pagedResult = {
+        firstPageLink: "",
+        getPage: typeof customGetPage === "function"
+            ? customGetPage
+            : async (pageLink) => {
+                const result = firstRun ? initialResponse : await client.pathUnchecked(pageLink).get();
+                firstRun = false;
+                checkPagingRequest(result);
+                const nextLink = getNextLink(result.body, nextLinkName);
+                const values = getElements(result.body, itemName);
+                return {
+                    page: values,
+                    nextPageLink: nextLink,
+                };
+            },
+    };
+    return corePaging.getPagedAsyncIterator(pagedResult);
+}
+/**
+ * Gets for the value of nextLink in the body
+ */
+function getNextLink(body, nextLinkName) {
+    if (!nextLinkName) {
+        return undefined;
+    }
+    const nextLink = body[nextLinkName];
+    if (typeof nextLink !== "string" && typeof nextLink !== "undefined") {
+        throw new Error(`Body Property ${nextLinkName} should be a string or undefined`);
+    }
+    return nextLink;
+}
+/**
+ * Gets the elements of the current request in the body.
+ */
+function getElements(body, itemName) {
+    const value = body[itemName];
+    // value has to be an array according to the x-ms-pageable extension.
+    // The fact that this must be an array is used above to calculate the
+    // type of elements in the page in PaginateReturn
+    if (!Array.isArray(value)) {
+        throw new Error(`Couldn't paginate response\n Body doesn't contain an array property with name: ${itemName}`);
+    }
+    return value !== null && value !== void 0 ? value : [];
+}
+/**
+ * Checks if a request failed
+ */
+function checkPagingRequest(response) {
+    const Http2xxStatusCodes = ["200", "201", "202", "203", "204", "205", "206", "207", "208", "226"];
+    if (!Http2xxStatusCodes.includes(response.status)) {
+        throw coreClient.createRestError(`Pagination failed with unexpected statusCode ${response.status}`, response);
+    }
+}
+
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT license.
+async function getLongRunningPoller(client, initialResponse, options = {}) {
+    var _a;
+    const abortController = new AbortController();
+    const poller = {
+        sendInitialRequest: async () => {
+            // In the case of Rest Clients we are building the LRO poller object from a response that's the reason
+            // we are not triggering the initial request here, just extracting the information from the
+            // response we were provided.
+            return getLroResponse(initialResponse);
+        },
+        sendPollRequest: async (path, sendPollRequestOptions) => {
+            // This is the callback that is going to be called to poll the service
+            // to get the latest status. We use the client provided and the polling path
+            // which is an opaque URL provided by caller, the service sends this in one of the following headers: operation-location, azure-asyncoperation or location
+            // depending on the lro pattern that the service implements. If non is provided we default to the initial path.
+            function abortListener() {
+                abortController.abort();
+            }
+            const inputAbortSignal = sendPollRequestOptions === null || sendPollRequestOptions === void 0 ? void 0 : sendPollRequestOptions.abortSignal;
+            const abortSignal = abortController.signal;
+            if (inputAbortSignal === null || inputAbortSignal === void 0 ? void 0 : inputAbortSignal.aborted) {
+                abortController.abort();
+            }
+            else if (!abortSignal.aborted) {
+                inputAbortSignal === null || inputAbortSignal === void 0 ? void 0 : inputAbortSignal.addEventListener("abort", abortListener, {
+                    once: true,
+                });
+            }
+            let response;
+            try {
+                response = await client
+                    .pathUnchecked(path !== null && path !== void 0 ? path : initialResponse.request.url)
+                    .get({ abortSignal });
+            }
+            finally {
+                inputAbortSignal === null || inputAbortSignal === void 0 ? void 0 : inputAbortSignal.removeEventListener("abort", abortListener);
+            }
+            const lroResponse = getLroResponse(response);
+            lroResponse.rawResponse.headers["x-ms-original-url"] = initialResponse.request.url;
+            return lroResponse;
+        },
+    };
+    options.resolveOnUnsuccessful = (_a = options.resolveOnUnsuccessful) !== null && _a !== void 0 ? _a : true;
+    const httpPoller = coreLro.createHttpPoller(poller, options);
+    const simplePoller = {
+        isDone() {
+            return httpPoller.isDone;
+        },
+        isStopped() {
+            return httpPoller.isStopped;
+        },
+        getOperationState() {
+            if (!httpPoller.operationState) {
+                throw new Error("Operation state is not available. The poller may not have been started and you could await submitted() before calling getOperationState().");
+            }
+            return httpPoller.operationState;
+        },
+        getResult() {
+            return httpPoller.result;
+        },
+        toString() {
+            if (!httpPoller.operationState) {
+                throw new Error("Operation state is not available. The poller may not have been started and you could await submitted() before calling getOperationState().");
+            }
+            return JSON.stringify({
+                state: httpPoller.operationState,
+            });
+        },
+        stopPolling() {
+            abortController.abort();
+        },
+        onProgress: httpPoller.onProgress,
+        poll: httpPoller.poll,
+        pollUntilDone: httpPoller.pollUntilDone,
+        serialize: httpPoller.serialize,
+        submitted: httpPoller.submitted,
+    };
+    return simplePoller;
+}
+/**
+ * Converts a Rest Client response to a response that the LRO implementation understands
+ * @param response - a rest client http response
+ * @returns - An LRO response that the LRO implementation understands
+ */
+function getLroResponse(response) {
+    if (Number.isNaN(response.status)) {
+        throw new TypeError(`Status code of the response is not a number. Value: ${response.status}`);
+    }
+    return {
+        flatResponse: response,
+        rawResponse: Object.assign(Object.assign({}, response), { statusCode: Number.parseInt(response.status), body: response.body }),
+    };
+}
+
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT license.
+
+Object.defineProperty(exports, "createFile", {
+    enumerable: true,
+    get: function () { return coreRestPipeline.createFile; }
+});
+Object.defineProperty(exports, "createFileFromStream", {
+    enumerable: true,
+    get: function () { return coreRestPipeline.createFileFromStream; }
+});
+exports.default = createClient;
+exports.getLongRunningPoller = getLongRunningPoller;
+exports.isUnexpected = isUnexpected;
+exports.paginate = paginate;
+//# sourceMappingURL=index.js.map