@scaleway/sdk 0.1.0-alpha.2 → 0.1.0-alpha.20

package/README.md

@@ -1,16 +1,80 @@
 # Scaleway SDK
 
-## ALPHA
+This SDK enables you to interact with Scaleway APIs.
 
-The project is in an early alpha phase. Only a few APIs are available, the rest should quickly follow! Feel free to open an issue for any feedback.
+**⚠️  The project is in alpha:**
+* Code is subject to breaking changes.
+* Sources will be available on GitHub once the SDK enters beta.
+* SDK only works from a node.js runtime, browser calls aren't supported yet.
 
-## Usage
+**🔗  Important links:**
+* Reference documentation (soon)
+* Example projects (soon)
+* [Developers website](https://developers.scaleway.com) (API documentation)
 
-This SDK is based on the [fetch](https://developer.mozilla.org/en-US/docs/Web/API/Fetch_API) API and use `Request`, `Response` & `Headers` interfaces. Those interfaces are native in modern browsers, node >=18 & deno environments.
+## Getting Started
+
+You'll need a pair of access and secret keys to connect to Scaleway API. Please check the [documentation](https://www.scaleway.com/docs/console/my-project/how-to/generate-api-key) on how to retrieve them.
+
+**A minimal setup** would look like this:
+
+```ts
+import { Registry, createClient } from '@scaleway/sdk'
+
+const client = createClient({
+  accessKey: 'SCWXXXXXXXXXXXXXXXXX',
+  secretKey: 'xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx',
+  defaultProjectId: 'xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx',
+  defaultRegion: 'fr-par',
+  defaultZone: 'fr-par-1',
+})
+
+const api = new Registry.v1.API(client)
+```
+
+**For a simpler setup**, you could retrieve the profile from either the configuration file or the environment variables:
+
+```ts
+import { 
+  loadProfileFromConfigurationFile, 
+  // loadProfileFromEnvironmentValues,
+} from '@scaleway/configuration-loader'
+
+const profile = loadProfileFromConfigurationFile() // loadProfileFromEnvironmentValues()
+const client = createClient(profile)
+```
+
+**For more advanced needs**, please check the examples.
+
+## Pagination
+
+We included some pagination helpers for the methods supporting the feature. Let's take `listNamespaces()` (Registry product) as an example:
+
+Retrieve the **first page**:
+
+```ts
+const namespaces = await api.listNamespaces(/*{ page: 1 }*/)
+```
+
+Retrieve **all the pages**:
+```ts
+const allNamespaces = await api.listNamespaces().all()
+```
+
+**Iterate** over the pages:
+```ts
+for await (const page of api.listNamespaces()) {
+  // 
+}
+```
+
+## Dependencies
+
+This SDK is based on the [fetch](https://developer.mozilla.org/en-US/docs/Web/API/Fetch_API) API and use `Request`, `Response` & `Headers` interfaces. Those interfaces are native in modern browsers, node >=18 & [deno](https://deno.land/) environments.
 
 For `node` < 18 & `React Native` environments, the commonJS build requires [cross-fetch](https://www.npmjs.com/package/cross-fetch) package, it is listed in `dependencies` but not used in esm build.
 
-## Troubleshooting
+**Troubleshooting**
 
 In node environment, the commonJS module defined in `dist/index.cjs` entry file is used by default, thanks to the "main" `package.json` field.
 
@@ -26,3 +90,7 @@ or
 ```bash
 node -r cross-fetch/polyfill ./script-using-sdk.mjs
 ```
+
+## Reach us
+
+We love feedback. Feel free to reach us on [Scaleway Slack community](https://slack.scaleway.com/), we are waiting for you on [#opensource](https://scaleway-community.slack.com/app_redirect?channel=opensource).

package/dist/api/account/index.js

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

package/dist/api/account/v2alpha1/api.gen.js

@@ -0,0 +1,66 @@
+import { API } from '../../../helpers/API.js';
+import { urlParams, validatePathParam } from '../../../scw/marshalling.js';
+import { enrichForPagination } from '../../../scw/fetch/resource-paginator.js';
+import { unmarshal0ECB, marshalCreateSSHKeyRequest, marshalUpdateSSHKeyRequest } from './marshalling.gen.js';
+
+// This file was automatically generated. DO NOT EDIT.
+const jsonContentHeaders = {
+  'Content-Type': 'application/json; charset=utf-8'
+};
+/** Account API. */
+
+class AccountV2Alpha1GenAPI extends API {
+  constructor() {
+    var _this;
+
+    super(...arguments);
+    _this = this;
+
+    this.pageOfListSSHKeys = function (request) {
+      if (request === void 0) {
+        request = {};
+      }
+
+      return _this.client.fetch({
+        method: 'GET',
+        path: `/account/v2alpha1/ssh-keys`,
+        urlParams: urlParams(['name', request.name], ['order_by', request.orderBy ?? 'created_at_asc'], ['organization_id', request.organizationId ?? _this.client.settings.defaultOrganizationId], ['page', request.page], ['page_size', request.pageSize ?? _this.client.settings.defaultPageSize], ['project_id', request.projectId ?? _this.client.settings.defaultProjectId])
+      }, unmarshal0ECB);
+    };
+
+    this.listSSHKeys = function (request) {
+      if (request === void 0) {
+        request = {};
+      }
+
+      return enrichForPagination('sshKeys', _this.pageOfListSSHKeys, request);
+    };
+
+    this.createSSHKey = request => this.client.fetch({
+      body: JSON.stringify(marshalCreateSSHKeyRequest(request, this.client.settings)),
+      headers: jsonContentHeaders,
+      method: 'POST',
+      path: `/account/v2alpha1/ssh-keys`
+    }, unmarshal0ECB);
+
+    this.getSSHKey = request => this.client.fetch({
+      method: 'GET',
+      path: `/account/v2alpha1/ssh-key/${validatePathParam('sshKeyId', request.sshKeyId)}`
+    }, unmarshal0ECB);
+
+    this.updateSSHKey = request => this.client.fetch({
+      body: JSON.stringify(marshalUpdateSSHKeyRequest(request, this.client.settings)),
+      headers: jsonContentHeaders,
+      method: 'PATCH',
+      path: `/account/v2alpha1/ssh-key/${validatePathParam('sshKeyId', request.sshKeyId)}`
+    }, unmarshal0ECB);
+
+    this.deleteSSHKey = request => this.client.fetch({
+      method: 'DELETE',
+      path: `/account/v2alpha1/ssh-key/${validatePathParam('sshKeyId', request.sshKeyId)}`
+    });
+  }
+
+}
+
+export { AccountV2Alpha1GenAPI };

package/dist/api/account/v2alpha1/index.js

@@ -0,0 +1 @@
+export { AccountV2Alpha1GenAPI as API } from './api.gen.js';

package/dist/api/account/v2alpha1/marshalling.gen.js

@@ -0,0 +1,22 @@
+import { resolveOneOf, unmarshalAnyRes } from '../../../scw/marshalling.js';
+
+// This file was automatically generated. DO NOT EDIT.
+const unmarshal0ECB = data => unmarshalAnyRes(data, [], ['created_at', 'updated_at']);
+const marshalCreateSSHKeyRequest = (request, defaults) => ({
+  name: request.name,
+  public_key: request.publicKey,
+  ...resolveOneOf([{
+    default: defaults.defaultProjectId,
+    param: 'project_id',
+    value: request.projectId
+  }, {
+    default: defaults.defaultOrganizationId,
+    param: 'organization_id',
+    value: request.organizationId
+  }])
+});
+const marshalUpdateSSHKeyRequest = (request, defaults) => ({
+  name: request.name
+});
+
+export { marshalCreateSSHKeyRequest, marshalUpdateSSHKeyRequest, unmarshal0ECB };

package/dist/api/applesilicon/index.js

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

package/dist/api/applesilicon/v1alpha1/api.gen.js

@@ -0,0 +1,145 @@
+import { API } from '../../../helpers/API.js';
+import { waitForResource } from '../../../internal/async/interval-retrier.js';
+import { validatePathParam, unmarshalAnyRes, urlParams } from '../../../scw/marshalling.js';
+import { enrichForPagination } from '../../../scw/fetch/resource-paginator.js';
+import { SERVER_TRANSIENT_STATUSES } from './content.gen.js';
+import { marshalCreateServerRequest, unmarshalA4C1, marshalUpdateServerRequest } from './marshalling.gen.js';
+
+// This file was automatically generated. DO NOT EDIT.
+const jsonContentHeaders = {
+  'Content-Type': 'application/json; charset=utf-8'
+};
+/**
+ * Apple silicon.
+ *
+ * Scaleway Apple silicon M1 as-a-Service is built using the latest generation
+ * of Apple Mac mini hardware (fifth generation).
+ *
+ * These dedicated Mac mini M1s are designed for developing, building, testing,
+ * and signing applications for Apple devices, including iPhones, iPads, Mac
+ * computers and much more.
+ *
+ * Get set to explore, learn and build on a dedicated Mac mini M1 with more
+ * performance and speed than you ever thought possible.
+ *
+ * _Apple silicon as a Service comes with a minimum allocation period of 24 hours_*.
+ *
+ * Mac mini and macOS are trademarks of Apple Inc., registered in the U.S. and
+ * other countries and regions. IOS is a trademark or registered trademark of
+ * Cisco in the U.S. and other countries and is used by Apple under license.
+ * Scaleway is not affiliated with Apple Inc.
+ */
+
+class ApplesiliconV1Alpha1GenAPI extends API {
+  constructor() {
+    var _this;
+
+    super(...arguments);
+    _this = this;
+
+    this.listServerTypes = function (request) {
+      if (request === void 0) {
+        request = {};
+      }
+
+      return _this.client.fetch({
+        method: 'GET',
+        path: `/apple-silicon/v1alpha1/zones/${validatePathParam('zone', request.zone ?? _this.client.settings.defaultZone)}/server-types`
+      }, unmarshalAnyRes);
+    };
+
+    this.getServerType = request => this.client.fetch({
+      method: 'GET',
+      path: `/apple-silicon/v1alpha1/zones/${validatePathParam('zone', request.zone ?? this.client.settings.defaultZone)}/server-type/${validatePathParam('serverType', request.serverType)}`
+    }, unmarshalAnyRes);
+
+    this.createServer = request => this.client.fetch({
+      body: JSON.stringify(marshalCreateServerRequest(request, this.client.settings)),
+      headers: jsonContentHeaders,
+      method: 'POST',
+      path: `/apple-silicon/v1alpha1/zones/${validatePathParam('zone', request.zone ?? this.client.settings.defaultZone)}/servers`
+    }, unmarshalA4C1);
+
+    this.pageOfListServers = function (request) {
+      if (request === void 0) {
+        request = {};
+      }
+
+      return _this.client.fetch({
+        method: 'GET',
+        path: `/apple-silicon/v1alpha1/zones/${validatePathParam('zone', request.zone ?? _this.client.settings.defaultZone)}/servers`,
+        urlParams: urlParams(['order_by', request.orderBy ?? 'created_at_asc'], ['organization_id', request.organizationId ?? _this.client.settings.defaultOrganizationId], ['page', request.page], ['page_size', request.pageSize ?? _this.client.settings.defaultPageSize], ['project_id', request.projectId ?? _this.client.settings.defaultProjectId])
+      }, unmarshalA4C1);
+    };
+
+    this.listServers = function (request) {
+      if (request === void 0) {
+        request = {};
+      }
+
+      return enrichForPagination('servers', _this.pageOfListServers, request);
+    };
+
+    this.pageOfListOS = function (request) {
+      if (request === void 0) {
+        request = {};
+      }
+
+      return _this.client.fetch({
+        method: 'GET',
+        path: `/apple-silicon/v1alpha1/zones/${validatePathParam('zone', request.zone ?? _this.client.settings.defaultZone)}/os`,
+        urlParams: urlParams(['name', request.name], ['page', request.page], ['page_size', request.pageSize ?? _this.client.settings.defaultPageSize], ['server_type', request.serverType])
+      }, unmarshalAnyRes);
+    };
+
+    this.listOS = function (request) {
+      if (request === void 0) {
+        request = {};
+      }
+
+      return enrichForPagination('os', _this.pageOfListOS, request);
+    };
+
+    this.getOS = request => this.client.fetch({
+      method: 'GET',
+      path: `/apple-silicon/v1alpha1/zones/${validatePathParam('zone', request.zone ?? this.client.settings.defaultZone)}/os/${validatePathParam('osId', request.osId)}`
+    }, unmarshalAnyRes);
+
+    this.getServer = request => this.client.fetch({
+      method: 'GET',
+      path: `/apple-silicon/v1alpha1/zones/${validatePathParam('zone', request.zone ?? this.client.settings.defaultZone)}/servers/${validatePathParam('serverId', request.serverId)}`
+    }, unmarshalA4C1);
+
+    this.waitForServer = (request, options) => waitForResource((options == null ? void 0 : options.stop) ?? (res => Promise.resolve(!SERVER_TRANSIENT_STATUSES.includes(res.status))), this.getServer, request, options);
+
+    this.updateServer = request => this.client.fetch({
+      body: JSON.stringify(marshalUpdateServerRequest(request, this.client.settings)),
+      headers: jsonContentHeaders,
+      method: 'PATCH',
+      path: `/apple-silicon/v1alpha1/zones/${validatePathParam('zone', request.zone ?? this.client.settings.defaultZone)}/servers/${validatePathParam('serverId', request.serverId)}`
+    }, unmarshalA4C1);
+
+    this.deleteServer = request => this.client.fetch({
+      method: 'DELETE',
+      path: `/apple-silicon/v1alpha1/zones/${validatePathParam('zone', request.zone ?? this.client.settings.defaultZone)}/servers/${validatePathParam('serverId', request.serverId)}`
+    });
+
+    this.rebootServer = request => this.client.fetch({
+      body: '{}',
+      headers: jsonContentHeaders,
+      method: 'POST',
+      path: `/apple-silicon/v1alpha1/zones/${validatePathParam('zone', request.zone ?? this.client.settings.defaultZone)}/servers/${validatePathParam('serverId', request.serverId)}/reboot`
+    }, unmarshalA4C1);
+
+    this.reinstallServer = request => this.client.fetch({
+      body: '{}',
+      headers: jsonContentHeaders,
+      method: 'POST',
+      path: `/apple-silicon/v1alpha1/zones/${validatePathParam('zone', request.zone ?? this.client.settings.defaultZone)}/servers/${validatePathParam('serverId', request.serverId)}/reinstall`
+    }, unmarshalA4C1);
+  }
+
+}
+ApplesiliconV1Alpha1GenAPI.LOCALITIES = ['fr-par-3'];
+
+export { ApplesiliconV1Alpha1GenAPI };

package/dist/api/applesilicon/v1alpha1/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 ServerStatus}. */
+const SERVER_TRANSIENT_STATUSES = ['starting', 'rebooting', 'updating', 'locking', 'unlocking', 'reinstalling'];
+
+export { SERVER_TRANSIENT_STATUSES };

package/dist/api/applesilicon/v1alpha1/index.js

@@ -0,0 +1,2 @@
+export { ApplesiliconV1Alpha1GenAPI as API } from './api.gen.js';
+export { SERVER_TRANSIENT_STATUSES } from './content.gen.js';

package/dist/api/applesilicon/v1alpha1/marshalling.gen.js

@@ -0,0 +1,15 @@
+import randomName from '../../../node_modules/.pnpm/@scaleway_random-name@3.0.2/node_modules/@scaleway/random-name/dist/index.js';
+import { unmarshalAnyRes } from '../../../scw/marshalling.js';
+
+// This file was automatically generated. DO NOT EDIT.
+const unmarshalA4C1 = data => unmarshalAnyRes(data, [], ['created_at', 'deletable_at', 'updated_at']);
+const marshalCreateServerRequest = (request, defaults) => ({
+  name: request.name || randomName('as'),
+  project_id: request.projectId ?? defaults.defaultProjectId,
+  type: request.type
+});
+const marshalUpdateServerRequest = (request, defaults) => ({
+  name: request.name
+});
+
+export { marshalCreateServerRequest, marshalUpdateServerRequest, unmarshalA4C1 };

package/dist/api/baremetal/index.js

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

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

@@ -0,0 +1,254 @@
+import { API } from '../../../helpers/API.js';
+import { waitForResource } from '../../../internal/async/interval-retrier.js';
+import { validatePathParam, urlParams, unmarshalAnyRes } from '../../../scw/marshalling.js';
+import { enrichForPagination } from '../../../scw/fetch/resource-paginator.js';
+import { SERVER_TRANSIENT_STATUSES } from './content.gen.js';
+import { unmarshal23C1, marshalCreateServerRequest, marshalUpdateServerRequest, marshalInstallServerRequest, marshalRebootServerRequest, marshalStartServerRequest, unmarshal0ECB, marshalStartBMCAccessRequest, unmarshal41B8, marshalUpdateIPRequest, marshalAddOptionServerRequest, marshalUpdateSettingRequest } from './marshalling.gen.js';
+
+// This file was automatically generated. DO NOT EDIT.
+const jsonContentHeaders = {
+  'Content-Type': 'application/json; charset=utf-8'
+};
+/**
+ * Elastic metal API.
+ *
+ * This API allows to manage your Bare metal server.
+ */
+
+class BaremetalV1GenAPI extends API {
+  constructor() {
+    var _this;
+
+    super(...arguments);
+    _this = this;
+
+    this.pageOfListServers = function (request) {
+      if (request === void 0) {
+        request = {};
+      }
+
+      return _this.client.fetch({
+        method: 'GET',
+        path: `/baremetal/v1/zones/${validatePathParam('zone', request.zone ?? _this.client.settings.defaultZone)}/servers`,
+        urlParams: urlParams(['name', request.name], ['option_id', request.optionId], ['order_by', request.orderBy ?? 'created_at_asc'], ['organization_id', request.organizationId ?? _this.client.settings.defaultOrganizationId], ['page', request.page], ['page_size', request.pageSize ?? _this.client.settings.defaultPageSize], ['project_id', request.projectId ?? _this.client.settings.defaultProjectId], ['status', request.status], ['tags', request.tags])
+      }, unmarshal23C1);
+    };
+
+    this.listServers = function (request) {
+      if (request === void 0) {
+        request = {};
+      }
+
+      return enrichForPagination('servers', _this.pageOfListServers, request);
+    };
+
+    this.getServer = request => this.client.fetch({
+      method: 'GET',
+      path: `/baremetal/v1/zones/${validatePathParam('zone', request.zone ?? this.client.settings.defaultZone)}/servers/${validatePathParam('serverId', request.serverId)}`
+    }, unmarshal23C1);
+
+    this.waitForServer = (request, options) => waitForResource((options == null ? void 0 : options.stop) ?? (res => Promise.resolve(!SERVER_TRANSIENT_STATUSES.includes(res.status))), this.getServer, request, options);
+
+    this.createServer = request => this.client.fetch({
+      body: JSON.stringify(marshalCreateServerRequest(request, this.client.settings)),
+      headers: jsonContentHeaders,
+      method: 'POST',
+      path: `/baremetal/v1/zones/${validatePathParam('zone', request.zone ?? this.client.settings.defaultZone)}/servers`
+    }, unmarshal23C1);
+
+    this.updateServer = request => this.client.fetch({
+      body: JSON.stringify(marshalUpdateServerRequest(request, this.client.settings)),
+      headers: jsonContentHeaders,
+      method: 'PATCH',
+      path: `/baremetal/v1/zones/${validatePathParam('zone', request.zone ?? this.client.settings.defaultZone)}/servers/${validatePathParam('serverId', request.serverId)}`
+    }, unmarshal23C1);
+
+    this.installServer = request => this.client.fetch({
+      body: JSON.stringify(marshalInstallServerRequest(request, this.client.settings)),
+      headers: jsonContentHeaders,
+      method: 'POST',
+      path: `/baremetal/v1/zones/${validatePathParam('zone', request.zone ?? this.client.settings.defaultZone)}/servers/${validatePathParam('serverId', request.serverId)}/install`
+    }, unmarshal23C1);
+
+    this.getServerMetrics = request => this.client.fetch({
+      method: 'GET',
+      path: `/baremetal/v1/zones/${validatePathParam('zone', request.zone ?? this.client.settings.defaultZone)}/servers/${validatePathParam('serverId', request.serverId)}/metrics`
+    }, unmarshalAnyRes);
+
+    this.deleteServer = request => this.client.fetch({
+      method: 'DELETE',
+      path: `/baremetal/v1/zones/${validatePathParam('zone', request.zone ?? this.client.settings.defaultZone)}/servers/${validatePathParam('serverId', request.serverId)}`
+    }, unmarshal23C1);
+
+    this.rebootServer = request => this.client.fetch({
+      body: JSON.stringify(marshalRebootServerRequest(request, this.client.settings)),
+      headers: jsonContentHeaders,
+      method: 'POST',
+      path: `/baremetal/v1/zones/${validatePathParam('zone', request.zone ?? this.client.settings.defaultZone)}/servers/${validatePathParam('serverId', request.serverId)}/reboot`
+    }, unmarshal23C1);
+
+    this.startServer = request => this.client.fetch({
+      body: JSON.stringify(marshalStartServerRequest(request, this.client.settings)),
+      headers: jsonContentHeaders,
+      method: 'POST',
+      path: `/baremetal/v1/zones/${validatePathParam('zone', request.zone ?? this.client.settings.defaultZone)}/servers/${validatePathParam('serverId', request.serverId)}/start`
+    }, unmarshal23C1);
+
+    this.stopServer = request => this.client.fetch({
+      body: '{}',
+      headers: jsonContentHeaders,
+      method: 'POST',
+      path: `/baremetal/v1/zones/${validatePathParam('zone', request.zone ?? this.client.settings.defaultZone)}/servers/${validatePathParam('serverId', request.serverId)}/stop`
+    }, unmarshal23C1);
+
+    this.pageOfListServerEvents = request => this.client.fetch({
+      method: 'GET',
+      path: `/baremetal/v1/zones/${validatePathParam('zone', request.zone ?? this.client.settings.defaultZone)}/servers/${validatePathParam('serverId', request.serverId)}/events`,
+      urlParams: urlParams(['order_by', request.orderBy ?? 'created_at_asc'], ['page', request.page], ['page_size', request.pageSize ?? this.client.settings.defaultPageSize])
+    }, unmarshal0ECB);
+
+    this.listServerEvents = request => enrichForPagination('events', this.pageOfListServerEvents, request);
+
+    this.startBMCAccess = request => this.client.fetch({
+      body: JSON.stringify(marshalStartBMCAccessRequest(request, this.client.settings)),
+      headers: jsonContentHeaders,
+      method: 'POST',
+      path: `/baremetal/v1/zones/${validatePathParam('zone', request.zone ?? this.client.settings.defaultZone)}/servers/${validatePathParam('serverId', request.serverId)}/bmc-access`
+    }, unmarshal41B8);
+
+    this.getBMCAccess = request => this.client.fetch({
+      method: 'GET',
+      path: `/baremetal/v1/zones/${validatePathParam('zone', request.zone ?? this.client.settings.defaultZone)}/servers/${validatePathParam('serverId', request.serverId)}/bmc-access`
+    }, unmarshal41B8);
+
+    this.stopBMCAccess = request => this.client.fetch({
+      method: 'DELETE',
+      path: `/baremetal/v1/zones/${validatePathParam('zone', request.zone ?? this.client.settings.defaultZone)}/servers/${validatePathParam('serverId', request.serverId)}/bmc-access`
+    });
+
+    this.updateIP = request => this.client.fetch({
+      body: JSON.stringify(marshalUpdateIPRequest(request, this.client.settings)),
+      headers: jsonContentHeaders,
+      method: 'PATCH',
+      path: `/baremetal/v1/zones/${validatePathParam('zone', request.zone ?? this.client.settings.defaultZone)}/servers/${validatePathParam('serverId', request.serverId)}/ips/${validatePathParam('ipId', request.ipId)}`
+    }, unmarshalAnyRes);
+
+    this.addOptionServer = request => this.client.fetch({
+      body: JSON.stringify(marshalAddOptionServerRequest(request, this.client.settings)),
+      headers: jsonContentHeaders,
+      method: 'POST',
+      path: `/baremetal/v1/zones/${validatePathParam('zone', request.zone ?? this.client.settings.defaultZone)}/servers/${validatePathParam('serverId', request.serverId)}/options/${validatePathParam('optionId', request.optionId)}`
+    }, unmarshal23C1);
+
+    this.deleteOptionServer = request => this.client.fetch({
+      method: 'DELETE',
+      path: `/baremetal/v1/zones/${validatePathParam('zone', request.zone ?? this.client.settings.defaultZone)}/servers/${validatePathParam('serverId', request.serverId)}/options/${validatePathParam('optionId', request.optionId)}`
+    }, unmarshal23C1);
+
+    this.pageOfListOffers = function (request) {
+      if (request === void 0) {
+        request = {};
+      }
+
+      return _this.client.fetch({
+        method: 'GET',
+        path: `/baremetal/v1/zones/${validatePathParam('zone', request.zone ?? _this.client.settings.defaultZone)}/offers`,
+        urlParams: urlParams(['page', request.page], ['page_size', request.pageSize ?? _this.client.settings.defaultPageSize], ['subscription_period', request.subscriptionPeriod ?? 'unknown_subscription_period'])
+      }, unmarshalAnyRes);
+    };
+
+    this.listOffers = function (request) {
+      if (request === void 0) {
+        request = {};
+      }
+
+      return enrichForPagination('offers', _this.pageOfListOffers, request);
+    };
+
+    this.getOffer = request => this.client.fetch({
+      method: 'GET',
+      path: `/baremetal/v1/zones/${validatePathParam('zone', request.zone ?? this.client.settings.defaultZone)}/offers/${validatePathParam('offerId', request.offerId)}`
+    }, unmarshalAnyRes);
+
+    this.getOption = request => this.client.fetch({
+      method: 'GET',
+      path: `/baremetal/v1/zones/${validatePathParam('zone', request.zone ?? this.client.settings.defaultZone)}/options/${validatePathParam('optionId', request.optionId)}`
+    }, unmarshalAnyRes);
+
+    this.pageOfListOptions = function (request) {
+      if (request === void 0) {
+        request = {};
+      }
+
+      return _this.client.fetch({
+        method: 'GET',
+        path: `/baremetal/v1/zones/${validatePathParam('zone', request.zone ?? _this.client.settings.defaultZone)}/options`,
+        urlParams: urlParams(['name', request.name], ['offer_id', request.offerId], ['page', request.page], ['page_size', request.pageSize ?? _this.client.settings.defaultPageSize])
+      }, unmarshalAnyRes);
+    };
+
+    this.listOptions = function (request) {
+      if (request === void 0) {
+        request = {};
+      }
+
+      return enrichForPagination('options', _this.pageOfListOptions, request);
+    };
+
+    this.pageOfListSettings = function (request) {
+      if (request === void 0) {
+        request = {};
+      }
+
+      return _this.client.fetch({
+        method: 'GET',
+        path: `/baremetal/v1/zones/${validatePathParam('zone', request.zone ?? _this.client.settings.defaultZone)}/settings`,
+        urlParams: urlParams(['order_by', request.orderBy ?? 'created_at_asc'], ['page', request.page], ['page_size', request.pageSize ?? _this.client.settings.defaultPageSize], ['project_id', request.projectId ?? _this.client.settings.defaultProjectId])
+      }, unmarshalAnyRes);
+    };
+
+    this.listSettings = function (request) {
+      if (request === void 0) {
+        request = {};
+      }
+
+      return enrichForPagination('settings', _this.pageOfListSettings, request);
+    };
+
+    this.updateSetting = request => this.client.fetch({
+      body: JSON.stringify(marshalUpdateSettingRequest(request, this.client.settings)),
+      headers: jsonContentHeaders,
+      method: 'PATCH',
+      path: `/baremetal/v1/zones/${validatePathParam('zone', request.zone ?? this.client.settings.defaultZone)}/settings/${validatePathParam('settingId', request.settingId)}`
+    }, unmarshalAnyRes);
+
+    this.pageOfListOS = function (request) {
+      if (request === void 0) {
+        request = {};
+      }
+
+      return _this.client.fetch({
+        method: 'GET',
+        path: `/baremetal/v1/zones/${validatePathParam('zone', request.zone ?? _this.client.settings.defaultZone)}/os`,
+        urlParams: urlParams(['offer_id', request.offerId], ['page', request.page], ['page_size', request.pageSize ?? _this.client.settings.defaultPageSize])
+      }, unmarshalAnyRes);
+    };
+
+    this.listOS = function (request) {
+      if (request === void 0) {
+        request = {};
+      }
+
+      return enrichForPagination('os', _this.pageOfListOS, request);
+    };
+
+    this.getOS = request => this.client.fetch({
+      method: 'GET',
+      path: `/baremetal/v1/zones/${validatePathParam('zone', request.zone ?? this.client.settings.defaultZone)}/os/${validatePathParam('osId', request.osId)}`
+    }, unmarshalAnyRes);
+  }
+
+}
+BaremetalV1GenAPI.LOCALITIES = ['fr-par-1', 'fr-par-2', 'nl-ams-1'];
+
+export { BaremetalV1GenAPI };

package/dist/api/baremetal/v1/api.utils.js

@@ -0,0 +1,31 @@
+import { tryAtIntervals, createExponentialBackoffStrategy } from '../../../internal/async/interval-retrier.js';
+import { BaremetalV1GenAPI } from './api.gen.js';
+import { SERVER_INSTALL_TRANSIENT_STATUSES } from './content.gen.js';
+
+class BaremetalV1UtilsAPI extends BaremetalV1GenAPI {
+  constructor() {
+    super(...arguments);
+
+    this.waitForServerInstall = (request, options) => tryAtIntervals(async () => {
+      const value = await this.getServer(request).then(server => {
+        if (!server.install) {
+          throw new Error(`Server creation has not begun for server ${request.serverId}`);
+        }
+
+        return server.install;
+      });
+
+      if (!value) {
+        throw new Error(`Server creation has not begun for server ${request.serverId}`);
+      }
+
+      return {
+        done: !SERVER_INSTALL_TRANSIENT_STATUSES.includes(value.status),
+        value
+      };
+    }, createExponentialBackoffStrategy((options == null ? void 0 : options.minDelay) ?? 1, (options == null ? void 0 : options.maxDelay) ?? 30), options == null ? void 0 : options.timeout);
+  }
+
+}
+
+export { BaremetalV1UtilsAPI };