@scaleway/sdk-webhosting 1.1.2 → 1.2.0

package/dist/v1/types.gen.d.ts

@@ -1,5 +1,7 @@
 import type { Money, Region as ScwRegion } from '@scaleway/sdk-client';
 import type { LanguageCode as StdLanguageCode } from '@scaleway/sdk-std';
+export type BackupItemType = 'unknown_backup_item_type' | 'full' | 'web' | 'mail' | 'db' | 'db_user' | 'ftp_user' | 'dns_zone' | 'cron_job' | 'ssl_certificate';
+export type BackupStatus = 'unknown_backup_status' | 'active' | 'locked' | 'disabled' | 'damaged' | 'restoring';
 export type DnsRecordStatus = 'unknown_status' | 'valid' | 'invalid';
 export type DnsRecordType = 'unknown_type' | 'a' | 'cname' | 'mx' | 'txt' | 'ns' | 'aaaa';
 export type DnsRecordsStatus = 'unknown_status' | 'valid' | 'invalid';
@@ -9,7 +11,8 @@ export type DomainAvailabilityStatus = 'unknown_status' | 'available' | 'not_ava
 export type DomainDnsAction = 'unknown_dns_action' | 'auto_config_all_records' | 'auto_config_web_records' | 'auto_config_mail_records' | 'auto_config_nameservers' | 'auto_config_none';
 export type DomainStatus = 'unknown_status' | 'valid' | 'invalid' | 'validating' | 'error';
 export type DomainZoneOwner = 'unknown_zone_owner' | 'external' | 'scaleway' | 'online' | 'webhosting';
-export type HostingStatus = 'unknown_status' | 'delivering' | 'ready' | 'deleting' | 'error' | 'locked' | 'migrating';
+export type HostingStatus = 'unknown_status' | 'delivering' | 'ready' | 'deleting' | 'error' | 'locked' | 'migrating' | 'updating';
+export type ListBackupsRequestOrderBy = 'created_at_desc' | 'created_at_asc';
 export type ListDatabaseUsersRequestOrderBy = 'username_asc' | 'username_desc';
 export type ListDatabasesRequestOrderBy = 'database_name_asc' | 'database_name_desc';
 export type ListFtpAccountsRequestOrderBy = 'username_asc' | 'username_desc';
@@ -21,6 +24,28 @@ export type NameserverStatus = 'unknown_status' | 'valid' | 'invalid';
 export type OfferOptionName = 'unknown_name' | 'domain_count' | 'email_count' | 'storage_gb' | 'vcpu_count' | 'ram_gb' | 'backup' | 'dedicated_ip' | 'email_storage_gb' | 'database_count' | 'support';
 export type OfferOptionWarning = 'unknown_warning' | 'quota_exceeded_warning' | 'usage_low_warning';
 export type PlatformPlatformGroup = 'unknown_group' | 'default' | 'premium';
+export interface AutoConfigDomainDns {
+    /**
+     * Whether or not to synchronize domain nameservers.
+     */
+    nameservers: boolean;
+    /**
+     * Whether or not to synchronize web records.
+     */
+    webRecords: boolean;
+    /**
+     * Whether or not to synchronize mail records.
+     */
+    mailRecords: boolean;
+    /**
+     * Whether or not to synchronize all types of records. Takes priority over the other fields.
+     */
+    allRecords: boolean;
+    /**
+     * No automatic domain configuration. Users must configure their domain for the Web Hosting to work.
+     */
+    none: boolean;
+}
 export interface PlatformControlPanelUrls {
     /**
      * URL to connect to the hosting control panel dashboard.
@@ -31,6 +56,24 @@ export interface PlatformControlPanelUrls {
      */
     webmail: string;
 }
+export interface HostingDomainCustomDomain {
+    /**
+     * Custom domain linked to the hosting plan.
+     */
+    domain: string;
+    /**
+     * Status of the custom domain verification.
+     */
+    domainStatus: DomainStatus;
+    /**
+     * Status of the DNS configuration for the custom domain.
+     */
+    dnsStatus: DnsRecordsStatus;
+    /**
+     * Indicates whether to auto-configure DNS for this domain.
+     */
+    autoConfigDomainDns?: AutoConfigDomainDns;
+}
 export interface OfferOption {
     /**
      * Option ID.
@@ -75,31 +118,45 @@ export interface PlatformControlPanel {
      */
     urls?: PlatformControlPanelUrls;
 }
-export interface CreateDatabaseRequestUser {
-    username: string;
-    password: string;
-}
-export interface AutoConfigDomainDns {
+export interface BackupItem {
     /**
-     * Whether or not to synchronize domain nameservers.
+     * ID of the item.
      */
-    nameservers: boolean;
+    id: string;
     /**
-     * Whether or not to synchronize web records.
+     * Name of the item (e.g., `database name`, `email address`).
      */
-    webRecords: boolean;
+    name: string;
     /**
-     * Whether or not to synchronize mail records.
+     * Type of the item (e.g., email, database, FTP).
      */
-    mailRecords: boolean;
+    type: BackupItemType;
     /**
-     * Whether or not to synchronize all types of records. Takes priority over the other fields.
+     * Size of the item in bytes.
      */
-    allRecords: boolean;
+    size: number;
     /**
-     * No automatic domain configuration. Users must configure their domain for the Web Hosting to work.
+     * Status of the item. Available values are `active`, `damaged`, and `restoring`.
      */
-    none: boolean;
+    status: BackupStatus;
+    /**
+     * Date and time at which this item was backed up.
+     */
+    createdAt?: Date;
+}
+export interface HostingDomain {
+    /**
+     * Optional free subdomain linked to the Web Hosting plan.
+     */
+    subdomain: string;
+    /**
+     * Optional custom domain linked to the Web Hosting plan.
+     */
+    customDomain?: HostingDomainCustomDomain;
+}
+export interface CreateDatabaseRequestUser {
+    username: string;
+    password: string;
 }
 export interface CreateHostingRequestDomainConfiguration {
     updateNameservers: boolean;
@@ -247,6 +304,38 @@ export interface Platform {
      */
     controlPanel?: PlatformControlPanel;
 }
+export interface BackupItemGroup {
+    /**
+     * Type of items (e.g., email, database, FTP).
+     */
+    type: BackupItemType;
+    /**
+     * List of individual backup items of this type.
+     */
+    items: BackupItem[];
+}
+export interface Backup {
+    /**
+     * ID of the backup.
+     */
+    id: string;
+    /**
+     * Total size of the backup in bytes.
+     */
+    size: number;
+    /**
+     * Creation date of the backup.
+     */
+    createdAt?: Date;
+    /**
+     * Status of the backup. Available values are `active`, `locked`, and `restoring`.
+     */
+    status: BackupStatus;
+    /**
+     * Total number of restorable items in the backup.
+     */
+    totalItems: number;
+}
 export interface ControlPanel {
     /**
      * Control panel name.
@@ -317,9 +406,9 @@ export interface HostingSummary {
      */
     status: HostingStatus;
     /**
-     * Main domain associated with the Web Hosting plan.
+     * @deprecated Main domain associated with the Web Hosting plan (deprecated, use domain_info).
      */
-    domain: string;
+    domain?: string;
     /**
      * Whether the hosting is protected or not.
      */
@@ -333,13 +422,17 @@ export interface HostingSummary {
      */
     offerName: string;
     /**
-     * Main domain status of the Web Hosting plan.
+     * @deprecated Main domain status of the Web Hosting plan.
      */
-    domainStatus: DomainStatus;
+    domainStatus?: DomainStatus;
     /**
      * Region where the Web Hosting plan is hosted.
      */
     region: ScwRegion;
+    /**
+     * Domain configuration block (subdomain, optional custom domain, and DNS settings).
+     */
+    domainInfo?: HostingDomain;
 }
 export interface MailAccount {
     /**
@@ -391,6 +484,84 @@ export interface DomainAvailability {
      */
     price?: Money;
 }
+export type BackupApiGetBackupRequest = {
+    /**
+     * Region to target. If none is passed will use default region from the config.
+     */
+    region?: ScwRegion;
+    /**
+     * UUID of the hosting account.
+     */
+    hostingId: string;
+    /**
+     * ID of the backup to retrieve.
+     */
+    backupId: string;
+};
+export type BackupApiListBackupItemsRequest = {
+    /**
+     * Region to target. If none is passed will use default region from the config.
+     */
+    region?: ScwRegion;
+    /**
+     * UUID of the hosting account.
+     */
+    hostingId: string;
+    /**
+     * ID of the backup to list items from.
+     */
+    backupId: string;
+};
+export type BackupApiListBackupsRequest = {
+    /**
+     * Region to target. If none is passed will use default region from the config.
+     */
+    region?: ScwRegion;
+    /**
+     * UUID of the hosting account.
+     */
+    hostingId: string;
+    /**
+     * Page number to retrieve.
+     */
+    page?: number;
+    /**
+     * Number of backups to return per page.
+     */
+    pageSize?: number;
+    /**
+     * Order in which to return the list of backups.
+     */
+    orderBy?: ListBackupsRequestOrderBy;
+};
+export type BackupApiRestoreBackupItemsRequest = {
+    /**
+     * Region to target. If none is passed will use default region from the config.
+     */
+    region?: ScwRegion;
+    /**
+     * UUID of the hosting account.
+     */
+    hostingId: string;
+    /**
+     * List of backup item IDs to restore individually.
+     */
+    itemIds?: string[];
+};
+export type BackupApiRestoreBackupRequest = {
+    /**
+     * Region to target. If none is passed will use default region from the config.
+     */
+    region?: ScwRegion;
+    /**
+     * UUID of the hosting account.
+     */
+    hostingId: string;
+    /**
+     * ID of the backup to fully restore.
+     */
+    backupId: string;
+};
 export interface CheckUserOwnsDomainResponse {
     /**
      * Indicates whether the specified project owns the domain.
@@ -730,6 +901,10 @@ export interface Domain {
      * Zone owner of the domain.
      */
     owner: DomainZoneOwner;
+    /**
+     * Main domain for this zone.
+     */
+    zoneDomainName: string;
     /**
      * A list of actions that can be performed on the domain.
      */
@@ -845,9 +1020,9 @@ export interface Hosting {
      */
     status: HostingStatus;
     /**
-     * Main domain associated with the Web Hosting plan.
+     * @deprecated Main domain associated with the Web Hosting plan (deprecated, use domain_info).
      */
-    domain: string;
+    domain?: string;
     /**
      * Details of the Web Hosting plan offer and options.
      */
@@ -861,7 +1036,7 @@ export interface Hosting {
      */
     tags: string[];
     /**
-     * @deprecated DNS status of the Web Hosting plan.
+     * @deprecated DNS status of the Web Hosting plan (deprecated, use domain_info).
      */
     dnsStatus?: DnsRecordsStatus;
     /**
@@ -877,14 +1052,32 @@ export interface Hosting {
      */
     user?: HostingUser;
     /**
-     * Main domain status of the Web Hosting plan.
+     * @deprecated Main domain status of the Web Hosting plan (deprecated, use domain_info).
      */
-    domainStatus: DomainStatus;
+    domainStatus?: DomainStatus;
     /**
      * Region where the Web Hosting plan is hosted.
      */
     region: ScwRegion;
+    /**
+     * Domain configuration block (subdomain, optional custom domain, and DNS settings).
+     */
+    domainInfo?: HostingDomain;
 }
+export type HostingApiAddCustomDomainRequest = {
+    /**
+     * Region to target. If none is passed will use default region from the config.
+     */
+    region?: ScwRegion;
+    /**
+     * Hosting ID to which the custom domain is attached to.
+     */
+    hostingId: string;
+    /**
+     * The custom domain name to attach to the hosting.
+     */
+    domainName: string;
+};
 export type HostingApiCreateHostingRequest = {
     /**
      * Region to target. If none is passed will use default region from the config.
@@ -910,6 +1103,10 @@ export type HostingApiCreateHostingRequest = {
      * Domain name to link to the Web Hosting plan. You must already own this domain name, and have completed the DNS validation process beforehand.
      */
     domain: string;
+    /**
+     * The name prefix to use as a free subdomain (for example, `mysite`) assigned to the Web Hosting plan. The full domain will be automatically created by adding it to the fixed base domain (e.g. `mysite.scw.site`). You do not need to include the base domain yourself.
+     */
+    subdomain?: string;
     /**
      * List of the Web Hosting plan options IDs with their quantities.
      */
@@ -1012,6 +1209,20 @@ export type HostingApiListHostingsRequest = {
      * Name of the control panel to filter for, only Web Hosting plans from this control panel will be returned.
      */
     controlPanels?: string[];
+    /**
+     * Optional free subdomain linked to the Web Hosting plan.
+     */
+    subdomain?: string;
+};
+export type HostingApiRemoveCustomDomainRequest = {
+    /**
+     * Region to target. If none is passed will use default region from the config.
+     */
+    region?: ScwRegion;
+    /**
+     * Hosting ID to which the custom domain is detached from.
+     */
+    hostingId: string;
 };
 export type HostingApiResetHostingPasswordRequest = {
     /**
@@ -1053,6 +1264,26 @@ export type HostingApiUpdateHostingRequest = {
      */
     protected?: boolean;
 };
+export interface ListBackupItemsResponse {
+    /**
+     * Total number of backup item groups.
+     */
+    totalCount: number;
+    /**
+     * List of backup item groups categorized by type.
+     */
+    groups: BackupItemGroup[];
+}
+export interface ListBackupsResponse {
+    /**
+     * Total number of available backups.
+     */
+    totalCount: number;
+    /**
+     * List of available backups.
+     */
+    backups: Backup[];
+}
 export interface ListControlPanelsResponse {
     /**
      * Number of control panels returned.
@@ -1275,6 +1506,10 @@ export interface ResourceSummary {
      */
     websitesCount: number;
 }
+export interface RestoreBackupItemsResponse {
+}
+export interface RestoreBackupResponse {
+}
 export interface SearchDomainsResponse {
     /**
      * List of domains availability.

package/dist/v1/validation-rules.gen.cjs

@@ -1,5 +1,14 @@
 "use strict";
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const BackupApiListBackupsRequest = {
+  page: {
+    greaterThan: 0
+  },
+  pageSize: {
+    greaterThan: 0,
+    lessThanOrEqual: 100
+  }
+};
 const ControlPanelApiListControlPanelsRequest = {
   page: {
     greaterThan: 0
@@ -72,6 +81,7 @@ const WebsiteApiListWebsitesRequest = {
     lessThanOrEqual: 100
   }
 };
+exports.BackupApiListBackupsRequest = BackupApiListBackupsRequest;
 exports.ControlPanelApiListControlPanelsRequest = ControlPanelApiListControlPanelsRequest;
 exports.DatabaseApiListDatabaseUsersRequest = DatabaseApiListDatabaseUsersRequest;
 exports.DatabaseApiListDatabasesRequest = DatabaseApiListDatabasesRequest;

package/dist/v1/validation-rules.gen.d.ts

@@ -1,3 +1,12 @@
+export declare const BackupApiListBackupsRequest: {
+    page: {
+        greaterThan: number;
+    };
+    pageSize: {
+        greaterThan: number;
+        lessThanOrEqual: number;
+    };
+};
 export declare const ControlPanelApiListControlPanelsRequest: {
     page: {
         greaterThan: number;

package/dist/v1/validation-rules.gen.js

@@ -1,3 +1,12 @@
+const BackupApiListBackupsRequest = {
+  page: {
+    greaterThan: 0
+  },
+  pageSize: {
+    greaterThan: 0,
+    lessThanOrEqual: 100
+  }
+};
 const ControlPanelApiListControlPanelsRequest = {
   page: {
     greaterThan: 0
@@ -71,6 +80,7 @@ const WebsiteApiListWebsitesRequest = {
   }
 };
 export {
+  BackupApiListBackupsRequest,
   ControlPanelApiListControlPanelsRequest,
   DatabaseApiListDatabaseUsersRequest,
   DatabaseApiListDatabasesRequest,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@scaleway/sdk-webhosting",
-  "version": "1.1.2",
+  "version": "1.2.0",
   "description": "Scaleway SDK webhosting",
   "license": "Apache-2.0",
   "files": [
@@ -26,17 +26,17 @@
     "directory": "packages_generated/webhosting"
   },
   "engines": {
-    "node": ">=20.19.1"
+    "node": ">=20.19.4"
   },
   "dependencies": {
-    "@scaleway/random-name": "5.1.1",
-    "@scaleway/sdk-std": "1.0.4"
+    "@scaleway/random-name": "5.1.2",
+    "@scaleway/sdk-std": "1.0.6"
   },
   "peerDependencies": {
-    "@scaleway/sdk-client": "^1.2.3"
+    "@scaleway/sdk-client": "^1.3.1"
   },
   "devDependencies": {
-    "@scaleway/sdk-client": "^1.2.3"
+    "@scaleway/sdk-client": "^1.3.1"
   },
   "scripts": {
     "package:check": "pnpm publint",