@salesforce/b2c-cli 2.3.1 → 2.4.0

package/content/guidance/b2c-cli/b2c-site-import-export/references/IMPORT-OPTIONS.md

@@ -0,0 +1,118 @@
+# Import Options
+
+## Import Commands
+
+### Import Local Directory
+
+```bash
+# Import a local directory as a site archive (waits for completion by default)
+b2c job import ./my-site-data
+
+# Import and return immediately without waiting
+b2c job import ./my-site-data --no-wait
+
+# Import a local zip file
+b2c job import ./export.zip
+
+# Keep the archive on the instance after import
+b2c job import ./my-site-data --keep-archive
+
+# Show job log if the import fails
+b2c job import ./my-site-data --show-log
+```
+
+### Import Remote Archive
+
+```bash
+# Import an archive that already exists on the instance (in Impex/src/instance/)
+b2c job import existing-archive.zip --remote
+```
+
+### Apply an Ordered, Idempotent Import Set
+
+Use `job import-set` when site import/export archives must be applied in order and skipped after the instance records their successful import. By default, the command reads discovered cartridge metadata first and the migrations directory second. This section is a summary; for the full migration workflow — source exclusions, post-import README notes, import history, set IDs, CI/CD patterns, and recovery — use the dedicated `b2c-cli:b2c-import-set-migrations` skill.
+
+Cartridge metadata supports two project layouts:
+
+- A standard site import/export archive directly inside `metadata/`, applied as one archive.
+- An ordered collection of immediate child directories or `.zip` files inside `metadata/`, with each child applied as one archive.
+
+Use one layout consistently within a cartridge. Cartridges are ordered by name, their archives are ordered lexically, and every cartridge archive is considered before the explicit import-set directory. Every directory-based archive must contain at least one file; empty directory trees are rejected before upload. The explicit directory uses the ordered-child layout:
+
+```text
+migrations/
+├── 20260801T140000-add-preferences/
+│   ├── meta/
+│   └── sites/
+├── 20260802T091500-seed-content.zip
+└── README.md                       # ignored
+```
+
+Name every archive `YYYYMMDDTHHmmss-description`, using UTC for cross-time-zone teams. The timestamp supplies ordering and helps keep archive names unique across projects.
+
+```bash
+# Show pending and already-applied archives without writing anything
+b2c job import-set --dry-run
+
+# Apply the default ./migrations directory
+b2c job import-set
+
+# Ignore discovered cartridge metadata and apply only ./migrations
+b2c job import-set --no-cartridge-metadata
+
+# Ignore project directories recursively during source discovery
+b2c job import-set --import-set-exclude fixtures --import-set-exclude test/integration
+
+# Apply a different directory
+b2c job import-set ./data-migrations
+
+# Keep uploaded archives for inspection
+b2c job import-set --keep-archive
+```
+
+Important semantics:
+
+- After an archive succeeds, later runs against the same instance skip it, including runs from other machines.
+- The archive name determines whether it has run; changing its contents does not cause another import. Never edit an applied archive—add a new, later-sorting archive for each change.
+- An interrupted run can retry its current archive. Make every archive safe to apply more than once.
+- Only one runner applies a history at a time. Other runners wait and then skip work completed while they were waiting.
+- An inactive run becomes recoverable after 30 minutes by default. Adjust this with `--stale-lock-seconds`; use `--break-lock` only after confirming the previous runner has stopped.
+- `--timeout` applies to each archive import, `--poll-interval` controls job polling, and `--lock-poll-interval` controls waiting for another runner.
+- `--import-set-exclude` can be repeated or comma-separated. Paths are relative to the project directory and exclude the named source directory and all descendants. Configure the same project default with `b2c.importSetExclude` in `package.json`, `import-set-exclude` in `dw.json`, or `SFCC_IMPORT_SET_EXCLUDE`.
+
+The default directory is `./migrations`; it may be absent if discovered cartridges supply at least one metadata archive. The default history name is `migrations` and is shared across runs against the target instance, regardless of local path. Most users should omit `--set-id`; use it only when intentionally creating an independent history. Cartridge discovery is enabled by default; use `--no-cartridge-metadata` to opt out.
+
+To start over without deleting the previous history, use a new set ID and keep using it on subsequent runs:
+
+```bash
+b2c job import-set --set-id migrations-reset-20260818
+```
+
+To reset the default history in place, remove it and rerun the import set:
+
+```bash
+b2c webdav rm --root=impex b2c-cli/import-sets/migrations
+b2c job import-set
+```
+
+For a custom set ID, replace the final `migrations` path segment with that ID. Resetting in place permanently forgets which archives succeeded and makes every current archive pending again, so only use it when every archive is safe to reapply. `--break-lock` is for recovery and does not reset history.
+
+### Import Archives Larger Than the Instance Limit
+
+An instance rejects a single import archive above its size limit (typically 200 MB). Use `--split` on a directory import to import the data in multiple smaller parts:
+
+```bash
+# Split a large directory import into multiple archive parts
+b2c job import ./big-site-data --split
+
+# Tune the per-archive size limit (default 190mb; bare number is MiB)
+b2c job import ./big-site-data --split --max-size 150mb
+```
+
+How splitting works:
+
+- **Metadata/XML is imported first**, kept together in one archive when it fits (so internal references and dependency ordering resolve within a single import). If the XML alone is too large, it splits at top-level data-unit boundaries (`catalogs`, `libraries`, `sites`, `meta`, …) in dependency order — never splitting a single unit.
+- **Static assets** (files under a `static/` folder) are deferred into later archive parts, packed by compressed size. They attach to the catalogs/libraries created by the metadata import.
+- Parts import sequentially; the command stops on the first failure.
+
+If a single file, or a single data unit's XML, is larger than `--max-size` on its own, the command errors (a file is never split across archives). A normal directory import that exceeds the limit warns and recommends `--split`. `--split` cannot be combined with `--remote`, subset paths, or `--no-wait`.

package/content/guidance/b2c-cli/b2c-site-import-export/references/METADATA-XML.md

@@ -0,0 +1,381 @@
+# Metadata XML Patterns
+
+Common XML patterns for site archive imports.
+
+## XSD Schema Reference
+
+For authoritative XML schema definitions, use the `b2c` CLI (if installed):
+
+```bash
+# View the metadata XSD schema
+b2c docs schema metadata
+
+# List all available schemas
+b2c docs schema --list
+```
+
+## Other Import Formats
+
+For service configurations (HTTP services, credentials, profiles), see the `b2c:b2c-webservices` skill.
+
+## System Object Extensions
+
+### Add String Attribute to Product
+
+```xml
+<?xml version="1.0" encoding="UTF-8"?>
+<metadata xmlns="http://www.demandware.com/xml/impex/metadata/2006-10-31">
+    <type-extension type-id="Product">
+        <custom-attribute-definitions>
+            <attribute-definition attribute-id="externalId">
+                <display-name xml:lang="x-default">External ID</display-name>
+                <type>string</type>
+                <mandatory-flag>false</mandatory-flag>
+                <externally-managed-flag>true</externally-managed-flag>
+                <max-length>100</max-length>
+            </attribute-definition>
+        </custom-attribute-definitions>
+        <group-definitions>
+            <attribute-group group-id="ExternalData">
+                <display-name xml:lang="x-default">External Data</display-name>
+                <attribute attribute-id="externalId"/>
+            </attribute-group>
+        </group-definitions>
+    </type-extension>
+</metadata>
+```
+
+### Add Enum Attribute to Order
+
+```xml
+<?xml version="1.0" encoding="UTF-8"?>
+<metadata xmlns="http://www.demandware.com/xml/impex/metadata/2006-10-31">
+    <type-extension type-id="Order">
+        <custom-attribute-definitions>
+            <attribute-definition attribute-id="fulfillmentStatus">
+                <display-name xml:lang="x-default">Fulfillment Status</display-name>
+                <type>enum-of-string</type>
+                <mandatory-flag>false</mandatory-flag>
+                <value-definitions>
+                    <value-definition default="true">
+                        <display xml:lang="x-default">Pending</display>
+                        <value>pending</value>
+                    </value-definition>
+                    <value-definition>
+                        <display xml:lang="x-default">Processing</display>
+                        <value>processing</value>
+                    </value-definition>
+                    <value-definition>
+                        <display xml:lang="x-default">Shipped</display>
+                        <value>shipped</value>
+                    </value-definition>
+                    <value-definition>
+                        <display xml:lang="x-default">Delivered</display>
+                        <value>delivered</value>
+                    </value-definition>
+                </value-definitions>
+            </attribute-definition>
+        </custom-attribute-definitions>
+        <group-definitions>
+            <attribute-group group-id="FulfillmentInfo">
+                <display-name xml:lang="x-default">Fulfillment Info</display-name>
+                <attribute attribute-id="fulfillmentStatus"/>
+            </attribute-group>
+        </group-definitions>
+    </type-extension>
+</metadata>
+```
+
+### Add Boolean Attribute to Customer Profile
+
+```xml
+<?xml version="1.0" encoding="UTF-8"?>
+<metadata xmlns="http://www.demandware.com/xml/impex/metadata/2006-10-31">
+    <type-extension type-id="Profile">
+        <custom-attribute-definitions>
+            <attribute-definition attribute-id="marketingOptIn">
+                <display-name xml:lang="x-default">Marketing Opt-In</display-name>
+                <type>boolean</type>
+                <mandatory-flag>false</mandatory-flag>
+                <default-value>false</default-value>
+            </attribute-definition>
+            <attribute-definition attribute-id="loyaltyMember">
+                <display-name xml:lang="x-default">Loyalty Member</display-name>
+                <type>boolean</type>
+                <mandatory-flag>false</mandatory-flag>
+                <default-value>false</default-value>
+            </attribute-definition>
+        </custom-attribute-definitions>
+    </type-extension>
+</metadata>
+```
+
+## Site Preferences
+
+### Boolean Preference
+
+```xml
+<?xml version="1.0" encoding="UTF-8"?>
+<metadata xmlns="http://www.demandware.com/xml/impex/metadata/2006-10-31">
+    <type-extension type-id="SitePreferences">
+        <custom-attribute-definitions>
+            <attribute-definition attribute-id="enableReviews">
+                <display-name xml:lang="x-default">Enable Product Reviews</display-name>
+                <type>boolean</type>
+                <default-value>true</default-value>
+            </attribute-definition>
+        </custom-attribute-definitions>
+    </type-extension>
+</metadata>
+```
+
+### String Preference (API Key)
+
+```xml
+<?xml version="1.0" encoding="UTF-8"?>
+<metadata xmlns="http://www.demandware.com/xml/impex/metadata/2006-10-31">
+    <type-extension type-id="SitePreferences">
+        <custom-attribute-definitions>
+            <attribute-definition attribute-id="analyticsApiKey">
+                <display-name xml:lang="x-default">Analytics API Key</display-name>
+                <type>password</type>
+            </attribute-definition>
+            <attribute-definition attribute-id="analyticsEndpoint">
+                <display-name xml:lang="x-default">Analytics Endpoint</display-name>
+                <type>string</type>
+            </attribute-definition>
+        </custom-attribute-definitions>
+        <group-definitions>
+            <attribute-group group-id="AnalyticsSettings">
+                <display-name xml:lang="x-default">Analytics Settings</display-name>
+                <attribute attribute-id="analyticsApiKey"/>
+                <attribute attribute-id="analyticsEndpoint"/>
+            </attribute-group>
+        </group-definitions>
+    </type-extension>
+</metadata>
+```
+
+### Preference Values
+
+**sites/RefArch/preferences.xml:**
+
+Preferences can be set per instance type:
+
+```xml
+<?xml version="1.0" encoding="UTF-8"?>
+<preferences xmlns="http://www.demandware.com/xml/impex/preferences/2007-03-31">
+    <custom-preferences>
+        <all-instances>
+            <preference preference-id="enableReviews">true</preference>
+        </all-instances>
+        <development>
+            <preference preference-id="analyticsEndpoint">https://dev-analytics.example.com/api</preference>
+        </development>
+        <production>
+            <preference preference-id="analyticsEndpoint">https://analytics.example.com/api</preference>
+        </production>
+    </custom-preferences>
+</preferences>
+```
+
+## Custom Object Types
+
+### Simple Custom Object
+
+```xml
+<?xml version="1.0" encoding="UTF-8"?>
+<metadata xmlns="http://www.demandware.com/xml/impex/metadata/2006-10-31">
+    <custom-type type-id="Banner">
+        <display-name xml:lang="x-default">Banner</display-name>
+        <staging-mode>source-to-target</staging-mode>
+        <storage-scope>site</storage-scope>
+        <key-definition attribute-id="bannerId">
+            <display-name xml:lang="x-default">Banner ID</display-name>
+            <type>string</type>
+            <min-length>1</min-length>
+        </key-definition>
+        <attribute-definitions>
+            <attribute-definition attribute-id="title">
+                <display-name xml:lang="x-default">Title</display-name>
+                <type>string</type>
+            </attribute-definition>
+            <attribute-definition attribute-id="imageUrl">
+                <display-name xml:lang="x-default">Image URL</display-name>
+                <type>string</type>
+            </attribute-definition>
+            <attribute-definition attribute-id="linkUrl">
+                <display-name xml:lang="x-default">Link URL</display-name>
+                <type>string</type>
+            </attribute-definition>
+            <attribute-definition attribute-id="startDate">
+                <display-name xml:lang="x-default">Start Date</display-name>
+                <type>datetime</type>
+            </attribute-definition>
+            <attribute-definition attribute-id="endDate">
+                <display-name xml:lang="x-default">End Date</display-name>
+                <type>datetime</type>
+            </attribute-definition>
+            <attribute-definition attribute-id="isActive">
+                <display-name xml:lang="x-default">Active</display-name>
+                <type>boolean</type>
+                <default-value>true</default-value>
+            </attribute-definition>
+        </attribute-definitions>
+    </custom-type>
+</metadata>
+```
+
+### Custom Object Data
+
+**customobjects/Banner.xml:**
+```xml
+<?xml version="1.0" encoding="UTF-8"?>
+<custom-objects xmlns="http://www.demandware.com/xml/impex/customobject/2006-10-31">
+    <custom-object type-id="Banner" object-id="homepage-hero">
+        <object-attribute attribute-id="title">Summer Sale</object-attribute>
+        <object-attribute attribute-id="imageUrl">/images/banners/summer-sale.jpg</object-attribute>
+        <object-attribute attribute-id="linkUrl">/sale</object-attribute>
+        <object-attribute attribute-id="startDate">2024-06-01T00:00:00.000Z</object-attribute>
+        <object-attribute attribute-id="endDate">2024-08-31T23:59:59.000Z</object-attribute>
+        <object-attribute attribute-id="isActive">true</object-attribute>
+    </custom-object>
+    <custom-object type-id="Banner" object-id="promo-banner">
+        <object-attribute attribute-id="title">Free Shipping</object-attribute>
+        <object-attribute attribute-id="imageUrl">/images/banners/free-shipping.jpg</object-attribute>
+        <object-attribute attribute-id="linkUrl">/shipping-info</object-attribute>
+        <object-attribute attribute-id="isActive">true</object-attribute>
+    </custom-object>
+</custom-objects>
+```
+
+## Content Assets
+
+**sites/RefArch/library/content/content.xml:**
+```xml
+<?xml version="1.0" encoding="UTF-8"?>
+<library xmlns="http://www.demandware.com/xml/impex/library/2006-10-31">
+    <content content-id="terms-conditions">
+        <display-name xml:lang="x-default">Terms and Conditions</display-name>
+        <online-flag>true</online-flag>
+        <searchable-flag>false</searchable-flag>
+        <custom-attributes>
+            <custom-attribute attribute-id="body" xml:lang="x-default">
+                <![CDATA[<h1>Terms and Conditions</h1><p>Content here...</p>]]>
+            </custom-attribute>
+        </custom-attributes>
+    </content>
+</library>
+```
+
+## Attribute Types Reference
+
+| Type | XML Value | Example |
+|------|-----------|---------|
+| `string` | `<type>string</type>` | Text up to 4000 chars |
+| `text` | `<type>text</type>` | Unlimited text |
+| `int` | `<type>int</type>` | Whole numbers |
+| `double` | `<type>double</type>` | Decimal numbers |
+| `boolean` | `<type>boolean</type>` | true/false |
+| `date` | `<type>date</type>` | Date only |
+| `datetime` | `<type>datetime</type>` | Date and time |
+| `email` | `<type>email</type>` | Email format |
+| `password` | `<type>password</type>` | Encrypted |
+| `html` | `<type>html</type>` | HTML content |
+| `image` | `<type>image</type>` | Image reference |
+| `enum-of-string` | `<type>enum-of-string</type>` | Single select |
+| `set-of-string` | `<type>set-of-string</type>` | Multi-select |
+
+## Complete Import Example
+
+Directory structure for adding a custom integration:
+
+```
+integration-import/
+├── meta/
+│   ├── system-objecttype-extensions.xml
+│   └── custom-objecttype-definitions.xml
+├── sites/
+│   └── RefArch/
+│       └── preferences.xml
+└── customobjects/
+    └── IntegrationConfig.xml
+```
+
+**meta/system-objecttype-extensions.xml:**
+```xml
+<?xml version="1.0" encoding="UTF-8"?>
+<metadata xmlns="http://www.demandware.com/xml/impex/metadata/2006-10-31">
+    <type-extension type-id="SitePreferences">
+        <custom-attribute-definitions>
+            <attribute-definition attribute-id="integrationEnabled">
+                <display-name xml:lang="x-default">Enable Integration</display-name>
+                <type>boolean</type>
+                <default-value>false</default-value>
+            </attribute-definition>
+        </custom-attribute-definitions>
+    </type-extension>
+    <type-extension type-id="Order">
+        <custom-attribute-definitions>
+            <attribute-definition attribute-id="integrationId">
+                <display-name xml:lang="x-default">Integration ID</display-name>
+                <type>string</type>
+                <externally-managed-flag>true</externally-managed-flag>
+            </attribute-definition>
+        </custom-attribute-definitions>
+    </type-extension>
+</metadata>
+```
+
+**meta/custom-objecttype-definitions.xml:**
+```xml
+<?xml version="1.0" encoding="UTF-8"?>
+<metadata xmlns="http://www.demandware.com/xml/impex/metadata/2006-10-31">
+    <custom-type type-id="IntegrationConfig">
+        <display-name xml:lang="x-default">Integration Configuration</display-name>
+        <staging-mode>source-to-target</staging-mode>
+        <storage-scope>organization</storage-scope>
+        <key-definition attribute-id="configKey">
+            <display-name xml:lang="x-default">Config Key</display-name>
+            <type>string</type>
+        </key-definition>
+        <attribute-definitions>
+            <attribute-definition attribute-id="endpoint">
+                <display-name xml:lang="x-default">Endpoint</display-name>
+                <type>string</type>
+            </attribute-definition>
+            <attribute-definition attribute-id="apiKey">
+                <display-name xml:lang="x-default">API Key</display-name>
+                <type>password</type>
+            </attribute-definition>
+        </attribute-definitions>
+    </custom-type>
+</metadata>
+```
+
+**sites/RefArch/preferences.xml:**
+```xml
+<?xml version="1.0" encoding="UTF-8"?>
+<preferences xmlns="http://www.demandware.com/xml/impex/preferences/2007-03-31">
+    <custom-preferences>
+        <all-instances>
+            <preference preference-id="integrationEnabled">true</preference>
+        </all-instances>
+    </custom-preferences>
+</preferences>
+```
+
+**customobjects/IntegrationConfig.xml:**
+```xml
+<?xml version="1.0" encoding="UTF-8"?>
+<custom-objects xmlns="http://www.demandware.com/xml/impex/customobject/2006-10-31">
+    <custom-object type-id="IntegrationConfig" object-id="production">
+        <object-attribute attribute-id="endpoint">https://api.integration.com/v1</object-attribute>
+    </custom-object>
+</custom-objects>
+```
+
+Import command:
+```bash
+b2c job import ./integration-import --wait --show-log
+```

package/content/guidance/b2c-cli/b2c-site-import-export/references/WORKFLOWS.md

@@ -0,0 +1,182 @@
+# Archive Workflows
+
+## Common Workflows
+
+### Adding a Custom Attribute to Products
+
+1. Create the metadata XML file:
+
+**meta/system-objecttype-extensions.xml:**
+
+```xml
+<?xml version="1.0" encoding="UTF-8"?>
+<metadata xmlns="http://www.demandware.com/xml/impex/metadata/2006-10-31">
+    <type-extension type-id="Product">
+        <custom-attribute-definitions>
+            <attribute-definition attribute-id="vendorSKU">
+                <display-name xml:lang="x-default">Vendor SKU</display-name>
+                <type>string</type>
+                <mandatory-flag>false</mandatory-flag>
+                <externally-managed-flag>true</externally-managed-flag>
+            </attribute-definition>
+        </custom-attribute-definitions>
+        <group-definitions>
+            <attribute-group group-id="CustomAttributes">
+                <display-name xml:lang="x-default">Custom Attributes</display-name>
+                <attribute attribute-id="vendorSKU"/>
+            </attribute-group>
+        </group-definitions>
+    </type-extension>
+</metadata>
+```
+
+2. Create the directory structure:
+
+```
+my-import/
+└── meta/
+    └── system-objecttype-extensions.xml
+```
+
+3. Import:
+
+```bash
+b2c job import ./my-import
+```
+
+### Adding Site Preferences
+
+1. Create metadata for the preference:
+
+**meta/system-objecttype-extensions.xml:**
+
+```xml
+<?xml version="1.0" encoding="UTF-8"?>
+<metadata xmlns="http://www.demandware.com/xml/impex/metadata/2006-10-31">
+    <type-extension type-id="SitePreferences">
+        <custom-attribute-definitions>
+            <attribute-definition attribute-id="enableFeatureX">
+                <display-name xml:lang="x-default">Enable Feature X</display-name>
+                <type>boolean</type>
+                <default-value>false</default-value>
+            </attribute-definition>
+        </custom-attribute-definitions>
+    </type-extension>
+</metadata>
+```
+
+2. Create preference values:
+
+**sites/MySite/preferences.xml:**
+
+```xml
+<?xml version="1.0" encoding="UTF-8"?>
+<preferences xmlns="http://www.demandware.com/xml/impex/preferences/2007-03-31">
+    <custom-preferences>
+        <all-instances>
+            <preference preference-id="enableFeatureX">true</preference>
+        </all-instances>
+    </custom-preferences>
+</preferences>
+```
+
+3. Directory structure:
+
+```
+my-import/
+├── meta/
+│   └── system-objecttype-extensions.xml
+└── sites/
+    └── MySite/
+        └── preferences.xml
+```
+
+4. Import:
+
+```bash
+b2c job import ./my-import
+```
+
+### Creating a Custom Object Type
+
+1. Define the custom object:
+
+**meta/custom-objecttype-definitions.xml:**
+
+```xml
+<?xml version="1.0" encoding="UTF-8"?>
+<metadata xmlns="http://www.demandware.com/xml/impex/metadata/2006-10-31">
+    <custom-type type-id="APIConfiguration">
+        <display-name xml:lang="x-default">API Configuration</display-name>
+        <staging-mode>source-to-target</staging-mode>
+        <storage-scope>site</storage-scope>
+        <key-definition attribute-id="configId">
+            <display-name xml:lang="x-default">Config ID</display-name>
+            <type>string</type>
+            <min-length>1</min-length>
+        </key-definition>
+        <attribute-definitions>
+            <attribute-definition attribute-id="endpoint">
+                <display-name xml:lang="x-default">API Endpoint</display-name>
+                <type>string</type>
+            </attribute-definition>
+            <attribute-definition attribute-id="apiKey">
+                <display-name xml:lang="x-default">API Key</display-name>
+                <type>password</type>
+            </attribute-definition>
+            <attribute-definition attribute-id="isActive">
+                <display-name xml:lang="x-default">Active</display-name>
+                <type>boolean</type>
+                <default-value>true</default-value>
+            </attribute-definition>
+        </attribute-definitions>
+    </custom-type>
+</metadata>
+```
+
+2. Import:
+
+```bash
+b2c job import ./my-import
+```
+
+### Importing Custom Object Data
+
+**customobjects/APIConfiguration.xml:**
+
+```xml
+<?xml version="1.0" encoding="UTF-8"?>
+<custom-objects xmlns="http://www.demandware.com/xml/impex/customobject/2006-10-31">
+    <custom-object type-id="APIConfiguration" object-id="payment-gateway">
+        <object-attribute attribute-id="endpoint">https://api.payment.com/v2</object-attribute>
+        <object-attribute attribute-id="isActive">true</object-attribute>
+    </custom-object>
+</custom-objects>
+```
+
+## Site Archive Structure
+
+```
+site-archive/
+├── services.xml                           # Service configurations (credentials, profiles, services)
+├── meta/
+│   ├── system-objecttype-extensions.xml   # Custom attributes on system objects
+│   └── custom-objecttype-definitions.xml  # Custom object type definitions
+├── sites/
+│   └── {SiteID}/
+│       ├── preferences.xml                # Site preference values
+│       └── library/
+│           └── content/
+│               └── content.xml            # Content assets
+├── catalogs/
+│   └── {CatalogID}/
+│       └── catalog.xml                    # Products and categories
+├── pricebooks/
+│   └── {PriceBookID}/
+│       └── pricebook.xml                  # Price definitions
+├── customobjects/
+│   └── {ObjectTypeID}.xml                 # Custom object instances
+└── inventory-lists/
+    └── {InventoryListID}/
+        └── inventory.xml                  # Inventory records
+```