Merge pull request #318 from oracle/release_2024-09-17

Releasing version 2.94.0

Author: JoshuaWR

CHANGELOG.md

@@ -3,6 +3,18 @@
 All notable changes to this project will be documented in this file.
 
 The format is based on [Keep a Changelog](http://keepachangelog.com/).
+## 2.94.0 - 2024-09-17
+### Added 
+- Support for calling Oracle Cloud Infrastructure services in the eu-crissier-1 region 
+- Support for dedicated AI cluster unit shapes in the Generative AI service 
+- Support for ticket numbers when creating access requests in the Managed Access service 
+- Support for 23ai database, cloud VM clusters and VM cluster patching in the Exadata Fleet Update service 
+- Support for text to speech feature in the AI Speech service 
+- Support for notifications and transfer of capacity requests in the OCI Control Center service    
+
+### Breaking Changes 
+- The field `occCustomerGroupId` was made mandatory in the models `ListInternalNamespaceOccOverviewsRequest`, `ListOccAvailabilityCatalogsInternalRequest`, and `ListOccCapacityRequestsInternalRequest` in the OCI Control Center service
+
 ## 2.93.0 - 2024-08-27
 ### Added 
 - Support for Delegate Access Control service 

lib/accessgovernancecp/package.json

@@ -1,6 +1,6 @@
 {
   "name": "oci-accessgovernancecp",
-  "version": "2.93.0",
+  "version": "2.94.0",
   "description": "OCI NodeJS client for Access Governance Cp Service",
   "repository": {
     "type": "git",

lib/adm/package.json

@@ -1,6 +1,6 @@
 {
   "name": "oci-adm",
-  "version": "2.93.0",
+  "version": "2.94.0",
   "description": "OCI NodeJS client for Adm Service",
   "repository": {
     "type": "git",

lib/aianomalydetection/package.json

@@ -1,6 +1,6 @@
 {
   "name": "oci-aianomalydetection",
-  "version": "2.93.0",
+  "version": "2.94.0",
   "description": "OCI NodeJS client for Ai Anomaly Detection Service",
   "repository": {
     "type": "git",

lib/aidocument/package.json

@@ -1,6 +1,6 @@
 {
   "name": "oci-aidocument",
-  "version": "2.93.0",
+  "version": "2.94.0",
   "description": "OCI NodeJS client for Ai Document Service",
   "repository": {
     "type": "git",

lib/ailanguage/package.json

@@ -1,6 +1,6 @@
 {
   "name": "oci-ailanguage",
-  "version": "2.93.0",
+  "version": "2.94.0",
   "description": "OCI NodeJS client for Ai Language Service",
   "repository": {
     "type": "git",

lib/aispeech/lib/client.ts

@@ -1404,6 +1404,155 @@ export class AIServiceSpeechClient {
     }
   }
 
+  /**
+   * Returns a list of speakers available to the user to choose from based on language code and voice type provided.
+   *
+   * This operation does not retry by default if the user has not defined a retry configuration.
+   * @param ListVoicesRequest
+   * @return ListVoicesResponse
+   * @throws OciError when an error occurs
+   * @example Click {@link https://docs.cloud.oracle.com/en-us/iaas/tools/typescript-sdk-examples/latest/aispeech/ListVoices.ts.html |here} to see how to use ListVoices API.
+   */
+  public async listVoices(
+    listVoicesRequest: requests.ListVoicesRequest
+  ): Promise<responses.ListVoicesResponse> {
+    if (this.logger) this.logger.debug("Calling operation AIServiceSpeechClient#listVoices.");
+    const operationName = "listVoices";
+    const apiReferenceLink =
+      "https://docs.oracle.com/iaas/api/#/en/speech/20220101/Voice/ListVoices";
+    const pathParams = {};
+
+    const queryParams = {
+      "compartmentId": listVoicesRequest.compartmentId,
+      "modelName": listVoicesRequest.modelName,
+      "displayName": listVoicesRequest.displayName
+    };
+
+    let headerParams = {
+      "Content-Type": common.Constants.APPLICATION_JSON,
+      "opc-request-id": listVoicesRequest.opcRequestId
+    };
+
+    const specRetryConfiguration = common.NoRetryConfigurationDetails;
+    const retrier = GenericRetrier.createPreferredRetrier(
+      this._clientConfiguration ? this._clientConfiguration.retryConfiguration : undefined,
+      listVoicesRequest.retryConfiguration,
+      specRetryConfiguration
+    );
+    if (this.logger) retrier.logger = this.logger;
+    const request = await composeRequest({
+      baseEndpoint: this._endpoint,
+      defaultHeaders: this._defaultHeaders,
+      path: "/voices",
+      method: "GET",
+      pathParams: pathParams,
+      headerParams: headerParams,
+      queryParams: queryParams
+    });
+    try {
+      const response = await retrier.makeServiceCall(
+        this._httpClient,
+        request,
+        this.targetService,
+        operationName,
+        apiReferenceLink
+      );
+      const sdkResponse = composeResponse({
+        responseObject: <responses.ListVoicesResponse>{},
+        body: await response.json(),
+        bodyKey: "voiceCollection",
+        bodyModel: model.VoiceCollection,
+        type: "model.VoiceCollection",
+        responseHeaders: [
+          {
+            value: response.headers.get("opc-request-id"),
+            key: "opcRequestId",
+            dataType: "string"
+          }
+        ]
+      });
+
+      return sdkResponse;
+    } catch (err) {
+      throw err;
+    }
+  }
+
+  /**
+   * Creates an audio for the given input text based on other input parameters like language, voice type, etc.
+   *
+   * This operation does not retry by default if the user has not defined a retry configuration.
+   * @param SynthesizeSpeechRequest
+   * @return SynthesizeSpeechResponse
+   * @throws OciError when an error occurs
+   * @example Click {@link https://docs.cloud.oracle.com/en-us/iaas/tools/typescript-sdk-examples/latest/aispeech/SynthesizeSpeech.ts.html |here} to see how to use SynthesizeSpeech API.
+   */
+  public async synthesizeSpeech(
+    synthesizeSpeechRequest: requests.SynthesizeSpeechRequest
+  ): Promise<responses.SynthesizeSpeechResponse> {
+    if (this.logger) this.logger.debug("Calling operation AIServiceSpeechClient#synthesizeSpeech.");
+    const operationName = "synthesizeSpeech";
+    const apiReferenceLink =
+      "https://docs.oracle.com/iaas/api/#/en/speech/20220101/SynthesizeSpeech/SynthesizeSpeech";
+    const pathParams = {};
+
+    const queryParams = {};
+
+    let headerParams = {
+      "Content-Type": common.Constants.APPLICATION_JSON,
+      "opc-request-id": synthesizeSpeechRequest.opcRequestId
+    };
+
+    const specRetryConfiguration = common.NoRetryConfigurationDetails;
+    const retrier = GenericRetrier.createPreferredRetrier(
+      this._clientConfiguration ? this._clientConfiguration.retryConfiguration : undefined,
+      synthesizeSpeechRequest.retryConfiguration,
+      specRetryConfiguration
+    );
+    if (this.logger) retrier.logger = this.logger;
+    const request = await composeRequest({
+      baseEndpoint: this._endpoint,
+      defaultHeaders: this._defaultHeaders,
+      path: "/actions/synthesizeSpeech",
+      method: "POST",
+      bodyContent: common.ObjectSerializer.serialize(
+        synthesizeSpeechRequest.synthesizeSpeechDetails,
+        "SynthesizeSpeechDetails",
+        model.SynthesizeSpeechDetails.getJsonObj
+      ),
+      pathParams: pathParams,
+      headerParams: headerParams,
+      queryParams: queryParams
+    });
+    try {
+      const response = await retrier.makeServiceCall(
+        this._httpClient,
+        request,
+        this.targetService,
+        operationName,
+        apiReferenceLink
+      );
+      const sdkResponse = composeResponse({
+        responseObject: <responses.SynthesizeSpeechResponse>{},
+
+        body: response.body!,
+        bodyKey: "value",
+        bodyModel: "string",
+        responseHeaders: [
+          {
+            value: response.headers.get("opc-request-id"),
+            key: "opcRequestId",
+            dataType: "string"
+          }
+        ]
+      });
+
+      return sdkResponse;
+    } catch (err) {
+      throw err;
+    }
+  }
+
   /**
    * Updates a Customization by identifier
    * This operation does not retry by default if the user has not defined a retry configuration.

lib/aispeech/lib/model/index.ts

@@ -75,6 +75,8 @@ import * as RealtimeSessionToken from "./realtime-session-token";
 export import RealtimeSessionToken = RealtimeSessionToken.RealtimeSessionToken;
 import * as SortOrder from "./sort-order";
 export import SortOrder = SortOrder.SortOrder;
+import * as SynthesizeSpeechDetails from "./synthesize-speech-details";
+export import SynthesizeSpeechDetails = SynthesizeSpeechDetails.SynthesizeSpeechDetails;
 import * as TranscriptionFilter from "./transcription-filter";
 export import TranscriptionFilter = TranscriptionFilter.TranscriptionFilter;
 import * as TranscriptionJob from "./transcription-job";
@@ -95,10 +97,22 @@ import * as TranscriptionTaskCollection from "./transcription-task-collection";
 export import TranscriptionTaskCollection = TranscriptionTaskCollection.TranscriptionTaskCollection;
 import * as TranscriptionTaskSummary from "./transcription-task-summary";
 export import TranscriptionTaskSummary = TranscriptionTaskSummary.TranscriptionTaskSummary;
+import * as TtsAudioConfig from "./tts-audio-config";
+export import TtsAudioConfig = TtsAudioConfig.TtsAudioConfig;
+import * as TtsConfiguration from "./tts-configuration";
+export import TtsConfiguration = TtsConfiguration.TtsConfiguration;
+import * as TtsOracleModelDetails from "./tts-oracle-model-details";
+export import TtsOracleModelDetails = TtsOracleModelDetails.TtsOracleModelDetails;
+import * as TtsOracleSpeechSettings from "./tts-oracle-speech-settings";
+export import TtsOracleSpeechSettings = TtsOracleSpeechSettings.TtsOracleSpeechSettings;
 import * as UpdateCustomizationDetails from "./update-customization-details";
 export import UpdateCustomizationDetails = UpdateCustomizationDetails.UpdateCustomizationDetails;
 import * as UpdateTranscriptionJobDetails from "./update-transcription-job-details";
 export import UpdateTranscriptionJobDetails = UpdateTranscriptionJobDetails.UpdateTranscriptionJobDetails;
+import * as VoiceCollection from "./voice-collection";
+export import VoiceCollection = VoiceCollection.VoiceCollection;
+import * as VoiceSummary from "./voice-summary";
+export import VoiceSummary = VoiceSummary.VoiceSummary;
 
 import * as EntityListDataset from "./entity-list-dataset";
 export import EntityListDataset = EntityListDataset.EntityListDataset;
@@ -126,3 +140,11 @@ import * as RealtimeMessageResult from "./realtime-message-result";
 export import RealtimeMessageResult = RealtimeMessageResult.RealtimeMessageResult;
 import * as RealtimeMessageSendFinalResult from "./realtime-message-send-final-result";
 export import RealtimeMessageSendFinalResult = RealtimeMessageSendFinalResult.RealtimeMessageSendFinalResult;
+import * as TtsBaseAudioConfig from "./tts-base-audio-config";
+export import TtsBaseAudioConfig = TtsBaseAudioConfig.TtsBaseAudioConfig;
+import * as TtsOracleConfiguration from "./tts-oracle-configuration";
+export import TtsOracleConfiguration = TtsOracleConfiguration.TtsOracleConfiguration;
+import * as TtsOracleTts1StandardModelDetails from "./tts-oracle-tts1-standard-model-details";
+export import TtsOracleTts1StandardModelDetails = TtsOracleTts1StandardModelDetails.TtsOracleTts1StandardModelDetails;
+import * as TtsOracleTts2NaturalModelDetails from "./tts-oracle-tts2-natural-model-details";
+export import TtsOracleTts2NaturalModelDetails = TtsOracleTts2NaturalModelDetails.TtsOracleTts2NaturalModelDetails;

lib/aispeech/lib/model/synthesize-speech-details.ts

@@ -0,0 +1,71 @@
+/**
+ * Speech API
+ * The OCI Speech Service harnesses the power of spoken language by allowing developers to easily convert file-based data containing human speech into highly accurate text transcriptions.
+ * OpenAPI spec version: 20220101
+ *
+ *
+ * NOTE: This class is auto generated by OracleSDKGenerator.
+ * Do not edit the class manually.
+ *
+ * Copyright (c) 2020, 2024, Oracle and/or its affiliates.  All rights reserved.
+ * This software is dual-licensed to you under the Universal Permissive License (UPL) 1.0 as shown at https://oss.oracle.com/licenses/upl or Apache License 2.0 as shown at http://www.apache.org/licenses/LICENSE-2.0. You may choose either license.
+ */
+
+import * as model from "../model";
+import common = require("oci-common");
+
+/**
+ * Input JSON to get audio inference from TTS Service.
+ */
+export interface SynthesizeSpeechDetails {
+  /**
+   * The text input to get the inference audio from TTS Service.
+   */
+  "text": string;
+  /**
+   * If set to true, response will be sent in the chunked transfer-encoding and audio chunks
+   * are sent back as and when they are ready. If set to false, response will be sent only once
+   * the entire audio is generated.
+   *
+   */
+  "isStreamEnabled"?: boolean;
+  /**
+   * The [OCID](https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm) of the compartment where the user has access to call {@code SpeechSynthesize} api. But default user access will be checked at tenancy level.
+   */
+  "compartmentId"?: string;
+  "configuration"?: model.TtsOracleConfiguration;
+  "audioConfig"?: model.TtsBaseAudioConfig;
+}
+
+export namespace SynthesizeSpeechDetails {
+  export function getJsonObj(obj: SynthesizeSpeechDetails): object {
+    const jsonObj = {
+      ...obj,
+      ...{
+        "configuration": obj.configuration
+          ? model.TtsConfiguration.getJsonObj(obj.configuration)
+          : undefined,
+        "audioConfig": obj.audioConfig
+          ? model.TtsAudioConfig.getJsonObj(obj.audioConfig)
+          : undefined
+      }
+    };
+
+    return jsonObj;
+  }
+  export function getDeserializedJsonObj(obj: SynthesizeSpeechDetails): object {
+    const jsonObj = {
+      ...obj,
+      ...{
+        "configuration": obj.configuration
+          ? model.TtsConfiguration.getDeserializedJsonObj(obj.configuration)
+          : undefined,
+        "audioConfig": obj.audioConfig
+          ? model.TtsAudioConfig.getDeserializedJsonObj(obj.audioConfig)
+          : undefined
+      }
+    };
+
+    return jsonObj;
+  }
+}

lib/aispeech/lib/model/tts-audio-config.ts

@@ -0,0 +1,59 @@
+/**
+ * Speech API
+ * The OCI Speech Service harnesses the power of spoken language by allowing developers to easily convert file-based data containing human speech into highly accurate text transcriptions.
+ * OpenAPI spec version: 20220101
+ *
+ *
+ * NOTE: This class is auto generated by OracleSDKGenerator.
+ * Do not edit the class manually.
+ *
+ * Copyright (c) 2020, 2024, Oracle and/or its affiliates.  All rights reserved.
+ * This software is dual-licensed to you under the Universal Permissive License (UPL) 1.0 as shown at https://oss.oracle.com/licenses/upl or Apache License 2.0 as shown at http://www.apache.org/licenses/LICENSE-2.0. You may choose either license.
+ */
+
+import * as model from "../model";
+import common = require("oci-common");
+
+/**
+ * Use this schema to specify handling of audio response.
+ * If audioConfig is not provided, raw response is handed over for the user to handle.
+ *
+ */
+export interface TtsAudioConfig {
+  "configType": string;
+}
+
+export namespace TtsAudioConfig {
+  export function getJsonObj(obj: TtsAudioConfig): object {
+    const jsonObj = { ...obj, ...{} };
+
+    if (obj && "configType" in obj && obj.configType) {
+      switch (obj.configType) {
+        case "BASE_AUDIO_CONFIG":
+          return model.TtsBaseAudioConfig.getJsonObj(
+            <model.TtsBaseAudioConfig>(<object>jsonObj),
+            true
+          );
+        default:
+          if (common.LOG.logger) common.LOG.logger.info(`Unknown value for: ${obj.configType}`);
+      }
+    }
+    return jsonObj;
+  }
+  export function getDeserializedJsonObj(obj: TtsAudioConfig): object {
+    const jsonObj = { ...obj, ...{} };
+
+    if (obj && "configType" in obj && obj.configType) {
+      switch (obj.configType) {
+        case "BASE_AUDIO_CONFIG":
+          return model.TtsBaseAudioConfig.getDeserializedJsonObj(
+            <model.TtsBaseAudioConfig>(<object>jsonObj),
+            true
+          );
+        default:
+          if (common.LOG.logger) common.LOG.logger.info(`Unknown value for: ${obj.configType}`);
+      }
+    }
+    return jsonObj;
+  }
+}