@ductape/sdk 0.0.4-v51 → 0.0.4-v53

package/dist/vector/vector.service.d.ts

@@ -0,0 +1,245 @@
+/**
+ * Vector Service
+ *
+ * Main service class for vector database operations.
+ * Provides a unified interface for multiple vector database providers.
+ */
+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';
+import { BaseVectorAdapter } from './adapters';
+/**
+ * Vector service configuration
+ */
+export interface IVectorServiceOptions {
+    /** Vector database type */
+    dbType: VectorDBType;
+    /** API endpoint URL */
+    endpoint?: string;
+    /** API key */
+    apiKey?: string;
+    /** Index/collection name */
+    index: string;
+    /** Default namespace */
+    namespace?: string;
+    /** Vector dimensions */
+    dimensions: number;
+    /** Distance metric */
+    metric?: DistanceMetric;
+    /** Cloud region (for hosted services) */
+    region?: string;
+    /** Request timeout in milliseconds */
+    timeout?: number;
+    /** Additional provider-specific options */
+    options?: Record<string, unknown>;
+}
+/**
+ * Main Vector Service class
+ *
+ * Provides a unified API for working with vector databases.
+ *
+ * @example
+ * ```typescript
+ * const vectorService = new VectorService({
+ *   dbType: VectorDBType.PINECONE,
+ *   apiKey: process.env.PINECONE_API_KEY,
+ *   endpoint: 'https://my-index.svc.pinecone.io',
+ *   index: 'my-index',
+ *   dimensions: 1536,
+ * });
+ *
+ * await vectorService.connect();
+ *
+ * // Upsert vectors
+ * await vectorService.upsert({
+ *   vectors: [
+ *     { id: 'doc1', values: [...], metadata: { title: 'Hello' } },
+ *     { id: 'doc2', values: [...], metadata: { title: 'World' } },
+ *   ],
+ * });
+ *
+ * // Query similar vectors
+ * const results = await vectorService.query({
+ *   vector: [...],
+ *   topK: 10,
+ *   filter: { field: 'category', operator: '$eq', value: 'tech' },
+ * });
+ * ```
+ */
+export declare class VectorService {
+    private adapter;
+    private config;
+    private _initialized;
+    constructor(config: IVectorServiceOptions);
+    /**
+     * Get the underlying adapter
+     */
+    get rawAdapter(): BaseVectorAdapter;
+    /**
+     * Get database type
+     */
+    get dbType(): VectorDBType;
+    /**
+     * Check if connected
+     */
+    get connected(): boolean;
+    /**
+     * Get current namespace
+     */
+    get namespace(): string | undefined;
+    /**
+     * Get configured dimensions
+     */
+    get dimensions(): number;
+    /**
+     * Get configured metric
+     */
+    get metric(): DistanceMetric;
+    /**
+     * Connect to the vector database
+     */
+    connect(): Promise<IVectorConnectionResult>;
+    /**
+     * Disconnect from the vector database
+     */
+    disconnect(): Promise<void>;
+    /**
+     * Test connection health
+     */
+    testConnection(): Promise<boolean>;
+    /**
+     * Upsert vectors (insert or update)
+     */
+    upsert(options: IUpsertVectorsOptions): Promise<IUpsertVectorsResult>;
+    /**
+     * Upsert a single vector
+     */
+    upsertOne(id: string, values: number[], metadata?: Record<string, unknown>, namespace?: string): Promise<IUpsertVectorsResult>;
+    /**
+     * Query vectors by similarity
+     */
+    query(options: IQueryVectorsOptions): Promise<IQueryVectorsResult>;
+    /**
+     * Find similar vectors to a given vector
+     */
+    findSimilar(vector: number[], topK?: number, options?: Partial<IQueryVectorsOptions>): Promise<IQueryVectorsResult>;
+    /**
+     * Fetch vectors by ID
+     */
+    fetch(options: IFetchVectorsOptions): Promise<IFetchVectorsResult>;
+    /**
+     * Fetch a single vector by ID
+     */
+    fetchOne(id: string, namespace?: string): Promise<IVector | null>;
+    /**
+     * Update a single vector
+     */
+    update(options: IUpdateVectorOptions): Promise<IUpdateVectorResult>;
+    /**
+     * Update vector metadata
+     */
+    updateMetadata(id: string, metadata: Record<string, unknown>, options?: {
+        merge?: boolean;
+        namespace?: string;
+    }): Promise<IUpdateVectorResult>;
+    /**
+     * Delete vectors
+     */
+    delete(options: IDeleteVectorsOptions): Promise<IDeleteVectorsResult>;
+    /**
+     * Delete vectors by IDs
+     */
+    deleteByIds(ids: string[], namespace?: string): Promise<IDeleteVectorsResult>;
+    /**
+     * Delete all vectors in a namespace
+     */
+    deleteAll(namespace?: string): Promise<IDeleteVectorsResult>;
+    /**
+     * List vector IDs
+     */
+    list(options?: IListVectorsOptions): Promise<IListVectorsResult>;
+    /**
+     * List all vector IDs (paginated)
+     */
+    listAll(options?: {
+        namespace?: string;
+        prefix?: string;
+    }): Promise<string[]>;
+    /**
+     * List available namespaces
+     */
+    listNamespaces(): Promise<IListNamespacesResult>;
+    /**
+     * Delete a namespace
+     */
+    deleteNamespace(namespace: string): Promise<void>;
+    /**
+     * Describe the current index
+     */
+    describeIndex(): Promise<IVectorIndexInfo>;
+    /**
+     * Get index statistics
+     */
+    getStats(): Promise<IVectorIndexStats>;
+    /**
+     * Create a new index
+     */
+    createIndex(options: ICreateIndexOptions): Promise<ICreateIndexResult>;
+    /**
+     * Delete an index
+     */
+    deleteIndex(options: IDeleteIndexOptions): Promise<IDeleteIndexResult>;
+    /**
+     * List all indexes
+     */
+    listIndexes(): Promise<IVectorIndexInfo[]>;
+    /**
+     * Check if a feature is supported
+     */
+    supportsFeature(feature: VectorFeature): boolean;
+    /**
+     * Get all supported features
+     */
+    getSupportedFeatures(): VectorFeature[];
+    /**
+     * Count vectors in the index
+     */
+    count(namespace?: string): Promise<number>;
+    /**
+     * Check if a vector exists
+     */
+    exists(id: string, namespace?: string): Promise<boolean>;
+    /**
+     * Create the appropriate adapter based on database type
+     */
+    private createAdapter;
+    /**
+     * Ensure the service is connected
+     */
+    private ensureConnected;
+}
+/**
+ * Create a vector service instance
+ *
+ * Factory function for creating vector service instances.
+ *
+ * @example
+ * ```typescript
+ * const vectors = createVectorService({
+ *   dbType: VectorDBType.MEMORY,
+ *   index: 'test',
+ *   dimensions: 384,
+ * });
+ * await vectors.connect();
+ * ```
+ */
+export declare function createVectorService(options: IVectorServiceOptions): VectorService;
+/**
+ * Create an in-memory vector service (for development/testing)
+ *
+ * @example
+ * ```typescript
+ * const vectors = createMemoryVectorService('test', 384);
+ * await vectors.connect();
+ * ```
+ */
+export declare function createMemoryVectorService(index: string, dimensions: number, metric?: DistanceMetric): VectorService;
+export default VectorService;

package/dist/vector/vector.service.js

@@ -0,0 +1,381 @@
+"use strict";
+/**
+ * Vector Service
+ *
+ * Main service class for vector database operations.
+ * Provides a unified interface for multiple vector database providers.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VectorService = void 0;
+exports.createVectorService = createVectorService;
+exports.createMemoryVectorService = createMemoryVectorService;
+const types_1 = require("./types");
+const adapters_1 = require("./adapters");
+const utils_1 = require("./utils");
+/**
+ * Main Vector Service class
+ *
+ * Provides a unified API for working with vector databases.
+ *
+ * @example
+ * ```typescript
+ * const vectorService = new VectorService({
+ *   dbType: VectorDBType.PINECONE,
+ *   apiKey: process.env.PINECONE_API_KEY,
+ *   endpoint: 'https://my-index.svc.pinecone.io',
+ *   index: 'my-index',
+ *   dimensions: 1536,
+ * });
+ *
+ * await vectorService.connect();
+ *
+ * // Upsert vectors
+ * await vectorService.upsert({
+ *   vectors: [
+ *     { id: 'doc1', values: [...], metadata: { title: 'Hello' } },
+ *     { id: 'doc2', values: [...], metadata: { title: 'World' } },
+ *   ],
+ * });
+ *
+ * // Query similar vectors
+ * const results = await vectorService.query({
+ *   vector: [...],
+ *   topK: 10,
+ *   filter: { field: 'category', operator: '$eq', value: 'tech' },
+ * });
+ * ```
+ */
+class VectorService {
+    constructor(config) {
+        this._initialized = false;
+        this.config = config;
+        this.adapter = this.createAdapter(config.dbType);
+    }
+    /**
+     * Get the underlying adapter
+     */
+    get rawAdapter() {
+        return this.adapter;
+    }
+    /**
+     * Get database type
+     */
+    get dbType() {
+        return this.config.dbType;
+    }
+    /**
+     * Check if connected
+     */
+    get connected() {
+        return this.adapter.connected;
+    }
+    /**
+     * Get current namespace
+     */
+    get namespace() {
+        return this.adapter.namespace;
+    }
+    /**
+     * Get configured dimensions
+     */
+    get dimensions() {
+        return this.config.dimensions;
+    }
+    /**
+     * Get configured metric
+     */
+    get metric() {
+        return this.config.metric || types_1.DistanceMetric.COSINE;
+    }
+    // ==================== CONNECTION ====================
+    /**
+     * Connect to the vector database
+     */
+    async connect() {
+        const connectionOptions = {
+            endpoint: this.config.endpoint || '',
+            apiKey: this.config.apiKey,
+            index: this.config.index,
+            namespace: this.config.namespace,
+            dimensions: this.config.dimensions,
+            metric: this.config.metric,
+            region: this.config.region,
+            options: Object.assign(Object.assign({}, this.config.options), { timeout: this.config.timeout }),
+        };
+        const result = await this.adapter.connect(connectionOptions);
+        this._initialized = result.connected;
+        return result;
+    }
+    /**
+     * Disconnect from the vector database
+     */
+    async disconnect() {
+        await this.adapter.disconnect();
+        this._initialized = false;
+    }
+    /**
+     * Test connection health
+     */
+    async testConnection() {
+        return this.adapter.testConnection();
+    }
+    // ==================== VECTOR OPERATIONS ====================
+    /**
+     * Upsert vectors (insert or update)
+     */
+    async upsert(options) {
+        this.ensureConnected();
+        return this.adapter.upsert(options);
+    }
+    /**
+     * Upsert a single vector
+     */
+    async upsertOne(id, values, metadata, namespace) {
+        return this.upsert({
+            vectors: [{ id, values, metadata }],
+            namespace,
+        });
+    }
+    /**
+     * Query vectors by similarity
+     */
+    async query(options) {
+        this.ensureConnected();
+        return this.adapter.query(options);
+    }
+    /**
+     * Find similar vectors to a given vector
+     */
+    async findSimilar(vector, topK = 10, options) {
+        return this.query(Object.assign({ vector,
+            topK }, options));
+    }
+    /**
+     * Fetch vectors by ID
+     */
+    async fetch(options) {
+        this.ensureConnected();
+        return this.adapter.fetch(options);
+    }
+    /**
+     * Fetch a single vector by ID
+     */
+    async fetchOne(id, namespace) {
+        const result = await this.fetch({ ids: [id], namespace });
+        return result.vectors[id] || null;
+    }
+    /**
+     * Update a single vector
+     */
+    async update(options) {
+        this.ensureConnected();
+        return this.adapter.update(options);
+    }
+    /**
+     * Update vector metadata
+     */
+    async updateMetadata(id, metadata, options) {
+        return this.update(Object.assign(Object.assign({ id }, ((options === null || options === void 0 ? void 0 : options.merge) ? { mergeMetadata: metadata } : { setMetadata: metadata })), { namespace: options === null || options === void 0 ? void 0 : options.namespace }));
+    }
+    /**
+     * Delete vectors
+     */
+    async delete(options) {
+        this.ensureConnected();
+        return this.adapter.delete(options);
+    }
+    /**
+     * Delete vectors by IDs
+     */
+    async deleteByIds(ids, namespace) {
+        return this.delete({ ids, namespace });
+    }
+    /**
+     * Delete all vectors in a namespace
+     */
+    async deleteAll(namespace) {
+        return this.delete({ deleteAll: true, namespace });
+    }
+    /**
+     * List vector IDs
+     */
+    async list(options = {}) {
+        this.ensureConnected();
+        return this.adapter.list(options);
+    }
+    /**
+     * List all vector IDs (paginated)
+     */
+    async listAll(options) {
+        const allIds = [];
+        let cursor;
+        do {
+            const result = await this.list({
+                namespace: options === null || options === void 0 ? void 0 : options.namespace,
+                prefix: options === null || options === void 0 ? void 0 : options.prefix,
+                limit: 1000,
+                cursor,
+            });
+            allIds.push(...result.ids);
+            cursor = result.nextCursor;
+        } while (cursor);
+        return allIds;
+    }
+    // ==================== NAMESPACE OPERATIONS ====================
+    /**
+     * List available namespaces
+     */
+    async listNamespaces() {
+        this.ensureConnected();
+        return this.adapter.listNamespaces();
+    }
+    /**
+     * Delete a namespace
+     */
+    async deleteNamespace(namespace) {
+        this.ensureConnected();
+        return this.adapter.deleteNamespace(namespace);
+    }
+    // ==================== INDEX OPERATIONS ====================
+    /**
+     * Describe the current index
+     */
+    async describeIndex() {
+        this.ensureConnected();
+        return this.adapter.describeIndex();
+    }
+    /**
+     * Get index statistics
+     */
+    async getStats() {
+        this.ensureConnected();
+        return this.adapter.getIndexStats();
+    }
+    /**
+     * Create a new index
+     */
+    async createIndex(options) {
+        this.ensureConnected();
+        return this.adapter.createIndex(options);
+    }
+    /**
+     * Delete an index
+     */
+    async deleteIndex(options) {
+        this.ensureConnected();
+        return this.adapter.deleteIndex(options);
+    }
+    /**
+     * List all indexes
+     */
+    async listIndexes() {
+        this.ensureConnected();
+        return this.adapter.listIndexes();
+    }
+    // ==================== FEATURE DETECTION ====================
+    /**
+     * Check if a feature is supported
+     */
+    supportsFeature(feature) {
+        return this.adapter.supportsFeature(feature);
+    }
+    /**
+     * Get all supported features
+     */
+    getSupportedFeatures() {
+        const features = [];
+        for (const feature of Object.values(types_1.VectorFeature)) {
+            if (this.supportsFeature(feature)) {
+                features.push(feature);
+            }
+        }
+        return features;
+    }
+    // ==================== UTILITY METHODS ====================
+    /**
+     * Count vectors in the index
+     */
+    async count(namespace) {
+        var _a;
+        const stats = await this.getStats();
+        if (namespace && stats.namespaces) {
+            return ((_a = stats.namespaces[namespace]) === null || _a === void 0 ? void 0 : _a.vectorCount) || 0;
+        }
+        return stats.vectorCount;
+    }
+    /**
+     * Check if a vector exists
+     */
+    async exists(id, namespace) {
+        const result = await this.fetch({ ids: [id], namespace, includeValues: false });
+        return result.vectors[id] !== null;
+    }
+    // ==================== PRIVATE METHODS ====================
+    /**
+     * Create the appropriate adapter based on database type
+     */
+    createAdapter(dbType) {
+        switch (dbType) {
+            case types_1.VectorDBType.PINECONE:
+                return new adapters_1.PineconeAdapter();
+            case types_1.VectorDBType.QDRANT:
+                return new adapters_1.QdrantAdapter();
+            case types_1.VectorDBType.WEAVIATE:
+                return new adapters_1.WeaviateAdapter();
+            case types_1.VectorDBType.MEMORY:
+                return new adapters_1.MemoryAdapter();
+            case types_1.VectorDBType.CHROMA:
+            case types_1.VectorDBType.MILVUS:
+            case types_1.VectorDBType.PGVECTOR:
+                throw new Error(`Adapter for ${dbType} is not yet implemented`);
+            default:
+                throw new Error(`Unknown vector database type: ${dbType}`);
+        }
+    }
+    /**
+     * Ensure the service is connected
+     */
+    ensureConnected() {
+        if (!this._initialized || !this.adapter.connected) {
+            throw utils_1.VectorError.connectionError('Not connected. Call connect() first.', this.dbType);
+        }
+    }
+}
+exports.VectorService = VectorService;
+/**
+ * Create a vector service instance
+ *
+ * Factory function for creating vector service instances.
+ *
+ * @example
+ * ```typescript
+ * const vectors = createVectorService({
+ *   dbType: VectorDBType.MEMORY,
+ *   index: 'test',
+ *   dimensions: 384,
+ * });
+ * await vectors.connect();
+ * ```
+ */
+function createVectorService(options) {
+    return new VectorService(options);
+}
+/**
+ * Create an in-memory vector service (for development/testing)
+ *
+ * @example
+ * ```typescript
+ * const vectors = createMemoryVectorService('test', 384);
+ * await vectors.connect();
+ * ```
+ */
+function createMemoryVectorService(index, dimensions, metric) {
+    return createVectorService({
+        dbType: types_1.VectorDBType.MEMORY,
+        index,
+        dimensions,
+        metric,
+    });
+}
+exports.default = VectorService;
+//# sourceMappingURL=vector.service.js.map

package/dist/vector/vector.service.js.map

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

package/dist/workflows/index.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Ductape Workflows Module
+ *
+ * Provides code-first workflow API for building durable workflows
+ * with automatic state persistence, retries, and rollbacks.
+ *
+ * @example
+ * ```ts
+ * import { WorkflowService, WorkflowBuilder } from '@ductape/sdk';
+ *
+ * // Using the service
+ * const workflows = new WorkflowService(config);
+ * await workflows.create('my-product', { tag: 'my-workflow', ... });
+ *
+ * // Using the builder
+ * const workflow = new WorkflowBuilder('order-fulfillment')
+ *   .name('Order Fulfillment')
+ *   .step('validate')
+ *     .action('orders', 'validate')
+ *     .done()
+ *   .build();
+ * ```
+ */
+export { WorkflowService, WorkflowError, workflowService, IDefinedWorkflow } from './workflows.service';
+export { default as WorkflowServiceDefault } from './workflows.service';
+export { WorkflowBuilder, createWorkflow } from './workflow-builder';
+export { default as WorkflowBuilderDefault } from './workflow-builder';
+export { WorkflowExecutor, IResumeOptions } from './workflow-executor';
+export { default as WorkflowExecutorDefault } from './workflow-executor';
+export * from './types';