Merge pull request #12306 from linode/staging

Release v1.143.0 - staging → master

Author: hana-akamai

docs/tooling/analytics.md

@@ -12,19 +12,20 @@ Pendo is configured in [`usePendo.js`](https://github.com/linode/manager/blob/de
 
 Important notes:
 
-- Pendo is only loaded if the user has enabled Performance Cookies via OneTrust *and* if a valid `PENDO_API_KEY` is configured as an environment variable. In our development, staging, and production environments, `PENDO_API_KEY` is available at build time. See **Locally Testing Page Views & Custom Events and/or Troubleshooting Pendo** for set up with local environments.
-- We load the Pendo agent from the CDN, rather than [self-hosting](https://support.pendo.io/hc/en-us/articles/360038969692-Self-hosting-the-Pendo-agent), and we have configured a [CNAME](https://support.pendo.io/hc/en-us/articles/360043539891-CNAME-for-Pendo).
+- Pendo is only loaded if a valid `PENDO_API_KEY` is configured as an environment variable. In our preview, development, staging, and production environments, `PENDO_API_KEY` is available at build time. See **Locally Testing Page Views & Custom Events and/or Troubleshooting Pendo** for set up with local environments.
+- We [self-host](https://support.pendo.io/hc/en-us/articles/360038969692-Self-hosting-the-Pendo-agent) and load the Pendo agent from Adobe Launch, rather than from the CDN, and we have configured a [CNAME](https://support.pendo.io/hc/en-us/articles/360043539891-CNAME-for-Pendo).
+- As configured by Adobe Launch, Pendo will respect OneTrust cookie preferences in development, staging, and production environments and does not check cookie preferences in preview environments. Pendo will not run on localhost:3000 because it needs a Optanon cookie with the linode.com domain for consent.
 - At initialization, we do string transformation on select URL patterns to **remove  sensitive data**. When new URL patterns are added to Cloud Manager, verify that existing transforms remove sensitive data; if not, update the transforms.
-- Pendo will respect OneTrust cookie preferences in development, staging, and production environments and does not check cookie preferences in the local environment.
 - Pendo makes use of the existing `data-testid` properties, used in our automated testing, for tagging elements. They are more persistent and reliable than CSS properties, which are liable to change.
 
 ### Locally Testing Page Views & Custom Events and/or Troubleshooting Pendo
 
 1. Set the `REACT_APP_PENDO_API_KEY` environment variable in `.env`.
-2. Use the browser tools Network tab, filter requests by "psp.cloud", and check that successful network requests have been made to load Pendo scripts (also visible in the browser tools Sources tab).
-3. In the browser console, type `pendo.validateEnvironment()`.
-4. You should see command output in the console, and it should include an `accountId` and a `visitorId` that correspond with your APIv4 account `euuid` and profile `uid`, respectively. Each page view change or custom event that fires should be visible as a request in the Network tab.
-5. If the console does not output the expected ids and instead outputs something like `Cookies are disabled in Pendo config. Is this expected?` in response to the above command, clear app storage with the browser tools. Once redirected back to Login, update the OneTrust cookie settings to enable cookies via "Manage Preferences" in the banner at the bottom of the screen. Log back into Cloud Manager and Pendo should load.
+2. Confirm the Adobe Launch script has loaded. (View it in the browser console Sources tab under the assets.adobedtm.com directory.)
+3. Use the browser tools Network tab, filter requests by "psp.cloud", and check that successful network requests have been made to load Pendo scripts (also visible in the browser tools Sources tab).
+4. In the browser console, type `pendo.validateEnvironment()`.
+5. You should see command output in the console, and it should include an `accountId` and a `visitorId` that correspond with your APIv4 account `euuid` and profile `uid`, respectively. Each page view change or custom event that fires should be visible as a request in the Network tab.
+6. If the console does not output the expected ids and instead outputs something like `Cookies are disabled in Pendo config. Is this expected?` in response to the above command, clear app storage with the browser tools. Once redirected back to Login, update the OneTrust cookie settings to enable cookies via "Manage Preferences" in the banner at the bottom of the screen. Log back into Cloud Manager and Pendo should load.
 
 ## Adobe Analytics
 

package.json

@@ -19,6 +19,7 @@
     "eslint-plugin-prettier": "~5.2.6",
     "eslint-plugin-react": "^7.37.4",
     "eslint-plugin-react-hooks": "^5.2.0",
+    "eslint-plugin-react-refresh": "0.4.20",
     "eslint-plugin-sonarjs": "^3.0.2",
     "eslint-plugin-testing-library": "^7.1.1",
     "eslint-plugin-xss": "^0.1.12",

packages/api-v4/CHANGELOG.md

@@ -1,3 +1,23 @@
+## [2025-06-03] - v0.141.0
+
+### Added:
+
+- Notification type for QEMU maintenance ([#12231](https://github.com/linode/manager/pull/12231))
+- PrivateNetwork type for Use in DBaaS requests ([#12281](https://github.com/linode/manager/pull/12281))
+
+### Changed:
+
+- Make `lke_cluster` and `type` defined in the `NodeBalancer` type ([#12217](https://github.com/linode/manager/pull/12217))
+- Mark `markEventRead` as deprecated ([#12274](https://github.com/linode/manager/pull/12274))
+
+### Fixed:
+
+- Make quota_id a string ([#12272](https://github.com/linode/manager/pull/12272))
+
+### Removed:
+
+- `add_buckets` from `GlobalGrantTypes` ([#12223](https://github.com/linode/manager/pull/12223))
+
 ## [2025-05-20] - v0.140.0
 
 ### Upcoming Features:

packages/api-v4/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@linode/api-v4",
-  "version": "0.140.0",
+  "version": "0.141.0",
   "homepage": "https://github.com/linode/manager/tree/develop/packages/api-v4",
   "bugs": {
     "url": "https://github.com/linode/manager/issues"
@@ -56,6 +56,7 @@
     "lib"
   ],
   "devDependencies": {
+    "@linode/tsconfig": "workspace:*",
     "axios-mock-adapter": "^1.22.0",
     "concurrently": "^9.0.1",
     "tsup": "^8.4.0"

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

@@ -33,7 +33,7 @@ export const getEvent = (eventId: number) =>
 /**
  * markEventSeen
  *
- * Set the "seen" property of an event to true
+ * Marks all events up to and including the referenced event ID as "seen"
  *
  * @param eventId { number } ID of the event to designate as seen
  */
@@ -50,6 +50,10 @@ export const markEventSeen = (eventId: number) =>
  *
  * @param eventId { number } ID of the event to designate as read
  *
+ * @deprecated As of `5/20/2025`, this endpoint is deprecated. It will be sunset on `6/17/2025`.
+ *
+ * If you depend on using `read`, you may be able to use `markEventSeen` and `seen` instead.
+ * Please note that the `seen` endpoint functions differently and will mark all events up to and including the referenced event ID as "seen" rather than individual events.
  */
 export const markEventRead = (eventId: number) =>
   Request<{}>(

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

@@ -199,7 +199,6 @@ export interface Grant {
 }
 export type GlobalGrantTypes =
   | 'account_access'
-  | 'add_buckets'
   | 'add_databases'
   | 'add_domains'
   | 'add_firewalls'
@@ -286,6 +285,7 @@ export type NotificationType =
   | 'payment_due'
   | 'promotion'
   | 'reboot_scheduled'
+  | 'security_reboot_maintenance_scheduled'
   | 'tax_id_verifying'
   | 'ticket_abuse'
   | 'ticket_important'
@@ -574,7 +574,7 @@ export interface AccountMaintenance {
   entity: {
     id: number;
     label: string;
-    type: string;
+    type: 'linode' | 'volume';
     url: string;
   };
   maintenance_policy_set: MaintenancePolicyType;

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

@@ -127,6 +127,12 @@ export interface DatabaseInstance {
 
 export type ClusterSize = 1 | 2 | 3;
 
+export interface PrivateNetwork {
+  public_access: boolean;
+  subnet_id: null | number;
+  vpc_id: null | number;
+}
+
 type ReadonlyCount = 0 | 2;
 
 /** @deprecated TODO (UIE-8214) remove POST GA */
@@ -139,6 +145,7 @@ export interface CreateDatabasePayload {
   encrypted?: boolean;
   engine?: Engine;
   label: string;
+  private_network?: null | PrivateNetwork; //  TODO (UIE-8831): Remove optional (?) post VPC release, since it will always be in create payload
   region: string;
   /** @Deprecated used by rdbms-legacy only */
   replication_type?: MySQLReplicationType | PostgresReplicationType;

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

@@ -22,7 +22,7 @@ import type {
   CreateNodeBalancerPayload,
   NodeBalancer,
   NodeBalancerStats,
-  NodebalancerVpcConfig,
+  NodeBalancerVpcConfig,
 } from './types';
 
 /**
@@ -193,7 +193,7 @@ export const getNodeBalancerVPCConfigsBeta = (
   params?: Params,
   filter?: Filter,
 ) =>
-  Request<Page<NodebalancerVpcConfig>>(
+  Request<Page<NodeBalancerVpcConfig>>(
     setURL(
       `${BETA_API_ROOT}/nodebalancers/${encodeURIComponent(
         nodeBalancerId,
@@ -214,7 +214,7 @@ export const getNodeBalancerVPCConfigBeta = (
   nodeBalancerId: number,
   nbVpcConfigId: number,
 ) =>
-  Request<NodebalancerVpcConfig>(
+  Request<NodeBalancerVpcConfig>(
     setURL(
       `${BETA_API_ROOT}/nodebalancers/${encodeURIComponent(
         nodeBalancerId,

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

@@ -42,11 +42,11 @@ export interface NodeBalancer {
    * If the NB is associated with a cluster (active or deleted), return its info
    * If the NB is not associated with a cluster, return null
    */
-  lke_cluster?: LKEClusterInfo | null;
+  lke_cluster: LKEClusterInfo | null;
   region: string;
   tags: string[];
   transfer: BalancerTransfer;
-  type?: NodeBalancerType;
+  type: NodeBalancerType;
   updated: string;
 }
 
@@ -134,7 +134,13 @@ export interface NodeBalancerStats {
   title: string;
 }
 
-export interface NodebalancerVpcConfig {
+export interface NodeBalancerVpcPayload {
+  ipv4_range?: string;
+  ipv6_range?: string;
+  subnet_id: number;
+}
+
+export interface NodeBalancerVpcConfig {
   id: number;
   ipv4_range: null | string;
   ipv6_range: null | string;
@@ -247,9 +253,5 @@ export interface CreateNodeBalancerPayload {
   label?: string;
   region?: string;
   tags?: string[];
-  vpcs?: {
-    ipv4_range: string;
-    ipv6_range?: string;
-    subnet_id: number;
-  }[];
+  vpcs?: NodeBalancerVpcPayload[];
 }

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

@@ -45,9 +45,9 @@ export const getQuotas = (
  * Returns the usage for a single quota within a particular service specified by `type`.
  *
  * @param type { QuotaType } retrieve a quota within this service type.
- * @param id { number } the quota ID to look up.
+ * @param id { string } the quota ID to look up.
  */
-export const getQuotaUsage = (type: QuotaType, id: number) =>
+export const getQuotaUsage = (type: QuotaType, id: string) =>
   Request<QuotaUsage>(
     setURL(`${BETA_API_ROOT}/${type}/quotas/${id}/usage`),
     setMethod('GET'),