@nahisaho/yata-scale 1.8.5

package/dist/YataScaleManager.d.ts

@@ -0,0 +1,75 @@
+/**
+ * @nahisaho/yata-scale - YataScale Manager
+ *
+ * High-level manager for the entire yata-scale system
+ */
+import { type Result } from 'neverthrow';
+import type { YataScaleConfig, YataScaleStats, Entity, Relationship, GraphQuery, QueryResult, BatchWriteResult } from './types.js';
+import { InitializationError, EntityNotFoundError, EntityAlreadyExistsError, QueryError } from './errors.js';
+import { ShardManager } from './ShardManager.js';
+import { CacheManager } from './CacheManager.js';
+import { IndexManager } from './IndexManager.js';
+import { QueryCoordinator } from './QueryCoordinator.js';
+import { SyncController } from './SyncController.js';
+/**
+ * YataScale manager - main entry point for the system
+ */
+export declare class YataScaleManager {
+    private config;
+    private shardManager;
+    private cache;
+    private indexManager;
+    private queryCoordinator;
+    private syncController;
+    private initialized;
+    /**
+     * Initialize the system
+     */
+    initialize(config: YataScaleConfig): Promise<Result<void, InitializationError>>;
+    private ensureInitialized;
+    /**
+     * Create an entity
+     */
+    createEntity(entity: Entity): Promise<Result<Entity, EntityAlreadyExistsError>>;
+    /**
+     * Get an entity by ID
+     */
+    getEntity(id: string): Promise<Result<Entity, EntityNotFoundError>>;
+    /**
+     * Update an entity
+     */
+    updateEntity(entity: Entity): Promise<Result<Entity, EntityNotFoundError>>;
+    /**
+     * Delete an entity
+     */
+    deleteEntity(id: string): Promise<Result<void, EntityNotFoundError>>;
+    /**
+     * Create a relationship
+     */
+    createRelationship(relationship: Relationship): Promise<Result<Relationship, Error>>;
+    /**
+     * Delete a relationship
+     */
+    deleteRelationship(id: string): Promise<Result<void, Error>>;
+    /**
+     * Execute a query
+     */
+    query(graphQuery: GraphQuery): Promise<Result<QueryResult, QueryError>>;
+    /**
+     * Batch write entities
+     */
+    batchWrite(entities: Entity[], relationships?: Relationship[]): Promise<BatchWriteResult>;
+    /**
+     * Get system statistics
+     */
+    getStats(): YataScaleStats;
+    getShardManager(): ShardManager;
+    getCacheManager(): CacheManager;
+    getIndexManager(): IndexManager;
+    getQueryCoordinator(): QueryCoordinator;
+    getSyncController(): SyncController;
+    shutdown(): Promise<void>;
+    isInitialized(): boolean;
+    getConfig(): YataScaleConfig | null;
+}
+//# sourceMappingURL=YataScaleManager.d.ts.map

package/dist/YataScaleManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"YataScaleManager.d.ts","sourceRoot":"","sources":["../src/YataScaleManager.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAW,KAAK,MAAM,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,KAAK,EACV,eAAe,EACf,cAAc,EACd,MAAM,EACN,YAAY,EACZ,UAAU,EACV,WAAW,EACX,gBAAgB,EACjB,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,mBAAmB,EAGnB,mBAAmB,EACnB,wBAAwB,EACxB,UAAU,EACX,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAErD;;GAEG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,MAAM,CAAgC;IAC9C,OAAO,CAAC,YAAY,CAA6B;IACjD,OAAO,CAAC,KAAK,CAA6B;IAC1C,OAAO,CAAC,YAAY,CAA6B;IACjD,OAAO,CAAC,gBAAgB,CAAiC;IACzD,OAAO,CAAC,cAAc,CAA+B;IACrD,OAAO,CAAC,WAAW,CAAS;IAE5B;;OAEG;IACG,UAAU,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,mBAAmB,CAAC,CAAC;IAqCrF,OAAO,CAAC,iBAAiB;IAMzB;;OAEG;IACG,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,wBAAwB,CAAC,CAAC;IAerF;;OAEG;IACG,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC;IAiBzE;;OAEG;IACG,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC;IAgBhF;;OAEG;IACG,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,mBAAmB,CAAC,CAAC;IAe1E;;OAEG;IACG,kBAAkB,CAAC,YAAY,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,YAAY,EAAE,KAAK,CAAC,CAAC;IAU1F;;OAEG;IACG,kBAAkB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IAUlE;;OAEG;IACG,KAAK,CAAC,UAAU,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC;IAiC7E;;OAEG;IACG,UAAU,CACd,QAAQ,EAAE,MAAM,EAAE,EAClB,aAAa,GAAE,YAAY,EAAO,GACjC,OAAO,CAAC,gBAAgB,CAAC;IAqC5B;;OAEG;IACH,QAAQ,IAAI,cAAc;IAsB1B,eAAe,IAAI,YAAY;IAK/B,eAAe,IAAI,YAAY;IAK/B,eAAe,IAAI,YAAY;IAK/B,mBAAmB,IAAI,gBAAgB;IAKvC,iBAAiB,IAAI,cAAc;IAK7B,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAiB/B,aAAa,IAAI,OAAO;IAIxB,SAAS,IAAI,eAAe,GAAG,IAAI;CAGpC"}

package/dist/YataScaleManager.js

@@ -0,0 +1,265 @@
+/**
+ * @nahisaho/yata-scale - YataScale Manager
+ *
+ * High-level manager for the entire yata-scale system
+ */
+import { ok, err } from 'neverthrow';
+import { InitializationError, AlreadyInitializedError, NotInitializedError, EntityNotFoundError, EntityAlreadyExistsError, } from './errors.js';
+import { ShardManager } from './ShardManager.js';
+import { CacheManager } from './CacheManager.js';
+import { IndexManager } from './IndexManager.js';
+import { QueryCoordinator } from './QueryCoordinator.js';
+import { SyncController } from './SyncController.js';
+/**
+ * YataScale manager - main entry point for the system
+ */
+export class YataScaleManager {
+    config = null;
+    shardManager = null;
+    cache = null;
+    indexManager = null;
+    queryCoordinator = null;
+    syncController = null;
+    initialized = false;
+    /**
+     * Initialize the system
+     */
+    async initialize(config) {
+        if (this.initialized) {
+            return err(new AlreadyInitializedError());
+        }
+        try {
+            this.config = config;
+            this.shardManager = new ShardManager();
+            this.cache = new CacheManager(config.cache);
+            this.indexManager = new IndexManager();
+            this.queryCoordinator = new QueryCoordinator(config.query.maxConcurrency, 60000, config.query.defaultTimeout);
+            const nodeId = config.nodeId ?? `node_${Date.now()}`;
+            this.syncController = new SyncController(nodeId);
+            // Create shards
+            for (let i = 0; i < config.shards.count; i++) {
+                const shardId = `shard_${i}`;
+                this.shardManager.createShard(shardId, config.shards);
+            }
+            this.initialized = true;
+            return ok(undefined);
+        }
+        catch (error) {
+            return err(new InitializationError(`Failed to initialize: ${error instanceof Error ? error.message : String(error)}`));
+        }
+    }
+    ensureInitialized() {
+        if (!this.initialized) {
+            throw new NotInitializedError();
+        }
+    }
+    /**
+     * Create an entity
+     */
+    async createEntity(entity) {
+        this.ensureInitialized();
+        const cached = await this.cache.getEntity(entity.id);
+        if (cached.isOk()) {
+            return err(new EntityAlreadyExistsError(entity.id));
+        }
+        await this.cache.setEntity(entity);
+        this.indexManager.indexEntity(entity);
+        this.syncController.recordCreate(entity);
+        return ok(entity);
+    }
+    /**
+     * Get an entity by ID
+     */
+    async getEntity(id) {
+        this.ensureInitialized();
+        const cached = await this.cache.getEntity(id);
+        if (cached.isOk()) {
+            return ok(cached.value);
+        }
+        const indexed = this.indexManager.getEntity(id);
+        if (indexed) {
+            await this.cache.setEntity(indexed);
+            return ok(indexed);
+        }
+        return err(new EntityNotFoundError(id));
+    }
+    /**
+     * Update an entity
+     */
+    async updateEntity(entity) {
+        this.ensureInitialized();
+        const existing = await this.getEntity(entity.id);
+        if (existing.isErr()) {
+            return err(existing.error);
+        }
+        await this.cache.setEntity(entity);
+        this.indexManager.removeEntity(entity.id);
+        this.indexManager.indexEntity(entity);
+        this.syncController.recordUpdate(entity, existing.value);
+        return ok(entity);
+    }
+    /**
+     * Delete an entity
+     */
+    async deleteEntity(id) {
+        this.ensureInitialized();
+        const existing = await this.getEntity(id);
+        if (existing.isErr()) {
+            return err(existing.error);
+        }
+        await this.cache.deleteEntity(id);
+        this.indexManager.removeEntity(id);
+        this.syncController.recordDelete(id, existing.value);
+        return ok(undefined);
+    }
+    /**
+     * Create a relationship
+     */
+    async createRelationship(relationship) {
+        this.ensureInitialized();
+        await this.cache.setRelationship(relationship);
+        this.indexManager.indexRelationship(relationship);
+        this.syncController.recordRelationshipCreate(relationship);
+        return ok(relationship);
+    }
+    /**
+     * Delete a relationship
+     */
+    async deleteRelationship(id) {
+        this.ensureInitialized();
+        await this.cache.deleteRelationship(id);
+        this.indexManager.removeRelationship(id);
+        this.syncController.recordRelationshipDelete(id);
+        return ok(undefined);
+    }
+    /**
+     * Execute a query
+     */
+    async query(graphQuery) {
+        this.ensureInitialized();
+        const shards = this.shardManager.getAllShards();
+        const queryFn = async (_shardId, query) => {
+            const entities = [];
+            const relationships = [];
+            if (query.startEntityIds) {
+                for (const id of query.startEntityIds) {
+                    const entity = this.indexManager.getEntity(id);
+                    if (entity) {
+                        entities.push(entity);
+                    }
+                }
+            }
+            if (query.entityIds) {
+                for (const id of query.entityIds) {
+                    const entity = this.indexManager.getEntity(id);
+                    if (entity) {
+                        entities.push(entity);
+                    }
+                }
+            }
+            return { entities, relationships };
+        };
+        return await this.queryCoordinator.query(graphQuery, shards, queryFn);
+    }
+    /**
+     * Batch write entities
+     */
+    async batchWrite(entities, relationships = []) {
+        this.ensureInitialized();
+        const succeeded = [];
+        const failed = [];
+        const startTime = Date.now();
+        for (const entity of entities) {
+            const result = await this.createEntity(entity);
+            if (result.isOk()) {
+                succeeded.push(entity.id);
+            }
+            else {
+                const updateResult = await this.updateEntity(entity);
+                if (updateResult.isOk()) {
+                    succeeded.push(entity.id);
+                }
+                else {
+                    failed.push({ id: entity.id, error: updateResult.error.message });
+                }
+            }
+        }
+        for (const rel of relationships) {
+            const result = await this.createRelationship(rel);
+            if (result.isOk()) {
+                succeeded.push(rel.id);
+            }
+            else {
+                failed.push({ id: rel.id, error: result.error.message });
+            }
+        }
+        return {
+            succeeded,
+            failed,
+            totalTime: Date.now() - startTime,
+        };
+    }
+    /**
+     * Get system statistics
+     */
+    getStats() {
+        this.ensureInitialized();
+        const cacheStats = this.cache.getAllStats();
+        const indexStats = this.indexManager.getAllStats();
+        const syncStats = this.syncController.getStats();
+        const shardStats = this.shardManager.getStats();
+        return {
+            entityCount: this.indexManager.entityCount,
+            relationshipCount: this.indexManager.relationshipCount,
+            shardCount: shardStats.totalShards,
+            cacheStats: cacheStats.l1,
+            indexStats: indexStats[0],
+            syncStats: {
+                nodeId: syncStats.nodeId,
+                activeSessions: syncStats.activeSessions,
+                walSequence: syncStats.walSequence,
+            },
+        };
+    }
+    getShardManager() {
+        this.ensureInitialized();
+        return this.shardManager;
+    }
+    getCacheManager() {
+        this.ensureInitialized();
+        return this.cache;
+    }
+    getIndexManager() {
+        this.ensureInitialized();
+        return this.indexManager;
+    }
+    getQueryCoordinator() {
+        this.ensureInitialized();
+        return this.queryCoordinator;
+    }
+    getSyncController() {
+        this.ensureInitialized();
+        return this.syncController;
+    }
+    async shutdown() {
+        if (!this.initialized) {
+            return;
+        }
+        await this.cache?.close();
+        await this.queryCoordinator?.shutdown();
+        this.initialized = false;
+        this.config = null;
+        this.shardManager = null;
+        this.cache = null;
+        this.indexManager = null;
+        this.queryCoordinator = null;
+        this.syncController = null;
+    }
+    isInitialized() {
+        return this.initialized;
+    }
+    getConfig() {
+        return this.config;
+    }
+}
+//# sourceMappingURL=YataScaleManager.js.map

package/dist/YataScaleManager.js.map

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

package/dist/cache/CacheManager.d.ts

@@ -0,0 +1,116 @@
+/**
+ * @nahisaho/yata-scale - Cache Manager
+ *
+ * Coordinates multi-tier caching (L1/L2/L3)
+ */
+import { type Result } from 'neverthrow';
+import type { CacheConfig, CacheStats, Entity, Relationship } from '../types.js';
+import { CacheMissError } from '../errors.js';
+import { L1Cache } from './L1Cache.js';
+import { L2Cache } from './L2Cache.js';
+import { L3Cache } from './L3Cache.js';
+import { InvalidationManager } from './InvalidationManager.js';
+/**
+ * Cache manager for multi-tier caching
+ */
+export declare class CacheManager {
+    private readonly l1;
+    private readonly l2;
+    private readonly l3;
+    private readonly invalidation;
+    private readonly config;
+    constructor(config: CacheConfig);
+    /**
+     * Get entity with cache hierarchy
+     */
+    getEntity(id: string): Promise<Result<Entity, CacheMissError>>;
+    /**
+     * Set entity in cache
+     */
+    setEntity(entity: Entity): Promise<void>;
+    /**
+     * Delete entity from all tiers
+     */
+    deleteEntity(id: string): Promise<void>;
+    /**
+     * Get relationship with cache hierarchy
+     */
+    getRelationship(id: string): Promise<Result<Relationship, CacheMissError>>;
+    /**
+     * Set relationship in cache
+     */
+    setRelationship(relationship: Relationship): Promise<void>;
+    /**
+     * Delete relationship from all tiers
+     */
+    deleteRelationship(id: string): Promise<void>;
+    /**
+     * Get multiple entities
+     */
+    getEntities(ids: string[]): Promise<Map<string, Entity>>;
+    /**
+     * Set multiple entities
+     */
+    setEntities(entities: Entity[]): Promise<void>;
+    /**
+     * Handle invalidation event
+     */
+    private handleInvalidation;
+    /**
+     * Invalidate entity across all tiers
+     */
+    invalidateEntity(id: string): void;
+    /**
+     * Invalidate multiple entities
+     */
+    invalidateEntities(ids: string[]): void;
+    /**
+     * Flush invalidations
+     */
+    flushInvalidations(): void;
+    /**
+     * Prewarm cache with entities
+     */
+    prewarm(entities: Entity[]): Promise<void>;
+    /**
+     * Clear all caches
+     */
+    clear(): Promise<void>;
+    /**
+     * Perform tier demotion (move cold data down)
+     */
+    performDemotion(): Promise<number>;
+    /**
+     * Get statistics for all tiers
+     */
+    getAllStats(): {
+        l1: CacheStats;
+        l2: CacheStats;
+        l3: CacheStats;
+    };
+    /**
+     * Get combined statistics
+     */
+    getCombinedStats(): CacheStats;
+    /**
+     * Get L1 cache
+     */
+    getL1(): L1Cache;
+    /**
+     * Get L2 cache
+     */
+    getL2(): L2Cache;
+    /**
+     * Get L3 cache
+     */
+    getL3(): L3Cache;
+    /**
+     * Get invalidation manager
+     */
+    getInvalidationManager(): InvalidationManager;
+    /**
+     * Close the cache manager
+     */
+    close(): Promise<void>;
+}
+//# sourceMappingURL=CacheManager.d.ts.map

package/dist/cache/CacheManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CacheManager.d.ts","sourceRoot":"","sources":["../../src/cache/CacheManager.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAW,KAAK,MAAM,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AACjF,OAAO,EAAE,cAAc,EAAc,MAAM,cAAc,CAAC;AAC1D,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,mBAAmB,EAA0B,MAAM,0BAA0B,CAAC;AAEvF;;GAEG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAU;IAC7B,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAU;IAC7B,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAU;IAC7B,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAsB;IACnD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAc;gBAEzB,MAAM,EAAE,WAAW;IAa/B;;OAEG;IACG,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IA2BpE;;OAEG;IACG,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ9C;;OAEG;IACG,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAO7C;;OAEG;IACG,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,YAAY,EAAE,cAAc,CAAC,CAAC;IAyBhF;;OAEG;IACG,eAAe,CAAC,YAAY,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAKhE;;OAEG;IACG,kBAAkB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAOnD;;OAEG;IACG,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IA6C9D;;OAEG;IACG,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAKpD;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAW1B;;OAEG;IACH,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAIlC;;OAEG;IACH,kBAAkB,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,IAAI;IAIvC;;OAEG;IACH,kBAAkB,IAAI,IAAI;IAI1B;;OAEG;IACG,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAKhD;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAM5B;;OAEG;IACG,eAAe,IAAI,OAAO,CAAC,MAAM,CAAC;IAYxC;;OAEG;IACH,WAAW,IAAI;QAAE,EAAE,EAAE,UAAU,CAAC;QAAC,EAAE,EAAE,UAAU,CAAC;QAAC,EAAE,EAAE,UAAU,CAAA;KAAE;IAQjE;;OAEG;IACH,gBAAgB,IAAI,UAAU;IAoB9B;;OAEG;IACH,KAAK,IAAI,OAAO;IAIhB;;OAEG;IACH,KAAK,IAAI,OAAO;IAIhB;;OAEG;IACH,KAAK,IAAI,OAAO;IAIhB;;OAEG;IACH,sBAAsB,IAAI,mBAAmB;IAI7C;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAI7B"}