@ductape/sdk 0.0.4-v51 → 0.0.4-v52

package/dist/graph/types/node.interface.d.ts

@@ -0,0 +1,248 @@
+/**
+ * Graph Node Interfaces
+ *
+ * Types for node CRUD operations
+ * Based on Ductape Graph API documentation (nodes.md, overview.md)
+ */
+import { IGraphWhereClause } from './query.interface';
+/**
+ * Generic node properties type
+ */
+export type NodeProperties = Record<string, any>;
+/**
+ * Node structure
+ * As documented in nodes.md
+ */
+export interface INode<T = NodeProperties> {
+    /** Database-specific ID */
+    id: string | number;
+    /** Node labels/types */
+    labels: string[];
+    /** Node properties */
+    properties: T;
+    /** Neo4j 5.x element ID */
+    elementId?: string;
+    /** Distance from start node (for traversals) */
+    distance?: number;
+}
+/**
+ * Options for creating a node
+ * As documented in nodes.md
+ */
+export interface ICreateNodeOptions<T = NodeProperties> {
+    /** Node labels (e.g., ['Person', 'User']) */
+    labels: string[];
+    /** Node properties */
+    properties: T;
+}
+/**
+ * Result of creating a node
+ * As documented in nodes.md
+ */
+export interface ICreateNodeResult<T = NodeProperties> {
+    /** The created node */
+    node: INode<T>;
+    /** Always true for create */
+    created: boolean;
+}
+/**
+ * Options for finding nodes
+ * As documented in nodes.md
+ */
+export interface IFindNodesOptions {
+    /** Node labels to filter by */
+    labels?: string[];
+    /** Filter conditions */
+    where?: IGraphWhereClause;
+    /** Maximum number of results */
+    limit?: number;
+    /** Number of results to skip */
+    offset?: number;
+    /** Number of results to skip (alias for offset) */
+    skip?: number;
+    /** Order by properties */
+    orderBy?: IGraphOrderBy[];
+    /** Properties to return (projection) */
+    select?: string[];
+    /** Cache tag for result caching */
+    cache?: string;
+}
+/**
+ * Order by specification
+ */
+export interface IGraphOrderBy {
+    /** Property name */
+    property: string;
+    /** Sort direction */
+    direction: 'asc' | 'desc' | 'ASC' | 'DESC';
+}
+/**
+ * Result of finding nodes
+ * As documented in nodes.md
+ */
+export interface IFindNodesResult<T = NodeProperties> {
+    /** Array of matching nodes */
+    nodes: INode<T>[];
+    /** Total count (for pagination) */
+    count?: number;
+    /** Total count (alias for count) */
+    total?: number;
+}
+/**
+ * Options for updating a node
+ * As documented in nodes.md
+ */
+export interface IUpdateNodeOptions<T = NodeProperties> {
+    /** Node ID to update */
+    id?: string | number;
+    /** Node labels to filter by (for batch update) */
+    labels?: string[];
+    /** Filter conditions (for batch update) */
+    where?: IGraphWhereClause;
+    /** Properties to update */
+    properties: Partial<T> | INodePropertyUpdate;
+}
+/**
+ * Property update operations
+ * As documented in nodes.md
+ */
+export interface INodePropertyUpdate {
+    [key: string]: any | {
+        $INCREMENT: number;
+    } | {
+        $SET: any;
+    } | {
+        $UNSET: boolean;
+    };
+}
+/**
+ * Result of updating a node
+ * As documented in nodes.md
+ */
+export interface IUpdateNodeResult<T = NodeProperties> {
+    /** Updated node (if single update) */
+    node?: INode<T>;
+    /** Updated nodes (if batch update) */
+    nodes?: INode<T>[];
+    /** Number of nodes updated */
+    updatedCount?: number;
+    /** Whether the node was updated */
+    updated?: boolean;
+}
+/**
+ * Options for deleting a node
+ * As documented in nodes.md
+ */
+export interface IDeleteNodeOptions {
+    /** Node ID to delete */
+    id?: string | number;
+    /** Node labels to filter by (for batch delete) */
+    labels?: string[];
+    /** Filter conditions (for batch delete) */
+    where?: IGraphWhereClause;
+    /** Also delete connected relationships */
+    detach?: boolean;
+}
+/**
+ * Result of deleting a node
+ * As documented in nodes.md
+ */
+export interface IDeleteNodeResult {
+    /** Whether deletion succeeded */
+    deleted: boolean;
+    /** Number of nodes deleted */
+    deletedCount?: number;
+    /** ID of deleted node */
+    id?: string | number;
+}
+/**
+ * Options for merge (upsert) operation
+ * As documented in nodes.md
+ */
+export interface IMergeNodeOptions<T = NodeProperties> {
+    /** Node labels */
+    labels: string[];
+    /** Properties to match on */
+    matchProperties: Partial<T>;
+    /** Properties to set if node is created */
+    onCreate?: Partial<T>;
+    /** Properties to set if node already exists */
+    onMatch?: Partial<T> | INodePropertyUpdate;
+}
+/**
+ * Result of merge operation
+ * As documented in nodes.md
+ */
+export interface IMergeNodeResult<T = NodeProperties> {
+    /** The resulting node */
+    node: INode<T>;
+    /** true if created, false if matched */
+    created: boolean;
+    /** Whether the merge operation completed */
+    merged?: boolean;
+}
+/**
+ * Node filter for traversals
+ */
+export interface INodeFilter {
+    /** Labels to filter by */
+    labels?: string[];
+    /** Property filter conditions */
+    where?: IGraphWhereClause;
+}
+/**
+ * Options for adding labels to a node
+ */
+export interface IAddLabelsOptions {
+    /** Node ID */
+    id: string | number;
+    /** Labels to add */
+    labels: string[];
+}
+/**
+ * Result of adding labels
+ */
+export interface IAddLabelsResult<T = NodeProperties> {
+    /** Updated node with new labels */
+    node: INode<T>;
+    /** Labels that were added */
+    addedLabels: string[];
+}
+/**
+ * Options for removing labels from a node
+ */
+export interface IRemoveLabelsOptions {
+    /** Node ID */
+    id: string | number;
+    /** Labels to remove */
+    labels: string[];
+}
+/**
+ * Result of removing labels
+ */
+export interface IRemoveLabelsResult<T = NodeProperties> {
+    /** Updated node without removed labels */
+    node: INode<T>;
+    /** Labels that were removed */
+    removedLabels: string[];
+}
+/**
+ * Options for setting labels on a node (replaces all existing labels)
+ */
+export interface ISetLabelsOptions {
+    /** Node ID */
+    id: string | number;
+    /** New labels to set (replaces existing) */
+    labels: string[];
+}
+/**
+ * Result of setting labels
+ */
+export interface ISetLabelsResult<T = NodeProperties> {
+    /** Updated node with new labels */
+    node: INode<T>;
+    /** Previous labels */
+    previousLabels: string[];
+    /** New labels */
+    newLabels: string[];
+}

package/dist/graph/types/node.interface.js

@@ -0,0 +1,9 @@
+"use strict";
+/**
+ * Graph Node Interfaces
+ *
+ * Types for node CRUD operations
+ * Based on Ductape Graph API documentation (nodes.md, overview.md)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=node.interface.js.map

package/dist/graph/types/node.interface.js.map

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

package/dist/graph/types/query.interface.d.ts

@@ -0,0 +1,168 @@
+/**
+ * Graph Query Interfaces
+ *
+ * Types for query operations and filter clauses
+ * Based on Ductape Graph API documentation (nodes.md, overview.md)
+ */
+/**
+ * Filter operators for graph queries
+ * As documented in nodes.md
+ */
+export interface IGraphFilterOperator {
+    /** Greater than */
+    $GT?: number | Date;
+    /** Greater than or equal */
+    $GTE?: number | Date;
+    /** Less than */
+    $LT?: number | Date;
+    /** Less than or equal */
+    $LTE?: number | Date;
+    /** Not equal */
+    $NE?: any;
+    /** In array */
+    $IN?: any[];
+    /** Not in array */
+    $NOT_IN?: any[];
+    /** String contains */
+    $CONTAINS?: string;
+    /** String starts with */
+    $STARTS_WITH?: string;
+    /** String ends with */
+    $ENDS_WITH?: string;
+    /** Property exists */
+    $EXISTS?: boolean;
+}
+/**
+ * Where clause for filtering
+ * As documented in nodes.md
+ */
+export interface IGraphWhereClause {
+    /** AND conditions */
+    $AND?: IGraphWhereClause;
+    /** OR conditions */
+    $OR?: IGraphWhereClause;
+    /** Property conditions */
+    [key: string]: any | IGraphFilterOperator | IGraphWhereClause | undefined;
+}
+/**
+ * Raw query options
+ * As documented in overview.md
+ */
+export interface IRawQueryOptions {
+    /** The query string (Cypher, Gremlin, AQL) */
+    query: string;
+    /** Query parameters */
+    params?: Record<string, any>;
+    /** Connection context override */
+    env?: string;
+    /** Graph tag override */
+    graph?: string;
+}
+/**
+ * Raw query result
+ */
+export interface IRawQueryResult<T = any> {
+    /** Query results */
+    records: T[];
+    /** Summary information */
+    summary?: {
+        /** Query execution time */
+        resultAvailableAfter?: number;
+        /** Query consumption time */
+        resultConsumedAfter?: number;
+        /** Database info */
+        database?: string;
+    };
+}
+/**
+ * Count nodes options
+ * As documented in overview.md
+ */
+export interface ICountNodesOptions {
+    /** Node labels to count */
+    labels?: string[];
+    /** Filter conditions */
+    where?: IGraphWhereClause;
+}
+/**
+ * Count nodes result
+ */
+export interface ICountNodesResult {
+    /** Count of matching nodes */
+    count: number;
+}
+/**
+ * Count relationships options
+ * As documented in overview.md
+ */
+export interface ICountRelationshipsOptions {
+    /** Relationship types to count */
+    types?: string[];
+    /** Filter conditions */
+    where?: IGraphWhereClause;
+}
+/**
+ * Count relationships result
+ */
+export interface ICountRelationshipsResult {
+    /** Count of matching relationships */
+    count: number;
+}
+/**
+ * Graph statistics
+ * As documented in overview.md
+ */
+export interface IGraphStatistics {
+    /** Total number of nodes */
+    nodeCount: number;
+    /** Total number of relationships */
+    relationshipCount: number;
+    /** Node count by label */
+    nodesByLabel?: Record<string, number>;
+    /** Relationship count by type */
+    relationshipsByType?: Record<string, number>;
+}
+/**
+ * Full-text search options
+ * As documented in overview.md
+ */
+export interface IFullTextSearchOptions {
+    /** Index name */
+    indexName: string;
+    /** Search query */
+    query: string;
+    /** Maximum results */
+    limit?: number;
+}
+/**
+ * Full-text search result
+ */
+export interface IFullTextSearchResult<T = any> {
+    /** Matching nodes */
+    nodes: T[];
+    /** Search scores */
+    scores?: number[];
+}
+/**
+ * Vector search options
+ * As documented in overview.md
+ */
+export interface IVectorSearchOptions {
+    /** Index name */
+    indexName: string;
+    /** Search vector */
+    vector: number[];
+    /** Number of results (top-k) */
+    topK?: number;
+    /** Minimum similarity threshold */
+    minScore?: number;
+}
+/**
+ * Vector search result
+ */
+export interface IVectorSearchResult<T = any> {
+    /** Matching nodes */
+    nodes: T[];
+    /** Similarity scores */
+    scores: number[];
+}

package/dist/graph/types/query.interface.js

@@ -0,0 +1,9 @@
+"use strict";
+/**
+ * Graph Query Interfaces
+ *
+ * Types for query operations and filter clauses
+ * Based on Ductape Graph API documentation (nodes.md, overview.md)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=query.interface.js.map

package/dist/graph/types/query.interface.js.map

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

package/dist/graph/types/relationship.interface.d.ts

@@ -0,0 +1,207 @@
+/**
+ * Graph Relationship Interfaces
+ *
+ * Types for relationship CRUD operations
+ * Based on Ductape Graph API documentation (relationships.md, overview.md)
+ */
+import { IGraphWhereClause } from './query.interface';
+/**
+ * Generic relationship properties type
+ */
+export type RelationshipProperties = Record<string, any>;
+/**
+ * Relationship structure
+ * As documented in relationships.md
+ */
+export interface IRelationship<T = RelationshipProperties> {
+    /** Database-specific ID */
+    id: string | number;
+    /** Relationship type */
+    type: string;
+    /** Source node ID */
+    startNodeId: string | number;
+    /** Target node ID */
+    endNodeId: string | number;
+    /** Relationship properties */
+    properties: T;
+    /** Neo4j 5.x element ID */
+    elementId?: string;
+}
+/**
+ * Options for creating a relationship
+ * As documented in relationships.md
+ */
+export interface ICreateRelationshipOptions<T = RelationshipProperties> {
+    /** Relationship type (e.g., 'FRIENDS_WITH', 'MANAGES') */
+    type: string;
+    /** Source node ID */
+    startNodeId: string | number;
+    /** Target node ID */
+    endNodeId: string | number;
+    /** Relationship properties */
+    properties?: T;
+}
+/**
+ * Result of creating a relationship
+ * As documented in relationships.md
+ */
+export interface ICreateRelationshipResult<T = RelationshipProperties> {
+    /** The created relationship */
+    relationship: IRelationship<T>;
+    /** Always true for create */
+    created: boolean;
+}
+/**
+ * Options for finding relationships
+ * As documented in relationships.md
+ */
+export interface IFindRelationshipsOptions {
+    /** Relationship type(s) to filter by */
+    type?: string | string[];
+    /** Relationship types to filter by (alias for type) */
+    types?: string[];
+    /** Filter by source node ID */
+    startNodeId?: string | number;
+    /** Filter by target node ID */
+    endNodeId?: string | number;
+    /** Filter conditions on properties */
+    where?: IGraphWhereClause;
+    /** Maximum number of results */
+    limit?: number;
+    /** Number of results to skip */
+    offset?: number;
+    /** Number of results to skip (alias for offset) */
+    skip?: number;
+}
+/**
+ * Result of finding relationships
+ * As documented in relationships.md
+ */
+export interface IFindRelationshipsResult<T = RelationshipProperties> {
+    /** Array of matching relationships */
+    relationships: IRelationship<T>[];
+    /** Total count (for pagination) */
+    count?: number;
+    /** Total count (alias for count) */
+    total?: number;
+}
+/**
+ * Options for updating a relationship
+ * As documented in relationships.md
+ */
+export interface IUpdateRelationshipOptions<T = RelationshipProperties> {
+    /** Relationship ID to update */
+    id?: string | number;
+    /** Relationship type to filter by (for batch update) */
+    type?: string;
+    /** Filter conditions (for batch update) */
+    where?: IGraphWhereClause;
+    /** Properties to update */
+    properties: Partial<T> | IRelationshipPropertyUpdate;
+}
+/**
+ * Property update operations
+ * As documented in relationships.md
+ */
+export interface IRelationshipPropertyUpdate {
+    [key: string]: any | {
+        $INCREMENT: number;
+    } | {
+        $SET: any;
+    } | {
+        $UNSET: boolean;
+    };
+}
+/**
+ * Result of updating a relationship
+ * As documented in relationships.md
+ */
+export interface IUpdateRelationshipResult<T = RelationshipProperties> {
+    /** Updated relationship (if single update) */
+    relationship?: IRelationship<T>;
+    /** Updated relationships (if batch update) */
+    relationships?: IRelationship<T>[];
+    /** Number of relationships updated */
+    updatedCount?: number;
+    /** Whether the relationship was updated */
+    updated?: boolean;
+}
+/**
+ * Options for deleting a relationship
+ * As documented in relationships.md
+ */
+export interface IDeleteRelationshipOptions {
+    /** Relationship ID to delete */
+    id?: string | number;
+    /** Relationship type to filter by (for batch delete) */
+    type?: string;
+    /** Filter by source node ID */
+    startNodeId?: string | number;
+    /** Filter by target node ID */
+    endNodeId?: string | number;
+    /** Filter conditions (for batch delete) */
+    where?: IGraphWhereClause;
+}
+/**
+ * Result of deleting a relationship
+ * As documented in relationships.md
+ */
+export interface IDeleteRelationshipResult {
+    /** Whether deletion succeeded */
+    deleted: boolean;
+    /** Number of relationships deleted */
+    deletedCount?: number;
+    /** ID of deleted relationship */
+    id?: string | number;
+}
+/**
+ * Options for merge (upsert) relationship operation
+ * As documented in relationships.md
+ */
+export interface IMergeRelationshipOptions<T = RelationshipProperties> {
+    /** Relationship type */
+    type: string;
+    /** Source node ID */
+    startNodeId: string | number;
+    /** Target node ID */
+    endNodeId: string | number;
+    /** Properties to match on */
+    matchProperties?: Partial<T>;
+    /** Properties to set if relationship is created */
+    onCreate?: Partial<T>;
+    /** Properties to set if relationship already exists */
+    onMatch?: Partial<T> | IRelationshipPropertyUpdate;
+}
+/**
+ * Result of merge relationship operation
+ * As documented in relationships.md
+ */
+export interface IMergeRelationshipResult<T = RelationshipProperties> {
+    /** The resulting relationship */
+    relationship: IRelationship<T>;
+    /** true if created, false if matched */
+    created: boolean;
+    /** Whether the merge operation completed */
+    merged?: boolean;
+}
+/**
+ * Relationship filter for traversals
+ */
+export interface IRelationshipFilter {
+    /** Types to filter by */
+    types?: string[];
+    /** Property filter conditions */
+    where?: IGraphWhereClause;
+}
+/**
+ * Options for creating relationship index
+ * As documented in relationships.md
+ */
+export interface ICreateRelationshipIndexOptions {
+    /** Index name */
+    name: string;
+    /** Relationship type */
+    type: string;
+    /** Properties to index */
+    properties: string[];
+}

package/dist/graph/types/relationship.interface.js

@@ -0,0 +1,9 @@
+"use strict";
+/**
+ * Graph Relationship Interfaces
+ *
+ * Types for relationship CRUD operations
+ * Based on Ductape Graph API documentation (relationships.md, overview.md)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=relationship.interface.js.map

package/dist/graph/types/relationship.interface.js.map

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