Cloudcraft Node.js Library

Visualize your cloud architecture with Cloudcraft by Datadog, the best way to create smart AWS and Azure diagrams.

Cloudcraft supports both manual and programmatic diagramming, as well as automatic reverse engineering of existing cloud environments into beautiful system architecture diagrams.

This cloudcraft Node library provides an easy-to-use native Node SDK for interacting with the Cloudcraft API.

Use case examples:

• Snapshot and visually compare your live AWS or Azure environment before and after a deployment, in your app or as part of your automated CI pipeline
• Download an inventory of all your cloud resources from a linked account as JSON
• Write a converter from a third party data format to Cloudcraft diagrams
• Backup, export & import your Cloudcraft data
• Programmatically create Cloudcraft diagrams

This SDK requires a Cloudcraft API key to use. A free trial of Cloudcraft Pro with API access is available.

Requirements

Node 22 or higher.

Installation

To install cloudcraft, run:

1npm install cloudcraft --save

Or, if you prefer yarn:

1yarn add cloudcraft

Usage

The API is accessed through the Cloudcraft class. An API key available through the Cloudcraft user interface is required when instantiating Cloudcraft. It can be passed to the class as an argument or through the CLOUDCRAFT_API_KEY environment variable:

1import { Cloudcraft } from 'Cloudcraft';
2
3const client = new Cloudcraft('api_key...');
4
5(async () => {
6    const user = await client.user.me();
7
8    console.log(user.name);
9})();

Configuration

Initialize with config object

The package can be initialized with several options:

1import { Cloudcraft } from 'Cloudcraft';
2
3const client = new Cloudcraft('api_key...', {
4    host: 'customhost',
5});

Option	Default	Description
maxNetworkRetries	10	The amount of times a request should be retried.
timeout	80_000	Maximum time each request can take in ms.
host	'api.cloudcraft.co'	Host that requests are made to.
port	443	Port that requests are made to.
protocol	'https'	'https' or 'http'.

Blueprints

List my blueprints

1const client = new Cloudcraft();
2
3const blueprints = await client.blueprint.list();

Retrieve blueprint

1const client = new Cloudcraft();
2
3const blueprint = await client.blueprint.get('id');

Create blueprint

1const client = new Cloudcraft();
2
3const blueprint = await client.blueprint.create({
4    data: {
5        grid: 'standard',
6        name: 'My new blueprint',
7    },
8});

Update blueprint

1const client = new Cloudcraft();
2
3const blueprint = await client.blueprint.get('id');
4blueprint.data.name = 'My updated blueprint';
5
6await client.blueprint.update(blueprint);

Export blueprint as image

1const client = new Cloudcraft();
2
3const blueprint = await client.blueprint.get('id');
4const svg = (await client.blueprint.export(
5  blueprint.id,
6  Cloudcraft.BlueprintFormat.SVG
7)) as string;

Delete blueprint

1const client = new Cloudcraft();
2
3const blueprint = await client.blueprint.get('id');
4await client.blueprint.delete(blueprint.id);

AWS Accounts

Add AWS account

1const client = new Cloudcraft();
2
3const awsAccount = await client.awsAccount.create(
4    {
5        name: 'Test account',
6        roleArn: 'arn:...',
7    },
8    'us-east-1',
9);

List my AWS accounts

1const client = new Cloudcraft();
2
3const awsAccounts = await client.awsAccount.list();

Snapshot AWS account

1const client = new Cloudcraft();
2
3const awsAccounts = await client.awsAccount.list();
4const awsAccount = awsAccounts.find(
5  (awsAccount) => awsAccount.id === 'id'
6) as any;
7const svg = (await client.awsAccount.snapshot(
8  awsAccount.id,
9  'us-east-1',
10  Cloudcraft.BlueprintFormat.SVG
11)) as string;

Update AWS account

1const client = new Cloudcraft();
2
3const awsAccounts = await client.awsAccount.list();
4const awsAccount = awsAccounts.find(
5  (awsAccount) => awsAccount.id === 'id'
6) as any;
7awsAccount.name = 'Updated account';
8
9const updatedAWSAccount = await client.awsAccount.update(awsAccount);

Delete AWS account

1const client = new Cloudcraft();
2
3const awsAccounts = await client.awsAccount.list();
4const awsAccount = awsAccounts.find(
5  (awsAccount) => awsAccount.id === 'id'
6) as any;
7await client.awsAccount.delete(awsAccount.id);

Get my AWS IAM Role parameters

1const client = new Cloudcraft();
2
3const iamParameters = await client.awsAccount.iamParameters();

Budgets

Export budget for a blueprint

1const client = new Cloudcraft();
2
3const blueprint = await client.blueprint.create(testBlueprint);
4
5const csv = (await client.budget.export(
6  blueprint.id,
7  Cloudcraft.BudgetFormat.CSV
8)) as string;

Users

Get my information

1const client = new Cloudcraft();
2
3const user = await client.user.me();

Contributing

Anyone can help make cloudcraft better. Check out the contribution guidelines for more information.

---

Released under the Apache-2.0 License.