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

package/dist/identityClient.js

@@ -29,14 +29,14 @@ function requireString(value, reason, label) {
   }
   return normalized;
 }
-function requirePrincipalType(principalType2) {
-  if (!principalType2) {
+function requirePrincipalType(principalType) {
+  if (!principalType) {
     throw new LucernSdkAuthContextError(
       "principal_missing",
       "Canonical Lucern SDK auth context is missing principalType."
     );
   }
-  return principalType2;
+  return principalType;
 }
 function requireAuthMode(authMode) {
   if (!authMode) {
@@ -82,15 +82,14 @@ function normalizeCanonicalLucernAuthContext(input) {
   );
   const roles = cleanStringList(input.roles);
   const scopes = cleanStringList(input.scopes);
-  const principalType2 = 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;
@@ -111,7 +110,7 @@ function normalizeCanonicalLucernAuthContext(input) {
     principalId,
     tenantId,
     workspaceId,
-    principalType: principalType2,
+    principalType,
     authMode,
     roles,
     scopes,
@@ -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,
@@ -567,10 +532,7 @@ function createListResult(items, legacyKey) {
     total: items.length
   };
   if (legacyKey) {
-    return {
-      ...result,
-      [legacyKey]: items
-    };
+    result[legacyKey] = items;
   }
   return result;
 }
@@ -586,9 +548,6 @@ function cleanOptionalString(value) {
   const normalized = value?.trim();
   return normalized ? normalized : void 0;
 }
-function isRecord2(value) {
-  return Boolean(value) && typeof value === "object" && !Array.isArray(value);
-}
 function cleanRequiredString(value, label) {
   const normalized = cleanOptionalString(value);
   if (!normalized) {
@@ -610,117 +569,13 @@ function knownPayload(input, allowed, operation) {
   return { ...input };
 }
 function listResultFromEnvelope(data, legacyKey) {
-  const record = isRecord2(data) ? data : {};
-  const legacyItems = record[legacyKey];
+  const record = data && typeof data === "object" ? data : {};
   return createListResult(
-    Array.isArray(legacyItems) ? legacyItems : Array.isArray(data) ? data : [],
+    Array.isArray(record[legacyKey]) ? record[legacyKey] : Array.isArray(data) ? data : [],
     legacyKey
   );
 }
 
-// src/control-plane.ts
-var LucernControlPlaneIdentityError = class extends Error {
-  reason;
-  principalStatus;
-  tenantStatus;
-  workspaceStatus;
-  details;
-  constructor(failure) {
-    super(failure.message);
-    this.name = "LucernControlPlaneIdentityError";
-    this.reason = failure.reason;
-    this.principalStatus = failure.principalStatus;
-    this.tenantStatus = failure.tenantStatus;
-    this.workspaceStatus = failure.workspaceStatus;
-    this.details = failure.details;
-  }
-};
-function cleanString2(value) {
-  return typeof value === "string" && value.trim().length > 0 ? value.trim() : void 0;
-}
-function stringList(value) {
-  if (!Array.isArray(value)) {
-    return [];
-  }
-  return [
-    ...new Set(
-      value.filter((entry) => typeof entry === "string").map((entry) => entry.trim()).filter(Boolean)
-    )
-  ];
-}
-function principalType(value) {
-  switch (value) {
-    case "service":
-    case "service_principal":
-      return "service";
-    case "agent":
-      return "agent";
-    case "group":
-      return "group";
-    case "external_viewer":
-    case "external_stakeholder":
-      return "external_viewer";
-    default:
-      return "human";
-  }
-}
-function adminFlags(roles) {
-  const normalized = roles.map((role) => role.toLowerCase());
-  const isPlatformAdmin = normalized.includes("platform_admin");
-  const isTenantAdmin = isPlatformAdmin || normalized.includes("tenant_admin");
-  const isWorkspaceAdmin = isTenantAdmin || normalized.includes("workspace_admin") || normalized.includes("workspace_owner");
-  return { isPlatformAdmin, isTenantAdmin, isWorkspaceAdmin };
-}
-function normalizeResolvedInteractivePrincipal(payload) {
-  if ("ok" in payload && payload.ok === false) {
-    throw new LucernControlPlaneIdentityError(payload);
-  }
-  const principalId = cleanString2(payload.principalId);
-  const clerkId = cleanString2(payload.clerkId);
-  const tenantId = cleanString2(payload.tenantId);
-  if (!principalId || !clerkId || !tenantId) {
-    throw new LucernControlPlaneIdentityError({
-      ok: false,
-      reason: "resolver_unavailable",
-      message: "Control-plane principal resolver returned an incomplete principal context.",
-      principalStatus: payload.principalStatus ?? "missing",
-      tenantStatus: payload.tenantStatus,
-      workspaceStatus: payload.workspaceStatus
-    });
-  }
-  const roles = stringList(payload.roles);
-  const scopes = stringList(payload.scopes);
-  const workspaceId = cleanString2(payload.workspaceId) ?? null;
-  const flags = adminFlags(roles);
-  return {
-    principalId,
-    principalType: principalType(payload.principalType),
-    clerkId,
-    tenantId,
-    workspaceId,
-    roles,
-    scopes,
-    groupIds: stringList(payload.groupIds),
-    permittedToolNames: stringList(payload.permittedToolNames),
-    permittedPackKeys: stringList(payload.permittedPackKeys),
-    principalStatus: cleanString2(payload.principalStatus) ?? "active",
-    tenantStatus: cleanString2(payload.tenantStatus) ?? "active",
-    workspaceStatus: cleanString2(payload.workspaceStatus) ?? (workspaceId ? "active" : "none"),
-    isPlatformAdmin: typeof payload.isPlatformAdmin === "boolean" ? payload.isPlatformAdmin : flags.isPlatformAdmin,
-    isTenantAdmin: typeof payload.isTenantAdmin === "boolean" ? payload.isTenantAdmin : flags.isTenantAdmin,
-    isWorkspaceAdmin: typeof payload.isWorkspaceAdmin === "boolean" ? payload.isWorkspaceAdmin : flags.isWorkspaceAdmin,
-    permit: {
-      subject: cleanString2(payload.permit?.subject) ?? principalId,
-      tenant: cleanString2(payload.permit?.tenant) ?? tenantId,
-      ...workspaceId ? { workspace: cleanString2(payload.permit?.workspace) ?? workspaceId } : {}
-    },
-    authMode: "interactive_user",
-    sessionId: payload.sessionId,
-    delegatedBy: payload.delegatedBy,
-    expiresAt: payload.expiresAt
-  };
-}
-
 // src/identityClient.ts
 function createIdentityWhoamiClient(config = {}) {
   const gateway = createGatewayRequestClient(config);
@@ -772,13 +627,6 @@ 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.
@@ -788,25 +636,13 @@ function createIdentityClient(config = {}) {
         (response) => mapGatewayData(response, (data) => ({
           principalId: data.principalId,
           principalType: data.principalType,
-          clerkId: data.clerkId,
           tenantId: data.tenantId ?? null,
           workspaceId: data.workspaceId ?? null,
           scopes: Array.isArray(data.scopes) ? data.scopes : [],
           roles: Array.isArray(data.roles) ? data.roles : [],
-          groupIds: Array.isArray(data.groupIds) ? data.groupIds : [],
-          permittedToolNames: Array.isArray(data.permittedToolNames) ? data.permittedToolNames : [],
-          permittedPackKeys: Array.isArray(data.permittedPackKeys) ? data.permittedPackKeys : [],
-          principalStatus: data.principalStatus,
-          tenantStatus: data.tenantStatus,
-          workspaceStatus: data.workspaceStatus,
           isPlatformAdmin: data.isPlatformAdmin === true,
           isTenantAdmin: data.isTenantAdmin === true,
           isWorkspaceAdmin: data.isWorkspaceAdmin === true,
-          permit: data.permit ?? (data.tenantId ? {
-            subject: data.principalId,
-            tenant: data.tenantId,
-            ...data.workspaceId ? { workspace: data.workspaceId } : {}
-          } : void 0),
           authMode: data.authMode,
           sessionId: data.sessionId,
           delegatedBy: data.delegatedBy,
@@ -814,19 +650,6 @@ function createIdentityClient(config = {}) {
         }))
       );
     },
-    /**
-     * Resolve a Clerk subject through the tenant control-plane Permit projection.
-     * @deprecated Prefer lucern.controlPlane.identity.resolveInteractivePrincipal().
-     */
-    async resolveInteractivePrincipal(input) {
-      return gateway.request({
-        path: "/api/platform/v1/control-plane/identity/resolve-interactive-principal",
-        method: "POST",
-        body: input
-      }).then(
-        (response) => mapGatewayData(response, normalizeResolvedInteractivePrincipal)
-      );
-    },
     /**
      * List principals in the current identity scope.
      */
@@ -852,11 +675,15 @@ function createIdentityClient(config = {}) {
     /**
      * Update a principal.
      */
-    updatePrincipal,
+    async updatePrincipal(input, idempotencyKey) {
+      return requestPrincipalWrite("PATCH", input, idempotencyKey);
+    },
     /**
      * @deprecated Use createPrincipal or updatePrincipal.
      */
-    upsertPrincipal: updatePrincipal,
+    async upsertPrincipal(input, idempotencyKey) {
+      return requestPrincipalWrite("PATCH", input, idempotencyKey);
+    },
     /**
      * List keys in the current identity scope.
      */
@@ -895,11 +722,20 @@ function createIdentityClient(config = {}) {
     /**
      * Delete an API key by revoking it.
      */
-    deleteKey,
+    async deleteKey(keyId, input = {}, idempotencyKey) {
+      return gateway.request({
+        path: `/api/platform/v1/identity/keys/${encodeURIComponent(keyId)}/revoke`,
+        method: "POST",
+        body: input,
+        idempotencyKey: idempotencyKey ?? randomIdempotencyKey()
+      });
+    },
     /**
      * @deprecated Use deleteKey.
      */
-    revokeKey: deleteKey,
+    async revokeKey(keyId, input = {}, idempotencyKey) {
+      return this.deleteKey(keyId, input, idempotencyKey);
+    },
     /**
      * Search Clerk users by email or display attributes.
      */