inspector/core/client/config-parse.ts
Bob Dickinson 5de4e911e3
feat(web,core): enterprise-managed authorization (EMA) (#1509) (#1512)
Adds enterprise-managed authorization (EMA): browser-side IdP login + RFC 8693 token-exchange and JWT-bearer resource-token mint, per-server EMA opt-in in Server Settings, IdP config in Client Settings, and IdP clientSecret keychain storage. Includes the v2/main merge and review follow-ups (400 on malformed client config; normalizeIdpIssuer import consolidation).
2026-06-24 22:15:12 -04:00

61 lines
1.7 KiB
TypeScript

/**
* Browser-safe client.json parse/validate (no Node file I/O).
*/
import { z } from "zod";
import type { ClientConfig } from "./types.js";
const HttpUrlStringSchema = z.string().min(1).superRefine((val, ctx) => {
const trimmed = val.trim();
if (!URL.canParse(trimmed)) {
ctx.addIssue({
code: z.ZodIssueCode.custom,
message: `Invalid URL: "${trimmed}" — must be an absolute URL (e.g. https://idp.example.com)`,
});
}
});
const EnterpriseManagedAuthIdpConfigSchema = z.object({
issuer: HttpUrlStringSchema,
clientId: z.string().min(1),
clientSecret: z.string().optional(),
});
const ClientConfigSchema = z.object({
enterpriseManagedAuth: z
.object({
enabled: z.boolean().optional(),
idp: EnterpriseManagedAuthIdpConfigSchema,
})
.optional(),
});
/**
* Parse and validate unknown JSON into {@link ClientConfig}.
* @throws {z.ZodError} when shape is invalid
*/
export function parseClientConfig(raw: unknown): ClientConfig {
return ClientConfigSchema.parse(raw);
}
/** Canonical JSON serialization for client.json (matches backend store-io format). */
export function serializeClientConfig(config: ClientConfig): string {
return JSON.stringify(config, null, 2);
}
/** Human-readable message for a failed client.json load (parse or transport). */
export function formatClientConfigLoadError(error: unknown): string {
if (error instanceof z.ZodError) {
const issue = error.issues[0];
if (issue) {
const field =
issue.path.length > 0 ? issue.path.map(String).join(".") : "config";
return `${field}: ${issue.message}`;
}
return "Invalid client.json shape";
}
if (error instanceof Error) {
return error.message;
}
return String(error);
}