# @gooddata/sdk-code-convertors

> GoodData AAC declarative converters

Latest version **11.64.0** (published 2026-10-22) · MIT license · 0 weekly downloads

## Install

```sh
npm install @gooddata/sdk-code-convertors
pnpm add @gooddata/sdk-code-convertors
yarn add @gooddata/sdk-code-convertors
bun add @gooddata/sdk-code-convertors
```

## Health

**Score 70/100 (B)** — status: active.

Positive: has types; esm support; no vulnerabilities; recently updated; high maintenance score; high quality score.

Warnings: low downloads.

## Facts

| | |
|---|---|
| Version | 11.64.0 |
| Published | 2026-10-22 |
| First published | 2026-03-27 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | bundled |
| Module format | ESM |
| Dependencies | 5 |
| Unpacked size | 1.1 MB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 73 |
| Author | GoodData |
| Maintainers | rodri360, ivan.mjartan, lupko, tomas.kratochvil, rodrigo.balsells, stanislavhacker, vojtasii, pbenes, gooddata-ci, nikolacech, petrjanu, hung.cao, xmort, bich.nguyen, no23reason, matyas.kandl, romanrakus, tu.bui, my.duong, hang.ngo, scavnickyj, thao-luong, thuong.nguyen, huyen.nguyen, nestor_encinas, tmuchka, gdjan, phong.nguyen, tuan.tran_gd, mkoldus, martin.milicka, pjiranek, martozar, david.zoufaly, agrebnevs-gd, vasek.zmrhal, hkad98, hoaimy, lukas.ther, ondrejvelisekgd, amilieta, andrenanninga-gooddata, pavelzrk, ilianchik, dusan-kovacik-profiq, khuongnguyen, matej.pavlik, jenny_gooddata, goodkuba, armhaj, bertold8, jyn.nguyen, mara3l, ondrej.maca, lukashlavacek, petr.veprek, jan.tychtl.gooddata, sommedamgd, guigooddata, peter-lorn, adampenaz, jakub.schenk, timurmuh, danieldoktor, jkbm, jmat_gd, ellavo, wendy.nguyen, milan.dufek, maitrieuphilong, jkbm_gd, zdenekornst, jiri.staroba, henry.nguyen.gooddata, adam.prchal, frankhuynh, macekond, martinnaj, peter.koza, sandrasus, pjar, jan.svager.gooddata, minh.ho.gooddata, maiphuong.bui, jakubz_good, pavelcerny, mvarhalik |

## Links

- npm: https://www.npmjs.com/package/@gooddata/sdk-code-convertors
- Repository: https://github.com/gooddata/gooddata-ui-sdk
- Homepage: https://github.com/gooddata/gooddata-ui-sdk#readme
- Issues: https://github.com/gooddata/gooddata-ui-sdk/issues
- npm.io page: https://npm.io/package/@gooddata/sdk-code-convertors

## Dependencies (5)

- [uuid](https://npm.io/package/uuid.md) 11.1.1
- [yaml](https://npm.io/package/yaml.md) 2.8.3
- [@gooddata/sdk-model](https://npm.io/package/@gooddata/sdk-model.md) 11.64.0
- [@gooddata/api-client-tiger](https://npm.io/package/@gooddata/api-client-tiger.md) 11.64.0
- [@gooddata/sdk-code-schemas](https://npm.io/package/@gooddata/sdk-code-schemas.md) 11.64.0

## Recent versions

- 11.64.0 (latest) — 2026-10-22
- 11.65.0-alpha.0 (prerelease) — 2026-10-22
- 11.64.0-alpha.6 — 2026-10-22
- 11.64.0-alpha.4 — 2026-10-21
- 11.64.0-alpha.3 — 2026-10-21
- 11.64.0-alpha.2 — 2026-10-21
- 11.64.0-alpha.1 — 2026-10-20
- 11.63.1 — 2026-10-19
- 11.64.0-alpha.0 — 2026-10-19
- 11.63.0 — 2026-10-19
- 11.63.0-alpha.5 — 2026-10-19
- 11.63.0-alpha.4 — 2026-10-19
- 11.63.0-alpha.3 — 2026-10-16
- 11.63.0-alpha.2 — 2026-10-15
- 11.63.0-alpha.1 — 2026-10-14
- … 253 more at https://npm.io/package/@gooddata/sdk-code-convertors/versions

## README

# @gooddata/sdk-code-convertors

GoodData Analytics as Code (AAC) declarative converters.

Converts between YAML-based AAC format and GoodData backend declarative API objects.

## Overview

This package provides bidirectional conversion for GoodData analytics objects:

- **YAML to Declarative** (AAC → API): `yamlVisualisationToDeclarative`, `yamlDashboardToDeclarative`, `yamlMetricToDeclarative`, `yamlDatasetToDeclarative`, etc.
- **Declarative to YAML** (API → AAC): `declarativeVisualisationToYaml`, `declarativeDashboardToYaml`, `declarativeMetricToYaml`, `declarativeDatasetToYaml`, etc.
- **Execution**: `buildAfmExecution` for building AFM execution requests from AAC format.
- **Schema types**: `v1` namespace with TypeScript types for the AAC YAML schema.

## Usage

```typescript
import { yamlMetricToDeclarative, declarativeMetricToYaml, v1 } from "@gooddata/sdk-code-convertors";

// AAC YAML object → Declarative API object
const metric: v1.Metric = {
    type: "metric",
    id: "revenue",
    title: "Revenue",
    maql: "SELECT {metric/order_amount}",
    format: "#,##0",
};
const declarative = yamlMetricToDeclarative(metric);

// Declarative API object → AAC YAML
const { content, json } = declarativeMetricToYaml(declarative);
```

## WASM

This package includes an isolated WASM build for use outside of Node.js (e.g., Python via wasmtime).
WASM is not part of the standard SDK build pipeline — it is built and tested separately via a dedicated CI workflow.

## License

MIT

---
_Source: https://npm.io/package/@gooddata/sdk-code-convertors · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._