@cagatayfdn/flora-components 0.0.164 → 0.0.165

package/dist/index.d.mts

@@ -208,6 +208,9 @@ export declare type BreadcrumbProps = {
     state?: any;
 };
 
+/** Build the final request URL from `baseURL`, `url` and serialized `params`. */
+export declare function buildFullURL(config: FetchRequestConfig): string;
+
 export declare const Button: ({ children, size, isLoading, isDisabled, isBlock, noBorder, noBackground, round, isSolid, isPill, type, focus, className, prefixIcon, appearance, onClick, }: ButtonProps) => JSX.Element;
 
 export declare type ButtonProps = {
@@ -319,6 +322,12 @@ export declare type ColumnsType = {
     render?: (property: any, row: any) => void;
 };
 
+/**
+ * Join a base URL and a relative URL with a single slash. An absolute
+ * `relativeURL` (with its own scheme/host) is returned untouched.
+ */
+export declare function combineURLs(baseURL?: string, relativeURL?: string): string;
+
 export declare function Config({ config, scrollProps }: ConfigProps): JSX_2.Element;
 
 declare function Config({ config, scrollProps }: ConfigProps): JSX_2.Element;
@@ -379,6 +388,20 @@ export declare type CountdownProps = {
 
 export declare const createConnectedService: (projects: Record<string, any>[], isFlex?: boolean) => JSX_2.Element[] | undefined;
 
+/**
+ * Create an axios-like HTTP client backed by the Fetch API.
+ *
+ * @example
+ * const instance = createFetchClient({ baseURL: import.meta.env.VITE_APP_API_URL });
+ * instance.interceptors.request.use((config) => {
+ *   const token = localStorage.getItem("token");
+ *   if (token) config.headers = { ...config.headers, Authorization: `Token ${token}` };
+ *   return config;
+ * });
+ * const { data } = await instance.get("/users");
+ */
+export declare function createFetchClient(defaultConfig?: FetchRequestConfig): FetchInstance;
+
 export declare type CustomItemProps = {
     item: OptionProps;
 };
@@ -440,6 +463,13 @@ export declare interface DateRange {
 
 export { dayjs }
 
+/**
+ * Serialize `params` into a query string. Arrays repeat the key with a `[]`
+ * suffix, `Date`s become ISO strings, plain objects are JSON-encoded, and
+ * `null`/`undefined` values are skipped — matching axios' default behaviour.
+ */
+export declare function defaultParamsSerializer(params: any): string;
+
 declare type Dispatch_2 = React_2.Dispatch<Actiontype>;
 
 export declare const Divider: ({ appearance, className, margin, }: DividerProps) => JSX.Element;
@@ -534,8 +564,69 @@ export declare type FetcherReturnType = {
     startInterval: (...params: any) => void;
 };
 
+/**
+ * Error thrown for failed requests. Mirrors `AxiosError`: it carries the
+ * originating `config`, the `response` (when the server responded) and a
+ * machine-readable `code`. Network failures, timeouts and cancellations have
+ * no `response`.
+ */
+export declare class FetchError<T = any> extends Error {
+    config: FetchRequestConfig;
+    code?: string;
+    request?: any;
+    response?: FetchResponse<T>;
+    isFetchError: boolean;
+    constructor(message: string, config: FetchRequestConfig, code?: string, request?: any, response?: FetchResponse<T>);
+    toJSON(): {
+        name: string;
+        message: string;
+        code: string | undefined;
+        status: number | undefined;
+    };
+}
+
+export declare const FetchErrorCode: {
+    readonly BAD_REQUEST: "ERR_BAD_REQUEST";
+    readonly BAD_RESPONSE: "ERR_BAD_RESPONSE";
+    readonly NETWORK: "ERR_NETWORK";
+    readonly TIMEOUT: "ERR_TIMEOUT";
+    readonly CANCELED: "ERR_CANCELED";
+};
+
 export declare type FetcherType = (...params: any) => void;
 
+export declare type FetchHeaders = Record<string, string>;
+
+/**
+ * A configured client. Callable like axios (`instance(config)` /
+ * `instance(url, config)`) and exposes `request`, the HTTP verb helpers,
+ * `interceptors`, `defaults`, and `create`.
+ */
+export declare interface FetchInstance {
+    <T = any>(config: FetchRequestConfig): Promise<FetchResponse<T>>;
+    <T = any>(url: string, config?: FetchRequestConfig): Promise<FetchResponse<T>>;
+    request<T = any>(config: FetchRequestConfig): Promise<FetchResponse<T>>;
+    get<T = any>(url: string, config?: FetchRequestConfig): Promise<FetchResponse<T>>;
+    delete<T = any>(url: string, config?: FetchRequestConfig): Promise<FetchResponse<T>>;
+    head<T = any>(url: string, config?: FetchRequestConfig): Promise<FetchResponse<T>>;
+    options<T = any>(url: string, config?: FetchRequestConfig): Promise<FetchResponse<T>>;
+    post<T = any, D = any>(url: string, data?: D, config?: FetchRequestConfig): Promise<FetchResponse<T>>;
+    put<T = any, D = any>(url: string, data?: D, config?: FetchRequestConfig): Promise<FetchResponse<T>>;
+    patch<T = any, D = any>(url: string, data?: D, config?: FetchRequestConfig): Promise<FetchResponse<T>>;
+    interceptors: {
+        request: FetchInterceptorManager<FetchRequestConfig>;
+        response: FetchInterceptorManager<FetchResponse>;
+    };
+    defaults: FetchRequestConfig;
+    create(config?: FetchRequestConfig): FetchInstance;
+}
+
+export declare interface FetchInterceptorManager<V> {
+    use(onFulfilled?: (value: V) => V | Promise<V>, onRejected?: InterceptorRejected): number;
+    eject(id: number): void;
+    clear(): void;
+}
+
 export declare interface FetchLogsParams {
     applications: string[];
     scroll_mode?: 'older' | 'newer';
@@ -544,6 +635,47 @@ export declare interface FetchLogsParams {
     withoutPermission?: boolean;
 }
 
+export declare type FetchMethod = "get" | "GET" | "post" | "POST" | "put" | "PUT" | "patch" | "PATCH" | "delete" | "DELETE" | "head" | "HEAD" | "options" | "OPTIONS";
+
+/**
+ * Request configuration. Mirrors the shape of an axios request config so that
+ * migrating existing axios code requires minimal changes. Unknown keys are
+ * allowed (e.g. custom flags like `_retry`) via the index signature.
+ */
+export declare interface FetchRequestConfig<D = any> {
+    url?: string;
+    method?: FetchMethod;
+    baseURL?: string;
+    headers?: FetchHeaders;
+    params?: any;
+    data?: D;
+    signal?: AbortSignal;
+    /** Abort the request after this many milliseconds. */
+    timeout?: number;
+    /** When true, sends credentials (cookies) cross-origin (`credentials: "include"`). */
+    withCredentials?: boolean;
+    /** Fine-grained override of the fetch `credentials` mode. Takes precedence over `withCredentials`. */
+    credentials?: RequestCredentials;
+    /** How to parse the response body. Defaults to `"json"`. */
+    responseType?: FetchResponseType;
+    /** Custom query-string serializer. Defaults to an axios-compatible serializer. */
+    paramsSerializer?: (params: any) => string;
+    /** Resolves the promise only for matching statuses. `null` accepts every status. */
+    validateStatus?: ((status: number) => boolean) | null;
+    [key: string]: any;
+}
+
+export declare interface FetchResponse<T = any, D = any> {
+    data: T;
+    status: number;
+    statusText: string;
+    headers: FetchHeaders;
+    config: FetchRequestConfig<D>;
+    request?: any;
+}
+
+export declare type FetchResponseType = "json" | "text" | "blob" | "arrayBuffer" | "formData";
+
 export declare const FileUpload: React_2.ForwardRefExoticComponent<{
     type?: "number" | "email" | "search" | "text" | "url" | "tel" | "password" | "hidden" | undefined;
     id?: string | undefined;
@@ -852,11 +984,42 @@ export declare type InputProps = {
     textFillColor?: string;
 } & Omit<FormElementProps, 'value'> & Omit<EventProps<HTMLInputElement>, 'onMouseUp' | 'onMouseDown' | 'onMouseEnter' | 'onMouseLeave'>;
 
+declare interface InterceptorHandler<V> {
+    fulfilled?: (value: V) => V | Promise<V>;
+    rejected?: InterceptorRejected;
+}
+
+/**
+ * Holds a list of interceptor handlers. Ejecting nulls a slot instead of
+ * splicing so previously returned ids stay valid (same approach as axios).
+ */
+export declare class InterceptorManager<V> {
+    private handlers;
+    /**
+     * Register a handler pair. Returns an id usable with {@link eject}.
+     */
+    use(onFulfilled?: (value: V) => V | Promise<V>, onRejected?: InterceptorRejected): number;
+    /** Remove the handler registered under `id`. */
+    eject(id: number): void;
+    /** Remove every registered handler. */
+    clear(): void;
+    /** Iterate over the non-ejected handlers in registration order. */
+    forEach(fn: (handler: InterceptorHandler<V>) => void): void;
+}
+
+export declare type InterceptorRejected = (error: any) => any;
+
 export declare enum isActiveColor {
     inActive = "#4482ff",
     active = "#3f4b5c"
 }
 
+/** True when `value` is the error produced by an aborted/cancelled request. */
+export declare function isCancel(value: any): boolean;
+
+/** Type guard: true when `value` is a `FetchError`. */
+export declare function isFetchError(value: any): value is FetchError;
+
 export declare interface KeyValueParams {
     [key: string]: string | string[] | number | number[] | undefined | Record<string, unknown>;
 }

package/dist/index.d.ts

@@ -208,6 +208,9 @@ export declare type BreadcrumbProps = {
     state?: any;
 };
 
+/** Build the final request URL from `baseURL`, `url` and serialized `params`. */
+export declare function buildFullURL(config: FetchRequestConfig): string;
+
 export declare const Button: ({ children, size, isLoading, isDisabled, isBlock, noBorder, noBackground, round, isSolid, isPill, type, focus, className, prefixIcon, appearance, onClick, }: ButtonProps) => JSX.Element;
 
 export declare type ButtonProps = {
@@ -319,6 +322,12 @@ export declare type ColumnsType = {
     render?: (property: any, row: any) => void;
 };
 
+/**
+ * Join a base URL and a relative URL with a single slash. An absolute
+ * `relativeURL` (with its own scheme/host) is returned untouched.
+ */
+export declare function combineURLs(baseURL?: string, relativeURL?: string): string;
+
 export declare function Config({ config, scrollProps }: ConfigProps): JSX_2.Element;
 
 declare function Config({ config, scrollProps }: ConfigProps): JSX_2.Element;
@@ -379,6 +388,20 @@ export declare type CountdownProps = {
 
 export declare const createConnectedService: (projects: Record<string, any>[], isFlex?: boolean) => JSX_2.Element[] | undefined;
 
+/**
+ * Create an axios-like HTTP client backed by the Fetch API.
+ *
+ * @example
+ * const instance = createFetchClient({ baseURL: import.meta.env.VITE_APP_API_URL });
+ * instance.interceptors.request.use((config) => {
+ *   const token = localStorage.getItem("token");
+ *   if (token) config.headers = { ...config.headers, Authorization: `Token ${token}` };
+ *   return config;
+ * });
+ * const { data } = await instance.get("/users");
+ */
+export declare function createFetchClient(defaultConfig?: FetchRequestConfig): FetchInstance;
+
 export declare type CustomItemProps = {
     item: OptionProps;
 };
@@ -440,6 +463,13 @@ export declare interface DateRange {
 
 export { dayjs }
 
+/**
+ * Serialize `params` into a query string. Arrays repeat the key with a `[]`
+ * suffix, `Date`s become ISO strings, plain objects are JSON-encoded, and
+ * `null`/`undefined` values are skipped — matching axios' default behaviour.
+ */
+export declare function defaultParamsSerializer(params: any): string;
+
 declare type Dispatch_2 = React_2.Dispatch<Actiontype>;
 
 export declare const Divider: ({ appearance, className, margin, }: DividerProps) => JSX.Element;
@@ -534,8 +564,69 @@ export declare type FetcherReturnType = {
     startInterval: (...params: any) => void;
 };
 
+/**
+ * Error thrown for failed requests. Mirrors `AxiosError`: it carries the
+ * originating `config`, the `response` (when the server responded) and a
+ * machine-readable `code`. Network failures, timeouts and cancellations have
+ * no `response`.
+ */
+export declare class FetchError<T = any> extends Error {
+    config: FetchRequestConfig;
+    code?: string;
+    request?: any;
+    response?: FetchResponse<T>;
+    isFetchError: boolean;
+    constructor(message: string, config: FetchRequestConfig, code?: string, request?: any, response?: FetchResponse<T>);
+    toJSON(): {
+        name: string;
+        message: string;
+        code: string | undefined;
+        status: number | undefined;
+    };
+}
+
+export declare const FetchErrorCode: {
+    readonly BAD_REQUEST: "ERR_BAD_REQUEST";
+    readonly BAD_RESPONSE: "ERR_BAD_RESPONSE";
+    readonly NETWORK: "ERR_NETWORK";
+    readonly TIMEOUT: "ERR_TIMEOUT";
+    readonly CANCELED: "ERR_CANCELED";
+};
+
 export declare type FetcherType = (...params: any) => void;
 
+export declare type FetchHeaders = Record<string, string>;
+
+/**
+ * A configured client. Callable like axios (`instance(config)` /
+ * `instance(url, config)`) and exposes `request`, the HTTP verb helpers,
+ * `interceptors`, `defaults`, and `create`.
+ */
+export declare interface FetchInstance {
+    <T = any>(config: FetchRequestConfig): Promise<FetchResponse<T>>;
+    <T = any>(url: string, config?: FetchRequestConfig): Promise<FetchResponse<T>>;
+    request<T = any>(config: FetchRequestConfig): Promise<FetchResponse<T>>;
+    get<T = any>(url: string, config?: FetchRequestConfig): Promise<FetchResponse<T>>;
+    delete<T = any>(url: string, config?: FetchRequestConfig): Promise<FetchResponse<T>>;
+    head<T = any>(url: string, config?: FetchRequestConfig): Promise<FetchResponse<T>>;
+    options<T = any>(url: string, config?: FetchRequestConfig): Promise<FetchResponse<T>>;
+    post<T = any, D = any>(url: string, data?: D, config?: FetchRequestConfig): Promise<FetchResponse<T>>;
+    put<T = any, D = any>(url: string, data?: D, config?: FetchRequestConfig): Promise<FetchResponse<T>>;
+    patch<T = any, D = any>(url: string, data?: D, config?: FetchRequestConfig): Promise<FetchResponse<T>>;
+    interceptors: {
+        request: FetchInterceptorManager<FetchRequestConfig>;
+        response: FetchInterceptorManager<FetchResponse>;
+    };
+    defaults: FetchRequestConfig;
+    create(config?: FetchRequestConfig): FetchInstance;
+}
+
+export declare interface FetchInterceptorManager<V> {
+    use(onFulfilled?: (value: V) => V | Promise<V>, onRejected?: InterceptorRejected): number;
+    eject(id: number): void;
+    clear(): void;
+}
+
 export declare interface FetchLogsParams {
     applications: string[];
     scroll_mode?: 'older' | 'newer';
@@ -544,6 +635,47 @@ export declare interface FetchLogsParams {
     withoutPermission?: boolean;
 }
 
+export declare type FetchMethod = "get" | "GET" | "post" | "POST" | "put" | "PUT" | "patch" | "PATCH" | "delete" | "DELETE" | "head" | "HEAD" | "options" | "OPTIONS";
+
+/**
+ * Request configuration. Mirrors the shape of an axios request config so that
+ * migrating existing axios code requires minimal changes. Unknown keys are
+ * allowed (e.g. custom flags like `_retry`) via the index signature.
+ */
+export declare interface FetchRequestConfig<D = any> {
+    url?: string;
+    method?: FetchMethod;
+    baseURL?: string;
+    headers?: FetchHeaders;
+    params?: any;
+    data?: D;
+    signal?: AbortSignal;
+    /** Abort the request after this many milliseconds. */
+    timeout?: number;
+    /** When true, sends credentials (cookies) cross-origin (`credentials: "include"`). */
+    withCredentials?: boolean;
+    /** Fine-grained override of the fetch `credentials` mode. Takes precedence over `withCredentials`. */
+    credentials?: RequestCredentials;
+    /** How to parse the response body. Defaults to `"json"`. */
+    responseType?: FetchResponseType;
+    /** Custom query-string serializer. Defaults to an axios-compatible serializer. */
+    paramsSerializer?: (params: any) => string;
+    /** Resolves the promise only for matching statuses. `null` accepts every status. */
+    validateStatus?: ((status: number) => boolean) | null;
+    [key: string]: any;
+}
+
+export declare interface FetchResponse<T = any, D = any> {
+    data: T;
+    status: number;
+    statusText: string;
+    headers: FetchHeaders;
+    config: FetchRequestConfig<D>;
+    request?: any;
+}
+
+export declare type FetchResponseType = "json" | "text" | "blob" | "arrayBuffer" | "formData";
+
 export declare const FileUpload: React_2.ForwardRefExoticComponent<{
     type?: "number" | "email" | "search" | "text" | "url" | "tel" | "password" | "hidden" | undefined;
     id?: string | undefined;
@@ -852,11 +984,42 @@ export declare type InputProps = {
     textFillColor?: string;
 } & Omit<FormElementProps, 'value'> & Omit<EventProps<HTMLInputElement>, 'onMouseUp' | 'onMouseDown' | 'onMouseEnter' | 'onMouseLeave'>;
 
+declare interface InterceptorHandler<V> {
+    fulfilled?: (value: V) => V | Promise<V>;
+    rejected?: InterceptorRejected;
+}
+
+/**
+ * Holds a list of interceptor handlers. Ejecting nulls a slot instead of
+ * splicing so previously returned ids stay valid (same approach as axios).
+ */
+export declare class InterceptorManager<V> {
+    private handlers;
+    /**
+     * Register a handler pair. Returns an id usable with {@link eject}.
+     */
+    use(onFulfilled?: (value: V) => V | Promise<V>, onRejected?: InterceptorRejected): number;
+    /** Remove the handler registered under `id`. */
+    eject(id: number): void;
+    /** Remove every registered handler. */
+    clear(): void;
+    /** Iterate over the non-ejected handlers in registration order. */
+    forEach(fn: (handler: InterceptorHandler<V>) => void): void;
+}
+
+export declare type InterceptorRejected = (error: any) => any;
+
 export declare enum isActiveColor {
     inActive = "#4482ff",
     active = "#3f4b5c"
 }
 
+/** True when `value` is the error produced by an aborted/cancelled request. */
+export declare function isCancel(value: any): boolean;
+
+/** Type guard: true when `value` is a `FetchError`. */
+export declare function isFetchError(value: any): value is FetchError;
+
 export declare interface KeyValueParams {
     [key: string]: string | string[] | number | number[] | undefined | Record<string, unknown>;
 }