@scaleway/sdk 2.0.0-alpha.13 → 2.0.0-alpha.15

package/dist/api/instance/v1/marshalling.utils.js

@@ -0,0 +1,63 @@
+const marshalVolumeSummary = (request, defaults) => ({
+  id: request.id,
+  name: request.name,
+  size: request.size,
+  volume_type: request.volumeType
+});
+const marshalServerSummary = (request, defaults) => ({
+  id: request.id,
+  name: request.name
+});
+const marshalBootscript = (request, defaults) => ({
+  arch: request.arch,
+  bootcmdargs: request.bootcmdargs,
+  default: request.default,
+  dtb: request.dtb,
+  id: request.id,
+  initrd: request.initrd,
+  kernel: request.kernel,
+  organization: request.organization,
+  project: request.project,
+  public: request.public,
+  title: request.title,
+  zone: request.zone
+});
+const marshalVolume = (request, defaults) => ({
+  creation_date: request.creationDate,
+  export_uri: request.exportUri,
+  id: request.id,
+  modification_date: request.modificationDate,
+  name: request.name,
+  organization: request.organization,
+  project: request.project,
+  server: request.server ? marshalServerSummary(request.server) : undefined,
+  size: request.size,
+  state: request.state,
+  tags: request.tags,
+  volume_type: request.volumeType,
+  zone: request.zone
+});
+const marshalSetImageRequestWithID = (request, defaults) => ({
+  arch: request.arch,
+  creation_date: request.creationDate,
+  default_bootscript: request.defaultBootscript ? marshalBootscript(request.defaultBootscript) : undefined,
+  extra_volumes: request.extraVolumes ? Object.entries(request.extraVolumes).reduce((acc, _ref) => {
+    let [key, value] = _ref;
+    return {
+      ...acc,
+      [key]: marshalVolume(value)
+    };
+  }, {}) : undefined,
+  from_server: request.fromServer,
+  modification_date: request.modificationDate,
+  id: request.id,
+  name: request.name,
+  organization: request.organization,
+  project: request.project,
+  public: request.public,
+  root_volume: request.rootVolume ? marshalVolumeSummary(request.rootVolume) : undefined,
+  state: request.state,
+  tags: request.tags
+});
+
+export { marshalSetImageRequestWithID };

package/dist/api/iot/index.js

@@ -0,0 +1,2 @@
+import * as index_gen from './v1/index.gen.js';
+export { index_gen as v1 };

package/dist/api/iot/v1/api.gen.js

@@ -0,0 +1,573 @@
+import { waitForResource } from '../../../internal/async/interval-retrier.js';
+import { API as API$1 } from '../../../scw/api.js';
+import { validatePathParam, urlParams } from '../../../helpers/marshalling.js';
+import { enrichForPagination } from '../../../scw/fetch/resource-paginator.js';
+import { HUB_TRANSIENT_STATUSES } from './content.gen.js';
+import { unmarshalListHubsResponse, marshalCreateHubRequest, unmarshalHub, marshalUpdateHubRequest, unmarshalGetHubMetricsResponse, marshalSetHubCARequest, unmarshalGetHubCAResponse, unmarshalListDevicesResponse, marshalCreateDeviceRequest, unmarshalCreateDeviceResponse, unmarshalDevice, marshalUpdateDeviceRequest, unmarshalRenewDeviceCertificateResponse, marshalSetDeviceCertificateRequest, unmarshalSetDeviceCertificateResponse, unmarshalGetDeviceCertificateResponse, unmarshalGetDeviceMetricsResponse, unmarshalListRoutesResponse, marshalCreateRouteRequest, unmarshalRoute, marshalUpdateRouteRequest, unmarshalListNetworksResponse, marshalCreateNetworkRequest, unmarshalCreateNetworkResponse, unmarshalNetwork, unmarshalTwinDocument, marshalPutTwinDocumentRequest, marshalPatchTwinDocumentRequest, unmarshalListTwinDocumentsResponse } from './marshalling.gen.js';
+
+// This file was automatically generated. DO NOT EDIT.
+// If you have any remark or suggestion do not hesitate to open an issue.
+const jsonContentHeaders = {
+  'Content-Type': 'application/json; charset=utf-8'
+};
+
+/**
+ * IoT Hub API.
+ *
+ * This API allows you to manage IoT hubs and devices.
+ */
+class API extends API$1 {
+  /** Lists the available regions of the API. */
+  static LOCALITIES = ['fr-par'];
+  pageOfListHubs = (() => {
+    var _this = this;
+    return function (request) {
+      if (request === void 0) {
+        request = {};
+      }
+      return _this.client.fetch({
+        method: 'GET',
+        path: `/iot/v1/regions/${validatePathParam('region', request.region ?? _this.client.settings.defaultRegion)}/hubs`,
+        urlParams: urlParams(['name', request.name], ['order_by', request.orderBy], ['organization_id', request.organizationId], ['page', request.page], ['page_size', request.pageSize ?? _this.client.settings.defaultPageSize], ['project_id', request.projectId])
+      }, unmarshalListHubsResponse);
+    };
+  })();
+
+  /**
+   * List hubs. List all Hubs in the specified zone. By default, returned Hubs
+   * are ordered by creation date in ascending order, though this can be
+   * modified via the `order_by` field.
+   *
+   * @param request - The request {@link ListHubsRequest}
+   * @returns A Promise of ListHubsResponse
+   */
+  listHubs = (() => {
+    var _this2 = this;
+    return function (request) {
+      if (request === void 0) {
+        request = {};
+      }
+      return enrichForPagination('hubs', _this2.pageOfListHubs, request);
+    };
+  })();
+
+  /**
+   * Create a hub. Create a new Hub in the targeted region, specifying its
+   * configuration including name and product plan.
+   *
+   * @param request - The request {@link CreateHubRequest}
+   * @returns A Promise of Hub
+   */
+  createHub = request => this.client.fetch({
+    body: JSON.stringify(marshalCreateHubRequest(request, this.client.settings)),
+    headers: jsonContentHeaders,
+    method: 'POST',
+    path: `/iot/v1/regions/${validatePathParam('region', request.region ?? this.client.settings.defaultRegion)}/hubs`
+  }, unmarshalHub);
+
+  /**
+   * Get a hub. Retrieve information about an existing IoT Hub, specified by its
+   * Hub ID. Its full details, including name, status and endpoint, are returned
+   * in the response object.
+   *
+   * @param request - The request {@link GetHubRequest}
+   * @returns A Promise of Hub
+   */
+  getHub = request => this.client.fetch({
+    method: 'GET',
+    path: `/iot/v1/regions/${validatePathParam('region', request.region ?? this.client.settings.defaultRegion)}/hubs/${validatePathParam('hubId', request.hubId)}`
+  }, unmarshalHub);
+
+  /**
+   * Waits for {@link Hub} to be in a final state.
+   *
+   * @param request - The request {@link GetHubRequest}
+   * @param options - The waiting options
+   * @returns A Promise of Hub
+   */
+  waitForHub = (request, options) => waitForResource(options?.stop ?? (res => Promise.resolve(!HUB_TRANSIENT_STATUSES.includes(res.status))), this.getHub, request, options);
+
+  /**
+   * Update a hub. Update the parameters of an existing IoT Hub, specified by
+   * its Hub ID.
+   *
+   * @param request - The request {@link UpdateHubRequest}
+   * @returns A Promise of Hub
+   */
+  updateHub = request => this.client.fetch({
+    body: JSON.stringify(marshalUpdateHubRequest(request, this.client.settings)),
+    headers: jsonContentHeaders,
+    method: 'PATCH',
+    path: `/iot/v1/regions/${validatePathParam('region', request.region ?? this.client.settings.defaultRegion)}/hubs/${validatePathParam('hubId', request.hubId)}`
+  }, unmarshalHub);
+
+  /**
+   * Enable a hub. Enable an existing IoT Hub, specified by its Hub ID.
+   *
+   * @param request - The request {@link EnableHubRequest}
+   * @returns A Promise of Hub
+   */
+  enableHub = request => this.client.fetch({
+    body: '{}',
+    headers: jsonContentHeaders,
+    method: 'POST',
+    path: `/iot/v1/regions/${validatePathParam('region', request.region ?? this.client.settings.defaultRegion)}/hubs/${validatePathParam('hubId', request.hubId)}/enable`
+  }, unmarshalHub);
+
+  /**
+   * Disable a hub. Disable an existing IoT Hub, specified by its Hub ID.
+   *
+   * @param request - The request {@link DisableHubRequest}
+   * @returns A Promise of Hub
+   */
+  disableHub = request => this.client.fetch({
+    body: '{}',
+    headers: jsonContentHeaders,
+    method: 'POST',
+    path: `/iot/v1/regions/${validatePathParam('region', request.region ?? this.client.settings.defaultRegion)}/hubs/${validatePathParam('hubId', request.hubId)}/disable`
+  }, unmarshalHub);
+
+  /**
+   * Delete a hub. Delete an existing IoT Hub, specified by its Hub ID. Deleting
+   * a Hub is permanent, and cannot be undone.
+   *
+   * @param request - The request {@link DeleteHubRequest}
+   */
+  deleteHub = request => this.client.fetch({
+    method: 'DELETE',
+    path: `/iot/v1/regions/${validatePathParam('region', request.region ?? this.client.settings.defaultRegion)}/hubs/${validatePathParam('hubId', request.hubId)}`,
+    urlParams: urlParams(['delete_devices', request.deleteDevices])
+  });
+
+  /**
+   * Get a hub's metrics. Get the metrics of an existing IoT Hub, specified by
+   * its Hub ID.
+   *
+   * @deprecated
+   * @param request - The request {@link GetHubMetricsRequest}
+   * @returns A Promise of GetHubMetricsResponse
+   */
+  getHubMetrics = request => this.client.fetch({
+    method: 'GET',
+    path: `/iot/v1/regions/${validatePathParam('region', request.region ?? this.client.settings.defaultRegion)}/hubs/${validatePathParam('hubId', request.hubId)}/metrics`,
+    urlParams: urlParams(['start_date', request.startDate])
+  }, unmarshalGetHubMetricsResponse);
+
+  /**
+   * Set the certificate authority of a hub. Set a particular PEM-encoded
+   * certificate, specified by the Hub ID.
+   *
+   * @param request - The request {@link SetHubCARequest}
+   * @returns A Promise of Hub
+   */
+  setHubCA = request => this.client.fetch({
+    body: JSON.stringify(marshalSetHubCARequest(request, this.client.settings)),
+    headers: jsonContentHeaders,
+    method: 'POST',
+    path: `/iot/v1/regions/${validatePathParam('region', request.region ?? this.client.settings.defaultRegion)}/hubs/${validatePathParam('hubId', request.hubId)}/ca`
+  }, unmarshalHub);
+
+  /**
+   * Get the certificate authority of a hub. Get information for a particular
+   * PEM-encoded certificate, specified by the Hub ID.
+   *
+   * @param request - The request {@link GetHubCARequest}
+   * @returns A Promise of GetHubCAResponse
+   */
+  getHubCA = request => this.client.fetch({
+    method: 'GET',
+    path: `/iot/v1/regions/${validatePathParam('region', request.region ?? this.client.settings.defaultRegion)}/hubs/${validatePathParam('hubId', request.hubId)}/ca`
+  }, unmarshalGetHubCAResponse);
+  pageOfListDevices = (() => {
+    var _this3 = this;
+    return function (request) {
+      if (request === void 0) {
+        request = {};
+      }
+      return _this3.client.fetch({
+        method: 'GET',
+        path: `/iot/v1/regions/${validatePathParam('region', request.region ?? _this3.client.settings.defaultRegion)}/devices`,
+        urlParams: urlParams(['allow_insecure', request.allowInsecure], ['hub_id', request.hubId], ['name', request.name], ['order_by', request.orderBy], ['page', request.page], ['page_size', request.pageSize ?? _this3.client.settings.defaultPageSize], ['status', request.status])
+      }, unmarshalListDevicesResponse);
+    };
+  })();
+
+  /**
+   * List devices. List all devices in the specified region. By default,
+   * returned devices are ordered by creation date in ascending order, though
+   * this can be modified via the `order_by` field.
+   *
+   * @param request - The request {@link ListDevicesRequest}
+   * @returns A Promise of ListDevicesResponse
+   */
+  listDevices = (() => {
+    var _this4 = this;
+    return function (request) {
+      if (request === void 0) {
+        request = {};
+      }
+      return enrichForPagination('devices', _this4.pageOfListDevices, request);
+    };
+  })();
+
+  /**
+   * Add a device. Attach a device to a given Hub.
+   *
+   * @param request - The request {@link CreateDeviceRequest}
+   * @returns A Promise of CreateDeviceResponse
+   */
+  createDevice = request => this.client.fetch({
+    body: JSON.stringify(marshalCreateDeviceRequest(request, this.client.settings)),
+    headers: jsonContentHeaders,
+    method: 'POST',
+    path: `/iot/v1/regions/${validatePathParam('region', request.region ?? this.client.settings.defaultRegion)}/devices`
+  }, unmarshalCreateDeviceResponse);
+
+  /**
+   * Get a device. Retrieve information about an existing device, specified by
+   * its device ID. Its full details, including name, status and ID, are
+   * returned in the response object.
+   *
+   * @param request - The request {@link GetDeviceRequest}
+   * @returns A Promise of Device
+   */
+  getDevice = request => this.client.fetch({
+    method: 'GET',
+    path: `/iot/v1/regions/${validatePathParam('region', request.region ?? this.client.settings.defaultRegion)}/devices/${validatePathParam('deviceId', request.deviceId)}`
+  }, unmarshalDevice);
+
+  /**
+   * Update a device. Update the parameters of an existing device, specified by
+   * its device ID.
+   *
+   * @param request - The request {@link UpdateDeviceRequest}
+   * @returns A Promise of Device
+   */
+  updateDevice = request => this.client.fetch({
+    body: JSON.stringify(marshalUpdateDeviceRequest(request, this.client.settings)),
+    headers: jsonContentHeaders,
+    method: 'PATCH',
+    path: `/iot/v1/regions/${validatePathParam('region', request.region ?? this.client.settings.defaultRegion)}/devices/${validatePathParam('deviceId', request.deviceId)}`
+  }, unmarshalDevice);
+
+  /**
+   * Enable a device. Enable a specific device, specified by its device ID.
+   *
+   * @param request - The request {@link EnableDeviceRequest}
+   * @returns A Promise of Device
+   */
+  enableDevice = request => this.client.fetch({
+    body: '{}',
+    headers: jsonContentHeaders,
+    method: 'POST',
+    path: `/iot/v1/regions/${validatePathParam('region', request.region ?? this.client.settings.defaultRegion)}/devices/${validatePathParam('deviceId', request.deviceId)}/enable`
+  }, unmarshalDevice);
+
+  /**
+   * Disable a device. Disable an existing device, specified by its device ID.
+   *
+   * @param request - The request {@link DisableDeviceRequest}
+   * @returns A Promise of Device
+   */
+  disableDevice = request => this.client.fetch({
+    body: '{}',
+    headers: jsonContentHeaders,
+    method: 'POST',
+    path: `/iot/v1/regions/${validatePathParam('region', request.region ?? this.client.settings.defaultRegion)}/devices/${validatePathParam('deviceId', request.deviceId)}/disable`
+  }, unmarshalDevice);
+
+  /**
+   * Renew a device certificate. Renew the certificate of an existing device,
+   * specified by its device ID.
+   *
+   * @param request - The request {@link RenewDeviceCertificateRequest}
+   * @returns A Promise of RenewDeviceCertificateResponse
+   */
+  renewDeviceCertificate = request => this.client.fetch({
+    body: '{}',
+    headers: jsonContentHeaders,
+    method: 'POST',
+    path: `/iot/v1/regions/${validatePathParam('region', request.region ?? this.client.settings.defaultRegion)}/devices/${validatePathParam('deviceId', request.deviceId)}/renew-certificate`
+  }, unmarshalRenewDeviceCertificateResponse);
+
+  /**
+   * Set a custom certificate on a device. Switch the existing certificate of a
+   * given device with an EM-encoded custom certificate.
+   *
+   * @param request - The request {@link SetDeviceCertificateRequest}
+   * @returns A Promise of SetDeviceCertificateResponse
+   */
+  setDeviceCertificate = request => this.client.fetch({
+    body: JSON.stringify(marshalSetDeviceCertificateRequest(request, this.client.settings)),
+    headers: jsonContentHeaders,
+    method: 'PUT',
+    path: `/iot/v1/regions/${validatePathParam('region', request.region ?? this.client.settings.defaultRegion)}/devices/${validatePathParam('deviceId', request.deviceId)}/certificate`
+  }, unmarshalSetDeviceCertificateResponse);
+
+  /**
+   * Get a device's certificate. Get information for a particular PEM-encoded
+   * certificate, specified by the device ID. The response returns full details
+   * of the device, including its type of certificate.
+   *
+   * @param request - The request {@link GetDeviceCertificateRequest}
+   * @returns A Promise of GetDeviceCertificateResponse
+   */
+  getDeviceCertificate = request => this.client.fetch({
+    method: 'GET',
+    path: `/iot/v1/regions/${validatePathParam('region', request.region ?? this.client.settings.defaultRegion)}/devices/${validatePathParam('deviceId', request.deviceId)}/certificate`
+  }, unmarshalGetDeviceCertificateResponse);
+
+  /**
+   * Remove a device. Remove a specific device from the specific Hub it is
+   * attached to.
+   *
+   * @param request - The request {@link DeleteDeviceRequest}
+   */
+  deleteDevice = request => this.client.fetch({
+    method: 'DELETE',
+    path: `/iot/v1/regions/${validatePathParam('region', request.region ?? this.client.settings.defaultRegion)}/devices/${validatePathParam('deviceId', request.deviceId)}`
+  });
+
+  /**
+   * Get a device's metrics. Get the metrics of an existing device, specified by
+   * its device ID.
+   *
+   * @deprecated
+   * @param request - The request {@link GetDeviceMetricsRequest}
+   * @returns A Promise of GetDeviceMetricsResponse
+   */
+  getDeviceMetrics = request => this.client.fetch({
+    method: 'GET',
+    path: `/iot/v1/regions/${validatePathParam('region', request.region ?? this.client.settings.defaultRegion)}/devices/${validatePathParam('deviceId', request.deviceId)}/metrics`,
+    urlParams: urlParams(['start_date', request.startDate])
+  }, unmarshalGetDeviceMetricsResponse);
+  pageOfListRoutes = (() => {
+    var _this5 = this;
+    return function (request) {
+      if (request === void 0) {
+        request = {};
+      }
+      return _this5.client.fetch({
+        method: 'GET',
+        path: `/iot/v1/regions/${validatePathParam('region', request.region ?? _this5.client.settings.defaultRegion)}/routes`,
+        urlParams: urlParams(['hub_id', request.hubId], ['name', request.name], ['order_by', request.orderBy], ['page', request.page], ['page_size', request.pageSize ?? _this5.client.settings.defaultPageSize])
+      }, unmarshalListRoutesResponse);
+    };
+  })();
+
+  /**
+   * List routes. List all routes in the specified region. By default, returned
+   * routes are ordered by creation date in ascending order, though this can be
+   * modified via the `order_by` field.
+   *
+   * @param request - The request {@link ListRoutesRequest}
+   * @returns A Promise of ListRoutesResponse
+   */
+  listRoutes = (() => {
+    var _this6 = this;
+    return function (request) {
+      if (request === void 0) {
+        request = {};
+      }
+      return enrichForPagination('routes', _this6.pageOfListRoutes, request);
+    };
+  })();
+
+  /**
+   * Create a route. Multiple kinds of routes can be created, such as:
+   *
+   * - Database Route Create a route that will record subscribed MQTT messages
+   *   into your database. <b>You need to manage the database by yourself</b>.
+   * - REST Route. Create a route that will call a REST API on received subscribed
+   *   MQTT messages.
+   * - S3 Routes. Create a route that will put subscribed MQTT messages into an S3
+   *   bucket. You need to create the bucket yourself and grant write access.
+   *   Granting can be done with s3cmd (`s3cmd setacl s3://<my-bucket>
+   *   --acl-grant=write:555c69c3-87d0-4bf8-80f1-99a2f757d031:555c69c3-87d0-4bf8-80f1-99a2f757d031`).
+   *
+   * @param request - The request {@link CreateRouteRequest}
+   * @returns A Promise of Route
+   */
+  createRoute = request => this.client.fetch({
+    body: JSON.stringify(marshalCreateRouteRequest(request, this.client.settings)),
+    headers: jsonContentHeaders,
+    method: 'POST',
+    path: `/iot/v1/regions/${validatePathParam('region', request.region ?? this.client.settings.defaultRegion)}/routes`
+  }, unmarshalRoute);
+
+  /**
+   * Update a route. Update the parameters of an existing route, specified by
+   * its route ID.
+   *
+   * @param request - The request {@link UpdateRouteRequest}
+   * @returns A Promise of Route
+   */
+  updateRoute = request => this.client.fetch({
+    body: JSON.stringify(marshalUpdateRouteRequest(request, this.client.settings)),
+    headers: jsonContentHeaders,
+    method: 'PATCH',
+    path: `/iot/v1/regions/${validatePathParam('region', request.region ?? this.client.settings.defaultRegion)}/routes/${validatePathParam('routeId', request.routeId)}`
+  }, unmarshalRoute);
+
+  /**
+   * Get a route. Get information for a particular route, specified by the route
+   * ID. The response returns full details of the route, including its type, the
+   * topic it subscribes to and its configuration.
+   *
+   * @param request - The request {@link GetRouteRequest}
+   * @returns A Promise of Route
+   */
+  getRoute = request => this.client.fetch({
+    method: 'GET',
+    path: `/iot/v1/regions/${validatePathParam('region', request.region ?? this.client.settings.defaultRegion)}/routes/${validatePathParam('routeId', request.routeId)}`
+  }, unmarshalRoute);
+
+  /**
+   * Delete a route. Delete an existing route, specified by its route ID.
+   * Deleting a route is permanent, and cannot be undone.
+   *
+   * @param request - The request {@link DeleteRouteRequest}
+   */
+  deleteRoute = request => this.client.fetch({
+    method: 'DELETE',
+    path: `/iot/v1/regions/${validatePathParam('region', request.region ?? this.client.settings.defaultRegion)}/routes/${validatePathParam('routeId', request.routeId)}`
+  });
+  pageOfListNetworks = (() => {
+    var _this7 = this;
+    return function (request) {
+      if (request === void 0) {
+        request = {};
+      }
+      return _this7.client.fetch({
+        method: 'GET',
+        path: `/iot/v1/regions/${validatePathParam('region', request.region ?? _this7.client.settings.defaultRegion)}/networks`,
+        urlParams: urlParams(['hub_id', request.hubId], ['name', request.name], ['order_by', request.orderBy], ['page', request.page], ['page_size', request.pageSize ?? _this7.client.settings.defaultPageSize], ['topic_prefix', request.topicPrefix])
+      }, unmarshalListNetworksResponse);
+    };
+  })();
+
+  /**
+   * List the networks.
+   *
+   * @param request - The request {@link ListNetworksRequest}
+   * @returns A Promise of ListNetworksResponse
+   */
+  listNetworks = (() => {
+    var _this8 = this;
+    return function (request) {
+      if (request === void 0) {
+        request = {};
+      }
+      return enrichForPagination('networks', _this8.pageOfListNetworks, request);
+    };
+  })();
+
+  /**
+   * Create a new network. Create a new network for an existing hub. Beside the
+   * default network, you can add networks for different data providers.
+   * Possible network types are Sigfox and REST.
+   *
+   * @param request - The request {@link CreateNetworkRequest}
+   * @returns A Promise of CreateNetworkResponse
+   */
+  createNetwork = request => this.client.fetch({
+    body: JSON.stringify(marshalCreateNetworkRequest(request, this.client.settings)),
+    headers: jsonContentHeaders,
+    method: 'POST',
+    path: `/iot/v1/regions/${validatePathParam('region', request.region ?? this.client.settings.defaultRegion)}/networks`
+  }, unmarshalCreateNetworkResponse);
+
+  /**
+   * Retrieve a specific network. Retrieve an existing network, specified by its
+   * network ID. The response returns full details of the network, including its
+   * type, the topic prefix and its endpoint.
+   *
+   * @param request - The request {@link GetNetworkRequest}
+   * @returns A Promise of Network
+   */
+  getNetwork = request => this.client.fetch({
+    method: 'GET',
+    path: `/iot/v1/regions/${validatePathParam('region', request.region ?? this.client.settings.defaultRegion)}/networks/${validatePathParam('networkId', request.networkId)}`
+  }, unmarshalNetwork);
+
+  /**
+   * Delete a Network. Delete an existing network, specified by its network ID.
+   * Deleting a network is permanent, and cannot be undone.
+   *
+   * @param request - The request {@link DeleteNetworkRequest}
+   */
+  deleteNetwork = request => this.client.fetch({
+    method: 'DELETE',
+    path: `/iot/v1/regions/${validatePathParam('region', request.region ?? this.client.settings.defaultRegion)}/networks/${validatePathParam('networkId', request.networkId)}`
+  });
+
+  /**
+   * BETA - Get a Cloud Twin Document.
+   *
+   * @param request - The request {@link GetTwinDocumentRequest}
+   * @returns A Promise of TwinDocument
+   */
+  getTwinDocument = request => this.client.fetch({
+    method: 'GET',
+    path: `/iot/v1/regions/${validatePathParam('region', request.region ?? this.client.settings.defaultRegion)}/twins/${validatePathParam('twinId', request.twinId)}/documents/${validatePathParam('documentName', request.documentName)}`
+  }, unmarshalTwinDocument);
+
+  /**
+   * BETA - Update a Cloud Twin Document.
+   *
+   * @param request - The request {@link PutTwinDocumentRequest}
+   * @returns A Promise of TwinDocument
+   */
+  putTwinDocument = request => this.client.fetch({
+    body: JSON.stringify(marshalPutTwinDocumentRequest(request, this.client.settings)),
+    headers: jsonContentHeaders,
+    method: 'PUT',
+    path: `/iot/v1/regions/${validatePathParam('region', request.region ?? this.client.settings.defaultRegion)}/twins/${validatePathParam('twinId', request.twinId)}/documents/${validatePathParam('documentName', request.documentName)}`
+  }, unmarshalTwinDocument);
+
+  /**
+   * BETA - Patch a Cloud Twin Document.
+   *
+   * @param request - The request {@link PatchTwinDocumentRequest}
+   * @returns A Promise of TwinDocument
+   */
+  patchTwinDocument = request => this.client.fetch({
+    body: JSON.stringify(marshalPatchTwinDocumentRequest(request, this.client.settings)),
+    headers: jsonContentHeaders,
+    method: 'PATCH',
+    path: `/iot/v1/regions/${validatePathParam('region', request.region ?? this.client.settings.defaultRegion)}/twins/${validatePathParam('twinId', request.twinId)}/documents/${validatePathParam('documentName', request.documentName)}`
+  }, unmarshalTwinDocument);
+
+  /**
+   * BETA - Delete a Cloud Twin Document.
+   *
+   * @param request - The request {@link DeleteTwinDocumentRequest}
+   */
+  deleteTwinDocument = request => this.client.fetch({
+    method: 'DELETE',
+    path: `/iot/v1/regions/${validatePathParam('region', request.region ?? this.client.settings.defaultRegion)}/twins/${validatePathParam('twinId', request.twinId)}/documents/${validatePathParam('documentName', request.documentName)}`
+  });
+
+  /**
+   * BETA - List the documents of a Cloud Twin.
+   *
+   * @param request - The request {@link ListTwinDocumentsRequest}
+   * @returns A Promise of ListTwinDocumentsResponse
+   */
+  listTwinDocuments = request => this.client.fetch({
+    method: 'GET',
+    path: `/iot/v1/regions/${validatePathParam('region', request.region ?? this.client.settings.defaultRegion)}/twins/${validatePathParam('twinId', request.twinId)}`
+  }, unmarshalListTwinDocumentsResponse);
+
+  /**
+   * BETA - Delete all the documents of a Cloud Twin.
+   *
+   * @param request - The request {@link DeleteTwinDocumentsRequest}
+   */
+  deleteTwinDocuments = request => this.client.fetch({
+    method: 'DELETE',
+    path: `/iot/v1/regions/${validatePathParam('region', request.region ?? this.client.settings.defaultRegion)}/twins/${validatePathParam('twinId', request.twinId)}`
+  });
+}
+
+export { API };

package/dist/api/iot/v1/content.gen.js

@@ -0,0 +1,7 @@
+// This file was automatically generated. DO NOT EDIT.
+// If you have any remark or suggestion do not hesitate to open an issue.
+
+/** Lists transient statutes of the enum {@link HubStatus}. */
+const HUB_TRANSIENT_STATUSES = ['enabling', 'disabling'];
+
+export { HUB_TRANSIENT_STATUSES };

package/dist/api/iot/v1/index.gen.js

@@ -0,0 +1,5 @@
+export { API } from './api.gen.js';
+export { HUB_TRANSIENT_STATUSES } from './content.gen.js';
+
+// This file was automatically generated. DO NOT EDIT.
+// If you have any remark or suggestion do not hesitate to open an issue.