@ductape/sdk 0.0.4-v9 → 0.0.4-v91

package/dist/vector/index.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Vector Database Module
+ *
+ * Provides a unified interface for working with vector databases.
+ * Supports multiple providers: Pinecone, Qdrant, Weaviate, and in-memory.
+ *
+ * @example
+ * ```typescript
+ * // Product-level vector management (via ductape.vector)
+ * await ductape.vector.create({
+ *   product: 'my-product',
+ *   tag: 'embeddings',
+ *   name: 'Document Embeddings',
+ *   type: VectorDBType.PINECONE,
+ *   dimensions: 1536,
+ *   envs: [{ slug: 'prd', apiKey: '...', endpoint: '...' }],
+ * });
+ *
+ * // Connect and query
+ * await ductape.vector.connect({ product: 'my-product', env: 'prd', tag: 'embeddings' });
+ * const results = await ductape.vector.query({
+ *   product: 'my-product',
+ *   env: 'prd',
+ *   tag: 'embeddings',
+ *   vector: [...],
+ *   topK: 10,
+ * });
+ * ```
+ */
+export { VectorDatabaseService, type IVectorDatabaseServiceConfig, type ICreateVectorDbOptions, type IVectorDbEnvConfig, type IUpdateVectorDbOptions, type IFetchVectorOptions, type IDeleteVectorConfigOptions, type IProductVectorQueryOptions, type IProductVectorUpsertOptions, type IProductVectorFetchOptions, type IProductVectorDeleteOptions, } from './vector-database.service';
+export { VectorService, type IVectorServiceOptions, type IVectorLoggingContext } from './vector.service';
+export { VectorDBType, DistanceMetric, VectorIndexType, VectorErrorType, VectorFeature, type IVectorEnvConfig, type IVectorConfig, type IVectorConnectionConfig, type IVectorConnectionOptions, type IVectorConnectionResult, type IVectorConnectionContext, type IVectorServiceConfig, type IVectorTestConnectionResult, type VectorMetadata, type IVector, type ISparseVector, type IUpsertVectorsOptions, type IUpsertVectorsResult, type IMetadataFilter, type MetadataFilterOperator, type IMetadataFilterGroup, type IQueryVectorsOptions, type IQueryMatch, type IQueryVectorsResult, type IFetchVectorsOptions, type IFetchVectorsResult, type IUpdateVectorOptions, type IUpdateVectorResult, type IDeleteVectorsOptions, type IDeleteVectorsResult, type IListVectorsOptions, type IListVectorsResult, type INamespaceInfo, type IListNamespacesResult, type IVectorIndexInfo, type ICreateIndexOptions, type ICreateIndexResult, type IDeleteIndexOptions, type IDeleteIndexResult, type IVectorIndexStats, type EmbeddingProvider, type IEmbeddingModelConfig, type IEmbedOptions, type IEmbeddingResult, type IBatchEmbeddingResult, type IEmbeddingProvider, type IOpenAIEmbeddingConfig, type ICohereEmbeddingConfig, type IVoyageEmbeddingConfig, type IJinaEmbeddingConfig, type IHuggingFaceEmbeddingConfig, type ILocalEmbeddingConfig, } from './types';
+export { BaseVectorAdapter, type IAdapterConnectionOptions, PineconeAdapter, QdrantAdapter, WeaviateAdapter, MemoryAdapter, } from './adapters';
+export { VectorActionTypes, VectorActionTypeMap, PLACEHOLDER_REGEX, extractPlaceholders, resolvePlaceholders, type IVectorActionDefinition, type IVectorActionTemplate, type IVectorActionParam, type IVectorActionCreateOptions, type IVectorActionUpdateOptions, type IVectorActionExecuteOptions, type IVectorActionFetchOptions, type IVectorActionDeleteOptions, type IVectorActionResult, } from './types';
+export { VectorActionManager, VectorActionBuilder, createVectorAction } from './actions/action-manager';
+export { VectorError } from './utils';

package/dist/vector/index.js

@@ -0,0 +1,70 @@
+"use strict";
+/**
+ * Vector Database Module
+ *
+ * Provides a unified interface for working with vector databases.
+ * Supports multiple providers: Pinecone, Qdrant, Weaviate, and in-memory.
+ *
+ * @example
+ * ```typescript
+ * // Product-level vector management (via ductape.vector)
+ * await ductape.vector.create({
+ *   product: 'my-product',
+ *   tag: 'embeddings',
+ *   name: 'Document Embeddings',
+ *   type: VectorDBType.PINECONE,
+ *   dimensions: 1536,
+ *   envs: [{ slug: 'prd', apiKey: '...', endpoint: '...' }],
+ * });
+ *
+ * // Connect and query
+ * await ductape.vector.connect({ product: 'my-product', env: 'prd', tag: 'embeddings' });
+ * const results = await ductape.vector.query({
+ *   product: 'my-product',
+ *   env: 'prd',
+ *   tag: 'embeddings',
+ *   vector: [...],
+ *   topK: 10,
+ * });
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VectorError = exports.createVectorAction = exports.VectorActionBuilder = exports.VectorActionManager = exports.resolvePlaceholders = exports.extractPlaceholders = exports.PLACEHOLDER_REGEX = exports.VectorActionTypeMap = exports.VectorActionTypes = exports.MemoryAdapter = exports.WeaviateAdapter = exports.QdrantAdapter = exports.PineconeAdapter = exports.BaseVectorAdapter = exports.VectorFeature = exports.VectorErrorType = exports.VectorIndexType = exports.DistanceMetric = exports.VectorDBType = exports.VectorService = exports.VectorDatabaseService = void 0;
+// Product-level vector database service
+var vector_database_service_1 = require("./vector-database.service");
+Object.defineProperty(exports, "VectorDatabaseService", { enumerable: true, get: function () { return vector_database_service_1.VectorDatabaseService; } });
+// Internal: VectorService is used internally by VectorDatabaseService
+// Not exported to users - use VectorDatabaseService instead
+var vector_service_1 = require("./vector.service");
+Object.defineProperty(exports, "VectorService", { enumerable: true, get: function () { return vector_service_1.VectorService; } });
+// Types
+var types_1 = require("./types");
+// Enums
+Object.defineProperty(exports, "VectorDBType", { enumerable: true, get: function () { return types_1.VectorDBType; } });
+Object.defineProperty(exports, "DistanceMetric", { enumerable: true, get: function () { return types_1.DistanceMetric; } });
+Object.defineProperty(exports, "VectorIndexType", { enumerable: true, get: function () { return types_1.VectorIndexType; } });
+Object.defineProperty(exports, "VectorErrorType", { enumerable: true, get: function () { return types_1.VectorErrorType; } });
+Object.defineProperty(exports, "VectorFeature", { enumerable: true, get: function () { return types_1.VectorFeature; } });
+// Adapters (for advanced use cases)
+var adapters_1 = require("./adapters");
+Object.defineProperty(exports, "BaseVectorAdapter", { enumerable: true, get: function () { return adapters_1.BaseVectorAdapter; } });
+Object.defineProperty(exports, "PineconeAdapter", { enumerable: true, get: function () { return adapters_1.PineconeAdapter; } });
+Object.defineProperty(exports, "QdrantAdapter", { enumerable: true, get: function () { return adapters_1.QdrantAdapter; } });
+Object.defineProperty(exports, "WeaviateAdapter", { enumerable: true, get: function () { return adapters_1.WeaviateAdapter; } });
+Object.defineProperty(exports, "MemoryAdapter", { enumerable: true, get: function () { return adapters_1.MemoryAdapter; } });
+// Action types
+var types_2 = require("./types");
+Object.defineProperty(exports, "VectorActionTypes", { enumerable: true, get: function () { return types_2.VectorActionTypes; } });
+Object.defineProperty(exports, "VectorActionTypeMap", { enumerable: true, get: function () { return types_2.VectorActionTypeMap; } });
+Object.defineProperty(exports, "PLACEHOLDER_REGEX", { enumerable: true, get: function () { return types_2.PLACEHOLDER_REGEX; } });
+Object.defineProperty(exports, "extractPlaceholders", { enumerable: true, get: function () { return types_2.extractPlaceholders; } });
+Object.defineProperty(exports, "resolvePlaceholders", { enumerable: true, get: function () { return types_2.resolvePlaceholders; } });
+// Action Manager
+var action_manager_1 = require("./actions/action-manager");
+Object.defineProperty(exports, "VectorActionManager", { enumerable: true, get: function () { return action_manager_1.VectorActionManager; } });
+Object.defineProperty(exports, "VectorActionBuilder", { enumerable: true, get: function () { return action_manager_1.VectorActionBuilder; } });
+Object.defineProperty(exports, "createVectorAction", { enumerable: true, get: function () { return action_manager_1.createVectorAction; } });
+// Utils
+var utils_1 = require("./utils");
+Object.defineProperty(exports, "VectorError", { enumerable: true, get: function () { return utils_1.VectorError; } });
+//# sourceMappingURL=index.js.map

package/dist/vector/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/vector/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;;;AAEH,wCAAwC;AACxC,qEAYmC;AAXjC,gIAAA,qBAAqB,OAAA;AAavB,sEAAsE;AACtE,4DAA4D;AAC5D,mDAAyG;AAAhG,+GAAA,aAAa,OAAA;AAEtB,QAAQ;AACR,iCAyDiB;AAxDf,QAAQ;AACR,qGAAA,YAAY,OAAA;AACZ,uGAAA,cAAc,OAAA;AACd,wGAAA,eAAe,OAAA;AACf,wGAAA,eAAe,OAAA;AACf,sGAAA,aAAa,OAAA;AAqDf,oCAAoC;AACpC,uCAOoB;AANlB,6GAAA,iBAAiB,OAAA;AAEjB,2GAAA,eAAe,OAAA;AACf,yGAAA,aAAa,OAAA;AACb,2GAAA,eAAe,OAAA;AACf,yGAAA,aAAa,OAAA;AAGf,eAAe;AACf,iCAeiB;AAdf,0GAAA,iBAAiB,OAAA;AACjB,4GAAA,mBAAmB,OAAA;AACnB,0GAAA,iBAAiB,OAAA;AACjB,4GAAA,mBAAmB,OAAA;AACnB,4GAAA,mBAAmB,OAAA;AAYrB,iBAAiB;AACjB,2DAAwG;AAA/F,qHAAA,mBAAmB,OAAA;AAAE,qHAAA,mBAAmB,OAAA;AAAE,oHAAA,kBAAkB,OAAA;AAErE,QAAQ;AACR,iCAAsC;AAA7B,oGAAA,WAAW,OAAA"}

package/dist/vector/types/action.interface.d.ts

@@ -0,0 +1,195 @@
+/**
+ * Vector Action type definitions
+ *
+ * Defines interfaces for creating, managing, and executing
+ * reusable vector database actions (query templates).
+ */
+import { VectorActionTypes } from '../../types/productsBuilder.types';
+/**
+ * Re-export VectorActionTypes for convenience
+ */
+export { VectorActionTypes };
+/**
+ * Map of VectorActionTypes to string values for runtime use
+ */
+export declare const VectorActionTypeMap: Record<VectorActionTypes, string>;
+/**
+ * Vector action definition
+ */
+export interface IVectorActionDefinition {
+    /** Human-readable name */
+    name: string;
+    /** Unique tag in format: vector_tag:action_tag */
+    tag: string;
+    /** Action type/operation */
+    operation: VectorActionTypes | string;
+    /** Description of what this action does */
+    description?: string;
+    /** Query template with placeholders */
+    template: IVectorActionTemplate;
+    /** Extracted parameters */
+    parameters: IVectorActionParam[];
+    /** Created timestamp */
+    createdAt?: Date;
+    /** Updated timestamp */
+    updatedAt?: Date;
+}
+/**
+ * Vector action template with placeholders
+ * Placeholders use {{variableName}} syntax
+ */
+export interface IVectorActionTemplate {
+    /** Namespace (supports placeholder) */
+    namespace?: string;
+    /** TopK for queries (supports placeholder) */
+    topK?: number | string;
+    /** Include metadata flag */
+    includeMetadata?: boolean;
+    /** Include values flag */
+    includeValues?: boolean;
+    /** Vector IDs for fetch/delete operations */
+    ids?: string[] | string;
+    /** Single ID for exists/fetchOne */
+    id?: string;
+    /** Query text for semantic search */
+    text?: string;
+    /** Query vector for similarity search */
+    vector?: number[] | string;
+    /** Metadata filter */
+    filter?: Record<string, any>;
+    /** Limit for list operations */
+    limit?: number | string;
+    /** Vectors for upsert operations */
+    vectors?: Array<{
+        id: string;
+        values?: number[];
+        metadata?: Record<string, any>;
+    }> | string;
+    /** Metadata for update operations */
+    metadata?: Record<string, any>;
+    /** Any additional options */
+    [key: string]: any;
+}
+/**
+ * Action parameter definition
+ */
+export interface IVectorActionParam {
+    /** Parameter name (without braces) */
+    name: string;
+    /** JSON path in template */
+    path: string;
+    /** Expected type */
+    type: 'string' | 'number' | 'boolean' | 'array' | 'object';
+    /** Required flag */
+    required?: boolean;
+    /** Default value if not provided */
+    defaultValue?: any;
+    /** Description */
+    description?: string;
+}
+/**
+ * Options for creating a vector action
+ */
+export interface IVectorActionCreateOptions {
+    /** Product tag */
+    product: string;
+    /** Vector database tag */
+    vector: string;
+    /** Human-readable name */
+    name: string;
+    /** Unique action tag (will be prefixed with vector_tag:) */
+    actionTag: string;
+    /** Action type */
+    operation: VectorActionTypes | string;
+    /** Description of what this action does */
+    description?: string;
+    /** Query template with placeholders */
+    template: IVectorActionTemplate;
+    /** Parameters extracted from template */
+    parameters?: IVectorActionParam[];
+}
+/**
+ * Options for updating a vector action
+ */
+export interface IVectorActionUpdateOptions {
+    /** Product tag */
+    product: string;
+    /** Vector database tag */
+    vector: string;
+    /** Action tag to update */
+    actionTag: string;
+    /** New name */
+    name?: string;
+    /** New description */
+    description?: string;
+    /** New template */
+    template?: IVectorActionTemplate;
+    /** New parameters */
+    parameters?: IVectorActionParam[];
+}
+/**
+ * Options for executing a vector action
+ */
+export interface IVectorActionExecuteOptions {
+    /** Product tag */
+    product: string;
+    /** Environment */
+    env: string;
+    /** Vector database tag */
+    vector: string;
+    /** Action tag (without vector prefix) */
+    action: string;
+    /** Input values for template placeholders */
+    input: Record<string, any>;
+    /** Session token in format: session_tag:jwt_token */
+    session?: string;
+}
+/**
+ * Options for fetching vector actions
+ */
+export interface IVectorActionFetchOptions {
+    /** Product tag */
+    product: string;
+    /** Vector database tag */
+    vector: string;
+    /** Optional: specific action tag */
+    actionTag?: string;
+}
+/**
+ * Options for deleting a vector action
+ */
+export interface IVectorActionDeleteOptions {
+    /** Product tag */
+    product: string;
+    /** Vector database tag */
+    vector: string;
+    /** Action tag to delete */
+    actionTag: string;
+}
+/**
+ * Result of action execution
+ */
+export interface IVectorActionResult<T = any> {
+    /** Whether execution succeeded */
+    success: boolean;
+    /** Result data */
+    data?: T;
+    /** Error message if failed */
+    error?: string;
+    /** Execution time in ms */
+    executionTime?: number;
+    /** The resolved template that was executed */
+    resolvedTemplate?: IVectorActionTemplate;
+}
+/**
+ * Placeholder regex pattern: {{variableName}}
+ */
+export declare const PLACEHOLDER_REGEX: RegExp;
+/**
+ * Extract placeholders from a value
+ */
+export declare function extractPlaceholders(value: any): string[];
+/**
+ * Resolve placeholders in a template
+ */
+export declare function resolvePlaceholders<T>(template: T, input: Record<string, any>): T;

package/dist/vector/types/action.interface.js

@@ -0,0 +1,100 @@
+"use strict";
+/**
+ * Vector Action type definitions
+ *
+ * Defines interfaces for creating, managing, and executing
+ * reusable vector database actions (query templates).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PLACEHOLDER_REGEX = exports.VectorActionTypeMap = exports.VectorActionTypes = void 0;
+exports.extractPlaceholders = extractPlaceholders;
+exports.resolvePlaceholders = resolvePlaceholders;
+const productsBuilder_types_1 = require("../../types/productsBuilder.types");
+Object.defineProperty(exports, "VectorActionTypes", { enumerable: true, get: function () { return productsBuilder_types_1.VectorActionTypes; } });
+/**
+ * Map of VectorActionTypes to string values for runtime use
+ */
+exports.VectorActionTypeMap = {
+    [productsBuilder_types_1.VectorActionTypes.QUERY]: 'query',
+    [productsBuilder_types_1.VectorActionTypes.FIND_SIMILAR]: 'find_similar',
+    [productsBuilder_types_1.VectorActionTypes.UPSERT]: 'upsert',
+    [productsBuilder_types_1.VectorActionTypes.UPSERT_ONE]: 'upsert_one',
+    [productsBuilder_types_1.VectorActionTypes.FETCH]: 'fetch',
+    [productsBuilder_types_1.VectorActionTypes.FETCH_ONE]: 'fetch_one',
+    [productsBuilder_types_1.VectorActionTypes.LIST]: 'list',
+    [productsBuilder_types_1.VectorActionTypes.COUNT]: 'count',
+    [productsBuilder_types_1.VectorActionTypes.EXISTS]: 'exists',
+    [productsBuilder_types_1.VectorActionTypes.UPDATE]: 'update',
+    [productsBuilder_types_1.VectorActionTypes.DELETE_BY_IDS]: 'delete_by_ids',
+    [productsBuilder_types_1.VectorActionTypes.DELETE_BY_FILTER]: 'delete_by_filter',
+    [productsBuilder_types_1.VectorActionTypes.DELETE_ALL]: 'delete_all',
+    [productsBuilder_types_1.VectorActionTypes.LIST_NAMESPACES]: 'list_namespaces',
+    [productsBuilder_types_1.VectorActionTypes.GET_STATS]: 'get_stats',
+    [productsBuilder_types_1.VectorActionTypes.DESCRIBE_INDEX]: 'describe_index',
+};
+// ==================== PLACEHOLDER UTILITIES ====================
+/**
+ * Placeholder regex pattern: {{variableName}}
+ */
+exports.PLACEHOLDER_REGEX = /\{\{(\w+)\}\}/g;
+/**
+ * Extract placeholders from a value
+ */
+function extractPlaceholders(value) {
+    const placeholders = [];
+    const seen = new Set();
+    const extract = (v) => {
+        if (typeof v === 'string') {
+            let match;
+            const regex = new RegExp(exports.PLACEHOLDER_REGEX.source, 'g');
+            while ((match = regex.exec(v)) !== null) {
+                if (!seen.has(match[1])) {
+                    seen.add(match[1]);
+                    placeholders.push(match[1]);
+                }
+            }
+        }
+        else if (Array.isArray(v)) {
+            v.forEach(extract);
+        }
+        else if (v && typeof v === 'object') {
+            Object.values(v).forEach(extract);
+        }
+    };
+    extract(value);
+    return placeholders;
+}
+/**
+ * Resolve placeholders in a template
+ */
+function resolvePlaceholders(template, input) {
+    const resolve = (value) => {
+        if (value === null || value === undefined)
+            return value;
+        if (typeof value === 'string') {
+            // Check if entire string is a placeholder
+            const singleMatch = value.match(/^\{\{(\w+)\}\}$/);
+            if (singleMatch) {
+                const key = singleMatch[1];
+                return key in input ? input[key] : value;
+            }
+            // Replace multiple placeholders
+            return value.replace(exports.PLACEHOLDER_REGEX, (match, key) => {
+                return key in input ? String(input[key]) : match;
+            });
+        }
+        if (Array.isArray(value)) {
+            return value.map(resolve);
+        }
+        if (typeof value === 'object' && !(value instanceof Date)) {
+            const resolved = {};
+            for (const [k, v] of Object.entries(value)) {
+                resolved[k] = resolve(v);
+            }
+            return resolved;
+        }
+        return value;
+    };
+    return resolve(template);
+}
+//# sourceMappingURL=action.interface.js.map

package/dist/vector/types/action.interface.js.map

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

package/dist/vector/types/connection.interface.d.ts

@@ -0,0 +1,151 @@
+/**
+ * Vector Database Connection Types
+ *
+ * Connection-related interfaces for vector databases.
+ */
+import { VectorDBType, DistanceMetric, VectorIndexType } from './enums';
+/**
+ * Environment-specific vector database configuration
+ */
+export interface IVectorEnvConfig {
+    /** Environment slug (e.g., 'dev', 'staging', 'prd') */
+    slug: string;
+    /** API endpoint URL */
+    endpoint?: string;
+    /** API key */
+    apiKey?: string;
+    /** Cloud region (for managed services) */
+    region?: string;
+    /** Index/collection name */
+    index?: string;
+    /** Namespace for multi-tenancy */
+    namespace?: string;
+    /** Whether this environment is active */
+    active?: boolean;
+}
+/**
+ * Vector database configuration
+ */
+export interface IVectorConfig {
+    /** Unique vector store tag */
+    tag: string;
+    /** Human-readable name */
+    name: string;
+    /** Description */
+    description?: string;
+    /** Vector database type */
+    type: VectorDBType;
+    /** Vector dimensions */
+    dimensions: number;
+    /** Distance metric for similarity */
+    metric?: DistanceMetric;
+    /** Index type */
+    indexType?: VectorIndexType;
+    /** Environment configurations */
+    envs?: IVectorEnvConfig[];
+}
+/**
+ * Connection configuration for a vector database
+ */
+export interface IVectorConnectionConfig {
+    /** Environment slug */
+    env: string;
+    /** Product tag */
+    product?: string;
+    /** Vector store tag */
+    vector: string;
+    /** Optional namespace override */
+    namespace?: string;
+    /** Connection options */
+    options?: IVectorConnectionOptions;
+}
+/**
+ * Connection options
+ */
+export interface IVectorConnectionOptions {
+    /** Connection timeout in ms */
+    timeout?: number;
+    /** Enable SSL/TLS */
+    ssl?: boolean;
+    /** Number of retries */
+    retries?: number;
+    /** Retry delay in ms */
+    retryDelay?: number;
+    /** Custom headers */
+    headers?: Record<string, string>;
+}
+/**
+ * Connection result
+ */
+export interface IVectorConnectionResult {
+    /** Whether connection was successful */
+    connected: boolean;
+    /** Index/collection name */
+    index?: string;
+    /** Vector dimensions */
+    dimensions?: number;
+    /** Number of vectors in index */
+    vectorCount?: number;
+    /** Latency in ms */
+    latency?: number;
+    /** Error message if failed */
+    error?: string;
+}
+/**
+ * Connection context (internal state)
+ */
+export interface IVectorConnectionContext {
+    /** Vector store tag */
+    vector: string;
+    /** Environment slug */
+    env: string;
+    /** Product tag */
+    product?: string;
+    /** Database type */
+    type: VectorDBType;
+    /** API endpoint */
+    endpoint: string;
+    /** Index/collection name */
+    index: string;
+    /** Namespace */
+    namespace?: string;
+    /** Dimensions */
+    dimensions: number;
+    /** Metric */
+    metric: DistanceMetric;
+    /** Whether connected */
+    connected: boolean;
+}
+/**
+ * Service configuration
+ */
+export interface IVectorServiceConfig {
+    /** Workspace ID */
+    workspace_id: string;
+    /** Public key for authentication */
+    public_key: string;
+    /** User ID */
+    user_id: string;
+    /** Authentication token */
+    token: string;
+    /** Environment type (staging, production, local) */
+    env_type: string;
+}
+/**
+ * Test connection result
+ */
+export interface IVectorTestConnectionResult {
+    /** Whether the connection test passed */
+    success: boolean;
+    /** Response time in ms */
+    latency: number;
+    /** Index information */
+    index?: {
+        name: string;
+        dimensions: number;
+        metric: string;
+        vectorCount: number;
+    };
+    /** Error message if failed */
+    error?: string;
+}

package/dist/vector/types/connection.interface.js

@@ -0,0 +1,8 @@
+"use strict";
+/**
+ * Vector Database Connection Types
+ *
+ * Connection-related interfaces for vector databases.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=connection.interface.js.map

package/dist/vector/types/connection.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection.interface.js","sourceRoot":"","sources":["../../../src/vector/types/connection.interface.ts"],"names":[],"mappings":";AAAA;;;;GAIG"}