Release v1.145.0 - staging → master

.gitignore

@@ -12,6 +12,7 @@ lib
 .vscode
 .idea
 **/*.iml
+*.mdc
 
 # misc
 .DS_Store

docs/development-guide/02-component-structure.md

@@ -17,7 +17,7 @@ Here is a minimal code example demonstrating the basic structure of a component
 ```tsx
 import { omittedProps } from "@linode/ui";
 import { styled } from "@mui/material/styles";
-import * as React from "react";
+import * as React from 'react';
 
 // If not exported, it can just be named `Props`
 export interface SayHelloProps {

docs/development-guide/05-fetching-data.md

@@ -125,7 +125,7 @@ export const useProfile = () =>
 Loading and error states are managed by React Query. The earlier username display example becomes greatly simplified:
 
 ```tsx
-import * as React from "react";
+import * as React from 'react';
 import { useProfile } from "src/queries/profile";
 
 const UsernameDisplay = () => {
@@ -166,7 +166,7 @@ Before React Query, Redux was used to store API data, loading, and error states.
 ```tsx
 // ---- OLD PATTERN, DON'T USE ---- //
 
-import * as React from "react";
+import * as React from 'react';
 import profileContainer, {
   Props as ProfileProps,
 } from "src/containers/profile.container";

docs/development-guide/08-testing.md

@@ -210,12 +210,13 @@ Environment variables related to Cypress logging and reporting, as well as repor
 |---------------------------------|----------------------------------------------------|------------------|----------------------------|
 | `CY_TEST_USER_REPORT`           | Log test account information when tests begin      | `1`              | Unset; disabled by default |
 | `CY_TEST_JUNIT_REPORT`          | Enable JUnit reporting                             | `1`              | Unset; disabled by default |
-| `CY_TEST_HTML_REPORT`          | Generate html report containing E2E test results   | `1`              | Unset; disabled by default |
+| `CY_TEST_HTML_REPORT`           | Generate html report containing E2E test results   | `1`              | Unset; disabled by default |
 | `CY_TEST_DISABLE_FILE_WATCHING` | Disable file watching in Cypress UI                | `1`              | Unset; disabled by default |
 | `CY_TEST_DISABLE_RETRIES`       | Disable test retries on failure in CI              | `1`              | Unset; disabled by default |
 | `CY_TEST_FAIL_ON_MANAGED`       | Fail affected tests when Managed is enabled        | `1`              | Unset; disabled by default |
 | `CY_TEST_GENWEIGHTS`            | Generate and output test weights to the given path | `./weights.json` | Unset; disabled by default |
 | `CY_TEST_RESET_PREFERENCES`     | Reset user preferences when test run begins        | `1`              | Unset; disabled by default |
+| `CY_TEST_RESOURCE_PREFIX`       | Prefix to apply to labels of created resources     | `test-resource`  | Unset; default `cy-test`   |
 
 ###### Performance
 

docs/development-guide/11-feature-flags.md

@@ -45,7 +45,7 @@ export interface Flags {
 To consume a feature flag from a function component, use the `useFlags` hook:
 
 ```tsx
-import * as React from "react";
+import * as React from 'react';
 import { useFlags } from "src/hooks/useFlags";
 
 const ImagesPricingBanner = () => {
@@ -62,7 +62,7 @@ const ImagesPricingBanner = () => {
 For (older) class components, use the `withFeatureFlagConsumer` HOC:
 
 ```tsx
-import * as React from "react";
+import * as React from 'react';
 import withFeatureFlags, {
   FeatureFlagConsumerProps,
 } from "src/containers/withFeatureFlagConsumer.container";

package.json

@@ -69,7 +69,6 @@
     "prepare": "husky"
   },
   "resolutions": {
-    "node-fetch": "^2.6.7",
     "semver": "^7.5.2",
     "yaml": "^2.3.0"
   },

packages/api-v4/CHANGELOG.md

@@ -1,3 +1,23 @@
+## [2025-07-01] - v0.143.0
+
+### Changed:
+
+- Allow `authorized_keys`  to be null in  `Profile` type ([#12390](https://github.com/linode/manager/pull/12390))
+
+### Removed:
+
+- `is_beta` flag from ServiceTypes interface in cloudpulse types ([#12386](https://github.com/linode/manager/pull/12386))
+
+### Upcoming Features:
+
+- Add Beta ACLP alerts property to the `CreateLinodeRequest` type ([#12248](https://github.com/linode/manager/pull/12248))
+- Add `parent_entity` field to `FirewallDeviceEntity` ([#12283](https://github.com/linode/manager/pull/12283))
+- Fix `getMaintenancePolicies` to properly handle pagination params and return all maintenance policies ([#12334](https://github.com/linode/manager/pull/12334))
+- Add `scope` in `Alert` and `EditAlertDefinitionPayload` interfaces, rename `ServiceTypes` interface to `Service`, add `ServiceAlert` interface ([#12377](https://github.com/linode/manager/pull/12377))
+- Add maintenance policy types for VM maintenance API ([#12417](https://github.com/linode/manager/pull/12417))
+- Add `monitors` field to the `Region` type ([#12375](https://github.com/linode/manager/pull/12375))
+- Add CRUD CloudNAT types ([#12379](https://github.com/linode/manager/pull/12379))
+
 ## [2025-06-17] - v0.142.0
 
 

packages/api-v4/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@linode/api-v4",
-  "version": "0.142.0",
+  "version": "0.143.0",
   "homepage": "https://github.com/linode/manager/tree/develop/packages/api-v4",
   "bugs": {
     "url": "https://github.com/linode/manager/issues"

packages/api-v4/src/account/account.ts

@@ -70,7 +70,7 @@ export const updateAccountInfo = (data: Partial<Account>) =>
  */
 export const getAccountSettings = () =>
   Request<AccountSettings>(
-    setURL(`${API_ROOT}/account/settings`),
+    setURL(`${BETA_API_ROOT}/account/settings`),
     setMethod('GET'),
   );
 
@@ -82,7 +82,7 @@ export const getAccountSettings = () =>
  */
 export const updateAccountSettings = (data: Partial<AccountSettings>) =>
   Request<AccountSettings>(
-    setURL(`${API_ROOT}/account/settings`),
+    setURL(`${BETA_API_ROOT}/account/settings`),
     setMethod('PUT'),
     setData(data, UpdateAccountSettingsSchema),
   );

packages/api-v4/src/account/maintenance.ts

@@ -24,8 +24,10 @@ export const getAccountMaintenance = (params?: Params, filter?: Filter) =>
  * Returns a list of maintenance policies that are available for Linodes in this account.
  *
  */
-export const getMaintenancePolicies = () =>
-  Request<MaintenancePolicy[]>(
+export const getMaintenancePolicies = (params?: Params, filter?: Filter) =>
+  Request<ResourcePage<MaintenancePolicy>>(
     setURL(`${BETA_API_ROOT}/maintenance/policies`),
     setMethod('GET'),
+    setParams(params),
+    setXFilter(filter),
   );

packages/api-v4/src/account/types.ts

@@ -109,7 +109,7 @@ export interface AccountSettings {
   backups_enabled: boolean;
   interfaces_for_new_linodes: LinodeInterfaceAccountSetting;
   longview_subscription: null | string;
-  maintenance_policy_id: MaintenancePolicyId;
+  maintenance_policy: MaintenancePolicySlug;
   managed: boolean;
   network_helper: boolean;
   object_storage: 'active' | 'disabled' | 'suspended';
@@ -504,8 +504,10 @@ export const EventActionKeys = [
 export type EventAction = (typeof EventActionKeys)[number];
 
 export type EventStatus =
+  | 'canceled'
   | 'failed'
   | 'finished'
+  | 'in-progress'
   | 'notification'
   | 'scheduled'
   | 'started';
@@ -514,25 +516,25 @@ export type EventSource = 'platform' | 'user';
 
 export interface Event {
   action: EventAction;
-  complete_time?: null | string; // @TODO VM & Host Maintenance: verify new fields
+  complete_time?: null | string;
   created: string;
-  description?: null | string; // @TODO VM & Host Maintenance: verify new fields
+  description?: null | string;
   /*
     NOTE: events before the duration key was added will have a duration of 0
   */
   duration: null | number;
   entity: Entity | null;
   id: number;
-  maintenance_policy_set?: MaintenancePolicyType | null; // @TODO VM & Host Maintenance: verify new fields
+  maintenance_policy_set?: MaintenancePolicySlug | null;
   message: null | string;
-  not_before?: null | string; // @TODO VM & Host Maintenance: verify new fields
+  not_before?: null | string;
   percent_complete: null | number;
   rate: null | string;
   read: boolean;
   secondary_entity: Entity | null;
   seen: boolean;
-  source?: EventSource | null; // @TODO VM & Host Maintenance: verify new fields
-  start_time?: null | string; // @TODO VM & Host Maintenance: verify new fields
+  source?: EventSource | null;
+  start_time?: null | string;
   status: EventStatus;
   time_remaining: null | string;
   username: null | string;
@@ -577,7 +579,7 @@ export interface AccountMaintenance {
     type: 'linode' | 'volume';
     url: string;
   };
-  maintenance_policy_set: MaintenancePolicyType;
+  maintenance_policy_set: MaintenancePolicySlug;
   not_before: string;
   reason: string;
   source: 'platform' | 'user';
@@ -589,25 +591,26 @@ export interface AccountMaintenance {
     | 'pending'
     | 'scheduled'
     | 'started';
-  type: 'cold_migration' | 'live_migration' | 'reboot' | 'volume_migration';
+  type:
+    | 'cold_migration'
+    | 'live_migration'
+    | 'migrate'
+    | 'power_off_on'
+    | 'reboot'
+    | 'volume_migration';
   when: string;
 }
 
-export const maintenancePolicies = [
-  { id: 1, type: 'migrate' },
-  { id: 2, type: 'power on/off' },
-] as const;
-
-export type MaintenancePolicyId = (typeof maintenancePolicies)[number]['id'];
+// Note: In the future there will be more slugs, ie: 'private/1234'.
+export type MaintenancePolicySlug = 'linode/migrate' | 'linode/power_off_on';
 
-export type MaintenancePolicyType =
-  (typeof maintenancePolicies)[number]['type'];
-
-export type MaintenancePolicy = (typeof maintenancePolicies)[number] & {
+export type MaintenancePolicy = {
   description: string;
   is_default: boolean;
-  name: string;
+  label: 'Migrate' | 'Power Off / Power On';
   notification_period_sec: number;
+  slug: MaintenancePolicySlug;
+  type: 'linode_migrate' | 'linode_power_off_on' | 'migrate' | 'power_off_on'; // Should not be needed for UX. Mainly for FleetOps.
 };
 
 export interface PayPalData {

packages/api-v4/src/cloudnat/cloudnats.ts

@@ -0,0 +1,51 @@
+import { createCloudNATSchema } from '@linode/validation';
+
+import { API_ROOT } from '../constants';
+import Request, {
+  setData,
+  setMethod,
+  setParams,
+  setURL,
+  setXFilter,
+} from '../request';
+
+import type { Filter, ResourcePage as Page, Params } from '../types';
+import type {
+  CloudNAT,
+  CreateCloudNATPayload,
+  UpdateCloudNATPayload,
+} from './types';
+
+export const getCloudNATs = (params?: Params, filter?: Filter) =>
+  Request<Page<CloudNAT>>(
+    setURL(`${API_ROOT}/networking/cloudnats`),
+    setMethod('GET'),
+    setParams(params),
+    setXFilter(filter),
+  );
+
+export const getCloudNAT = (id: number) =>
+  Request<CloudNAT>(
+    setURL(`${API_ROOT}/networking/cloudnats/${id}`),
+    setMethod('GET'),
+  );
+
+export const createCloudNAT = (data: CreateCloudNATPayload) =>
+  Request<CloudNAT>(
+    setURL(`${API_ROOT}/networking/cloudnats`),
+    setMethod('POST'),
+    setData(data, createCloudNATSchema),
+  );
+
+export const updateCloudNAT = (id: number, data: UpdateCloudNATPayload) =>
+  Request<CloudNAT>(
+    setURL(`${API_ROOT}/networking/cloudnats/${id}`),
+    setMethod('PUT'),
+    setData(data, createCloudNATSchema),
+  );
+
+export const deleteCloudNAT = (id: number) =>
+  Request<{}>(
+    setURL(`${API_ROOT}/networking/cloudnats/${id}`),
+    setMethod('DELETE'),
+  );

packages/api-v4/src/cloudnat/index.ts

@@ -0,0 +1,3 @@
+export * from './cloudnats';
+
+export * from './types';

packages/api-v4/src/cloudnat/types.ts

@@ -0,0 +1,28 @@
+interface CloudNATIPAddress {
+  address: string;
+}
+
+export interface CloudNAT {
+  addresses: CloudNATIPAddress[];
+  id: number;
+  label: string;
+  port_prefix_default_len: number;
+  region: string;
+}
+
+export interface CreateCloudNATPayload {
+  addresses?: CloudNATIPAddress[];
+  label: string;
+  port_prefix_default_len?: ValidPortSize;
+  region: string;
+}
+
+export interface UpdateCloudNATPayload {
+  label?: string;
+}
+
+export const VALID_PORT_SIZES = [
+  64, 128, 256, 512, 1024, 2048, 4096, 8192, 16384,
+] as const;
+
+export type ValidPortSize = (typeof VALID_PORT_SIZES)[number];

packages/api-v4/src/cloudpulse/services.ts

@@ -12,7 +12,7 @@ import type {
   JWEToken,
   JWETokenPayLoad,
   MetricDefinition,
-  ServiceTypes,
+  Service,
   ServiceTypesList,
 } from './types';
 import type { Filter, Params, ResourcePage } from 'src/types';
@@ -51,7 +51,7 @@ export const getCloudPulseServiceTypes = () =>
   );
 
 export const getCloudPulseServiceByServiceType = (serviceType: string) =>
-  Request<ServiceTypes>(
+  Request<Service>(
     setURL(`${API_ROOT}/monitor/services/${encodeURIComponent(serviceType)}`),
     setMethod('GET'),
   );