Release v1.142.0 – staging → master

docs/CONTRIBUTING.md

@@ -46,6 +46,7 @@ Two reviews from members of the Cloud Manager team are required before merge. Af
 
 Follow these best practices to write a good changeset:
 
+- Summarize your changes succinctly in 150 characters or less. A changeset shouldn't describe every line of code edited in the PR.
 - Use a consistent tense in all changeset entries. We have chosen to use **imperative (present)** tense. (This follows established [git commit message best practices](https://tbaggery.com/2008/04/19/a-note-about-git-commit-messages.html).)
 - Avoid starting a changeset with the verb "Add", "Remove", "Change" or "Fix" when listed under that respective `Added`, `Removed`, `Changed` or `Fixed` section. It is unnecessary repetition.
 - For `Fixed` changesets, describe the bug that needed to be fixed, rather than the fix itself. (e.g. say "Missing button labels in action buttons" rather than "Make label prop required for action buttons").

packages/api-v4/CHANGELOG.md

@@ -1,3 +1,12 @@
+## [2025-05-20] - v0.140.0
+
+### Upcoming Features:
+
+- Add Host & VM Maintenance types and queries ([#11990](https://github.com/linode/manager/pull/11990))
+- Add `SubnetAssignedNodeBalancerData` interface, `nodebalancers` property to `Subnet` interface, and `nodebalancer_id` property to `VCPIP` interface ([#12099](https://github.com/linode/manager/pull/12099))
+- CloudPulse: Add payload `DeleteAlertFeature` and request `deleteAlertDefinition` for handling user alert deletion ([#12134](https://github.com/linode/manager/pull/12134))
+- Add `/v4beta` endpoints and types for Node Pool requests ([#12188](https://github.com/linode/manager/pull/12188))
+
 ## [2025-05-06] - v0.139.0
 
 ### Upcoming Features:

packages/api-v4/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@linode/api-v4",
-  "version": "0.139.0",
+  "version": "0.140.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

@@ -2,27 +2,29 @@ import {
   updateAccountSchema,
   UpdateAccountSettingsSchema,
 } from '@linode/validation/lib/account.schema';
+
 import { API_ROOT, BETA_API_ROOT } from '../constants';
 import Request, {
   setData,
   setHeaders,
   setMethod,
-  setURL,
   setParams,
+  setURL,
   setXFilter,
 } from '../request';
-import {
+
+import type { Token } from '../profile';
+import type { Filter, Params, RequestOptions, ResourcePage } from '../types';
+import type {
   Account,
   AccountAvailability,
   AccountSettings,
+  Agreements,
   CancelAccount,
   CancelAccountPayload,
-  Agreements,
-  RegionalNetworkUtilization,
   ChildAccountPayload,
+  RegionalNetworkUtilization,
 } from './types';
-import type { Filter, ResourcePage, Params, RequestOptions } from '../types';
-import type { Token } from '../profile';
 
 /**
  * getAccountInfo
@@ -44,7 +46,7 @@ export const getAccountInfo = () => {
 export const getNetworkUtilization = () =>
   Request<RegionalNetworkUtilization>(
     setURL(`${API_ROOT}/account/transfer`),
-    setMethod('GET')
+    setMethod('GET'),
   );
 
 /**
@@ -57,7 +59,7 @@ export const updateAccountInfo = (data: Partial<Account>) =>
   Request<Account>(
     setURL(`${API_ROOT}/account`),
     setMethod('PUT'),
-    setData(data, updateAccountSchema)
+    setData(data, updateAccountSchema),
   );
 
 /**
@@ -69,7 +71,7 @@ export const updateAccountInfo = (data: Partial<Account>) =>
 export const getAccountSettings = () =>
   Request<AccountSettings>(
     setURL(`${API_ROOT}/account/settings`),
-    setMethod('GET')
+    setMethod('GET'),
   );
 
 /**
@@ -82,7 +84,7 @@ export const updateAccountSettings = (data: Partial<AccountSettings>) =>
   Request<AccountSettings>(
     setURL(`${API_ROOT}/account/settings`),
     setMethod('PUT'),
-    setData(data, UpdateAccountSettingsSchema)
+    setData(data, UpdateAccountSettingsSchema),
   );
 
 /**
@@ -94,7 +96,7 @@ export const cancelAccount = (data: CancelAccountPayload) => {
   return Request<CancelAccount>(
     setURL(`${API_ROOT}/account/cancel`),
     setMethod('POST'),
-    setData(data)
+    setData(data),
   );
 };
 
@@ -107,7 +109,7 @@ export const cancelAccount = (data: CancelAccountPayload) => {
 export const getAccountAgreements = () =>
   Request<Agreements>(
     setURL(`${BETA_API_ROOT}/account/agreements`),
-    setMethod('GET')
+    setMethod('GET'),
   );
 
 /**
@@ -122,7 +124,7 @@ export const getAccountAvailabilities = (params?: Params, filter?: Filter) =>
     setURL(`${BETA_API_ROOT}/account/availability`),
     setMethod('GET'),
     setParams(params),
-    setXFilter(filter)
+    setXFilter(filter),
   );
 
 /**
@@ -135,9 +137,9 @@ export const getAccountAvailabilities = (params?: Params, filter?: Filter) =>
 export const getAccountAvailability = (regionId: string) =>
   Request<AccountAvailability>(
     setURL(
-      `${BETA_API_ROOT}/account/availability/${encodeURIComponent(regionId)}`
+      `${BETA_API_ROOT}/account/availability/${encodeURIComponent(regionId)}`,
     ),
-    setMethod('GET')
+    setMethod('GET'),
   );
 
 /**
@@ -149,7 +151,7 @@ export const signAgreement = (data: Partial<Agreements>) => {
   return Request<{}>(
     setURL(`${BETA_API_ROOT}/account/agreements`),
     setMethod('POST'),
-    setData(data)
+    setData(data),
   );
 };
 
@@ -165,7 +167,7 @@ export const getChildAccounts = ({ filter, params, headers }: RequestOptions) =>
     setMethod('GET'),
     setHeaders(headers),
     setParams(params),
-    setXFilter(filter)
+    setXFilter(filter),
   );
 
 /**
@@ -178,7 +180,7 @@ export const getChildAccount = ({ euuid, headers }: ChildAccountPayload) =>
   Request<Account>(
     setURL(`${API_ROOT}/account/child-accounts/${encodeURIComponent(euuid)}`),
     setMethod('GET'),
-    setHeaders(headers)
+    setHeaders(headers),
   );
 
 /**
@@ -198,9 +200,9 @@ export const createChildAccountPersonalAccessToken = ({
 }: ChildAccountPayload) =>
   Request<Token>(
     setURL(
-      `${API_ROOT}/account/child-accounts/${encodeURIComponent(euuid)}/token`
+      `${API_ROOT}/account/child-accounts/${encodeURIComponent(euuid)}/token`,
     ),
     setMethod('POST'),
     setHeaders(headers),
-    setData(euuid)
+    setData(euuid),
   );

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

@@ -1,13 +1,14 @@
 import { API_ROOT } from '../constants';
 import Request, {
+  setData,
   setMethod,
   setParams,
   setURL,
   setXFilter,
-  setData,
 } from '../request';
-import { Filter, Params, ResourcePage } from '../types';
-import { AccountBeta, EnrollInBetaPayload } from './types';
+
+import type { Filter, Params, ResourcePage } from '../types';
+import type { AccountBeta, EnrollInBetaPayload } from './types';
 
 /**
  * getBetas
@@ -19,7 +20,7 @@ export const getAccountBetas = (params?: Params, filter?: Filter) =>
     setURL(`${API_ROOT}/account/betas`),
     setMethod('GET'),
     setParams(params),
-    setXFilter(filter)
+    setXFilter(filter),
   );
 
 /**
@@ -31,7 +32,7 @@ export const getAccountBetas = (params?: Params, filter?: Filter) =>
 export const getAccountBeta = (betaId: string) =>
   Request<AccountBeta>(
     setURL(`${API_ROOT}/account/betas/${encodeURIComponent(betaId)}`),
-    setMethod('GET')
+    setMethod('GET'),
   );
 
 /**
@@ -45,5 +46,5 @@ export const enrollInBeta = (data: EnrollInBetaPayload) =>
   Request<{}>(
     setURL(`${API_ROOT}/account/betas`),
     setMethod('POST'),
-    setData(data)
+    setData(data),
   );

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

@@ -1,7 +1,8 @@
 import { API_ROOT } from '../constants';
 import Request, { setMethod, setParams, setURL, setXFilter } from '../request';
-import { Filter, Params, ResourcePage } from '../types';
-import { Event, Notification } from './types';
+
+import type { Filter, Params, ResourcePage } from '../types';
+import type { Event, Notification } from './types';
 
 /**
  * getEvents
@@ -14,7 +15,7 @@ export const getEvents = (params: Params = {}, filter: Filter = {}) =>
     setURL(`${API_ROOT}/account/events`),
     setMethod('GET'),
     setXFilter(filter),
-    setParams(params)
+    setParams(params),
   );
 
 /**
@@ -26,7 +27,7 @@ export const getEvents = (params: Params = {}, filter: Filter = {}) =>
 export const getEvent = (eventId: number) =>
   Request<Event>(
     setURL(`${API_ROOT}/account/events/${encodeURIComponent(eventId)}`),
-    setMethod('GET')
+    setMethod('GET'),
   );
 
 /**
@@ -39,7 +40,7 @@ export const getEvent = (eventId: number) =>
 export const markEventSeen = (eventId: number) =>
   Request<{}>(
     setURL(`${API_ROOT}/account/events/${encodeURIComponent(eventId)}/seen`),
-    setMethod('POST')
+    setMethod('POST'),
   );
 
 /**
@@ -53,7 +54,7 @@ export const markEventSeen = (eventId: number) =>
 export const markEventRead = (eventId: number) =>
   Request<{}>(
     setURL(`${API_ROOT}/account/events/${encodeURIComponent(eventId)}/read`),
-    setMethod('POST')
+    setMethod('POST'),
   );
 
 /**
@@ -67,5 +68,5 @@ export const getNotifications = (params?: Params, filter?: Filter) =>
     setURL(`${API_ROOT}/account/notifications`),
     setMethod('GET'),
     setParams(params),
-    setXFilter(filter)
+    setXFilter(filter),
   );

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

@@ -6,16 +6,16 @@ export * from './events';
 
 export * from './invoices';
 
-export * from './payments';
+export * from './logins';
 
-export * from './users';
+export * from './maintenance';
 
 export * from './oauth';
 
+export * from './payments';
+
 export * from './promos';
 
 export * from './types';
 
-export * from './maintenance';
-
-export * from './logins';
+export * from './users';

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

@@ -1,7 +1,8 @@
 import { API_ROOT } from '../constants';
 import Request, { setMethod, setParams, setURL, setXFilter } from '../request';
-import { Filter, Params, ResourcePage } from '../types';
-import { Invoice, InvoiceItem } from './types';
+
+import type { Filter, Params, ResourcePage } from '../types';
+import type { Invoice, InvoiceItem } from './types';
 
 /**
  * getInvoices
@@ -14,7 +15,7 @@ export const getInvoices = (params?: Params, filter?: Filter) =>
     setURL(`${API_ROOT}/account/invoices`),
     setMethod('GET'),
     setParams(params),
-    setXFilter(filter)
+    setXFilter(filter),
   );
 
 /**
@@ -28,7 +29,7 @@ export const getInvoices = (params?: Params, filter?: Filter) =>
 export const getInvoice = (invoiceId: number) =>
   Request<Invoice>(
     setURL(`${API_ROOT}/account/invoices/${encodeURIComponent(invoiceId)}`),
-    setMethod('GET')
+    setMethod('GET'),
   );
 
 /**
@@ -43,13 +44,13 @@ export const getInvoice = (invoiceId: number) =>
 export const getInvoiceItems = (
   invoiceId: number,
   params?: Params,
-  filter?: Filter
+  filter?: Filter,
 ) =>
   Request<ResourcePage<InvoiceItem>>(
     setURL(
-      `${API_ROOT}/account/invoices/${encodeURIComponent(invoiceId)}/items`
+      `${API_ROOT}/account/invoices/${encodeURIComponent(invoiceId)}/items`,
     ),
     setMethod('GET'),
     setParams(params),
-    setXFilter(filter)
+    setXFilter(filter),
   );

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

@@ -1,7 +1,8 @@
 import { API_ROOT } from '../constants';
 import Request, { setMethod, setParams, setURL, setXFilter } from '../request';
-import { Filter, Params, ResourcePage } from '../types';
-import { AccountLogin } from './types';
+
+import type { Filter, Params, ResourcePage } from '../types';
+import type { AccountLogin } from './types';
 
 /**
  * getAccountLogins
@@ -14,7 +15,7 @@ export const getAccountLogins = (params?: Params, filter?: Filter) =>
     setURL(`${API_ROOT}/account/logins`),
     setMethod('GET'),
     setParams(params),
-    setXFilter(filter)
+    setXFilter(filter),
   );
 
 /**
@@ -28,5 +29,5 @@ export const getAccountLogins = (params?: Params, filter?: Filter) =>
 export const getAccountLogin = (loginId: number) =>
   Request<AccountLogin>(
     setURL(`${API_ROOT}/account/logins/${encodeURIComponent(loginId)}`),
-    setMethod('GET')
+    setMethod('GET'),
   );