@lucern/sdk 0.3.0-alpha.17 → 0.3.0-alpha.3

package/dist/graphClient.d.ts

@@ -1,6 +1,6 @@
 import { GatewayClientConfig, PlatformGatewaySuccess } from './coreClient.js';
 export { GatewayScope, LucernApiError } from './coreClient.js';
-import { TopicIdentifierInput, JsonObject, TextAliasInput, GraphAnalyticsMetric, ListResult, PlatformGraphEdge, PlatformGraphNode, DeleteEdgeResponse, GraphNeighborhoodResponse, GraphPathResponse, GraphAnalyticsResponse } from './types.js';
+import { TopicIdentifierInput, JsonObject, TextAliasInput, GraphAnalyticsMetric, ListResult, PlatformGraphNode, PlatformGraphEdge, DeleteEdgeResponse, GraphNeighborhoodResponse, GraphPathResponse, GraphAnalyticsResponse } from './types.js';
 export { CreateEdgeResponse, CreateNodeResponse, QueryEdgesResponse, QueryNodesResponse, UpdateNodeResponse } from './types.js';
 import './authContext.js';
 import './contracts/auth-session.contract.js';
@@ -84,7 +84,6 @@ type CreateEdgeInput = {
     confidence?: number;
     weight?: number;
     context?: string;
-    reasoningMethod?: string;
     derivationType?: string;
 } & TopicIdentifierInput;
 /** Filter for selecting edges to delete. */
@@ -185,6 +184,10 @@ declare function createGraphClient(config?: GraphClientConfig): {
      * List graph nodes matching the provided filters.
      */
     listNodes(query: ListNodesInput): Promise<PlatformGatewaySuccess<ListResult<PlatformGraphNode, "nodes">>>;
+    /**
+     * @deprecated Use listNodes.
+     */
+    queryNodes(query: QueryNodesInput): Promise<PlatformGatewaySuccess<ListResult<PlatformGraphNode, "nodes">>>;
     /**
      * Retrieve a single graph node by nodeId or globalId.
      */
@@ -217,6 +220,10 @@ declare function createGraphClient(config?: GraphClientConfig): {
      * List graph edges matching the provided filters.
      */
     listEdges(query: ListEdgesInput): Promise<PlatformGatewaySuccess<ListResult<PlatformGraphEdge, "edges">>>;
+    /**
+     * @deprecated Use listEdges.
+     */
+    queryEdges(query: QueryEdgesInput): Promise<PlatformGatewaySuccess<ListResult<PlatformGraphEdge, "edges">>>;
     /**
      * Create a graph edge.
      */
@@ -249,6 +256,10 @@ declare function createGraphClient(config?: GraphClientConfig): {
      * Search across graph resources within a topic.
      */
     search(query: SearchInput): Promise<PlatformGatewaySuccess<Record<string, unknown>>>;
+    /**
+     * Retrieve a graph neighborhood around a root node.
+     */
+    getNeighborhood(query: NeighborhoodInput): Promise<PlatformGatewaySuccess<GraphNeighborhoodResponse>>;
     /**
      * Retrieve the shortest known path between two graph nodes.
      */
@@ -257,10 +268,6 @@ declare function createGraphClient(config?: GraphClientConfig): {
      * Retrieve graph analytics for the requested metric.
      */
     getAnalytics(query?: AnalyticsInput): Promise<PlatformGatewaySuccess<GraphAnalyticsResponse>>;
-} & {
-    queryNodes: (query: ListNodesInput) => Promise<PlatformGatewaySuccess<ListResult<PlatformGraphNode, "nodes">>>;
-    queryEdges: (query: ListEdgesInput) => Promise<PlatformGatewaySuccess<ListResult<PlatformGraphEdge, "edges">>>;
-    getNeighborhood: (query: NeighborhoodInput) => Promise<PlatformGatewaySuccess<GraphNeighborhoodResponse>>;
 };
 
 export { type AnalyticsInput, type AnalyzeInput, type BatchCreateNodesInput, type BiasInput, type CreateEdgeInput, type CreateNodeInput, type DeleteEdgeInput, DeleteEdgeResponse, type GapsInput, type GetNodeInput, GraphAnalyticsMetric, GraphAnalyticsResponse, type GraphClientConfig, GraphNeighborhoodResponse, GraphPathResponse, type HardDeleteNodeInput, type ListEdgesInput, type ListEdgesResponse, type ListNodesInput, type ListNodesResponse, ListResult, type NeighborhoodInput, type PathInput, PlatformGatewaySuccess, type QueryEdgesInput, type QueryNodesInput, type SearchInput, type SupersedeNodeInput, type TraverseInput, type UpdateNodeInput, type VerifyNodeInput, createGraphClient };

package/dist/graphClient.js

@@ -82,15 +82,14 @@ function normalizeCanonicalLucernAuthContext(input) {
   );
   const roles = cleanStringList(input.roles);
   const scopes = cleanStringList(input.scopes);
-  const principalType = requirePrincipalType(input.principalType);
-  const authMode = requireAuthMode(input.authMode);
-  const roleBasedInteractiveAuth = authMode === "interactive_user" && roles.length > 0;
-  if (roles.length === 0 || scopes.length === 0 && !roleBasedInteractiveAuth) {
+  if (roles.length === 0 || scopes.length === 0) {
     throw new LucernSdkAuthContextError(
       "membership_missing",
       "Canonical Lucern SDK auth context requires non-empty roles and scopes."
     );
   }
+  const principalType = requirePrincipalType(input.principalType);
+  const authMode = requireAuthMode(input.authMode);
   const subject = cleanString(input.permit?.subject) ?? principalId;
   const tenant = cleanString(input.permit?.tenant) ?? tenantId;
   const workspace = cleanString(input.permit?.workspace) ?? workspaceId;
@@ -232,7 +231,9 @@ function generatePortableRequestId() {
     8
   ).join("")}-${hex.slice(8, 10).join("")}-${hex.slice(10).join("")}`;
 }
-var randomIdempotencyKey = generatePortableRequestId;
+function randomIdempotencyKey() {
+  return generatePortableRequestId();
+}
 function isRetryableStatus(status) {
   return status >= 500 || status === 408 || status === 429;
 }
@@ -297,11 +298,8 @@ function timeoutError(timeoutMs) {
   error.name = "AbortError";
   return error;
 }
-function isRecord(value) {
-  return value !== null && typeof value === "object" && !Array.isArray(value);
-}
 function readPolicySummaryFromDetails(details) {
-  if (!isRecord(details)) {
+  if (!details || typeof details !== "object" || Array.isArray(details)) {
     return null;
   }
   const directSummary = details.summary;
@@ -309,11 +307,11 @@ function readPolicySummaryFromDetails(details) {
     return directSummary.trim();
   }
   const policy = details.policy;
-  if (!isRecord(policy)) {
+  if (!policy || typeof policy !== "object" || Array.isArray(policy)) {
     return null;
   }
   const explanation = policy.explanation;
-  if (!isRecord(explanation)) {
+  if (!explanation || typeof explanation !== "object" || Array.isArray(explanation)) {
     return null;
   }
   const nestedSummary = explanation.summary;
@@ -342,31 +340,13 @@ function mergeHeaderRecord(base, addition) {
   }
   return Object.fromEntries(headers.entries());
 }
-function cleanHeaderValue(value) {
-  const normalized = value?.trim();
-  return normalized ? normalized : void 0;
-}
 function createGatewayRequestClient(config = {}) {
   const fetchImpl = config.fetchImpl ?? fetch;
   const baseUrl = config.baseUrl?.replace(/\/+$/, "") ?? "";
   const maxRetries = config.maxRetries ?? 2;
   const requestIdFactory = config.requestIdFactory ?? (() => generatePortableRequestId());
   async function resolveAuthHeaders() {
-    const provided = config.getAuthHeaders ? await config.getAuthHeaders() : {};
-    const headers = new Headers(provided);
-    const setIfAbsent = (name, value) => {
-      const normalized = cleanHeaderValue(value);
-      if (normalized && !headers.has(name)) {
-        headers.set(name, normalized);
-      }
-    };
-    setIfAbsent("x-lucern-key", config.apiKey);
-    setIfAbsent("x-lucern-session-token", config.userToken);
-    setIfAbsent("x-lucern-environment", config.environment);
-    setIfAbsent("x-lucern-clerk-id", config.clerkId);
-    setIfAbsent("x-lucern-user-id", config.userId ?? config.clerkId);
-    setIfAbsent("x-lucern-deployment-host", config.deploymentHost);
-    const base = Object.fromEntries(headers.entries());
+    const base = config.getAuthHeaders ? await config.getAuthHeaders() : {};
     const authContextInput = await resolveConfiguredAuthContext(
       config.authContext
     );
@@ -395,11 +375,11 @@ function createGatewayRequestClient(config = {}) {
     if (!text) {
       return null;
     }
-    const parsed = tryParseGatewayEnvelopeJson(text);
-    if (!parsed.ok) {
+    try {
+      return JSON.parse(text);
+    } catch {
       return null;
     }
-    return isRecord(parsed.value) ? parsed.value : null;
   }
   function resolveTimeoutMs(method, requestTimeoutMs) {
     if (typeof requestTimeoutMs === "number") {
@@ -411,31 +391,16 @@ function createGatewayRequestClient(config = {}) {
     }
     return config.timeoutMs ?? 15e3;
   }
-  function tryParseGatewayEnvelopeJson(text) {
-    const trimmed = text.trim();
-    if (!trimmed.startsWith("{") && !trimmed.startsWith("[")) {
-      return { ok: false, reason: "non-json" };
-    }
-    try {
-      return { ok: true, value: JSON.parse(trimmed) };
-    } catch (error) {
-      if (error instanceof SyntaxError) {
-        return { ok: false, reason: "invalid-json", error };
-      }
-      throw error;
-    }
-  }
   function buildApiError(args) {
     const failure = args.failure;
-    const legacyError = failure && isRecord(failure.error) ? failure.error : failure?.legacyError;
+    const legacyError = failure && typeof failure.error === "object" && failure.error !== null ? failure.error : failure?.legacyError;
     const correlationId = failure?.correlationId ?? args.response.headers.get("x-lucern-correlation-id")?.trim() ?? args.requestId;
     const policyTraceId = failure?.policyTraceId ?? args.response.headers.get("x-lucern-policy-trace-id")?.trim() ?? null;
     const details = failure?.details ?? legacyError?.details;
     const policySummary = readPolicySummaryFromDetails(details);
-    const failureMessage = typeof failure?.error === "string" ? failure.error : legacyError?.message;
     return new LucernApiError({
       code: failure?.code ?? legacyError?.code ?? fallbackErrorCode(args.response.status),
-      message: policySummary ?? failureMessage ?? (args.response.ok ? "Platform API returned an invalid success payload." : "Platform API request failed."),
+      message: policySummary ?? (typeof failure?.error === "string" ? failure.error : legacyError?.message ?? (args.response.ok ? "Platform API returned an invalid success payload." : "Platform API request failed.")),
       status: args.response.status,
       invariant: failure?.invariant,
       suggestion: failure?.suggestion,
@@ -561,11 +526,8 @@ function createGatewayRequestClient(config = {}) {
 }
 
 // src/sdkSurface.ts
-function isRecord2(value) {
-  return Boolean(value) && typeof value === "object" && !Array.isArray(value);
-}
 function asRecord(value) {
-  return isRecord2(value) ? value : {};
+  return value && typeof value === "object" ? value : {};
 }
 function cleanString2(value) {
   return typeof value === "string" && value.trim().length > 0 ? value.trim() : void 0;
@@ -626,7 +588,9 @@ function normalizeNodeWriteInput(value) {
   }
   return next;
 }
-var normalizeNodeVerificationStatus = normalizeVerificationStatus;
+function normalizeNodeVerificationStatus(value) {
+  return normalizeVerificationStatus(value);
+}
 function normalizeTopicQuery(value) {
   const topicId = cleanString2(value.topicId);
   if (!topicId) {
@@ -653,10 +617,7 @@ function createListResult(items, legacyKey) {
     total: items.length
   };
   if (legacyKey) {
-    return {
-      ...result,
-      [legacyKey]: items
-    };
+    result[legacyKey] = items;
   }
   return result;
 }
@@ -676,7 +637,7 @@ function mapAliasedList(data, legacyKey) {
 // src/graphClient.ts
 function createGraphClient(config = {}) {
   const gateway = createGatewayRequestClient(config);
-  const client = {
+  return {
     /**
      * List graph nodes matching the provided filters.
      */
@@ -689,6 +650,12 @@ function createGraphClient(config = {}) {
         (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.
      */
@@ -799,6 +766,12 @@ function createGraphClient(config = {}) {
         )
       );
     },
+    /**
+     * @deprecated Use listEdges.
+     */
+    async queryEdges(query) {
+      return this.listEdges(query);
+    },
     /**
      * Create a graph edge.
      */
@@ -886,6 +859,12 @@ function createGraphClient(config = {}) {
         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.
      */
@@ -903,11 +882,6 @@ function createGraphClient(config = {}) {
       });
     }
   };
-  return Object.assign(client, {
-    queryNodes: client.listNodes,
-    queryEdges: client.listEdges,
-    getNeighborhood: client.neighborhood
-  });
 }
 
 export { LucernApiError, createGraphClient };