@rancher/shell 3.0.12-rc.2 → 3.0.12-rc.3

package/types/shell/index.d.ts

@@ -2511,6 +2511,35 @@ export namespace AUTOSCALER_ENABLED {
     let formatter_72: string;
     export { formatter_72 as formatter };
 }
+export namespace MGMT_CLUSTER_PROVIDER {
+    let name_128: string;
+    export { name_128 as name };
+    let labelKey_125: string;
+    export { labelKey_125 as labelKey };
+    export let subLabel: string;
+    let value_126: string;
+    export { value_126 as value };
+    let sort_116: string[];
+    export { sort_116 as sort };
+    let search_20: string[];
+    export { search_20 as search };
+    let formatter_73: string;
+    export { formatter_73 as formatter };
+}
+export namespace MGMT_CLUSTER_KUBE_VERSION {
+    let name_129: string;
+    export { name_129 as name };
+    let labelKey_126: string;
+    export { labelKey_126 as labelKey };
+    let subLabel_1: string;
+    export { subLabel_1 as subLabel };
+    let sort_117: string;
+    export { sort_117 as sort };
+    let search_21: string;
+    export { search_21 as search };
+    let formatter_74: string;
+    export { formatter_74 as formatter };
+}
 }
 
 // @shell/config/table-headers.js
@@ -4281,6 +4310,35 @@ export namespace AUTOSCALER_ENABLED {
     let formatter_72: string;
     export { formatter_72 as formatter };
 }
+export namespace MGMT_CLUSTER_PROVIDER {
+    let name_128: string;
+    export { name_128 as name };
+    let labelKey_125: string;
+    export { labelKey_125 as labelKey };
+    export let subLabel: string;
+    let value_126: string;
+    export { value_126 as value };
+    let sort_116: string[];
+    export { sort_116 as sort };
+    let search_20: string[];
+    export { search_20 as search };
+    let formatter_73: string;
+    export { formatter_73 as formatter };
+}
+export namespace MGMT_CLUSTER_KUBE_VERSION {
+    let name_129: string;
+    export { name_129 as name };
+    let labelKey_126: string;
+    export { labelKey_126 as labelKey };
+    let subLabel_1: string;
+    export { subLabel_1 as subLabel };
+    let sort_117: string;
+    export { sort_117 as sort };
+    let search_21: string;
+    export { search_21 as search };
+    let formatter_74: string;
+    export { formatter_74 as formatter };
+}
 }
 
 // @shell/config/types
@@ -4497,6 +4555,7 @@ export namespace MANAGEMENT {
     export let RKE_TEMPLATE_REVISION: string;
     export let CLUSTER_PROXY_CONFIG: string;
     export let OIDC_CLIENT: string;
+    export let PROXY_ENDPOINT: string;
 }
 export namespace BRAND {
     let SUSE: string;
@@ -4872,6 +4931,7 @@ export namespace MANAGEMENT {
     export let RKE_TEMPLATE_REVISION: string;
     export let CLUSTER_PROXY_CONFIG: string;
     export let OIDC_CLIENT: string;
+    export let PROXY_ENDPOINT: string;
 }
 export namespace BRAND {
     let SUSE: string;
@@ -6040,6 +6100,7 @@ export default class Ingress {
     get useNestedBackendField(): any;
     get serviceNamePath(): "service.name" | "serviceName";
     get servicePortPath(): "service.port.number" | "servicePort";
+    get servicePortNamePath(): "servicePort" | "service.port.name";
     get defaultBackendPath(): "defaultBackend" | "backend";
     get hasDefaultBackend(): boolean;
     get details(): any;
@@ -6103,6 +6164,7 @@ export default class Ingress {
     get useNestedBackendField(): any;
     get serviceNamePath(): "service.name" | "serviceName";
     get servicePortPath(): "service.port.number" | "servicePort";
+    get servicePortNamePath(): "servicePort" | "service.port.name";
     get defaultBackendPath(): "defaultBackend" | "backend";
     get hasDefaultBackend(): boolean;
     get details(): any;
@@ -6223,7 +6285,7 @@ declare namespace _default {
         commit: any;
         dispatch: any;
         state: any;
-    }, type: any, compareWatches: any): void;
+    }, payload: any): void;
     export function promptRemove({ commit, state }: {
         commit: any;
         state: any;
@@ -6393,7 +6455,7 @@ declare namespace _default {
         commit: any;
         dispatch: any;
         state: any;
-    }, type: any, compareWatches: any): void;
+    }, payload: any): void;
     export function promptRemove({ commit, state }: {
         commit: any;
         state: any;
@@ -8378,6 +8440,16 @@ export function compareChartVersions(v1: string, v2: string): number;
  * @returns {Object} The latest compatible chart version object.
  */
 export function getLatestCompatibleVersion(chart: any, workerOSs: Array<string>, showPrerelease: boolean): any;
+/**
+ * Builds the route URL for the standalone chart readme page.
+ *
+ * The helper maps chart context into query params so the readme page can fetch
+ * version info directly (instead of relying on local/session storage transfer).
+ */
+export function getStandaloneReadmeUrl(router: any, { cluster, repoType, repoName, chartName, versionName, deprecated, showAppReadme, hideReadmeFirstTitle, }?: {
+    showAppReadme?: boolean;
+    hideReadmeFirstTitle?: boolean;
+}): any;
 }
 
 // @shell/utils/chart.js
@@ -8405,6 +8477,16 @@ export function compareChartVersions(v1: string, v2: string): number;
  * @returns {Object} The latest compatible chart version object.
  */
 export function getLatestCompatibleVersion(chart: any, workerOSs: Array<string>, showPrerelease: boolean): any;
+/**
+ * Builds the route URL for the standalone chart readme page.
+ *
+ * The helper maps chart context into query params so the readme page can fetch
+ * version info directly (instead of relying on local/session storage transfer).
+ */
+export function getStandaloneReadmeUrl(router: any, { cluster, repoType, repoName, chartName, versionName, deprecated, showAppReadme, hideReadmeFirstTitle, }?: {
+    showAppReadme?: boolean;
+    hideReadmeFirstTitle?: boolean;
+}): any;
 }
 
 // @shell/utils/clipboard
@@ -10460,6 +10542,14 @@ export function sanitizeIP(v: any): any;
  */
 export function xOfy(x: any, y: any): string;
 export function isBase64(value: any): boolean;
+/**
+ * Checks if a value is a valid base64-encoded CA bundle.
+ * Unlike isBase64, this handles multiline base64 (e.g. openssl wraps at 76 chars)
+ * and rejects short strings that could be false positives.
+ * @param {string} value
+ * @returns {boolean}
+ */
+export function isBase64EncodedCert(value: string): boolean;
 export function generateRandomAlphaString(length: any): string;
 /**
  * Generate a key-value nested object from a list of paths that represents a directory tree.
@@ -10526,6 +10616,14 @@ export function sanitizeIP(v: any): any;
  */
 export function xOfy(x: any, y: any): string;
 export function isBase64(value: any): boolean;
+/**
+ * Checks if a value is a valid base64-encoded CA bundle.
+ * Unlike isBase64, this handles multiline base64 (e.g. openssl wraps at 76 chars)
+ * and rejects short strings that could be false positives.
+ * @param {string} value
+ * @returns {boolean}
+ */
+export function isBase64EncodedCert(value: string): boolean;
 export function generateRandomAlphaString(length: any): string;
 /**
  * Generate a key-value nested object from a list of paths that represents a directory tree.
@@ -10960,6 +11058,7 @@ export function isServerUrl(value: any): boolean;
 export function isHttps(value: any): any;
 export function isDomainWithoutProtocol(value: any): boolean;
 export function isLocalhost(value: any): boolean;
+export function isValidUrl(value: any): boolean;
 export function hasTrailingForwardSlash(value: any): any;
 }
 
@@ -10970,6 +11069,7 @@ export function isServerUrl(value: any): boolean;
 export function isHttps(value: any): any;
 export function isDomainWithoutProtocol(value: any): boolean;
 export function isLocalhost(value: any): boolean;
+export function isValidUrl(value: any): boolean;
 export function hasTrailingForwardSlash(value: any): any;
 }
 

package/types/store/dashboard-store.types.ts

@@ -2,21 +2,68 @@ import { KubeLabelSelector } from '@shell/types/kube/kube-api';
 import { PaginationArgs, StorePagination } from '@shell/types/store/pagination.types';
 
 /**
- * Properties on all findX actions
+ * @internal
+ * Core properties on all findX actions
  */
-export type ActionCoreFindArgs = {
+export type ActionCoreFindOptions = {
+  /**
+   * Use this to override URL instead of looking up the URL for the type/id
+   */
   url?: string,
+  /**
+   * Force the request to go to the server instead of checking for a cached value first
+   */
   force?: boolean,
 }
 
 /**
+ * @internal
+ * Args used for find action
+ */
+export interface ActionFindArgs extends ActionCoreFindOptions {
+  /**
+   * Watch for changes
+   *
+   * false = no, all other values = yes
+   */
+  watch?: boolean,
+  /**
+   * @internal
+   * Whether to invalidate the page cache (default: false)
+   */
+  invalidatePageCache?: boolean,
+  /**
+   * XHR request verbs `get`, `post`, `put`, `delete` (default: get)
+   */
+  method?: string,
+  /**
+   * Used if we want to specify custom headers for the request
+   */
+  headers?: object,
+  /**
+   * Use this to override URL instead of looking up the URL for the type/id
+   */
+  url?: string,
+}
+
+/**
+ * @internal
  * Args used for findAll action
  */
-export interface ActionFindAllArgs extends ActionCoreFindArgs {
+export interface ActionFindAllArgs extends ActionCoreFindOptions {
+  /**
+   * Watch for changes
+   *
+   * false = no, all other values = yes
+   */
   watch?: boolean,
+  /**
+   * Array of namespaces to filter by (used in url path, not part of pagination params)
+   */
   namespaced?: string[],
   /**
-   * Should resources be fetched in increments?
+   * @internal
+   * Properties that determine and control if resources should be fetched in increments
    */
   incremental?: {
     /**
@@ -38,24 +85,32 @@ export interface ActionFindAllArgs extends ActionCoreFindArgs {
      */
     pageByNumber: boolean,
   },
+  /**
+   * @internal
+   * Flag to indicate if this request is coming from a list with manual refresh, which may require different handling in the store
+   */
   hasManualRefresh?: boolean,
+  /**
+   * Number of records to return per page
+   */
   limit?: number,
   /**
-   * Iterate over all pages and return all resources.
-   *
-   * This is done via the native kube pagination api, not steve
+   * @internal
+   * Iterate over all pages and return all resources. This is done via the native kube pagination api, not Steve
    */
   depaginate?: boolean,
   /**
+   * @internal
    * Specifies the name to use if we should save the count returned in the paginated request
    */
   saveCountAs?: string,
 }
 
 /**
+ * @internal
  * Args used for findPage action
  */
-export interface ActionFindPageArgs extends ActionCoreFindArgs {
+export interface ActionFindPageArgs extends ActionCoreFindOptions {
   /**
    * Set of pagination settings that creates the url.
    *
@@ -73,6 +128,7 @@ export interface ActionFindPageArgs extends ActionCoreFindArgs {
    */
   watch?: boolean,
   /**
+   * @internal
    * Does this request stem from a list with manual refresh?
    */
   hasManualRefresh?: boolean,
@@ -81,6 +137,10 @@ export interface ActionFindPageArgs extends ActionCoreFindArgs {
    */
   transient?: boolean,
 
+  /**
+   * @internal
+   * Specifies the name to use if we should save the count returned in the paginated request
+   */
   saveCountAs?: string,
 
   /**
@@ -97,6 +157,14 @@ export interface ActionFindPageArgs extends ActionCoreFindArgs {
 }
 
 /**
+ * @internal
+ * Response to the find action
+ * resource object returned by the API, or null if not found
+ */
+export type ActionFindResponse<T = any> = T;
+
+/**
+ * @internal
  * Response to a transient (not stored in cache) findPage action
  */
 export type ActionFindPageTransientResponse<T = any> = {
@@ -105,6 +173,7 @@ export type ActionFindPageTransientResponse<T = any> = {
 };
 
 /**
+ * @internal
  * Response to the findPage action
  *
  * If the request was transient (not stored in cache) this will be an object contain all the details of the request
@@ -114,20 +183,48 @@ export type ActionFindPageTransientResponse<T = any> = {
 export type ActionFindPageResponse<T = any> = ActionFindPageTransientResponse | T[];
 
 /**
- * Args used for findPage action
+ * Args used for findMatching action
  */
-export interface ActionFindMatchingArgs extends ActionCoreFindArgs {
+export interface ActionFindMatchingArgs extends ActionCoreFindOptions {
+  /**
+   * Represents the label selector to filter by
+   * @example
+   * ```
+   * {
+   *   matchLabels: {
+   *     app: 'my-app',
+   *     tier: 'frontend'
+   *   },
+   *   matchExpressions: [
+   *     {
+   *       key: 'environment',
+   *       operator: 'In',
+   *       values: ['production', 'staging']
+   *     }
+   *   ]
+   * }
+   * ```
+   */
   labelSelector: KubeLabelSelector,
+  /**
+   * The single namespace to filter by (used in url path, not part of pagination params)
+   */
   namespaced?: string,
+  /**
+   * @internal
+   * Iterate over all pages and return all resources.
+   */
   depaginate?: boolean
 }
 
 /**
+ * @internal
  * Response to the findMatching action
  */
 export type ActionFindMatchingResponse<T = any> = ActionFindPageResponse<T>
 
 /**
+ * @internal
  * Args used for findLabelSelector action
  */
-export type ActionFindLabelSelectorArgs = ActionFindPageArgs | ActionFindMatchingArgs;
+export type ActionFindLabelSelectorArgs = Omit<ActionFindPageArgs, 'pagination' | 'namespace'> | ActionFindMatchingArgs;

package/types/store/pagination.types.ts

@@ -44,13 +44,16 @@ export interface PaginationSort {
    * Name of field within the object to sort by
    */
   field: string,
+  /**
+   * Sort direction. `true` for ascending, `false` for descending
+   */
   asc: boolean
 }
 
 /**
  * Equalities that can be used with a `filter` query param
  *
- * filter=<field><equality><values>
+ * `filter=<field><equality><values>`
  *
  * For example
  * - filter=a=b
@@ -143,14 +146,14 @@ type FilterFieldCtorArgs = {
 /**
  * Filter the pagination result by these specific fields
  *
- * In format of <field><equality><value>
+ * In format of `<field><equality><value>`
  *
  * For example
  *
  * - metadata.name=test
  * - metadata.namespace!=system
  *
- * These are sub items for @PaginationParam, for example filter=<PaginationFilterField>
+ * These are sub items for {@link PaginationParam}, for example `filter=<PaginationFilterField>`
  *
  * For more information regarding the API see https://github.com/rancher/steve?tab=readme-ov-file#query-parameters
  */

package/utils/__tests__/alertmanagerconfig.test.ts

@@ -0,0 +1,117 @@
+import { Buffer } from 'buffer';
+import { areRoutesSupportedFormat, canCreate, createDefaultRouteName } from '@shell/utils/alertmanagerconfig';
+
+function makeSecret(yaml: string | null): { data: Record<string, string> } {
+  if (yaml === null) {
+    return { data: {} };
+  }
+
+  return { data: { 'alertmanager.yaml': Buffer.from(yaml).toString('base64') } };
+}
+
+describe('alertmanagerconfig utils', () => {
+  describe('createDefaultRouteName', () => {
+    it.each([
+      {
+        desc:     'index 0',
+        index:    0,
+        expected: 'route-0',
+      },
+      {
+        desc:     'index 1',
+        index:    1,
+        expected: 'route-1',
+      },
+      {
+        desc:     'index 99',
+        index:    99,
+        expected: 'route-99',
+      },
+    ])('returns $expected for $desc', ({ index, expected }) => {
+      expect(createDefaultRouteName(index)).toStrictEqual(expected);
+    });
+  });
+
+  describe('areRoutesSupportedFormat', () => {
+    it('returns true when secret has no data', () => {
+      const secret = makeSecret(null);
+
+      expect(areRoutesSupportedFormat(secret)).toStrictEqual(true);
+    });
+
+    it('returns true when config has no routes', () => {
+      const secret = makeSecret('receivers: []\nroute: {}');
+
+      expect(areRoutesSupportedFormat(secret)).toStrictEqual(true);
+    });
+
+    it('returns true when all routes are non-empty', () => {
+      const yaml = `
+receivers: []
+route:
+  routes:
+    - receiver: team-a
+      match:
+        severity: critical
+`;
+      const secret = makeSecret(yaml);
+
+      expect(areRoutesSupportedFormat(secret)).toStrictEqual(true);
+    });
+
+    it('returns false when any route is an empty object', () => {
+      const yaml = `
+receivers: []
+route:
+  routes:
+    - {}
+`;
+      const secret = makeSecret(yaml);
+
+      expect(areRoutesSupportedFormat(secret)).toStrictEqual(false);
+    });
+
+    it('returns false when the yaml is invalid', () => {
+      const secret = { data: { 'alertmanager.yaml': Buffer.from(': invalid: yaml: {').toString('base64') } };
+
+      expect(areRoutesSupportedFormat(secret)).toStrictEqual(false);
+    });
+
+    it('returns true when routes array is empty', () => {
+      const yaml = `
+route:
+  routes: []
+`;
+      const secret = makeSecret(yaml);
+
+      expect(areRoutesSupportedFormat(secret)).toStrictEqual(true);
+    });
+
+    it('returns false when one of multiple routes is empty', () => {
+      const yaml = `
+receivers: []
+route:
+  routes:
+    - receiver: team-a
+    - {}
+`;
+      const secret = makeSecret(yaml);
+
+      expect(areRoutesSupportedFormat(secret)).toStrictEqual(false);
+    });
+  });
+
+  describe('canCreate', () => {
+    it('returns true when secret type is creatable', () => {
+      const rootGetters = { 'type-map/optionsFor': () => ({ isCreatable: true }) };
+
+      expect(canCreate(rootGetters)).toStrictEqual(true);
+    });
+
+    it('returns false when secret type is not creatable', () => {
+      const rootGetters = { 'type-map/optionsFor': () => ({ isCreatable: false }) };
+
+      expect(canCreate(rootGetters)).toStrictEqual(false);
+    });
+  });
+});

package/utils/__tests__/async.test.ts

@@ -0,0 +1,87 @@
+import { waitFor, wait } from '@shell/utils/async';
+
+describe('wait', () => {
+  it('resolves after the specified delay', async() => {
+    jest.useFakeTimers();
+
+    const p = wait(1000);
+
+    jest.advanceTimersByTime(1000);
+    await expect(p).resolves.toBeUndefined();
+
+    jest.useRealTimers();
+  });
+
+  it('does not resolve before the delay elapses', async() => {
+    jest.useFakeTimers();
+
+    let resolved = false;
+    const p = wait(500).then(() => {
+      resolved = true;
+    });
+
+    jest.advanceTimersByTime(499);
+    expect(resolved).toBe(false);
+
+    jest.advanceTimersByTime(1);
+    await p;
+    expect(resolved).toBe(true);
+
+    jest.useRealTimers();
+  });
+});
+
+describe('waitFor', () => {
+  afterEach(() => {
+    jest.useRealTimers();
+  });
+
+  it('resolves immediately when testFn returns true on first call', async() => {
+    jest.useFakeTimers();
+    const testFn = jest.fn().mockReturnValue(true);
+
+    const p = waitFor(testFn, 'ready');
+
+    await expect(p).resolves.toBeDefined();
+    expect(testFn).toHaveBeenCalledTimes(1);
+  });
+
+  it('resolves after testFn eventually returns true', async() => {
+    jest.useFakeTimers();
+    let count = 0;
+    const testFn = jest.fn().mockImplementation(() => {
+      count++;
+
+      return count >= 3;
+    });
+
+    const p = waitFor(testFn, 'ready', 10000, 500);
+
+    // first call returns false (immediate check), then intervals fire
+    jest.advanceTimersByTime(500); // interval 1 → count=2, false
+    jest.advanceTimersByTime(500); // interval 2 → count=3, true
+    await p;
+
+    expect(testFn).toHaveBeenCalledTimes(3);
+  });
+
+  it('rejects with msg when timeout elapses', async() => {
+    jest.useFakeTimers();
+    const testFn = jest.fn().mockReturnValue(false);
+
+    const p = waitFor(testFn, 'some condition', 1000, 500);
+
+    jest.advanceTimersByTime(1001);
+    await expect(p).rejects.toThrow('Failed waiting for: some condition');
+  });
+
+  it('rejects with generic message when no msg provided and timeout elapses', async() => {
+    jest.useFakeTimers();
+    const testFn = jest.fn().mockReturnValue(false);
+
+    const p = waitFor(testFn, '', 2000, 500);
+
+    jest.advanceTimersByTime(2001);
+    await expect(p).rejects.toThrow('waitFor timed out after 2 seconds');
+  });
+});