@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:64

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)

---

assetQuery?

optional assetQuery: string[]

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

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:80

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:82

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:86

Catalog IDs for WebDAV browsing

---

certificate?

optional certificate: string

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

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:102

Passphrase for the certificate

---

cipHost?

optional cipHost: string

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

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:84

Default content library ID for content export/list commands

---

hostname?

optional hostname: string

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

B2C instance hostname

---

jwtCertPath?

optional jwtCertPath: string

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

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:108

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:110

Optional passphrase for encrypted JWT private key

---

libraries?

optional libraries: (string | LibraryEntry)[]

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

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:70

MRT API key

---

mrtEnvironment?

optional mrtEnvironment: string

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

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

---

mrtOrigin?

optional mrtOrigin: string

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

MRT cloud origin URL

---

mrtProject?

optional mrtProject: string

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

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:78

Default ODS realm for sandbox operations

---

safety?

optional safety: object

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

Safety configuration for this instance.

confirm?

optional confirm: boolean

level?

optional level: string

rules?

optional rules: object[]

Example

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

---

sandboxApiHost?

optional sandboxApiHost: string

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

ODS API hostname

---

selfSigned?

optional selfSigned: boolean

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

Whether to skip SSL/TLS certificate verification (self-signed certs)

---

shortCode?

optional shortCode: string

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

SCAPI short code

---

siteId?

optional siteId: string

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

B2C Commerce site/channel ID

---

slasClientId?

optional slasClientId: string

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

SLAS client ID for shopper authentication

---

slasClientSecret?

optional slasClientSecret: string

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

SLAS client secret for private shopper clients

---

tenantId?

optional tenantId: string

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

Tenant/Organization ID for SCAPI

---

username?

optional username: string

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

Username for Basic auth (WebDAV)

---

webdavHostname?

optional webdavHostname: string

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

Alternate hostname for WebDAV (if different from main hostname)