@shival99/z-ui 1.0.12 → 1.0.14

package/types/shival99-z-ui-services.d.ts

@@ -1,18 +1,15 @@
+import { HttpHeaders, HttpContext, HttpParams, HttpClient } from '@angular/common/http';
+import { Router } from '@angular/router';
 import { Observable } from 'rxjs';
 import * as i0 from '@angular/core';
 import { InjectionToken } from '@angular/core';
 import { TranslationObject, TranslateService } from '@ngx-translate/core';
 
-/**
- * Z-Cache Types
- */
-/** Cache entry with TTL */
 interface ZCacheEntry<T = unknown> {
     data: T;
     timestamp: number;
     ttl: number;
 }
-/** Cache service configuration */
 interface ZCacheConfig {
     /** Prefix for cache keys */
     prefix?: string;
@@ -20,17 +17,9 @@ interface ZCacheConfig {
     encrypt?: boolean;
 }
 
-/**
- * Z-Cache Service
- * A localStorage-based cache service with optional encryption
- */
-
 declare class ZCacheService {
     private static _prefix;
     private static _encrypt;
-    /**
-     * Configure the cache service
-     */
     static configure(config: ZCacheConfig): void;
     private static _encode;
     private static _decode;
@@ -78,10 +67,66 @@ declare class ZCacheService {
     static keys(): string[];
 }
 
-/**
- * Z-IndexDB Types
- */
-/** Configuration for a single IndexedDB store */
+type ZHttpParamsType<T> = {
+    [K in keyof T]: string | number | boolean | ReadonlyArray<string | number | boolean>;
+};
+type ZHttpContentType = 'json' | 'urlencoded' | 'form-data';
+interface ZHttpBaseOptions {
+    headers?: HttpHeaders | Record<string, string | string[]>;
+    context?: HttpContext;
+    observe?: 'body';
+    params?: HttpParams | Record<string, string | number | boolean | ReadonlyArray<string | number | boolean>>;
+    reportProgress?: boolean;
+    responseType?: 'json' | 'arraybuffer' | 'blob' | 'text';
+    withCredentials?: boolean;
+    credentials?: RequestCredentials;
+    keepalive?: boolean;
+    priority?: RequestPriority;
+    cache?: RequestCache;
+    mode?: RequestMode;
+    redirect?: RequestRedirect;
+    transferCache?: {
+        includeHeaders?: string[];
+    } | boolean;
+    body?: unknown;
+}
+interface ZHttpOptions<TParams extends object = object, TApiType extends string = string> extends ZHttpBaseOptions {
+    contentType?: ZHttpContentType;
+    api?: TApiType;
+    skipToken?: boolean;
+    params?: HttpParams | ZHttpParamsType<TParams>;
+    enableCache?: boolean;
+    timeCache?: number;
+    skipErrorToast?: boolean;
+}
+interface ZHttpCacheEntry<T = unknown> {
+    data: T;
+    timestamp: number;
+    ttl: number;
+}
+interface ZHttpError<TApiType extends string = string> {
+    message: string;
+    status: number;
+    error?: unknown;
+    endpoint?: string;
+    method?: string;
+    body?: unknown;
+    options?: ZHttpOptions<object, TApiType>;
+}
+interface ZHttpConfig {
+    defaultCacheTime?: number;
+    networkCheckCacheTime?: number;
+    tokenKey?: string;
+    userInfoKey?: string;
+    lastUrlKey?: string;
+    loginRoute?: string;
+    homeRoute?: string;
+}
+interface ZHttpNetworkCheck {
+    time: number;
+    isOnline: boolean;
+}
+
 interface ZIndexDbStoreConfig {
     /** Name of the store */
     name: string;
@@ -90,7 +135,6 @@ interface ZIndexDbStoreConfig {
     /** Keys to avoid during clear operation */
     protectedKeys?: string[];
 }
-/** Configuration for Z-IndexDB Service */
 interface ZIndexDbConfig {
     /** Database name */
     dbName?: string;
@@ -106,11 +150,6 @@ interface ZIndexDbConfig {
     protectedKeys?: string[];
 }
 
-/**
- * Z-IndexDB Service
- * A robust IndexedDB service with multi-store support, encryption, and retry logic
- */
-
 declare class ZIndexDbService {
     private _db;
     private _dbName;
@@ -181,6 +220,105 @@ declare class ZIndexDbService {
     addStore(config: ZIndexDbStoreConfig): Promise<void>;
 }
 
+declare class ZTranslateService {
+    private readonly _translate;
+    readonly currentLang: i0.WritableSignal<string>;
+    readonly availableLangs: i0.WritableSignal<string[]>;
+    constructor();
+    private _initialize;
+    /**
+     * Change the current language
+     * @param lang - Language code
+     */
+    use(lang: string): void;
+    /**
+     * Get the current language code
+     */
+    getLang(): string;
+    /**
+     * Get translation synchronously (returns key if not found)
+     * @param key - Translation key
+     * @param params - Interpolation parameters
+     */
+    instant(key: string, params?: Record<string, unknown>): string;
+    /**
+     * Get translation asynchronously
+     * @param key - Translation key
+     * @param params - Interpolation parameters
+     */
+    get(key: string, params?: Record<string, unknown>): Promise<string>;
+    /**
+     * Get translation as observable
+     * @param key - Translation key
+     * @param params - Interpolation parameters
+     */
+    get$(key: string, params?: Record<string, unknown>): Observable<string>;
+    /**
+     * Stream translations (re-emits on language change)
+     * @param key - Translation key
+     * @param params - Interpolation parameters
+     */
+    stream$(key: string, params?: Record<string, unknown>): Observable<string>;
+    /**
+     * Get multiple translations at once
+     * @param keys - Array of translation keys
+     * @param params - Interpolation parameters (applied to all)
+     */
+    getMany(keys: string[], params?: Record<string, unknown>): Promise<Record<string, string>>;
+    /**
+     * Check if a translation key exists
+     * @param key - Translation key
+     */
+    has(key: string): boolean;
+    /**
+     * Add translations dynamically
+     * @param lang - Language code
+     * @param translations - Translation object
+     * @param shouldMerge - Whether to merge with existing translations
+     */
+    setTranslation(lang: string, translations: TranslationObject, shouldMerge?: boolean): void;
+    /**
+     * Get the underlying TranslateService for advanced usage
+     */
+    getNgxTranslate(): TranslateService;
+    static ɵfac: i0.ɵɵFactoryDeclaration<ZTranslateService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<ZTranslateService>;
+}
+
+declare abstract class ZHttpAbstractService<TApiType extends string = string> {
+    protected readonly http: HttpClient;
+    protected readonly router: Router;
+    protected readonly cacheService: typeof ZCacheService;
+    protected readonly translateService: ZTranslateService;
+    protected readonly indexDbService: ZIndexDbService;
+    protected readonly config: Required<ZHttpConfig>;
+    private _networkCache;
+    constructor();
+    protected abstract resolveBaseUrl(apiType?: TApiType): string;
+    protected get<T, TParams extends object = object>(endpoint: string, options?: ZHttpOptions<TParams, TApiType>): Observable<T>;
+    protected post<T, TParams extends object = object>(endpoint: string, body: unknown, options?: ZHttpOptions<TParams, TApiType>): Observable<T>;
+    protected put<T, TParams extends object = object>(endpoint: string, body: unknown, options?: ZHttpOptions<TParams, TApiType>): Observable<T>;
+    protected patch<T, TParams extends object = object>(endpoint: string, body: unknown, options?: ZHttpOptions<TParams, TApiType>): Observable<T>;
+    protected delete<T, TParams extends object = object>(endpoint: string, body?: unknown, options?: ZHttpOptions<TParams, TApiType>): Observable<T>;
+    private _buildRequest;
+    private _buildHttpOptions;
+    private _handleCacheAndRequest;
+    private _executeHttpCall;
+    private _generateCacheKey;
+    private _cacheData;
+    private _getCachedData;
+    private _detectNetworkStatus;
+    private _checkNetworkWithRetry;
+    private _performNetworkCheck;
+    private _handleError;
+    private _buildErrorObject;
+    private _localizeError;
+    private _get401Message;
+    private _handleStatusCode;
+    static ɵfac: i0.ɵɵFactoryDeclaration<ZHttpAbstractService<any>, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<ZHttpAbstractService<any>>;
+}
+
 type SubjectType = 'subject' | 'behavior';
 declare class ZSubjectService {
     private readonly _subjects;
@@ -224,10 +362,6 @@ declare class ZSubjectService {
     static ɵprov: i0.ɵɵInjectableDeclaration<ZSubjectService>;
 }
 
-/**
- * Z-Theme Types
- */
-
 type ZThemeName = 'green' | 'orange' | 'violet' | 'neutral' | 'stone' | 'zinc' | 'gray' | 'slate' | 'hospital';
 interface ZThemeConfig {
     defaultTheme?: ZThemeName;
@@ -263,105 +397,6 @@ declare class ZThemeService {
     static ɵprov: i0.ɵɵInjectableDeclaration<ZThemeService>;
 }
 
-declare class ZTranslateService {
-    private readonly _translate;
-    /** Current language signal */
-    readonly currentLang: i0.WritableSignal<string>;
-    /** Available languages */
-    readonly availableLangs: i0.WritableSignal<string[]>;
-    constructor();
-    private _initialize;
-    /**
-     * Change the current language
-     * @param lang - Language code
-     */
-    use(lang: string): void;
-    /**
-     * Get the current language code
-     */
-    getLang(): string;
-    /**
-     * Get translation synchronously (returns key if not found)
-     * @param key - Translation key
-     * @param params - Interpolation parameters
-     */
-    instant(key: string, params?: Record<string, unknown>): string;
-    /**
-     * Get translation asynchronously
-     * @param key - Translation key
-     * @param params - Interpolation parameters
-     */
-    get(key: string, params?: Record<string, unknown>): Promise<string>;
-    /**
-     * Get translation as observable
-     * @param key - Translation key
-     * @param params - Interpolation parameters
-     */
-    get$(key: string, params?: Record<string, unknown>): Observable<string>;
-    /**
-     * Stream translations (re-emits on language change)
-     * @param key - Translation key
-     * @param params - Interpolation parameters
-     */
-    stream$(key: string, params?: Record<string, unknown>): Observable<string>;
-    /**
-     * Get multiple translations at once
-     * @param keys - Array of translation keys
-     * @param params - Interpolation parameters (applied to all)
-     */
-    getMany(keys: string[], params?: Record<string, unknown>): Promise<Record<string, string>>;
-    /**
-     * Check if a translation key exists
-     * @param key - Translation key
-     */
-    has(key: string): boolean;
-    /**
-     * Add translations dynamically
-     * @param lang - Language code
-     * @param translations - Translation object
-     * @param shouldMerge - Whether to merge with existing translations
-     */
-    setTranslation(lang: string, translations: TranslationObject, shouldMerge?: boolean): void;
-    /**
-     * Get the underlying TranslateService for advanced usage
-     */
-    getNgxTranslate(): TranslateService;
-    static ɵfac: i0.ɵɵFactoryDeclaration<ZTranslateService, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<ZTranslateService>;
-}
-
-/**
- * Z-Http Types
- */
-/** HTTP cache entry */
-interface ZHttpCacheEntry<T = unknown> {
-    data: T;
-    timestamp: number;
-    ttl: number;
-}
-/** HTTP error response */
-interface ZHttpError {
-    message: string;
-    status: number;
-    error?: unknown;
-    endpoint?: string;
-    method?: string;
-    body?: unknown;
-}
-/** HTTP request options */
-interface ZHttpOptions<TParams extends object = object> {
-    params?: TParams;
-    headers?: Record<string, string | string[]>;
-    enableCache?: boolean;
-    timeCache?: number;
-    contentType?: 'json' | 'urlencoded' | 'form-data';
-    skipToken?: boolean;
-}
-
-/**
- * Z-Translate Types
- */
-/** Translate service configuration */
 interface ZTranslateConfig {
     /** Default language */
     defaultLang?: string;
@@ -372,11 +407,10 @@ interface ZTranslateConfig {
     /** Translation file extension */
     fileExtension?: string;
 }
-/** Translate I18n configuration */
 interface ZTranslateI18nConfig {
     defaultLang?: string;
     availableLangs?: string[];
 }
 
-export { ZCacheService, ZIndexDbService, ZSubjectService, ZThemeService, ZTranslateService, Z_DARK_MODE_CACHE_KEY, Z_DEFAULT_THEME, Z_THEME_CACHE_KEY, Z_THEME_CONFIG, Z_THEME_CSS_MAP };
-export type { ZCacheConfig, ZCacheEntry, ZHttpCacheEntry, ZHttpError, ZHttpOptions, ZIndexDbConfig, ZIndexDbStoreConfig, ZThemeConfig, ZThemeName, ZTranslateConfig, ZTranslateI18nConfig };
+export { ZCacheService, ZHttpAbstractService, ZIndexDbService, ZSubjectService, ZThemeService, ZTranslateService, Z_DARK_MODE_CACHE_KEY, Z_DEFAULT_THEME, Z_THEME_CACHE_KEY, Z_THEME_CONFIG, Z_THEME_CSS_MAP };
+export type { ZCacheConfig, ZCacheEntry, ZHttpBaseOptions, ZHttpCacheEntry, ZHttpConfig, ZHttpContentType, ZHttpError, ZHttpNetworkCheck, ZHttpOptions, ZHttpParamsType, ZIndexDbConfig, ZIndexDbStoreConfig, ZThemeConfig, ZThemeName, ZTranslateConfig, ZTranslateI18nConfig };

package/types/shival99-z-ui-utils.d.ts

@@ -3,10 +3,6 @@ import { ClassValue } from 'clsx';
 import { Observable } from 'rxjs';
 import { FormGroup, FormArray } from '@angular/forms';
 
-/**
- * Z-Common Types
- * Common utility types
- */
 type ZBrowserName = 'Chrome' | 'Edge' | 'Firefox' | 'Safari' | 'Opera' | 'IE' | 'Unknown' | string;
 type ZDeviceType = 'mobile' | 'tablet' | 'desktop';
 interface ZBrowserInfo {
@@ -25,68 +21,55 @@ interface ZNavigatorUAData {
     mobile: boolean;
     platform: string;
 }
+type ZNumberDivide = 'none' | 'thousand' | 'million' | 'billion';
+type ZEmptyCheck = 'strict' | 'includeZero';
+declare const Z_DIVIDE_SCALE: Record<ZNumberDivide, number>;
+declare const Z_LOCALE_MAP: Record<string, string>;
+interface ZFormatNumOptions {
+    divide?: ZNumberDivide;
+    format?: string;
+    percent?: boolean;
+    emptyCheck?: ZEmptyCheck;
+    locale?: 'vi' | 'en';
+    placeholder?: string;
+}
 declare global {
     interface Navigator {
         userAgentData?: ZNavigatorUAData;
     }
 }
 
-/**
- * Z-Common Utils
- * Common utility functions for z-ui library
- * All functions are prefixed with 'z' for consistency
- */
-
-/** Merge Tailwind CSS classes with clsx */
 declare const zMergeClasses: (...inputs: ClassValue[]) => string;
-/** Transform boolean-like values to boolean */
 declare const zTransform: (value: boolean | string) => boolean;
-/** Generate a unique ID with optional prefix */
 declare const zGenerateId: (prefix?: string) => string;
 declare const zNoop: () => undefined;
-/** Simple UUID generator */
+declare const zFormatNum: (value: unknown, options?: ZFormatNumOptions) => string;
 declare const zUuid: () => string;
-/** Capitalize each word in a string */
 declare const zCapitalCase: (text: string) => string;
-/** Check if text is truncated (requires element to be rendered) */
 declare const zIsTextTruncated: (el: HTMLElement) => Promise<boolean>;
-/** Decode unicode escape sequences */
 declare const zDecodeUnicode: (str: string) => string;
-/** Generate a random color in hex, rgb, and hsl formats */
 declare const zRandomColor: () => {
     hex: string;
     rgb: string;
     hsl: string;
 };
-/** Convert color string to ARGB format */
 declare const zConvertColorToArgb: (color: string) => string;
-/** Clean null/undefined values from object recursively */
 declare const zCleanObject: <T = unknown>(obj: T) => T;
-/** Flatten tree structure to flat array */
 declare const zTreeFlatten: <T extends Record<string, unknown>>(list: T[], keyMap: keyof T, parentKeyMap: keyof T, sortFn?: (a: T, b: T) => number) => (T & {
     level: number;
     parentsKey: string[];
 })[];
-/** Build tree structure from flat array */
 declare const zTreeBuild: <T extends Record<string, unknown>>(list: T[], keyMap: keyof T, parentKeyMap: keyof T, sortFn?: (a: T, b: T) => number) => (T & {
     level: number;
     parentsKey: string[];
     children: unknown[];
 })[];
-/** Vietnamese character map for normalization */
 declare const VIETNAMESE_MAP: Record<string, string>;
-/** Remove Vietnamese diacritics from string */
 declare const zRemoveVietnamese: (str: string) => string;
-/** Full-text search using MiniSearch */
 declare const zMiniSearch: <T>(data: T[], query: string, fields: (keyof T | string)[]) => T[];
-/** Full-text search as Observable with loading state */
 declare const zMiniSearch$: <T>(data: T[], query: string, fields: (keyof T | string)[], loading?: WritableSignal<boolean>, fakeDelay?: number) => Observable<T[]>;
-/** Detect browser information */
 declare const zDetectBrowser: () => ZBrowserInfo;
 
-/**
- * Z-Echarts Types
- */
 interface ZEchartsThemeOptions {
     /** Theme name (default: 'zTheme') */
     themeName?: string;
@@ -94,23 +77,11 @@ interface ZEchartsThemeOptions {
     fontFamily?: string;
 }
 
-/**
- * Z-Echarts Utils
- * ECharts utility functions
- */
-
 /**
  * Register custom Z-UI theme for ECharts
  * @param options - Theme configuration options
  */
 declare function zRegisterEchartsTheme(options?: ZEchartsThemeOptions): void;
-/** @deprecated Use zRegisterEchartsTheme instead */
-declare const registerEchartsMsgTheme: () => void;
-
-/**
- * Z-Form Utils
- * Form utility functions
- */
 
 /**
  * Submit form and mark invalid controls as dirty
@@ -129,17 +100,11 @@ declare const zDebugFormInvalid: (form: FormGroup, parentKey?: string) => void;
 /** Legacy alias */
 declare const debugFormInvalid: (form: FormGroup, parentKey?: string) => void;
 
-/**
- * Z-Form Types
- * Form utility types
- */
-/** Form submit result */
 type ZFormSubmitResult = boolean;
-/** Form debug options */
 interface ZFormDebugOptions {
     showValid?: boolean;
     logLevel?: 'error' | 'warn' | 'log';
 }
 
-export { VIETNAMESE_MAP, debugFormInvalid, registerEchartsMsgTheme, submitForm, zCapitalCase, zCleanObject, zConvertColorToArgb, zDebugFormInvalid, zDecodeUnicode, zDetectBrowser, zGenerateId, zIsTextTruncated, zMergeClasses, zMiniSearch, zMiniSearch$, zNoop, zRandomColor, zRegisterEchartsTheme, zRemoveVietnamese, zSubmitForm, zTransform, zTreeBuild, zTreeFlatten, zUuid };
-export type { ZBrowserInfo, ZBrowserName, ZDeviceType, ZEchartsThemeOptions, ZFormDebugOptions, ZFormSubmitResult, ZNavigatorUABrandVersion, ZNavigatorUAData };
+export { VIETNAMESE_MAP, Z_DIVIDE_SCALE, Z_LOCALE_MAP, debugFormInvalid, submitForm, zCapitalCase, zCleanObject, zConvertColorToArgb, zDebugFormInvalid, zDecodeUnicode, zDetectBrowser, zFormatNum, zGenerateId, zIsTextTruncated, zMergeClasses, zMiniSearch, zMiniSearch$, zNoop, zRandomColor, zRegisterEchartsTheme, zRemoveVietnamese, zSubmitForm, zTransform, zTreeBuild, zTreeFlatten, zUuid };
+export type { ZBrowserInfo, ZBrowserName, ZDeviceType, ZEchartsThemeOptions, ZEmptyCheck, ZFormDebugOptions, ZFormSubmitResult, ZFormatNumOptions, ZNavigatorUABrandVersion, ZNavigatorUAData, ZNumberDivide };

package/types/z-ui.d.ts

@@ -1,4 +1,3 @@
-/** Z-UI library version */
 declare const Z_UI_VERSION = "1.0.1";
 
 export { Z_UI_VERSION };