@nestjs-redisx/cache 1.0.0

package/dist/invalidation/application/ports/event-invalidation.port.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Event invalidation service port.
+ */
+export interface IInvalidationResult {
+    event: string;
+    tagsInvalidated: string[];
+    keysInvalidated: string[];
+    totalKeysDeleted: number;
+    duration: number;
+    skipped: boolean;
+    skipReason?: string;
+}
+export type InvalidationHandler = (event: string, payload: unknown, result: IInvalidationResult) => void | Promise<void>;
+export interface IEventInvalidationService {
+    /**
+     * Process invalidation event.
+     */
+    processEvent(event: string, payload: unknown): Promise<IInvalidationResult>;
+    /**
+     * Emit invalidation event (for internal source).
+     */
+    emit(event: string, payload: unknown): Promise<void>;
+    /**
+     * Subscribe to invalidation events.
+     */
+    subscribe(handler: InvalidationHandler): () => void;
+}
+//# sourceMappingURL=event-invalidation.port.d.ts.map

package/dist/invalidation/application/ports/event-invalidation.port.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-invalidation.port.d.ts","sourceRoot":"","sources":["../../../../src/invalidation/application/ports/event-invalidation.port.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,gBAAgB,EAAE,MAAM,CAAC;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,MAAM,mBAAmB,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,mBAAmB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAEzH,MAAM,WAAW,yBAAyB;IACxC;;OAEG;IACH,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAE5E;;OAEG;IACH,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAErD;;OAEG;IACH,SAAS,CAAC,OAAO,EAAE,mBAAmB,GAAG,MAAM,IAAI,CAAC;CACrD"}

package/dist/invalidation/application/ports/invalidation-registry.port.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Invalidation registry port.
+ */
+import { InvalidationRule } from '../../domain/entities/invalidation-rule.entity';
+export interface IResolvedInvalidation {
+    tags: string[];
+    keys: string[];
+    matchedRules: InvalidationRule[];
+}
+export interface IInvalidationRegistry {
+    /**
+     * Register invalidation rule.
+     */
+    register(rule: InvalidationRule): void;
+    /**
+     * Register multiple rules.
+     */
+    registerMany(rules: InvalidationRule[]): void;
+    /**
+     * Unregister rule by event pattern.
+     */
+    unregister(event: string): void;
+    /**
+     * Find matching rules for event.
+     */
+    findRules(event: string): InvalidationRule[];
+    /**
+     * Resolve tags/keys for event with payload.
+     */
+    resolve(event: string, payload: unknown): IResolvedInvalidation;
+    /**
+     * Get all registered rules.
+     */
+    getRules(): InvalidationRule[];
+}
+//# sourceMappingURL=invalidation-registry.port.d.ts.map

package/dist/invalidation/application/ports/invalidation-registry.port.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"invalidation-registry.port.d.ts","sourceRoot":"","sources":["../../../../src/invalidation/application/ports/invalidation-registry.port.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,gDAAgD,CAAC;AAElF,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,YAAY,EAAE,gBAAgB,EAAE,CAAC;CAClC;AAED,MAAM,WAAW,qBAAqB;IACpC;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,gBAAgB,GAAG,IAAI,CAAC;IAEvC;;OAEG;IACH,YAAY,CAAC,KAAK,EAAE,gBAAgB,EAAE,GAAG,IAAI,CAAC;IAE9C;;OAEG;IACH,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAEhC;;OAEG;IACH,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,gBAAgB,EAAE,CAAC;IAE7C;;OAEG;IACH,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,qBAAqB,CAAC;IAEhE;;OAEG;IACH,QAAQ,IAAI,gBAAgB,EAAE,CAAC;CAChC"}

package/dist/invalidation/application/services/event-invalidation.service.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Event invalidation service.
+ * Processes invalidation events and coordinates cache invalidation.
+ */
+import { OnModuleInit } from '@nestjs/common';
+import { IRedisDriver } from '@nestjs-redisx/core';
+import { ICacheService } from '../../../cache/application/ports/cache-service.port';
+import { ICachePluginOptions } from '../../../shared/types';
+import { IEventInvalidationService, InvalidationHandler, IInvalidationResult } from '../ports/event-invalidation.port';
+import { IInvalidationRegistry } from '../ports/invalidation-registry.port';
+export declare class EventInvalidationService implements IEventInvalidationService, OnModuleInit {
+    private readonly registry;
+    private readonly cacheService;
+    private readonly driver;
+    private readonly config;
+    private readonly logger;
+    private readonly handlers;
+    private readonly eventEmitter;
+    constructor(registry: IInvalidationRegistry, cacheService: ICacheService, driver: IRedisDriver, config: ICachePluginOptions);
+    onModuleInit(): Promise<void>;
+    processEvent(event: string, payload: unknown): Promise<IInvalidationResult>;
+    emit(event: string, payload: unknown): Promise<void>;
+    subscribe(handler: InvalidationHandler): () => void;
+    private setupInternalSource;
+    private checkDuplicate;
+    private markProcessed;
+    private generateEventId;
+    private notifyHandlers;
+}
+//# sourceMappingURL=event-invalidation.service.d.ts.map

package/dist/invalidation/application/services/event-invalidation.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-invalidation.service.d.ts","sourceRoot":"","sources":["../../../../src/invalidation/application/services/event-invalidation.service.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,OAAO,EAA8B,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC1E,OAAO,EAAgB,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAEjE,OAAO,EAAE,aAAa,EAAE,MAAM,qDAAqD,CAAC;AAEpF,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,yBAAyB,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AACvH,OAAO,EAAE,qBAAqB,EAAE,MAAM,qCAAqC,CAAC;AAE5E,qBACa,wBAAyB,YAAW,yBAAyB,EAAE,YAAY;IAOpF,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACF,OAAO,CAAC,QAAQ,CAAC,YAAY;IAC9B,OAAO,CAAC,QAAQ,CAAC,MAAM;IACf,OAAO,CAAC,QAAQ,CAAC,MAAM;IATvD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA6C;IACpE,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAkC;IAC3D,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAsB;gBAIhC,QAAQ,EAAE,qBAAqB,EACR,YAAY,EAAE,aAAa,EAC5B,MAAM,EAAE,YAAY,EACZ,MAAM,EAAE,mBAAmB;IAItE,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;IAW7B,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,mBAAmB,CAAC;IA2E3E,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAI1D,SAAS,CAAC,OAAO,EAAE,mBAAmB,GAAG,MAAM,IAAI;IAKnD,OAAO,CAAC,mBAAmB;YAWb,cAAc;YAWd,aAAa;IAW3B,OAAO,CAAC,eAAe;YAST,cAAc;CAU7B"}

package/dist/invalidation/application/services/invalidation-registry.service.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Invalidation registry service.
+ * Manages invalidation rules and resolves what to invalidate for events.
+ */
+import { InvalidationRule } from '../../domain/entities/invalidation-rule.entity';
+import { IInvalidationRegistry, IResolvedInvalidation } from '../ports/invalidation-registry.port';
+export declare class InvalidationRegistryService implements IInvalidationRegistry {
+    private readonly logger;
+    private rules;
+    register(rule: InvalidationRule): void;
+    registerMany(rules: InvalidationRule[]): void;
+    unregister(event: string): void;
+    findRules(event: string): InvalidationRule[];
+    resolve(event: string, payload: unknown): IResolvedInvalidation;
+    getRules(): InvalidationRule[];
+}
+//# sourceMappingURL=invalidation-registry.service.d.ts.map

package/dist/invalidation/application/services/invalidation-registry.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"invalidation-registry.service.d.ts","sourceRoot":"","sources":["../../../../src/invalidation/application/services/invalidation-registry.service.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,EAAE,gBAAgB,EAAE,MAAM,gDAAgD,CAAC;AAClF,OAAO,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,MAAM,qCAAqC,CAAC;AAEnG,qBACa,2BAA4B,YAAW,qBAAqB;IACvE,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgD;IACvE,OAAO,CAAC,KAAK,CAA0B;IAEvC,QAAQ,CAAC,IAAI,EAAE,gBAAgB,GAAG,IAAI;IAQtC,YAAY,CAAC,KAAK,EAAE,gBAAgB,EAAE,GAAG,IAAI;IAM7C,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAU/B,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,gBAAgB,EAAE;IAI5C,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,qBAAqB;IAiD/D,QAAQ,IAAI,gBAAgB,EAAE;CAG/B"}

package/dist/invalidation/domain/entities/invalidation-rule.entity.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Invalidation rule entity.
+ * Defines what to invalidate when an event occurs.
+ */
+export interface IInvalidationRuleProps {
+    event: string;
+    tags?: string[];
+    keys?: string[];
+    condition?: (payload: unknown) => boolean;
+    priority?: number;
+}
+export declare class InvalidationRule {
+    private readonly eventPattern;
+    private readonly tagTemplates;
+    private readonly keyTemplates;
+    private readonly condition?;
+    private readonly priority;
+    private constructor();
+    /**
+     * Creates InvalidationRule from props.
+     */
+    static create(props: IInvalidationRuleProps): InvalidationRule;
+    /**
+     * Tests if this rule matches the given event.
+     */
+    matches(event: string): boolean;
+    /**
+     * Tests if condition passes for the given payload.
+     */
+    testCondition(payload: unknown): boolean;
+    /**
+     * Resolves tags for the given payload.
+     */
+    resolveTags(payload: unknown): string[];
+    /**
+     * Resolves keys for the given payload.
+     */
+    resolveKeys(payload: unknown): string[];
+    /**
+     * Gets rule priority (higher = processed first).
+     */
+    getPriority(): number;
+    /**
+     * Gets the event pattern string.
+     */
+    getEventPattern(): string;
+    /**
+     * Checks if rule has any tags.
+     */
+    hasTags(): boolean;
+    /**
+     * Checks if rule has any keys.
+     */
+    hasKeys(): boolean;
+    /**
+     * Checks if rule has a condition.
+     */
+    hasCondition(): boolean;
+}
+//# sourceMappingURL=invalidation-rule.entity.d.ts.map

package/dist/invalidation/domain/entities/invalidation-rule.entity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"invalidation-rule.entity.d.ts","sourceRoot":"","sources":["../../../../src/invalidation/domain/entities/invalidation-rule.entity.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC;IAC1C,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAe;IAC5C,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAgB;IAC7C,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAgB;IAC7C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAgC;IAC3D,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAElC,OAAO;IAQP;;OAEG;IACH,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,sBAAsB,GAAG,gBAAgB;IAY9D;;OAEG;IACH,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAI/B;;OAEG;IACH,aAAa,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO;IAaxC;;OAEG;IACH,WAAW,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,EAAE;IAIvC;;OAEG;IACH,WAAW,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,EAAE;IAIvC;;OAEG;IACH,WAAW,IAAI,MAAM;IAIrB;;OAEG;IACH,eAAe,IAAI,MAAM;IAIzB;;OAEG;IACH,OAAO,IAAI,OAAO;IAIlB;;OAEG;IACH,OAAO,IAAI,OAAO;IAIlB;;OAEG;IACH,YAAY,IAAI,OAAO;CAGxB"}

package/dist/invalidation/domain/value-objects/event-pattern.vo.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Event pattern value object.
+ * Supports AMQP-style wildcards: '*' for one word, '#' for zero or more words.
+ */
+export declare class EventPattern {
+    private readonly pattern;
+    private readonly regex;
+    private constructor();
+    /**
+     * Creates EventPattern from string pattern.
+     * @param pattern - AMQP-style pattern (e.g., 'user.*', 'order.#', 'product.updated')
+     */
+    static create(pattern: string): EventPattern;
+    /**
+     * Tests if this pattern matches the given event.
+     */
+    matches(event: string): boolean;
+    /**
+     * Returns the raw pattern string.
+     */
+    toString(): string;
+    /**
+     * Checks equality with another pattern.
+     */
+    equals(other: EventPattern): boolean;
+}
+//# sourceMappingURL=event-pattern.vo.d.ts.map

package/dist/invalidation/domain/value-objects/event-pattern.vo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-pattern.vo.d.ts","sourceRoot":"","sources":["../../../../src/invalidation/domain/value-objects/event-pattern.vo.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAE/B,OAAO;IAKP;;;OAGG;IACH,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,YAAY;IA4B5C;;OAEG;IACH,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAI/B;;OAEG;IACH,QAAQ,IAAI,MAAM;IAIlB;;OAEG;IACH,MAAM,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO;CAGrC"}

package/dist/invalidation/domain/value-objects/tag-template.vo.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Tag template value object.
+ * Supports placeholders like 'user:{userId}' or 'tenant:{payload.tenantId}'.
+ */
+export declare class TagTemplate {
+    private readonly template;
+    private readonly placeholders;
+    private constructor();
+    /**
+     * Creates TagTemplate from template string.
+     * @param template - Template string with placeholders (e.g., 'user:{userId}')
+     */
+    static create(template: string): TagTemplate;
+    /**
+     * Resolves template with given payload.
+     * @param payload - Data object to resolve placeholders from
+     * @returns Resolved tag string
+     */
+    resolve(payload: unknown): string;
+    /**
+     * Returns the raw template string.
+     */
+    toString(): string;
+    /**
+     * Returns all placeholders in the template.
+     */
+    getPlaceholders(): string[];
+    /**
+     * Checks if template has any placeholders.
+     */
+    hasPlaceholders(): boolean;
+    private getNestedValue;
+}
+//# sourceMappingURL=tag-template.vo.d.ts.map

package/dist/invalidation/domain/value-objects/tag-template.vo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tag-template.vo.d.ts","sourceRoot":"","sources":["../../../../src/invalidation/domain/value-objects/tag-template.vo.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAW;IAExC,OAAO;IAKP;;;OAGG;IACH,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,WAAW;IAmB5C;;;;OAIG;IACH,OAAO,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM;IAWjC;;OAEG;IACH,QAAQ,IAAI,MAAM;IAIlB;;OAEG;IACH,eAAe,IAAI,MAAM,EAAE;IAI3B;;OAEG;IACH,eAAe,IAAI,OAAO;IAI1B,OAAO,CAAC,cAAc;CAsBvB"}

package/dist/invalidation/infrastructure/adapters/amqp-event-source.adapter.d.ts

@@ -0,0 +1,51 @@
+/**
+ * AMQP event source adapter.
+ * Integrates with RabbitMQ using @golevelup/nestjs-rabbitmq.
+ * This is an optional adapter that requires @golevelup/nestjs-rabbitmq to be installed.
+ */
+import { OnModuleInit } from '@nestjs/common';
+import { ICachePluginOptions } from '../../../shared/types';
+import { IEventInvalidationService } from '../../application/ports/event-invalidation.port';
+interface IInvalidationMessage {
+    payload: unknown;
+    timestamp?: number;
+    source?: string;
+}
+/**
+ * AMQP connection interface (from @golevelup/nestjs-rabbitmq).
+ * Using minimal interface to avoid tight coupling with the external library.
+ */
+interface IAMQPConnection {
+    createSubscriber(handler: (msg: IInvalidationMessage, rawMsg: IRawMessage) => Promise<void>, options: {
+        exchange: string;
+        queue: string;
+        routingKey: string[];
+        queueOptions: {
+            durable: boolean;
+        };
+    }): Promise<void>;
+}
+/**
+ * Raw AMQP message interface.
+ */
+interface IRawMessage {
+    fields: {
+        routingKey: string;
+    };
+}
+/**
+ * AMQP Event Source Adapter.
+ * Note: This adapter requires @golevelup/nestjs-rabbitmq to be installed.
+ * If not available, the adapter will log a warning and do nothing.
+ */
+export declare class AMQPEventSourceAdapter implements OnModuleInit {
+    private readonly invalidationService;
+    private readonly config;
+    private readonly logger;
+    private amqpConnection;
+    constructor(invalidationService: IEventInvalidationService, config: ICachePluginOptions, amqpConnection?: IAMQPConnection);
+    onModuleInit(): Promise<void>;
+    private getServiceName;
+}
+export {};
+//# sourceMappingURL=amqp-event-source.adapter.d.ts.map

package/dist/invalidation/infrastructure/adapters/amqp-event-source.adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"amqp-event-source.adapter.d.ts","sourceRoot":"","sources":["../../../../src/invalidation/infrastructure/adapters/amqp-event-source.adapter.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAsB,YAAY,EAAoB,MAAM,gBAAgB,CAAC;AAGpF,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,yBAAyB,EAAE,MAAM,iDAAiD,CAAC;AAE5F,UAAU,oBAAoB;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;GAGG;AACH,UAAU,eAAe;IACvB,gBAAgB,CACd,OAAO,EAAE,CAAC,GAAG,EAAE,oBAAoB,EAAE,MAAM,EAAE,WAAW,KAAK,OAAO,CAAC,IAAI,CAAC,EAC1E,OAAO,EAAE;QACP,QAAQ,EAAE,MAAM,CAAC;QACjB,KAAK,EAAE,MAAM,CAAC;QACd,UAAU,EAAE,MAAM,EAAE,CAAC;QACrB,YAAY,EAAE;YAAE,OAAO,EAAE,OAAO,CAAA;SAAE,CAAC;KACpC,GACA,OAAO,CAAC,IAAI,CAAC,CAAC;CAClB;AAED;;GAEG;AACH,UAAU,WAAW;IACnB,MAAM,EAAE;QACN,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;CACH;AAED;;;;GAIG;AACH,qBACa,sBAAuB,YAAW,YAAY;IAMvD,OAAO,CAAC,QAAQ,CAAC,mBAAmB;IACN,OAAO,CAAC,QAAQ,CAAC,MAAM;IANvD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA2C;IAClE,OAAO,CAAC,cAAc,CAA8B;gBAIjC,mBAAmB,EAAE,yBAAyB,EAChB,MAAM,EAAE,mBAAmB,EACrC,cAAc,CAAC,EAAE,eAAe;IAKjE,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;IA+CnC,OAAO,CAAC,cAAc;CAGvB"}

package/dist/invalidation/infrastructure/decorators/invalidate-on.decorator.d.ts

@@ -0,0 +1,69 @@
+/**
+ * @InvalidateOn decorator.
+ * Automatically invalidates cache after method execution based on events.
+ *
+ * Uses immediate proxy-based wrapping (not deferred to interceptor).
+ * Works on ANY Injectable class methods (services, repositories, etc).
+ */
+import 'reflect-metadata';
+export declare const INVALIDATE_ON_OPTIONS: unique symbol;
+/**
+ * Event invalidation service interface for decorator use.
+ */
+interface IDecoratorEventInvalidationService {
+    emit(event: string, payload: unknown): Promise<void>;
+}
+/**
+ * Register event invalidation service getter for lazy injection.
+ * Called by CacheDecoratorInitializerService during initialization.
+ */
+export declare function registerEventInvalidationServiceGetter(getter: () => IDecoratorEventInvalidationService): void;
+/**
+ * Get the registered event invalidation service.
+ */
+export declare function getEventInvalidationService(): IDecoratorEventInvalidationService | null;
+export interface IInvalidateOnOptions {
+    /** Events that trigger invalidation */
+    events: string[];
+    /** Tags to invalidate */
+    tags?: string[] | ((result: unknown, args: unknown[]) => string[]);
+    /** Keys to invalidate */
+    keys?: string[] | ((result: unknown, args: unknown[]) => string[]);
+    /** Condition - only invalidate if returns true */
+    condition?: (result: unknown, args: unknown[]) => boolean;
+    /** Publish event after method execution (for distributed invalidation) */
+    publish?: boolean;
+}
+/**
+ * Decorator that invalidates cache after method execution.
+ *
+ * Works on any Injectable class method, not just controllers.
+ *
+ * @param options - Invalidation options
+ *
+ * @example
+ * ```typescript
+ * @Injectable()
+ * class UserService {
+ *   @InvalidateOn({
+ *     events: ['user.updated'],
+ *     tags: (result, [userId]) => [`user:${userId}`, 'users'],
+ *   })
+ *   async updateUser(userId: string, data: UpdateUserDto): Promise<User> {
+ *     return this.userRepo.update(userId, data);
+ *   }
+ *
+ *   @InvalidateOn({
+ *     events: ['user.deleted'],
+ *     keys: (result, [userId]) => [`user:${userId}`],
+ *     tags: ['users'],
+ *   })
+ *   async deleteUser(userId: string): Promise<void> {
+ *     await this.userRepo.delete(userId);
+ *   }
+ * }
+ * ```
+ */
+export declare function InvalidateOn(options: IInvalidateOnOptions): MethodDecorator;
+export {};
+//# sourceMappingURL=invalidate-on.decorator.d.ts.map

package/dist/invalidation/infrastructure/decorators/invalidate-on.decorator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"invalidate-on.decorator.d.ts","sourceRoot":"","sources":["../../../../src/invalidation/infrastructure/decorators/invalidate-on.decorator.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,kBAAkB,CAAC;AAG1B,eAAO,MAAM,qBAAqB,eAAsC,CAAC;AAEzE;;GAEG;AACH,UAAU,kCAAkC;IAC1C,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACtD;AAKD;;;GAGG;AACH,wBAAgB,sCAAsC,CAAC,MAAM,EAAE,MAAM,kCAAkC,GAAG,IAAI,CAE7G;AAED;;GAEG;AACH,wBAAgB,2BAA2B,IAAI,kCAAkC,GAAG,IAAI,CAEvF;AAED,MAAM,WAAW,oBAAoB;IACnC,uCAAuC;IACvC,MAAM,EAAE,MAAM,EAAE,CAAC;IAEjB,yBAAyB;IACzB,IAAI,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,MAAM,EAAE,CAAC,CAAC;IAEnE,yBAAyB;IACzB,IAAI,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,MAAM,EAAE,CAAC,CAAC;IAEnE,kDAAkD;IAClD,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC;IAE1D,0EAA0E;IAC1E,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,oBAAoB,GAAG,eAAe,CAuE3E"}

package/dist/key-builder.d.ts

@@ -0,0 +1,199 @@
+/**
+ * Fluent key builder for cache keys.
+ *
+ * Provides a convenient API for building cache keys with proper formatting,
+ * validation, and separation.
+ *
+ * @example
+ * ```typescript
+ * // Simple key
+ * const key = KeyBuilder.create()
+ *   .prefix('app')
+ *   .segment('user')
+ *   .segment('123')
+ *   .build();
+ * // 'app:user:123'
+ *
+ * // With namespace
+ * const key = KeyBuilder.create()
+ *   .namespace('tenant-5')
+ *   .prefix('cache')
+ *   .segment('product')
+ *   .segment('456')
+ *   .build();
+ * // 'tenant-5:cache:product:456'
+ *
+ * // From template
+ * const key = KeyBuilder.fromTemplate('user:{userId}:post:{postId}', {
+ *   userId: '123',
+ *   postId: '456',
+ * });
+ * // 'user:123:post:456'
+ *
+ * // With versioning
+ * const key = KeyBuilder.create()
+ *   .prefix('cache')
+ *   .version('v2')
+ *   .segment('user')
+ *   .segment('123')
+ *   .build();
+ * // 'cache:v2:user:123'
+ * ```
+ */
+export interface IKeyBuilderOptions {
+    /**
+     * Separator between segments (default: ':')
+     */
+    separator?: string;
+    /**
+     * Maximum key length (default: 512)
+     */
+    maxLength?: number;
+    /**
+     * Whether to validate segments for invalid characters (default: true)
+     */
+    validate?: boolean;
+    /**
+     * Whether to convert segments to lowercase (default: false)
+     */
+    lowercase?: boolean;
+}
+export declare class KeyBuilder {
+    private keySegments;
+    private options;
+    private constructor();
+    /**
+     * Creates a new KeyBuilder instance.
+     *
+     * @param options - Builder options
+     * @returns New KeyBuilder
+     */
+    static create(options?: IKeyBuilderOptions): KeyBuilder;
+    /**
+     * Creates a key from a template string with placeholders.
+     *
+     * @param template - Template string (e.g., 'user:{id}:post:{postId}')
+     * @param params - Parameter values
+     * @param options - Builder options
+     * @returns Generated key
+     *
+     * @example
+     * ```typescript
+     * KeyBuilder.fromTemplate('user:{id}', { id: '123' })
+     * // 'user:123'
+     *
+     * KeyBuilder.fromTemplate('user:{userId}:post:{postId}', {
+     *   userId: '123',
+     *   postId: '456',
+     * })
+     * // 'user:123:post:456'
+     * ```
+     */
+    static fromTemplate(template: string, params: Record<string, string | number>, options?: IKeyBuilderOptions): string;
+    /**
+     * Creates a key from an array of segments.
+     *
+     * @param segments - Array of key segments
+     * @param options - Builder options
+     * @returns Generated key
+     */
+    static fromSegments(segments: string[], options?: IKeyBuilderOptions): string;
+    /**
+     * Adds a namespace segment (first segment).
+     *
+     * @param ns - Namespace value
+     * @returns This builder for chaining
+     */
+    namespace(ns: string): this;
+    /**
+     * Adds a prefix segment.
+     *
+     * @param prefix - Prefix value
+     * @returns This builder for chaining
+     */
+    prefix(prefix: string): this;
+    /**
+     * Adds a version segment.
+     *
+     * @param version - Version value (e.g., 'v1', 'v2')
+     * @returns This builder for chaining
+     */
+    version(version: string): this;
+    /**
+     * Adds a segment to the key.
+     *
+     * @param value - Segment value
+     * @returns This builder for chaining
+     */
+    segment(value: string | number): this;
+    /**
+     * Adds multiple segments at once.
+     *
+     * @param values - Array of segment values
+     * @returns This builder for chaining
+     */
+    segments(...values: Array<string | number>): this;
+    /**
+     * Adds a tag segment (useful for grouping).
+     *
+     * @param tag - Tag value
+     * @returns This builder for chaining
+     */
+    tag(tag: string): this;
+    /**
+     * Adds timestamp segment.
+     *
+     * @param timestamp - Unix timestamp (default: now)
+     * @returns This builder for chaining
+     */
+    timestamp(timestamp?: number): this;
+    /**
+     * Adds a hash segment from an object.
+     * Useful for cache keys based on complex objects.
+     *
+     * @param obj - Object to hash
+     * @returns This builder for chaining
+     */
+    hash(obj: unknown): this;
+    /**
+     * Builds and returns the final key.
+     *
+     * @returns Generated cache key
+     * @throws CacheKeyError if key is invalid
+     */
+    build(): string;
+    /**
+     * Resets the builder to initial state.
+     *
+     * @returns This builder for chaining
+     */
+    reset(): this;
+    /**
+     * Gets current segments.
+     *
+     * @returns Array of segments
+     */
+    getSegments(): string[];
+    /**
+     * Normalizes a segment value.
+     *
+     * @param value - Segment value
+     * @returns Normalized value
+     */
+    private normalizeSegment;
+    /**
+     * Validates a complete key.
+     *
+     * @param key - Key to validate
+     * @throws CacheKeyError if key is invalid
+     */
+    private validateKey;
+    /**
+     * Simple hash function for objects.
+     *
+     * @param str - String to hash
+     * @returns Hash string
+     */
+    private simpleHash;
+}
+//# sourceMappingURL=key-builder.d.ts.map

package/dist/key-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"key-builder.d.ts","sourceRoot":"","sources":["../src/key-builder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AAIH,MAAM,WAAW,kBAAkB;IACjC;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB;;OAEG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,qBAAa,UAAU;IACrB,OAAO,CAAC,WAAW,CAAgB;IACnC,OAAO,CAAC,OAAO,CAA+B;IAE9C,OAAO;IASP;;;;;OAKG;IACH,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,kBAAkB,GAAG,UAAU;IAIvD;;;;;;;;;;;;;;;;;;;OAmBG;IACH,MAAM,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,MAAM;IAiCpH;;;;;;OAMG;IACH,MAAM,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,MAAM;IAM7E;;;;;OAKG;IACH,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAK3B;;;;;OAKG;IACH,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAI5B;;;;;OAKG;IACH,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAI9B;;;;;OAKG;IACH,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAKrC;;;;;OAKG;IACH,QAAQ,CAAC,GAAG,MAAM,EAAE,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,GAAG,IAAI;IAKjD;;;;;OAKG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAMtB;;;;;OAKG;IACH,SAAS,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI;IAInC;;;;;;OAMG;IACH,IAAI,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI;IAKxB;;;;;OAKG;IACH,KAAK,IAAI,MAAM;IAWf;;;;OAIG;IACH,KAAK,IAAI,IAAI;IAKb;;;;OAIG;IACH,WAAW,IAAI,MAAM,EAAE;IAIvB;;;;;OAKG;IACH,OAAO,CAAC,gBAAgB;IAyBxB;;;;;OAKG;IACH,OAAO,CAAC,WAAW;IAyBnB;;;;;OAKG;IACH,OAAO,CAAC,UAAU;CASnB"}

package/dist/serializers/index.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Cache serializers for different data formats.
+ *
+ * @example
+ * ```typescript
+ * import { JsonSerializer, MsgpackSerializer } from '@nestjs-redisx/cache';
+ *
+ * const jsonSerializer = new JsonSerializer();
+ * const serialized = jsonSerializer.serialize({ id: 1, name: 'John' });
+ *
+ * // For better performance and smaller size, use MessagePack
+ * const msgpackSerializer = new MsgpackSerializer();
+ * const binary = msgpackSerializer.serialize(largeData);
+ * ```
+ */
+export type { ISerializer } from './serializer.interface';
+export { JsonSerializer } from './json.serializer';
+export { MsgpackSerializer } from './msgpack.serializer';
+//# sourceMappingURL=index.d.ts.map

package/dist/serializers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/serializers/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,YAAY,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC"}