@lucern/sdk 0.2.0-alpha.5 → 0.2.0-alpha.7

package/dist/lib/platform/sdk/graphClient.d.ts

@@ -1,266 +0,0 @@
-import { type GatewayClientConfig, LucernApiError } from "./coreClient";
-import type { DeleteEdgeResponse, GraphAnalyticsMetric, GraphAnalyticsResponse, GraphNeighborhoodResponse, GraphPathResponse, JsonObject, ListResult, PlatformGraphEdge, PlatformGraphNode, TextAliasInput, TopicIdentifierInput } from "./types";
-export { LucernApiError };
-export type { GatewayScope, PlatformGatewaySuccess } from "./coreClient";
-export type { CreateEdgeResponse, CreateNodeResponse, DeleteEdgeResponse, GraphAnalyticsMetric, GraphAnalyticsResponse, GraphNeighborhoodResponse, GraphPathResponse, ListResult, QueryEdgesResponse, QueryNodesResponse, UpdateNodeResponse, } from "./types";
-/** Configuration for the graph client. */
-export type GraphClientConfig = GatewayClientConfig;
-/** Filter parameters for listing graph nodes. */
-export type ListNodesInput = {
-    nodeId?: string;
-    globalId?: string;
-    topicId?: string;
-    nodeType?: string;
-    limit?: number;
-} & TopicIdentifierInput;
-/** Paginated list response containing graph nodes. */
-export type ListNodesResponse = ListResult<PlatformGraphNode, "nodes">;
-/** @deprecated Use ListNodesInput. */
-export type QueryNodesInput = ListNodesInput;
-/** Input for creating a new graph node. */
-export type CreateNodeInput = {
-    text?: string;
-    /** @deprecated Use text. */
-    canonicalText?: string;
-    nodeType: string;
-    topicId?: string;
-    content?: string;
-    contentHash?: string;
-    globalId?: string;
-    sourceType?: string;
-    subtype?: string;
-    title?: string;
-    confidence?: number;
-    status?: string;
-    tags?: string[];
-    metadata?: JsonObject;
-    verificationStatus?: string;
-} & TextAliasInput & TopicIdentifierInput;
-/** Input for updating an existing graph node. */
-export type UpdateNodeInput = {
-    nodeId: string;
-    text?: string;
-    canonicalText?: string;
-    content?: string;
-    contentHash?: string;
-    title?: string;
-    subtype?: string;
-    confidence?: number;
-    status?: string;
-    tags?: string[];
-    metadata?: JsonObject;
-    verificationStatus?: string;
-} & TextAliasInput;
-/** Input for retrieving a single graph node by canonical identifier. */
-export type GetNodeInput = {
-    nodeId?: string;
-    globalId?: string;
-};
-/** Filter parameters for listing graph edges. */
-export type ListEdgesInput = {
-    edgeId?: string;
-    topicId?: string;
-    fromNodeId?: string;
-    toNodeId?: string;
-    edgeType?: string;
-    limit?: number;
-} & TopicIdentifierInput;
-/** Paginated list response containing graph edges. */
-export type ListEdgesResponse = ListResult<PlatformGraphEdge, "edges">;
-/** @deprecated Use ListEdgesInput. */
-export type QueryEdgesInput = ListEdgesInput;
-/** Input for creating a typed edge between two graph nodes. */
-export type CreateEdgeInput = {
-    fromNodeId: string;
-    toNodeId: string;
-    edgeType: string;
-    globalId?: string;
-    topicId?: string;
-    confidence?: number;
-    weight?: number;
-    context?: string;
-    derivationType?: string;
-} & TopicIdentifierInput;
-/** Filter for selecting edges to delete. */
-export type DeleteEdgeInput = {
-    edgeId?: string;
-    fromNodeId?: string;
-    toNodeId?: string;
-    edgeType?: string;
-};
-/** Input for batch-creating multiple graph nodes. */
-export type BatchCreateNodesInput = {
-    nodes: Array<CreateNodeInput>;
-};
-/** Input for superseding an existing graph node with a new version. */
-export type SupersedeNodeInput = {
-    oldNodeId?: string;
-    nodeId?: string;
-    newGlobalId?: string;
-    newCanonicalText?: string;
-    text?: string;
-    canonicalText?: string;
-    newContentHash?: string;
-    reason?: string;
-};
-/** Input for updating a node's verification state. */
-export type VerifyNodeInput = {
-    nodeId?: string;
-    id?: string;
-    verificationStatus: string;
-    confidence?: number;
-};
-/** Input for permanently deleting a node via admin-only API. */
-export type HardDeleteNodeInput = {
-    nodeId?: string;
-    id?: string;
-    reason: string;
-    allowBeliefHardDelete?: boolean;
-};
-/** Input for retrieving the local neighborhood around a graph node. */
-export type NeighborhoodInput = {
-    globalId?: string;
-    globalIds?: string;
-    maxDepth?: number;
-};
-/** Input for finding the shortest path between two graph nodes. */
-export type PathInput = {
-    fromGlobalId: string;
-    toGlobalId: string;
-    maxDepth?: number;
-};
-/** Input for retrieving a specific graph analytics metric. */
-export type AnalyticsInput = {
-    metric?: GraphAnalyticsMetric;
-    limit?: number;
-};
-/** Input for traversing the graph from a starting node. */
-export type TraverseInput = {
-    startNode: string;
-    direction?: string;
-    maxDepth?: number;
-    topicId?: string;
-} & TopicIdentifierInput;
-/** Input for structural analysis of a topic graph. */
-export type AnalyzeInput = {
-    topicId?: string;
-    metric?: GraphAnalyticsMetric;
-    limit?: number;
-} & TopicIdentifierInput;
-/** Input for detecting confirmation-bias patterns in a topic graph. */
-export type BiasInput = {
-    topicId?: string;
-    threshold?: number;
-    limit?: number;
-} & TopicIdentifierInput;
-/** Input for finding beliefs without sufficient testing questions. */
-export type GapsInput = {
-    topicId?: string;
-    minConfidence?: number;
-} & TopicIdentifierInput;
-/** Input for cross-resource search within a topic scope. */
-export type SearchInput = {
-    q?: string;
-    query?: string;
-    topicId?: string;
-    types?: string[];
-    status?: string;
-    minConfidence?: number;
-    limit?: number;
-    cursor?: string;
-} & TopicIdentifierInput;
-/**
- * Create the low-level graph client for nodes, edges, and graph analytics.
- * @param config - Gateway transport configuration.
- * @returns An object with methods for CRUD on nodes/edges plus analytics, traversal, and search.
- */
-export declare function createGraphClient(config?: GraphClientConfig): {
-    /**
-     * List graph nodes matching the provided filters.
-     */
-    listNodes(query: ListNodesInput): Promise<import("./coreClient").PlatformGatewaySuccess<ListResult<PlatformGraphNode, "nodes">>>;
-    /**
-     * @deprecated Use listNodes.
-     */
-    queryNodes(query: QueryNodesInput): Promise<import("./coreClient").PlatformGatewaySuccess<ListResult<PlatformGraphNode, "nodes">>>;
-    /**
-     * Retrieve a single graph node by nodeId or globalId.
-     */
-    getNode(query: GetNodeInput): Promise<import("./coreClient").PlatformGatewaySuccess<PlatformGraphNode>>;
-    /**
-     * Create a graph node.
-     */
-    createNode(input: CreateNodeInput, idempotencyKey?: string): Promise<import("./coreClient").PlatformGatewaySuccess<PlatformGraphNode>>;
-    /**
-     * Update a graph node.
-     */
-    updateNode(input: UpdateNodeInput, idempotencyKey?: string): Promise<import("./coreClient").PlatformGatewaySuccess<PlatformGraphNode>>;
-    /**
-     * Batch create graph nodes through the admin route surface.
-     */
-    batchCreateNodes(input: BatchCreateNodesInput, idempotencyKey?: string): Promise<import("./coreClient").PlatformGatewaySuccess<Record<string, unknown>>>;
-    /**
-     * Supersede an existing graph node with a new canonical version.
-     */
-    supersedeNode(input: SupersedeNodeInput, idempotencyKey?: string): Promise<import("./coreClient").PlatformGatewaySuccess<Record<string, unknown>>>;
-    /**
-     * Update a node's verification status.
-     */
-    verifyNode(input: VerifyNodeInput, idempotencyKey?: string): Promise<import("./coreClient").PlatformGatewaySuccess<Record<string, unknown>>>;
-    /**
-     * Permanently delete a node via the admin-only hard-delete route.
-     */
-    hardDeleteNode(input: HardDeleteNodeInput, idempotencyKey?: string): Promise<import("./coreClient").PlatformGatewaySuccess<Record<string, unknown>>>;
-    /**
-     * List graph edges matching the provided filters.
-     */
-    listEdges(query: ListEdgesInput): Promise<import("./coreClient").PlatformGatewaySuccess<ListResult<PlatformGraphEdge, "edges">>>;
-    /**
-     * @deprecated Use listEdges.
-     */
-    queryEdges(query: QueryEdgesInput): Promise<import("./coreClient").PlatformGatewaySuccess<ListResult<PlatformGraphEdge, "edges">>>;
-    /**
-     * Create a graph edge.
-     */
-    createEdge(input: CreateEdgeInput, idempotencyKey?: string): Promise<import("./coreClient").PlatformGatewaySuccess<PlatformGraphEdge>>;
-    /**
-     * Delete one or more edges matching the provided filter.
-     */
-    deleteEdge(query: DeleteEdgeInput, idempotencyKey?: string): Promise<import("./coreClient").PlatformGatewaySuccess<DeleteEdgeResponse>>;
-    /**
-     * Retrieve a graph neighborhood around a root node.
-     */
-    neighborhood(query: NeighborhoodInput): Promise<import("./coreClient").PlatformGatewaySuccess<GraphNeighborhoodResponse>>;
-    /**
-     * Traverse the graph from a starting node.
-     */
-    traverse(query: TraverseInput): Promise<import("./coreClient").PlatformGatewaySuccess<Record<string, unknown>>>;
-    /**
-     * Analyze graph structure for a topic.
-     */
-    analyze(query?: AnalyzeInput): Promise<import("./coreClient").PlatformGatewaySuccess<Record<string, unknown>>>;
-    /**
-     * Detect confirmation-bias patterns for a topic graph.
-     */
-    bias(query?: BiasInput): Promise<import("./coreClient").PlatformGatewaySuccess<Record<string, unknown>>>;
-    /**
-     * Find graph gaps for beliefs that still need testing.
-     */
-    gaps(query: GapsInput): Promise<import("./coreClient").PlatformGatewaySuccess<Record<string, unknown>>>;
-    /**
-     * Search across graph resources within a topic.
-     */
-    search(query: SearchInput): Promise<import("./coreClient").PlatformGatewaySuccess<Record<string, unknown>>>;
-    /**
-     * Retrieve a graph neighborhood around a root node.
-     */
-    getNeighborhood(query: NeighborhoodInput): Promise<import("./coreClient").PlatformGatewaySuccess<GraphNeighborhoodResponse>>;
-    /**
-     * Retrieve the shortest known path between two graph nodes.
-     */
-    getPath(query: PathInput): Promise<import("./coreClient").PlatformGatewaySuccess<GraphPathResponse>>;
-    /**
-     * Retrieve graph analytics for the requested metric.
-     */
-    getAnalytics(query?: AnalyticsInput): Promise<import("./coreClient").PlatformGatewaySuccess<GraphAnalyticsResponse>>;
-};

package/dist/lib/platform/sdk/graphClient.js

@@ -1,235 +0,0 @@
-import { createGatewayRequestClient, LucernApiError, randomIdempotencyKey, toQueryString, } from "./coreClient.js";
-import { mapAliasedList, mapGatewayData, normalizeNodeWriteInput, normalizeNodeVerificationStatus, normalizeTopicQuery, withSdkAliases, } from "./sdkSurface.js";
-export { LucernApiError };
-/**
- * Create the low-level graph client for nodes, edges, and graph analytics.
- * @param config - Gateway transport configuration.
- * @returns An object with methods for CRUD on nodes/edges plus analytics, traversal, and search.
- */
-export function createGraphClient(config = {}) {
-    const gateway = createGatewayRequestClient(config);
-    return {
-        /**
-         * List graph nodes matching the provided filters.
-         */
-        async listNodes(query) {
-            return gateway.request({
-                path: `/api/platform/v1/graph/nodes${toQueryString(normalizeTopicQuery(query))}`,
-            }).then((response) => mapGatewayData(response, (data) => mapAliasedList(data, "nodes")));
-        },
-        /**
-         * @deprecated Use listNodes.
-         */
-        async queryNodes(query) {
-            return this.listNodes(query);
-        },
-        /**
-         * Retrieve a single graph node by nodeId or globalId.
-         */
-        async getNode(query) {
-            return gateway.request({
-                path: `/api/platform/v1/graph/nodes${toQueryString(query)}`,
-            }).then((response) => mapGatewayData(response, (data) => withSdkAliases(data)));
-        },
-        /**
-         * Create a graph node.
-         */
-        async createNode(input, idempotencyKey) {
-            return gateway.request({
-                path: "/api/platform/v1/graph/nodes",
-                method: "POST",
-                body: normalizeNodeWriteInput(input),
-                idempotencyKey: idempotencyKey ?? randomIdempotencyKey(),
-            }).then((response) => mapGatewayData(response, (data) => withSdkAliases(data)));
-        },
-        /**
-         * Update a graph node.
-         */
-        async updateNode(input, idempotencyKey) {
-            return gateway.request({
-                path: "/api/platform/v1/graph/nodes",
-                method: "PUT",
-                body: normalizeNodeWriteInput(input),
-                idempotencyKey: idempotencyKey ?? randomIdempotencyKey(),
-            }).then((response) => mapGatewayData(response, (data) => withSdkAliases(data)));
-        },
-        /**
-         * Batch create graph nodes through the admin route surface.
-         */
-        async batchCreateNodes(input, idempotencyKey) {
-            return gateway.request({
-                path: "/api/platform/v1/graph/nodes/batch",
-                method: "POST",
-                body: {
-                    nodes: input.nodes.map((node) => normalizeNodeWriteInput(node)),
-                },
-                idempotencyKey: idempotencyKey ?? randomIdempotencyKey(),
-            });
-        },
-        /**
-         * Supersede an existing graph node with a new canonical version.
-         */
-        async supersedeNode(input, idempotencyKey) {
-            return gateway.request({
-                path: "/api/platform/v1/graph/nodes/supersede",
-                method: "POST",
-                body: input,
-                idempotencyKey: idempotencyKey ?? randomIdempotencyKey(),
-            });
-        },
-        /**
-         * Update a node's verification status.
-         */
-        async verifyNode(input, idempotencyKey) {
-            const verificationStatus = normalizeNodeVerificationStatus(input.verificationStatus) ??
-                input.verificationStatus;
-            return gateway.request({
-                path: "/api/platform/v1/graph/nodes/verify",
-                method: "POST",
-                body: {
-                    ...input,
-                    verificationStatus,
-                },
-                idempotencyKey: idempotencyKey ?? randomIdempotencyKey(),
-            });
-        },
-        /**
-         * Permanently delete a node via the admin-only hard-delete route.
-         */
-        async hardDeleteNode(input, idempotencyKey) {
-            return gateway.request({
-                path: "/api/platform/v1/graph/nodes/hard-delete",
-                method: "POST",
-                body: input,
-                idempotencyKey: idempotencyKey ?? randomIdempotencyKey(),
-            });
-        },
-        /**
-         * List graph edges matching the provided filters.
-         */
-        async listEdges(query) {
-            return gateway.request({
-                path: `/api/platform/v1/graph/edges${toQueryString(normalizeTopicQuery(query))}`,
-            }).then((response) => mapGatewayData(response, (data) => mapAliasedList(data, "edges")));
-        },
-        /**
-         * @deprecated Use listEdges.
-         */
-        async queryEdges(query) {
-            return this.listEdges(query);
-        },
-        /**
-         * Create a graph edge.
-         */
-        async createEdge(input, idempotencyKey) {
-            return gateway.request({
-                path: "/api/platform/v1/graph/edges",
-                method: "POST",
-                body: normalizeTopicQuery(input),
-                idempotencyKey: idempotencyKey ?? randomIdempotencyKey(),
-            });
-        },
-        /**
-         * Delete one or more edges matching the provided filter.
-         */
-        async deleteEdge(query, idempotencyKey) {
-            return gateway.request({
-                path: `/api/platform/v1/graph/edges${toQueryString(query)}`,
-                method: "DELETE",
-                idempotencyKey: idempotencyKey ?? randomIdempotencyKey(),
-            });
-        },
-        /**
-         * Retrieve a graph neighborhood around a root node.
-         */
-        async neighborhood(query) {
-            return gateway.request({
-                path: `/api/platform/v1/graph/neighborhood${toQueryString(query)}`,
-            });
-        },
-        /**
-         * Traverse the graph from a starting node.
-         */
-        async traverse(query) {
-            return gateway.request({
-                path: "/api/platform/v1/graph/traverse",
-                method: "POST",
-                body: normalizeTopicQuery(query),
-            });
-        },
-        /**
-         * Analyze graph structure for a topic.
-         */
-        async analyze(query = {}) {
-            const normalized = normalizeTopicQuery(query);
-            return gateway.request({
-                path: `/api/platform/v1/graph/analyze${toQueryString({
-                    topicId: typeof normalized.topicId === "string" ? normalized.topicId : undefined,
-                    metric: typeof normalized.metric === "string" ? normalized.metric : undefined,
-                    limit: typeof normalized.limit === "number" ? normalized.limit : undefined,
-                })}`,
-            });
-        },
-        /**
-         * Detect confirmation-bias patterns for a topic graph.
-         */
-        async bias(query = {}) {
-            const normalized = normalizeTopicQuery(query);
-            return gateway.request({
-                path: `/api/platform/v1/graph/bias${toQueryString({
-                    topicId: typeof normalized.topicId === "string" ? normalized.topicId : undefined,
-                    threshold: typeof normalized.threshold === "number"
-                        ? normalized.threshold
-                        : undefined,
-                    limit: typeof normalized.limit === "number" ? normalized.limit : undefined,
-                })}`,
-            });
-        },
-        /**
-         * Find graph gaps for beliefs that still need testing.
-         */
-        async gaps(query) {
-            const normalized = normalizeTopicQuery(query);
-            return gateway.request({
-                path: `/api/platform/v1/graph/gaps${toQueryString({
-                    topicId: typeof normalized.topicId === "string" ? normalized.topicId : undefined,
-                    minConfidence: typeof normalized.minConfidence === "number"
-                        ? normalized.minConfidence
-                        : undefined,
-                })}`,
-            });
-        },
-        /**
-         * Search across graph resources within a topic.
-         */
-        async search(query) {
-            return gateway.request({
-                path: "/api/platform/v1/search",
-                method: "POST",
-                body: normalizeTopicQuery(query),
-            });
-        },
-        /**
-         * Retrieve a graph neighborhood around a root node.
-         */
-        async getNeighborhood(query) {
-            return this.neighborhood(query);
-        },
-        /**
-         * Retrieve the shortest known path between two graph nodes.
-         */
-        async getPath(query) {
-            return gateway.request({
-                path: `/api/platform/v1/graph/path${toQueryString(query)}`,
-            });
-        },
-        /**
-         * Retrieve graph analytics for the requested metric.
-         */
-        async getAnalytics(query = {}) {
-            return gateway.request({
-                path: `/api/platform/v1/graph/analytics${toQueryString(query)}`,
-            });
-        },
-    };
-}