feat(ping-sdk): standardize sdk configuration

feat(sdk-utilities): add pure unified config validation

feat(sdk-utilities): add unified config mapping functions

feat(sdk-utilities): export config module from sdk-utilities

test(sdk-utilities): add unit tests for config mapping and validation

feat(sdk-types): add OIDC authorize params to GetAuthorizationUrlOptions

feat(sdk-oidc): wire OIDC authorize params into buildAuthorizeParams

feat(oidc-client): add signOutRedirectUri to endSession URL

feat(oidc-client): accept unified JSON config in oidc factory

feat(journey-client): accept unified JSON config in journey factory

feat(davinci-client): accept unified JSON config in davinci factory

chore: update api-reports for unified config param widening

feat(sdk-utilities): align unified config schema with new journey
sub-object

refactor(sdk-utilities): mapper functions return ConfigMappingResult
with single error

fix(sdk-utilities): map log field and use config.log in factories

fix(sdk-utilities): tighten isUnifiedSdkConfig discriminant to require
object values

fix(oidc-client): use throw instead of Promise.reject in unified config
error paths

refactor(oidc-client): migrate logout.request.test.ts to it +
Micro.runPromise pattern

docs(oidc-client): add JSDoc to OidcConfig and all new fields

fix(sdk): tighten config param types to XConfig | UnifiedSdkConfig

test(oidc-client): migrate authorize.request.micros tests to @effect/vitest

test(oidc-client): migrate authorize.request.utils tests to @effect/vitest

refactor(sdk-utilities): use as const satisfies for required-field constants

refactor(sdk-utilities): replace mutable error array with effect Either in config validators

refactor(sdk): utility-first config — move json→config transform to sdk-utilities

refactor(sdk-utilities): remove LogLevel duplicates — use LogLevel from sdk-types

docs(changeset): update sdks-5067 changeset to reflect utility-first config API

refactor(sdk-utilities): rename *ConfigFromJson to make*Config

refactor(sdk-types): move client config types to sdk-types, delete Mapped* mirrors

Author: SteinGabriel

.changeset/sdks-5067-unified-config.md

@@ -0,0 +1,59 @@
+---
+'@forgerock/sdk-utilities': minor
+'@forgerock/sdk-types': minor
+'@forgerock/sdk-logger': patch
+'@forgerock/sdk-oidc': minor
+'@forgerock/oidc-client': minor
+'@forgerock/journey-client': minor
+'@forgerock/davinci-client': minor
+---
+
+Add unified cross-platform SDK configuration support
+
+New utility functions in `@forgerock/sdk-utilities` convert the cross-platform unified JSON config schema into each client's native config shape. Validation and mapping are owned entirely by the utilities layer — client factories remain typed to their existing config interfaces.
+
+**New in `@forgerock/sdk-utilities`:**
+
+- `makeOidcConfig(json)` — validates and maps unified JSON → `OidcConfig`; throws on invalid input
+- `makeJourneyConfig(json)` — validates and maps unified JSON → `JourneyClientConfig`; throws on invalid input
+- `makeDavinciConfig(json)` — validates and maps unified JSON → `DaVinciConfig`; throws on invalid input
+- `UnifiedSdkConfig`, `UnifiedOidcConfig`, `UnifiedJourneyConfig` types
+- `validateUnifiedSdkConfig` / `validateUnifiedOidcConfig` — pure validation returning `Either<T, ConfigValidationError[]>`
+- `unifiedToOidcConfig`, `unifiedToJourneyConfig`, `unifiedToDavinciConfig` — pure mappers returning `Either<T, ConfigValidationError>`
+- `isUnifiedSdkConfig` discriminator
+- `AuthDisplayValue`, `AuthPromptValue` types (canonical source — shared between `OidcConfig` and `GetAuthorizationUrlOptions`)
+
+**Usage:**
+
+```ts
+import { makeDavinciConfig } from '@forgerock/sdk-utilities';
+
+const client = await davinci({ config: makeDavinciConfig(unifiedJsonConfig) });
+```
+
+**New in `@forgerock/sdk-types`:**
+
+- `OidcConfig`, `JourneyClientConfig`, `DaVinciConfig` moved here as canonical types (previously mirrored in `sdk-utilities` as `Mapped*` types)
+- `AuthDisplayValue`, `AuthPromptValue` types added (renamed from `OidcDisplayValue`/`OidcPromptValue`)
+- `GetAuthorizationUrlOptions` extended with `loginHint`, `nonce`, `display`, `uiLocales`, `acrValues`; `prompt` widened to include `'select_account'`
+
+**Updated in `@forgerock/sdk-logger`:**
+
+- `LogLevel` now re-exported from `@forgerock/sdk-types` (single source of truth); runtime behaviour unchanged
+
+**New in `@forgerock/sdk-oidc`:**
+
+- `buildAuthorizeParams` forwards all new OIDC authorize params into the URL
+
+**New in `@forgerock/oidc-client`:**
+
+- `endSession` appends `post_logout_redirect_uri` when `signOutRedirectUri` is set on config
+- Authorize URL construction forwards `loginHint`, `state`, `nonce`, `display`, `prompt`, `uiLocales`, `acrValues`, `additionalParameters` from config
+
+**New in `@forgerock/journey-client`:**
+
+- No API change — consume `makeJourneyConfig` at call-site to use unified JSON config
+
+**New in `@forgerock/davinci-client`:**
+
+- No API change — consume `makeDavinciConfig` at call-site to use unified JSON config

packages/davinci-client/api-report/davinci-client.api.md

@@ -6,8 +6,8 @@
 
 import { ActionCreatorWithPayload } from '@reduxjs/toolkit';
 import { ActionTypes } from '@forgerock/sdk-request-middleware';
-import type { AsyncLegacyConfigOptions } from '@forgerock/sdk-types';
 import { CustomLogger } from '@forgerock/sdk-logger';
+import type { DaVinciConfig } from '@forgerock/sdk-types';
 import { FetchBaseQueryError } from '@reduxjs/toolkit/query';
 import type { FetchBaseQueryMeta } from '@reduxjs/toolkit/query';
 import { GenericError } from '@forgerock/sdk-types';
@@ -506,11 +506,7 @@ export type DaVinciCacheEntry = {
 // @public (undocumented)
 export type DavinciClient = Awaited<ReturnType<typeof davinci>>;
 
-// @public (undocumented)
-export interface DaVinciConfig extends AsyncLegacyConfigOptions {
-    // (undocumented)
-    responseType?: string;
-}
+export { DaVinciConfig }
 
 // @public (undocumented)
 export interface DaVinciError extends Omit<GenericError, 'error'> {

packages/davinci-client/api-report/davinci-client.types.api.md

@@ -6,8 +6,8 @@
 
 import { ActionCreatorWithPayload } from '@reduxjs/toolkit';
 import { ActionTypes } from '@forgerock/sdk-request-middleware';
-import type { AsyncLegacyConfigOptions } from '@forgerock/sdk-types';
 import { CustomLogger } from '@forgerock/sdk-logger';
+import type { DaVinciConfig } from '@forgerock/sdk-types';
 import { FetchBaseQueryError } from '@reduxjs/toolkit/query';
 import type { FetchBaseQueryMeta } from '@reduxjs/toolkit/query';
 import { GenericError } from '@forgerock/sdk-types';
@@ -506,11 +506,7 @@ export type DaVinciCacheEntry = {
 // @public (undocumented)
 export type DavinciClient = Awaited<ReturnType<typeof davinci>>;
 
-// @public (undocumented)
-export interface DaVinciConfig extends AsyncLegacyConfigOptions {
-    // (undocumented)
-    responseType?: string;
-}
+export { DaVinciConfig }
 
 // @public (undocumented)
 export interface DaVinciError extends Omit<GenericError, 'error'> {

packages/davinci-client/src/lib/client.store.test.ts

@@ -8,6 +8,7 @@
 import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
 
 import { davinci } from './client.store.js';
+import { makeDavinciConfig } from '@forgerock/sdk-utilities';
 import type { DaVinciConfig } from './config.types.js';
 
 // ---------------------------------------------------------------------------
@@ -181,3 +182,59 @@ describe('davinci client — cache', () => {
     });
   });
 });
+
+// ---------------------------------------------------------------------------
+
+describe('unified JSON config entry', () => {
+  beforeEach(() => {
+    vi.stubGlobal('localStorage', makeStorageStub());
+    vi.stubGlobal('sessionStorage', makeStorageStub());
+    mockFetchImplementation();
+  });
+
+  afterEach(() => {
+    vi.unstubAllGlobals();
+    vi.restoreAllMocks();
+  });
+
+  it('accepts unified JSON config and initializes successfully', async () => {
+    const unifiedConfig = {
+      oidc: {
+        clientId: '123456789',
+        discoveryEndpoint: TEST_WELLKNOWN_URL,
+        scopes: ['openid', 'profile'],
+        redirectUri: 'https://example.com/callback',
+      },
+    };
+
+    const client = await davinci({ config: makeDavinciConfig(unifiedConfig) });
+    expect(client).toHaveProperty('flow');
+    expect(client).toHaveProperty('subscribe');
+  });
+
+  it('throws when unified JSON config has missing required field', async () => {
+    const invalidConfig = {
+      oidc: {
+        // clientId missing
+        discoveryEndpoint: TEST_WELLKNOWN_URL,
+        scopes: ['openid'],
+        redirectUri: 'https://example.com/callback',
+      },
+    };
+
+    expect(() => makeDavinciConfig(invalidConfig)).toThrow(/Invalid unified SDK config/);
+  });
+
+  it('throws when unified JSON config has wrong field type', async () => {
+    const invalidConfig = {
+      oidc: {
+        clientId: '123',
+        discoveryEndpoint: TEST_WELLKNOWN_URL,
+        scopes: 'openid', // should be array
+        redirectUri: 'https://example.com/callback',
+      },
+    };
+
+    expect(() => makeDavinciConfig(invalidConfig)).toThrow(/Invalid unified SDK config/);
+  });
+});

packages/davinci-client/src/lib/client.store.ts

@@ -77,7 +77,10 @@ export async function davinci<ActionType extends ActionTypes = ActionTypes>({
     custom?: CustomLogger;
   };
 }) {
-  const log = loggerFn({ level: logger?.level || 'error', custom: logger?.custom });
+  const log = loggerFn({
+    level: logger?.level ?? config.log ?? 'error',
+    custom: logger?.custom,
+  });
   const store = createClientStore({ requestMiddleware, logger: log });
   const serverInfo = createStorage<ContinueNode['server']>({
     type: 'localStorage',

packages/davinci-client/src/lib/config.types.ts

@@ -5,11 +5,10 @@
  * of the MIT license. See the LICENSE file for details.
  */
 
-import type { AsyncLegacyConfigOptions, WellknownResponse } from '@forgerock/sdk-types';
+import type { WellknownResponse } from '@forgerock/sdk-types';
+import type { DaVinciConfig } from '@forgerock/sdk-types';
 
-export interface DaVinciConfig extends AsyncLegacyConfigOptions {
-  responseType?: string;
-}
+export type { DaVinciConfig };
 
 export interface InternalDaVinciConfig extends DaVinciConfig {
   wellknownResponse: WellknownResponse;

packages/journey-client/api-report/journey-client.api.md

@@ -5,7 +5,6 @@
 ```ts
 
 import { ActionTypes } from '@forgerock/sdk-request-middleware';
-import type { AsyncLegacyConfigOptions } from '@forgerock/sdk-types';
 import { AuthResponse } from '@forgerock/sdk-types';
 import { Callback } from '@forgerock/sdk-types';
 import { CallbackType } from '@forgerock/sdk-types';
@@ -16,6 +15,8 @@ import { FailedPolicyRequirement } from '@forgerock/sdk-types';
 import { FailureDetail } from '@forgerock/sdk-types';
 import { GenericError } from '@forgerock/sdk-types';
 import { isValidWellknownUrl } from '@forgerock/sdk-utilities';
+import { JourneyClientConfig } from '@forgerock/sdk-types';
+import { JourneyServerConfig } from '@forgerock/sdk-types';
 import { LogLevel } from '@forgerock/sdk-logger';
 import { NameValue } from '@forgerock/sdk-types';
 import { PolicyKey } from '@forgerock/sdk-types';
@@ -202,11 +203,7 @@ export interface JourneyClient {
     }) => Promise<void | GenericError>;
 }
 
-// @public
-export interface JourneyClientConfig extends AsyncLegacyConfigOptions {
-    // (undocumented)
-    serverConfig: JourneyServerConfig;
-}
+export { JourneyClientConfig }
 
 // @public (undocumented)
 export type JourneyLoginFailure = AuthResponse & {
@@ -231,11 +228,7 @@ export type JourneyLoginSuccess = AuthResponse & {
 // @public
 export type JourneyResult = JourneyStep | JourneyLoginSuccess | JourneyLoginFailure | GenericError;
 
-// @public
-export interface JourneyServerConfig {
-    timeout?: number;
-    wellknown: string;
-}
+export { JourneyServerConfig }
 
 // @public (undocumented)
 export type JourneyStep = AuthResponse & {

packages/journey-client/api-report/journey-client.types.api.md

@@ -5,7 +5,6 @@
 ```ts
 
 import { ActionTypes } from '@forgerock/sdk-request-middleware';
-import type { AsyncLegacyConfigOptions } from '@forgerock/sdk-types';
 import { AuthResponse } from '@forgerock/sdk-types';
 import { Callback } from '@forgerock/sdk-types';
 import { CallbackType } from '@forgerock/sdk-types';
@@ -15,6 +14,8 @@ import { FailedPolicyRequirement } from '@forgerock/sdk-types';
 import { FailureDetail } from '@forgerock/sdk-types';
 import { GenericError } from '@forgerock/sdk-types';
 import { isValidWellknownUrl } from '@forgerock/sdk-utilities';
+import { JourneyClientConfig } from '@forgerock/sdk-types';
+import { JourneyServerConfig } from '@forgerock/sdk-types';
 import { LogLevel } from '@forgerock/sdk-logger';
 import { NameValue } from '@forgerock/sdk-types';
 import { PolicyKey } from '@forgerock/sdk-types';
@@ -189,11 +190,7 @@ export interface JourneyClient {
     }) => Promise<void | GenericError>;
 }
 
-// @public
-export interface JourneyClientConfig extends AsyncLegacyConfigOptions {
-    // (undocumented)
-    serverConfig: JourneyServerConfig;
-}
+export { JourneyClientConfig }
 
 // @public (undocumented)
 export type JourneyLoginFailure = AuthResponse & {
@@ -218,11 +215,7 @@ export type JourneyLoginSuccess = AuthResponse & {
 // @public
 export type JourneyResult = JourneyStep | JourneyLoginSuccess | JourneyLoginFailure | GenericError;
 
-// @public
-export interface JourneyServerConfig {
-    timeout?: number;
-    wellknown: string;
-}
+export { JourneyServerConfig }
 
 // @public (undocumented)
 export type JourneyStep = AuthResponse & {

packages/journey-client/package.json

@@ -39,6 +39,7 @@
     "@forgerock/sdk-utilities": "workspace:*",
     "@forgerock/storage": "workspace:*",
     "@reduxjs/toolkit": "catalog:",
+    "effect": "catalog:effect",
     "tslib": "catalog:"
   },
   "devDependencies": {

packages/journey-client/src/lib/client.store.test.ts

@@ -12,6 +12,7 @@ import { afterEach, describe, expect, test, vi } from 'vitest';
 import type { GenericError, Step, WellknownResponse } from '@forgerock/sdk-types';
 
 import { journey } from './client.store.js';
+import { makeJourneyConfig } from '@forgerock/sdk-utilities';
 import { createJourneyStep } from './step.utils.js';
 import { JourneyClientConfig } from './config.types.js';
 
@@ -502,4 +503,46 @@ describe('journey-client', () => {
       expect(request.url).toBe('https://test.com/am/json/realms/root/realms/alpha/authenticate');
     });
   });
+
+  describe('unified JSON config entry', () => {
+    test('accepts unified JSON config and initializes successfully', async () => {
+      setupMockFetch();
+
+      const unifiedConfig = {
+        oidc: {
+          clientId: 'ignored-by-journey',
+          discoveryEndpoint: mockWellknownUrl,
+          scopes: ['openid'],
+          redirectUri: 'https://example.com/callback',
+        },
+      };
+
+      const client = await journey({ config: makeJourneyConfig(unifiedConfig) });
+      expect(client).toHaveProperty('start');
+      expect(client).toHaveProperty('next');
+    });
+
+    test('throws when unified JSON config has missing required field', async () => {
+      const invalidConfig = {
+        oidc: {
+          // discoveryEndpoint missing — required even for journey
+        },
+      };
+
+      expect(() => makeJourneyConfig(invalidConfig)).toThrow(/Invalid unified SDK config/);
+    });
+
+    test('throws when unified JSON config has wrong field type', async () => {
+      const invalidConfig = {
+        oidc: {
+          clientId: '123',
+          discoveryEndpoint: mockWellknownUrl,
+          scopes: 'openid', // should be array
+          redirectUri: 'https://example.com/callback',
+        },
+      };
+
+      expect(() => makeJourneyConfig(invalidConfig)).toThrow(/Invalid unified SDK config/);
+    });
+  });
 });