---
editLink: false
lastUpdated: false
---

[@salesforce/b2c-tooling-sdk](../../modules.md) / [cli](../index.md) / CartridgeTransformer

# Interface: CartridgeTransformer

Defined in: [packages/b2c-tooling-sdk/src/cli/cartridge-providers.ts:85](https://github.com/SalesforceCommerceCloud/b2c-developer-tooling/blob/9c8c448223735b087738106fca3bc4c8e812ceb7/packages/b2c-tooling-sdk/src/cli/cartridge-providers.ts#L85)

Transformer interface for modifying cartridge mappings before deployment.

Transformers run after all providers have contributed cartridges and can
modify paths, rename cartridges, or filter the final list.

## Example

```typescript
const versioningTransformer: CartridgeTransformer = {
  name: 'versioning-transformer',
  async transform(cartridges, options) {
    // Append version suffix to cartridge names
    return cartridges.map(c => ({
      ...c,
      dest: `${c.name}_v2`,
    }));
  },
};
```

## Properties

### name

> `readonly` **name**: `string`

Defined in: [packages/b2c-tooling-sdk/src/cli/cartridge-providers.ts:87](https://github.com/SalesforceCommerceCloud/b2c-developer-tooling/blob/9c8c448223735b087738106fca3bc4c8e812ceb7/packages/b2c-tooling-sdk/src/cli/cartridge-providers.ts#L87)

Unique name for this transformer (used for logging)

## Methods

### transform()

> **transform**(`cartridges`, `options`): `Promise`\<[`CartridgeMapping`](../../operations/code/interfaces/CartridgeMapping.md)[]\>

Defined in: [packages/b2c-tooling-sdk/src/cli/cartridge-providers.ts:98](https://github.com/SalesforceCommerceCloud/b2c-developer-tooling/blob/9c8c448223735b087738106fca3bc4c8e812ceb7/packages/b2c-tooling-sdk/src/cli/cartridge-providers.ts#L98)

Transform cartridge mappings before deployment.

Can modify paths, names, or filter cartridges.

#### Parameters

##### cartridges

[`CartridgeMapping`](../../operations/code/interfaces/CartridgeMapping.md)[]

Current list of cartridge mappings

##### options

[`CartridgeDiscoveryOptions`](CartridgeDiscoveryOptions.md)

Discovery options for context

#### Returns

`Promise`\<[`CartridgeMapping`](../../operations/code/interfaces/CartridgeMapping.md)[]\>

Transformed array of cartridge mappings