@ductape/sdk 0.1.7 → 0.1.8

package/dist/graph/graphs.service.js

@@ -1,2594 +0,0 @@
-"use strict";
-/**
- * Graph Service
- *
- * Main service class for graph database operations.
- * Provides a unified API for working with different graph databases
- * (Neo4j, Neptune, ArangoDB, Memgraph).
- *
- * Based on Ductape Graph API documentation.
- */
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.GraphService = void 0;
-const adapter_factory_1 = require("./adapters/adapter.factory");
-const transaction_manager_1 = require("./transactions/transaction-manager");
-const graph_error_1 = require("./utils/graph-error");
-const products_service_1 = __importDefault(require("../products/services/products.service"));
-const productsBuilder_types_1 = require("../types/productsBuilder.types");
-const cache_manager_1 = require("../cache/cache.manager");
-const processor_service_1 = __importDefault(require("../processor/services/processor.service"));
-const crypto_1 = require("crypto");
-const logs_service_1 = __importDefault(require("../logs/logs.service"));
-const logs_types_1 = require("../logs/logs.types");
-const processor_utils_1 = require("../processor/utils/processor.utils");
-const secrets_1 = require("../secrets");
-const sharedGraphRegistry = new Map();
-const sharedGraphConnectInFlight = new Map();
-function getSharedGraphKey(workspaceId, product, graph, env) {
-    return `${workspaceId}:${product}:${graph}:${env}`;
-}
-/** Log debounce: avoid duplicate connect logs across instances */
-const lastGraphConnectLogAt = new Map();
-const GRAPH_CONNECT_LOG_DEBOUNCE_MS = 15000;
-/**
- * Main graph database service
- */
-class GraphService {
-    constructor(config) {
-        /** Cache of adapters by connection key */
-        this.adapters = new Map();
-        /** Connection contexts */
-        this.connectionContexts = new Map();
-        /** Currently active connection context */
-        this.currentContext = null;
-        /** Transaction manager */
-        this.transactionManager = null;
-        /** Service configuration */
-        this.config = null;
-        /** Product builders cache */
-        this.productBuilders = new Map();
-        /** Local graph configurations */
-        this.localConfigs = new Map();
-        /** LogService instance for logging operations */
-        this.logService = null;
-        /** Current product ID for logging */
-        this.productId = '';
-        /** CacheManager for two-tier caching (Redis + remote) */
-        this.cacheManager = null;
-        /** Private keys cache for products (keyed by product tag) */
-        this.privateKeys = new Map();
-        // ==================== GRAPH ACTIONS ====================
-        /** Local cache of graph actions */
-        this.actions = new Map();
-        // ==================== UTILITY METHODS ====================
-        /** Maximum retry attempts for auto-reconnection */
-        this.maxReconnectRetries = 2;
-        /** Flag to track if reconnection is in progress */
-        this.reconnecting = false;
-        this.adapterFactory = new adapter_factory_1.GraphAdapterFactory();
-        if (config) {
-            this.config = config;
-            this._privateKey = config.private_key || '';
-            // Initialize CacheManager (Redis is optional - Tier 1 internal cache and Tier 3 remote cache always work)
-            this.cacheManager = new cache_manager_1.CacheManager({
-                workspace_id: config.workspace_id,
-                public_key: config.public_key,
-                user_id: config.user_id,
-                token: config.token,
-                env_type: config.env_type,
-                redis_client: config.redis_client, // Optional - Tier 2 cache
-            });
-        }
-    }
-    // ==================== CONFIGURATION ====================
-    /**
-     * Update service configuration
-     */
-    updateConfig(config) {
-        this.config = config;
-    }
-    /**
-     * Get service configuration
-     */
-    getConfig() {
-        return this.config;
-    }
-    // ==================== PRODUCT BUILDER MANAGEMENT ====================
-    /**
-     * Create a new ProductBuilder instance
-     */
-    createNewProductBuilder() {
-        if (!this.config) {
-            throw graph_error_1.GraphError.configurationError('GraphService not configured. Please provide config when initializing.');
-        }
-        return new products_service_1.default({
-            workspace_id: this.config.workspace_id,
-            public_key: this.config.public_key,
-            user_id: this.config.user_id,
-            token: this.config.token,
-            env_type: this.config.env_type,
-            access_key: this.config.access_key,
-        });
-    }
-    /**
-     * Get or create a ProductBuilder instance for the given product tag
-     */
-    async getProductBuilder(productTag) {
-        let builder = this.productBuilders.get(productTag);
-        if (!builder) {
-            builder = this.createNewProductBuilder();
-            await builder.initializeProductByTag(productTag);
-            this.productBuilders.set(productTag, builder);
-            // Update productId for logging
-            this.productId = builder.fetchProductId() || '';
-            // Cache private key for caching operations
-            const privateKey = builder.fetchPrivateKey();
-            if (privateKey) {
-                this.privateKeys.set(productTag, privateKey);
-            }
-        }
-        return builder;
-    }
-    /**
-     * Initialize logging service
-     */
-    initializeLogService() {
-        var _a;
-        if (!this.logService && this.config) {
-            this.logService = new logs_service_1.default({
-                product_id: this.productId,
-                workspace_id: this.config.workspace_id,
-                public_key: this.config.public_key,
-                user_id: this.config.user_id,
-                token: this.config.token,
-                env_type: this.config.env_type,
-                workspace_private_key: (_a = this._privateKey) !== null && _a !== void 0 ? _a : undefined,
-            });
-        }
-    }
-    /**
-     * Create a new ProcessorService instance for job scheduling
-     */
-    createNewProcessor() {
-        if (!this.config) {
-            throw graph_error_1.GraphError.configurationError('GraphService not configured. Please provide config when initializing.');
-        }
-        return new processor_service_1.default({
-            workspace_id: this.config.workspace_id,
-            public_key: this.config.public_key,
-            user_id: this.config.user_id,
-            token: this.config.token,
-            env_type: this.config.env_type,
-            private_key: this._privateKey,
-        });
-    }
-    // ==================== GRAPH REGISTRATION ====================
-    /**
-     * Register a new graph database
-     * As documented in getting-started.md
-     *
-     * @example
-     * ```ts
-     * await ductape.graph.create({
-     *   name: 'Social Graph',
-     *   tag: 'social-graph',
-     *   type: 'neo4j',
-     *   description: 'Stores user relationships',
-     *   envs: [
-     *     { slug: 'dev', connection_url: 'bolt://localhost:7687' },
-     *     { slug: 'prd', connection_url: 'bolt://neo4j-prod:7687' },
-     *   ],
-     * });
-     * ```
-     */
-    async create(graphConfig, productTag) {
-        var _a;
-        // Validate required fields
-        if (!graphConfig.name || !graphConfig.tag || !graphConfig.type || !((_a = graphConfig.envs) === null || _a === void 0 ? void 0 : _a.length)) {
-            throw graph_error_1.GraphError.validationError('Graph configuration requires name, tag, type, and at least one environment');
-        }
-        const exists = await this.fetchGraphByTag(productTag, graphConfig.tag);
-        if (exists) {
-            return;
-        }
-        // Validate graph type
-        if (!this.adapterFactory.isSupported(graphConfig.type)) {
-            throw graph_error_1.GraphError.validationError(`Unsupported graph type: ${graphConfig.type}. ` +
-                `Supported types: ${this.adapterFactory.getSupportedTypes().join(', ')}`);
-        }
-        // Process sensitive fields - store as secrets if not already secret references
-        const processedEnvs = [];
-        for (const env of graphConfig.envs) {
-            // Store all sensitive fields as secrets
-            const connectionUrl = productTag
-                ? await this.storeAsSecretIfNeeded(env.connection_url, productTag, graphConfig.tag, env.slug, 'url', `Graph connection URL for ${graphConfig.tag} in ${env.slug}`)
-                : env.connection_url;
-            const graphName = productTag
-                ? await this.storeAsSecretIfNeeded(env.graphName, productTag, graphConfig.tag, env.slug, 'graphName', `Graph name for ${graphConfig.tag} in ${env.slug}`)
-                : env.graphName;
-            const region = productTag
-                ? await this.storeAsSecretIfNeeded(env.region, productTag, graphConfig.tag, env.slug, 'region', `AWS region for ${graphConfig.tag} in ${env.slug}`)
-                : env.region;
-            const username = productTag
-                ? await this.storeAsSecretIfNeeded(env.username, productTag, graphConfig.tag, env.slug, 'username', `Username for ${graphConfig.tag} in ${env.slug}`)
-                : env.username;
-            const password = productTag
-                ? await this.storeAsSecretIfNeeded(env.password, productTag, graphConfig.tag, env.slug, 'password', `Password for ${graphConfig.tag} in ${env.slug}`)
-                : env.password;
-            processedEnvs.push(Object.assign(Object.assign({}, env), { connection_url: connectionUrl || env.connection_url, graphName,
-                region,
-                username,
-                password }));
-        }
-        // If productTag is provided, use ProductBuilder to persist to backend
-        if (productTag) {
-            const builder = await this.getProductBuilder(productTag);
-            const productGraph = {
-                name: graphConfig.name,
-                tag: graphConfig.tag,
-                description: graphConfig.description,
-                type: graphConfig.type,
-                envs: processedEnvs.map((env) => ({
-                    slug: env.slug,
-                    connection_url: env.connection_url,
-                    description: env.description,
-                    database: env.database,
-                    graphName: env.graphName,
-                    region: env.region,
-                    username: env.username,
-                    password: env.password,
-                })),
-            };
-            await builder.createGraph(productGraph);
-        }
-        // Create local adapters and connection contexts
-        const processedConfig = Object.assign(Object.assign({}, graphConfig), { envs: processedEnvs });
-        this.createAdapter(processedConfig);
-    }
-    /**
-     * Create local adapter and connection context for a graph configuration.
-     * This is a lightweight operation that only sets up local state without API calls.
-     * Use this when the graph config is already fetched/decrypted from the API.
-     *
-     * @param graphConfig - The graph configuration (already decrypted if from API)
-     */
-    createAdapter(graphConfig) {
-        var _a;
-        // Validate required fields
-        if (!graphConfig.tag || !graphConfig.type || !((_a = graphConfig.envs) === null || _a === void 0 ? void 0 : _a.length)) {
-            throw graph_error_1.GraphError.validationError('Graph configuration requires tag, type, and at least one environment');
-        }
-        // Validate graph type
-        if (!this.adapterFactory.isSupported(graphConfig.type)) {
-            throw graph_error_1.GraphError.validationError(`Unsupported graph type: ${graphConfig.type}. ` +
-                `Supported types: ${this.adapterFactory.getSupportedTypes().join(', ')}`);
-        }
-        // Store in local configs
-        this.localConfigs.set(graphConfig.tag, graphConfig);
-        // Create adapters and contexts for each environment
-        for (const envConfig of graphConfig.envs) {
-            const contextKey = `${graphConfig.tag}:${envConfig.slug}`;
-            // Skip if already exists
-            if (this.adapters.has(contextKey) && this.connectionContexts.has(contextKey)) {
-                continue;
-            }
-            const adapter = this.adapterFactory.create(graphConfig.type);
-            this.adapters.set(contextKey, adapter);
-            // Store connection context (not connected yet)
-            this.connectionContexts.set(contextKey, {
-                graph: graphConfig.tag,
-                env: envConfig.slug,
-                type: graphConfig.type,
-                connectionUrl: envConfig.connection_url,
-                connected: false,
-                name: graphConfig.name,
-                description: graphConfig.description,
-                database: envConfig.database,
-                graphName: envConfig.graphName,
-                username: envConfig.username,
-                password: envConfig.password,
-            });
-        }
-    }
-    /**
-     * Generate a secret key for graph configuration field
-     * Format: GRAPH_{PRODUCT}_{ASSET_TAG}_{ENV}_{KEY}
-     *
-     * Where:
-     * - PRODUCT = productTag.split('.')[1] (second part after workspace)
-     * - ASSET_TAG = if graphTag starts with same workspace prefix, use second part; otherwise sanitize full tag
-     * - All parts are automatically capitalized
-     */
-    generateGraphSecretKey(productTag, graphTag, envSlug, field) {
-        const sanitize = (str) => str.toUpperCase().replace(/[^A-Z0-9]/g, '_');
-        // Support both ':' and '.' delimiters for product tags (e.g., 'ductape:rematch' or 'ductape.rematch')
-        const productParts = productTag.includes(':') ? productTag.split(':') : productTag.split('.');
-        const product = productParts[1] || productParts[0]; // Use product name (index 1), fallback to index 0
-        const workspace = productParts[0];
-        // Support both ':' and '.' delimiters for graph tags
-        const graphParts = graphTag.includes(':') ? graphTag.split(':') : graphTag.split('.');
-        let assetTag;
-        if (graphParts.length > 1 && graphParts[0] === workspace) {
-            // Same workspace prefix, use second part
-            assetTag = graphParts[1];
-        }
-        else {
-            // Different or no prefix, use full tag
-            assetTag = graphTag;
-        }
-        return `GRAPH_${sanitize(product)}_${sanitize(assetTag)}_${sanitize(envSlug)}_${sanitize(field)}`;
-    }
-    /**
-     * Store a value as a secret if it exists and is not already a secret reference
-     * @returns The secret reference if stored, or the original value
-     */
-    async storeAsSecretIfNeeded(value, productTag, graphTag, envSlug, fieldName, description) {
-        if (!value) {
-            return undefined;
-        }
-        const secretsService = (0, secrets_1.getSecretsService)();
-        const secretCheck = (0, secrets_1.isSecretReference)(value);
-        console.log(`[GraphService.storeAsSecretIfNeeded] Processing '${fieldName}' for env '${envSlug}':`, {
-            isSecretReference: secretCheck.isSecret,
-            hasValue: !!value,
-        });
-        // If not already a secret reference and we have a secrets service, store it as a secret
-        if (!secretCheck.isSecret && secretsService && productTag) {
-            const secretKey = this.generateGraphSecretKey(productTag, graphTag, envSlug, fieldName);
-            try {
-                const exists = await secretsService.exists(secretKey);
-                console.log(`[GraphService.storeAsSecretIfNeeded] Secret '${secretKey}' exists:`, exists);
-                if (exists) {
-                    await secretsService.update(secretKey, { value });
-                    console.log(`[GraphService.storeAsSecretIfNeeded] Updated existing secret '${secretKey}'`);
-                }
-                else {
-                    await secretsService.create({
-                        key: secretKey,
-                        value,
-                        description,
-                        scope: [productTag, graphTag],
-                        envs: [envSlug],
-                    });
-                    console.log(`[GraphService.storeAsSecretIfNeeded] Created new secret '${secretKey}'`);
-                }
-                return `$Secret{${secretKey}}`;
-            }
-            catch (error) {
-                console.warn(`[GraphService.storeAsSecretIfNeeded] Failed to store '${fieldName}' as secret: ${secretKey}`, error);
-                // Continue with the original value
-                return value;
-            }
-        }
-        return value;
-    }
-    // ==================== PRODUCT COMPONENT FETCHING ====================
-    /**
-     * Fetch all graphs for a product using the product component fetcher
-     * @param productTag - The product tag
-     * @returns Array of IProductGraph objects
-     */
-    async fetchAllGraphs(productTag) {
-        const builder = await this.getProductBuilder(productTag);
-        return builder.fetchGraphs();
-    }
-    /**
-     * Fetch a specific graph by tag using the product component fetcher
-     * @param productTag - The product tag
-     * @param graphTag - The graph tag
-     * @returns The IProductGraph object or null if not found
-     */
-    async fetchGraphByTag(productTag, graphTag) {
-        const builder = await this.getProductBuilder(productTag);
-        return builder.fetchGraph(graphTag);
-    }
-    // ==================== GRAPH CONFIGURATION ====================
-    /**
-     * Fetch all registered graphs for a product
-     */
-    async fetchAll(productTag) {
-        // Return local configs if no product tag
-        if (!productTag) {
-            return Array.from(this.localConfigs.values());
-        }
-        // Fetch from API using ProductBuilder
-        try {
-            const builder = await this.getProductBuilder(productTag);
-            const graphs = await builder.fetchGraphs();
-            // Convert IProductGraph[] to IGraphConfig[]
-            return graphs.map((graph) => this.productGraphToConfig(graph));
-        }
-        catch (error) {
-            // Fall back to local configs if API fails
-            return Array.from(this.localConfigs.values());
-        }
-    }
-    /**
-     * Fetch a specific graph configuration
-     */
-    async fetch(graphTag, productTag) {
-        // If productTag is provided, fetch from API
-        if (productTag) {
-            try {
-                const builder = await this.getProductBuilder(productTag);
-                const graph = await builder.fetchGraph(graphTag);
-                if (graph) {
-                    const config = this.productGraphToConfig(graph);
-                    // Also update local cache
-                    this.localConfigs.set(graphTag, config);
-                    return config;
-                }
-                return null;
-            }
-            catch (error) {
-                // Fall back to local config
-                return this.localConfigs.get(graphTag) || null;
-            }
-        }
-        return this.localConfigs.get(graphTag) || null;
-    }
-    /**
-     * Update graph configuration
-     */
-    async update(graphTag, updates, productTag) {
-        var _a;
-        // If productTag is provided, use ProductBuilder to update in backend
-        if (productTag) {
-            const builder = await this.getProductBuilder(productTag);
-            const productGraphUpdates = {
-                name: updates.name,
-                description: updates.description,
-                type: updates.type,
-                envs: (_a = updates.envs) === null || _a === void 0 ? void 0 : _a.map((env) => ({
-                    slug: env.slug,
-                    connection_url: env.connection_url,
-                    description: env.description,
-                    database: env.database,
-                    graphName: env.graphName,
-                    region: env.region,
-                    username: env.username,
-                    password: env.password,
-                })),
-            };
-            await builder.updateGraph(graphTag, productGraphUpdates);
-        }
-        const existing = this.localConfigs.get(graphTag);
-        if (!existing && !productTag) {
-            throw graph_error_1.GraphError.notFoundError(`Graph '${graphTag}' not found`);
-        }
-        const updated = Object.assign(Object.assign(Object.assign({}, (existing || {})), updates), { tag: graphTag });
-        this.localConfigs.set(graphTag, updated);
-        // Update connection contexts
-        if (updates.envs) {
-            for (const envConfig of updates.envs) {
-                const contextKey = `${graphTag}:${envConfig.slug}`;
-                const existingContext = this.connectionContexts.get(contextKey);
-                if (existingContext) {
-                    this.connectionContexts.set(contextKey, Object.assign(Object.assign({}, existingContext), { connectionUrl: envConfig.connection_url, database: envConfig.database, graphName: envConfig.graphName, username: envConfig.username, password: envConfig.password }));
-                }
-            }
-        }
-    }
-    /**
-     * Delete a graph configuration
-     */
-    async delete(graphTag, productTag) {
-        var _a;
-        // If productTag is provided, use ProductBuilder to delete from backend
-        if (productTag) {
-            const builder = await this.getProductBuilder(productTag);
-            await builder.deleteGraph(graphTag);
-        }
-        // Get local config to clean up adapters and contexts
-        const config = this.localConfigs.get(graphTag);
-        if (config) {
-            // Clean up adapters and contexts for each environment
-            for (const envConfig of config.envs) {
-                const contextKey = `${graphTag}:${envConfig.slug}`;
-                // Disconnect adapter if connected
-                const adapter = this.adapters.get(contextKey);
-                if (adapter) {
-                    try {
-                        await adapter.disconnect();
-                    }
-                    catch (error) {
-                        // Ignore disconnect errors during cleanup
-                    }
-                    this.adapters.delete(contextKey);
-                }
-                // Remove connection context
-                this.connectionContexts.delete(contextKey);
-            }
-            // Remove from local configs
-            this.localConfigs.delete(graphTag);
-            // Clear current context if it was the deleted graph
-            if (((_a = this.currentContext) === null || _a === void 0 ? void 0 : _a.graph) === graphTag) {
-                this.currentContext = null;
-                this.transactionManager = null;
-            }
-        }
-        else if (!productTag) {
-            throw graph_error_1.GraphError.notFoundError(`Graph '${graphTag}' not found`);
-        }
-    }
-    /**
-     * Convert IProductGraph to IGraphConfig
-     */
-    productGraphToConfig(graph) {
-        return {
-            name: graph.name,
-            tag: graph.tag,
-            type: graph.type,
-            description: graph.description,
-            envs: graph.envs.map((env) => ({
-                slug: env.slug,
-                connection_url: env.connection_url,
-                description: env.description,
-                database: env.database,
-                graphName: env.graphName,
-                region: env.region,
-                username: env.username,
-                password: env.password,
-            })),
-        };
-    }
-    // ==================== CONNECTION MANAGEMENT ====================
-    /**
-     * Connect to a graph database
-     * As documented in getting-started.md
-     *
-     * @example
-     * ```ts
-     * await ductape.graph.connect({
-     *   env: 'dev',
-     *   product: 'my-app',
-     *   graph: 'social-graph',
-     * });
-     * ```
-     */
-    async connect(config) {
-        var _a, _b, _c;
-        const process_id = (0, processor_utils_1.generateObjectId)();
-        const start = Date.now();
-        const contextKey = `${config.graph}:${config.env}`;
-        const workspaceId = (_b = (_a = this.config) === null || _a === void 0 ? void 0 : _a.workspace_id) !== null && _b !== void 0 ? _b : '';
-        const product = (_c = config.product) !== null && _c !== void 0 ? _c : '';
-        const useShared = workspaceId !== '' && product !== '';
-        if (useShared) {
-            const sharedKey = getSharedGraphKey(workspaceId, product, config.graph, config.env);
-            const existing = sharedGraphRegistry.get(sharedKey);
-            if (existing === null || existing === void 0 ? void 0 : existing.context.connected) {
-                this.adapters.set(contextKey, existing.adapter);
-                this.connectionContexts.set(contextKey, existing.context);
-                this.currentContext = existing.context;
-                this.transactionManager = new transaction_manager_1.GraphTransactionManager(existing.adapter);
-                return { connected: true, type: existing.context.type };
-            }
-            const inFlight = sharedGraphConnectInFlight.get(sharedKey);
-            if (inFlight) {
-                const entry = await inFlight;
-                this.adapters.set(contextKey, entry.adapter);
-                this.connectionContexts.set(contextKey, entry.context);
-                this.currentContext = entry.context;
-                this.transactionManager = new transaction_manager_1.GraphTransactionManager(entry.adapter);
-                return { connected: true, type: entry.context.type };
-            }
-            const createPromise = this.connectAndRegisterGraphShared(sharedKey, config, contextKey);
-            sharedGraphConnectInFlight.set(sharedKey, createPromise);
-            try {
-                const entry = await createPromise;
-                this.adapters.set(contextKey, entry.adapter);
-                this.connectionContexts.set(contextKey, entry.context);
-                this.currentContext = entry.context;
-                this.transactionManager = new transaction_manager_1.GraphTransactionManager(entry.adapter);
-                return { connected: true, type: entry.context.type };
-            }
-            finally {
-                sharedGraphConnectInFlight.delete(sharedKey);
-            }
-        }
-        let adapter = this.adapters.get(contextKey);
-        let context = this.connectionContexts.get(contextKey);
-        if (!adapter || !context) {
-            if (config.product)
-                await this.getProductBuilder(config.product);
-            const graphConfig = await this.fetchGraphFromProduct(config.product, config.graph);
-            if (!graphConfig) {
-                throw graph_error_1.GraphError.notFoundError(`Graph '${config.graph}' not found in product '${config.product}'`);
-            }
-            this.createAdapter(graphConfig);
-            adapter = this.adapters.get(contextKey);
-            context = this.connectionContexts.get(contextKey);
-        }
-        if (!adapter || !context) {
-            throw graph_error_1.GraphError.configurationError(`Failed to initialize adapter for ${contextKey}`);
-        }
-        return this.runGraphConnect(config, contextKey, adapter, context, process_id, start);
-    }
-    /**
-     * Disconnect any existing connection to this graph from the SDK (shared registry and this instance) before creating a fresh one.
-     */
-    async disconnectExistingForResource(sharedKey, contextKey, workspaceId, product, graph, env) {
-        const existingInRegistry = sharedGraphRegistry.get(sharedKey);
-        if (existingInRegistry) {
-            try {
-                await existingInRegistry.adapter.disconnect();
-                existingInRegistry.context.connected = false;
-            }
-            catch (_a) {
-                // Non-fatal
-            }
-            sharedGraphRegistry.delete(sharedKey);
-        }
-        const context = this.connectionContexts.get(contextKey);
-        if (context === null || context === void 0 ? void 0 : context.connected) {
-            const adapter = this.adapters.get(contextKey);
-            if (adapter) {
-                try {
-                    if (this.transactionManager)
-                        await this.transactionManager.rollbackAll();
-                    await adapter.disconnect();
-                }
-                catch (_b) {
-                    // Non-fatal
-                }
-                context.connected = false;
-                if (workspaceId && product) {
-                    sharedGraphRegistry.delete(getSharedGraphKey(workspaceId, product, graph, env));
-                }
-            }
-        }
-    }
-    async connectAndRegisterGraphShared(sharedKey, config, contextKey) {
-        var _a, _b, _c;
-        const workspaceId = (_b = (_a = this.config) === null || _a === void 0 ? void 0 : _a.workspace_id) !== null && _b !== void 0 ? _b : '';
-        const product = (_c = config.product) !== null && _c !== void 0 ? _c : '';
-        await this.disconnectExistingForResource(sharedKey, contextKey, workspaceId, product, config.graph, config.env);
-        let adapter = this.adapters.get(contextKey);
-        let context = this.connectionContexts.get(contextKey);
-        if (!adapter || !context) {
-            if (config.product)
-                await this.getProductBuilder(config.product);
-            const graphConfig = await this.fetchGraphFromProduct(config.product, config.graph);
-            if (!graphConfig) {
-                throw graph_error_1.GraphError.notFoundError(`Graph '${config.graph}' not found in product '${config.product}'`);
-            }
-            this.createAdapter(graphConfig);
-            adapter = this.adapters.get(contextKey);
-            context = this.connectionContexts.get(contextKey);
-        }
-        await this.runGraphConnect(config, contextKey, adapter, context, (0, processor_utils_1.generateObjectId)(), Date.now());
-        const entry = { adapter, context };
-        const raceExisting = sharedGraphRegistry.get(sharedKey);
-        if (raceExisting) {
-            try {
-                await raceExisting.adapter.disconnect();
-                raceExisting.context.connected = false;
-            }
-            catch (_d) {
-                // Non-fatal
-            }
-            sharedGraphRegistry.delete(sharedKey);
-        }
-        sharedGraphRegistry.set(sharedKey, entry);
-        return entry;
-    }
-    async runGraphConnect(config, contextKey, adapter, context, process_id, start) {
-        var _a, _b, _c, _d, _e;
-        this.initializeLogService();
-        const envValue = config.env || '';
-        const baseLogs = {
-            product_tag: config.product || '',
-            workspace_id: ((_a = this.config) === null || _a === void 0 ? void 0 : _a.workspace_id) || '',
-            env: envValue,
-            app_env: envValue,
-            process_id,
-            type: logs_types_1.LogEventTypes.GRAPH,
-            parent_tag: config.graph,
-            child_tag: 'connect',
-            data: { graph: config.graph, env: envValue, operation: 'connect' },
-        };
-        const logKey = `${(_b = config.product) !== null && _b !== void 0 ? _b : ''}:${config.graph}:${config.env}`;
-        const now = Date.now();
-        const last = (_c = lastGraphConnectLogAt.get(logKey)) !== null && _c !== void 0 ? _c : {};
-        if (this.logService && (!last.initiated || now - last.initiated >= GRAPH_CONNECT_LOG_DEBOUNCE_MS)) {
-            lastGraphConnectLogAt.set(logKey, Object.assign(Object.assign({}, last), { initiated: now }));
-            this.logService.add(Object.assign(Object.assign({}, baseLogs), { start, message: 'Graph connect - initiated', status: logs_types_1.LogEventStatus.PROCESSING }));
-        }
-        try {
-            const secretsService = (0, secrets_1.getSecretsService)();
-            const resolveSecret = async (value, fieldName) => {
-                if (!value)
-                    return undefined;
-                const secretCheck = (0, secrets_1.isSecretReference)(value);
-                if (secretCheck.isSecret) {
-                    if (secretsService) {
-                        const resolved = await secretsService.resolve(value, { env: config.env });
-                        return resolved.value;
-                    }
-                    throw graph_error_1.GraphError.configurationError(`${fieldName} contains secret reference but secrets service is not initialized.`);
-                }
-                return value;
-            };
-            const connectionUrl = await resolveSecret(context.connectionUrl, 'connectionUrl');
-            const graphName = await resolveSecret(context.graphName, 'graphName');
-            const username = await resolveSecret(context.username, 'username');
-            const password = await resolveSecret(context.password, 'password');
-            if (!connectionUrl)
-                throw graph_error_1.GraphError.configurationError('Connection URL is required');
-            const result = await adapter.connect({
-                connectionUrl,
-                database: context.database,
-                graphName: graphName || context.graphName,
-                options: config.options,
-                auth: username && password ? { username, password } : undefined,
-            });
-            context.connected = result.connected;
-            context.product = config.product;
-            this.connectionContexts.set(contextKey, context);
-            this.currentContext = context;
-            this.transactionManager = new transaction_manager_1.GraphTransactionManager(adapter);
-            const end = Date.now();
-            const lastSuccess = (_d = lastGraphConnectLogAt.get(logKey)) !== null && _d !== void 0 ? _d : {};
-            if (this.logService && (!lastSuccess.success || end - lastSuccess.success >= GRAPH_CONNECT_LOG_DEBOUNCE_MS)) {
-                lastGraphConnectLogAt.set(logKey, Object.assign(Object.assign({}, lastSuccess), { success: end }));
-                this.logService.add(Object.assign(Object.assign({}, baseLogs), { start, end, message: 'Graph connect - success', successful_execution: true, status: logs_types_1.LogEventStatus.SUCCESS }));
-                this.logService.publish();
-            }
-            return result;
-        }
-        catch (error) {
-            const end = Date.now();
-            const lastFail = (_e = lastGraphConnectLogAt.get(logKey)) !== null && _e !== void 0 ? _e : {};
-            if (this.logService && (!lastFail.failed || end - lastFail.failed >= GRAPH_CONNECT_LOG_DEBOUNCE_MS)) {
-                lastGraphConnectLogAt.set(logKey, Object.assign(Object.assign({}, lastFail), { failed: end }));
-                this.logService.add(Object.assign(Object.assign({}, baseLogs), { start,
-                    end, message: 'Graph connect - failed', failed_execution: true, data: { graph: config.graph, env: config.env, error: String(error) }, status: logs_types_1.LogEventStatus.FAIL }));
-                await this.logService.publish();
-            }
-            throw error;
-        }
-    }
-    /**
-     * Test connection to a graph database
-     */
-    async testConnection(config) {
-        const contextKey = `${config.graph}:${config.env}`;
-        const context = this.connectionContexts.get(contextKey);
-        if (!context) {
-            throw graph_error_1.GraphError.notFoundError(`Graph configuration not found for ${config.graph}:${config.env}`);
-        }
-        const adapter = this.adapterFactory.create(context.type);
-        return adapter.testConnection({
-            connectionUrl: context.connectionUrl,
-            database: context.database,
-            graphName: context.graphName,
-            options: config.options,
-            auth: context.username && context.password ? { username: context.username, password: context.password } : undefined,
-        });
-    }
-    /**
-     * Disconnect from current graph
-     */
-    async disconnect() {
-        var _a, _b, _c;
-        if (this.currentContext) {
-            const contextKey = `${this.currentContext.graph}:${this.currentContext.env}`;
-            const adapter = this.adapters.get(contextKey);
-            if (adapter) {
-                if (this.transactionManager)
-                    await this.transactionManager.rollbackAll();
-                await adapter.disconnect();
-                this.currentContext.connected = false;
-                const workspaceId = (_b = (_a = this.config) === null || _a === void 0 ? void 0 : _a.workspace_id) !== null && _b !== void 0 ? _b : '';
-                const product = (_c = this.currentContext.product) !== null && _c !== void 0 ? _c : '';
-                if (workspaceId && product) {
-                    sharedGraphRegistry.delete(getSharedGraphKey(workspaceId, product, this.currentContext.graph, this.currentContext.env));
-                }
-            }
-            this.currentContext = null;
-        }
-    }
-    /**
-     * Disconnect from all graphs
-     */
-    async closeAll() {
-        var _a, _b, _c;
-        const workspaceId = (_b = (_a = this.config) === null || _a === void 0 ? void 0 : _a.workspace_id) !== null && _b !== void 0 ? _b : '';
-        for (const [key, adapter] of this.adapters.entries()) {
-            try {
-                await adapter.disconnect();
-                const context = this.connectionContexts.get(key);
-                if (context) {
-                    context.connected = false;
-                    const product = (_c = context.product) !== null && _c !== void 0 ? _c : '';
-                    if (workspaceId && product) {
-                        sharedGraphRegistry.delete(getSharedGraphKey(workspaceId, product, context.graph, context.env));
-                    }
-                }
-            }
-            catch (error) {
-                console.error(`Failed to disconnect ${key}:`, error);
-            }
-        }
-        if (this.transactionManager)
-            await this.transactionManager.rollbackAll();
-        this.currentContext = null;
-    }
-    // ==================== NODE OPERATIONS ====================
-    /**
-     * Create a node
-     * As documented in nodes.md
-     */
-    async createNode(options, transaction) {
-        var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k;
-        await this.ensureConnectionFor(options);
-        const process_id = (0, processor_utils_1.generateObjectId)();
-        const start = Date.now();
-        // Session log fields (will be populated if session is provided)
-        let sessionLogFields = {};
-        let resolvedOptions = options;
-        // Process session if provided
-        if (options.session && ((_a = this.currentContext) === null || _a === void 0 ? void 0 : _a.product)) {
-            const builder = await this.getProductBuilder(this.currentContext.product);
-            const privateKey = builder.fetchPrivateKey();
-            if (privateKey) {
-                const { processSessionForExecution } = await Promise.resolve().then(() => __importStar(require('../sessions')));
-                const sessionResult = await processSessionForExecution(options.session, privateKey, options, this.currentContext.env, {
-                    fetchSessionSelector: async (sessionTag) => {
-                        const sessionConfig = await builder.fetchSession(sessionTag);
-                        return sessionConfig === null || sessionConfig === void 0 ? void 0 : sessionConfig.selector;
-                    },
-                });
-                if (sessionResult.error) {
-                    throw new Error(`Session validation failed: ${sessionResult.error}`);
-                }
-                resolvedOptions = sessionResult.input;
-                sessionLogFields = sessionResult.logFields;
-            }
-        }
-        this.initializeLogService();
-        const envValue = ((_b = this.currentContext) === null || _b === void 0 ? void 0 : _b.env) || '';
-        const graphValue = ((_c = this.currentContext) === null || _c === void 0 ? void 0 : _c.graph) || '';
-        const baseLogs = Object.assign({ product_tag: ((_d = this.currentContext) === null || _d === void 0 ? void 0 : _d.product) || '', workspace_id: ((_e = this.config) === null || _e === void 0 ? void 0 : _e.workspace_id) || '', env: envValue, app_env: envValue, process_id, type: logs_types_1.LogEventTypes.GRAPH, parent_tag: graphValue, child_tag: 'createNode', data: { labels: resolvedOptions.labels, operation: 'createNode', graph: graphValue, env: envValue, properties: resolvedOptions.properties } }, sessionLogFields);
-        (_f = this.logService) === null || _f === void 0 ? void 0 : _f.add(Object.assign(Object.assign({}, baseLogs), { start, message: 'Graph createNode - initiated', status: logs_types_1.LogEventStatus.PROCESSING }));
-        try {
-            const adapter = this.getAdapter();
-            const result = await adapter.createNode(resolvedOptions, transaction);
-            const end = Date.now();
-            (_g = this.logService) === null || _g === void 0 ? void 0 : _g.add(Object.assign(Object.assign({}, baseLogs), { start,
-                end, message: 'Graph createNode - success', successful_execution: true, status: logs_types_1.LogEventStatus.SUCCESS }));
-            (_h = this.logService) === null || _h === void 0 ? void 0 : _h.publish();
-            return result;
-        }
-        catch (error) {
-            const end = Date.now();
-            (_j = this.logService) === null || _j === void 0 ? void 0 : _j.add(Object.assign(Object.assign({}, baseLogs), { start,
-                end, message: 'Graph createNode - failed', failed_execution: true, data: { labels: resolvedOptions.labels, operation: 'createNode', error: String(error) }, status: logs_types_1.LogEventStatus.FAIL }));
-            await ((_k = this.logService) === null || _k === void 0 ? void 0 : _k.publish());
-            throw error;
-        }
-    }
-    /**
-     * Find nodes by criteria
-     * As documented in nodes.md
-     */
-    async findNodes(options, transaction) {
-        var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q;
-        await this.ensureConnectionFor(options);
-        const process_id = (0, processor_utils_1.generateObjectId)();
-        const start = Date.now();
-        // Session log fields (will be populated if session is provided)
-        let sessionLogFields = {};
-        let resolvedOptions = options;
-        // Process session if provided
-        if (options.session && ((_a = this.currentContext) === null || _a === void 0 ? void 0 : _a.product)) {
-            const builder = await this.getProductBuilder(this.currentContext.product);
-            const privateKey = builder.fetchPrivateKey();
-            if (privateKey) {
-                const { processSessionForExecution } = await Promise.resolve().then(() => __importStar(require('../sessions')));
-                const sessionResult = await processSessionForExecution(options.session, privateKey, options, this.currentContext.env, {
-                    fetchSessionSelector: async (sessionTag) => {
-                        const sessionConfig = await builder.fetchSession(sessionTag);
-                        return sessionConfig === null || sessionConfig === void 0 ? void 0 : sessionConfig.selector;
-                    },
-                });
-                if (sessionResult.error) {
-                    throw new Error(`Session validation failed: ${sessionResult.error}`);
-                }
-                resolvedOptions = sessionResult.input;
-                sessionLogFields = sessionResult.logFields;
-            }
-        }
-        this.initializeLogService();
-        const envValue = ((_b = this.currentContext) === null || _b === void 0 ? void 0 : _b.env) || '';
-        const graphValue = ((_c = this.currentContext) === null || _c === void 0 ? void 0 : _c.graph) || '';
-        const baseLogs = Object.assign({ product_tag: ((_d = this.currentContext) === null || _d === void 0 ? void 0 : _d.product) || '', workspace_id: ((_e = this.config) === null || _e === void 0 ? void 0 : _e.workspace_id) || '', env: envValue, app_env: envValue, process_id, type: logs_types_1.LogEventTypes.GRAPH, parent_tag: graphValue, child_tag: 'findNodes', data: { labels: resolvedOptions.labels, operation: 'findNodes', graph: graphValue, env: envValue, where: resolvedOptions.where, select: resolvedOptions.select, orderBy: resolvedOptions.orderBy, limit: resolvedOptions.limit, offset: resolvedOptions.offset } }, sessionLogFields);
-        (_f = this.logService) === null || _f === void 0 ? void 0 : _f.add(Object.assign(Object.assign({}, baseLogs), { start, message: 'Graph findNodes - initiated', status: logs_types_1.LogEventStatus.PROCESSING }));
-        try {
-            // Check cache if cache tag is provided
-            const productTag = (_g = this.currentContext) === null || _g === void 0 ? void 0 : _g.product;
-            const privateKey = productTag ? this.privateKeys.get(productTag) : undefined;
-            if (resolvedOptions.cache && this.cacheManager && privateKey) {
-                const cacheOptions = {
-                    cache_tag: resolvedOptions.cache,
-                    product_tag: productTag || '',
-                    component_tag: ((_h = this.currentContext) === null || _h === void 0 ? void 0 : _h.graph) || '',
-                    component_type: 'graph',
-                    input: {
-                        labels: resolvedOptions.labels,
-                        where: resolvedOptions.where,
-                        select: resolvedOptions.select,
-                        orderBy: resolvedOptions.orderBy,
-                        limit: resolvedOptions.limit,
-                        offset: resolvedOptions.offset,
-                    },
-                    privateKey,
-                };
-                const cached = await this.cacheManager.fetch(cacheOptions);
-                if (cached.hit && cached.data) {
-                    const end = Date.now();
-                    (_j = this.logService) === null || _j === void 0 ? void 0 : _j.add(Object.assign(Object.assign({}, baseLogs), { start,
-                        end, message: `Graph findNodes - cache hit (${cached.source})`, successful_execution: true, status: logs_types_1.LogEventStatus.SUCCESS, cache_tag: resolvedOptions.cache, cache_key: cached.key, cache_status: true }));
-                    (_k = this.logService) === null || _k === void 0 ? void 0 : _k.publish();
-                    return cached.data;
-                }
-            }
-            const adapter = this.getAdapter();
-            const result = await adapter.findNodes(resolvedOptions, transaction);
-            // Store in cache if cache tag is provided
-            if (resolvedOptions.cache && this.cacheManager && privateKey) {
-                const cacheOptions = {
-                    cache_tag: resolvedOptions.cache,
-                    product_tag: productTag || '',
-                    component_tag: ((_l = this.currentContext) === null || _l === void 0 ? void 0 : _l.graph) || '',
-                    component_type: 'graph',
-                    input: {
-                        labels: resolvedOptions.labels,
-                        where: resolvedOptions.where,
-                        select: resolvedOptions.select,
-                        orderBy: resolvedOptions.orderBy,
-                        limit: resolvedOptions.limit,
-                        offset: resolvedOptions.offset,
-                    },
-                    privateKey,
-                };
-                this.cacheManager.store(cacheOptions, result); // Fire-and-forget
-            }
-            const end = Date.now();
-            (_m = this.logService) === null || _m === void 0 ? void 0 : _m.add(Object.assign(Object.assign({}, baseLogs), { start,
-                end, message: 'Graph findNodes - success', successful_execution: true, status: logs_types_1.LogEventStatus.SUCCESS }));
-            (_o = this.logService) === null || _o === void 0 ? void 0 : _o.publish();
-            return result;
-        }
-        catch (error) {
-            const end = Date.now();
-            (_p = this.logService) === null || _p === void 0 ? void 0 : _p.add(Object.assign(Object.assign({}, baseLogs), { start,
-                end, message: 'Graph findNodes - failed', failed_execution: true, data: { labels: resolvedOptions.labels, operation: 'findNodes', error: String(error) }, status: logs_types_1.LogEventStatus.FAIL }));
-            await ((_q = this.logService) === null || _q === void 0 ? void 0 : _q.publish());
-            throw error;
-        }
-    }
-    /**
-     * Find a node by ID
-     * As documented in nodes.md
-     */
-    async findNodeById(id, transaction) {
-        return this.executeWithRetry(async () => {
-            const adapter = this.getAdapter();
-            return adapter.findNodeById(id, transaction);
-        });
-    }
-    /**
-     * Update a node
-     * As documented in nodes.md
-     */
-    async updateNode(options, transaction) {
-        var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k;
-        await this.ensureConnectionFor(options);
-        const process_id = (0, processor_utils_1.generateObjectId)();
-        const start = Date.now();
-        // Session log fields (will be populated if session is provided)
-        let sessionLogFields = {};
-        let resolvedOptions = options;
-        // Process session if provided
-        if (options.session && ((_a = this.currentContext) === null || _a === void 0 ? void 0 : _a.product)) {
-            const builder = await this.getProductBuilder(this.currentContext.product);
-            const privateKey = builder.fetchPrivateKey();
-            if (privateKey) {
-                const { processSessionForExecution } = await Promise.resolve().then(() => __importStar(require('../sessions')));
-                const sessionResult = await processSessionForExecution(options.session, privateKey, options, this.currentContext.env, {
-                    fetchSessionSelector: async (sessionTag) => {
-                        const sessionConfig = await builder.fetchSession(sessionTag);
-                        return sessionConfig === null || sessionConfig === void 0 ? void 0 : sessionConfig.selector;
-                    },
-                });
-                if (sessionResult.error) {
-                    throw new Error(`Session validation failed: ${sessionResult.error}`);
-                }
-                resolvedOptions = sessionResult.input;
-                sessionLogFields = sessionResult.logFields;
-            }
-        }
-        this.initializeLogService();
-        const envValue = ((_b = this.currentContext) === null || _b === void 0 ? void 0 : _b.env) || '';
-        const graphValue = ((_c = this.currentContext) === null || _c === void 0 ? void 0 : _c.graph) || '';
-        const baseLogs = Object.assign({ product_tag: ((_d = this.currentContext) === null || _d === void 0 ? void 0 : _d.product) || '', workspace_id: ((_e = this.config) === null || _e === void 0 ? void 0 : _e.workspace_id) || '', env: envValue, app_env: envValue, process_id, type: logs_types_1.LogEventTypes.GRAPH, parent_tag: graphValue, child_tag: 'updateNode', data: { id: resolvedOptions.id, operation: 'updateNode', graph: graphValue, env: envValue, properties: resolvedOptions.properties, labels: resolvedOptions.labels } }, sessionLogFields);
-        (_f = this.logService) === null || _f === void 0 ? void 0 : _f.add(Object.assign(Object.assign({}, baseLogs), { start, message: 'Graph updateNode - initiated', status: logs_types_1.LogEventStatus.PROCESSING }));
-        try {
-            const adapter = this.getAdapter();
-            const result = await adapter.updateNode(resolvedOptions, transaction);
-            const end = Date.now();
-            (_g = this.logService) === null || _g === void 0 ? void 0 : _g.add(Object.assign(Object.assign({}, baseLogs), { start,
-                end, message: 'Graph updateNode - success', successful_execution: true, status: logs_types_1.LogEventStatus.SUCCESS }));
-            (_h = this.logService) === null || _h === void 0 ? void 0 : _h.publish();
-            return result;
-        }
-        catch (error) {
-            const end = Date.now();
-            (_j = this.logService) === null || _j === void 0 ? void 0 : _j.add(Object.assign(Object.assign({}, baseLogs), { start,
-                end, message: 'Graph updateNode - failed', failed_execution: true, data: { id: resolvedOptions.id, operation: 'updateNode', error: String(error) }, status: logs_types_1.LogEventStatus.FAIL }));
-            await ((_k = this.logService) === null || _k === void 0 ? void 0 : _k.publish());
-            throw error;
-        }
-    }
-    /**
-     * Delete a node
-     * As documented in nodes.md
-     */
-    async deleteNode(options, transaction) {
-        var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k;
-        await this.ensureConnectionFor(options);
-        const process_id = (0, processor_utils_1.generateObjectId)();
-        const start = Date.now();
-        // Session log fields (will be populated if session is provided)
-        let sessionLogFields = {};
-        let resolvedOptions = options;
-        // Process session if provided
-        if (options.session && ((_a = this.currentContext) === null || _a === void 0 ? void 0 : _a.product)) {
-            const builder = await this.getProductBuilder(this.currentContext.product);
-            const privateKey = builder.fetchPrivateKey();
-            if (privateKey) {
-                const { processSessionForExecution } = await Promise.resolve().then(() => __importStar(require('../sessions')));
-                const sessionResult = await processSessionForExecution(options.session, privateKey, options, this.currentContext.env, {
-                    fetchSessionSelector: async (sessionTag) => {
-                        const sessionConfig = await builder.fetchSession(sessionTag);
-                        return sessionConfig === null || sessionConfig === void 0 ? void 0 : sessionConfig.selector;
-                    },
-                });
-                if (sessionResult.error) {
-                    throw new Error(`Session validation failed: ${sessionResult.error}`);
-                }
-                resolvedOptions = sessionResult.input;
-                sessionLogFields = sessionResult.logFields;
-            }
-        }
-        this.initializeLogService();
-        const envValue = ((_b = this.currentContext) === null || _b === void 0 ? void 0 : _b.env) || '';
-        const graphValue = ((_c = this.currentContext) === null || _c === void 0 ? void 0 : _c.graph) || '';
-        const baseLogs = Object.assign({ product_tag: ((_d = this.currentContext) === null || _d === void 0 ? void 0 : _d.product) || '', workspace_id: ((_e = this.config) === null || _e === void 0 ? void 0 : _e.workspace_id) || '', env: envValue, app_env: envValue, process_id, type: logs_types_1.LogEventTypes.GRAPH, parent_tag: graphValue, child_tag: 'deleteNode', data: { id: resolvedOptions.id, operation: 'deleteNode', graph: graphValue, env: envValue, detach: resolvedOptions.detach } }, sessionLogFields);
-        (_f = this.logService) === null || _f === void 0 ? void 0 : _f.add(Object.assign(Object.assign({}, baseLogs), { start, message: 'Graph deleteNode - initiated', status: logs_types_1.LogEventStatus.PROCESSING }));
-        try {
-            const adapter = this.getAdapter();
-            const result = await adapter.deleteNode(resolvedOptions, transaction);
-            const end = Date.now();
-            (_g = this.logService) === null || _g === void 0 ? void 0 : _g.add(Object.assign(Object.assign({}, baseLogs), { start,
-                end, message: 'Graph deleteNode - success', successful_execution: true, status: logs_types_1.LogEventStatus.SUCCESS }));
-            (_h = this.logService) === null || _h === void 0 ? void 0 : _h.publish();
-            return result;
-        }
-        catch (error) {
-            const end = Date.now();
-            (_j = this.logService) === null || _j === void 0 ? void 0 : _j.add(Object.assign(Object.assign({}, baseLogs), { start,
-                end, message: 'Graph deleteNode - failed', failed_execution: true, data: { id: resolvedOptions.id, operation: 'deleteNode', error: String(error) }, status: logs_types_1.LogEventStatus.FAIL }));
-            await ((_k = this.logService) === null || _k === void 0 ? void 0 : _k.publish());
-            throw error;
-        }
-    }
-    /**
-     * Merge (upsert) a node
-     * As documented in nodes.md
-     */
-    async mergeNode(options, transaction) {
-        await this.ensureConnectionFor(options);
-        return this.executeWithRetry(async () => {
-            const adapter = this.getAdapter();
-            return adapter.mergeNode(options, transaction);
-        });
-    }
-    // ==================== LABEL MANAGEMENT ====================
-    /**
-     * Add labels to an existing node
-     *
-     * @example
-     * ```ts
-     * const result = await graphService.addLabels({
-     *   id: 'node-123',
-     *   labels: ['Admin', 'Verified'],
-     * });
-     * console.log(result.node.labels); // ['Person', 'Admin', 'Verified']
-     * ```
-     */
-    async addLabels(options, transaction) {
-        await this.ensureConnectionFor(options);
-        return this.executeWithRetry(async () => {
-            const adapter = this.getAdapter();
-            return adapter.addLabels(options, transaction);
-        });
-    }
-    /**
-     * Remove labels from an existing node
-     *
-     * @example
-     * ```ts
-     * const result = await graphService.removeLabels({
-     *   id: 'node-123',
-     *   labels: ['Temporary'],
-     * });
-     * console.log(result.removedLabels); // ['Temporary']
-     * ```
-     */
-    async removeLabels(options, transaction) {
-        await this.ensureConnectionFor(options);
-        return this.executeWithRetry(async () => {
-            const adapter = this.getAdapter();
-            return adapter.removeLabels(options, transaction);
-        });
-    }
-    /**
-     * Set labels on a node (replaces all existing labels)
-     *
-     * @example
-     * ```ts
-     * const result = await graphService.setLabels({
-     *   id: 'node-123',
-     *   labels: ['Person', 'Employee'],
-     * });
-     * console.log(result.previousLabels); // ['Person', 'Contractor']
-     * console.log(result.newLabels); // ['Person', 'Employee']
-     * ```
-     */
-    async setLabels(options, transaction) {
-        await this.ensureConnectionFor(options);
-        return this.executeWithRetry(async () => {
-            const adapter = this.getAdapter();
-            return adapter.setLabels(options, transaction);
-        });
-    }
-    // ==================== RELATIONSHIP OPERATIONS ====================
-    /**
-     * Create a relationship
-     * As documented in relationships.md
-     */
-    async createRelationship(options, transaction) {
-        var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k;
-        await this.ensureConnectionFor(options);
-        const process_id = (0, processor_utils_1.generateObjectId)();
-        const start = Date.now();
-        this.initializeLogService();
-        // Session log fields (will be populated if session is provided)
-        let sessionLogFields = {};
-        let resolvedOptions = options;
-        // Process session if provided
-        if (options.session && ((_a = this.currentContext) === null || _a === void 0 ? void 0 : _a.product)) {
-            const builder = await this.getProductBuilder(this.currentContext.product);
-            const privateKey = builder.fetchPrivateKey();
-            if (privateKey) {
-                const { processSessionForExecution } = await Promise.resolve().then(() => __importStar(require('../sessions')));
-                const sessionResult = await processSessionForExecution(options.session, privateKey, options, this.currentContext.env, {
-                    fetchSessionSelector: async (sessionTag) => {
-                        const sessionConfig = await builder.fetchSession(sessionTag);
-                        return sessionConfig === null || sessionConfig === void 0 ? void 0 : sessionConfig.selector;
-                    },
-                });
-                if (sessionResult.error) {
-                    throw new Error(`Session validation failed: ${sessionResult.error}`);
-                }
-                resolvedOptions = sessionResult.input;
-                sessionLogFields = sessionResult.logFields;
-            }
-        }
-        const envValue = ((_b = this.currentContext) === null || _b === void 0 ? void 0 : _b.env) || '';
-        const graphValue = ((_c = this.currentContext) === null || _c === void 0 ? void 0 : _c.graph) || '';
-        const baseLogs = Object.assign({ product_tag: ((_d = this.currentContext) === null || _d === void 0 ? void 0 : _d.product) || '', workspace_id: ((_e = this.config) === null || _e === void 0 ? void 0 : _e.workspace_id) || '', env: envValue, app_env: envValue, process_id, type: logs_types_1.LogEventTypes.GRAPH, parent_tag: graphValue, child_tag: 'createRelationship', data: { type: resolvedOptions.type, operation: 'createRelationship', graph: graphValue, env: envValue, startNodeId: resolvedOptions.startNodeId, endNodeId: resolvedOptions.endNodeId, properties: resolvedOptions.properties } }, sessionLogFields);
-        (_f = this.logService) === null || _f === void 0 ? void 0 : _f.add(Object.assign(Object.assign({}, baseLogs), { start, message: 'Graph createRelationship - initiated', status: logs_types_1.LogEventStatus.PROCESSING }));
-        try {
-            const adapter = this.getAdapter();
-            const result = await adapter.createRelationship(resolvedOptions, transaction);
-            const end = Date.now();
-            (_g = this.logService) === null || _g === void 0 ? void 0 : _g.add(Object.assign(Object.assign({}, baseLogs), { start,
-                end, message: 'Graph createRelationship - success', successful_execution: true, status: logs_types_1.LogEventStatus.SUCCESS }));
-            (_h = this.logService) === null || _h === void 0 ? void 0 : _h.publish();
-            return result;
-        }
-        catch (error) {
-            const end = Date.now();
-            (_j = this.logService) === null || _j === void 0 ? void 0 : _j.add(Object.assign(Object.assign({}, baseLogs), { start,
-                end, message: 'Graph createRelationship - failed', failed_execution: true, data: { type: resolvedOptions.type, operation: 'createRelationship', error: String(error) }, status: logs_types_1.LogEventStatus.FAIL }));
-            await ((_k = this.logService) === null || _k === void 0 ? void 0 : _k.publish());
-            throw error;
-        }
-    }
-    /**
-     * Find relationships by criteria
-     * As documented in relationships.md
-     */
-    async findRelationships(options, transaction) {
-        var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k;
-        await this.ensureConnectionFor(options);
-        const process_id = (0, processor_utils_1.generateObjectId)();
-        const start = Date.now();
-        this.initializeLogService();
-        // Session log fields (will be populated if session is provided)
-        let sessionLogFields = {};
-        let resolvedOptions = options;
-        // Process session if provided
-        if (options.session && ((_a = this.currentContext) === null || _a === void 0 ? void 0 : _a.product)) {
-            const builder = await this.getProductBuilder(this.currentContext.product);
-            const privateKey = builder.fetchPrivateKey();
-            if (privateKey) {
-                const { processSessionForExecution } = await Promise.resolve().then(() => __importStar(require('../sessions')));
-                const sessionResult = await processSessionForExecution(options.session, privateKey, options, this.currentContext.env, {
-                    fetchSessionSelector: async (sessionTag) => {
-                        const sessionConfig = await builder.fetchSession(sessionTag);
-                        return sessionConfig === null || sessionConfig === void 0 ? void 0 : sessionConfig.selector;
-                    },
-                });
-                if (sessionResult.error) {
-                    throw new Error(`Session validation failed: ${sessionResult.error}`);
-                }
-                resolvedOptions = sessionResult.input;
-                sessionLogFields = sessionResult.logFields;
-            }
-        }
-        const envValue = ((_b = this.currentContext) === null || _b === void 0 ? void 0 : _b.env) || '';
-        const graphValue = ((_c = this.currentContext) === null || _c === void 0 ? void 0 : _c.graph) || '';
-        const baseLogs = Object.assign({ product_tag: ((_d = this.currentContext) === null || _d === void 0 ? void 0 : _d.product) || '', workspace_id: ((_e = this.config) === null || _e === void 0 ? void 0 : _e.workspace_id) || '', env: envValue, app_env: envValue, process_id, type: logs_types_1.LogEventTypes.GRAPH, parent_tag: graphValue, child_tag: 'findRelationships', data: { type: resolvedOptions.type, operation: 'findRelationships', graph: graphValue, env: envValue } }, sessionLogFields);
-        (_f = this.logService) === null || _f === void 0 ? void 0 : _f.add(Object.assign(Object.assign({}, baseLogs), { start, message: 'Graph findRelationships - initiated', status: logs_types_1.LogEventStatus.PROCESSING }));
-        try {
-            const adapter = this.getAdapter();
-            const result = await adapter.findRelationships(resolvedOptions, transaction);
-            const end = Date.now();
-            (_g = this.logService) === null || _g === void 0 ? void 0 : _g.add(Object.assign(Object.assign({}, baseLogs), { start,
-                end, message: 'Graph findRelationships - success', successful_execution: true, status: logs_types_1.LogEventStatus.SUCCESS }));
-            (_h = this.logService) === null || _h === void 0 ? void 0 : _h.publish();
-            return result;
-        }
-        catch (error) {
-            const end = Date.now();
-            (_j = this.logService) === null || _j === void 0 ? void 0 : _j.add(Object.assign(Object.assign({}, baseLogs), { start,
-                end, message: 'Graph findRelationships - failed', failed_execution: true, data: { type: resolvedOptions.type, operation: 'findRelationships', error: String(error) }, status: logs_types_1.LogEventStatus.FAIL }));
-            await ((_k = this.logService) === null || _k === void 0 ? void 0 : _k.publish());
-            throw error;
-        }
-    }
-    /**
-     * Find a relationship by ID
-     */
-    async findRelationshipById(id, transaction) {
-        return this.executeWithRetry(async () => {
-            const adapter = this.getAdapter();
-            return adapter.findRelationshipById(id, transaction);
-        });
-    }
-    /**
-     * Update a relationship
-     * As documented in relationships.md
-     */
-    async updateRelationship(options, transaction) {
-        var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k;
-        await this.ensureConnectionFor(options);
-        const process_id = (0, processor_utils_1.generateObjectId)();
-        const start = Date.now();
-        this.initializeLogService();
-        // Session log fields (will be populated if session is provided)
-        let sessionLogFields = {};
-        let resolvedOptions = options;
-        // Process session if provided
-        if (options.session && ((_a = this.currentContext) === null || _a === void 0 ? void 0 : _a.product)) {
-            const builder = await this.getProductBuilder(this.currentContext.product);
-            const privateKey = builder.fetchPrivateKey();
-            if (privateKey) {
-                const { processSessionForExecution } = await Promise.resolve().then(() => __importStar(require('../sessions')));
-                const sessionResult = await processSessionForExecution(options.session, privateKey, options, this.currentContext.env, {
-                    fetchSessionSelector: async (sessionTag) => {
-                        const sessionConfig = await builder.fetchSession(sessionTag);
-                        return sessionConfig === null || sessionConfig === void 0 ? void 0 : sessionConfig.selector;
-                    },
-                });
-                if (sessionResult.error) {
-                    throw new Error(`Session validation failed: ${sessionResult.error}`);
-                }
-                resolvedOptions = sessionResult.input;
-                sessionLogFields = sessionResult.logFields;
-            }
-        }
-        const envValue = ((_b = this.currentContext) === null || _b === void 0 ? void 0 : _b.env) || '';
-        const graphValue = ((_c = this.currentContext) === null || _c === void 0 ? void 0 : _c.graph) || '';
-        const baseLogs = Object.assign({ product_tag: ((_d = this.currentContext) === null || _d === void 0 ? void 0 : _d.product) || '', workspace_id: ((_e = this.config) === null || _e === void 0 ? void 0 : _e.workspace_id) || '', env: envValue, app_env: envValue, process_id, type: logs_types_1.LogEventTypes.GRAPH, parent_tag: graphValue, child_tag: 'updateRelationship', data: { id: resolvedOptions.id, operation: 'updateRelationship', graph: graphValue, env: envValue } }, sessionLogFields);
-        (_f = this.logService) === null || _f === void 0 ? void 0 : _f.add(Object.assign(Object.assign({}, baseLogs), { start, message: 'Graph updateRelationship - initiated', status: logs_types_1.LogEventStatus.PROCESSING }));
-        try {
-            const adapter = this.getAdapter();
-            const result = await adapter.updateRelationship(resolvedOptions, transaction);
-            const end = Date.now();
-            (_g = this.logService) === null || _g === void 0 ? void 0 : _g.add(Object.assign(Object.assign({}, baseLogs), { start,
-                end, message: 'Graph updateRelationship - success', successful_execution: true, status: logs_types_1.LogEventStatus.SUCCESS }));
-            (_h = this.logService) === null || _h === void 0 ? void 0 : _h.publish();
-            return result;
-        }
-        catch (error) {
-            const end = Date.now();
-            (_j = this.logService) === null || _j === void 0 ? void 0 : _j.add(Object.assign(Object.assign({}, baseLogs), { start,
-                end, message: 'Graph updateRelationship - failed', failed_execution: true, data: { id: resolvedOptions.id, operation: 'updateRelationship', error: String(error) }, status: logs_types_1.LogEventStatus.FAIL }));
-            await ((_k = this.logService) === null || _k === void 0 ? void 0 : _k.publish());
-            throw error;
-        }
-    }
-    /**
-     * Delete a relationship
-     * As documented in relationships.md
-     */
-    async deleteRelationship(options, transaction) {
-        var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k;
-        await this.ensureConnectionFor(options);
-        const process_id = (0, processor_utils_1.generateObjectId)();
-        const start = Date.now();
-        this.initializeLogService();
-        // Session log fields (will be populated if session is provided)
-        let sessionLogFields = {};
-        let resolvedOptions = options;
-        // Process session if provided
-        if (options.session && ((_a = this.currentContext) === null || _a === void 0 ? void 0 : _a.product)) {
-            const builder = await this.getProductBuilder(this.currentContext.product);
-            const privateKey = builder.fetchPrivateKey();
-            if (privateKey) {
-                const { processSessionForExecution } = await Promise.resolve().then(() => __importStar(require('../sessions')));
-                const sessionResult = await processSessionForExecution(options.session, privateKey, options, this.currentContext.env, {
-                    fetchSessionSelector: async (sessionTag) => {
-                        const sessionConfig = await builder.fetchSession(sessionTag);
-                        return sessionConfig === null || sessionConfig === void 0 ? void 0 : sessionConfig.selector;
-                    },
-                });
-                if (sessionResult.error) {
-                    throw new Error(`Session validation failed: ${sessionResult.error}`);
-                }
-                resolvedOptions = sessionResult.input;
-                sessionLogFields = sessionResult.logFields;
-            }
-        }
-        const envValue = ((_b = this.currentContext) === null || _b === void 0 ? void 0 : _b.env) || '';
-        const graphValue = ((_c = this.currentContext) === null || _c === void 0 ? void 0 : _c.graph) || '';
-        const baseLogs = Object.assign({ product_tag: ((_d = this.currentContext) === null || _d === void 0 ? void 0 : _d.product) || '', workspace_id: ((_e = this.config) === null || _e === void 0 ? void 0 : _e.workspace_id) || '', env: envValue, app_env: envValue, process_id, type: logs_types_1.LogEventTypes.GRAPH, parent_tag: graphValue, child_tag: 'deleteRelationship', data: { id: resolvedOptions.id, operation: 'deleteRelationship', graph: graphValue, env: envValue } }, sessionLogFields);
-        (_f = this.logService) === null || _f === void 0 ? void 0 : _f.add(Object.assign(Object.assign({}, baseLogs), { start, message: 'Graph deleteRelationship - initiated', status: logs_types_1.LogEventStatus.PROCESSING }));
-        try {
-            const adapter = this.getAdapter();
-            const result = await adapter.deleteRelationship(resolvedOptions, transaction);
-            const end = Date.now();
-            (_g = this.logService) === null || _g === void 0 ? void 0 : _g.add(Object.assign(Object.assign({}, baseLogs), { start,
-                end, message: 'Graph deleteRelationship - success', successful_execution: true, status: logs_types_1.LogEventStatus.SUCCESS }));
-            (_h = this.logService) === null || _h === void 0 ? void 0 : _h.publish();
-            return result;
-        }
-        catch (error) {
-            const end = Date.now();
-            (_j = this.logService) === null || _j === void 0 ? void 0 : _j.add(Object.assign(Object.assign({}, baseLogs), { start,
-                end, message: 'Graph deleteRelationship - failed', failed_execution: true, data: { id: resolvedOptions.id, operation: 'deleteRelationship', error: String(error) }, status: logs_types_1.LogEventStatus.FAIL }));
-            await ((_k = this.logService) === null || _k === void 0 ? void 0 : _k.publish());
-            throw error;
-        }
-    }
-    /**
-     * Merge (upsert) a relationship
-     * As documented in relationships.md
-     */
-    async mergeRelationship(options, transaction) {
-        await this.ensureConnectionFor(options);
-        return this.executeWithRetry(async () => {
-            const adapter = this.getAdapter();
-            return adapter.mergeRelationship(options, transaction);
-        });
-    }
-    // ==================== TRAVERSAL OPERATIONS ====================
-    /**
-     * Traverse the graph from a starting node
-     * As documented in traversals.md
-     */
-    async traverse(options, transaction) {
-        var _a, _b, _c, _d, _e, _f, _g, _h, _j;
-        await this.ensureConnectionFor(options);
-        const process_id = (0, processor_utils_1.generateObjectId)();
-        const start = Date.now();
-        this.initializeLogService();
-        const envValue = ((_a = this.currentContext) === null || _a === void 0 ? void 0 : _a.env) || '';
-        const graphValue = ((_b = this.currentContext) === null || _b === void 0 ? void 0 : _b.graph) || '';
-        const baseLogs = {
-            product_tag: ((_c = this.currentContext) === null || _c === void 0 ? void 0 : _c.product) || '',
-            workspace_id: ((_d = this.config) === null || _d === void 0 ? void 0 : _d.workspace_id) || '',
-            env: envValue,
-            app_env: envValue,
-            process_id,
-            type: logs_types_1.LogEventTypes.GRAPH,
-            parent_tag: graphValue,
-            child_tag: 'traverse',
-            data: { startNodeId: options.startNodeId, operation: 'traverse', graph: graphValue, env: envValue, direction: options.direction, maxDepth: options.maxDepth, relationshipTypes: options.relationshipTypes },
-        };
-        (_e = this.logService) === null || _e === void 0 ? void 0 : _e.add(Object.assign(Object.assign({}, baseLogs), { start, message: 'Graph traverse - initiated', status: logs_types_1.LogEventStatus.PROCESSING }));
-        try {
-            const adapter = this.getAdapter();
-            const result = await adapter.traverse(options, transaction);
-            const end = Date.now();
-            (_f = this.logService) === null || _f === void 0 ? void 0 : _f.add(Object.assign(Object.assign({}, baseLogs), { start,
-                end, message: 'Graph traverse - success', successful_execution: true, status: logs_types_1.LogEventStatus.SUCCESS }));
-            (_g = this.logService) === null || _g === void 0 ? void 0 : _g.publish();
-            return result;
-        }
-        catch (error) {
-            const end = Date.now();
-            (_h = this.logService) === null || _h === void 0 ? void 0 : _h.add(Object.assign(Object.assign({}, baseLogs), { start,
-                end, message: 'Graph traverse - failed', failed_execution: true, data: { startNodeId: options.startNodeId, operation: 'traverse', error: String(error) }, status: logs_types_1.LogEventStatus.FAIL }));
-            await ((_j = this.logService) === null || _j === void 0 ? void 0 : _j.publish());
-            throw error;
-        }
-    }
-    /**
-     * Find the shortest path between two nodes
-     * As documented in traversals.md
-     */
-    async shortestPath(options, transaction) {
-        await this.ensureConnectionFor(options);
-        return this.executeWithRetry(async () => {
-            const adapter = this.getAdapter();
-            return adapter.shortestPath(options, transaction);
-        });
-    }
-    /**
-     * Find all paths between two nodes
-     * As documented in traversals.md
-     */
-    async allPaths(options, transaction) {
-        await this.ensureConnectionFor(options);
-        return this.executeWithRetry(async () => {
-            const adapter = this.getAdapter();
-            return adapter.allPaths(options, transaction);
-        });
-    }
-    /**
-     * Get the neighborhood of a node
-     * As documented in traversals.md
-     */
-    async getNeighborhood(options, transaction) {
-        await this.ensureConnectionFor(options);
-        return this.executeWithRetry(async () => {
-            const adapter = this.getAdapter();
-            return adapter.getNeighborhood(options, transaction);
-        });
-    }
-    /**
-     * Find connected components in the graph
-     * As documented in traversals.md
-     */
-    async findConnectedComponents(options, transaction) {
-        await this.ensureConnectionFor(options);
-        return this.executeWithRetry(async () => {
-            const adapter = this.getAdapter();
-            return adapter.findConnectedComponents(options, transaction);
-        });
-    }
-    // ==================== AGGREGATION OPERATIONS ====================
-    /**
-     * Count nodes matching criteria
-     * As documented in overview.md
-     */
-    async countNodes(labels, where, transaction, session) {
-        var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k;
-        const process_id = (0, processor_utils_1.generateObjectId)();
-        const start = Date.now();
-        this.initializeLogService();
-        // Session log fields (will be populated if session is provided)
-        let sessionLogFields = {};
-        let resolvedWhere = where;
-        // Process session if provided
-        if (session && ((_a = this.currentContext) === null || _a === void 0 ? void 0 : _a.product)) {
-            const builder = await this.getProductBuilder(this.currentContext.product);
-            const privateKey = builder.fetchPrivateKey();
-            if (privateKey) {
-                const { processSessionForExecution } = await Promise.resolve().then(() => __importStar(require('../sessions')));
-                const sessionResult = await processSessionForExecution(session, privateKey, { where }, this.currentContext.env, {
-                    fetchSessionSelector: async (sessionTag) => {
-                        const sessionConfig = await builder.fetchSession(sessionTag);
-                        return sessionConfig === null || sessionConfig === void 0 ? void 0 : sessionConfig.selector;
-                    },
-                });
-                if (sessionResult.error) {
-                    throw new Error(`Session validation failed: ${sessionResult.error}`);
-                }
-                resolvedWhere = sessionResult.input.where;
-                sessionLogFields = sessionResult.logFields;
-            }
-        }
-        const envValue = ((_b = this.currentContext) === null || _b === void 0 ? void 0 : _b.env) || '';
-        const graphValue = ((_c = this.currentContext) === null || _c === void 0 ? void 0 : _c.graph) || '';
-        const baseLogs = Object.assign({ product_tag: ((_d = this.currentContext) === null || _d === void 0 ? void 0 : _d.product) || '', workspace_id: ((_e = this.config) === null || _e === void 0 ? void 0 : _e.workspace_id) || '', env: envValue, app_env: envValue, process_id, type: logs_types_1.LogEventTypes.GRAPH, parent_tag: graphValue, child_tag: 'countNodes', data: { labels, operation: 'countNodes', graph: graphValue, env: envValue } }, sessionLogFields);
-        (_f = this.logService) === null || _f === void 0 ? void 0 : _f.add(Object.assign(Object.assign({}, baseLogs), { start, message: 'Graph countNodes - initiated', status: logs_types_1.LogEventStatus.PROCESSING }));
-        try {
-            const adapter = this.getAdapter();
-            const result = await adapter.countNodes(labels, resolvedWhere, transaction);
-            const end = Date.now();
-            (_g = this.logService) === null || _g === void 0 ? void 0 : _g.add(Object.assign(Object.assign({}, baseLogs), { start,
-                end, message: 'Graph countNodes - success', successful_execution: true, status: logs_types_1.LogEventStatus.SUCCESS }));
-            (_h = this.logService) === null || _h === void 0 ? void 0 : _h.publish();
-            return result;
-        }
-        catch (error) {
-            const end = Date.now();
-            (_j = this.logService) === null || _j === void 0 ? void 0 : _j.add(Object.assign(Object.assign({}, baseLogs), { start,
-                end, message: 'Graph countNodes - failed', failed_execution: true, data: { labels, operation: 'countNodes', error: String(error) }, status: logs_types_1.LogEventStatus.FAIL }));
-            await ((_k = this.logService) === null || _k === void 0 ? void 0 : _k.publish());
-            throw error;
-        }
-    }
-    /**
-     * Count relationships matching criteria
-     * As documented in overview.md
-     */
-    async countRelationships(types, where, transaction) {
-        return this.executeWithRetry(async () => {
-            const adapter = this.getAdapter();
-            return adapter.countRelationships(types, where, transaction);
-        });
-    }
-    /**
-     * Get graph statistics
-     * As documented in overview.md
-     */
-    async getStatistics(transaction, session) {
-        var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k;
-        const process_id = (0, processor_utils_1.generateObjectId)();
-        const start = Date.now();
-        this.initializeLogService();
-        // Session log fields (will be populated if session is provided)
-        let sessionLogFields = {};
-        // Process session if provided
-        if (session && ((_a = this.currentContext) === null || _a === void 0 ? void 0 : _a.product)) {
-            const builder = await this.getProductBuilder(this.currentContext.product);
-            const privateKey = builder.fetchPrivateKey();
-            if (privateKey) {
-                const { processSessionForExecution } = await Promise.resolve().then(() => __importStar(require('../sessions')));
-                const sessionResult = await processSessionForExecution(session, privateKey, {}, this.currentContext.env, {
-                    fetchSessionSelector: async (sessionTag) => {
-                        const sessionConfig = await builder.fetchSession(sessionTag);
-                        return sessionConfig === null || sessionConfig === void 0 ? void 0 : sessionConfig.selector;
-                    },
-                });
-                if (sessionResult.error) {
-                    throw new Error(`Session validation failed: ${sessionResult.error}`);
-                }
-                sessionLogFields = sessionResult.logFields;
-            }
-        }
-        const envValue = ((_b = this.currentContext) === null || _b === void 0 ? void 0 : _b.env) || '';
-        const graphValue = ((_c = this.currentContext) === null || _c === void 0 ? void 0 : _c.graph) || '';
-        const baseLogs = Object.assign({ product_tag: ((_d = this.currentContext) === null || _d === void 0 ? void 0 : _d.product) || '', workspace_id: ((_e = this.config) === null || _e === void 0 ? void 0 : _e.workspace_id) || '', env: envValue, app_env: envValue, process_id, type: logs_types_1.LogEventTypes.GRAPH, parent_tag: graphValue, child_tag: 'getStatistics', data: { operation: 'getStatistics', graph: graphValue, env: envValue } }, sessionLogFields);
-        (_f = this.logService) === null || _f === void 0 ? void 0 : _f.add(Object.assign(Object.assign({}, baseLogs), { start, message: 'Graph getStatistics - initiated', status: logs_types_1.LogEventStatus.PROCESSING }));
-        try {
-            const adapter = this.getAdapter();
-            const result = await adapter.getStatistics(transaction);
-            const end = Date.now();
-            (_g = this.logService) === null || _g === void 0 ? void 0 : _g.add(Object.assign(Object.assign({}, baseLogs), { start,
-                end, message: 'Graph getStatistics - success', successful_execution: true, status: logs_types_1.LogEventStatus.SUCCESS }));
-            (_h = this.logService) === null || _h === void 0 ? void 0 : _h.publish();
-            return result;
-        }
-        catch (error) {
-            const end = Date.now();
-            (_j = this.logService) === null || _j === void 0 ? void 0 : _j.add(Object.assign(Object.assign({}, baseLogs), { start,
-                end, message: 'Graph getStatistics - failed', failed_execution: true, data: { operation: 'getStatistics', error: String(error) }, status: logs_types_1.LogEventStatus.FAIL }));
-            await ((_k = this.logService) === null || _k === void 0 ? void 0 : _k.publish());
-            throw error;
-        }
-    }
-    // ==================== SEARCH OPERATIONS ====================
-    /**
-     * Full-text search
-     * As documented in overview.md
-     */
-    async fullTextSearch(options, transaction) {
-        return this.executeWithRetry(async () => {
-            const adapter = this.getAdapter();
-            return adapter.fullTextSearch(options, transaction);
-        });
-    }
-    /**
-     * Vector similarity search
-     * As documented in overview.md
-     */
-    async vectorSearch(options, transaction) {
-        return this.executeWithRetry(async () => {
-            const adapter = this.getAdapter();
-            return adapter.vectorSearch(options, transaction);
-        });
-    }
-    // ==================== RAW QUERY ====================
-    /**
-     * Execute a raw query
-     * As documented in overview.md
-     *
-     * @example
-     * ```ts
-     * const result = await ductape.graph.query(
-     *   'MATCH (p:Person)-[:FRIENDS_WITH]->(f) WHERE p.name = $name RETURN f',
-     *   { name: 'Alice' }
-     * );
-     * ```
-     */
-    async query(queryString, params, transaction) {
-        var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k;
-        const process_id = (0, processor_utils_1.generateObjectId)();
-        const start = Date.now();
-        this.initializeLogService();
-        const envValue = ((_a = this.currentContext) === null || _a === void 0 ? void 0 : _a.env) || '';
-        const graphValue = ((_b = this.currentContext) === null || _b === void 0 ? void 0 : _b.graph) || '';
-        const baseLogs = {
-            product_tag: ((_c = this.currentContext) === null || _c === void 0 ? void 0 : _c.product) || '',
-            workspace_id: ((_d = this.config) === null || _d === void 0 ? void 0 : _d.workspace_id) || '',
-            env: envValue,
-            app_env: envValue,
-            process_id,
-            type: logs_types_1.LogEventTypes.GRAPH,
-            parent_tag: graphValue,
-            child_tag: 'query',
-            data: { operation: 'query', graph: graphValue, env: envValue, query: queryString.substring(0, 200) },
-        };
-        (_e = this.logService) === null || _e === void 0 ? void 0 : _e.add(Object.assign(Object.assign({}, baseLogs), { start, message: 'Graph query - initiated', status: logs_types_1.LogEventStatus.PROCESSING }));
-        try {
-            const result = await this.executeWithRetry(async () => {
-                const adapter = this.getAdapter();
-                return adapter.query({ query: queryString, params }, transaction);
-            });
-            const end = Date.now();
-            (_f = this.logService) === null || _f === void 0 ? void 0 : _f.add(Object.assign(Object.assign({}, baseLogs), { start,
-                end, message: 'Graph query - success', successful_execution: true, status: logs_types_1.LogEventStatus.SUCCESS, data: { operation: 'query', graph: graphValue, env: envValue, recordCount: ((_g = result.records) === null || _g === void 0 ? void 0 : _g.length) || 0 } }));
-            (_h = this.logService) === null || _h === void 0 ? void 0 : _h.publish();
-            return result;
-        }
-        catch (error) {
-            const end = Date.now();
-            (_j = this.logService) === null || _j === void 0 ? void 0 : _j.add(Object.assign(Object.assign({}, baseLogs), { start,
-                end, message: 'Graph query - failed', failed_execution: true, data: { operation: 'query', graph: graphValue, env: envValue, error: String(error) }, status: logs_types_1.LogEventStatus.FAIL }));
-            await ((_k = this.logService) === null || _k === void 0 ? void 0 : _k.publish());
-            throw error;
-        }
-    }
-    // ==================== SCHEMA OPERATIONS ====================
-    /**
-     * Create a node index
-     * As documented in overview.md
-     */
-    async createNodeIndex(options) {
-        await this.ensureConnectionFor(options);
-        return this.executeWithRetry(async () => {
-            const adapter = this.getAdapter();
-            return adapter.createNodeIndex(options);
-        });
-    }
-    /**
-     * Create a node constraint
-     * As documented in overview.md
-     */
-    async createNodeConstraint(options) {
-        await this.ensureConnectionFor(options);
-        return this.executeWithRetry(async () => {
-            const adapter = this.getAdapter();
-            return adapter.createNodeConstraint(options);
-        });
-    }
-    /**
-     * Create a relationship index
-     */
-    async createRelationshipIndex(options) {
-        await this.ensureConnectionFor(options);
-        return this.executeWithRetry(async () => {
-            const adapter = this.getAdapter();
-            return adapter.createRelationshipIndex(options);
-        });
-    }
-    /**
-     * List all indexes
-     * As documented in overview.md
-     */
-    async listIndexes() {
-        return this.executeWithRetry(async () => {
-            const adapter = this.getAdapter();
-            return adapter.listIndexes();
-        });
-    }
-    /**
-     * List all constraints
-     */
-    async listConstraints() {
-        return this.executeWithRetry(async () => {
-            const adapter = this.getAdapter();
-            return adapter.listConstraints();
-        });
-    }
-    /**
-     * Drop an index
-     */
-    async dropIndex(name) {
-        return this.executeWithRetry(async () => {
-            const adapter = this.getAdapter();
-            return adapter.dropIndex(name);
-        });
-    }
-    /**
-     * Drop a constraint
-     */
-    async dropConstraint(name) {
-        return this.executeWithRetry(async () => {
-            const adapter = this.getAdapter();
-            return adapter.dropConstraint(name);
-        });
-    }
-    // ==================== SCHEMA INTROSPECTION ====================
-    /**
-     * List all node labels with counts and property information
-     * Used for GraphExplorer sidebar
-     */
-    async listLabels() {
-        return this.executeWithRetry(async () => {
-            const adapter = this.getAdapter();
-            return adapter.listLabels();
-        });
-    }
-    /**
-     * List all relationship types with counts
-     * Used for GraphExplorer sidebar
-     */
-    async listRelationshipTypes() {
-        return this.executeWithRetry(async () => {
-            const adapter = this.getAdapter();
-            return adapter.listRelationshipTypes();
-        });
-    }
-    /**
-     * Generate a URL-safe tag from a name
-     */
-    generateActionTag(name) {
-        return name
-            .toLowerCase()
-            .replace(/[^a-z0-9]+/g, '-')
-            .replace(/^-+|-+$/g, '');
-    }
-    /**
-     * Create a new graph action (saved parameterized query)
-     *
-     * @example
-     * ```ts
-     * const action = await graphService.createAction({
-     *   name: 'Find Persons',
-     *   description: 'Find persons with configurable limit',
-     *   operation: 'findNodes',
-     *   query: {
-     *     operation: 'findNodes',
-     *     options: { labels: ['Person'], limit: '{{limit}}' }
-     *   },
-     *   parameters: [
-     *     { name: 'limit', path: 'options.limit', defaultValue: 25, type: 'number' }
-     *   ]
-     * }, 'my-product');
-     * ```
-     */
-    async createAction(options, productTag) {
-        var _a;
-        const graphTag = options.graphTag || ((_a = this.currentContext) === null || _a === void 0 ? void 0 : _a.graph);
-        if (!graphTag) {
-            throw graph_error_1.GraphError.configurationError('No graph specified. Please connect first or provide graphTag.');
-        }
-        const actionTag = this.generateActionTag(options.name);
-        const now = new Date().toISOString();
-        const action = {
-            id: `action_${Date.now()}_${Math.random().toString(36).substring(2, 9)}`,
-            tag: actionTag,
-            name: options.name,
-            description: options.description,
-            operation: options.operation,
-            query: options.query,
-            parameters: options.parameters,
-            createdAt: now,
-            graphTag,
-        };
-        // If productTag is provided, persist to backend using ProductBuilder
-        if (productTag) {
-            try {
-                const builder = await this.getProductBuilder(productTag);
-                await builder.createGraphAction(graphTag, action);
-            }
-            catch (error) {
-                // Fall back to local storage if API fails
-                console.warn('Failed to persist action to backend, storing locally:', error);
-            }
-        }
-        // Store locally
-        const graphActions = this.actions.get(graphTag) || [];
-        graphActions.push(action);
-        this.actions.set(graphTag, graphActions);
-        return action;
-    }
-    /**
-     * List all actions for a graph
-     */
-    async listActions(graphTag, productTag) {
-        var _a;
-        const tag = graphTag || ((_a = this.currentContext) === null || _a === void 0 ? void 0 : _a.graph);
-        if (!tag) {
-            throw graph_error_1.GraphError.configurationError('No graph specified. Please connect first or provide graphTag.');
-        }
-        // If productTag is provided, fetch from backend using ProductBuilder
-        if (productTag) {
-            try {
-                const builder = await this.getProductBuilder(productTag);
-                const actions = await builder.fetchGraphActions(tag);
-                // Update local cache
-                this.actions.set(tag, actions);
-                return { actions };
-            }
-            catch (error) {
-                // Fall back to local cache
-                console.warn('Failed to fetch actions from backend, using local cache:', error);
-            }
-        }
-        const actions = this.actions.get(tag) || [];
-        return { actions };
-    }
-    /**
-     * Get a specific action by tag
-     */
-    async getAction(actionTag, graphTag, productTag) {
-        var _a;
-        const tag = graphTag || ((_a = this.currentContext) === null || _a === void 0 ? void 0 : _a.graph);
-        if (!tag) {
-            throw graph_error_1.GraphError.configurationError('No graph specified. Please connect first or provide graphTag.');
-        }
-        // If productTag is provided, fetch from backend using ProductBuilder
-        if (productTag) {
-            try {
-                const builder = await this.getProductBuilder(productTag);
-                const action = await builder.fetchGraphAction(tag, actionTag);
-                if (action) {
-                    // Update local cache
-                    const actions = this.actions.get(tag) || [];
-                    const existingIndex = actions.findIndex((a) => a.tag === actionTag);
-                    if (existingIndex >= 0) {
-                        actions[existingIndex] = action;
-                    }
-                    else {
-                        actions.push(action);
-                    }
-                    this.actions.set(tag, actions);
-                    return action;
-                }
-            }
-            catch (error) {
-                // Fall back to local cache
-                console.warn('Failed to fetch action from backend, using local cache:', error);
-            }
-        }
-        const actions = this.actions.get(tag) || [];
-        return actions.find((a) => a.tag === actionTag) || null;
-    }
-    /**
-     * Update an existing action
-     */
-    async updateAction(actionTag, updates, graphTag, productTag) {
-        var _a, _b, _c, _d, _e;
-        const tag = graphTag || ((_a = this.currentContext) === null || _a === void 0 ? void 0 : _a.graph);
-        if (!tag) {
-            throw graph_error_1.GraphError.configurationError('No graph specified. Please connect first or provide graphTag.');
-        }
-        const actions = this.actions.get(tag) || [];
-        const index = actions.findIndex((a) => a.tag === actionTag);
-        if (index === -1) {
-            throw graph_error_1.GraphError.notFoundError(`Action '${actionTag}' not found`);
-        }
-        const existing = actions[index];
-        const updated = Object.assign(Object.assign({}, existing), { name: (_b = updates.name) !== null && _b !== void 0 ? _b : existing.name, description: (_c = updates.description) !== null && _c !== void 0 ? _c : existing.description, query: (_d = updates.query) !== null && _d !== void 0 ? _d : existing.query, parameters: (_e = updates.parameters) !== null && _e !== void 0 ? _e : existing.parameters, updatedAt: new Date().toISOString() });
-        // If productTag is provided, persist to backend using ProductBuilder
-        if (productTag) {
-            try {
-                const builder = await this.getProductBuilder(productTag);
-                await builder.updateGraphAction(tag, actionTag, updated);
-            }
-            catch (error) {
-                console.warn('Failed to update action in backend:', error);
-            }
-        }
-        actions[index] = updated;
-        this.actions.set(tag, actions);
-        return updated;
-    }
-    /**
-     * Delete an action
-     */
-    async deleteAction(actionTag, graphTag, productTag) {
-        var _a;
-        const tag = graphTag || ((_a = this.currentContext) === null || _a === void 0 ? void 0 : _a.graph);
-        if (!tag) {
-            throw graph_error_1.GraphError.configurationError('No graph specified. Please connect first or provide graphTag.');
-        }
-        // If productTag is provided, delete from backend using ProductBuilder
-        if (productTag) {
-            try {
-                const builder = await this.getProductBuilder(productTag);
-                await builder.deleteGraphAction(tag, actionTag);
-            }
-            catch (error) {
-                console.warn('Failed to delete action from backend:', error);
-            }
-        }
-        const actions = this.actions.get(tag) || [];
-        const filtered = actions.filter((a) => a.tag !== actionTag);
-        if (filtered.length === actions.length) {
-            throw graph_error_1.GraphError.notFoundError(`Action '${actionTag}' not found`);
-        }
-        this.actions.set(tag, filtered);
-    }
-    /**
-     * Execute a graph action with parameter substitution
-     *
-     * @example
-     * ```ts
-     * const result = await graphService.execute({
-     *   product: 'my-app',
-     *   env: 'dev',
-     *   graph: 'social-graph',
-     *   action: 'find-persons',
-     *   input: { limit: 50 }
-     * });
-     * ```
-     */
-    async execute(options) {
-        var _a, _b, _c, _d, _e, _f, _g, _h;
-        const process_id = (0, processor_utils_1.generateObjectId)();
-        const startTime = Date.now();
-        // Session log fields (will be populated if session is provided)
-        let sessionLogFields = {};
-        let resolvedOptions = options;
-        // Initialize product builder and logging
-        if (options.product) {
-            const builder = await this.getProductBuilder(options.product);
-            // Process session if provided
-            if (options.session) {
-                const privateKey = builder.fetchPrivateKey();
-                if (privateKey) {
-                    const { processSessionForExecution } = await Promise.resolve().then(() => __importStar(require('../sessions')));
-                    const sessionResult = await processSessionForExecution(options.session, privateKey, options, options.env, {
-                        fetchSessionSelector: async (sessionTag) => {
-                            const sessionConfig = await builder.fetchSession(sessionTag);
-                            return sessionConfig === null || sessionConfig === void 0 ? void 0 : sessionConfig.selector;
-                        },
-                    });
-                    if (sessionResult.error) {
-                        throw new Error(`Session validation failed: ${sessionResult.error}`);
-                    }
-                    resolvedOptions = sessionResult.input;
-                    sessionLogFields = sessionResult.logFields;
-                }
-            }
-        }
-        this.initializeLogService();
-        const baseLogs = Object.assign({ product_tag: options.product || '', workspace_id: ((_a = this.config) === null || _a === void 0 ? void 0 : _a.workspace_id) || '', env: options.env, process_id, type: logs_types_1.LogEventTypes.GRAPH, parent_tag: options.graph, child_tag: options.action, data: { graph: options.graph, action: options.action, operation: 'execute' } }, sessionLogFields);
-        (_b = this.logService) === null || _b === void 0 ? void 0 : _b.add(Object.assign(Object.assign({}, baseLogs), { start: startTime, message: 'Graph action execute - initiated', status: logs_types_1.LogEventStatus.PROCESSING }));
-        // Get the action
-        const action = await this.getAction(resolvedOptions.action, resolvedOptions.graph);
-        if (!action) {
-            const end = Date.now();
-            (_c = this.logService) === null || _c === void 0 ? void 0 : _c.add(Object.assign(Object.assign({}, baseLogs), { start: startTime, end, message: 'Graph action execute - failed', failed_execution: true, data: { graph: options.graph, action: options.action, error: `Action '${options.action}' not found` }, status: logs_types_1.LogEventStatus.FAIL }));
-            await ((_d = this.logService) === null || _d === void 0 ? void 0 : _d.publish());
-            return {
-                success: false,
-                executionTime: end - startTime,
-                data: [],
-                count: 0,
-                error: `Action '${options.action}' not found`,
-            };
-        }
-        try {
-            // Build the query with parameter substitution
-            const query = this.substituteParameters(action.query, action.parameters, resolvedOptions.input || {});
-            // Execute based on operation type
-            const result = await this.executeOperation(query);
-            const end = Date.now();
-            (_e = this.logService) === null || _e === void 0 ? void 0 : _e.add(Object.assign(Object.assign({}, baseLogs), { start: startTime, end, message: 'Graph action execute - success', successful_execution: true, status: logs_types_1.LogEventStatus.SUCCESS }));
-            (_f = this.logService) === null || _f === void 0 ? void 0 : _f.publish();
-            return {
-                success: true,
-                executionTime: end - startTime,
-                data: result.data,
-                count: result.data.length,
-            };
-        }
-        catch (error) {
-            const end = Date.now();
-            (_g = this.logService) === null || _g === void 0 ? void 0 : _g.add(Object.assign(Object.assign({}, baseLogs), { start: startTime, end, message: 'Graph action execute - failed', failed_execution: true, data: { graph: options.graph, action: options.action, error: error.message || 'Execution failed' }, status: logs_types_1.LogEventStatus.FAIL }));
-            await ((_h = this.logService) === null || _h === void 0 ? void 0 : _h.publish());
-            return {
-                success: false,
-                executionTime: end - startTime,
-                data: [],
-                count: 0,
-                error: error.message || 'Execution failed',
-            };
-        }
-    }
-    // ==================== DISPATCH OPERATIONS ====================
-    /**
-     * Action dispatch operations - for predefined graph actions.
-     */
-    get action() {
-        return {
-            /**
-             * Dispatches a graph action to run as a scheduled job.
-             * @param {IGraphActionDispatchInput} data - The graph action dispatch input.
-             * @returns {Promise<IDispatchResult>} The dispatch result with job ID and status.
-             * @example
-             * // Schedule a graph action to run in 1 hour
-             * await ductape.graph.action.dispatch({
-             *   product: 'my-product',
-             *   env: 'production',
-             *   graph: 'social-graph',
-             *   event: 'compute-recommendations',
-             *   input: { userId: '123', limit: 10 },
-             *   schedule: { start_at: Date.now() + 3600000 }
-             * });
-             *
-             * // Run on a cron schedule
-             * await ductape.graph.action.dispatch({
-             *   product: 'my-product',
-             *   env: 'production',
-             *   graph: 'analytics-graph',
-             *   event: 'aggregate-metrics',
-             *   input: {},
-             *   schedule: { cron: '0 0 * * *' } // Daily at midnight
-             * });
-             */
-            dispatch: async (data) => {
-                const processorService = this.createNewProcessor();
-                const productBuilder = await this.getProductBuilder(data.product);
-                const schedule = data.schedule || {};
-                const startAt = typeof schedule.start_at === 'string'
-                    ? new Date(schedule.start_at).getTime()
-                    : schedule.start_at || Date.now();
-                // Generate job tag based on type, graph, and event
-                const jobTag = `graph-action:${data.graph}:${data.event}`;
-                // Check if job exists, if not create it
-                const existingJob = await productBuilder.fetchJob(jobTag);
-                if (!existingJob) {
-                    await productBuilder.createJob({
-                        tag: jobTag,
-                        name: `Graph Action: ${data.graph}/${data.event}`,
-                        description: `Auto-created job for graph action ${data.event} on graph ${data.graph}`,
-                        type: productsBuilder_types_1.JobEventTypes.GRAPH_ACTION,
-                        app: data.graph,
-                        event: data.event,
-                        executions: 0,
-                        intervals: schedule.every || 0,
-                        start_at: startAt,
-                    });
-                }
-                const jobInput = {
-                    product: data.product,
-                    env: data.env,
-                    event: jobTag,
-                    input: data.input,
-                    retries: data.retries || 0,
-                    start_at: startAt,
-                    session: data.session,
-                    cache: data.cache,
-                    repeat: schedule.cron || schedule.every
-                        ? {
-                            cron: schedule.cron,
-                            every: schedule.every,
-                            limit: schedule.limit,
-                            endDate: schedule.endDate,
-                            tz: schedule.tz,
-                        }
-                        : undefined,
-                };
-                await processorService.processJob(jobInput);
-                const isRecurring = !!(schedule.cron || schedule.every);
-                let nextRunAt;
-                if (isRecurring && schedule.every) {
-                    nextRunAt = startAt + schedule.every;
-                }
-                return {
-                    job_id: (0, crypto_1.randomUUID)(),
-                    status: startAt > Date.now() ? 'scheduled' : 'queued',
-                    scheduled_at: startAt,
-                    recurring: isRecurring,
-                    next_run_at: nextRunAt,
-                };
-            },
-        };
-    }
-    /**
-     * Dispatches a graph operation to run as a scheduled job.
-     * Use this for direct graph operations (traverse, query, createNode, deleteNodes, etc.).
-     * @param {IGraphOperationDispatchInput} data - The graph operation dispatch input.
-     * @returns {Promise<IDispatchResult>} The dispatch result with job ID and status.
-     * @example
-     * // Schedule a graph traversal operation
-     * await ductape.graph.dispatch({
-     *   product: 'my-product',
-     *   env: 'production',
-     *   graph: 'social-graph',
-     *   operation: 'traverse',
-     *   input: { startNode: 'user:123', direction: 'outgoing', depth: 3 },
-     *   schedule: { start_at: Date.now() + 3600000 }
-     * });
-     *
-     * // Run periodic graph cleanup
-     * await ductape.graph.dispatch({
-     *   product: 'my-product',
-     *   env: 'production',
-     *   graph: 'session-graph',
-     *   operation: 'deleteNodes',
-     *   input: { filter: { expired: true } },
-     *   schedule: { cron: '0 4 * * *' } // Daily at 4 AM
-     * });
-     */
-    async dispatch(data) {
-        var _a, _b, _c, _d, _e, _f;
-        const process_id = (0, processor_utils_1.generateObjectId)();
-        const start = Date.now();
-        const processorService = this.createNewProcessor();
-        const productBuilder = await this.getProductBuilder(data.product);
-        const schedule = data.schedule || {};
-        const startAt = typeof schedule.start_at === 'string' ? new Date(schedule.start_at).getTime() : schedule.start_at || Date.now();
-        // Generate job tag based on type, graph, and operation
-        const jobTag = `graph-operation:${data.graph}:${data.operation}`;
-        // Initialize logging
-        this.initializeLogService();
-        const baseLogs = {
-            product_tag: data.product,
-            workspace_id: ((_a = this.config) === null || _a === void 0 ? void 0 : _a.workspace_id) || '',
-            env: data.env,
-            process_id,
-            type: logs_types_1.LogEventTypes.GRAPH,
-            parent_tag: data.graph,
-            child_tag: data.operation,
-            data: { graph: data.graph, operation: data.operation },
-        };
-        (_b = this.logService) === null || _b === void 0 ? void 0 : _b.add(Object.assign(Object.assign({}, baseLogs), { start, message: 'Graph dispatch - initiated', status: logs_types_1.LogEventStatus.PROCESSING }));
-        try {
-            // Check if job exists, if not create it
-            const existingJob = await productBuilder.fetchJob(jobTag);
-            if (!existingJob) {
-                await productBuilder.createJob({
-                    tag: jobTag,
-                    name: `Graph Operation: ${data.graph}/${data.operation}`,
-                    description: `Auto-created job for graph operation ${data.operation} on graph ${data.graph}`,
-                    type: productsBuilder_types_1.JobEventTypes.GRAPH_OPERATION,
-                    app: data.graph,
-                    event: data.operation,
-                    executions: 0,
-                    intervals: schedule.every || 0,
-                    start_at: startAt,
-                });
-            }
-            const jobInput = {
-                product: data.product,
-                env: data.env,
-                event: jobTag,
-                input: data.input,
-                retries: data.retries || 0,
-                start_at: startAt,
-                session: data.session,
-                cache: data.cache,
-                repeat: schedule.cron || schedule.every
-                    ? {
-                        cron: schedule.cron,
-                        every: schedule.every,
-                        limit: schedule.limit,
-                        endDate: schedule.endDate,
-                        tz: schedule.tz,
-                    }
-                    : undefined,
-            };
-            await processorService.processJob(jobInput);
-            const isRecurring = !!(schedule.cron || schedule.every);
-            let nextRunAt;
-            if (isRecurring && schedule.every) {
-                nextRunAt = startAt + schedule.every;
-            }
-            const job_id = (0, crypto_1.randomUUID)();
-            const end = Date.now();
-            (_c = this.logService) === null || _c === void 0 ? void 0 : _c.add(Object.assign(Object.assign({}, baseLogs), { start,
-                end, message: 'Graph dispatch - success', successful_execution: true, data: { graph: data.graph, operation: data.operation, job_id }, status: logs_types_1.LogEventStatus.SUCCESS }));
-            (_d = this.logService) === null || _d === void 0 ? void 0 : _d.publish();
-            return {
-                job_id,
-                status: startAt > Date.now() ? 'scheduled' : 'queued',
-                scheduled_at: startAt,
-                recurring: isRecurring,
-                next_run_at: nextRunAt,
-            };
-        }
-        catch (error) {
-            const end = Date.now();
-            (_e = this.logService) === null || _e === void 0 ? void 0 : _e.add(Object.assign(Object.assign({}, baseLogs), { start,
-                end, message: 'Graph dispatch - failed', failed_execution: true, data: { graph: data.graph, operation: data.operation, error: String(error) }, status: logs_types_1.LogEventStatus.FAIL }));
-            await ((_f = this.logService) === null || _f === void 0 ? void 0 : _f.publish());
-            throw error;
-        }
-    }
-    /**
-     * Substitute parameter placeholders in a query object
-     */
-    substituteParameters(query, parameters, input) {
-        var _a;
-        // Deep clone the query
-        const result = JSON.parse(JSON.stringify(query));
-        // Substitute each parameter
-        for (const param of parameters) {
-            const value = (_a = input[param.name]) !== null && _a !== void 0 ? _a : param.defaultValue;
-            this.setNestedValue(result, param.path, value);
-        }
-        return result;
-    }
-    /**
-     * Set a nested value in an object using a dot-notation path
-     */
-    setNestedValue(obj, path, value) {
-        const keys = path.replace(/\[(\d+)\]/g, '.$1').split('.');
-        let current = obj;
-        for (let i = 0; i < keys.length - 1; i++) {
-            const key = keys[i];
-            if (current[key] === undefined) {
-                current[key] = {};
-            }
-            current = current[key];
-        }
-        current[keys[keys.length - 1]] = value;
-    }
-    /**
-     * Execute an operation based on the query object
-     */
-    async executeOperation(query) {
-        const { operation, options } = query;
-        switch (operation) {
-            case 'findNodes': {
-                const result = await this.findNodes(options);
-                return { data: result.nodes };
-            }
-            case 'findRelationships': {
-                const result = await this.findRelationships(options);
-                return { data: result.relationships };
-            }
-            case 'traverse': {
-                const result = await this.traverse(options);
-                return { data: result.paths };
-            }
-            case 'shortestPath': {
-                const result = await this.shortestPath(options);
-                return { data: result.path ? [result.path] : [] };
-            }
-            case 'allPaths': {
-                const result = await this.allPaths(options);
-                return { data: result.paths };
-            }
-            case 'getNeighborhood': {
-                const result = await this.getNeighborhood(options);
-                return { data: result.nodes };
-            }
-            case 'countNodes': {
-                const result = await this.countNodes(options === null || options === void 0 ? void 0 : options.labels, options === null || options === void 0 ? void 0 : options.where);
-                return { data: [{ count: result.count }] };
-            }
-            case 'countRelationships': {
-                const result = await this.countRelationships(options === null || options === void 0 ? void 0 : options.types, options === null || options === void 0 ? void 0 : options.where);
-                return { data: [{ count: result.count }] };
-            }
-            case 'getStatistics': {
-                const result = await this.getStatistics();
-                return { data: [result] };
-            }
-            case 'executeRaw':
-            case 'query': {
-                const result = await this.query(options.query, options.params);
-                return { data: result.records };
-            }
-            default:
-                throw new Error(`Unsupported operation: ${operation}`);
-        }
-    }
-    // ==================== TRANSACTION OPERATIONS ====================
-    /**
-     * Execute operations within a transaction
-     * As documented in transactions.md
-     *
-     * @example
-     * ```ts
-     * const result = await ductape.graph.executeTransaction(async (transaction) => {
-     *   const alice = await ductape.graph.createNode({
-     *     labels: ['Person'],
-     *     properties: { name: 'Alice' },
-     *   }, transaction);
-     *
-     *   const bob = await ductape.graph.createNode({
-     *     labels: ['Person'],
-     *     properties: { name: 'Bob' },
-     *   }, transaction);
-     *
-     *   await ductape.graph.createRelationship({
-     *     type: 'FRIENDS_WITH',
-     *     startNodeId: alice.node.id,
-     *     endNodeId: bob.node.id,
-     *   }, transaction);
-     *
-     *   return { alice, bob };
-     * });
-     * ```
-     */
-    async executeTransaction(callback, options) {
-        if (!this.transactionManager) {
-            throw graph_error_1.GraphError.configurationError('No connection established. Please connect first.');
-        }
-        return this.transactionManager.executeTransaction(callback, options);
-    }
-    /**
-     * Begin a manual transaction
-     * As documented in transactions.md
-     */
-    async beginTransaction(options) {
-        if (!this.transactionManager) {
-            throw graph_error_1.GraphError.configurationError('No connection established. Please connect first.');
-        }
-        return this.transactionManager.beginTransaction(options);
-    }
-    /**
-     * Commit a transaction
-     */
-    async commitTransaction(transaction) {
-        if (!this.transactionManager) {
-            throw graph_error_1.GraphError.configurationError('No connection established.');
-        }
-        return this.transactionManager.commitTransaction(transaction);
-    }
-    /**
-     * Rollback a transaction
-     */
-    async rollbackTransaction(transaction) {
-        if (!this.transactionManager) {
-            throw graph_error_1.GraphError.configurationError('No connection established.');
-        }
-        return this.transactionManager.rollbackTransaction(transaction);
-    }
-    /**
-     * Get the current adapter (synchronous, throws if not connected)
-     */
-    getAdapter() {
-        if (!this.currentContext) {
-            throw graph_error_1.GraphError.configurationError('No connection established. Please call connect() first.');
-        }
-        const contextKey = `${this.currentContext.graph}:${this.currentContext.env}`;
-        const adapter = this.adapters.get(contextKey);
-        if (!adapter) {
-            throw graph_error_1.GraphError.configurationError(`Adapter not found for ${contextKey}`);
-        }
-        if (!this.currentContext.connected) {
-            throw graph_error_1.GraphError.connectionError('Not connected to graph database');
-        }
-        return adapter;
-    }
-    /**
-     * Ensure a connection exists for the given graph/env/product (connect on demand).
-     * Use before getAdapter() when options include graph+env+product (e.g. from proxy).
-     */
-    async ensureConnectionFor(options) {
-        if (!(options === null || options === void 0 ? void 0 : options.graph) || !(options === null || options === void 0 ? void 0 : options.env) || !(options === null || options === void 0 ? void 0 : options.product))
-            return;
-        const contextKey = `${options.graph}:${options.env}`;
-        const existingAdapter = this.adapters.get(contextKey);
-        const ctx = this.connectionContexts.get(contextKey);
-        if (existingAdapter && (ctx === null || ctx === void 0 ? void 0 : ctx.connected)) {
-            this.currentContext = ctx;
-            this.transactionManager = new transaction_manager_1.GraphTransactionManager(existingAdapter);
-            return;
-        }
-        await this.connect({ graph: options.graph, env: options.env, product: options.product });
-    }
-    /**
-     * Get the current adapter with automatic reconnection on failure
-     */
-    async getAdapterWithReconnect() {
-        if (!this.currentContext) {
-            throw graph_error_1.GraphError.configurationError('No connection established. Please call connect() first.');
-        }
-        const contextKey = `${this.currentContext.graph}:${this.currentContext.env}`;
-        const adapter = this.adapters.get(contextKey);
-        if (!adapter) {
-            throw graph_error_1.GraphError.configurationError(`Adapter not found for ${contextKey}`);
-        }
-        // If connected, return the adapter
-        if (this.currentContext.connected && adapter.isConnected()) {
-            return adapter;
-        }
-        // Connection lost - attempt to reconnect
-        await this.attemptReconnect();
-        // After reconnection, verify we're connected
-        if (!this.currentContext.connected) {
-            throw graph_error_1.GraphError.connectionError('Failed to reconnect to graph database');
-        }
-        return adapter;
-    }
-    /**
-     * Attempt to reconnect to the graph database
-     */
-    async attemptReconnect() {
-        var _a;
-        if (this.reconnecting) {
-            // Wait briefly if reconnection is already in progress
-            await new Promise(resolve => setTimeout(resolve, 1000));
-            if ((_a = this.currentContext) === null || _a === void 0 ? void 0 : _a.connected)
-                return;
-            throw graph_error_1.GraphError.connectionError('Reconnection already in progress');
-        }
-        if (!this.currentContext) {
-            throw graph_error_1.GraphError.configurationError('Cannot reconnect: no connection context available');
-        }
-        this.reconnecting = true;
-        const { graph, env, product } = this.currentContext;
-        try {
-            console.log(`[GraphService] Attempting to reconnect to ${graph}:${env}...`);
-            // Attempt to reconnect using stored context
-            await this.connect({
-                graph,
-                env,
-                product: product || '',
-            });
-            console.log(`[GraphService] Successfully reconnected to ${graph}:${env}`);
-        }
-        catch (error) {
-            console.error(`[GraphService] Failed to reconnect to ${graph}:${env}:`, error);
-            throw error;
-        }
-        finally {
-            this.reconnecting = false;
-        }
-    }
-    /**
-     * Execute an operation with automatic retry on connection errors
-     */
-    async executeWithRetry(operation, retries = this.maxReconnectRetries) {
-        let lastError = null;
-        for (let attempt = 0; attempt <= retries; attempt++) {
-            try {
-                // Ensure we have a connected adapter before each attempt
-                await this.getAdapterWithReconnect();
-                return await operation();
-            }
-            catch (error) {
-                lastError = error;
-                // Check if this is a connection error
-                if (!this.isConnectionError(error) || attempt === retries) {
-                    throw error;
-                }
-                console.log(`[GraphService] Connection error on attempt ${attempt + 1}/${retries + 1}, retrying...`);
-                // Mark as disconnected and try to reconnect
-                if (this.currentContext) {
-                    this.currentContext.connected = false;
-                }
-                // Small delay before retry (exponential backoff)
-                await new Promise(resolve => setTimeout(resolve, 500 * (attempt + 1)));
-            }
-        }
-        throw lastError || new Error('Operation failed after retries');
-    }
-    /**
-     * Check if an error is a connection-related error that can be retried
-     * Note: "No connection established" errors are NOT retriable - they indicate
-     * connect() was never called, not that a connection was lost
-     */
-    isConnectionError(error) {
-        var _a, _b, _c;
-        const errorCode = ((_a = error.code) === null || _a === void 0 ? void 0 : _a.toString()) || '';
-        const errorMessage = ((_b = error.message) === null || _b === void 0 ? void 0 : _b.toLowerCase()) || '';
-        const errorType = ((_c = error.type) === null || _c === void 0 ? void 0 : _c.toString()) || '';
-        // Configuration errors should NOT be retried - they require explicit connect() call
-        if (errorType === 'CONFIGURATION_ERROR' || errorMessage.includes('please call connect')) {
-            return false;
-        }
-        return (errorCode === 'ECONNRESET' ||
-            errorCode === 'ETIMEDOUT' ||
-            errorCode === 'ENOTFOUND' ||
-            errorCode === 'ECONNREFUSED' ||
-            errorCode === 'EPIPE' ||
-            errorCode === 'ServiceUnavailable' ||
-            errorCode === 'SessionExpired' ||
-            errorMessage.includes('connection terminated') ||
-            errorMessage.includes('connection timeout') ||
-            errorMessage.includes('connection refused') ||
-            errorMessage.includes('connection lost') ||
-            errorMessage.includes('connection closed') ||
-            errorMessage.includes('socket hang up') ||
-            errorMessage.includes('econnreset') ||
-            errorMessage.includes('network error') ||
-            errorMessage.includes('session expired') ||
-            errorMessage.includes('service unavailable') ||
-            errorMessage.includes('no longer valid') ||
-            errorMessage.includes('pool is closed'));
-    }
-    /**
-     * Fetch graph configuration from product API
-     */
-    async fetchGraphFromProduct(productTag, graphTag) {
-        try {
-            const builder = await this.getProductBuilder(productTag);
-            const graph = await builder.fetchGraph(graphTag);
-            if (graph) {
-                return this.productGraphToConfig(graph);
-            }
-            return null;
-        }
-        catch (error) {
-            console.warn(`[GraphService] Failed to fetch graph '${graphTag}' from product '${productTag}':`, error);
-            return null;
-        }
-    }
-    /**
-     * Get current connection context
-     */
-    getCurrentContext() {
-        return this.currentContext;
-    }
-    /**
-     * Check if a feature is supported by the current adapter
-     */
-    supportsFeature(feature) {
-        try {
-            const adapter = this.getAdapter();
-            return adapter.supportsFeature(feature);
-        }
-        catch (_a) {
-            return false;
-        }
-    }
-}
-exports.GraphService = GraphService;
-//# sourceMappingURL=graphs.service.js.map