@lucern/sdk 0.3.0-alpha.9 → 1.0.0

package/dist/control-plane.d.ts

@@ -0,0 +1,69 @@
+import { GatewayClientConfig, PlatformGatewaySuccess } from './coreClient.js';
+import { SdkPrincipalContext, JsonObject } from './types.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';
+
+type ControlPlanePrincipalType = "human" | "service" | "agent" | "group" | "external_viewer";
+type ControlPlanePrincipalStatus = "active" | "invited" | "suspended" | "disabled" | "revoked" | "missing";
+type ResolveInteractivePrincipalInput = {
+    clerkId: string;
+    tenantId?: string;
+    workspaceId?: string;
+    providerProjectId?: string;
+};
+type ControlPlanePermitSubject = {
+    subject: string;
+    tenant: string;
+    workspace?: string;
+};
+type ResolvedInteractivePrincipalContext = SdkPrincipalContext & {
+    principalType: ControlPlanePrincipalType;
+    authMode: "interactive_user";
+    clerkId: string;
+    tenantId: string;
+    workspaceId: string | null;
+    groupIds: string[];
+    permittedToolNames: string[];
+    permittedPackKeys: string[];
+    principalStatus: ControlPlanePrincipalStatus;
+    tenantStatus: string;
+    workspaceStatus: string;
+    permit: ControlPlanePermitSubject;
+};
+type ResolveInteractivePrincipalFailureReason = "principal_missing" | "tenant_missing" | "workspace_missing" | "membership_missing" | "ambiguous_principal" | "ambiguous_workspace" | "alias_invited" | "alias_suspended" | "alias_disabled" | "alias_revoked" | "principal_invited" | "principal_suspended" | "principal_disabled" | "principal_revoked" | "tenant_disabled" | "workspace_disabled" | "resolver_unavailable";
+type ResolveInteractivePrincipalFailure = {
+    ok: false;
+    reason: ResolveInteractivePrincipalFailureReason | (string & {});
+    message: string;
+    principalStatus?: ControlPlanePrincipalStatus | string;
+    tenantStatus?: string;
+    workspaceStatus?: string;
+    details?: JsonObject;
+};
+type ResolveInteractivePrincipalPayload = (ResolvedInteractivePrincipalContext & {
+    ok?: true;
+}) | ResolveInteractivePrincipalFailure;
+declare class LucernControlPlaneIdentityError extends Error {
+    readonly reason: ResolveInteractivePrincipalFailure["reason"];
+    readonly principalStatus?: string;
+    readonly tenantStatus?: string;
+    readonly workspaceStatus?: string;
+    readonly details?: JsonObject;
+    constructor(failure: ResolveInteractivePrincipalFailure);
+}
+declare function normalizeResolvedInteractivePrincipal(payload: ResolveInteractivePrincipalPayload): ResolvedInteractivePrincipalContext;
+type ResolveInteractivePrincipalResponse = PlatformGatewaySuccess<ResolvedInteractivePrincipalContext>;
+type ControlPlaneIdentityClientConfig = GatewayClientConfig;
+declare function createControlPlaneIdentityClient(config?: ControlPlaneIdentityClientConfig): {
+    resolveInteractivePrincipal(input: ResolveInteractivePrincipalInput): Promise<ResolveInteractivePrincipalResponse>;
+};
+declare function createControlPlaneClient(config?: ControlPlaneIdentityClientConfig): {
+    identity: {
+        resolveInteractivePrincipal(input: ResolveInteractivePrincipalInput): Promise<ResolveInteractivePrincipalResponse>;
+    };
+};
+
+export { type ControlPlaneIdentityClientConfig, type ControlPlanePermitSubject, type ControlPlanePrincipalStatus, type ControlPlanePrincipalType, LucernControlPlaneIdentityError, type ResolveInteractivePrincipalFailure, type ResolveInteractivePrincipalFailureReason, type ResolveInteractivePrincipalInput, type ResolveInteractivePrincipalResponse, type ResolvedInteractivePrincipalContext, createControlPlaneClient, createControlPlaneIdentityClient, normalizeResolvedInteractivePrincipal };