@lucern/sdk 1.0.28 → 1.0.30

package/dist/orgGraphSearchClient.d.ts

@@ -4,23 +4,16 @@ export type OrgGraphSearchClientConfig = GatewayClientConfig;
 export declare const ORG_GRAPH_SEARCH_FIELDS: readonly ["tenantId", "workspaceId", "query", "nodeTypes", "minConfidence", "limit", "cursor", "provenanceScope"];
 export type OrgGraphProvenanceScope = "canonical" | "published" | "own_workspace" | "cross_workspace";
 export type OrgGraphVisibility = "private" | "workspace" | "tenant" | "public";
-export type OrgGraphSearchProvenance = {
+export interface OrgGraphSearchProvenance {
+    metadata?: JsonObject | null;
+    publishedAt?: number;
+    publishedByPrincipalId?: string;
     scope?: OrgGraphProvenanceScope | string;
     source?: string;
     sourceNodeId?: string;
     sourceWorkspaceId?: string;
-    publishedAt?: number;
-    publishedByPrincipalId?: string;
-    metadata?: JsonObject | null;
-};
-export type OrgGraphSearchResult = {
-    nodeId: string;
-    globalId?: string;
-    topicId?: string;
-    sourceWorkspaceId?: string;
-    publishedAt?: number;
-    publishedByPrincipalId?: string;
-    visibility?: OrgGraphVisibility | string;
+}
+export interface OrgGraphSearchResult {
     confidence?: number | null;
     confidenceHistory?: Array<{
         confidence?: number;
@@ -28,46 +21,53 @@ export type OrgGraphSearchResult = {
         rationale?: string;
         trigger?: string;
     }>;
-    provenance?: OrgGraphSearchProvenance;
+    globalId?: string;
+    metadata?: JsonObject | null;
+    nodeId: string;
     nodeType?: string;
+    provenance?: OrgGraphSearchProvenance;
+    publishedAt?: number;
+    publishedByPrincipalId?: string;
+    sourceWorkspaceId?: string;
     text?: string;
     title?: string;
-    metadata?: JsonObject | null;
-};
-export type OrgGraphSearchInput = {
-    tenantId: string;
-    workspaceId: string;
-    query: string;
-    nodeTypes?: string[];
-    minConfidence?: number;
-    limit?: number;
+    topicId?: string;
+    visibility?: OrgGraphVisibility | string;
+}
+export interface OrgGraphSearchInput {
     cursor?: string;
+    limit?: number;
+    minConfidence?: number;
+    nodeTypes?: string[];
     provenanceScope?: OrgGraphProvenanceScope;
-};
-export type GetOrgGraphNodeInput = {
+    query: string;
     tenantId: string;
     workspaceId: string;
-    nodeId?: string;
+}
+export interface GetOrgGraphNodeInput {
     globalId?: string;
-};
-export type ListOrgGraphByProvenanceInput = {
+    nodeId?: string;
     tenantId: string;
     workspaceId: string;
-    provenanceScope: OrgGraphProvenanceScope;
-    nodeTypes?: string[];
-    minConfidence?: number;
-    limit?: number;
+}
+export interface ListOrgGraphByProvenanceInput {
     cursor?: string;
-};
-export type ListPublishedFromWorkspaceInput = {
+    limit?: number;
+    minConfidence?: number;
+    nodeTypes?: string[];
+    provenanceScope: OrgGraphProvenanceScope;
     tenantId: string;
     workspaceId: string;
-    sourceWorkspaceId?: string;
-    nodeTypes?: string[];
-    minConfidence?: number;
-    limit?: number;
+}
+export interface ListPublishedFromWorkspaceInput {
     cursor?: string;
-};
+    limit?: number;
+    minConfidence?: number;
+    nodeTypes?: string[];
+    sourceWorkspaceId?: string;
+    tenantId: string;
+    workspaceId: string;
+}
 export type OrgGraphSearchResponse = ListResult<OrgGraphSearchResult, "results">;
 export declare function createOrgGraphSearchClient(config?: OrgGraphSearchClientConfig): {
     search(input: OrgGraphSearchInput): Promise<import("./coreClient").PlatformGatewaySuccess<OrgGraphSearchResponse>>;

package/dist/orgGraphSearchClient.js

@@ -1,3 +1,4 @@
+// biome-ignore-all lint/style/useFilenamingConvention: This file is an @lucern/sdk public import ABI / package subpath compatibility surface; the camelCase filename is intentional.
 import { createGatewayRequestClient, toQueryString, } from "./coreClient.js";
 import { createListResult, mapGatewayData } from "./sdkSurface.js";
 export const ORG_GRAPH_SEARCH_FIELDS = [
@@ -47,28 +48,32 @@ function listQuery(input) {
         cursor: input.cursor,
     };
 }
-function mapResults(data) {
+function orgGraphSearchRows(data) {
     const record = data && typeof data === "object" ? data : {};
-    return createListResult(Array.isArray(record.results)
-        ? record.results
-        : Array.isArray(data)
-            ? data
-            : [], "results");
+    if (Array.isArray(record.results)) {
+        return record.results;
+    }
+    return Array.isArray(data) ? data : [];
+}
+function mapResults(data) {
+    return createListResult(orgGraphSearchRows(data), "results");
 }
 export function createOrgGraphSearchClient(config = {}) {
     const gateway = createGatewayRequestClient(config);
     return {
         search(input) {
-            return gateway.request({
+            return gateway
+                .request({
                 path: "/api/platform/v1/org-graph-search/search",
                 method: "POST",
                 body: searchBody(input),
-            }).then((response) => mapGatewayData(response, mapResults));
+            })
+                .then((response) => mapGatewayData(response, mapResults));
         },
         getNode(input) {
             const nodeId = input.nodeId?.trim();
             const globalId = input.globalId?.trim();
-            if (!nodeId && !globalId) {
+            if (!(nodeId || globalId)) {
                 throw new Error("nodeId or globalId is required");
             }
             const nodePath = encodeURIComponent(nodeId ?? globalId ?? "");
@@ -81,20 +86,24 @@ export function createOrgGraphSearchClient(config = {}) {
             });
         },
         listByProvenance(input) {
-            return gateway.request({
+            return gateway
+                .request({
                 path: `/api/platform/v1/org-graph-search/provenance${toQueryString({
                     ...listQuery(input),
                     provenanceScope: input.provenanceScope,
                 })}`,
-            }).then((response) => mapGatewayData(response, mapResults));
+            })
+                .then((response) => mapGatewayData(response, mapResults));
         },
         listPublishedFromWorkspace(input) {
-            return gateway.request({
+            return gateway
+                .request({
                 path: `/api/platform/v1/org-graph-search/published${toQueryString({
                     ...listQuery(input),
                     sourceWorkspaceId: input.sourceWorkspaceId,
                 })}`,
-            }).then((response) => mapGatewayData(response, mapResults));
+            })
+                .then((response) => mapGatewayData(response, mapResults));
         },
     };
 }

package/dist/packsClient.d.ts

@@ -1,7 +1,7 @@
 import { type GatewayClientConfig, type GatewayScope, LucernApiError } from "./coreClient";
 import type { JsonObject } from "./types";
-export { LucernApiError };
 export type { GatewayScope, PlatformGatewaySuccess } from "./coreClient";
+export { LucernApiError };
 /** Configuration for the packs client. */
 export type PacksClientConfig = GatewayClientConfig;
 /** Input for installing a pack into a tenant or workspace scope. */

package/dist/packsClient.js

@@ -1,4 +1,7 @@
-import { createGatewayRequestClient, LucernApiError, randomIdempotencyKey, toQueryString, } from "./coreClient.js";
+// biome-ignore-all lint/style/useFilenamingConvention: This file is an @lucern/sdk public import ABI / package subpath compatibility surface; the camelCase filename is intentional.
+import { createGatewayRequestClient, 
+// biome-ignore lint/style/noExportedImports: packsClient preserves this legacy compatibility re-export while package root also exports coreClient.
+LucernApiError, randomIdempotencyKey, toQueryString, } from "./coreClient.js";
 import { createListResult, mapGatewayData } from "./sdkSurface.js";
 export { LucernApiError };
 /**
@@ -12,15 +15,17 @@ export function createPacksClient(config = {}) {
         /**
          * List catalog entries for available packs.
          */
-        async listCatalog() {
-            return gateway.request({
+        listCatalog() {
+            return gateway
+                .request({
                 path: "/api/platform/v1/packs/catalog",
-            }).then((response) => mapGatewayData(response, (data) => createListResult(Array.isArray(data) ? data : [], "catalog")));
+            })
+                .then((response) => mapGatewayData(response, (data) => createListResult(Array.isArray(data) ? data : [], "catalog")));
         },
         /**
          * Get the discovery catalog for packs.
          */
-        async getDiscoveryCatalog() {
+        getDiscoveryCatalog() {
             return gateway.request({
                 path: "/api/platform/v1/packs/discovery",
             });
@@ -28,7 +33,7 @@ export function createPacksClient(config = {}) {
         /**
          * Get discovery details for a specific pack.
          */
-        async getDiscoveryDetail(packKey) {
+        getDiscoveryDetail(packKey) {
             return gateway.request({
                 path: `/api/platform/v1/packs/discovery/${encodeURIComponent(packKey)}`,
             });
@@ -36,15 +41,17 @@ export function createPacksClient(config = {}) {
         /**
          * List pack states for the current scope.
          */
-        async listStates(query = {}) {
-            return gateway.request({
+        listStates(query = {}) {
+            return gateway
+                .request({
                 path: `/api/platform/v1/packs/states${toQueryString(query)}`,
-            }).then((response) => mapGatewayData(response, (data) => createListResult(Array.isArray(data) ? data : [], "states")));
+            })
+                .then((response) => mapGatewayData(response, (data) => createListResult(Array.isArray(data) ? data : [], "states")));
         },
         /**
          * Get health details for a pack.
          */
-        async getHealth(packKey, query = {}) {
+        getHealth(packKey, query = {}) {
             return gateway.request({
                 path: `/api/platform/v1/packs/${encodeURIComponent(packKey)}/health${toQueryString(query)}`,
             });
@@ -52,15 +59,17 @@ export function createPacksClient(config = {}) {
         /**
          * List pack telemetry entries.
          */
-        async listTelemetry(query = {}) {
-            return gateway.request({
+        listTelemetry(query = {}) {
+            return gateway
+                .request({
                 path: `/api/platform/v1/packs/telemetry${toQueryString(query)}`,
-            }).then((response) => mapGatewayData(response, (data) => createListResult(Array.isArray(data) ? data : [], "telemetry")));
+            })
+                .then((response) => mapGatewayData(response, (data) => createListResult(Array.isArray(data) ? data : [], "telemetry")));
         },
         /**
          * Create a pack entitlement.
          */
-        async createEntitlement(input, idempotencyKey) {
+        createEntitlement(input, idempotencyKey) {
             return gateway.request({
                 path: "/api/platform/v1/packs/entitlements",
                 method: "POST",
@@ -71,7 +80,7 @@ export function createPacksClient(config = {}) {
         /**
          * Install a pack.
          */
-        async install(input, idempotencyKey) {
+        install(input, idempotencyKey) {
             return gateway.request({
                 path: "/api/platform/v1/packs/install",
                 method: "POST",
@@ -82,7 +91,7 @@ export function createPacksClient(config = {}) {
         /**
          * Enable a pack.
          */
-        async enable(input, idempotencyKey) {
+        enable(input, idempotencyKey) {
             return gateway.request({
                 path: "/api/platform/v1/packs/enable",
                 method: "POST",
@@ -93,7 +102,7 @@ export function createPacksClient(config = {}) {
         /**
          * Disable a pack.
          */
-        async disable(input, idempotencyKey) {
+        disable(input, idempotencyKey) {
             return gateway.request({
                 path: "/api/platform/v1/packs/disable",
                 method: "POST",
@@ -104,7 +113,7 @@ export function createPacksClient(config = {}) {
         /**
          * Uninstall a pack.
          */
-        async uninstall(input, idempotencyKey) {
+        uninstall(input, idempotencyKey) {
             return gateway.request({
                 path: "/api/platform/v1/packs/uninstall",
                 method: "POST",
@@ -115,7 +124,7 @@ export function createPacksClient(config = {}) {
         /**
          * Upgrade a pack.
          */
-        async upgrade(input, idempotencyKey) {
+        upgrade(input, idempotencyKey) {
             return gateway.request({
                 path: "/api/platform/v1/packs/upgrade",
                 method: "POST",

package/dist/policyClient.d.ts

@@ -1,5 +1,4 @@
-import { type GatewayClientConfig, type GatewayScope, LucernApiError } from "./coreClient";
-export { LucernApiError };
+import { type GatewayClientConfig, type GatewayScope } from "./coreClient";
 export type { GatewayScope, PlatformGatewaySuccess } from "./coreClient";
 /** Configuration for the policy client. */
 export type PolicyClientConfig = GatewayClientConfig;
@@ -7,16 +6,16 @@ export type PolicyClientConfig = GatewayClientConfig;
 export type PermissionKind = "read" | "write";
 /** Permission level for a write policy rule. */
 export type WritePolicyPermission = "allow" | "deny" | "review_required";
-type TopicRecord = {
-    topicId?: string;
+/** Topic row returned from policy-scoped topic filters. */
+export interface PolicyTopicRecord {
+    isOwner?: boolean;
     name?: string;
+    topicId?: string;
     type?: string;
-    isOwner?: boolean;
     [key: string]: unknown;
-};
+}
 /** Structured explanation of how a policy decision was derived. */
-export type PolicyDecisionExplanation = {
-    summary?: string;
+export interface PolicyDecisionExplanation {
     matchedReasonCode?: string;
     steps?: Array<{
         stage?: string;
@@ -24,36 +23,37 @@ export type PolicyDecisionExplanation = {
         reasonCode?: string;
         detail?: string;
     }>;
+    summary?: string;
     [key: string]: unknown;
-};
+}
 /** Result of a permission check against the policy engine. */
-export type PermissionDecision = {
+export interface PermissionDecision {
     allowed?: boolean;
     decision?: string;
-    reasonCode?: string;
-    principalId?: string;
-    topicId?: string;
+    explanation?: PolicyDecisionExplanation;
     permission?: string;
     policyVersion?: string;
+    principalId?: string;
+    reasonCode?: string;
+    topicId?: string;
     traceId?: string | null;
-    explanation?: PolicyDecisionExplanation;
-};
+}
 /** A persisted write policy rule controlling mutation access. */
-export type WritePolicyRecord = {
+export interface WritePolicyRecord {
+    createdAt?: number;
+    createdBy?: string;
+    enabled?: boolean;
     id?: string;
-    topicId?: string;
-    role?: string;
-    toolCategory?: string;
-    permission?: WritePolicyPermission;
     maxWritesPerSession?: number;
-    enabled?: boolean;
+    permission?: WritePolicyPermission;
     rationale?: string;
-    createdAt?: number;
-    updatedAt?: number;
-    createdBy?: string;
     resolution?: string;
+    role?: string;
+    toolCategory?: string;
+    topicId?: string;
+    updatedAt?: number;
     [key: string]: unknown;
-};
+}
 /** Input for creating a write policy rule. */
 export type WritePolicyCreateInput = GatewayScope & {
     topicId?: string;
@@ -78,56 +78,67 @@ export type WritePolicyUpdateInput = GatewayScope & {
     rationale?: string;
     clearRationale?: boolean;
 };
-export type TenantPolicyPermission = {
-    resource: string;
+export interface TenantPolicyPermission {
     actions: string[];
-};
+    resource: string;
+}
 export type TenantPolicyKind = "role" | "object_classification";
 export type TenantPolicyExternalAccess = "allowed" | "summaries" | "omitted";
-export type TenantPolicyClassificationFields = {
-    policyKind?: TenantPolicyKind;
-    profileKey?: string;
-    objectTypes?: string[];
+export interface TenantPolicyClassificationFields {
     accessTier?: string;
-    exportClass?: string;
     classificationKey?: string;
     classificationLabels?: string[];
-    policyTags?: string[];
+    exportClass?: string;
     externalAccess?: TenantPolicyExternalAccess;
-    requiredGroupKey?: string;
-};
-export type TenantPolicyRecord = {
-    id?: string;
-    tenantId: string;
-    workspaceId?: string;
+    objectTypes?: string[];
     policyKind?: TenantPolicyKind;
-    roleName: string;
-    description?: string;
-    permissions: TenantPolicyPermission[];
-    groupBindings: string[];
+    policyTags?: string[];
     profileKey?: string;
-    objectTypes?: string[];
+    requiredGroupKey?: string;
+}
+export interface TenantPolicyRecord {
     accessTier?: string;
-    exportClass?: string;
     classificationKey?: string;
     classificationLabels?: string[];
-    policyTags?: string[];
+    createdAt?: number;
+    createdBy?: string;
+    description?: string;
+    exportClass?: string;
     externalAccess?: TenantPolicyExternalAccess;
+    groupBindings: string[];
+    id?: string;
+    objectTypes?: string[];
+    permissions: TenantPolicyPermission[];
+    policyKind?: TenantPolicyKind;
+    policyTags?: string[];
+    profileKey?: string;
     requiredGroupKey?: string;
-    createdAt?: number;
+    roleName: string;
+    tenantId: string;
     updatedAt?: number;
-    createdBy?: string;
     updatedBy?: string;
-};
-type FilterByPermissionResponse = {
+    workspaceId?: string;
+}
+/** Response envelope for accessible-topic policy queries. */
+export interface AccessibleTopicsResponse {
+    deniedTopics: Array<{
+        topicId: string;
+        reasonCode: string;
+    }>;
     permission: PermissionKind;
+    topics: PolicyTopicRecord[];
+    total: number;
+}
+/** Response envelope for topic permission filters. */
+export interface FilterByPermissionResponse {
     allowedTopicIds: string[];
+    count: number;
     deniedTopics: Array<{
         topicId: string;
         reasonCode: string;
     }>;
-    count: number;
-};
+    permission: PermissionKind;
+}
 /**
  * Create the policy client for permission checks, grants, and write policies.
  * @param config - Gateway transport configuration.
@@ -179,10 +190,10 @@ export declare function createPolicyClient(config?: PolicyClientConfig): {
         data: {
             policies: WritePolicyRecord[];
         };
-        success: true;
         correlationId: string;
-        policyTraceId: string | null;
         idempotentReplay: boolean;
+        policyTraceId: string | null;
+        success: true;
     }>;
     /**
      * Create a write policy rule.
@@ -193,10 +204,10 @@ export declare function createPolicyClient(config?: PolicyClientConfig): {
             created: boolean;
             policy: WritePolicyRecord | null;
         };
-        success: true;
         correlationId: string;
-        policyTraceId: string | null;
         idempotentReplay: boolean;
+        policyTraceId: string | null;
+        success: true;
     }>;
     /**
      * Update an existing write policy rule by identifier.
@@ -207,10 +218,10 @@ export declare function createPolicyClient(config?: PolicyClientConfig): {
             updated: boolean;
             policy: WritePolicyRecord | null;
         };
-        success: true;
         correlationId: string;
-        policyTraceId: string | null;
         idempotentReplay: boolean;
+        policyTraceId: string | null;
+        success: true;
     }>;
     /**
      * Delete a write policy rule by identifier.
@@ -226,10 +237,10 @@ export declare function createPolicyClient(config?: PolicyClientConfig): {
         data: {
             policies: TenantPolicyRecord[];
         };
-        success: true;
         correlationId: string;
-        policyTraceId: string | null;
         idempotentReplay: boolean;
+        policyTraceId: string | null;
+        success: true;
     }>;
     /**
      * Create a tenant role policy.
@@ -243,10 +254,10 @@ export declare function createPolicyClient(config?: PolicyClientConfig): {
         data: {
             policy: TenantPolicyRecord | null;
         };
-        success: true;
         correlationId: string;
-        policyTraceId: string | null;
         idempotentReplay: boolean;
+        policyTraceId: string | null;
+        success: true;
     }>;
     /**
      * Update a tenant role policy by identifier.
@@ -260,10 +271,10 @@ export declare function createPolicyClient(config?: PolicyClientConfig): {
         data: {
             policy: TenantPolicyRecord | null;
         };
-        success: true;
         correlationId: string;
-        policyTraceId: string | null;
         idempotentReplay: boolean;
+        policyTraceId: string | null;
+        success: true;
     }>;
     /**
      * Delete a tenant role policy by identifier.
@@ -291,17 +302,17 @@ export declare function createPolicyClient(config?: PolicyClientConfig): {
     }): Promise<{
         data: {
             permission: PermissionKind;
-            topics: TopicRecord[];
+            topics: PolicyTopicRecord[];
             total: number;
             deniedTopics: {
                 topicId: string;
                 reasonCode: string;
             }[];
         };
-        success: true;
         correlationId: string;
-        policyTraceId: string | null;
         idempotentReplay: boolean;
+        policyTraceId: string | null;
+        success: true;
     }>;
     /**
      * Filter topic identifiers by permission.