@devtron-labs/devtron-fe-common-lib 0.0.61 → 0.0.62-beta-1

package/dist/Common/Api.d.ts

@@ -1,5 +1,14 @@
 import { ResponseType, APIOptions } from './Types';
+import { MutableRefObject } from 'react';
 export declare const post: (url: string, data: object, options?: APIOptions, isMultipartRequest?: boolean) => Promise<ResponseType>;
 export declare const put: (url: string, data: object, options?: APIOptions) => Promise<ResponseType>;
 export declare const get: (url: string, options?: APIOptions) => Promise<ResponseType>;
 export declare const trash: (url: string, data?: object, options?: APIOptions) => Promise<ResponseType>;
+/**
+ * Aborts the previous request before triggering next request
+ */
+export declare const abortPreviousRequests: <T>(callback: () => Promise<T>, abortControllerRef: MutableRefObject<AbortController>) => Promise<T>;
+/**
+ * Returns true if the error is due to a aborted request
+ */
+export declare const getIsRequestAborted: (error: any) => boolean;

package/dist/Common/Constants.d.ts

@@ -73,3 +73,17 @@ export declare const SELECTED_APPROVAL_TAB_STATE: {
     APPROVAL: string;
     PENDING: string;
 };
+export declare enum SortingOrder {
+    /**
+     * Ascending order
+     */
+    ASC = "ASC",
+    /**
+     * Descending order
+     */
+    DESC = "DESC"
+}
+/**
+ * Base page size for pagination
+ */
+export declare const DEFAULT_BASE_PAGE_SIZE = 20;

package/dist/Common/DraggableWrapper/types.d.ts

@@ -5,7 +5,10 @@ export declare enum DraggablePositionVariant {
 }
 export interface DraggableWrapperProps {
     children: ReactNode;
-    zIndex?: number;
+    /**
+     * Support for passing the direct value or calc functions as well
+     */
+    zIndex?: number | string;
     positionVariant?: DraggablePositionVariant;
     /**
      * dragSelector (class - (append with .), id, etc) will be used to identify the grabbable button that will grab the div to drag

package/dist/Common/Hooks/index.d.ts

@@ -1,3 +1,4 @@
 export { useSuperAdmin } from './UseSuperAdmin/UseSuperAdmin';
 export { useClickOutside } from './UseClickOutside/UseClickOutside';
 export { useWindowSize } from './UseWindowSize/UseWindowSize';
+export * from './useUrlFilters';

package/dist/Common/Hooks/useUrlFilters/constants.d.ts

@@ -0,0 +1,8 @@
+export declare const DEFAULT_PAGE_NUMBER = 1;
+export declare const URL_FILTER_KEYS: {
+    readonly PAGE_SIZE: "pageSize";
+    readonly PAGE_NUMBER: "pageNumber";
+    readonly SEARCH_KEY: "searchKey";
+    readonly SORT_BY: "sortBy";
+    readonly SORT_ORDER: "sortOrder";
+};

package/dist/Common/Hooks/useUrlFilters/index.d.ts

@@ -0,0 +1,2 @@
+export { default as useUrlFilters } from './useUrlFilters';
+export type { UseUrlFiltersProps, UseUrlFiltersReturnType } from './types';

package/dist/Common/Hooks/useUrlFilters/types.d.ts

@@ -0,0 +1,19 @@
+import { SortingOrder } from '../../Constants';
+export interface UseUrlFiltersProps<T> {
+    /**
+     * The key on which the sorting should be applied
+     */
+    initialSortKey?: T;
+}
+export interface UseUrlFiltersReturnType<T> {
+    pageSize: number;
+    changePage: (pageNumber: number) => void;
+    changePageSize: (pageSize: number) => void;
+    searchKey: string;
+    handleSearch: (searchKey: string) => void;
+    offset: number;
+    sortBy: T;
+    sortOrder: SortingOrder;
+    handleSorting: (sortBy: T) => void;
+    clearFilters: () => void;
+}

package/dist/Common/Hooks/useUrlFilters/useUrlFilters.d.ts

@@ -0,0 +1,20 @@
+import { UseUrlFiltersProps, UseUrlFiltersReturnType } from './types';
+/**
+ * Generic hook for implementing URL based filters.
+ * eg: pagination, search, sort.
+ *
+ * The exposed handlers can be consumed directly without the need for explicit state management
+ *
+ * @example Default Usage:
+ * ```tsx
+ * const { pageSize, changePage, ...rest } = useUrlFilters()
+ * ```
+ *
+ * @example Usage with custom type for sort keys and initial sort key:
+ * ```tsx
+ * const  { sortBy, sortOrder } = useUrlFilters<'email' | 'name'>({ initialSortKey: 'email' })
+ * ```
+ *
+ */
+declare const useUrlFilters: <T = string>({ initialSortKey }?: UseUrlFiltersProps<T>) => UseUrlFiltersReturnType<T>;
+export default useUrlFilters;

package/dist/Common/SortableTableHeaderCell/SortableTableHeaderCell.d.ts

@@ -0,0 +1,18 @@
+/// <reference types="react" />
+import { SortableTableHeaderCellProps } from './types';
+/**
+ * Reusable component for the table header cell with support for sorting icons
+ *
+ * @example Usage
+ * ```tsx
+ * <SortableTableHeaderCell
+ *   isSorted={currentSortedCell === 'cell'}
+ *   triggerSorting={() => {}}
+ *   sortOrder={SortingOrder.ASC}
+ *   title="Header Cell"
+ *   disabled={isDisabled}
+ * />
+ * ```
+ */
+declare const SortableTableHeaderCell: ({ isSorted, triggerSorting, sortOrder, title, disabled, }: SortableTableHeaderCellProps) => JSX.Element;
+export default SortableTableHeaderCell;

package/dist/Common/SortableTableHeaderCell/index.d.ts

@@ -0,0 +1,2 @@
+export { default as SortableTableHeaderCell } from './SortableTableHeaderCell';
+export type { SortableTableHeaderCellProps } from './types';

package/dist/Common/SortableTableHeaderCell/types.d.ts

@@ -0,0 +1,25 @@
+import { SortingOrder } from '../Constants';
+export interface SortableTableHeaderCellProps {
+    /**
+     * If true, the cell is sorted
+     */
+    isSorted: boolean;
+    /**
+     * Callback for handling the sorting of the cell
+     */
+    triggerSorting: () => void;
+    /**
+     * Current sort order
+     *
+     * Note: On click, the sort order should be updated as required
+     */
+    sortOrder: SortingOrder;
+    /**
+     * Label for the cell
+     */
+    title: string;
+    /**
+     * If true, the cell is disabled
+     */
+    disabled: boolean;
+}

package/dist/Common/Types.d.ts

@@ -1,7 +1,7 @@
 import React, { ReactNode, CSSProperties } from 'react';
 import { Placement } from 'tippy.js';
 import { ImageComment, ReleaseTag } from './ImageTags.Types';
-import { DockerConfigOverrideType, TaskErrorObj } from '.';
+import { DockerConfigOverrideType, SortingOrder, TaskErrorObj } from '.';
 /**
  * Generic response type object with support for overriding the result type
  *
@@ -44,12 +44,13 @@ export interface Teams {
 }
 export declare enum CHECKBOX_VALUE {
     CHECKED = "CHECKED",
-    INTERMEDIATE = "INTERMEDIATE"
+    INTERMEDIATE = "INTERMEDIATE",
+    BULK_CHECKED = "BULK_CHECKED"
 }
 export interface CheckboxProps {
     onChange: (event: any) => void;
     isChecked: boolean;
-    value: 'CHECKED' | 'INTERMEDIATE';
+    value: 'CHECKED' | 'INTERMEDIATE' | 'BULK_CHECKED';
     disabled?: boolean;
     tabIndex?: number;
     rootClassName?: string;
@@ -688,4 +689,16 @@ export interface EdgeNodeType {
 export interface EdgeEndNodeType extends EdgeNodeType {
     userApprovalConfig?: UserApprovalConfigType;
 }
+/**
+ * Search params for sorting configuration
+ *
+ * Note: Either both sortOrder and sortBy are required or none
+ */
+export type SortingParams<T = string> = {
+    sortOrder: SortingOrder;
+    sortBy: T;
+} | {
+    sortOrder?: never;
+    sortBy?: never;
+};
 export {};

package/dist/Common/index.d.ts

@@ -27,6 +27,7 @@ export * from './Checkbox';
 export { default as EmptyState } from './EmptyState/EmptyState';
 export { default as GenericEmptyState } from './EmptyState/GenericEmptyState';
 export * from './SearchBar';
+export * from './SortableTableHeaderCell';
 export { default as Toggle } from './Toggle/Toggle';
 export { default as ScanVulnerabilitiesTable } from './Security/ScanVulnerabilitiesTable';
 export { default as StyledRadioGroup } from './RadioGroup/RadioGroup';

package/dist/Pages/GlobalConfigurations/Authorization/constants.d.ts

@@ -0,0 +1,15 @@
+/**
+ * User Status received from the API
+ */
+export declare enum UserStatusDto {
+    active = "active",
+    inactive = "inactive"
+}
+/**
+ * User status for the frontend
+ */
+export declare enum UserStatus {
+    active = "active",
+    inactive = "inactive",
+    temporary = "temporaryAccess"
+}

package/dist/Pages/GlobalConfigurations/Authorization/index.d.ts

@@ -0,0 +1 @@
+export * from './constants';

package/dist/Pages/GlobalConfigurations/index.d.ts

@@ -0,0 +1 @@
+export * from './Authorization';

package/dist/Pages/index.d.ts

@@ -0,0 +1 @@
+export * from './GlobalConfigurations';

package/dist/Shared/Components/BulkSelection/BulkSelection.d.ts

@@ -0,0 +1,4 @@
+/// <reference types="react" />
+import { BulkSelectionProps } from './types';
+declare const BulkSelection: <T>({ showPagination }: BulkSelectionProps) => JSX.Element;
+export default BulkSelection;

package/dist/Shared/Components/BulkSelection/BulkSelectionDropdownItems.d.ts

@@ -0,0 +1,4 @@
+/// <reference types="react" />
+import { BulkSelectionDropdownItemsProps } from './types';
+declare const BulkSelectionDropdownItems: <T>({ locator, label, isSelected, handleBulkSelection, icon: Icon, }: BulkSelectionDropdownItemsProps<T>) => JSX.Element;
+export default BulkSelectionDropdownItems;

package/dist/Shared/Components/BulkSelection/BulkSelectionProvider.d.ts

@@ -0,0 +1,4 @@
+/// <reference types="react" />
+import { UseBulkSelectionProps, UseBulkSelectionReturnType } from './types';
+export declare const useBulkSelection: <T>() => UseBulkSelectionReturnType<T>;
+export declare const BulkSelectionProvider: <T>({ children, identifiers, getSelectAllDialogStatus, }: UseBulkSelectionProps<T>) => JSX.Element;

package/dist/Shared/Components/BulkSelection/constants.d.ts

@@ -0,0 +1,9 @@
+export declare const BULK_DROPDOWN_TEST_ID: "bulk-selection-pop-up-menu";
+export declare const BulkSelectionOptionsLabels: {
+    readonly SELECT_ALL_ON_PAGE: "All on this page";
+    readonly SELECT_ALL_ACROSS_PAGES: "All across pages";
+    readonly CLEAR_ALL_SELECTIONS: "Clear selection";
+};
+export declare const SELECT_ALL_ACROSS_PAGES_LOCATOR: "*";
+export declare const getInvalidActionMessage: (action: string) => string;
+export declare const BULK_SELECTION_CONTEXT_ERROR = "useBulkSelection must be used within BulkSelectionContext";

package/dist/Shared/Components/BulkSelection/index.d.ts

@@ -0,0 +1,4 @@
+export { default as BulkSelection } from './BulkSelection';
+export * from './BulkSelectionProvider';
+export * from './types';
+export * from './constants';

package/dist/Shared/Components/BulkSelection/types.d.ts

@@ -0,0 +1,56 @@
+/// <reference types="react" />
+import { CHECKBOX_VALUE } from '../../../Common';
+export declare enum BulkSelectionEvents {
+    CLEAR_ALL_SELECTIONS = "CLEAR_ALL_SELECTIONS",
+    CLEAR_IDENTIFIERS = "CLEAR_IDENTIFIERS",
+    SELECT_ALL_ACROSS_PAGES = "SELECT_ALL_ACROSS_PAGES",
+    SELECT_ALL_ON_PAGE = "SELECT_ALL_ON_PAGE",
+    SELECT_IDENTIFIER = "SELECT_IDENTIFIER",
+    CLEAR_IDENTIFIERS_AFTER_ACROSS_SELECTION = "CLEAR_IDENTIFIERS_AFTER_ACROSS_SELECTION",
+    CLEAR_SELECTIONS_AND_SELECT_ALL_ACROSS_PAGES = "CLEAR_SELECTIONS_AND_SELECT_ALL_ACROSS_PAGES"
+}
+export interface HandleBulkSelectionType<T> {
+    action: BulkSelectionEvents;
+    data?: {
+        identifierIds?: (number | string)[];
+        identifierObject?: T;
+    };
+}
+export interface GetBulkSelectionCheckboxValuesType {
+    isChecked: boolean;
+    checkboxValue: CHECKBOX_VALUE;
+}
+export interface UseBulkSelectionReturnType<T> extends GetBulkSelectionCheckboxValuesType {
+    selectedIdentifiers: T;
+    handleBulkSelection: ({ action, data }: HandleBulkSelectionType<T>) => void;
+    isBulkSelectionApplied: boolean;
+    getSelectedIdentifiersCount: () => number;
+}
+export interface BulkSelectionProps {
+    showPagination: boolean;
+}
+export interface BulkSelectionDropdownItemsType {
+    locator: BulkSelectionEvents;
+    label: string;
+    isSelected: boolean;
+    icon: React.FunctionComponent<React.SVGProps<SVGSVGElement>>;
+}
+export interface BulkSelectionDropdownItemsProps<T> extends BulkSelectionDropdownItemsType, Pick<UseBulkSelectionReturnType<T>, 'handleBulkSelection'> {
+}
+export declare enum SelectAllDialogStatus {
+    OPEN = "OPEN",
+    CLOSED = "CLOSED"
+}
+export type BulkSelectionIdentifiersType<T> = Record<string | number, T>;
+export interface UseBulkSelectionProps<T> {
+    /**
+     * Response from API, assuming structure to be array of objects with key and values
+     * This will the given ids on current page
+     */
+    identifiers: T;
+    /**
+     * Act as buffer between select all across pages and select all on page state
+     */
+    getSelectAllDialogStatus: () => SelectAllDialogStatus;
+    children?: React.ReactNode;
+}

package/dist/Shared/Components/index.d.ts

@@ -0,0 +1 @@
+export * from './BulkSelection';

package/dist/Shared/index.d.ts

@@ -0,0 +1 @@
+export * from './Components';

package/dist/index.d.ts

@@ -1 +1,3 @@
-export * from "./Common";
+export * from './Common';
+export * from './Pages';
+export * from './Shared';