Skip to main content

MandaitorConfigClient

@mandaitor/sdk


@mandaitor/sdk / MandaitorConfigClient

Class: MandaitorConfigClient

Defined in: @mandaitor/sdk/dist/widget-config.d.ts:94

Client for managing embeddable-widget configuration. Provides tenant-side methods (get/update config, validate an IdP, list versions, roll back — all requiring a Cognito JWT) and a public method to fetch the safe, secret-free config for embedding.

Constructors​

Constructor​

new MandaitorConfigClient(baseUrl, authToken, tenantId?): MandaitorConfigClient

Defined in: @mandaitor/sdk/dist/widget-config.d.ts:98

Parameters​

baseUrl​

string

authToken​

string

tenantId?​

string

Returns​

MandaitorConfigClient

Methods​

getPublicWidgetConfig()​

getPublicWidgetConfig(widgetId): Promise<PublicWidgetConfig>

Defined in: @mandaitor/sdk/dist/widget-config.d.ts:147

Fetch the public-safe widget configuration for embedding. This endpoint requires no authentication.

Parameters​

widgetId​

string

Returns​

Promise<PublicWidgetConfig>


getWidgetConfig()​

getWidgetConfig(version?): Promise<WidgetConfiguration>

Defined in: @mandaitor/sdk/dist/widget-config.d.ts:101

Parameters​

version?​

number

Returns​

Promise<WidgetConfiguration>


listConfigVersions()​

listConfigVersions(params?): Promise<{ next_cursor?: string; versions: ConfigVersionSummary[]; }>

Defined in: @mandaitor/sdk/dist/widget-config.d.ts:123

List all configuration versions for the tenant, sorted by version descending. Returns version summaries (not full configs) with pagination.

Parameters​

params?​
cursor?​

string

limit?​

number

Returns​

Promise<{ next_cursor?: string; versions: ConfigVersionSummary[]; }>


rollbackConfig()​

rollbackConfig(version): Promise<{ rollbackFrom: number; version: number; widgetId: string; }>

Defined in: @mandaitor/sdk/dist/widget-config.d.ts:138

Roll back the widget configuration to a previous version.

This creates a NEW version that is a copy of the target version, preserving the full version history for audit purposes.

Parameters​

version​

number

The version number to roll back to

Returns​

Promise<{ rollbackFrom: number; version: number; widgetId: string; }>


updateWidgetConfig()​

updateWidgetConfig(config): Promise<{ version: number; widgetId: string; }>

Defined in: @mandaitor/sdk/dist/widget-config.d.ts:102

Parameters​

config​

Partial<WidgetConfiguration>

Returns​

Promise<{ version: number; widgetId: string; }>


validateIdPConfig()​

validateIdPConfig(provider, config): Promise<{ message: string; valid: boolean; }>

Defined in: @mandaitor/sdk/dist/widget-config.d.ts:115

Validate an IdP configuration by attempting a client credentials flow.

Sends both provider (API spec canonical) and idpType (Lambda alias) so the request works regardless of which the server expects.

Parameters​

provider​

string

The IdP type to validate (e.g. "entra_id", "auth0", "okta", "eidas_eudi")

config​

IdPConfig

The IdP-specific configuration object

Returns​

Promise<{ message: string; valid: boolean; }>