Merge pull request #13181 from linode/staging

Release v1.156.0 - `staging` → `master`

Author: dwiley-akamai

package.json

@@ -8,8 +8,8 @@
     "concurrently": "9.1.0",
     "husky": "^9.1.6",
     "typescript": "^5.7.3",
-    "vitest": "^3.2.4",
-    "@vitest/ui": "^3.2.4",
+    "vitest": "^4.0.10",
+    "@vitest/ui": "^4.0.10",
     "lint-staged": "^15.4.3",
     "eslint": "^9.24.0",
     "eslint-config-prettier": "^10.1.1",

packages/api-v4/CHANGELOG.md

@@ -1,3 +1,25 @@
+## [2025-12-09] - v0.154.0
+
+
+### Changed:
+
+- Update database restoreWithBackup data to include region ([#13097](https://github.com/linode/manager/pull/13097))
+- Add private_network to `DatabaseBackupsPayload` ([#13174](https://github.com/linode/manager/pull/13174))
+
+### Tech Stories:
+
+- Add `@types/node` as a devDependency ([#13119](https://github.com/linode/manager/pull/13119))
+
+### Upcoming Features:
+
+- Add new API endpoints and types for Network Load Balancers ([#13078](https://github.com/linode/manager/pull/13078))
+- Update FirewallRuleType to support ruleset ([#13079](https://github.com/linode/manager/pull/13079))
+- Add additional status types `enabling`, `disabling`, `provisioning` in CloudPulse alerts ([#13127](https://github.com/linode/manager/pull/13127))
+- CloudPulse-Metrics: Update `entity_ids` type in `CloudPulseMetricsRequest` for metrics api in endpoints dahsboard ([#13133](https://github.com/linode/manager/pull/13133))
+- Add `deleted` property to `FirewallPrefixList` type after API update ([#13146](https://github.com/linode/manager/pull/13146))
+- Added Database Connection Pool types and endpoints ([#13148](https://github.com/linode/manager/pull/13148))
+- Add 'Cloud Firewall Rule Set' to AccountCapability type ([#13156](https://github.com/linode/manager/pull/13156))
+
 ## [2025-11-18] - v0.153.0
 
 

packages/api-v4/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@linode/api-v4",
-  "version": "0.153.0",
+  "version": "0.154.0",
   "homepage": "https://github.com/linode/manager/tree/develop/packages/api-v4",
   "bugs": {
     "url": "https://github.com/linode/manager/issues"
@@ -59,7 +59,8 @@
     "@linode/tsconfig": "workspace:*",
     "axios-mock-adapter": "^1.22.0",
     "concurrently": "^9.0.1",
-    "tsup": "^8.4.0"
+    "tsup": "^8.4.0",
+    "@types/node": "^22.13.14"
   },
   "lint-staged": {
     "*.{ts,tsx,js}": [

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

@@ -66,6 +66,7 @@ export const accountCapabilities = [
   'Block Storage',
   'Block Storage Encryption',
   'Cloud Firewall',
+  'Cloud Firewall Rule Set',
   'CloudPulse',
   'Disk Encryption',
   'Kubernetes',
@@ -80,6 +81,7 @@ export const accountCapabilities = [
   'Managed Databases',
   'Managed Databases Beta',
   'NETINT Quadra T1U',
+  'Network LoadBalancer',
   'NodeBalancers',
   'Object Storage Access Key Regions',
   'Object Storage Endpoint Types',

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

@@ -19,8 +19,15 @@ export type DimensionFilterOperatorType =
   | 'neq'
   | 'startswith';
 export type AlertDefinitionType = 'system' | 'user';
-export type AlertStatusType = 'disabled' | 'enabled' | 'failed' | 'in progress';
 export type AlertDefinitionScope = 'account' | 'entity' | 'region';
+export type AlertStatusType =
+  | 'disabled'
+  | 'disabling'
+  | 'enabled'
+  | 'enabling'
+  | 'failed'
+  | 'in progress'
+  | 'provisioning';
 export type CriteriaConditionType = 'ALL';
 export type MetricUnitType =
   | 'bit_per_second'
@@ -152,7 +159,7 @@ export interface Metric {
 export interface CloudPulseMetricsRequest {
   absolute_time_duration: DateTimeWithPreset | undefined;
   associated_entity_region?: string;
-  entity_ids: number[] | string[];
+  entity_ids: number[] | string[] | undefined;
   entity_region?: string;
   filters?: Filters[];
   group_by?: string[];

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

@@ -1,5 +1,7 @@
 import {
+  createDatabaseConnectionPoolSchema,
   createDatabaseSchema,
+  updateDatabaseConnectionPoolSchema,
   updateDatabaseSchema,
 } from '@linode/validation/lib/databases.schema';
 
@@ -14,13 +16,14 @@ import Request, {
 
 import type { Filter, ResourcePage as Page, Params } from '../types';
 import type {
+  ConnectionPool,
   CreateDatabasePayload,
   Database,
   DatabaseBackup,
+  DatabaseBackupsPayload,
   DatabaseCredentials,
   DatabaseEngine,
   DatabaseEngineConfig,
-  DatabaseFork,
   DatabaseInstance,
   DatabaseType,
   Engine,
@@ -267,11 +270,14 @@ export const legacyRestoreWithBackup = (
  *
  * Fully restore a backup to the cluster
  */
-export const restoreWithBackup = (engine: Engine, fork: DatabaseFork) =>
+export const restoreWithBackup = (
+  engine: Engine,
+  data: DatabaseBackupsPayload,
+) =>
   Request<Database>(
     setURL(`${API_ROOT}/databases/${encodeURIComponent(engine)}/instances`),
     setMethod('POST'),
-    setData({ fork }),
+    setData(data),
   );
 
 /**
@@ -361,3 +367,73 @@ export const getDatabaseEngineConfig = (engine: Engine) =>
     setURL(`${API_ROOT}/databases/${encodeURIComponent(engine)}/config`),
     setMethod('GET'),
   );
+
+/**
+ * Get a paginated list of connection pools for a database
+ */
+export const getDatabaseConnectionPools = (databaseID: number) =>
+  Request<Page<ConnectionPool>>(
+    setURL(
+      `${API_ROOT}/databases/postgresql/instances/${encodeURIComponent(databaseID)}/connection-pools`,
+    ),
+    setMethod('GET'),
+  );
+
+/**
+ * Get a connection pool for a database
+ */
+export const getDatabaseConnectionPool = (
+  databaseID: number,
+  poolName: string,
+) =>
+  Request<ConnectionPool>(
+    setURL(
+      `${API_ROOT}/databases/postgresql/instances/${encodeURIComponent(databaseID)}/connection-pools/${encodeURIComponent(poolName)}`,
+    ),
+    setMethod('GET'),
+  );
+
+/**
+ * Create a new connection pool for a database. Connection pools can only be created on active clusters
+ */
+export const createDatabaseConnectionPool = (
+  databaseID: number,
+  data: ConnectionPool,
+) =>
+  Request<ConnectionPool>(
+    setURL(
+      `${API_ROOT}/databases/postgresql/instances/${encodeURIComponent(databaseID)}/connection-pools`,
+    ),
+    setMethod('POST'),
+    setData(data, createDatabaseConnectionPoolSchema),
+  );
+
+/**
+ * Update an existing connection pool. This may cause sudden closure of an in-use connection pool
+ */
+export const updateDatabaseConnectionPool = (
+  databaseID: number,
+  poolName: string,
+  data: Omit<ConnectionPool, 'label'>,
+) =>
+  Request<ConnectionPool>(
+    setURL(
+      `${API_ROOT}/databases/postgresql/instances/${encodeURIComponent(databaseID)}/connection-pools/${encodeURIComponent(poolName)}`,
+    ),
+    setMethod('PUT'),
+    setData(data, updateDatabaseConnectionPoolSchema),
+  );
+
+/**
+ * Delete an existing connection pool. This may cause sudden closure of an in-use connection pool
+ */
+export const deleteDatabaseConnectionPool = (
+  databaseID: number,
+  poolName: string,
+) =>
+  Request<{}>(
+    setURL(
+      `${API_ROOT}/databases/postgresql/instances/${encodeURIComponent(databaseID)}/connection-pools/${encodeURIComponent(poolName)}`,
+    ),
+    setMethod('DELETE'),
+  );

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

@@ -79,6 +79,12 @@ export interface DatabaseFork {
   source: number;
 }
 
+export interface DatabaseBackupsPayload {
+  fork: DatabaseFork;
+  private_network?: null | PrivateNetwork;
+  region?: string;
+}
+
 export interface DatabaseCredentials {
   password: string;
   username: string;
@@ -100,6 +106,7 @@ type MemberType = 'failover' | 'primary';
 export interface DatabaseInstance {
   allow_list: string[];
   cluster_size: ClusterSize;
+  connection_pool_port: null | number;
   connection_strings: ConnectionStrings[];
   created: string;
   /** @Deprecated used by rdbms-legacy only, rdbms-default always encrypts */
@@ -163,12 +170,10 @@ interface ConnectionStrings {
   value: string;
 }
 
-export type UpdatesFrequency = 'monthly' | 'weekly';
-
 export interface UpdatesSchedule {
   day_of_week: number;
   duration: number;
-  frequency: UpdatesFrequency;
+  frequency: 'monthly' | 'weekly';
   hour_of_day: number;
   pending?: PendingUpdates[];
   week_of_month: null | number;
@@ -246,3 +251,13 @@ export interface UpdateDatabasePayload {
   updates?: UpdatesSchedule;
   version?: string;
 }
+
+export type PoolMode = 'session' | 'statement' | 'transaction';
+
+export interface ConnectionPool {
+  database: string;
+  label: string;
+  mode: PoolMode;
+  size: number;
+  username: null | string;
+}

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

@@ -36,16 +36,26 @@ export type UpdateFirewallRules = Omit<
 
 export type FirewallTemplateRules = UpdateFirewallRules;
 
+/**
+ * The API may return either a full firewall rule object or a ruleset reference
+ * containing only the `ruleset` field. This interface supports both formats
+ * to ensure backward compatibility with existing implementations and avoid
+ * widespread refactoring.
+ */
 export interface FirewallRuleType {
-  action: FirewallPolicyType;
+  action?: FirewallPolicyType | null;
   addresses?: null | {
     ipv4?: null | string[];
     ipv6?: null | string[];
   };
   description?: null | string;
   label?: null | string;
-  ports?: string;
-  protocol: FirewallRuleProtocol;
+  ports?: null | string;
+  protocol?: FirewallRuleProtocol | null;
+  /**
+   * Present when the object represents a ruleset reference.
+   */
+  ruleset?: null | number;
 }
 
 export interface FirewallDeviceEntity {
@@ -124,6 +134,7 @@ export type FirewallPrefixListVisibility = 'private' | 'public' | 'restricted';
 
 export interface FirewallPrefixList {
   created: string;
+  deleted: null | string;
   description: string;
   id: number;
   ipv4?: null | string[];

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

@@ -1,6 +1,13 @@
 import { BETA_API_ROOT } from '../constants';
-import Request, { setData, setMethod, setURL } from '../request';
+import Request, {
+  setData,
+  setMethod,
+  setParams,
+  setURL,
+  setXFilter,
+} from '../request';
 
+import type { Filter, Params, ResourcePage } from '../types';
 import type {
   AccessType,
   EntityByPermission,
@@ -9,7 +16,6 @@ import type {
   PermissionType,
 } from './types';
 import type { EntityType } from 'src/entities/types';
-
 /**
  * getUserRoles
  *
@@ -93,6 +99,8 @@ export const getUserEntityPermissions = (
   username: string,
   entityType: AccessType,
   entityId: number | string,
+  params?: Params,
+  filter?: Filter,
 ) =>
   Request<PermissionType[]>(
     setURL(
@@ -101,6 +109,8 @@ export const getUserEntityPermissions = (
       )}/permissions/${entityType}/${entityId}`,
     ),
     setMethod('GET'),
+    setParams(params),
+    setXFilter(filter),
   );
 
 /**
@@ -109,7 +119,10 @@ export const getUserEntityPermissions = (
  * Returns the available entities for a given permission.
  */
 export interface GetEntitiesByPermissionParams {
+  enabled?: boolean;
   entityType: EntityType;
+  filter?: Filter;
+  params?: Params;
   permission: PermissionType;
   username: string | undefined;
 }
@@ -118,10 +131,14 @@ export const getUserEntitiesByPermission = ({
   username,
   entityType,
   permission,
+  params,
+  filter,
 }: GetEntitiesByPermissionParams) =>
-  Request<EntityByPermission[]>(
+  Request<ResourcePage<EntityByPermission>>(
     setURL(
       `${BETA_API_ROOT}/iam/users/${username}/entities/${entityType}?permission=${permission}`,
     ),
     setMethod('GET'),
+    setParams(params),
+    setXFilter(filter),
   );

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

@@ -457,7 +457,7 @@ export interface Roles {
   permissions: PermissionType[];
 }
 export interface EntityByPermission {
-  id: number;
+  id: number | string;
   label: string;
   type: EntityType;
 }