@ductape/sdk 0.0.4-v9 → 0.0.4-v91

package/dist/vector/actions/action-manager.js

@@ -0,0 +1,356 @@
+"use strict";
+/**
+ * Vector Action Manager
+ *
+ * Manages reusable vector database actions (query templates).
+ * Actions allow defining common vector operations that can be
+ * executed with different input parameters.
+ *
+ * Uses ProductBuilder for persistence to the backend.
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VectorActionBuilder = exports.VectorActionManager = void 0;
+exports.createVectorAction = createVectorAction;
+const action_interface_1 = require("../types/action.interface");
+const vector_error_1 = require("../utils/vector-error");
+const enums_1 = require("../types/enums");
+const products_service_1 = __importDefault(require("../../products/services/products.service"));
+const types_1 = require("../../types");
+/**
+ * Vector Action Manager for managing reusable vector actions
+ * Uses ProductBuilder for persistent storage
+ */
+class VectorActionManager {
+    constructor(vectorService) {
+        this.productBuilders = new Map();
+        this.vectorService = vectorService;
+    }
+    // ==================== PRODUCT BUILDER MANAGEMENT ====================
+    /**
+     * Create a new ProductBuilder instance
+     */
+    createNewProductBuilder() {
+        const config = this.vectorService.getConfig();
+        if (!config) {
+            throw new vector_error_1.VectorError('VectorService not configured. Please provide config when initializing.', enums_1.VectorErrorType.CONFIGURATION_ERROR);
+        }
+        return new products_service_1.default({
+            workspace_id: config.workspace_id,
+            public_key: config.public_key,
+            user_id: config.user_id,
+            token: config.token,
+            env_type: config.env_type,
+            access_key: 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);
+        }
+        return builder;
+    }
+    // ==================== ACTION CRUD ====================
+    /**
+     * Create a new vector action
+     * @param options Action creation options
+     */
+    async create(options) {
+        const builder = await this.getProductBuilder(options.product);
+        // Extract parameters from template if not provided
+        const parameters = options.parameters || this.extractParametersFromTemplate(options.template);
+        // Build the action tag (vector_tag:action_tag)
+        const fullActionTag = `${options.vector}:${options.actionTag}`;
+        // Convert to IProductVectorAction format
+        const actionData = {
+            name: options.name,
+            tag: fullActionTag,
+            description: options.description,
+            type: this.mapOperationType(options.operation),
+            template: {
+                options: options.template,
+            },
+            parameters: parameters.map(p => ({
+                name: p.name,
+                path: p.path,
+                defaultValue: p.defaultValue,
+                type: p.type,
+                required: p.required,
+                description: p.description,
+            })),
+        };
+        const result = await builder.createVectorAction(options.vector, actionData);
+        return result;
+    }
+    /**
+     * Update an existing vector action
+     * @param options Action update options
+     */
+    async update(options) {
+        const builder = await this.getProductBuilder(options.product);
+        const fullActionTag = `${options.vector}:${options.actionTag}`;
+        // Build update data
+        const actionData = {
+            tag: fullActionTag,
+        };
+        if (options.name)
+            actionData.name = options.name;
+        if (options.description !== undefined)
+            actionData.description = options.description;
+        if (options.template) {
+            actionData.template = { options: options.template };
+        }
+        if (options.parameters) {
+            actionData.parameters = options.parameters.map(p => ({
+                name: p.name,
+                path: p.path,
+                defaultValue: p.defaultValue,
+                type: p.type,
+                required: p.required,
+                description: p.description,
+            }));
+        }
+        const result = await builder.updateVectorAction(options.vector, actionData);
+        return result;
+    }
+    /**
+     * Fetch a specific vector action
+     * @param options Fetch options
+     * @returns Action definition or null
+     */
+    async fetch(options) {
+        const builder = await this.getProductBuilder(options.product);
+        const fullActionTag = `${options.vector}:${options.actionTag}`;
+        const action = await builder.fetchVectorAction(options.vector, fullActionTag);
+        if (!action)
+            return null;
+        return this.convertToActionDefinition(action);
+    }
+    /**
+     * Fetch all vector actions for a vector database
+     * @param options Fetch options
+     * @returns Array of action definitions
+     */
+    async fetchAll(options) {
+        const builder = await this.getProductBuilder(options.product);
+        const actions = await builder.fetchVectorActions(options.vector);
+        return actions.map(action => this.convertToActionDefinition(action));
+    }
+    /**
+     * Delete a vector action
+     * @param options Delete options
+     */
+    async delete(options) {
+        const builder = await this.getProductBuilder(options.product);
+        const fullActionTag = `${options.vector}:${options.actionTag}`;
+        await builder.deleteVectorAction(options.vector, fullActionTag);
+    }
+    // ==================== ACTION EXECUTION ====================
+    /**
+     * Execute a vector action
+     *
+     * This method resolves the template placeholders and returns
+     * the resolved options for the caller to execute through
+     * the VectorDatabaseService.
+     *
+     * @param options Execution options
+     * @returns Resolved template ready for execution
+     */
+    async resolve(options) {
+        var _a;
+        const builder = await this.getProductBuilder(options.product);
+        const fullActionTag = `${options.vector}:${options.action}`;
+        const action = await builder.fetchVectorAction(options.vector, fullActionTag);
+        if (!action) {
+            throw new vector_error_1.VectorError(`Action with tag '${fullActionTag}' not found`, enums_1.VectorErrorType.INVALID_OPERATION);
+        }
+        // Resolve template placeholders with input values
+        const template = ((_a = action.template) === null || _a === void 0 ? void 0 : _a.options) || {};
+        const resolvedTemplate = (0, action_interface_1.resolvePlaceholders)(template, options.input);
+        return resolvedTemplate;
+    }
+    // ==================== HELPER METHODS ====================
+    /**
+     * Extract parameters from a template
+     */
+    extractParametersFromTemplate(template) {
+        const params = [];
+        const seen = new Set();
+        const processValue = (value, path) => {
+            if (typeof value === 'string') {
+                const placeholders = (0, action_interface_1.extractPlaceholders)(value);
+                for (const name of placeholders) {
+                    if (!seen.has(name)) {
+                        seen.add(name);
+                        params.push({
+                            name,
+                            path,
+                            type: 'string',
+                            required: true,
+                        });
+                    }
+                }
+            }
+            else if (Array.isArray(value)) {
+                value.forEach((item, idx) => {
+                    processValue(item, `${path}[${idx}]`);
+                });
+            }
+            else if (value && typeof value === 'object') {
+                for (const [key, val] of Object.entries(value)) {
+                    processValue(val, path ? `${path}.${key}` : key);
+                }
+            }
+        };
+        processValue(template, '');
+        return params;
+    }
+    /**
+     * Map operation type to ProductVectorActionTypes
+     */
+    mapOperationType(operation) {
+        const opType = typeof operation === 'string' ? operation.toLowerCase() : operation;
+        // Map string values to enum
+        const mapping = {
+            query: types_1.VectorActionTypes.QUERY,
+            find_similar: types_1.VectorActionTypes.FIND_SIMILAR,
+            upsert: types_1.VectorActionTypes.UPSERT,
+            upsert_one: types_1.VectorActionTypes.UPSERT_ONE,
+            fetch: types_1.VectorActionTypes.FETCH,
+            fetch_one: types_1.VectorActionTypes.FETCH_ONE,
+            list: types_1.VectorActionTypes.LIST,
+            count: types_1.VectorActionTypes.COUNT,
+            exists: types_1.VectorActionTypes.EXISTS,
+            update: types_1.VectorActionTypes.UPDATE,
+            delete_by_ids: types_1.VectorActionTypes.DELETE_BY_IDS,
+            delete_by_filter: types_1.VectorActionTypes.DELETE_BY_FILTER,
+            delete_all: types_1.VectorActionTypes.DELETE_ALL,
+            list_namespaces: types_1.VectorActionTypes.LIST_NAMESPACES,
+            get_stats: types_1.VectorActionTypes.GET_STATS,
+            describe_index: types_1.VectorActionTypes.DESCRIBE_INDEX,
+        };
+        return mapping[opType] || types_1.VectorActionTypes.QUERY;
+    }
+    /**
+     * Convert IProductVectorAction to IVectorActionDefinition
+     */
+    convertToActionDefinition(action) {
+        var _a;
+        return {
+            name: action.name,
+            tag: action.tag,
+            operation: action.type,
+            description: action.description,
+            template: ((_a = action.template) === null || _a === void 0 ? void 0 : _a.options) || {},
+            parameters: (action.parameters || []).map(p => ({
+                name: p.name,
+                path: p.path,
+                type: p.type,
+                required: p.required,
+                defaultValue: p.defaultValue,
+                description: p.description,
+            })),
+            createdAt: action.created_at,
+            updatedAt: action.updated_at,
+        };
+    }
+}
+exports.VectorActionManager = VectorActionManager;
+/**
+ * Vector Action Builder for fluent action creation
+ */
+class VectorActionBuilder {
+    constructor() {
+        this.options = {};
+    }
+    /**
+     * Set product tag
+     */
+    product(product) {
+        this.options.product = product;
+        return this;
+    }
+    /**
+     * Set vector database tag
+     */
+    vector(vector) {
+        this.options.vector = vector;
+        return this;
+    }
+    /**
+     * Set action name
+     */
+    name(name) {
+        this.options.name = name;
+        return this;
+    }
+    /**
+     * Set action tag
+     */
+    tag(actionTag) {
+        this.options.actionTag = actionTag;
+        return this;
+    }
+    /**
+     * Set operation type
+     */
+    operation(operation) {
+        this.options.operation = operation;
+        return this;
+    }
+    /**
+     * Set description
+     */
+    description(description) {
+        this.options.description = description;
+        return this;
+    }
+    /**
+     * Set template
+     */
+    template(template) {
+        this.options.template = template;
+        return this;
+    }
+    /**
+     * Set parameters
+     */
+    parameters(parameters) {
+        this.options.parameters = parameters;
+        return this;
+    }
+    /**
+     * Build the action options
+     */
+    build() {
+        if (!this.options.product)
+            throw new Error('Product tag is required');
+        if (!this.options.vector)
+            throw new Error('Vector database tag is required');
+        if (!this.options.name)
+            throw new Error('Action name is required');
+        if (!this.options.actionTag)
+            throw new Error('Action tag is required');
+        if (!this.options.operation)
+            throw new Error('Operation type is required');
+        if (!this.options.template)
+            throw new Error('Template is required');
+        return this.options;
+    }
+}
+exports.VectorActionBuilder = VectorActionBuilder;
+/**
+ * Create a new vector action builder
+ */
+function createVectorAction() {
+    return new VectorActionBuilder();
+}
+//# sourceMappingURL=action-manager.js.map

package/dist/vector/actions/action-manager.js.map

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

package/dist/vector/adapters/base.adapter.d.ts

@@ -0,0 +1,169 @@
+/**
+ * Base Vector Adapter
+ *
+ * Abstract base class for vector database adapters.
+ * All adapters (Pinecone, Qdrant, Weaviate, etc.) extend this class.
+ */
+import { VectorDBType, DistanceMetric, VectorFeature, IVectorConnectionResult, IVector, IUpsertVectorsOptions, IUpsertVectorsResult, IQueryVectorsOptions, IQueryVectorsResult, IFetchVectorsOptions, IFetchVectorsResult, IUpdateVectorOptions, IUpdateVectorResult, IDeleteVectorsOptions, IDeleteVectorsResult, IListVectorsOptions, IListVectorsResult, IListNamespacesResult, IVectorIndexInfo, ICreateIndexOptions, ICreateIndexResult, IDeleteIndexOptions, IDeleteIndexResult, IVectorIndexStats } from '../types';
+/**
+ * Adapter connection options
+ */
+export interface IAdapterConnectionOptions {
+    /** API endpoint URL */
+    endpoint: string;
+    /** API key */
+    apiKey?: string;
+    /** Index/collection name */
+    index: string;
+    /** Namespace (for multi-tenancy) */
+    namespace?: string;
+    /** Vector dimensions */
+    dimensions: number;
+    /** Distance metric */
+    metric?: DistanceMetric;
+    /** Cloud region */
+    region?: string;
+    /** Additional options */
+    options?: Record<string, unknown>;
+}
+/**
+ * Abstract base adapter for vector databases
+ */
+export declare abstract class BaseVectorAdapter {
+    /** Database type */
+    abstract readonly type: VectorDBType;
+    /** Whether connected */
+    protected _connected: boolean;
+    /** Connection options */
+    protected connectionOptions: IAdapterConnectionOptions | null;
+    /** Maximum retry attempts for auto-reconnection */
+    protected maxRetries: number;
+    /** Flag to indicate if a reconnection is in progress */
+    private reconnecting;
+    /**
+     * Get connected status
+     */
+    get connected(): boolean;
+    /**
+     * Execute an operation with automatic retry on connection errors.
+     * This handles transient connection timeouts and disconnects silently.
+     */
+    protected executeWithRetry<T>(operation: () => Promise<T>, retries?: number): Promise<T>;
+    /**
+     * Check if an error is a connection-related error
+     */
+    protected isConnectionError(error: any): boolean;
+    /**
+     * Attempt to reconnect to the vector database
+     */
+    protected attemptReconnect(): Promise<void>;
+    /**
+     * Get current namespace
+     */
+    get namespace(): string | undefined;
+    /**
+     * Get configured dimensions
+     */
+    get dimensions(): number;
+    /**
+     * Get configured metric
+     */
+    get metric(): DistanceMetric;
+    /**
+     * Connect to the vector database
+     */
+    abstract connect(options: IAdapterConnectionOptions): Promise<IVectorConnectionResult>;
+    /**
+     * Disconnect from the vector database
+     */
+    abstract disconnect(): Promise<void>;
+    /**
+     * Test connection health
+     */
+    abstract testConnection(): Promise<boolean>;
+    /**
+     * Upsert vectors (insert or update)
+     */
+    abstract upsert(options: IUpsertVectorsOptions): Promise<IUpsertVectorsResult>;
+    /**
+     * Query vectors by similarity
+     */
+    abstract query(options: IQueryVectorsOptions): Promise<IQueryVectorsResult>;
+    /**
+     * Fetch vectors by ID
+     */
+    abstract fetch(options: IFetchVectorsOptions): Promise<IFetchVectorsResult>;
+    /**
+     * Update a single vector
+     */
+    abstract update(options: IUpdateVectorOptions): Promise<IUpdateVectorResult>;
+    /**
+     * Delete vectors
+     */
+    abstract delete(options: IDeleteVectorsOptions): Promise<IDeleteVectorsResult>;
+    /**
+     * List vector IDs
+     */
+    abstract list(options: IListVectorsOptions): Promise<IListVectorsResult>;
+    /**
+     * List available namespaces
+     */
+    abstract listNamespaces(): Promise<IListNamespacesResult>;
+    /**
+     * Delete a namespace
+     */
+    abstract deleteNamespace(namespace: string): Promise<void>;
+    /**
+     * Describe the current index
+     */
+    abstract describeIndex(): Promise<IVectorIndexInfo>;
+    /**
+     * Get index statistics
+     */
+    abstract getIndexStats(): Promise<IVectorIndexStats>;
+    /**
+     * Create a new index
+     */
+    abstract createIndex(options: ICreateIndexOptions): Promise<ICreateIndexResult>;
+    /**
+     * Delete an index
+     */
+    abstract deleteIndex(options: IDeleteIndexOptions): Promise<IDeleteIndexResult>;
+    /**
+     * List all indexes
+     */
+    abstract listIndexes(): Promise<IVectorIndexInfo[]>;
+    /**
+     * Check if a feature is supported
+     */
+    abstract supportsFeature(feature: VectorFeature): boolean;
+    /**
+     * Validate vector dimensions
+     */
+    protected validateDimensions(vectors: IVector[]): void;
+    /**
+     * Normalize a vector to unit length (for cosine similarity)
+     */
+    protected normalizeVector(vector: number[]): number[];
+    /**
+     * Calculate cosine similarity between two vectors
+     */
+    protected cosineSimilarity(a: number[], b: number[]): number;
+    /**
+     * Calculate Euclidean distance between two vectors
+     */
+    protected euclideanDistance(a: number[], b: number[]): number;
+    /**
+     * Calculate dot product between two vectors
+     */
+    protected dotProduct(a: number[], b: number[]): number;
+    /**
+     * Calculate similarity based on configured metric
+     */
+    protected calculateSimilarity(a: number[], b: number[]): number;
+    /**
+     * Generate a unique ID
+     */
+    protected generateId(): string;
+}
+export default BaseVectorAdapter;