@trokky/trokky 2.0.3

package/dist/structure/utils/hash.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Efficient Hashing Utilities
+ * Fast cache key generation without JSON.stringify
+ */
+/**
+ * Fast hash function for cache keys
+ * Uses FNV-1a algorithm for good distribution and speed
+ */
+export declare class FastHasher {
+    private static readonly FNV_OFFSET_BASIS;
+    private static readonly FNV_PRIME;
+    /**
+     * Generate a fast hash for any value
+     */
+    static hash(value: any): string;
+    /**
+     * Fast object stringification for hashing
+     * More efficient than JSON.stringify for cache keys
+     */
+    private static stringify;
+    /**
+     * Generate a structured cache key with namespace
+     */
+    static cacheKey(namespace: string, ...parts: any[]): string;
+}
+/**
+ * Stable hash for consistent ordering
+ * Ensures same input always produces same hash
+ */
+export declare class StableHasher {
+    /**
+     * Create a stable hash that's consistent across runs
+     */
+    static hash(value: any): string;
+    /**
+     * Normalize value for consistent hashing
+     */
+    private static normalize;
+}
+/**
+ * Cache key utilities for specific use cases
+ */
+export declare class CacheKeyUtils {
+    /**
+     * Generate query cache key
+     */
+    static queryKey(schemaType: string, filter: any, context?: any): string;
+    /**
+     * Generate navigation cache key
+     */
+    static navigationKey(structureTitle: string, userId?: string): string;
+    /**
+     * Generate permission cache key
+     */
+    static permissionKey(action: string, itemId: string, userId?: string): string;
+    /**
+     * Generate validation cache key
+     */
+    static validationKey(structureHash: string): string;
+}
+//# sourceMappingURL=hash.d.ts.map

package/dist/structure/utils/hash.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hash.d.ts","sourceRoot":"","sources":["../../../src/structure/utils/hash.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;GAGG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,gBAAgB,CAAa;IACrD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAW;IAE5C;;OAEG;IACH,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,GAAG,GAAG,MAAM;IAY/B;;;OAGG;IACH,OAAO,CAAC,MAAM,CAAC,SAAS;IAsBxB;;OAEG;IACH,MAAM,CAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,KAAK,EAAE,GAAG,EAAE,GAAG,MAAM;CAI5D;AAED;;;GAGG;AACH,qBAAa,YAAY;IACvB;;OAEG;IACH,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,GAAG,GAAG,MAAM;IAI/B;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,SAAS;CAkBzB;AAED;;GAEG;AACH,qBAAa,aAAa;IACxB;;OAEG;IACH,MAAM,CAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE,GAAG,GAAG,MAAM;IAIvE;;OAEG;IACH,MAAM,CAAC,aAAa,CAAC,cAAc,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM;IAIrE;;OAEG;IACH,MAAM,CAAC,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM;IAI7E;;OAEG;IACH,MAAM,CAAC,aAAa,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM;CAGpD"}

package/dist/structure/utils/hash.js

@@ -0,0 +1,118 @@
+/**
+ * Efficient Hashing Utilities
+ * Fast cache key generation without JSON.stringify
+ */
+/**
+ * Fast hash function for cache keys
+ * Uses FNV-1a algorithm for good distribution and speed
+ */
+export class FastHasher {
+    static FNV_OFFSET_BASIS = 2166136261;
+    static FNV_PRIME = 16777619;
+    /**
+     * Generate a fast hash for any value
+     */
+    static hash(value) {
+        const str = this.stringify(value);
+        let hash = this.FNV_OFFSET_BASIS;
+        for (let i = 0; i < str.length; i++) {
+            hash ^= str.charCodeAt(i);
+            hash = Math.imul(hash, this.FNV_PRIME);
+        }
+        return (hash >>> 0).toString(36);
+    }
+    /**
+     * Fast object stringification for hashing
+     * More efficient than JSON.stringify for cache keys
+     */
+    static stringify(obj) {
+        if (obj === null)
+            return 'null';
+        if (obj === undefined)
+            return 'undefined';
+        const type = typeof obj;
+        if (type === 'string')
+            return `"${obj}"`;
+        if (type === 'number' || type === 'boolean')
+            return String(obj);
+        if (type === 'function')
+            return obj.toString();
+        if (Array.isArray(obj)) {
+            return `[${obj.map(item => this.stringify(item)).join(',')}]`;
+        }
+        if (type === 'object') {
+            const keys = Object.keys(obj).sort(); // Sort for consistency
+            const pairs = keys.map(key => `"${key}":${this.stringify(obj[key])}`);
+            return `{${pairs.join(',')}}`;
+        }
+        return String(obj);
+    }
+    /**
+     * Generate a structured cache key with namespace
+     */
+    static cacheKey(namespace, ...parts) {
+        const hashParts = parts.map(part => this.hash(part)).join('-');
+        return `${namespace}:${hashParts}`;
+    }
+}
+/**
+ * Stable hash for consistent ordering
+ * Ensures same input always produces same hash
+ */
+export class StableHasher {
+    /**
+     * Create a stable hash that's consistent across runs
+     */
+    static hash(value) {
+        return FastHasher.hash(this.normalize(value));
+    }
+    /**
+     * Normalize value for consistent hashing
+     */
+    static normalize(obj) {
+        if (obj === null || obj === undefined)
+            return obj;
+        if (Array.isArray(obj)) {
+            return obj.map(item => this.normalize(item));
+        }
+        if (typeof obj === 'object' && obj.constructor === Object) {
+            const result = {};
+            const keys = Object.keys(obj).sort();
+            for (const key of keys) {
+                result[key] = this.normalize(obj[key]);
+            }
+            return result;
+        }
+        return obj;
+    }
+}
+/**
+ * Cache key utilities for specific use cases
+ */
+export class CacheKeyUtils {
+    /**
+     * Generate query cache key
+     */
+    static queryKey(schemaType, filter, context) {
+        return FastHasher.cacheKey('query', schemaType, filter, context);
+    }
+    /**
+     * Generate navigation cache key
+     */
+    static navigationKey(structureTitle, userId) {
+        return FastHasher.cacheKey('nav', structureTitle, userId || 'anonymous');
+    }
+    /**
+     * Generate permission cache key
+     */
+    static permissionKey(action, itemId, userId) {
+        return FastHasher.cacheKey('perm', action, itemId, userId || 'anonymous');
+    }
+    /**
+     * Generate validation cache key
+     */
+    static validationKey(structureHash) {
+        return FastHasher.cacheKey('valid', structureHash);
+    }
+}
+//# sourceMappingURL=hash.js.map

package/dist/structure/utils/hash.js.map

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

package/dist/structure/utils/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Utils Module Exports
+ */
+export { PermissionChecker } from './permission-checker.js';
+export { QueryBuilder } from './query-builder.js';
+export { StructureMerger } from './structure-merger.js';
+export type { PermissionCheckerOptions } from './permission-checker.js';
+export type { QueryBuilderOptions } from './query-builder.js';
+export type { MergeOptions, MergeResult, MergeConflict } from './structure-merger.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/structure/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/structure/utils/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAA;AAC3D,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;AAEvD,YAAY,EACV,wBAAwB,EACzB,MAAM,yBAAyB,CAAA;AAEhC,YAAY,EACV,mBAAmB,EACpB,MAAM,oBAAoB,CAAA;AAE3B,YAAY,EACV,YAAY,EACZ,WAAW,EACX,aAAa,EACd,MAAM,uBAAuB,CAAA"}

package/dist/structure/utils/index.js

@@ -0,0 +1,7 @@
+/**
+ * Utils Module Exports
+ */
+export { PermissionChecker } from './permission-checker.js';
+export { QueryBuilder } from './query-builder.js';
+export { StructureMerger } from './structure-merger.js';
+//# sourceMappingURL=index.js.map

package/dist/structure/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/structure/utils/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAA;AAC3D,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA"}

package/dist/structure/utils/permission-checker.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Permission Checker
+ * Utility for checking permissions against structure items
+ */
+import type { User } from '../../core/index.js';
+import type { PermissionConfig, PermissionContext, PermissionResult } from '../types/index.js';
+export interface PermissionCheckerOptions {
+    /** Enable permission inheritance */
+    enableInheritance?: boolean;
+    /** Default permissions for items without explicit permissions */
+    defaultPermissions?: PermissionConfig;
+    /** Available roles in the system */
+    availableRoles?: string[];
+}
+export declare class PermissionChecker {
+    private options;
+    private defaultPermissions;
+    private availableRoles;
+    constructor(options?: PermissionCheckerOptions);
+    /**
+     * Check if user has permission for action
+     */
+    check(permissions: PermissionConfig | undefined, action: string, user?: User, context?: PermissionContext): Promise<boolean>;
+    /**
+     * Check permissions with detailed result
+     */
+    checkDetailed(permissions: PermissionConfig | undefined, action: string, user?: User, context?: PermissionContext): Promise<PermissionResult>;
+    /**
+     * Evaluate a permission rule
+     */
+    private evaluateRule;
+    /**
+     * Evaluate conditional permission rule
+     */
+    private evaluateConditionalRule;
+    /**
+     * Evaluate string condition
+     */
+    private evaluateStringCondition;
+    /**
+     * Check if rule is conditional
+     */
+    private isConditionalRule;
+    /**
+     * Validate permission configuration
+     */
+    validatePermissionConfig(config: PermissionConfig): string[];
+    /**
+     * Validate permission rule
+     */
+    private validateRule;
+    /**
+     * Get effective permissions for user
+     */
+    getEffectivePermissions(permissions: PermissionConfig | undefined, user?: User, context?: PermissionContext): Promise<Record<string, boolean>>;
+}
+//# sourceMappingURL=permission-checker.d.ts.map

package/dist/structure/utils/permission-checker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"permission-checker.d.ts","sourceRoot":"","sources":["../../../src/structure/utils/permission-checker.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAA;AAC/C,OAAO,KAAK,EACV,gBAAgB,EAIhB,iBAAiB,EACjB,gBAAgB,EACjB,MAAM,mBAAmB,CAAA;AAG1B,MAAM,WAAW,wBAAwB;IACvC,oCAAoC;IACpC,iBAAiB,CAAC,EAAE,OAAO,CAAA;IAE3B,iEAAiE;IACjE,kBAAkB,CAAC,EAAE,gBAAgB,CAAA;IAErC,oCAAoC;IACpC,cAAc,CAAC,EAAE,MAAM,EAAE,CAAA;CAC1B;AAED,qBAAa,iBAAiB;IAIhB,OAAO,CAAC,OAAO;IAH3B,OAAO,CAAC,kBAAkB,CAAkB;IAC5C,OAAO,CAAC,cAAc,CAAa;gBAEf,OAAO,GAAE,wBAA6B;IAa1D;;OAEG;IACG,KAAK,CACT,WAAW,EAAE,gBAAgB,GAAG,SAAS,EACzC,MAAM,EAAE,MAAM,EACd,IAAI,CAAC,EAAE,IAAI,EACX,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,OAAO,CAAC;IAiBnB;;OAEG;IACG,aAAa,CACjB,WAAW,EAAE,gBAAgB,GAAG,SAAS,EACzC,MAAM,EAAE,MAAM,EACd,IAAI,CAAC,EAAE,IAAI,EACX,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,gBAAgB,CAAC;IAmB5B;;OAEG;YACW,YAAY;IA4E1B;;OAEG;YACW,uBAAuB;IAiErC;;OAEG;IACH,OAAO,CAAC,uBAAuB;IA6B/B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAIzB;;OAEG;IACH,wBAAwB,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,EAAE;IAW5D;;OAEG;IACH,OAAO,CAAC,YAAY;IAuDpB;;OAEG;IACG,uBAAuB,CAC3B,WAAW,EAAE,gBAAgB,GAAG,SAAS,EACzC,IAAI,CAAC,EAAE,IAAI,EACX,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAkBpC"}

package/dist/structure/utils/permission-checker.js

@@ -0,0 +1,286 @@
+/**
+ * Permission Checker
+ * Utility for checking permissions against structure items
+ */
+import { PermissionError, ErrorRecovery } from '../errors/index.js';
+export class PermissionChecker {
+    options;
+    defaultPermissions;
+    availableRoles;
+    constructor(options = {}) {
+        this.options = options;
+        this.defaultPermissions = options.defaultPermissions || {
+            read: ['viewer', 'editor', 'admin'],
+            create: ['editor', 'admin'],
+            update: ['editor', 'admin'],
+            delete: ['admin']
+        };
+        this.availableRoles = new Set(options.availableRoles || [
+            'viewer', 'editor', 'admin'
+        ]);
+    }
+    /**
+     * Check if user has permission for action
+     */
+    async check(permissions, action, user, context) {
+        return ErrorRecovery.safeExecute(async () => {
+            const result = await this.checkDetailed(permissions, action, user, context);
+            return result.allowed;
+        }, false, // Fallback to deny access on error
+        (error) => {
+            console.warn('Permission check failed:', {
+                action,
+                user: user?.id,
+                error: error.message
+            });
+        });
+    }
+    /**
+     * Check permissions with detailed result
+     */
+    async checkDetailed(permissions, action, user, context) {
+        // Use default permissions if none specified
+        const effectivePermissions = permissions || this.defaultPermissions;
+        // Get rule for action
+        const rule = effectivePermissions[action] ||
+            effectivePermissions.custom?.[action];
+        if (!rule) {
+            return {
+                allowed: false,
+                reason: `No permission rule defined for action: ${action}`,
+                rule
+            };
+        }
+        return await this.evaluateRule(rule, user, context);
+    }
+    /**
+     * Evaluate a permission rule
+     */
+    async evaluateRule(rule, user, context) {
+        // Boolean rule
+        if (typeof rule === 'boolean') {
+            return {
+                allowed: rule,
+                reason: rule ? 'Explicitly allowed' : 'Explicitly denied',
+                rule
+            };
+        }
+        // No user for role-based checks
+        if (!user && (typeof rule === 'string' || Array.isArray(rule))) {
+            return {
+                allowed: false,
+                reason: 'Authentication required',
+                rule
+            };
+        }
+        // Single role string
+        if (typeof rule === 'string') {
+            const allowed = user?.role === rule;
+            return {
+                allowed,
+                reason: allowed ? `User has required role: ${rule}` : `User lacks required role: ${rule}`,
+                rule
+            };
+        }
+        // Multiple roles array
+        if (Array.isArray(rule)) {
+            const allowed = user?.role ? rule.includes(user.role) : false;
+            return {
+                allowed,
+                reason: allowed
+                    ? `User role ${user?.role} is in allowed roles: [${rule.join(', ')}]`
+                    : `User role ${user?.role || 'none'} not in allowed roles: [${rule.join(', ')}]`,
+                rule
+            };
+        }
+        // Function rule
+        if (typeof rule === 'function') {
+            try {
+                const result = rule(user, context);
+                const allowed = result instanceof Promise ? await result : result;
+                return {
+                    allowed,
+                    reason: allowed ? 'Custom function allowed access' : 'Custom function denied access',
+                    rule
+                };
+            }
+            catch (error) {
+                throw new PermissionError('Custom permission function failed', { rule, user: user?.id }, error);
+            }
+        }
+        // Conditional rule
+        if (this.isConditionalRule(rule)) {
+            return await this.evaluateConditionalRule(rule, user, context);
+        }
+        return {
+            allowed: false,
+            reason: 'Invalid permission rule',
+            rule
+        };
+    }
+    /**
+     * Evaluate conditional permission rule
+     */
+    async evaluateConditionalRule(rule, user, context) {
+        let conditionResult;
+        try {
+            if (typeof rule.condition === 'string') {
+                // String condition - could be evaluated as expression
+                conditionResult = this.evaluateStringCondition(rule.condition, user, context);
+            }
+            else if (typeof rule.condition === 'function') {
+                // Function condition
+                conditionResult = rule.condition(user, context);
+            }
+            else {
+                return {
+                    allowed: false,
+                    reason: 'Invalid condition type',
+                    rule
+                };
+            }
+        }
+        catch (error) {
+            throw new PermissionError('Permission condition evaluation failed', { rule, user: user?.id }, error);
+        }
+        if (conditionResult) {
+            // Condition is true - check allow rules
+            if (rule.allow) {
+                return await this.evaluateRule(rule.allow, user, context);
+            }
+            // No allow rule but condition is true - default allow
+            return {
+                allowed: true,
+                reason: 'Condition met and no explicit allow rule',
+                rule
+            };
+        }
+        else {
+            // Condition is false - check deny rules or fallback
+            if (rule.deny) {
+                const denyResult = await this.evaluateRule(rule.deny, user, context);
+                return {
+                    allowed: !denyResult.allowed,
+                    reason: denyResult.allowed ? 'Explicitly denied by condition' : 'Not in deny list',
+                    rule
+                };
+            }
+            // Check fallback rule
+            if (rule.fallback) {
+                return await this.evaluateRule(rule.fallback, user, context);
+            }
+            // No deny rule, no fallback - default deny
+            return {
+                allowed: false,
+                reason: 'Condition not met and no fallback rule',
+                rule
+            };
+        }
+    }
+    /**
+     * Evaluate string condition
+     */
+    evaluateStringCondition(condition, user, context) {
+        // Simple string conditions
+        switch (condition) {
+            case 'isAuthenticated':
+                return !!user;
+            case 'isAdmin':
+                return user?.role === 'admin';
+            case 'isEditor':
+                return user?.role === 'editor' || user?.role === 'admin';
+            case 'isOwner':
+                return context?.resource?.author === user?.id;
+            case 'isActive':
+                return user?.isActive !== false;
+            default:
+                // For more complex conditions, could implement expression parser
+                console.warn(`Unknown string condition: ${condition}`);
+                return false;
+        }
+    }
+    /**
+     * Check if rule is conditional
+     */
+    isConditionalRule(rule) {
+        return rule && typeof rule === 'object' && 'condition' in rule;
+    }
+    /**
+     * Validate permission configuration
+     */
+    validatePermissionConfig(config) {
+        const errors = [];
+        for (const [action, rule] of Object.entries(config)) {
+            const ruleErrors = this.validateRule(rule, `${action}`);
+            errors.push(...ruleErrors);
+        }
+        return errors;
+    }
+    /**
+     * Validate permission rule
+     */
+    validateRule(rule, path) {
+        const errors = [];
+        if (typeof rule === 'boolean') {
+            // Boolean rules are always valid
+            return errors;
+        }
+        if (typeof rule === 'string') {
+            if (!this.availableRoles.has(rule)) {
+                errors.push(`${path}: Unknown role "${rule}"`);
+            }
+            return errors;
+        }
+        if (Array.isArray(rule)) {
+            rule.forEach((role, index) => {
+                if (typeof role !== 'string') {
+                    errors.push(`${path}[${index}]: Role must be string`);
+                }
+                else if (!this.availableRoles.has(role)) {
+                    errors.push(`${path}[${index}]: Unknown role "${role}"`);
+                }
+            });
+            return errors;
+        }
+        if (typeof rule === 'function') {
+            // Functions are hard to validate statically
+            return errors;
+        }
+        if (this.isConditionalRule(rule)) {
+            if (!rule.condition) {
+                errors.push(`${path}: Conditional rule missing condition`);
+            }
+            if (rule.allow) {
+                errors.push(...this.validateRule(rule.allow, `${path}.allow`));
+            }
+            if (rule.deny) {
+                errors.push(...this.validateRule(rule.deny, `${path}.deny`));
+            }
+            if (rule.fallback) {
+                errors.push(...this.validateRule(rule.fallback, `${path}.fallback`));
+            }
+            return errors;
+        }
+        errors.push(`${path}: Invalid permission rule type`);
+        return errors;
+    }
+    /**
+     * Get effective permissions for user
+     */
+    async getEffectivePermissions(permissions, user, context) {
+        const effectivePermissions = permissions || this.defaultPermissions;
+        const result = {};
+        // Check standard actions
+        for (const action of ['read', 'create', 'update', 'delete']) {
+            result[action] = await this.check(effectivePermissions, action, user, context);
+        }
+        // Check custom actions
+        if (effectivePermissions.custom) {
+            for (const action of Object.keys(effectivePermissions.custom)) {
+                result[action] = await this.check(effectivePermissions, action, user, context);
+            }
+        }
+        return result;
+    }
+}
+//# sourceMappingURL=permission-checker.js.map

package/dist/structure/utils/permission-checker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"permission-checker.js","sourceRoot":"","sources":["../../../src/structure/utils/permission-checker.ts"],"names":[],"mappings":"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"}

package/dist/structure/utils/query-builder.d.ts

@@ -0,0 +1,82 @@
+/**
+ * Query Builder
+ * Builds and optimizes MongoDB-style queries for structure filtering
+ */
+import type { QueryFilter, ResolvedQuery, QueryContext, QueryComplexity, DocumentListItem } from '../types/index.js';
+export interface QueryBuilderOptions {
+    /** Enable query optimization */
+    optimize?: boolean;
+    /** Enable query caching */
+    cache?: boolean;
+    /** Cache TTL in milliseconds */
+    cacheTTL?: number;
+    /** Maximum query complexity allowed */
+    maxComplexity?: number;
+    /** Enable query logging */
+    enableLogging?: boolean;
+}
+export declare class QueryBuilder {
+    private options;
+    private cache;
+    private complexityWeights;
+    constructor(options?: QueryBuilderOptions);
+    /**
+     * Build query from structure item
+     */
+    buildQuery(item: DocumentListItem, context?: QueryContext): Promise<ResolvedQuery>;
+    /**
+     * Calculate query complexity
+     */
+    calculateComplexity(filter: QueryFilter): QueryComplexity;
+    /**
+     * Optimize query for better performance
+     */
+    optimizeQuery(query: ResolvedQuery): ResolvedQuery;
+    /**
+     * Convert ordering array to sort object
+     */
+    private convertOrderingToSort;
+    /**
+     * Optimize filter object
+     */
+    optimizeFilter(filter: QueryFilter): QueryFilter;
+    /**
+     * Merge multiple filters
+     */
+    private mergeFilters;
+    /**
+     * Optimize $and conditions
+     */
+    private optimizeAndConditions;
+    /**
+     * Optimize $or conditions
+     */
+    private optimizeOrConditions;
+    /**
+     * Estimate query cost
+     */
+    private estimateQueryCost;
+    /**
+     * Generate cache key
+     */
+    private generateCacheKey;
+    /**
+     * Clear query cache
+     */
+    clearCache(): void;
+    /**
+     * Get cache statistics
+     */
+    getCacheStats(): {
+        size: number;
+        keys: string[];
+    };
+    /**
+     * Validate filter structure
+     */
+    validateFilter(filter: QueryFilter): {
+        valid: boolean;
+        errors: string[];
+    };
+}
+//# sourceMappingURL=query-builder.d.ts.map

package/dist/structure/utils/query-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-builder.d.ts","sourceRoot":"","sources":["../../../src/structure/utils/query-builder.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EACV,WAAW,EACX,aAAa,EACb,YAAY,EACZ,eAAe,EACf,gBAAgB,EAEjB,MAAM,mBAAmB,CAAA;AAI1B,MAAM,WAAW,mBAAmB;IAClC,gCAAgC;IAChC,QAAQ,CAAC,EAAE,OAAO,CAAA;IAElB,2BAA2B;IAC3B,KAAK,CAAC,EAAE,OAAO,CAAA;IAEf,gCAAgC;IAChC,QAAQ,CAAC,EAAE,MAAM,CAAA;IAEjB,uCAAuC;IACvC,aAAa,CAAC,EAAE,MAAM,CAAA;IAEtB,2BAA2B;IAC3B,aAAa,CAAC,EAAE,OAAO,CAAA;CACxB;AAED,qBAAa,YAAY;IAkCX,OAAO,CAAC,OAAO;IAjC3B,OAAO,CAAC,KAAK,CAAmC;IAChD,OAAO,CAAC,iBAAiB,CA8BxB;gBAEmB,OAAO,GAAE,mBAAwB;IAWrD;;OAEG;IACG,UAAU,CACd,IAAI,EAAE,gBAAgB,EACtB,OAAO,CAAC,EAAE,YAAY,GACrB,OAAO,CAAC,aAAa,CAAC;IAyFzB;;OAEG;IACH,mBAAmB,CAAC,MAAM,EAAE,WAAW,GAAG,eAAe;IA6EzD;;OAEG;IACH,aAAa,CAAC,KAAK,EAAE,aAAa,GAAG,aAAa;IAmBlD;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAQ7B;;OAEG;IACH,cAAc,CAAC,MAAM,EAAE,WAAW,GAAG,WAAW;IAgEhD;;OAEG;IACH,OAAO,CAAC,YAAY;IA2CpB;;OAEG;IACH,OAAO,CAAC,qBAAqB;IA8C7B;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAkB5B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAOzB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAkBxB;;OAEG;IACH,UAAU,IAAI,IAAI;IAIlB;;OAEG;IACH,aAAa,IAAI;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,EAAE,CAAA;KAAE;IAOjD;;OAEG;IACH,cAAc,CAAC,MAAM,EAAE,WAAW,GAAG;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,CAAA;KAAE;CAyD1E"}