@flusys/nestjs-shared 9.1.2 → 9.2.0

package/interceptors/idempotency.interceptor.d.ts

@@ -1,10 +1,22 @@
 import { type CallHandler, type ExecutionContext, type NestInterceptor } from '@nestjs/common';
 import { Observable } from 'rxjs';
 import { HybridCache } from '../classes/hybrid-cache.class.js';
+interface IIdempotentRequest {
+    headers: Record<string, string | string[] | undefined>;
+    method?: string;
+    originalUrl?: string;
+    url?: string;
+    route?: {
+        path?: string;
+    };
+    user?: {
+        id?: string;
+    } | null;
+}
+export declare function buildIdempotencyCacheKey(request: IIdempotentRequest, idempotencyKey: string): string;
 export declare class IdempotencyInterceptor implements NestInterceptor {
     private readonly cache?;
-    private readonly CACHE_TTL;
-    private readonly PROCESSING_MARKER;
     constructor(cache?: HybridCache | undefined);
     intercept<T = any>(context: ExecutionContext, next: CallHandler<T>): Promise<Observable<T>>;
 }
+export {};

package/interceptors/slug.interceptor.d.ts

@@ -5,4 +5,5 @@ export declare class Slug implements NestInterceptor {
     private readonly utilsService;
     constructor(utilsService: UtilsService);
     intercept<T = any>(context: ExecutionContext, next: CallHandler<T>): Observable<T>;
+    private withSlug;
 }

package/interfaces/permission-action-registry.interface.d.ts

@@ -9,4 +9,5 @@ export interface IPermissionActionInput {
 export interface IPermissionActionRegistry {
     registerActions(actions: IPermissionActionInput[]): Promise<void>;
     removeActionsByCodes(codes: string[]): Promise<void>;
+    findMissingCodes?(codes: string[]): Promise<string[]>;
 }

package/interfaces/permission.interface.d.ts

@@ -18,4 +18,5 @@ export interface PermissionGuardConfig {
     enableCompanyFeature?: boolean;
     userPermissionKeyFormat?: string;
     companyPermissionKeyFormat?: string;
+    multiTenant?: boolean;
 }

package/modules/shared-permission-cache/shared-permission-cache.service.d.ts

@@ -1,10 +1,12 @@
 import { HybridCache } from '../../classes/hybrid-cache.class.js';
 import type { ILogicNode, PermissionGuardConfig } from '../../interfaces/index.js';
+import { type IPermissionResolver } from '../../interfaces/permission-resolver.interface.js';
 import { type PermissionCacheKeyOptions } from '../../utils/permission-cache-key.util.js';
 export declare class SharedPermissionCacheService {
     private readonly cache?;
+    private readonly resolver?;
     private readonly config;
-    constructor(cache?: HybridCache | undefined, config?: PermissionGuardConfig);
+    constructor(cache?: HybridCache | undefined, config?: PermissionGuardConfig, resolver?: IPermissionResolver | undefined);
     getPermissions(options: PermissionCacheKeyOptions): Promise<string[]>;
     setPermissions(options: PermissionCacheKeyOptions, permissions: string[], ttl?: number): Promise<void>;
     clearPermissions(options: PermissionCacheKeyOptions): Promise<void>;

package/modules/utils/utils.service.d.ts

@@ -1,10 +1,10 @@
 import { HybridCache } from '../../classes/hybrid-cache.class.js';
 export declare class UtilsService {
-    getCacheKey(entityName: string, params: any, entityId?: string, tenantId?: string): string;
-    trackCacheKey(cacheKey: string, entityName: string, cacheManager: HybridCache, entityId?: string, tenantId?: string): Promise<void>;
-    clearCache(entityName: string, cacheManager: HybridCache, entityId?: string, tenantId?: string): Promise<void>;
-    transformToSlug(value: string, salt?: boolean): string;
-    getRandomInt(min: number, max: number): number;
+    private readonly logger;
+    getCacheStamp(cacheManager: HybridCache, entityNames: string[], tenantId?: string): Promise<string>;
+    getCacheKey(entityName: string, params: unknown, entityId: string | undefined, tenantId: string | undefined, stamp: string): string;
+    clearCache(entityName: string, cacheManager: HybridCache, tenantId?: string): Promise<void>;
+    getStampName(entityName: string, tenantId?: string): string;
+    transformToSlug(value: string): string;
     private buildTenantPrefix;
-    private buildTrackingKey;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flusys/nestjs-shared",
-  "version": "9.1.2",
+  "version": "9.2.0",
   "description": "Common shared utilities for Flusys NestJS applications",
   "type": "module",
   "main": "./fesm/index.js",
@@ -104,7 +104,7 @@
     "rxjs": "^7.8.0"
   },
   "dependencies": {
-    "@flusys/nestjs-core": "9.1.2",
+    "@flusys/nestjs-core": "9.2.0",
     "re2js": "^2.8.6"
   }
 }

package/utils/date-time.util.d.ts

@@ -5,4 +5,3 @@ export declare function utcToLocal(utcDate: Date | string, timezone: string): {
     display: string;
 };
 export declare function formatInTimezone(utcDate: Date | string, timezone: string, options?: Intl.DateTimeFormatOptions): string;
-export declare function getTodayInTimezone(timezone: string): string;

package/utils/event-pattern.util.d.ts

@@ -1,3 +1,4 @@
 export declare function matchEventPattern(pattern: string, eventName: string): boolean;
 export declare function isMultiWildcard(segment: string): boolean;
 export declare function sanitizeEventPayload<T>(value: T): T;
+export declare function isSensitiveKey(key: string): boolean;

package/utils/permission-cache-key.util.d.ts

@@ -1,3 +1,4 @@
+import { type HybridCache } from '../classes/hybrid-cache.class.js';
 import { type PermissionGuardConfig } from '../interfaces/permission.interface.js';
 export interface PermissionCacheKeyOptions {
     userId: string;
@@ -7,3 +8,5 @@ export interface PermissionCacheKeyOptions {
 export declare const DEFAULT_USER_PERMISSION_KEY_FORMAT = "my-permissions:user:{userId}";
 export declare const DEFAULT_COMPANY_PERMISSION_KEY_FORMAT = "my-permissions:company:{companyId}:branch:{branchId}:user:{userId}";
 export declare function buildPermissionCacheKey(options: PermissionCacheKeyOptions, config?: PermissionGuardConfig): string;
+export declare function resolvePermissionCacheKey(cache: Pick<HybridCache, 'getStamp'>, options: PermissionCacheKeyOptions, config?: PermissionGuardConfig): Promise<string>;
+export declare function invalidatePermissionCache(cache: Pick<HybridCache, 'bumpStamp'>, userId: string, config?: PermissionGuardConfig): Promise<void>;

package/utils/query-helpers.util.d.ts

@@ -1,4 +1,4 @@
-import { type ObjectLiteral, type QueryRunner, SelectQueryBuilder } from 'typeorm';
+import { type FindOperator, type ObjectLiteral, type QueryRunner, SelectQueryBuilder } from 'typeorm';
 import { type ILoggedUserInfo } from '../interfaces/index.js';
 export interface ICompanyFilterConfig {
     isCompanyFeatureEnabled: boolean;
@@ -13,7 +13,7 @@ export interface IBranchFilterConfig {
 }
 export declare function applyBranchFilter<T extends ObjectLiteral>(query: SelectQueryBuilder<T>, config: IBranchFilterConfig, branchIds: ReadonlyArray<string | null | undefined>): SelectQueryBuilder<T>;
 export declare function buildCompanyWhereCondition<T extends Record<string, unknown>>(baseWhere: T, isCompanyFeatureEnabled: boolean, user: ILoggedUserInfo | null | undefined): T & {
-    companyId?: string;
+    companyId?: string | FindOperator<string>;
 };
 export interface ICompanyEnabled {
     companyId?: string | null;