@nahisaho/yata-scale 1.8.5

package/dist/query/DistributedExecutor.js.map

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

package/dist/query/QueryCoordinator.d.ts

@@ -0,0 +1,98 @@
+/**
+ * @nahisaho/yata-scale - Query Coordinator
+ *
+ * High-level query coordination and caching
+ */
+import { type Result } from 'neverthrow';
+import type { GraphQuery, QueryResult, QueryOptions, Entity } from '../types.js';
+import { QueryError } from '../errors.js';
+import { QueryPlanner } from './QueryPlanner.js';
+import { DistributedExecutor, type ShardQueryFn } from './DistributedExecutor.js';
+/**
+ * Query coordinator for managing query lifecycle
+ */
+export declare class QueryCoordinator {
+    private readonly planner;
+    private readonly executor;
+    private readonly cache;
+    private readonly maxCacheSize;
+    private readonly defaultCacheTtlMs;
+    constructor(parallelism?: number, maxCacheSize?: number, defaultCacheTtlMs?: number);
+    /**
+     * Execute a query
+     */
+    query(graphQuery: GraphQuery, shards: string[], queryFn: ShardQueryFn, options?: QueryOptions): Promise<Result<QueryResult, QueryError>>;
+    /**
+     * Validate query
+     */
+    private validateQuery;
+    /**
+     * Get cache key for query
+     */
+    private getCacheKey;
+    /**
+     * Get from cache
+     */
+    private getFromCache;
+    /**
+     * Add to cache
+     */
+    private addToCache;
+    /**
+     * Evict oldest cache entry
+     */
+    private evictOldest;
+    /**
+     * Invalidate cache entries
+     */
+    invalidateCache(pattern?: string): void;
+    /**
+     * Find entities by type
+     */
+    findByType(entityType: string, shards: string[], queryFn: ShardQueryFn, options?: {
+        limit?: number;
+        offset?: number;
+    }): Promise<Result<Entity[], QueryError>>;
+    /**
+     * Find entity by ID
+     */
+    findById(entityId: string, shards: string[], queryFn: ShardQueryFn): Promise<Result<Entity | undefined, QueryError>>;
+    /**
+     * Find related entities
+     */
+    findRelated(entityId: string, relationshipType: string, shards: string[], queryFn: ShardQueryFn, options?: {
+        depth?: number;
+        limit?: number;
+    }): Promise<Result<Entity[], QueryError>>;
+    /**
+     * Search entities
+     */
+    search(searchQuery: string, shards: string[], queryFn: ShardQueryFn, options?: {
+        entityTypes?: string[];
+        limit?: number;
+    }): Promise<Result<Entity[], QueryError>>;
+    /**
+     * Explain query plan
+     */
+    explain(query: GraphQuery): string;
+    /**
+     * Get query planner
+     */
+    getPlanner(): QueryPlanner;
+    /**
+     * Get distributed executor
+     */
+    getExecutor(): DistributedExecutor;
+    /**
+     * Get cache statistics
+     */
+    getCacheStats(): {
+        size: number;
+        maxSize: number;
+    };
+    /**
+     * Shutdown coordinator
+     */
+    shutdown(): Promise<void>;
+}
+//# sourceMappingURL=QueryCoordinator.d.ts.map

package/dist/query/QueryCoordinator.d.ts.map

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

package/dist/query/QueryCoordinator.js

@@ -0,0 +1,246 @@
+/**
+ * @nahisaho/yata-scale - Query Coordinator
+ *
+ * High-level query coordination and caching
+ */
+import { ok, err } from 'neverthrow';
+import { InvalidQueryError } from '../errors.js';
+import { QueryPlanner } from './QueryPlanner.js';
+import { DistributedExecutor } from './DistributedExecutor.js';
+/**
+ * Query coordinator for managing query lifecycle
+ */
+export class QueryCoordinator {
+    planner;
+    executor;
+    cache = new Map();
+    maxCacheSize;
+    defaultCacheTtlMs;
+    constructor(parallelism = 4, maxCacheSize = 1000, defaultCacheTtlMs = 60000) {
+        this.planner = new QueryPlanner();
+        this.executor = new DistributedExecutor(parallelism);
+        this.maxCacheSize = maxCacheSize;
+        this.defaultCacheTtlMs = defaultCacheTtlMs;
+    }
+    /**
+     * Execute a query
+     */
+    async query(graphQuery, shards, queryFn, options) {
+        // Validate query
+        const validationResult = this.validateQuery(graphQuery);
+        if (validationResult.isErr()) {
+            return err(validationResult.error);
+        }
+        // Check cache
+        if (options?.useCache !== false) {
+            const cacheKey = this.getCacheKey(graphQuery);
+            const cached = this.getFromCache(cacheKey);
+            if (cached) {
+                return ok(cached);
+            }
+        }
+        // Plan query
+        const plan = this.planner.plan(graphQuery);
+        // Optimize plan
+        const optimizedPlan = this.planner.optimize(plan);
+        // Execute query
+        const result = await this.executor.execute(optimizedPlan, shards, queryFn);
+        if (result.isOk() && options?.useCache !== false) {
+            const cacheKey = this.getCacheKey(graphQuery);
+            this.addToCache(cacheKey, result.value, options?.cacheTtlMs);
+        }
+        return result;
+    }
+    /**
+     * Validate query
+     */
+    validateQuery(query) {
+        // Must have at least one constraint
+        if ((!query.entityTypes || query.entityTypes.length === 0) &&
+            (!query.startEntityIds || query.startEntityIds.length === 0) &&
+            (!query.filters || query.filters.length === 0)) {
+            return err(new InvalidQueryError('Query must have at least one constraint (entityTypes, startEntityIds, or filters)'));
+        }
+        // Validate limit
+        if (query.limit !== undefined && query.limit <= 0) {
+            return err(new InvalidQueryError('Limit must be positive'));
+        }
+        // Validate offset
+        if (query.offset !== undefined && query.offset < 0) {
+            return err(new InvalidQueryError('Offset cannot be negative'));
+        }
+        // Validate traversal depth
+        if (query.traversal?.maxDepth !== undefined && query.traversal.maxDepth <= 0) {
+            return err(new InvalidQueryError('Traversal depth must be positive'));
+        }
+        return ok(undefined);
+    }
+    /**
+     * Get cache key for query
+     */
+    getCacheKey(query) {
+        return JSON.stringify({
+            entityTypes: query.entityTypes,
+            startEntityIds: query.startEntityIds,
+            filters: query.filters,
+            traversal: query.traversal,
+            orderBy: query.orderBy,
+            orderDirection: query.orderDirection,
+            limit: query.limit,
+            offset: query.offset,
+        });
+    }
+    /**
+     * Get from cache
+     */
+    getFromCache(key) {
+        const entry = this.cache.get(key);
+        if (!entry) {
+            return undefined;
+        }
+        // Check if expired
+        const age = Date.now() - entry.timestamp.getTime();
+        if (age > entry.ttlMs) {
+            this.cache.delete(key);
+            return undefined;
+        }
+        return entry.result;
+    }
+    /**
+     * Add to cache
+     */
+    addToCache(key, result, ttlMs) {
+        // Evict if at capacity
+        if (this.cache.size >= this.maxCacheSize) {
+            this.evictOldest();
+        }
+        this.cache.set(key, {
+            result,
+            timestamp: new Date(),
+            ttlMs: ttlMs ?? this.defaultCacheTtlMs,
+        });
+    }
+    /**
+     * Evict oldest cache entry
+     */
+    evictOldest() {
+        let oldestKey = null;
+        let oldestTime = Infinity;
+        for (const [key, entry] of this.cache) {
+            if (entry.timestamp.getTime() < oldestTime) {
+                oldestTime = entry.timestamp.getTime();
+                oldestKey = key;
+            }
+        }
+        if (oldestKey) {
+            this.cache.delete(oldestKey);
+        }
+    }
+    /**
+     * Invalidate cache entries
+     */
+    invalidateCache(pattern) {
+        if (!pattern) {
+            this.cache.clear();
+            return;
+        }
+        for (const key of this.cache.keys()) {
+            if (key.includes(pattern)) {
+                this.cache.delete(key);
+            }
+        }
+    }
+    /**
+     * Find entities by type
+     */
+    async findByType(entityType, shards, queryFn, options) {
+        const query = {
+            entityTypes: [entityType],
+            limit: options?.limit,
+            offset: options?.offset,
+        };
+        const result = await this.query(query, shards, queryFn);
+        return result.map((r) => r.entities);
+    }
+    /**
+     * Find entity by ID
+     */
+    async findById(entityId, shards, queryFn) {
+        const query = {
+            startEntityIds: [entityId],
+            limit: 1,
+        };
+        const result = await this.query(query, shards, queryFn);
+        return result.map((r) => r.entities[0]);
+    }
+    /**
+     * Find related entities
+     */
+    async findRelated(entityId, relationshipType, shards, queryFn, options) {
+        const query = {
+            startEntityIds: [entityId],
+            traversal: {
+                direction: 'outgoing',
+                relationshipTypes: [relationshipType],
+                maxDepth: options?.depth ?? 1,
+            },
+            limit: options?.limit,
+        };
+        const result = await this.query(query, shards, queryFn);
+        return result.map((r) => r.entities.filter((e) => e.id !== entityId));
+    }
+    /**
+     * Search entities
+     */
+    async search(searchQuery, shards, queryFn, options) {
+        const query = {
+            entityTypes: options?.entityTypes,
+            filters: [
+                {
+                    field: 'name',
+                    operator: 'contains',
+                    value: searchQuery,
+                },
+            ],
+            limit: options?.limit ?? 100,
+        };
+        const result = await this.query(query, shards, queryFn);
+        return result.map((r) => r.entities);
+    }
+    /**
+     * Explain query plan
+     */
+    explain(query) {
+        const plan = this.planner.plan(query);
+        return this.planner.explain(plan);
+    }
+    /**
+     * Get query planner
+     */
+    getPlanner() {
+        return this.planner;
+    }
+    /**
+     * Get distributed executor
+     */
+    getExecutor() {
+        return this.executor;
+    }
+    /**
+     * Get cache statistics
+     */
+    getCacheStats() {
+        return {
+            size: this.cache.size,
+            maxSize: this.maxCacheSize,
+        };
+    }
+    /**
+     * Shutdown coordinator
+     */
+    async shutdown() {
+        this.cache.clear();
+        await this.executor.shutdown();
+    }
+}
+//# sourceMappingURL=QueryCoordinator.js.map

package/dist/query/QueryCoordinator.js.map

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

package/dist/query/QueryPlanner.d.ts

@@ -0,0 +1,88 @@
+/**
+ * @nahisaho/yata-scale - Query Planner
+ *
+ * Generates optimized query execution plans
+ */
+import type { GraphQuery, QueryPlan, QueryFilter, IndexType } from '../types.js';
+/**
+ * Query plan step
+ */
+export interface PlanStep {
+    readonly id: string;
+    readonly type: 'scan' | 'index' | 'filter' | 'join' | 'sort' | 'limit' | 'aggregate';
+    readonly target?: string;
+    readonly index?: string;
+    readonly filter?: QueryFilter;
+    readonly dependencies: string[];
+    readonly estimatedCost: number;
+    readonly estimatedRows: number;
+}
+/**
+ * Index statistics for planning
+ */
+export interface IndexStatistics {
+    readonly name: string;
+    readonly type: IndexType;
+    readonly entryCount: number;
+    readonly selectivity: number;
+}
+/**
+ * Query planner for generating execution plans
+ */
+export declare class QueryPlanner {
+    private indexStats;
+    constructor();
+    /**
+     * Register index statistics
+     */
+    registerIndex(stats: IndexStatistics): void;
+    /**
+     * Unregister index
+     */
+    unregisterIndex(name: string): void;
+    /**
+     * Generate query plan
+     */
+    plan(query: GraphQuery): QueryPlan;
+    /**
+     * Plan access path (scan vs index)
+     */
+    private planAccessPath;
+    /**
+     * Find best index for query
+     */
+    private findBestIndex;
+    /**
+     * Plan filter step
+     */
+    private planFilterStep;
+    /**
+     * Plan traversal step
+     */
+    private planTraversalStep;
+    /**
+     * Plan sort step
+     */
+    private planSortStep;
+    /**
+     * Plan limit step
+     */
+    private planLimitStep;
+    /**
+     * Check if plan is parallelizable
+     */
+    private isParallelizable;
+    /**
+     * Determine target shards for query
+     */
+    private determineTargetShards;
+    /**
+     * Optimize plan
+     */
+    optimize(plan: QueryPlan): QueryPlan;
+    /**
+     * Explain plan in human-readable format
+     */
+    explain(plan: QueryPlan): string;
+}
+//# sourceMappingURL=QueryPlanner.d.ts.map

package/dist/query/QueryPlanner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"QueryPlanner.d.ts","sourceRoot":"","sources":["../../src/query/QueryPlanner.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACV,UAAU,EACV,SAAS,EACT,WAAW,EACX,SAAS,EACV,MAAM,aAAa,CAAC;AAErB;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,QAAQ,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,WAAW,CAAC;IACrF,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;IAC9B,QAAQ,CAAC,YAAY,EAAE,MAAM,EAAE,CAAC;IAChC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAChC;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED;;GAEG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,UAAU,CAA2C;;IAI7D;;OAEG;IACH,aAAa,CAAC,KAAK,EAAE,eAAe,GAAG,IAAI;IAI3C;;OAEG;IACH,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAInC;;OAEG;IACH,IAAI,CAAC,KAAK,EAAE,UAAU,GAAG,SAAS;IAsDlC;;OAEG;IACH,OAAO,CAAC,cAAc;IA2BtB;;OAEG;IACH,OAAO,CAAC,aAAa;IAsBrB;;OAEG;IACH,OAAO,CAAC,cAAc;IAetB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAkBzB;;OAEG;IACH,OAAO,CAAC,YAAY;IAepB;;OAEG;IACH,OAAO,CAAC,aAAa;IAcrB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAMxB;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAW7B;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,SAAS,GAAG,SAAS;IAapC;;OAEG;IACH,OAAO,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM;CA2BjC"}