@salesforce/b2c-tooling-sdk / config / DwJsonConfig

Interface: DwJsonConfig

Defined in: packages/b2c-tooling-sdk/src/config/dw-json.ts:32

Configuration structure for dw.json after key normalization.

All keys are normalized to camelCase by normalizeConfigKeys() when loading. Both camelCase and kebab-case are accepted in the raw file; the interface documents the canonical (post-normalization) field names.

Legacy aliases (e.g., server, secureHostname, passphrase, selfsigned, cloudOrigin, scapi-shortcode) are also accepted and mapped to their canonical names during normalization.

Extended by

DwJsonMultiConfig

Properties

accountManagerHost?

optional accountManagerHost: string

Defined in: packages/b2c-tooling-sdk/src/config/dw-json.ts:72

Account Manager hostname for OAuth

active?

optional active: boolean

Defined in: packages/b2c-tooling-sdk/src/config/dw-json.ts:36

Whether this config is active (for multi-config files)

apiBackend?

optional apiBackend: "ocapi" | "scapi" | "auto"

Defined in: packages/b2c-tooling-sdk/src/config/dw-json.ts:118

API backend preference for operations that support both OCAPI and SCAPI

assetQuery?

optional assetQuery: string[]

Defined in: packages/b2c-tooling-sdk/src/config/dw-json.ts:106

JSON dot-paths for asset extraction during content library parsing (defaults to ['image.path'])

authMethods?

optional authMethods: AuthMethod[]

Defined in: packages/b2c-tooling-sdk/src/config/dw-json.ts:62

Allowed authentication methods in priority order

autoUpload?

optional autoUpload: boolean

Defined in: packages/b2c-tooling-sdk/src/config/dw-json.ts:88

Whether to auto-start code upload/sync in IDE extensions

cartridges?

optional cartridges: string | string[]

Defined in: packages/b2c-tooling-sdk/src/config/dw-json.ts:90

Cartridge names to include in deploy/watch (string with colon/comma separators, or array)

catalogs?

optional catalogs: string[]

Defined in: packages/b2c-tooling-sdk/src/config/dw-json.ts:96

Catalog IDs for WebDAV browsing

certificate?

optional certificate: string

Defined in: packages/b2c-tooling-sdk/src/config/dw-json.ts:112

Path to PKCS12 certificate file for mTLS (two-factor auth)

certificatePassphrase?

optional certificatePassphrase: string

Defined in: packages/b2c-tooling-sdk/src/config/dw-json.ts:114

Passphrase for the certificate

cipHost?

optional cipHost: string

Defined in: packages/b2c-tooling-sdk/src/config/dw-json.ts:108

Optional CIP analytics host override

clientId?

optional clientId: string

Defined in: packages/b2c-tooling-sdk/src/config/dw-json.ts:46

OAuth client ID

clientSecret?

optional clientSecret: string

Defined in: packages/b2c-tooling-sdk/src/config/dw-json.ts:48

OAuth client secret

codeVersion?

optional codeVersion: string

Defined in: packages/b2c-tooling-sdk/src/config/dw-json.ts:40

Code version for deployments

contentLibrary?

optional contentLibrary: string

Defined in: packages/b2c-tooling-sdk/src/config/dw-json.ts:94

Default content library ID for content export/list commands

docsCategories?

optional docsCategories: string[]

Defined in: packages/b2c-tooling-sdk/src/config/dw-json.ts:110

Documentation categories to expose (allowlist); dw.json key docs-categories

hostname?

optional hostname: string

Defined in: packages/b2c-tooling-sdk/src/config/dw-json.ts:38

B2C instance hostname

importSetExclude?

optional importSetExclude: string[]

Defined in: packages/b2c-tooling-sdk/src/config/dw-json.ts:92

Directory paths to exclude recursively from import-set source discovery

jwtCertPath?

optional jwtCertPath: string

Defined in: packages/b2c-tooling-sdk/src/config/dw-json.ts:122

Path to JWT certificate file (cert.pem) for JWT authentication

jwtKeyPath?

optional jwtKeyPath: string

Defined in: packages/b2c-tooling-sdk/src/config/dw-json.ts:124

Path to JWT private key file (key.pem) for JWT authentication

jwtPassphrase?

optional jwtPassphrase: string

Defined in: packages/b2c-tooling-sdk/src/config/dw-json.ts:126

Optional passphrase for encrypted JWT private key

libraries?

optional libraries: (string | LibraryEntry)[]

Defined in: packages/b2c-tooling-sdk/src/config/dw-json.ts:104

Library IDs for WebDAV browsing and the Content Libraries tree.

Accepts either a string array or a mixed array of strings and {id, siteLibrary?} objects. Object entries can mark individual libraries as site-private.

mrtApiKey?

optional mrtApiKey: string

Defined in: packages/b2c-tooling-sdk/src/config/dw-json.ts:78

MRT API key

mrtBackend?

optional mrtBackend: "scapi" | "auto" | "legacy"

Defined in: packages/b2c-tooling-sdk/src/config/dw-json.ts:120

MRT backend preference: legacy MRT Cloud API vs SCAPI MRT deployments API

mrtEnvironment?

optional mrtEnvironment: string

Defined in: packages/b2c-tooling-sdk/src/config/dw-json.ts:76

MRT environment name (e.g., staging, production)

mrtOrigin?

optional mrtOrigin: string

Defined in: packages/b2c-tooling-sdk/src/config/dw-json.ts:80

MRT cloud origin URL

mrtProject?

optional mrtProject: string

Defined in: packages/b2c-tooling-sdk/src/config/dw-json.ts:74

MRT project slug

name?

optional name: string

Defined in: packages/b2c-tooling-sdk/src/config/dw-json.ts:34

Instance name (for multi-config files)

oauthScopes?

optional oauthScopes: string[]

Defined in: packages/b2c-tooling-sdk/src/config/dw-json.ts:50

OAuth scopes

password?

optional password: string

Defined in: packages/b2c-tooling-sdk/src/config/dw-json.ts:44

Password/access-key for Basic auth (WebDAV)

realm?

optional realm: string

Defined in: packages/b2c-tooling-sdk/src/config/dw-json.ts:86

Default ODS realm for sandbox operations

safety?

optional safety: object

Defined in: packages/b2c-tooling-sdk/src/config/dw-json.ts:144

Safety configuration for this instance.

confirm?

optional confirm: boolean

level?

optional level: string

rules?

optional rules: object[]

Example

json

{
  "safety": {
    "level": "NO_UPDATE",
    "confirm": true,
    "rules": [
      { "job": "sfcc-site-archive-export", "action": "allow" },
      { "command": "sandbox:*", "action": "confirm" }
    ]
  }
}