driftdetect-core 0.4.6 → 0.6.0

package/dist/patterns/adapters/service-factory.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Service Factory
+ *
+ * Factory functions for creating PatternService instances from legacy stores.
+ * This is the recommended way to migrate consumers to the new pattern system.
+ *
+ * @module patterns/adapters/service-factory
+ */
+import type { PatternStore } from '../../store/pattern-store.js';
+import type { IPatternService, PatternServiceConfig } from '../service.js';
+/**
+ * Create a PatternService from an existing PatternStore.
+ *
+ * This is the recommended migration path for consumers currently using
+ * PatternStore directly. The service provides a higher-level API with
+ * caching, metrics, and business logic.
+ *
+ * The returned service auto-initializes on first use, so you don't need
+ * to call initialize() manually.
+ *
+ * @example
+ * ```typescript
+ * // Before (direct PatternStore usage)
+ * const store = new PatternStore({ rootDir });
+ * await store.initialize();
+ * const patterns = store.getAll();
+ *
+ * // After (using PatternService)
+ * const store = new PatternStore({ rootDir });
+ * const service = createPatternServiceFromStore(store, rootDir);
+ * const result = await service.listPatterns(); // Auto-initializes
+ * ```
+ *
+ * @param store The existing PatternStore instance
+ * @param rootDir The project root directory (for reading code examples)
+ * @param config Optional service configuration
+ * @returns A PatternService instance wrapping the store
+ */
+export declare function createPatternServiceFromStore(store: PatternStore, rootDir: string, config?: Partial<PatternServiceConfig>): IPatternService;
+//# sourceMappingURL=service-factory.d.ts.map

package/dist/patterns/adapters/service-factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-factory.d.ts","sourceRoot":"","sources":["../../../src/patterns/adapters/service-factory.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AACjE,OAAO,KAAK,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAkI3E;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,6BAA6B,CAC3C,KAAK,EAAE,YAAY,EACnB,OAAO,EAAE,MAAM,EACf,MAAM,CAAC,EAAE,OAAO,CAAC,oBAAoB,CAAC,GACrC,eAAe,CAGjB"}

package/dist/patterns/adapters/service-factory.js

@@ -0,0 +1,144 @@
+/**
+ * Service Factory
+ *
+ * Factory functions for creating PatternService instances from legacy stores.
+ * This is the recommended way to migrate consumers to the new pattern system.
+ *
+ * @module patterns/adapters/service-factory
+ */
+import { PatternStoreAdapter } from './pattern-store-adapter.js';
+import { PatternService } from '../impl/pattern-service.js';
+/**
+ * A wrapper that auto-initializes the repository on first use.
+ * This provides a seamless experience for consumers who don't want
+ * to manually call initialize().
+ */
+class AutoInitPatternService {
+    inner;
+    repository;
+    initPromise = null;
+    constructor(repository, rootDir, config) {
+        this.repository = repository;
+        this.inner = new PatternService(repository, rootDir, config);
+    }
+    async ensureInitialized() {
+        if (!this.initPromise) {
+            this.initPromise = this.repository.initialize();
+        }
+        await this.initPromise;
+    }
+    async getStatus() {
+        await this.ensureInitialized();
+        return this.inner.getStatus();
+    }
+    async getCategories() {
+        await this.ensureInitialized();
+        return this.inner.getCategories();
+    }
+    async listPatterns(options) {
+        await this.ensureInitialized();
+        return this.inner.listPatterns(options);
+    }
+    async listByCategory(...args) {
+        await this.ensureInitialized();
+        return this.inner.listByCategory(...args);
+    }
+    async listByStatus(...args) {
+        await this.ensureInitialized();
+        return this.inner.listByStatus(...args);
+    }
+    async getPattern(id) {
+        await this.ensureInitialized();
+        return this.inner.getPattern(id);
+    }
+    async getPatternWithExamples(id, maxExamples) {
+        await this.ensureInitialized();
+        return this.inner.getPatternWithExamples(id, maxExamples);
+    }
+    async getPatternsByFile(file) {
+        await this.ensureInitialized();
+        return this.inner.getPatternsByFile(file);
+    }
+    async approvePattern(id, approvedBy) {
+        await this.ensureInitialized();
+        return this.inner.approvePattern(id, approvedBy);
+    }
+    async ignorePattern(id) {
+        await this.ensureInitialized();
+        return this.inner.ignorePattern(id);
+    }
+    async approveMany(ids, approvedBy) {
+        await this.ensureInitialized();
+        return this.inner.approveMany(ids, approvedBy);
+    }
+    async ignoreMany(ids) {
+        await this.ensureInitialized();
+        return this.inner.ignoreMany(ids);
+    }
+    async search(...args) {
+        await this.ensureInitialized();
+        return this.inner.search(...args);
+    }
+    async query(...args) {
+        await this.ensureInitialized();
+        return this.inner.query(...args);
+    }
+    // === Write Operations ===
+    async addPattern(...args) {
+        await this.ensureInitialized();
+        return this.inner.addPattern(...args);
+    }
+    async addPatterns(...args) {
+        await this.ensureInitialized();
+        return this.inner.addPatterns(...args);
+    }
+    async updatePattern(...args) {
+        await this.ensureInitialized();
+        return this.inner.updatePattern(...args);
+    }
+    async deletePattern(...args) {
+        await this.ensureInitialized();
+        return this.inner.deletePattern(...args);
+    }
+    async save() {
+        await this.ensureInitialized();
+        return this.inner.save();
+    }
+    async clear() {
+        await this.ensureInitialized();
+        return this.inner.clear();
+    }
+}
+/**
+ * Create a PatternService from an existing PatternStore.
+ *
+ * This is the recommended migration path for consumers currently using
+ * PatternStore directly. The service provides a higher-level API with
+ * caching, metrics, and business logic.
+ *
+ * The returned service auto-initializes on first use, so you don't need
+ * to call initialize() manually.
+ *
+ * @example
+ * ```typescript
+ * // Before (direct PatternStore usage)
+ * const store = new PatternStore({ rootDir });
+ * await store.initialize();
+ * const patterns = store.getAll();
+ *
+ * // After (using PatternService)
+ * const store = new PatternStore({ rootDir });
+ * const service = createPatternServiceFromStore(store, rootDir);
+ * const result = await service.listPatterns(); // Auto-initializes
+ * ```
+ *
+ * @param store The existing PatternStore instance
+ * @param rootDir The project root directory (for reading code examples)
+ * @param config Optional service configuration
+ * @returns A PatternService instance wrapping the store
+ */
+export function createPatternServiceFromStore(store, rootDir, config) {
+    const adapter = new PatternStoreAdapter(store);
+    return new AutoInitPatternService(adapter, rootDir, config);
+}
+//# sourceMappingURL=service-factory.js.map

package/dist/patterns/adapters/service-factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-factory.js","sourceRoot":"","sources":["../../../src/patterns/adapters/service-factory.ts"],"names":[],"mappings":"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"}

package/dist/patterns/errors.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Pattern System Errors
+ *
+ * Shared error classes for the pattern system.
+ *
+ * @module patterns/errors
+ */
+import type { PatternStatus } from './types.js';
+/**
+ * Error thrown when a pattern is not found
+ */
+export declare class PatternNotFoundError extends Error {
+    readonly patternId: string;
+    constructor(patternId: string);
+}
+/**
+ * Error thrown when an invalid state transition is attempted
+ */
+export declare class InvalidStatusTransitionError extends Error {
+    readonly patternId: string;
+    readonly fromStatus: PatternStatus;
+    readonly toStatus: PatternStatus;
+    constructor(patternId: string, fromStatus: PatternStatus, toStatus: PatternStatus);
+}
+/**
+ * Error thrown when trying to add a pattern that already exists
+ */
+export declare class PatternAlreadyExistsError extends Error {
+    readonly patternId: string;
+    constructor(patternId: string);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/patterns/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/patterns/errors.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD;;GAEG;AACH,qBAAa,oBAAqB,SAAQ,KAAK;aACjB,SAAS,EAAE,MAAM;gBAAjB,SAAS,EAAE,MAAM;CAI9C;AAED;;GAEG;AACH,qBAAa,4BAA6B,SAAQ,KAAK;aAEnC,SAAS,EAAE,MAAM;aACjB,UAAU,EAAE,aAAa;aACzB,QAAQ,EAAE,aAAa;gBAFvB,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,aAAa,EACzB,QAAQ,EAAE,aAAa;CAK1C;AAED;;GAEG;AACH,qBAAa,yBAA0B,SAAQ,KAAK;aACtB,SAAS,EAAE,MAAM;gBAAjB,SAAS,EAAE,MAAM;CAI9C"}

package/dist/patterns/errors.js

@@ -0,0 +1,45 @@
+/**
+ * Pattern System Errors
+ *
+ * Shared error classes for the pattern system.
+ *
+ * @module patterns/errors
+ */
+/**
+ * Error thrown when a pattern is not found
+ */
+export class PatternNotFoundError extends Error {
+    patternId;
+    constructor(patternId) {
+        super(`Pattern not found: ${patternId}`);
+        this.patternId = patternId;
+        this.name = 'PatternNotFoundError';
+    }
+}
+/**
+ * Error thrown when an invalid state transition is attempted
+ */
+export class InvalidStatusTransitionError extends Error {
+    patternId;
+    fromStatus;
+    toStatus;
+    constructor(patternId, fromStatus, toStatus) {
+        super(`Invalid status transition for pattern ${patternId}: ${fromStatus} → ${toStatus}`);
+        this.patternId = patternId;
+        this.fromStatus = fromStatus;
+        this.toStatus = toStatus;
+        this.name = 'InvalidStatusTransitionError';
+    }
+}
+/**
+ * Error thrown when trying to add a pattern that already exists
+ */
+export class PatternAlreadyExistsError extends Error {
+    patternId;
+    constructor(patternId) {
+        super(`Pattern already exists: ${patternId}`);
+        this.patternId = patternId;
+        this.name = 'PatternAlreadyExistsError';
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/patterns/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/patterns/errors.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH;;GAEG;AACH,MAAM,OAAO,oBAAqB,SAAQ,KAAK;IACjB;IAA5B,YAA4B,SAAiB;QAC3C,KAAK,CAAC,sBAAsB,SAAS,EAAE,CAAC,CAAC;QADf,cAAS,GAAT,SAAS,CAAQ;QAE3C,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;IACrC,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,4BAA6B,SAAQ,KAAK;IAEnC;IACA;IACA;IAHlB,YACkB,SAAiB,EACjB,UAAyB,EACzB,QAAuB;QAEvC,KAAK,CAAC,yCAAyC,SAAS,KAAK,UAAU,MAAM,QAAQ,EAAE,CAAC,CAAC;QAJzE,cAAS,GAAT,SAAS,CAAQ;QACjB,eAAU,GAAV,UAAU,CAAe;QACzB,aAAQ,GAAR,QAAQ,CAAe;QAGvC,IAAI,CAAC,IAAI,GAAG,8BAA8B,CAAC;IAC7C,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,yBAA0B,SAAQ,KAAK;IACtB;IAA5B,YAA4B,SAAiB;QAC3C,KAAK,CAAC,2BAA2B,SAAS,EAAE,CAAC,CAAC;QADpB,cAAS,GAAT,SAAS,CAAQ;QAE3C,IAAI,CAAC,IAAI,GAAG,2BAA2B,CAAC;IAC1C,CAAC;CACF"}

package/dist/patterns/impl/cached-repository.d.ts

@@ -0,0 +1,79 @@
+/**
+ * Cached Pattern Repository
+ *
+ * Decorator implementation of IPatternRepository that adds caching
+ * on top of any other repository implementation.
+ *
+ * @module patterns/impl/cached-repository
+ */
+import { EventEmitter } from 'node:events';
+import type { Pattern, PatternCategory, PatternStatus, PatternSummary } from '../types.js';
+import type { IPatternRepository, PatternRepositoryEventType, PatternRepositoryEventHandler, PatternQueryOptions, PatternQueryResult, PatternFilter } from '../repository.js';
+interface CacheConfig {
+    /** TTL for pattern cache in milliseconds */
+    patternTtlMs: number;
+    /** TTL for query cache in milliseconds */
+    queryTtlMs: number;
+    /** Maximum number of cached queries */
+    maxCachedQueries: number;
+}
+/**
+ * Cached pattern repository decorator.
+ *
+ * Wraps any IPatternRepository implementation and adds caching.
+ * Cache is automatically invalidated on write operations.
+ */
+export declare class CachedPatternRepository extends EventEmitter implements IPatternRepository {
+    private readonly inner;
+    private readonly config;
+    private patternCache;
+    private queryCache;
+    private allPatternsCache;
+    private countCache;
+    constructor(inner: IPatternRepository, config?: Partial<CacheConfig>);
+    private setupEventForwarding;
+    private isExpired;
+    private setPatternCache;
+    private getPatternCache;
+    private setQueryCache;
+    private getQueryCache;
+    private serializeQueryOptions;
+    private invalidateAllCaches;
+    private invalidatePatternCaches;
+    initialize(): Promise<void>;
+    close(): Promise<void>;
+    add(pattern: Pattern): Promise<void>;
+    addMany(patterns: Pattern[]): Promise<void>;
+    get(id: string): Promise<Pattern | null>;
+    update(id: string, updates: Partial<Pattern>): Promise<Pattern>;
+    delete(id: string): Promise<boolean>;
+    query(options: PatternQueryOptions): Promise<PatternQueryResult>;
+    getByCategory(category: PatternCategory): Promise<Pattern[]>;
+    getByStatus(status: PatternStatus): Promise<Pattern[]>;
+    getByFile(file: string): Promise<Pattern[]>;
+    getAll(): Promise<Pattern[]>;
+    count(filter?: PatternFilter): Promise<number>;
+    approve(id: string, approvedBy?: string): Promise<Pattern>;
+    ignore(id: string): Promise<Pattern>;
+    saveAll(): Promise<void>;
+    clear(): Promise<void>;
+    on(event: PatternRepositoryEventType, handler: PatternRepositoryEventHandler): this;
+    off(event: PatternRepositoryEventType, handler: PatternRepositoryEventHandler): this;
+    exists(id: string): Promise<boolean>;
+    getSummaries(options?: PatternQueryOptions): Promise<PatternSummary[]>;
+    /**
+     * Clear all caches.
+     */
+    clearCache(): void;
+    /**
+     * Get cache statistics.
+     */
+    getCacheStats(): {
+        patternCacheSize: number;
+        queryCacheSize: number;
+        countCacheSize: number;
+        hasAllPatternsCache: boolean;
+    };
+}
+export {};
+//# sourceMappingURL=cached-repository.d.ts.map

package/dist/patterns/impl/cached-repository.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cached-repository.d.ts","sourceRoot":"","sources":["../../../src/patterns/impl/cached-repository.ts"],"names":[],"mappings":"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"}

package/dist/patterns/impl/cached-repository.js

@@ -0,0 +1,296 @@
+/**
+ * Cached Pattern Repository
+ *
+ * Decorator implementation of IPatternRepository that adds caching
+ * on top of any other repository implementation.
+ *
+ * @module patterns/impl/cached-repository
+ */
+import { EventEmitter } from 'node:events';
+const DEFAULT_CACHE_CONFIG = {
+    patternTtlMs: 60000, // 1 minute
+    queryTtlMs: 30000, // 30 seconds
+    maxCachedQueries: 100,
+};
+// ============================================================================
+// Cached Pattern Repository
+// ============================================================================
+/**
+ * Cached pattern repository decorator.
+ *
+ * Wraps any IPatternRepository implementation and adds caching.
+ * Cache is automatically invalidated on write operations.
+ */
+export class CachedPatternRepository extends EventEmitter {
+    inner;
+    config;
+    // Pattern cache: id -> Pattern
+    patternCache = new Map();
+    // Query cache: serialized query -> result
+    queryCache = new Map();
+    // All patterns cache
+    allPatternsCache = null;
+    // Count cache
+    countCache = new Map();
+    constructor(inner, config = {}) {
+        super();
+        this.inner = inner;
+        this.config = { ...DEFAULT_CACHE_CONFIG, ...config };
+        // Forward events from inner repository
+        this.setupEventForwarding();
+    }
+    setupEventForwarding() {
+        const events = [
+            'pattern:added',
+            'pattern:updated',
+            'pattern:deleted',
+            'pattern:approved',
+            'pattern:ignored',
+            'patterns:loaded',
+            'patterns:saved',
+        ];
+        for (const event of events) {
+            this.inner.on(event, (pattern, metadata) => {
+                this.emit(event, pattern, metadata);
+            });
+        }
+    }
+    // ==========================================================================
+    // Cache Utilities
+    // ==========================================================================
+    isExpired(entry) {
+        return Date.now() > entry.expiresAt;
+    }
+    setPatternCache(pattern) {
+        this.patternCache.set(pattern.id, {
+            value: pattern,
+            expiresAt: Date.now() + this.config.patternTtlMs,
+        });
+    }
+    getPatternCache(id) {
+        const entry = this.patternCache.get(id);
+        if (!entry || this.isExpired(entry)) {
+            this.patternCache.delete(id);
+            return null;
+        }
+        return entry.value;
+    }
+    setQueryCache(key, result) {
+        // Evict oldest entries if at capacity
+        if (this.queryCache.size >= this.config.maxCachedQueries) {
+            const oldestKey = this.queryCache.keys().next().value;
+            if (oldestKey) {
+                this.queryCache.delete(oldestKey);
+            }
+        }
+        this.queryCache.set(key, {
+            value: result,
+            expiresAt: Date.now() + this.config.queryTtlMs,
+        });
+    }
+    getQueryCache(key) {
+        const entry = this.queryCache.get(key);
+        if (!entry || this.isExpired(entry)) {
+            this.queryCache.delete(key);
+            return null;
+        }
+        return entry.value;
+    }
+    serializeQueryOptions(options) {
+        return JSON.stringify(options);
+    }
+    invalidateAllCaches() {
+        this.patternCache.clear();
+        this.queryCache.clear();
+        this.allPatternsCache = null;
+        this.countCache.clear();
+    }
+    invalidatePatternCaches(id) {
+        this.patternCache.delete(id);
+        this.queryCache.clear(); // Queries may include this pattern
+        this.allPatternsCache = null;
+        this.countCache.clear();
+    }
+    // ==========================================================================
+    // Lifecycle
+    // ==========================================================================
+    async initialize() {
+        await this.inner.initialize();
+    }
+    async close() {
+        this.invalidateAllCaches();
+        await this.inner.close();
+    }
+    // ==========================================================================
+    // CRUD Operations
+    // ==========================================================================
+    async add(pattern) {
+        await this.inner.add(pattern);
+        this.setPatternCache(pattern);
+        this.invalidatePatternCaches(pattern.id);
+    }
+    async addMany(patterns) {
+        await this.inner.addMany(patterns);
+        for (const pattern of patterns) {
+            this.setPatternCache(pattern);
+        }
+        this.invalidateAllCaches();
+    }
+    async get(id) {
+        // Check cache first
+        const cached = this.getPatternCache(id);
+        if (cached) {
+            return cached;
+        }
+        // Fetch from inner repository
+        const pattern = await this.inner.get(id);
+        if (pattern) {
+            this.setPatternCache(pattern);
+        }
+        return pattern;
+    }
+    async update(id, updates) {
+        const updated = await this.inner.update(id, updates);
+        this.setPatternCache(updated);
+        this.invalidatePatternCaches(id);
+        return updated;
+    }
+    async delete(id) {
+        const result = await this.inner.delete(id);
+        if (result) {
+            this.invalidatePatternCaches(id);
+        }
+        return result;
+    }
+    // ==========================================================================
+    // Querying
+    // ==========================================================================
+    async query(options) {
+        const cacheKey = this.serializeQueryOptions(options);
+        // Check cache first
+        const cached = this.getQueryCache(cacheKey);
+        if (cached) {
+            return cached;
+        }
+        // Fetch from inner repository
+        const result = await this.inner.query(options);
+        this.setQueryCache(cacheKey, result);
+        // Also cache individual patterns
+        for (const pattern of result.patterns) {
+            this.setPatternCache(pattern);
+        }
+        return result;
+    }
+    async getByCategory(category) {
+        return this.inner.getByCategory(category);
+    }
+    async getByStatus(status) {
+        return this.inner.getByStatus(status);
+    }
+    async getByFile(file) {
+        return this.inner.getByFile(file);
+    }
+    async getAll() {
+        // Check cache first
+        if (this.allPatternsCache && !this.isExpired(this.allPatternsCache)) {
+            return this.allPatternsCache.value;
+        }
+        // Fetch from inner repository
+        const patterns = await this.inner.getAll();
+        this.allPatternsCache = {
+            value: patterns,
+            expiresAt: Date.now() + this.config.queryTtlMs,
+        };
+        // Also cache individual patterns
+        for (const pattern of patterns) {
+            this.setPatternCache(pattern);
+        }
+        return patterns;
+    }
+    async count(filter) {
+        const cacheKey = filter ? JSON.stringify(filter) : '__all__';
+        // Check cache first
+        const entry = this.countCache.get(cacheKey);
+        if (entry && !this.isExpired(entry)) {
+            return entry.value;
+        }
+        // Fetch from inner repository
+        const count = await this.inner.count(filter);
+        this.countCache.set(cacheKey, {
+            value: count,
+            expiresAt: Date.now() + this.config.queryTtlMs,
+        });
+        return count;
+    }
+    // ==========================================================================
+    // Status Transitions
+    // ==========================================================================
+    async approve(id, approvedBy) {
+        const updated = await this.inner.approve(id, approvedBy);
+        this.setPatternCache(updated);
+        this.invalidatePatternCaches(id);
+        return updated;
+    }
+    async ignore(id) {
+        const updated = await this.inner.ignore(id);
+        this.setPatternCache(updated);
+        this.invalidatePatternCaches(id);
+        return updated;
+    }
+    // ==========================================================================
+    // Batch Operations
+    // ==========================================================================
+    async saveAll() {
+        await this.inner.saveAll();
+    }
+    async clear() {
+        await this.inner.clear();
+        this.invalidateAllCaches();
+    }
+    // ==========================================================================
+    // Events
+    // ==========================================================================
+    on(event, handler) {
+        return super.on(event, handler);
+    }
+    off(event, handler) {
+        return super.off(event, handler);
+    }
+    // ==========================================================================
+    // Utilities
+    // ==========================================================================
+    async exists(id) {
+        // Check cache first
+        if (this.patternCache.has(id)) {
+            const entry = this.patternCache.get(id);
+            if (!this.isExpired(entry)) {
+                return true;
+            }
+        }
+        return this.inner.exists(id);
+    }
+    async getSummaries(options) {
+        return this.inner.getSummaries(options);
+    }
+    // ==========================================================================
+    // Cache Management
+    // ==========================================================================
+    /**
+     * Clear all caches.
+     */
+    clearCache() {
+        this.invalidateAllCaches();
+    }
+    /**
+     * Get cache statistics.
+     */
+    getCacheStats() {
+        return {
+            patternCacheSize: this.patternCache.size,
+            queryCacheSize: this.queryCache.size,
+            countCacheSize: this.countCache.size,
+            hasAllPatternsCache: this.allPatternsCache !== null,
+        };
+    }
+}
+//# sourceMappingURL=cached-repository.js.map