@azure-rest/ai-document-intelligence 1.0.0 → 1.1.0

package/CHANGELOG.md

@@ -1,5 +1,28 @@
+<!-- dev-tool snippets ignore -->
+
 # Release History
 
+## 1.1.0 (2025-05-08)
+
+### Features Added
+
+- Supports alternative cloud environments (Azure United States Government and Azure China Cloud). To use an alternative cloud environment, provide a value for the `scopes` field of `DocumentIntelligenceClientOptions#credentials` to configure the client to authenticate within a [Sovereign Cloud](https://learn.microsoft.com/entra/identity-platform/authentication-national-cloud).
+  Import and use `KnownDocumentIntelligenceAudience` to get the correct values for a given cloud environment. The currently supported cloud environments are:
+
+  - `KnownDocumentIntelligenceAudience.AzureChina` (`"https://cognitiveservices.azure.cn"`),
+  - `KnownDocumentIntelligenceAudience.AzureGovernment` (`"https://cognitiveservices.azure.us"`),
+  - `KnownDocumentIntelligenceAudience.AzurePublicCloud` (`"https://cognitiveservices.azure.com"`),
+
+  ```js
+    const client = DocumentIntelligence(
+      "<cognitive services endpoint>",
+      <--credential-->,
+      { credentials: { scopes: [ KnownDocumentIntelligenceAudience.AzureGovernment ] } }
+    );
+  ```
+
+  If `scopes` is undefined, the default value is suitable for the Azure Public Cloud `https://cognitiveservices.azure.com`.
+
 ## 1.0.0 (2024-12-16)
 
 ### Features Added
@@ -22,7 +45,7 @@
       "/documentModels/{modelId}/analyzeResults/{resultId}/figures/{figureId}",
       "prebuilt-layout",
       resultId,
-      figureId
+      figureId,
     )
     .get()
     .asNodeStream(); // output.body would be NodeJS.ReadableStream
@@ -61,7 +84,7 @@
     .path(
       "/documentModels/{modelId}/analyzeBatchResults/{resultId}",
       "prebuilt-layout",
-      batchResultId
+      batchResultId,
     )
     .get();
   ```
@@ -108,6 +131,11 @@ The following types are renamed
 - `ResourceDetailsOutput` to `DocumentIntelligenceResourceDetailsOutput`
 - `PagedOperationDetailsOutput` to `PagedDocumentIntelligenceOperationDetailsOutput`
 - `GetResourceInfo` to `GetResourceDetails`
+- `AnalyzeResultOperationOutput` to `AnalyzeOperationOutput`
+- `FontWeightOutput` to `DocumentFontWeightOutput`
+- `FontStyleOutput` to `DocumentFontStyleOutput`
+- `DocumentOutput` to `AnalyzedDocumentOutput`
+- `CopyAuthorizationOutput` to `ModelCopyAuthorizationOutput`
 
 ## 1.0.0-beta.3 (2024-08-20)
 

package/LICENSE

@@ -1,6 +1,6 @@
-The MIT License (MIT)
+Copyright (c) Microsoft Corporation.
 
-Copyright (c) 2024 Microsoft
+MIT License
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal
@@ -12,10 +12,10 @@ furnished to do so, subject to the following conditions:
 The above copyright notice and this permission notice shall be included in all
 copies or substantial portions of the Software.
 
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+THE SOFTWARE IS PROVIDED *AS IS*, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
 IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
 FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
 AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+SOFTWARE.

package/README.md

@@ -10,7 +10,7 @@ Key links:
 
 - [Source code](https://github.com/Azure/azure-sdk-for-js/tree/main/sdk/documentintelligence/ai-document-intelligence-rest)
 - [Package (NPM)](https://www.npmjs.com/package/@azure-rest/ai-document-intelligence)
-- [API reference documentation](https://docs.microsoft.com/javascript/api/@azure-rest/ai-document-intelligence?view=azure-node-preview)
+- [API reference documentation](https://learn.microsoft.com/javascript/api/@azure-rest/ai-document-intelligence?view=azure-node-preview)
 - [Samples](https://github.com/Azure/azure-sdk-for-js/tree/main/sdk/documentintelligence/ai-document-intelligence-rest/samples)
 - [Changelog](https://github.com/Azure/azure-sdk-for-js/tree/main/sdk/documentintelligence/ai-document-intelligence-rest/CHANGELOG.md)
 - [Migration Guide from Form Recognizer](https://github.com/Azure/azure-sdk-for-js/tree/main/sdk/documentintelligence/ai-document-intelligence-rest/MIGRATION-FR_v4-DI_v1.md)
@@ -19,19 +19,19 @@ Key links:
 
 This table shows the relationship between SDK versions and supported API versions of the service:
 
-| SDK version  | Supported API version of service |
-| ------------ | -------------------------------- |
-| 1.0.0        | 2024-11-30                       |
+| SDK version | Supported API version of service |
+| ----------- | -------------------------------- |
+| 1.0.0       | 2024-11-30                       |
 
 > Please rely on the older `@azure/ai-form-recognizer` library through the older service API versions for retired models, such as `"prebuilt-businessCard"` and `"prebuilt-document"`. For more information, see [Changelog](https://github.com/Azure/azure-sdk-for-js/tree/main/sdk/documentintelligence/ai-document-intelligence-rest/CHANGELOG.md).
 
 The below table describes the relationship of each client and its supported API version(s):
 
-| Service API version | Supported clients                                            | Package                                                       |
-| ------------------- | ------------------------------------------------------------ | ------------------------------------------------------------- |
-| 2024-11-30          | DocumentIntelligenceClient                                   | `@azure-rest/ai-document-intelligence` version `1.0.0`        |
-| 2023-07-31          | DocumentAnalysisClient and DocumentModelAdministrationClient | `@azure/ai-form-recognizer` version `^5.0.0`                  |
-| 2022-08-01          | DocumentAnalysisClient and DocumentModelAdministrationClient | `@azure/ai-form-recognizer` version `^4.0.0`                  |
+| Service API version | Supported clients                                            | Package                                                |
+| ------------------- | ------------------------------------------------------------ | ------------------------------------------------------ |
+| 2024-11-30          | DocumentIntelligenceClient                                   | `@azure-rest/ai-document-intelligence` version `^1.0.0` |
+| 2023-07-31          | DocumentAnalysisClient and DocumentModelAdministrationClient | `@azure/ai-form-recognizer` version `^5.0.0`           |
+| 2022-08-01          | DocumentAnalysisClient and DocumentModelAdministrationClient | `@azure/ai-form-recognizer` version `^4.0.0`           |
 
 ## Getting started
 
@@ -68,18 +68,19 @@ AZURE_CLIENT_ID, AZURE_TENANT_ID, AZURE_CLIENT_SECRET
 
 ### Using a Token Credential
 
-```ts
+```ts snippet:ReadmeSampleCreateClient_TokenCredential
 import DocumentIntelligence from "@azure-rest/ai-document-intelligence";
+import { DefaultAzureCredential } from "@azure/identity";
 
 const client = DocumentIntelligence(
   process.env["DOCUMENT_INTELLIGENCE_ENDPOINT"],
-  new DefaultAzureCredential()
+  new DefaultAzureCredential(),
 );
 ```
 
 ### Using an API KEY
 
-```ts
+```ts snippet:ReadmeSampleCreateClient_APIKey
 import DocumentIntelligence from "@azure-rest/ai-document-intelligence";
 
 const client = DocumentIntelligence(process.env["DOCUMENT_INTELLIGENCE_ENDPOINT"], {
@@ -87,11 +88,41 @@ const client = DocumentIntelligence(process.env["DOCUMENT_INTELLIGENCE_ENDPOINT"
 });
 ```
 
+### Sovereign Clouds
+
+Connect to alternative Azure cloud environments (such as Azure China or Azure Government) by specifying the `scopes` field in the `credentials` option and use the appropriate value from `KnownDocumentIntelligenceAudience`.
+
+```ts
+import DocumentIntelligence, { KnownDocumentIntelligenceAudience } from "@azure-rest/ai-document-intelligence";
+import { DefaultAzureCredential } from "@azure/identity";
+
+const client = DocumentIntelligence(
+  process.env["DOCUMENT_INTELLIGENCE_ENDPOINT"],
+  new DefaultAzureCredential(),
+  {
+    credentials: {
+      // Use the correct audience for your cloud environment
+      scopes: [KnownDocumentIntelligenceAudience.AzureGovernment]
+    }
+  }
+);
+```
+
+If you do not specify `scopes`, the client will default to the Azure Public Cloud (`https://cognitiveservices.azure.com`).
+
 ## Document Models
 
 ### Analyze prebuilt-layout (urlSource)
 
-```ts
+```ts snippet:ReadmeSampleAnalyzePrebuiltLayoutUrlSource
+import DocumentIntelligence from "@azure-rest/ai-document-intelligence";
+import { DefaultAzureCredential } from "@azure/identity";
+
+const client = DocumentIntelligence(
+  process.env["DOCUMENT_INTELLIGENCE_ENDPOINT"],
+  new DefaultAzureCredential(),
+);
+
 const initialResponse = await client
   .path("/documentModels/{modelId}:analyze", "prebuilt-layout")
   .post({
@@ -106,12 +137,23 @@ const initialResponse = await client
 
 ### Analyze prebuilt-layout (base64Source)
 
-```ts
-import fs from "fs";
-import path from "path";
+```ts snippet:ReadmeSampleAnalyzePrebuiltLayoutBase64Source
+import DocumentIntelligence, {
+  isUnexpected,
+  getLongRunningPoller,
+  AnalyzeOperationOutput,
+} from "@azure-rest/ai-document-intelligence";
+import { DefaultAzureCredential } from "@azure/identity";
+import { join } from "node:path";
+import { readFile } from "node:fs/promises";
 
-const filePath = path.join(ASSET_PATH, "forms", "Invoice_1.pdf");
-const base64Source = fs.readFileSync(filePath, { encoding: "base64" });
+const client = DocumentIntelligence(
+  process.env["DOCUMENT_INTELLIGENCE_ENDPOINT"],
+  new DefaultAzureCredential(),
+);
+
+const filePath = join("./assets", "forms", "Invoice_1.pdf");
+const base64Source = await readFile(filePath, { encoding: "base64" });
 const initialResponse = await client
   .path("/documentModels/{modelId}:analyze", "prebuilt-layout")
   .post({
@@ -121,41 +163,29 @@ const initialResponse = await client
     },
     queryParameters: { locale: "en-IN" },
   });
-```
-
-Continue creating the poller from initial response
-
-```ts
-import {
-  getLongRunningPoller,
-  AnalyzeResultOperationOutput,
-  isUnexpected,
-} from "@azure-rest/ai-document-intelligence";
 
 if (isUnexpected(initialResponse)) {
   throw initialResponse.body.error;
 }
+
 const poller = getLongRunningPoller(client, initialResponse);
-const result = (await poller.pollUntilDone()).body as AnalyzeResultOperationOutput;
+const result = (await poller.pollUntilDone()).body as AnalyzeOperationOutput;
 console.log(result);
-// {
-//   status: 'succeeded',
-//   createdDateTime: '2023-11-10T13:31:31Z',
-//   lastUpdatedDateTime: '2023-11-10T13:31:34Z',
-//   analyzeResult: {
-//     apiVersion: '2023-10-31-preview',
-//     .
-//     .
-//     .
-//     contentFormat: 'text'
-//   }
-// }
 ```
 
 ## Batch analysis
 
-```ts
-import { parseResultIdFromResponse, isUnexpected } from "@azure-rest/ai-document-intelligence";
+```ts snippet:ReadmeSampleAnalyzeBatch
+import DocumentIntelligence, {
+  isUnexpected,
+  parseResultIdFromResponse,
+} from "@azure-rest/ai-document-intelligence";
+import { DefaultAzureCredential } from "@azure/identity";
+
+const client = DocumentIntelligence(
+  process.env["DOCUMENT_INTELLIGENCE_ENDPOINT"],
+  new DefaultAzureCredential(),
+);
 
 // 1. Analyze a batch of documents
 const initialResponse = await client
@@ -164,9 +194,10 @@ const initialResponse = await client
     contentType: "application/json",
     body: {
       azureBlobSource: {
-        containerUrl: batchTrainingFilesContainerUrl(),
+        containerUrl: process.env["DOCUMENT_INTELLIGENCE_BATCH_TRAINING_DATA_CONTAINER_SAS_URL"],
       },
-      resultContainerUrl: batchTrainingFilesResultContainerUrl(),
+      resultContainerUrl:
+        process.env["DOCUMENT_INTELLIGENCE_BATCH_TRAINING_DATA_RESULT_CONTAINER_SAS_URL"],
       resultPrefix: "result",
     },
   });
@@ -174,6 +205,7 @@ const initialResponse = await client
 if (isUnexpected(initialResponse)) {
   throw initialResponse.body.error;
 }
+
 const resultId = parseResultIdFromResponse(initialResponse);
 console.log("resultId: ", resultId);
 
@@ -194,11 +226,14 @@ Supports output with Markdown content format along with the default plain _text_
 
 Service follows the GFM spec ([GitHub Flavored Markdown](https://github.github.com/gfm/)) for the Markdown format. Also introduces a new _contentFormat_ property with value "text" or "markdown" to indicate the result content format.
 
-```ts
+```ts snippet:ReadmeSampleAnalyzeMarkdownContentFormat
 import DocumentIntelligence from "@azure-rest/ai-document-intelligence";
-const client = DocumentIntelligence(process.env["DOCUMENT_INTELLIGENCE_ENDPOINT"], {
-  key: process.env["DOCUMENT_INTELLIGENCE_API_KEY"],
-});
+import { DefaultAzureCredential } from "@azure/identity";
+
+const client = DocumentIntelligence(
+  process.env["DOCUMENT_INTELLIGENCE_ENDPOINT"],
+  new DefaultAzureCredential(),
+);
 
 const initialResponse = await client
   .path("/documentModels/{modelId}:analyze", "prebuilt-layout")
@@ -216,7 +251,15 @@ const initialResponse = await client
 
 When this feature flag is specified, the service will further extract the values of the fields specified via the queryFields query parameter to supplement any existing fields defined by the model as fallback.
 
-```ts
+```ts snippet:ReadmeSampleAnalyzeQueryFields
+import DocumentIntelligence from "@azure-rest/ai-document-intelligence";
+import { DefaultAzureCredential } from "@azure/identity";
+
+const client = DocumentIntelligence(
+  process.env["DOCUMENT_INTELLIGENCE_ENDPOINT"],
+  new DefaultAzureCredential(),
+);
+
 await client.path("/documentModels/{modelId}:analyze", "prebuilt-layout").post({
   contentType: "application/json",
   body: { urlSource: "..." },
@@ -247,18 +290,24 @@ To enable a wider set of scenarios, service introduces a "split" query parameter
 
 ## Document Classifiers #Build
 
-```ts
-import {
-  DocumentClassifierBuildOperationDetailsOutput,
-  getLongRunningPoller,
+```ts snippet:ReadmeSampleDocumentClassifierBuild
+import DocumentIntelligence, {
   isUnexpected,
+  getLongRunningPoller,
+  DocumentClassifierBuildOperationDetailsOutput,
 } from "@azure-rest/ai-document-intelligence";
+import { DefaultAzureCredential } from "@azure/identity";
+
+const client = DocumentIntelligence(
+  process.env["DOCUMENT_INTELLIGENCE_ENDPOINT"],
+  new DefaultAzureCredential(),
+);
 
 const containerSasUrl = (): string =>
   process.env["DOCUMENT_INTELLIGENCE_TRAINING_CONTAINER_SAS_URL"];
 const initialResponse = await client.path("/documentClassifiers:build").post({
   body: {
-    classifierId: `customClassifier${getRandomNumber()}`,
+    classifierId: `customClassifier-12345`,
     description: "Custom classifier description",
     docTypes: {
       foo: {
@@ -278,33 +327,34 @@ const initialResponse = await client.path("/documentClassifiers:build").post({
 if (isUnexpected(initialResponse)) {
   throw initialResponse.body.error;
 }
+
 const poller = getLongRunningPoller(client, initialResponse);
 const response = (await poller.pollUntilDone())
   .body as DocumentClassifierBuildOperationDetailsOutput;
 console.log(response);
-//  {
-//    operationId: '31466834048_f3ee629e-73fb-48ab-993b-1d55d73ca460',
-//    kind: 'documentClassifierBuild',
-//    status: 'succeeded',
-//    .
-//    .
-//    result: {
-//      classifierId: 'customClassifier10978',
-//      createdDateTime: '2023-11-09T12:45:56Z',
-//      .
-//      .
-//      description: 'Custom classifier description'
-//    },
-//    apiVersion: '2023-10-31-preview'
-//  }
 ```
 
 ## Get the generated PDF output from document analysis
 
-```ts
-const filePath = path.join(ASSET_PATH, "layout-pageobject.pdf");
+```ts snippet:ReadmeSampleGetPdfOutput
+import DocumentIntelligence, {
+  isUnexpected,
+  getLongRunningPoller,
+  parseResultIdFromResponse,
+  streamToUint8Array,
+} from "@azure-rest/ai-document-intelligence";
+import { DefaultAzureCredential } from "@azure/identity";
+import { join } from "node:path";
+import { readFile, writeFile } from "node:fs/promises";
+
+const client = DocumentIntelligence(
+  process.env["DOCUMENT_INTELLIGENCE_ENDPOINT"],
+  new DefaultAzureCredential(),
+);
 
-const base64Source = await fs.readFile(filePath, { encoding: "base64" });
+const filePath = join("./assets", "layout-pageobject.pdf");
+
+const base64Source = await readFile(filePath, { encoding: "base64" });
 
 const initialResponse = await client
   .path("/documentModels/{modelId}:analyze", "prebuilt-read")
@@ -328,7 +378,7 @@ const output = await client
   .path(
     "/documentModels/{modelId}/analyzeResults/{resultId}/pdf",
     "prebuilt-read",
-    parseResultIdFromResponse(initialResponse)
+    parseResultIdFromResponse(initialResponse),
   )
   .get()
   .asNodeStream(); // output.body would be NodeJS.ReadableStream
@@ -338,16 +388,31 @@ if (output.status !== "200" || !output.body) {
 }
 
 const pdfData = await streamToUint8Array(output.body);
-fs.promises.writeFile(`./output.pdf`, pdfData);
-// Or you can consume the NodeJS.ReadableStream directly
+await writeFile(`./output.pdf`, pdfData);
 ```
 
 ## Get the generated cropped image of specified figure from document analysis
 
-```ts
-const filePath = path.join(ASSET_PATH, "layout-pageobject.pdf");
+```ts snippet:ReadmeSampleGetFigureImage
+import DocumentIntelligence, {
+  isUnexpected,
+  getLongRunningPoller,
+  AnalyzeOperationOutput,
+  parseResultIdFromResponse,
+  streamToUint8Array,
+} from "@azure-rest/ai-document-intelligence";
+import { DefaultAzureCredential } from "@azure/identity";
+import { join } from "node:path";
+import { readFile, writeFile } from "node:fs/promises";
 
-const base64Source = fs.readFileSync(filePath, { encoding: "base64" });
+const client = DocumentIntelligence(
+  process.env["DOCUMENT_INTELLIGENCE_ENDPOINT"],
+  new DefaultAzureCredential(),
+);
+
+const filePath = join("./assets", "layout-pageobject.pdf");
+
+const base64Source = await readFile(filePath, { encoding: "base64" });
 
 const initialResponse = await client
   .path("/documentModels/{modelId}:analyze", "prebuilt-layout")
@@ -363,21 +428,18 @@ if (isUnexpected(initialResponse)) {
   throw initialResponse.body.error;
 }
 
-const poller = getLongRunningPoller(client, initialResponse, { ...testPollingOptions });
+const poller = getLongRunningPoller(client, initialResponse);
 
-const result = (await poller.pollUntilDone()).body as AnalyzeResultOperationOutput;
+const result = (await poller.pollUntilDone()).body as AnalyzeOperationOutput;
 const figures = result.analyzeResult?.figures;
-assert.isArray(figures);
-assert.isNotEmpty(figures?.[0]);
 const figureId = figures?.[0].id || "";
-assert.isDefined(figureId);
 
 const output = await client
   .path(
     "/documentModels/{modelId}/analyzeResults/{resultId}/figures/{figureId}",
     "prebuilt-layout",
     parseResultIdFromResponse(initialResponse),
-    figureId
+    figureId,
   )
   .get()
   .asNodeStream(); // output.body would be NodeJS.ReadableStream
@@ -387,31 +449,44 @@ if (output.status !== "200" || !output.body) {
 }
 
 const imageData = await streamToUint8Array(output.body);
-fs.promises.writeFile(`./figures/${figureId}.png`, imageData);
-// Or you can consume the NodeJS.ReadableStream directly
+await writeFile(`./figures/${figureId}.png`, imageData);
 ```
 
 ## Get Info
 
-```ts
+```ts snippet:ReadmeSampleGetInfo
+import DocumentIntelligence, { isUnexpected } from "@azure-rest/ai-document-intelligence";
+import { DefaultAzureCredential } from "@azure/identity";
+
+const client = DocumentIntelligence(
+  process.env["DOCUMENT_INTELLIGENCE_ENDPOINT"],
+  new DefaultAzureCredential(),
+);
+
 const response = await client.path("/info").get();
 if (isUnexpected(response)) {
   throw response.body.error;
 }
+
 console.log(response.body.customDocumentModels.limit);
-// 20000
 ```
 
 ## List Document Models
 
-```ts
-import { paginate } from "@azure-rest/ai-document-intelligence";
+```ts snippet:ReadmeSampleListDocumentModels
+import DocumentIntelligence, { isUnexpected, paginate } from "@azure-rest/ai-document-intelligence";
+import { DefaultAzureCredential } from "@azure/identity";
+
+const client = DocumentIntelligence(
+  process.env["DOCUMENT_INTELLIGENCE_ENDPOINT"],
+  new DefaultAzureCredential(),
+);
+
 const response = await client.path("/documentModels").get();
 if (isUnexpected(response)) {
   throw response.body.error;
 }
 
-const modelsInAccount: string[] = [];
 for await (const model of paginate(client, response)) {
   console.log(model.modelId);
 }
@@ -423,8 +498,8 @@ for await (const model of paginate(client, response)) {
 
 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");
+```ts snippet:SetLogLevel
+import { setLogLevel } from "@azure/logger";
 
 setLogLevel("info");
 ```

package/dist/browser/audience.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Defines the known cloud audiences for Document Intelligence.
+ *
+ * To authenticate with Entra Id (using a `TokenCredential`) in a [Sovereign Cloud](https://learn.microsoft.com/en-us/entra/identity-platform/authentication-national-cloud)
+ * environment, provide the appropriate value below as the `audience` option when creating a
+ * `Document Intelligence` client.
+ *
+ * The default value is suitable for Document Intelligence resources created in the Azure Public Cloud, so this value
+ * is only required to use Document Intelligence in a different cloud environment.
+ */
+export declare enum KnownDocumentIntelligenceAudience {
+    /** Azure China */
+    AzureChina = "https://cognitiveservices.azure.cn",
+    /** Azure Government */
+    AzureGovernment = "https://cognitiveservices.azure.us",
+    /** Azure Public Cloud */
+    AzurePublicCloud = "https://cognitiveservices.azure.com"
+}
+//# sourceMappingURL=audience.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"audience.d.ts","sourceRoot":"","sources":["../../src/audience.ts"],"names":[],"mappings":"AAGA;;;;;;;;;GASG;AACH,oBAAY,iCAAiC;IAC3C,kBAAkB;IAClB,UAAU,uCAAuC;IACjD,uBAAuB;IACvB,eAAe,uCAAuC;IACtD,yBAAyB;IACzB,gBAAgB,wCAAwC;CACzD"}

package/dist/browser/audience.js

@@ -0,0 +1,22 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+/**
+ * Defines the known cloud audiences for Document Intelligence.
+ *
+ * To authenticate with Entra Id (using a `TokenCredential`) in a [Sovereign Cloud](https://learn.microsoft.com/en-us/entra/identity-platform/authentication-national-cloud)
+ * environment, provide the appropriate value below as the `audience` option when creating a
+ * `Document Intelligence` client.
+ *
+ * The default value is suitable for Document Intelligence resources created in the Azure Public Cloud, so this value
+ * is only required to use Document Intelligence in a different cloud environment.
+ */
+export var KnownDocumentIntelligenceAudience;
+(function (KnownDocumentIntelligenceAudience) {
+    /** Azure China */
+    KnownDocumentIntelligenceAudience["AzureChina"] = "https://cognitiveservices.azure.cn";
+    /** Azure Government */
+    KnownDocumentIntelligenceAudience["AzureGovernment"] = "https://cognitiveservices.azure.us";
+    /** Azure Public Cloud */
+    KnownDocumentIntelligenceAudience["AzurePublicCloud"] = "https://cognitiveservices.azure.com";
+})(KnownDocumentIntelligenceAudience || (KnownDocumentIntelligenceAudience = {}));
+//# sourceMappingURL=audience.js.map

package/dist/browser/audience.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"audience.js","sourceRoot":"","sources":["../../src/audience.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,kCAAkC;AAElC;;;;;;;;;GASG;AACH,MAAM,CAAN,IAAY,iCAOX;AAPD,WAAY,iCAAiC;IAC3C,kBAAkB;IAClB,sFAAiD,CAAA;IACjD,uBAAuB;IACvB,2FAAsD,CAAA;IACtD,yBAAyB;IACzB,6FAAwD,CAAA;AAC1D,CAAC,EAPW,iCAAiC,KAAjC,iCAAiC,QAO5C","sourcesContent":["// Copyright (c) Microsoft Corporation.\n// Licensed under the MIT License.\n\n/**\n * Defines the known cloud audiences for Document Intelligence.\n *\n * To authenticate with Entra Id (using a `TokenCredential`) in a [Sovereign Cloud](https://learn.microsoft.com/en-us/entra/identity-platform/authentication-national-cloud)\n * environment, provide the appropriate value below as the `audience` option when creating a\n * `Document Intelligence` client.\n *\n * The default value is suitable for Document Intelligence resources created in the Azure Public Cloud, so this value\n * is only required to use Document Intelligence in a different cloud environment.\n */\nexport enum KnownDocumentIntelligenceAudience {\n  /** Azure China */\n  AzureChina = \"https://cognitiveservices.azure.cn\",\n  /** Azure Government */\n  AzureGovernment = \"https://cognitiveservices.azure.us\",\n  /** Azure Public Cloud */\n  AzurePublicCloud = \"https://cognitiveservices.azure.com\",\n}\n"]}

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

@@ -1 +1 @@
-{"version":3,"file":"documentIntelligence.d.ts","sourceRoot":"","sources":["../../src/documentIntelligence.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAG7D,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACvE,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,wBAAwB,CAAC;AAEzE,6CAA6C;AAC7C,MAAM,WAAW,iCAAkC,SAAQ,aAAa;IACtE,2CAA2C;IAC3C,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;GAKG;AACH,MAAM,CAAC,OAAO,UAAU,YAAY,CAClC,aAAa,EAAE,MAAM,EACrB,WAAW,EAAE,eAAe,GAAG,aAAa,EAC5C,EAAE,UAAyB,EAAE,GAAG,OAAO,EAAE,GAAE,iCAAsC,GAChF,0BAA0B,CAyC5B"}
+{"version":3,"file":"documentIntelligence.d.ts","sourceRoot":"","sources":["../../src/documentIntelligence.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAG7D,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACvE,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,wBAAwB,CAAC;AAGzE,6CAA6C;AAC7C,MAAM,WAAW,iCAAkC,SAAQ,aAAa;IACtE,2CAA2C;IAC3C,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;GAKG;AACH,MAAM,CAAC,OAAO,UAAU,YAAY,CAClC,aAAa,EAAE,MAAM,EACrB,WAAW,EAAE,eAAe,GAAG,aAAa,EAC5C,EAAE,UAAyB,EAAE,GAAG,OAAO,EAAE,GAAE,iCAAsC,GAChF,0BAA0B,CA8C5B"}

package/dist/browser/documentIntelligence.js

@@ -3,6 +3,7 @@
 import { __rest } from "tslib";
 import { getClient } from "@azure-rest/core-client";
 import { logger } from "./logger.js";
+import { KnownDocumentIntelligenceAudience } from "./audience.js";
 /**
  * Initialize a new instance of `DocumentIntelligenceClient`
  * @param endpointParam - The Document Intelligence service endpoint.
@@ -13,7 +14,7 @@ export default function createClient(endpointParam, credentials, _a = {}) {
     var _b, _c, _d, _e, _f, _g, _h, _j;
     var { apiVersion = "2024-11-30" } = _a, options = __rest(_a, ["apiVersion"]);
     const endpointUrl = (_c = (_b = options.endpoint) !== null && _b !== void 0 ? _b : options.baseUrl) !== null && _c !== void 0 ? _c : `${endpointParam}/documentintelligence`;
-    const userAgentInfo = `azsdk-js-ai-document-intelligence-rest/1.0.0`;
+    const userAgentInfo = `azsdk-js-ai-document-intelligence-rest/1.1.0`;
     const userAgentPrefix = options.userAgentOptions && options.userAgentOptions.userAgentPrefix
         ? `${options.userAgentOptions.userAgentPrefix} ${userAgentInfo}`
         : `${userAgentInfo}`;
@@ -22,7 +23,11 @@ export default function createClient(endpointParam, credentials, _a = {}) {
         }, 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"],
+            scopes: ((_g = (_f = options.credentials) === null || _f === void 0 ? void 0 : _f.scopes) !== null && _g !== void 0 ? _g : [KnownDocumentIntelligenceAudience.AzurePublicCloud]).map((scope) => {
+                if (scope.endsWith("/.default"))
+                    return scope;
+                return `${scope}/.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 = getClient(endpointUrl, credentials, options);

package/dist/browser/documentIntelligence.js.map

@@ -1 +1 @@
-{"version":3,"file":"documentIntelligence.js","sourceRoot":"","sources":["../../src/documentIntelligence.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,kCAAkC;;AAGlC,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACpD,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAUrC;;;;;GAKG;AACH,MAAM,CAAC,OAAO,UAAU,YAAY,CAClC,aAAqB,EACrB,WAA4C,EAC5C,KAA+E,EAAE;;QAAjF,EAAE,UAAU,GAAG,YAAY,OAAsD,EAAjD,OAAO,cAAvC,cAAyC,CAAF;IAEvC,MAAM,WAAW,GACf,MAAA,MAAA,OAAO,CAAC,QAAQ,mCAAI,OAAO,CAAC,OAAO,mCAAI,GAAG,aAAa,uBAAuB,CAAC;IACjF,MAAM,aAAa,GAAG,8CAA8C,CAAC;IACrE,MAAM,eAAe,GACnB,OAAO,CAAC,gBAAgB,IAAI,OAAO,CAAC,gBAAgB,CAAC,eAAe;QAClE,CAAC,CAAC,GAAG,OAAO,CAAC,gBAAgB,CAAC,eAAe,IAAI,aAAa,EAAE;QAChE,CAAC,CAAC,GAAG,aAAa,EAAE,CAAC;IACzB,OAAO,mCACF,OAAO,KACV,gBAAgB,EAAE;YAChB,eAAe;SAChB,EACD,cAAc,EAAE;YACd,MAAM,EAAE,MAAA,MAAA,OAAO,CAAC,cAAc,0CAAE,MAAM,mCAAI,MAAM,CAAC,IAAI;SACtD,EACD,WAAW,EAAE;YACX,MAAM,EAAE,MAAA,MAAA,OAAO,CAAC,WAAW,0CAAE,MAAM,mCAAI,CAAC,8CAA8C,CAAC;YACvF,gBAAgB,EAAE,MAAA,MAAA,OAAO,CAAC,WAAW,0CAAE,gBAAgB,mCAAI,2BAA2B;SACvF,GACF,CAAC;IACF,MAAM,MAAM,GAAG,SAAS,CAAC,WAAW,EAAE,WAAW,EAAE,OAAO,CAA+B,CAAC;IAE1F,MAAM,CAAC,QAAQ,CAAC,YAAY,CAAC,EAAE,IAAI,EAAE,kBAAkB,EAAE,CAAC,CAAC;IAC3D,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC;QACxB,IAAI,EAAE,wBAAwB;QAC9B,WAAW,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE;YACzB,qDAAqD;YACrD,yEAAyE;YACzE,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YAC7B,IAAI,CAAC,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,aAAa,CAAC,IAAI,UAAU,EAAE,CAAC;gBACvD,GAAG,CAAC,GAAG,GAAG,GAAG,GAAG,CAAC,GAAG,GAClB,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GACzD,eAAe,UAAU,EAAE,CAAC;YAC9B,CAAC;YAED,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC;QACnB,CAAC;KACF,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC;AAChB,CAAC","sourcesContent":["// Copyright (c) Microsoft Corporation.\n// Licensed under the MIT License.\n\nimport type { ClientOptions } from \"@azure-rest/core-client\";\nimport { getClient } from \"@azure-rest/core-client\";\nimport { logger } from \"./logger.js\";\nimport type { TokenCredential, KeyCredential } from \"@azure/core-auth\";\nimport type { DocumentIntelligenceClient } from \"./clientDefinitions.js\";\n\n/** The optional parameters for the client */\nexport interface DocumentIntelligenceClientOptions extends ClientOptions {\n  /** The api version option of the client */\n  apiVersion?: string;\n}\n\n/**\n * Initialize a new instance of `DocumentIntelligenceClient`\n * @param endpointParam - The Document Intelligence service endpoint.\n * @param credentials - uniquely identify client credential\n * @param options - the parameter for all optional parameters\n */\nexport default function createClient(\n  endpointParam: string,\n  credentials: TokenCredential | KeyCredential,\n  { apiVersion = \"2024-11-30\", ...options }: DocumentIntelligenceClientOptions = {},\n): DocumentIntelligenceClient {\n  const endpointUrl =\n    options.endpoint ?? options.baseUrl ?? `${endpointParam}/documentintelligence`;\n  const userAgentInfo = `azsdk-js-ai-document-intelligence-rest/1.0.0`;\n  const userAgentPrefix =\n    options.userAgentOptions && options.userAgentOptions.userAgentPrefix\n      ? `${options.userAgentOptions.userAgentPrefix} ${userAgentInfo}`\n      : `${userAgentInfo}`;\n  options = {\n    ...options,\n    userAgentOptions: {\n      userAgentPrefix,\n    },\n    loggingOptions: {\n      logger: options.loggingOptions?.logger ?? logger.info,\n    },\n    credentials: {\n      scopes: options.credentials?.scopes ?? [\"https://cognitiveservices.azure.com/.default\"],\n      apiKeyHeaderName: options.credentials?.apiKeyHeaderName ?? \"Ocp-Apim-Subscription-Key\",\n    },\n  };\n  const client = getClient(endpointUrl, credentials, options) as DocumentIntelligenceClient;\n\n  client.pipeline.removePolicy({ name: \"ApiVersionPolicy\" });\n  client.pipeline.addPolicy({\n    name: \"ClientApiVersionPolicy\",\n    sendRequest: (req, next) => {\n      // Use the apiVersion defined in request url directly\n      // Append one if there is no apiVersion and we have one at client options\n      const url = new URL(req.url);\n      if (!url.searchParams.get(\"api-version\") && apiVersion) {\n        req.url = `${req.url}${\n          Array.from(url.searchParams.keys()).length > 0 ? \"&\" : \"?\"\n        }api-version=${apiVersion}`;\n      }\n\n      return next(req);\n    },\n  });\n\n  return client;\n}\n"]}
+{"version":3,"file":"documentIntelligence.js","sourceRoot":"","sources":["../../src/documentIntelligence.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,kCAAkC;;AAGlC,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACpD,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAGrC,OAAO,EAAE,iCAAiC,EAAE,MAAM,eAAe,CAAC;AAQlE;;;;;GAKG;AACH,MAAM,CAAC,OAAO,UAAU,YAAY,CAClC,aAAqB,EACrB,WAA4C,EAC5C,KAA+E,EAAE;;QAAjF,EAAE,UAAU,GAAG,YAAY,OAAsD,EAAjD,OAAO,cAAvC,cAAyC,CAAF;IAEvC,MAAM,WAAW,GACf,MAAA,MAAA,OAAO,CAAC,QAAQ,mCAAI,OAAO,CAAC,OAAO,mCAAI,GAAG,aAAa,uBAAuB,CAAC;IACjF,MAAM,aAAa,GAAG,8CAA8C,CAAC;IACrE,MAAM,eAAe,GACnB,OAAO,CAAC,gBAAgB,IAAI,OAAO,CAAC,gBAAgB,CAAC,eAAe;QAClE,CAAC,CAAC,GAAG,OAAO,CAAC,gBAAgB,CAAC,eAAe,IAAI,aAAa,EAAE;QAChE,CAAC,CAAC,GAAG,aAAa,EAAE,CAAC;IACzB,OAAO,mCACF,OAAO,KACV,gBAAgB,EAAE;YAChB,eAAe;SAChB,EACD,cAAc,EAAE;YACd,MAAM,EAAE,MAAA,MAAA,OAAO,CAAC,cAAc,0CAAE,MAAM,mCAAI,MAAM,CAAC,IAAI;SACtD,EACD,WAAW,EAAE;YACX,MAAM,EAAE,CACN,MAAA,MAAA,OAAO,CAAC,WAAW,0CAAE,MAAM,mCAAI,CAAC,iCAAiC,CAAC,gBAAgB,CAAC,CACpF,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;gBACd,IAAI,KAAK,CAAC,QAAQ,CAAC,WAAW,CAAC;oBAAE,OAAO,KAAK,CAAC;gBAC9C,OAAO,GAAG,KAAK,WAAW,CAAC;YAC7B,CAAC,CAAC;YACF,gBAAgB,EAAE,MAAA,MAAA,OAAO,CAAC,WAAW,0CAAE,gBAAgB,mCAAI,2BAA2B;SACvF,GACF,CAAC;IACF,MAAM,MAAM,GAAG,SAAS,CAAC,WAAW,EAAE,WAAW,EAAE,OAAO,CAA+B,CAAC;IAE1F,MAAM,CAAC,QAAQ,CAAC,YAAY,CAAC,EAAE,IAAI,EAAE,kBAAkB,EAAE,CAAC,CAAC;IAC3D,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC;QACxB,IAAI,EAAE,wBAAwB;QAC9B,WAAW,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE;YACzB,qDAAqD;YACrD,yEAAyE;YACzE,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YAC7B,IAAI,CAAC,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,aAAa,CAAC,IAAI,UAAU,EAAE,CAAC;gBACvD,GAAG,CAAC,GAAG,GAAG,GAAG,GAAG,CAAC,GAAG,GAClB,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GACzD,eAAe,UAAU,EAAE,CAAC;YAC9B,CAAC;YAED,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC;QACnB,CAAC;KACF,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC;AAChB,CAAC","sourcesContent":["// Copyright (c) Microsoft Corporation.\n// Licensed under the MIT License.\n\nimport type { ClientOptions } from \"@azure-rest/core-client\";\nimport { getClient } from \"@azure-rest/core-client\";\nimport { logger } from \"./logger.js\";\nimport type { TokenCredential, KeyCredential } from \"@azure/core-auth\";\nimport type { DocumentIntelligenceClient } from \"./clientDefinitions.js\";\nimport { KnownDocumentIntelligenceAudience } from \"./audience.js\";\n\n/** The optional parameters for the client */\nexport interface DocumentIntelligenceClientOptions extends ClientOptions {\n  /** The api version option of the client */\n  apiVersion?: string;\n}\n\n/**\n * Initialize a new instance of `DocumentIntelligenceClient`\n * @param endpointParam - The Document Intelligence service endpoint.\n * @param credentials - uniquely identify client credential\n * @param options - the parameter for all optional parameters\n */\nexport default function createClient(\n  endpointParam: string,\n  credentials: TokenCredential | KeyCredential,\n  { apiVersion = \"2024-11-30\", ...options }: DocumentIntelligenceClientOptions = {},\n): DocumentIntelligenceClient {\n  const endpointUrl =\n    options.endpoint ?? options.baseUrl ?? `${endpointParam}/documentintelligence`;\n  const userAgentInfo = `azsdk-js-ai-document-intelligence-rest/1.1.0`;\n  const userAgentPrefix =\n    options.userAgentOptions && options.userAgentOptions.userAgentPrefix\n      ? `${options.userAgentOptions.userAgentPrefix} ${userAgentInfo}`\n      : `${userAgentInfo}`;\n  options = {\n    ...options,\n    userAgentOptions: {\n      userAgentPrefix,\n    },\n    loggingOptions: {\n      logger: options.loggingOptions?.logger ?? logger.info,\n    },\n    credentials: {\n      scopes: (\n        options.credentials?.scopes ?? [KnownDocumentIntelligenceAudience.AzurePublicCloud]\n      ).map((scope) => {\n        if (scope.endsWith(\"/.default\")) return scope;\n        return `${scope}/.default`;\n      }),\n      apiKeyHeaderName: options.credentials?.apiKeyHeaderName ?? \"Ocp-Apim-Subscription-Key\",\n    },\n  };\n  const client = getClient(endpointUrl, credentials, options) as DocumentIntelligenceClient;\n\n  client.pipeline.removePolicy({ name: \"ApiVersionPolicy\" });\n  client.pipeline.addPolicy({\n    name: \"ClientApiVersionPolicy\",\n    sendRequest: (req, next) => {\n      // Use the apiVersion defined in request url directly\n      // Append one if there is no apiVersion and we have one at client options\n      const url = new URL(req.url);\n      if (!url.searchParams.get(\"api-version\") && apiVersion) {\n        req.url = `${req.url}${\n          Array.from(url.searchParams.keys()).length > 0 ? \"&\" : \"?\"\n        }api-version=${apiVersion}`;\n      }\n\n      return next(req);\n    },\n  });\n\n  return client;\n}\n"]}

package/dist/browser/index.d.ts

@@ -9,5 +9,6 @@ export * from "./outputModels.js";
 export * from "./paginateHelper.js";
 export * from "./pollingHelper.js";
 export * from "./utils.js";
+export { KnownDocumentIntelligenceAudience } from "./audience.js";
 export default DocumentIntelligence;
 //# sourceMappingURL=index.d.ts.map