@ductape/sdk 0.0.4-v6 → 0.0.4-v60

package/dist/database/utils/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Utils Module
+ *
+ * Exports utility classes and functions.
+ */
+export { DatabaseError } from './database-error';

package/dist/database/utils/index.js

@@ -0,0 +1,11 @@
+"use strict";
+/**
+ * Utils Module
+ *
+ * Exports utility classes and functions.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DatabaseError = void 0;
+var database_error_1 = require("./database-error");
+Object.defineProperty(exports, "DatabaseError", { enumerable: true, get: function () { return database_error_1.DatabaseError; } });
+//# sourceMappingURL=index.js.map

package/dist/database/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/database/utils/index.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAEH,mDAAiD;AAAxC,+GAAA,aAAa,OAAA"}

package/dist/graph/adapters/adapter.factory.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Graph Adapter Factory
+ *
+ * Factory for creating graph database adapters based on type.
+ * Supports runtime registration of custom adapters.
+ */
+import { GraphType } from '../types/enums';
+import { BaseGraphAdapter } from './base.adapter';
+/**
+ * Factory for creating graph database adapters
+ */
+export declare class GraphAdapterFactory {
+    /**
+     * Map of adapter constructors by graph type
+     */
+    private adapterConstructors;
+    constructor();
+    /**
+     * Create an adapter instance for the specified graph type
+     * @param type Graph database type
+     * @returns New adapter instance
+     */
+    create(type: GraphType | string): BaseGraphAdapter;
+    /**
+     * Check if a graph type is supported
+     * @param type Graph type to check
+     * @returns True if supported
+     */
+    isSupported(type: GraphType | string): boolean;
+    /**
+     * Get all supported graph types
+     * @returns Array of supported graph types
+     */
+    getSupportedTypes(): (GraphType | string)[];
+    /**
+     * Register a custom adapter for a graph type
+     * @param type Graph type
+     * @param AdapterConstructor Adapter constructor
+     */
+    registerAdapter(type: GraphType | string, AdapterConstructor: new () => BaseGraphAdapter): void;
+    /**
+     * Unregister an adapter
+     * @param type Graph type to unregister
+     * @returns True if adapter was removed
+     */
+    unregisterAdapter(type: GraphType | string): boolean;
+}

package/dist/graph/adapters/adapter.factory.js

@@ -0,0 +1,77 @@
+"use strict";
+/**
+ * Graph Adapter Factory
+ *
+ * Factory for creating graph database adapters based on type.
+ * Supports runtime registration of custom adapters.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GraphAdapterFactory = void 0;
+const enums_1 = require("../types/enums");
+const neo4j_adapter_1 = require("./neo4j.adapter");
+const neptune_adapter_1 = require("./neptune.adapter");
+const arangodb_adapter_1 = require("./arangodb.adapter");
+const memgraph_adapter_1 = require("./memgraph.adapter");
+const graph_error_1 = require("../utils/graph-error");
+/**
+ * Factory for creating graph database adapters
+ */
+class GraphAdapterFactory {
+    constructor() {
+        this.adapterConstructors = new Map();
+        this.adapterConstructors.set(enums_1.GraphType.NEO4J, neo4j_adapter_1.Neo4jAdapter);
+        this.adapterConstructors.set(enums_1.GraphType.NEPTUNE, neptune_adapter_1.NeptuneAdapter);
+        this.adapterConstructors.set(enums_1.GraphType.ARANGODB, arangodb_adapter_1.ArangoDBAdapter);
+        this.adapterConstructors.set(enums_1.GraphType.MEMGRAPH, memgraph_adapter_1.MemgraphAdapter);
+    }
+    /**
+     * Create an adapter instance for the specified graph type
+     * @param type Graph database type
+     * @returns New adapter instance
+     */
+    create(type) {
+        const normalizedType = typeof type === 'string' ? type.toLowerCase() : type;
+        const AdapterConstructor = this.adapterConstructors.get(normalizedType);
+        if (!AdapterConstructor) {
+            throw graph_error_1.GraphError.configurationError(`Unsupported graph database type: ${type}. ` +
+                `Supported types: ${this.getSupportedTypes().join(', ')}`);
+        }
+        return new AdapterConstructor();
+    }
+    /**
+     * Check if a graph type is supported
+     * @param type Graph type to check
+     * @returns True if supported
+     */
+    isSupported(type) {
+        const normalizedType = typeof type === 'string' ? type.toLowerCase() : type;
+        return this.adapterConstructors.has(normalizedType);
+    }
+    /**
+     * Get all supported graph types
+     * @returns Array of supported graph types
+     */
+    getSupportedTypes() {
+        return Array.from(this.adapterConstructors.keys());
+    }
+    /**
+     * Register a custom adapter for a graph type
+     * @param type Graph type
+     * @param AdapterConstructor Adapter constructor
+     */
+    registerAdapter(type, AdapterConstructor) {
+        const normalizedType = typeof type === 'string' ? type.toLowerCase() : type;
+        this.adapterConstructors.set(normalizedType, AdapterConstructor);
+    }
+    /**
+     * Unregister an adapter
+     * @param type Graph type to unregister
+     * @returns True if adapter was removed
+     */
+    unregisterAdapter(type) {
+        const normalizedType = typeof type === 'string' ? type.toLowerCase() : type;
+        return this.adapterConstructors.delete(normalizedType);
+    }
+}
+exports.GraphAdapterFactory = GraphAdapterFactory;
+//# sourceMappingURL=adapter.factory.js.map

package/dist/graph/adapters/adapter.factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.factory.js","sourceRoot":"","sources":["../../../src/graph/adapters/adapter.factory.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAEH,0CAA2C;AAE3C,mDAA+C;AAC/C,uDAAmD;AACnD,yDAAqD;AACrD,yDAAqD;AACrD,sDAAkD;AAElD;;GAEG;AACH,MAAa,mBAAmB;IAM9B;QACE,IAAI,CAAC,mBAAmB,GAAG,IAAI,GAAG,EAAE,CAAC;QACrC,IAAI,CAAC,mBAAmB,CAAC,GAAG,CAAC,iBAAS,CAAC,KAAK,EAAE,4BAAY,CAAC,CAAC;QAC5D,IAAI,CAAC,mBAAmB,CAAC,GAAG,CAAC,iBAAS,CAAC,OAAO,EAAE,gCAAc,CAAC,CAAC;QAChE,IAAI,CAAC,mBAAmB,CAAC,GAAG,CAAC,iBAAS,CAAC,QAAQ,EAAE,kCAAe,CAAC,CAAC;QAClE,IAAI,CAAC,mBAAmB,CAAC,GAAG,CAAC,iBAAS,CAAC,QAAQ,EAAE,kCAAe,CAAC,CAAC;IACpE,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,IAAwB;QAC7B,MAAM,cAAc,GAAG,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;QAC5E,MAAM,kBAAkB,GAAG,IAAI,CAAC,mBAAmB,CAAC,GAAG,CAAC,cAA2B,CAAC,CAAC;QAErF,IAAI,CAAC,kBAAkB,EAAE,CAAC;YACxB,MAAM,wBAAU,CAAC,kBAAkB,CACjC,oCAAoC,IAAI,IAAI;gBAC5C,oBAAoB,IAAI,CAAC,iBAAiB,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAC1D,CAAC;QACJ,CAAC;QAED,OAAO,IAAI,kBAAkB,EAAE,CAAC;IAClC,CAAC;IAED;;;;OAIG;IACH,WAAW,CAAC,IAAwB;QAClC,MAAM,cAAc,GAAG,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;QAC5E,OAAO,IAAI,CAAC,mBAAmB,CAAC,GAAG,CAAC,cAA2B,CAAC,CAAC;IACnE,CAAC;IAED;;;OAGG;IACH,iBAAiB;QACf,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,mBAAmB,CAAC,IAAI,EAAE,CAAC,CAAC;IACrD,CAAC;IAED;;;;OAIG;IACH,eAAe,CAAC,IAAwB,EAAE,kBAA8C;QACtF,MAAM,cAAc,GAAG,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;QAC5E,IAAI,CAAC,mBAAmB,CAAC,GAAG,CAAC,cAA2B,EAAE,kBAAkB,CAAC,CAAC;IAChF,CAAC;IAED;;;;OAIG;IACH,iBAAiB,CAAC,IAAwB;QACxC,MAAM,cAAc,GAAG,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;QAC5E,OAAO,IAAI,CAAC,mBAAmB,CAAC,MAAM,CAAC,cAA2B,CAAC,CAAC;IACtE,CAAC;CACF;AAtED,kDAsEC"}

package/dist/graph/adapters/arangodb.adapter.d.ts

@@ -0,0 +1,86 @@
+/**
+ * ArangoDB Graph Database Adapter
+ *
+ * Implements the BaseGraphAdapter for ArangoDB.
+ * ArangoDB is a multi-model database that supports documents, graphs, and key-value.
+ * Uses AQL (ArangoDB Query Language) for graph operations.
+ */
+import { BaseGraphAdapter, IAdapterConnectionOptions } from './base.adapter';
+import { GraphType, GraphFeature } from '../types/enums';
+import { IGraphConnectionResult, IGraphTestConnectionResult } from '../types/connection.interface';
+import { ICreateNodeOptions, ICreateNodeResult, IFindNodesOptions, IFindNodesResult, IUpdateNodeOptions, IUpdateNodeResult, IDeleteNodeOptions, IDeleteNodeResult, IMergeNodeOptions, IMergeNodeResult, INode, IAddLabelsOptions, IAddLabelsResult, IRemoveLabelsOptions, IRemoveLabelsResult, ISetLabelsOptions, ISetLabelsResult } from '../types/node.interface';
+import { ICreateRelationshipOptions, ICreateRelationshipResult, IFindRelationshipsOptions, IFindRelationshipsResult, IUpdateRelationshipOptions, IUpdateRelationshipResult, IDeleteRelationshipOptions, IDeleteRelationshipResult, IMergeRelationshipOptions, IMergeRelationshipResult, IRelationship, ICreateRelationshipIndexOptions } from '../types/relationship.interface';
+import { ITraverseOptions, ITraverseResult, IShortestPathOptions, IShortestPathResult, IAllPathsOptions, IAllPathsResult, INeighborhoodOptions, INeighborhoodResult, IConnectedComponentsOptions, IConnectedComponentsResult } from '../types/traversal.interface';
+import { IGraphTransaction } from '../types/transaction.interface';
+import { IRawQueryOptions, IRawQueryResult, ICountNodesResult, ICountRelationshipsResult, IGraphStatistics, IFullTextSearchOptions, IFullTextSearchResult, IVectorSearchOptions, IVectorSearchResult, IGraphWhereClause } from '../types/query.interface';
+import { ICreateNodeIndexOptions, ICreateNodeConstraintOptions, IListIndexesResult, IListConstraintsResult, ICreateIndexResult, ICreateConstraintResult, IDropIndexResult, IDropConstraintResult, IListLabelsResult, IListRelationshipTypesResult } from '../types/schema.interface';
+/**
+ * ArangoDB adapter using arangojs
+ */
+export declare class ArangoDBAdapter extends BaseGraphAdapter {
+    protected readonly graphType = GraphType.ARANGODB;
+    protected readonly supportedFeatures: Set<GraphFeature>;
+    private db;
+    private graph;
+    private graphName;
+    private vertexCollections;
+    private edgeCollections;
+    /**
+     * Connect to ArangoDB
+     */
+    connect(options: IAdapterConnectionOptions): Promise<IGraphConnectionResult>;
+    private getVersion;
+    /**
+     * Disconnect from ArangoDB
+     */
+    disconnect(): Promise<void>;
+    /**
+     * Test ArangoDB connection
+     */
+    testConnection(options: IAdapterConnectionOptions): Promise<IGraphTestConnectionResult>;
+    createNode<T>(options: ICreateNodeOptions<T>, transaction?: IGraphTransaction): Promise<ICreateNodeResult<T>>;
+    findNodes<T>(options: IFindNodesOptions, transaction?: IGraphTransaction): Promise<IFindNodesResult<T>>;
+    findNodeById<T>(id: string | number, transaction?: IGraphTransaction): Promise<INode<T> | null>;
+    updateNode<T>(options: IUpdateNodeOptions<T>, transaction?: IGraphTransaction): Promise<IUpdateNodeResult<T>>;
+    deleteNode(options: IDeleteNodeOptions, transaction?: IGraphTransaction): Promise<IDeleteNodeResult>;
+    mergeNode<T>(options: IMergeNodeOptions<T>, transaction?: IGraphTransaction): Promise<IMergeNodeResult<T>>;
+    addLabels<T = any>(options: IAddLabelsOptions, _transaction?: IGraphTransaction): Promise<IAddLabelsResult<T>>;
+    removeLabels<T = any>(options: IRemoveLabelsOptions, _transaction?: IGraphTransaction): Promise<IRemoveLabelsResult<T>>;
+    setLabels<T = any>(options: ISetLabelsOptions, _transaction?: IGraphTransaction): Promise<ISetLabelsResult<T>>;
+    createRelationship<T>(options: ICreateRelationshipOptions<T>, transaction?: IGraphTransaction): Promise<ICreateRelationshipResult<T>>;
+    findRelationships<T>(options: IFindRelationshipsOptions, transaction?: IGraphTransaction): Promise<IFindRelationshipsResult<T>>;
+    findRelationshipById<T>(id: string | number, transaction?: IGraphTransaction): Promise<IRelationship<T> | null>;
+    updateRelationship<T>(options: IUpdateRelationshipOptions<T>, transaction?: IGraphTransaction): Promise<IUpdateRelationshipResult<T>>;
+    deleteRelationship(options: IDeleteRelationshipOptions, transaction?: IGraphTransaction): Promise<IDeleteRelationshipResult>;
+    mergeRelationship<T>(options: IMergeRelationshipOptions<T>, transaction?: IGraphTransaction): Promise<IMergeRelationshipResult<T>>;
+    traverse<TNode, TRel>(options: ITraverseOptions, transaction?: IGraphTransaction): Promise<ITraverseResult<TNode, TRel>>;
+    shortestPath<TNode, TRel>(options: IShortestPathOptions, transaction?: IGraphTransaction): Promise<IShortestPathResult<TNode, TRel>>;
+    allPaths<TNode, TRel>(options: IAllPathsOptions, transaction?: IGraphTransaction): Promise<IAllPathsResult<TNode, TRel>>;
+    getNeighborhood<TNode, TRel>(options: INeighborhoodOptions, transaction?: IGraphTransaction): Promise<INeighborhoodResult<TNode, TRel>>;
+    findConnectedComponents<TNode>(options: IConnectedComponentsOptions, transaction?: IGraphTransaction): Promise<IConnectedComponentsResult<TNode>>;
+    countNodes(labels?: string[], where?: IGraphWhereClause, transaction?: IGraphTransaction): Promise<ICountNodesResult>;
+    countRelationships(types?: string[], where?: IGraphWhereClause, transaction?: IGraphTransaction): Promise<ICountRelationshipsResult>;
+    getStatistics(transaction?: IGraphTransaction): Promise<IGraphStatistics>;
+    fullTextSearch<T>(options: IFullTextSearchOptions, transaction?: IGraphTransaction): Promise<IFullTextSearchResult<T>>;
+    vectorSearch<T>(options: IVectorSearchOptions, transaction?: IGraphTransaction): Promise<IVectorSearchResult<T>>;
+    query<T>(options: IRawQueryOptions, transaction?: IGraphTransaction): Promise<IRawQueryResult<T>>;
+    createNodeIndex(options: ICreateNodeIndexOptions): Promise<ICreateIndexResult>;
+    createNodeConstraint(options: ICreateNodeConstraintOptions): Promise<ICreateConstraintResult>;
+    createRelationshipIndex(options: ICreateRelationshipIndexOptions): Promise<ICreateIndexResult>;
+    listIndexes(): Promise<IListIndexesResult>;
+    listConstraints(): Promise<IListConstraintsResult>;
+    dropIndex(name: string): Promise<IDropIndexResult>;
+    dropConstraint(name: string): Promise<IDropConstraintResult>;
+    listLabels(): Promise<IListLabelsResult>;
+    listRelationshipTypes(): Promise<IListRelationshipTypesResult>;
+    beginTransaction(): Promise<IGraphTransaction>;
+    commitTransaction(transaction: IGraphTransaction): Promise<void>;
+    rollbackTransaction(transaction: IGraphTransaction): Promise<void>;
+    private mapDirection;
+    private mapIndexType;
+    protected buildWhereClause(where: IGraphWhereClause): any;
+    parseError(error: unknown): Error;
+    private buildArangoWhereClause;
+    private cleanArangoProps;
+    private resolveNodeId;
+}