@ductape/sdk 0.1.7 → 0.1.8

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

@@ -1,356 +0,0 @@
-"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

@@ -1 +0,0 @@
-{"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

@@ -1,169 +0,0 @@
-/**
- * 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;