@shival99/z-ui 1.4.6 → 1.4.8

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shival99/z-ui",
-  "version": "1.4.6",
+  "version": "1.4.8",
   "description": "Z-UI: Modern Angular UI Component Library - A comprehensive, high-performance design system built with Angular 20+, featuring 40+ customizable components with dark mode, accessibility, and enterprise-ready features.",
   "keywords": [
     "angular",

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

@@ -1,10 +1,31 @@
 import { EnvironmentProviders, InjectionToken } from '@angular/core';
-import { ZIndexDbConfig, ZIndexDbService, ZThemeConfig } from '@shival99/z-ui/services';
+import { ZCacheConfig, ZIndexDbConfig, ZIndexDbService, ZThemeConfig } from '@shival99/z-ui/services';
 export { ZThemeConfig, ZThemeName } from '@shival99/z-ui/services';
 import { HttpClient } from '@angular/common/http';
 import { TranslateLoader } from '@ngx-translate/core';
 import { ZUITranslations } from '@shival99/z-ui/i18n';
 
+/** Injection token for ZCacheService configuration */
+declare const Z_CACHE_CONFIG: InjectionToken<ZCacheConfig>;
+/**
+ * Provide Z-Cache service with configuration
+ * @param config - Cache configuration with prefix and encrypt options
+ *
+ * @example
+ * ```typescript
+ * // In app.config.ts
+ * export const appConfig: ApplicationConfig = {
+ *   providers: [
+ *     provideZCache({
+ *       prefix: 'myapp_',
+ *       encrypt: false, // Disable encryption for debugging
+ *     }),
+ *   ],
+ * };
+ * ```
+ */
+declare function provideZCache(config?: ZCacheConfig): EnvironmentProviders;
+
 /** Injection token for ZIndexDbService */
 declare const Z_INDEXDB_SERVICE: InjectionToken<ZIndexDbService>;
 /**
@@ -126,5 +147,5 @@ interface ZTranslateProviderConfig {
 declare function zCreateTranslateLoader(http: HttpClient, path?: string, extension?: string, includeZUI?: boolean, zuiOverridePath?: string, customZUI?: Partial<Record<string, ZUITranslations>>): TranslateLoader;
 declare function provideZTranslate(config?: ZTranslateProviderConfig): EnvironmentProviders;
 
-export { Z_INDEXDB_SERVICE, provideZIndexDb, provideZNgxMask, provideZScrollbar, provideZTheme, provideZTranslate, zCreateTranslateLoader };
+export { Z_CACHE_CONFIG, Z_INDEXDB_SERVICE, provideZCache, provideZIndexDb, provideZNgxMask, provideZScrollbar, provideZTheme, provideZTranslate, zCreateTranslateLoader };
 export type { ZNgxMaskConfig, ZTranslateProviderConfig };

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

@@ -12,9 +12,7 @@ interface ZCacheEntry<T = unknown> {
     ttl: number;
 }
 interface ZCacheConfig {
-    /** Prefix for cache keys */
     prefix?: string;
-    /** Whether to encrypt data */
     encrypt?: boolean;
 }
 
@@ -26,45 +24,12 @@ declare class ZCacheService {
     private static _decode;
     private static _getFullKey;
     private static _safeOperation;
-    /**
-     * Get a value from cache
-     * @param key - Cache key
-     * @param defaultValue - Default value if not found
-     * @param encrypt - Whether to use encryption (default: service config)
-     */
     static get<T>(key: string, defaultValue?: T, encrypt?: boolean): T | undefined;
-    /**
-     * Set a value in cache
-     * @param key - Cache key
-     * @param data - Data to store
-     * @param encrypt - Whether to use encryption
-     */
     static set<T>(key: string, data: T, encrypt?: boolean): boolean;
-    /**
-     * Delete a key from cache
-     * @param key - Cache key
-     * @param encrypt - Whether key is encrypted
-     */
-    static delete(key: string, encrypt?: boolean): boolean;
-    /**
-     * Delete multiple keys from cache
-     * @param keys - Array of cache keys
-     * @param encrypt - Whether keys are encrypted
-     */
-    static deleteMultiple(keys: string[], encrypt?: boolean): boolean;
-    /**
-     * Clear all cache with the configured prefix
-     */
+    static delete(key: string): boolean;
+    static deleteMultiple(keys: string[]): boolean;
     static clear(): boolean;
-    /**
-     * Check if a key exists in cache
-     * @param key - Cache key
-     * @param encrypt - Whether key is encrypted
-     */
     static has(key: string, encrypt?: boolean): boolean;
-    /**
-     * Get all keys with the configured prefix
-     */
     static keys(): string[];
 }
 
@@ -307,26 +272,27 @@ interface ZHttpNetworkCheck {
 }
 
 interface ZIndexDbStoreConfig {
-    /** Name of the store */
     name: string;
-    /** Whether to encrypt data (default: true) */
     encrypt?: boolean;
-    /** Keys to avoid during clear operation */
     protectedKeys?: string[];
 }
 interface ZIndexDbConfig {
-    /** Database name */
     dbName?: string;
-    /** Database version */
     version?: number;
-    /** Transaction mode */
     mode?: IDBTransactionMode;
-    /** Store configurations - supports multiple stores */
     stores?: ZIndexDbStoreConfig[];
-    /** Default store name (for backward compatibility) */
     defaultStore?: string;
-    /** Keys to avoid during clear operation (global) */
     protectedKeys?: string[];
+    encrypt?: boolean;
+}
+interface ZIndexDbGetOptions<T = unknown> {
+    defaultValue?: T;
+    storeName?: string;
+    encrypt?: boolean;
+}
+interface ZIndexDbSetOptions {
+    storeName?: string;
+    encrypt?: boolean;
 }
 
 declare class ZIndexDbService {
@@ -338,10 +304,18 @@ declare class ZIndexDbService {
     private _stores;
     private _defaultStoreName;
     private _globalProtectedKeys;
+    private _encrypt;
     constructor(config?: ZIndexDbConfig);
     private _getStoreConfig;
-    private _encrypt;
-    private _decrypt;
+    /**
+     * Determines if encryption should be used.
+     * Priority: per-call > store-level > global
+     * @param storeConfig - Store configuration
+     * @param perCallEncrypt - Per-call encrypt override (highest priority)
+     */
+    private _shouldEncrypt;
+    private _encryptData;
+    private _decryptData;
     private _closeConnection;
     private _reconnect;
     private _withRetry;
@@ -351,15 +325,21 @@ declare class ZIndexDbService {
     private _resetDatabase;
     private _getMissingStores;
     private _ensureStoreExists;
-    get<T>(key: string, defaultValue?: T, storeName?: string): Promise<T | undefined>;
-    set<T>(key: string, value: T, storeName?: string): Promise<void>;
+    get<T>(key: string, options?: ZIndexDbGetOptions<T>): Promise<T | undefined>;
+    set<T>(key: string, value: T, options?: ZIndexDbSetOptions): Promise<void>;
+    /**
+     * Delete key(s) from IndexDB. If storeName not provided, deletes from all stores.
+     * Tries both encrypted and non-encrypted versions of the key.
+     */
     delete(key: string | string[], storeName?: string): Promise<void>;
+    private _deleteFromStore;
     clear(storeName?: string): Promise<void>;
     getAll<T = unknown>(storeName?: string): Promise<Record<string, T>>;
-    setMultiple<T>(items: Record<string, T>, storeName?: string): Promise<void>;
+    setMultiple<T>(items: Record<string, T>, options?: ZIndexDbSetOptions): Promise<void>;
     getStoreNames(): string[];
     hasStore(storeName: string): boolean;
     addStore(config: ZIndexDbStoreConfig): Promise<void>;
+    clearAll(): Promise<void>;
 }
 
 declare class ZTranslateService {
@@ -607,4 +587,4 @@ interface ZTranslateI18nConfig {
 declare const Z_LANG_CACHE_KEY = "Z_LANGUAGE";
 
 export { ZCacheService, ZExcelService, ZHttpAbstractService, ZIndexDbService, ZSubjectService, ZThemeService, ZTranslateService, Z_DARK_MODE_CACHE_KEY, Z_DEFAULT_THEME, Z_EXCEL_BORDER_THIN, Z_EXCEL_CHAR_WIDTH_MAP, Z_EXCEL_COLORS, Z_EXCEL_DEFAULT_CONFIG, Z_EXCEL_FONT_MULTIPLIERS, Z_EXCEL_WIDTH_LIMITS, Z_HTTP_DEFAULT_CONFIG, Z_INDEXDB_BATCH_SIZE, Z_INDEXDB_DEFAULT_CONFIG, Z_INDEXDB_MAX_VERSION, Z_LANG_CACHE_KEY, Z_THEME_CACHE_KEY, Z_THEME_CONFIG, Z_THEME_CONFIG_CACHE_KEY, Z_THEME_CSS_MAP };
-export type { ZCacheConfig, ZCacheEntry, ZExcelAlign, ZExcelCell, ZExcelCellContext, ZExcelColumnConfig, ZExcelConfig, ZExcelDefaultConfig, ZExcelExportOptions, ZExcelExportResult, ZExcelFontConfig, ZExcelFromTableConfig, ZExcelHeaderColors, ZExcelHeaderContext, ZExcelSheetSource, ZExcelTableColumnConfig, ZExcelTableHeaderConfig, ZExcelToastHandler, ZHttpBaseOptions, ZHttpCacheEntry, ZHttpConfig, ZHttpContentType, ZHttpError, ZHttpNetworkCheck, ZHttpOptions, ZHttpParamsType, ZIndexDbConfig, ZIndexDbStoreConfig, ZTableToExcelColumn, ZThemeConfig, ZThemeName, ZTranslateConfig, ZTranslateI18nConfig };
+export type { ZCacheConfig, ZCacheEntry, ZExcelAlign, ZExcelCell, ZExcelCellContext, ZExcelColumnConfig, ZExcelConfig, ZExcelDefaultConfig, ZExcelExportOptions, ZExcelExportResult, ZExcelFontConfig, ZExcelFromTableConfig, ZExcelHeaderColors, ZExcelHeaderContext, ZExcelSheetSource, ZExcelTableColumnConfig, ZExcelTableHeaderConfig, ZExcelToastHandler, ZHttpBaseOptions, ZHttpCacheEntry, ZHttpConfig, ZHttpContentType, ZHttpError, ZHttpNetworkCheck, ZHttpOptions, ZHttpParamsType, ZIndexDbConfig, ZIndexDbGetOptions, ZIndexDbSetOptions, ZIndexDbStoreConfig, ZTableToExcelColumn, ZThemeConfig, ZThemeName, ZTranslateConfig, ZTranslateI18nConfig };