Soft Deprecation

lib/iotidentity/iotidentityclient.ts

@@ -14,6 +14,7 @@ import * as model from "./model";
 import { mqtt, mqtt5 } from "aws-crt";
 import { toUtf8 } from "@aws-sdk/util-utf8-browser"
 import * as service_client_mqtt_adapter from "../service_client_mqtt_adapter";
+import type { IotIdentityClientv2 } from "./iotidentityclientv2";
 
 /**
  * Error subclass for IotIdentity service errors
@@ -36,6 +37,11 @@ export class IotIdentityError extends Error {
 }
 
 /**
+ * @deprecated We strongly recommend using {@link IotIdentityClientv2}.
+ * There are no current plans to fully deprecate IotIdentityClient but it is highly
+ * recommended customers migrate to IotIdentityClientV2.
+ * More details can be found in the GitHub Repo FAQ.
+ *
  * An AWS IoT service that assists with provisioning a device and installing unique client certificates on it
  *
  * AWS documentation: https://docs.aws.amazon.com/iot/latest/developerguide/provision-wo-cert.html

lib/iotjobs/iotjobsclient.ts

@@ -14,6 +14,7 @@ import * as model from "./model";
 import { mqtt, mqtt5 } from "aws-crt";
 import { toUtf8 } from "@aws-sdk/util-utf8-browser"
 import * as service_client_mqtt_adapter from "../service_client_mqtt_adapter";
+import type { IotJobsClientv2 } from "./iotjobsclientv2";
 
 /**
  * Error subclass for IotJobs service errors
@@ -36,6 +37,11 @@ export class IotJobsError extends Error {
 }
 
 /**
+ * @deprecated We strongly recommend using {@link IotJobsClientv2}.
+ * There are no current plans to fully deprecate IotJobsClient but it is highly
+ * recommended customers migrate to IotJobsClientV2.
+ * More details can be found in the GitHub Repo FAQ.
+ *
  * The AWS IoT jobs service can be used to define a set of remote operations that are sent to and executed on one or more devices connected to AWS IoT.
  *
  * AWS documentation: https://docs.aws.amazon.com/iot/latest/developerguide/jobs-api.html#jobs-mqtt-api

lib/iotshadow/iotshadowclient.ts

@@ -14,6 +14,7 @@ import * as model from "./model";
 import { mqtt, mqtt5 } from "aws-crt";
 import { toUtf8 } from "@aws-sdk/util-utf8-browser"
 import * as service_client_mqtt_adapter from "../service_client_mqtt_adapter";
+import type { IotShadowClientv2 } from "./iotshadowclientv2";
 
 /**
  * Error subclass for IotShadow service errors
@@ -36,6 +37,11 @@ export class IotShadowError extends Error {
 }
 
 /**
+ * @deprecated We strongly recommend using {@link IotShadowClientv2}.
+ * There are no current plans to fully deprecate IotShadowClient but it is highly
+ * recommended customers migrate to IotShadowClientV2.
+ * More details can be found in the GitHub Repo FAQ.
+ *
  * The AWS IoT Device Shadow service adds shadows to AWS IoT thing objects. Shadows are a simple data store for device properties and state.  Shadows can make a device’s state available to apps and other services whether the device is connected to AWS IoT or not.
  *
  * AWS documentation: https://docs.aws.amazon.com/iot/latest/developerguide/device-shadow-mqtt.html