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

package/dist/gatewayFacades.d.ts

@@ -1,13 +1,14 @@
-import { JsonObject, GraphNeighborhoodResponse, GraphAnalyticsMetric, TopicRecord, TopicListResponse, TopicTreeResponse, TopicCoverageResponse } from './types.js';
-import { GatewayClientConfig, PlatformGatewaySuccess } from './coreClient.js';
+import { TopicCreateInput, TopicListInput, TopicUpdateInput, TopicTreeQuery, TopicCoverageQuery, TopicBulkCreateInput } from './topicsClient.js';
+import { GatewayClientConfig, PlatformGatewaySuccess, GatewayScope } from './coreClient.js';
+import { TraverseInput, AnalyzeInput, BiasInput, GapsInput } from './graphClient.js';
+import { JsonObject, GraphNeighborhoodResponse, TopicRecord, TopicListResponse, TopicTreeResponse, TopicCoverageResponse } from './types.js';
 import { ModulateConfidenceInput } from './beliefsClient.js';
 import { OntologyBindingInput } from './ontologyClient.js';
-import { TopicCreateInput, TopicListInput, TopicUpdateInput, TopicTreeQuery, TopicCoverageQuery, TopicBulkCreateInput } from './topicsClient.js';
+import './authContext.js';
+import './contracts/auth-session.contract.js';
 import './contracts/workflow-runtime.contract.js';
 import './contracts/lens-workflow.contract.js';
 import './contracts/lens-filter.contract.js';
-import './authContext.js';
-import './contracts/auth-session.contract.js';
 import './opinion.js';
 
 type GatewayRecord = Record<string, unknown>;
@@ -36,26 +37,6 @@ type GraphNeighborhoodInput = {
     globalIds?: string | string[];
     maxDepth?: number;
 };
-type GraphTraverseInput = {
-    startNode: string;
-    direction?: string;
-    maxDepth?: number;
-    topicId?: string;
-};
-type GraphAnalyzeInput = {
-    topicId?: string;
-    metric?: GraphAnalyticsMetric;
-    limit?: number;
-};
-type GraphBiasInput = {
-    topicId?: string;
-    threshold?: number;
-    limit?: number;
-};
-type GraphGapsInput = {
-    topicId?: string;
-    minConfidence?: number;
-};
 type GraphFalsifyInput = {
     topicId?: string;
     beliefId?: string;
@@ -363,11 +344,6 @@ type WorktreeTargetsInput = {
     removeBeliefIds?: string[];
     removeQuestionIds?: string[];
 };
-type OntologyListInput = {
-    tenantId?: string;
-    tier?: string;
-    status?: string;
-};
 type OntologyMatchInput = GatewayRecord;
 type WebhookCreateInput = GatewayRecord;
 type WebhookUpdateInput = GatewayRecord;
@@ -499,11 +475,12 @@ declare function createEventsFacade(config?: GatewayClientConfig): {
 };
 declare function createGraphFacade(config?: GatewayClientConfig): {
     neighborhood(input: GraphNeighborhoodInput): Promise<PlatformGatewaySuccess<GraphNeighborhoodResponse>>;
-    traverse(input: GraphTraverseInput): Promise<PlatformGatewaySuccess<Record<string, unknown>>>;
-    analyze(input?: GraphAnalyzeInput): Promise<PlatformGatewaySuccess<Record<string, unknown>>>;
-    bias(input?: GraphBiasInput): Promise<PlatformGatewaySuccess<Record<string, unknown>>>;
-    gaps(input: GraphGapsInput): Promise<PlatformGatewaySuccess<Record<string, unknown>>>;
     falsify(input: GraphFalsifyInput, idempotencyKey?: string): Promise<PlatformGatewaySuccess<GatewayRecord>>;
+} & {
+    traverse: (query: TraverseInput) => Promise<PlatformGatewaySuccess<Record<string, unknown>>>;
+    analyze: (query?: AnalyzeInput) => Promise<PlatformGatewaySuccess<Record<string, unknown>>>;
+    bias: (query?: BiasInput) => Promise<PlatformGatewaySuccess<Record<string, unknown>>>;
+    gaps: (query: GapsInput) => Promise<PlatformGatewaySuccess<Record<string, unknown>>>;
 };
 declare function createIdentityFacade(config?: GatewayClientConfig): {
     whoami(): Promise<PlatformGatewaySuccess<{
@@ -538,14 +515,19 @@ declare function createIdentityFacade(config?: GatewayClientConfig): {
 };
 declare function createOntologiesFacade(config?: GatewayClientConfig): {
     get(id: string): Promise<PlatformGatewaySuccess<GatewayRecord>>;
-    list(query?: OntologyListInput): Promise<PlatformGatewaySuccess<{
-        ontologies: any[];
-        total: number;
-        items: any[];
-        definitions: any[];
-    }>>;
     bind(input: OntologyBindingInput, idempotencyKey?: string): Promise<PlatformGatewaySuccess<GatewayRecord>>;
     match(input: OntologyMatchInput, idempotencyKey?: string): Promise<PlatformGatewaySuccess<GatewayRecord>>;
+} & {
+    list: (filters?: GatewayScope & {
+        tenantId?: string;
+        tier?: string;
+        status?: string;
+    }) => Promise<PlatformGatewaySuccess<{
+        ontologies: unknown[];
+        total: number;
+        items: unknown[];
+        definitions: unknown[];
+    }>>;
 };
 declare function createQuestionsFacade(config?: GatewayClientConfig): {
     create(input: QuestionCreateInput, idempotencyKey?: string): Promise<PlatformGatewaySuccess<GatewayRecord>>;
@@ -574,9 +556,9 @@ declare function createTasksFacade(config?: GatewayClientConfig): {
     list(query: TaskListQuery): Promise<PlatformGatewaySuccess<TaskListResult>>;
 };
 declare function createTopicsFacade(config?: GatewayClientConfig): {
-    create(input: TopicCreateInput, idempotencyKey?: string): Promise<PlatformGatewaySuccess<TopicRecord>>;
-    get(id: string): Promise<PlatformGatewaySuccess<TopicRecord>>;
-    list(query?: TopicListInput): Promise<PlatformGatewaySuccess<TopicListResponse>>;
+    create: (input: TopicCreateInput, idempotencyKey?: string) => Promise<PlatformGatewaySuccess<TopicRecord>>;
+    get: (topicId: string) => Promise<PlatformGatewaySuccess<TopicRecord>>;
+    list: (query?: TopicListInput) => Promise<PlatformGatewaySuccess<TopicListResponse>>;
     update(input: TopicUpdateInput & {
         id: string;
     }, idempotencyKey?: string): Promise<PlatformGatewaySuccess<TopicRecord>>;
@@ -586,8 +568,8 @@ declare function createTopicsFacade(config?: GatewayClientConfig): {
     coverage(input: TopicCoverageQuery & {
         id: string;
     }): Promise<PlatformGatewaySuccess<TopicCoverageResponse>>;
-    remove(id: string, idempotencyKey?: string): Promise<PlatformGatewaySuccess<Record<string, unknown>>>;
-    bulkCreate(input: TopicBulkCreateInput, idempotencyKey?: string): Promise<PlatformGatewaySuccess<Record<string, unknown>>>;
+    remove: (topicId: string, idempotencyKey?: string) => Promise<PlatformGatewaySuccess<Record<string, unknown>>>;
+    bulkCreate: (input: TopicBulkCreateInput, idempotencyKey?: string) => Promise<PlatformGatewaySuccess<Record<string, unknown>>>;
 };
 declare function createWebhooksFacade(config?: GatewayClientConfig): {
     create(input: WebhookCreateInput, idempotencyKey?: string): Promise<PlatformGatewaySuccess<GatewayRecord>>;

package/dist/gatewayFacades.js

@@ -232,9 +232,7 @@ function generatePortableRequestId() {
     8
   ).join("")}-${hex.slice(8, 10).join("")}-${hex.slice(10).join("")}`;
 }
-function randomIdempotencyKey() {
-  return generatePortableRequestId();
-}
+var randomIdempotencyKey = generatePortableRequestId;
 function isRetryableStatus(status) {
   return status >= 500 || status === 408 || status === 429;
 }
@@ -299,8 +297,11 @@ function timeoutError(timeoutMs) {
   error.name = "AbortError";
   return error;
 }
+function isRecord(value) {
+  return value !== null && typeof value === "object" && !Array.isArray(value);
+}
 function readPolicySummaryFromDetails(details) {
-  if (!details || typeof details !== "object" || Array.isArray(details)) {
+  if (!isRecord(details)) {
     return null;
   }
   const directSummary = details.summary;
@@ -308,11 +309,11 @@ function readPolicySummaryFromDetails(details) {
     return directSummary.trim();
   }
   const policy = details.policy;
-  if (!policy || typeof policy !== "object" || Array.isArray(policy)) {
+  if (!isRecord(policy)) {
     return null;
   }
   const explanation = policy.explanation;
-  if (!explanation || typeof explanation !== "object" || Array.isArray(explanation)) {
+  if (!isRecord(explanation)) {
     return null;
   }
   const nestedSummary = explanation.summary;
@@ -376,11 +377,11 @@ function createGatewayRequestClient(config = {}) {
     if (!text) {
       return null;
     }
-    try {
-      return JSON.parse(text);
-    } catch {
+    const parsed = tryParseGatewayEnvelopeJson(text);
+    if (!parsed.ok) {
       return null;
     }
+    return isRecord(parsed.value) ? parsed.value : null;
   }
   function resolveTimeoutMs(method, requestTimeoutMs) {
     if (typeof requestTimeoutMs === "number") {
@@ -392,16 +393,31 @@ 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 && typeof failure.error === "object" && failure.error !== null ? failure.error : failure?.legacyError;
+    const legacyError = failure && isRecord(failure.error) ? 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 ?? (typeof failure?.error === "string" ? failure.error : legacyError?.message ?? (args.response.ok ? "Platform API returned an invalid success payload." : "Platform API request failed.")),
+      message: policySummary ?? failureMessage ?? (args.response.ok ? "Platform API returned an invalid success payload." : "Platform API request failed."),
       status: args.response.status,
       invariant: failure?.invariant,
       suggestion: failure?.suggestion,
@@ -527,8 +543,11 @@ function createGatewayRequestClient(config = {}) {
 }
 
 // src/sdkSurface.ts
+function isRecord2(value) {
+  return Boolean(value) && typeof value === "object" && !Array.isArray(value);
+}
 function asRecord(value) {
-  return value && typeof value === "object" ? value : {};
+  return isRecord2(value) ? value : {};
 }
 function cleanString2(value) {
   return typeof value === "string" && value.trim().length > 0 ? value.trim() : void 0;
@@ -589,9 +608,7 @@ function normalizeNodeWriteInput(value) {
   }
   return next;
 }
-function normalizeNodeVerificationStatus(value) {
-  return normalizeVerificationStatus(value);
-}
+var normalizeNodeVerificationStatus = normalizeVerificationStatus;
 function normalizeTopicQuery(value) {
   const topicId = cleanString2(value.topicId);
   if (!topicId) {
@@ -618,7 +635,10 @@ function createListResult(items, legacyKey) {
     total: items.length
   };
   if (legacyKey) {
-    result[legacyKey] = items;
+    return {
+      ...result,
+      [legacyKey]: items
+    };
   }
   return result;
 }
@@ -638,7 +658,7 @@ function mapAliasedList(data, legacyKey) {
 // src/ontologyClient.ts
 function createOntologyClient(config = {}) {
   const gateway = createGatewayRequestClient(config);
-  return {
+  const client = {
     /**
      * List ontology definitions matching optional filters.
      */
@@ -647,13 +667,14 @@ function createOntologyClient(config = {}) {
         path: `/api/platform/v1/ontologies${toQueryString(filters)}`
       }).then(
         (response) => mapGatewayData(response, (data) => {
-          const record = data && typeof data === "object" && !Array.isArray(data) ? data : {};
-          const ontologies = Array.isArray(record.ontologies) ? record.ontologies : Array.isArray(record.definitions) ? record.definitions : Array.isArray(data) ? data : [];
-          const total = typeof record.total === "number" && Number.isFinite(record.total) ? record.total : ontologies.length;
+          const record = asRecord(data);
+          const ontologies = asListItems(data, "ontologies");
+          const definitions = ontologies.length > 0 ? ontologies : asListItems(data, "definitions");
+          const total = typeof record.total === "number" && Number.isFinite(record.total) ? record.total : definitions.length;
           return {
             ...record,
-            ...createListResult(ontologies, "definitions"),
-            ontologies,
+            ...createListResult(definitions, "definitions"),
+            ontologies: definitions,
             total
           };
         })
@@ -680,18 +701,6 @@ function createOntologyClient(config = {}) {
         idempotencyKey: idempotencyKey ?? randomIdempotencyKey()
       });
     },
-    /**
-     * List ontology definitions.
-     */
-    async listDefinitions(filters = {}) {
-      return this.list(filters);
-    },
-    /**
-     * Get an ontology definition.
-     */
-    async getDefinition(id) {
-      return this.get(id);
-    },
     /**
      * Create an ontology definition.
      */
@@ -733,7 +742,7 @@ function createOntologyClient(config = {}) {
       }).then(
         (response) => mapGatewayData(
           response,
-          (data) => createListResult(Array.isArray(data) ? data : [], "versions")
+          (data) => createListResult(asListItems(data, "versions"), "versions")
         )
       );
     },
@@ -781,20 +790,19 @@ function createOntologyClient(config = {}) {
           (data) => createListResult(Array.isArray(data) ? data : [], "topics")
         )
       );
-    },
-    /**
-     * @deprecated Use listTopics.
-     */
-    async listTopicsByOntology(ontologyId) {
-      return this.listTopics(ontologyId);
     }
   };
+  return Object.assign(client, {
+    listDefinitions: client.list,
+    getDefinition: client.get,
+    listTopicsByOntology: client.listTopics
+  });
 }
 
 // src/graphClient.ts
 function createGraphClient(config = {}) {
   const gateway = createGatewayRequestClient(config);
-  return {
+  const client = {
     /**
      * List graph nodes matching the provided filters.
      */
@@ -807,12 +815,6 @@ 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.
      */
@@ -923,12 +925,6 @@ function createGraphClient(config = {}) {
         )
       );
     },
-    /**
-     * @deprecated Use listEdges.
-     */
-    async queryEdges(query) {
-      return this.listEdges(query);
-    },
     /**
      * Create a graph edge.
      */
@@ -1016,12 +1012,6 @@ 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.
      */
@@ -1039,6 +1029,11 @@ function createGraphClient(config = {}) {
       });
     }
   };
+  return Object.assign(client, {
+    queryNodes: client.listNodes,
+    queryEdges: client.listEdges,
+    getNeighborhood: client.neighborhood
+  });
 }
 
 // src/boundaryClientSurface.ts
@@ -1046,6 +1041,9 @@ function cleanOptionalString(value) {
   const normalized = value?.trim();
   return normalized ? normalized : void 0;
 }
+function isRecord3(value) {
+  return Boolean(value) && typeof value === "object" && !Array.isArray(value);
+}
 function cleanRequiredString(value, label) {
   const normalized = cleanOptionalString(value);
   if (!normalized) {
@@ -1067,9 +1065,10 @@ function knownPayload(input, allowed, operation) {
   return { ...input };
 }
 function listResultFromEnvelope(data, legacyKey) {
-  const record = data && typeof data === "object" ? data : {};
+  const record = isRecord3(data) ? data : {};
+  const legacyItems = record[legacyKey];
   return createListResult(
-    Array.isArray(record[legacyKey]) ? record[legacyKey] : Array.isArray(data) ? data : [],
+    Array.isArray(legacyItems) ? legacyItems : Array.isArray(data) ? data : [],
     legacyKey
   );
 }
@@ -1125,6 +1124,13 @@ function createIdentityClient(config = {}) {
     body: input,
     idempotencyKey: idempotencyKey ?? randomIdempotencyKey()
   });
+  const updatePrincipal = (input, idempotencyKey) => requestPrincipalWrite("PATCH", input, idempotencyKey);
+  const deleteKey = (keyId, input = {}, idempotencyKey) => gateway.request({
+    path: `/api/platform/v1/identity/keys/${encodeURIComponent(keyId)}/revoke`,
+    method: "POST",
+    body: input,
+    idempotencyKey: idempotencyKey ?? randomIdempotencyKey()
+  });
   return {
     /**
      * Resolve the current authenticated identity summary.
@@ -1173,15 +1179,11 @@ function createIdentityClient(config = {}) {
     /**
      * Update a principal.
      */
-    async updatePrincipal(input, idempotencyKey) {
-      return requestPrincipalWrite("PATCH", input, idempotencyKey);
-    },
+    updatePrincipal,
     /**
      * @deprecated Use createPrincipal or updatePrincipal.
      */
-    async upsertPrincipal(input, idempotencyKey) {
-      return requestPrincipalWrite("PATCH", input, idempotencyKey);
-    },
+    upsertPrincipal: updatePrincipal,
     /**
      * List keys in the current identity scope.
      */
@@ -1220,20 +1222,11 @@ function createIdentityClient(config = {}) {
     /**
      * Delete an API key by revoking it.
      */
-    async deleteKey(keyId, input = {}, idempotencyKey) {
-      return gateway.request({
-        path: `/api/platform/v1/identity/keys/${encodeURIComponent(keyId)}/revoke`,
-        method: "POST",
-        body: input,
-        idempotencyKey: idempotencyKey ?? randomIdempotencyKey()
-      });
-    },
+    deleteKey,
     /**
      * @deprecated Use deleteKey.
      */
-    async revokeKey(keyId, input = {}, idempotencyKey) {
-      return this.deleteKey(keyId, input, idempotencyKey);
-    },
+    revokeKey: deleteKey,
     /**
      * Search Clerk users by email or display attributes.
      */
@@ -1349,14 +1342,11 @@ function createIdentityClient(config = {}) {
 }
 
 // src/topicsClient.ts
-function asRecord2(value) {
-  return value && typeof value === "object" ? value : {};
-}
 function cleanString3(value) {
   return typeof value === "string" && value.trim().length > 0 ? value.trim() : void 0;
 }
 function normalizeTopicRecord(value) {
-  const record = asRecord2(value);
+  const record = asRecord(value);
   const topicId = cleanString3(record.topicId) ?? cleanString3(record.id) ?? cleanString3(record._id);
   return withTopicAlias({
     ...record,
@@ -1381,7 +1371,7 @@ function createTopicsClient(config = {}) {
         })}`
       }).then(
         (response) => mapGatewayData(response, (data) => {
-          const record = asRecord2(data);
+          const record = asRecord(data);
           const items = Array.isArray(record.topics) ? record.topics.map(normalizeTopicRecord) : [];
           return {
             ...createListResult(items, "topics"),
@@ -1398,7 +1388,7 @@ function createTopicsClient(config = {}) {
       }).then(
         (response) => mapGatewayData(
           response,
-          (data) => normalizeTopicRecord(asRecord2(data).topic ?? data)
+          (data) => normalizeTopicRecord(asRecord(data).topic ?? data)
         )
       );
     },
@@ -1434,7 +1424,7 @@ function createTopicsClient(config = {}) {
         )}`
       }).then(
         (response) => mapGatewayData(response, (data) => {
-          const record = asRecord2(data);
+          const record = asRecord(data);
           return {
             tree: Array.isArray(record.tree) ? record.tree.map(normalizeTopicTreeNode) : []
           };
@@ -1853,7 +1843,7 @@ function createEventsFacade(config = {}) {
 function createGraphFacade(config = {}) {
   const graphClient = createGraphClient(config);
   const gateway = createGatewayRequestClient(config);
-  return {
+  const graphFacade = {
     async neighborhood(input) {
       return graphClient.neighborhood({
         globalId: input.globalId,
@@ -1861,18 +1851,6 @@ function createGraphFacade(config = {}) {
         maxDepth: input.maxDepth
       });
     },
-    async traverse(input) {
-      return graphClient.traverse(input);
-    },
-    async analyze(input = {}) {
-      return graphClient.analyze(input);
-    },
-    async bias(input = {}) {
-      return graphClient.bias(input);
-    },
-    async gaps(input) {
-      return graphClient.gaps(input);
-    },
     async falsify(input, idempotencyKey = randomIdempotencyKey()) {
       return gateway.request({
         path: "/api/platform/v1/graph/falsify",
@@ -1882,6 +1860,12 @@ function createGraphFacade(config = {}) {
       });
     }
   };
+  return Object.assign(graphFacade, {
+    traverse: graphClient.traverse,
+    analyze: graphClient.analyze,
+    bias: graphClient.bias,
+    gaps: graphClient.gaps
+  });
 }
 function createIdentityFacade(config = {}) {
   const identityClient = createIdentityClient(config);
@@ -1895,15 +1879,12 @@ function createIdentityFacade(config = {}) {
 function createOntologiesFacade(config = {}) {
   const ontologyClient = createOntologyClient(config);
   const gateway = createGatewayRequestClient(config);
-  return {
+  const ontologyFacade = {
     async get(id) {
       return gateway.request({
         path: `/api/platform/v1/ontologies/${encodeURIComponent(id)}`
       });
     },
-    async list(query = {}) {
-      return ontologyClient.list(query);
-    },
     async bind(input, idempotencyKey) {
       return gateway.request({
         path: `/api/platform/v1/ontologies/${encodeURIComponent(input.ontologyId)}/bind`,
@@ -1923,6 +1904,9 @@ function createOntologiesFacade(config = {}) {
       });
     }
   };
+  return Object.assign(ontologyFacade, {
+    list: ontologyClient.list
+  });
 }
 function createQuestionsFacade(config = {}) {
   const gateway = createGatewayRequestClient(config);
@@ -2115,15 +2099,9 @@ function createTasksFacade(config = {}) {
 function createTopicsFacade(config = {}) {
   const topicsClient = createTopicsClient(config);
   return {
-    async create(input, idempotencyKey) {
-      return topicsClient.create(input, idempotencyKey);
-    },
-    async get(id) {
-      return topicsClient.get(id);
-    },
-    async list(query = {}) {
-      return topicsClient.list(query);
-    },
+    create: topicsClient.create,
+    get: topicsClient.get,
+    list: topicsClient.list,
     async update(input, idempotencyKey) {
       const { id, ...rest } = input;
       return topicsClient.update(id, rest, idempotencyKey);
@@ -2139,12 +2117,8 @@ function createTopicsFacade(config = {}) {
         maxDepth: input.maxDepth
       });
     },
-    async remove(id, idempotencyKey = randomIdempotencyKey()) {
-      return topicsClient.remove(id, idempotencyKey);
-    },
-    async bulkCreate(input, idempotencyKey = randomIdempotencyKey()) {
-      return topicsClient.bulkCreate(input, idempotencyKey);
-    }
+    remove: topicsClient.remove,
+    bulkCreate: topicsClient.bulkCreate
   };
 }
 function createWebhooksFacade(config = {}) {