Contentful CMA Helper Library

A utility library for the Contentful Management API 🔗, designed to help developers interact with the API in a more intuitive and streamlined way. This library provides functions for common tasks, such as retrieving and publishing entries, as well as tools for handling errors and logging.

Sponsored by Atida

✨ Features · 💡 Installation · 📟 Example · 🎹 Usage · 🔊 verbosityLevel · 📅 ToDo · 👾 Contributors · 🎩 Acknowledgments · 📚 Collection · 📄 License

✨ Features

• Easy-to-use functions for common tasks
• Compatible return types with CMA
• Customizable verbosity level for console logging
• Robust error handling and validation
• Async/await API for easy integration into async workflows

💡 Installation

To use this helper library, you must have NodeJS 🔗 and npm 🔗 installed.

To install it, simply run:

1npm install contentful-lib-helpers --save

Or, if using yarn 🔗:

1yarn add contentful-lib-helpers

Similarly, if you are using Bun 🔗, just run
bun add contentful-lib-helpers

Requirements

• node >= 18.20.0
• npm >= 10.5.0
• contentful-management >= 11.31.7

📟 Example

Here a simple example of writing a function that finds an entry by slug, add a tag and then republishes it.
We show both implementations: one using only the Contentful Management SDK and the other one, much shorter, using the Contentful Lib Helpers.

1(async function main () {
2    const contentfulManagement = require('contentful-management')
3    const lib = await import('contentful-lib-helpers')
4    const environment = await lib.getEnvironment(
5        contentfulManagement,
6        'your-access-token',
7        'your-space-id',
8        'master'
9    )
10
11    const entryId = await lib.getEntryIdByUniqueField(
12        environment,
13        'page',
14        'slug',
15        '/my-awesome-blog-post'
16    )
17
18    if (entryId) {
19        await lib.addEntryTag(environment, entryId, 'your-tag')
20        await lib.publishEntry(environment, entryId)
21    }
22})()

1(async function main () {
2    const contentfulManagement = require('contentful-management')
3    const client = await contentfulManagement.createClient({
4    accessToken: 'your-access-token',
5    })
6
7    try {
8        // Get the environment
9        const space = await client.getSpace('your-space-id')
10        const environment = await space.getEnvironment('master')
11
12        // Get the entry ID by unique field
13        const entry = await environment.getEntries({
14            content_type: 'page',
15            ['fields.slug']: '/my-awesome-blog-post',
16            limit: 1
17        })
18
19        const entryId = entry.items.length > 0 ? entry.items[0].sys.id : null
20
21        if (entryId) {
22            // Add tag to the entry
23            const tagName = 'country-it'
24            const entryWithTags = await environment.getEntry(entryId).then((entry) => {
25                entry.metadata = entry.metadata || { tags: [] }
26                if (!entry.metadata.tags.includes(tagName)) {
27                    entry.metadata.tags.push({
28                        sys: {
29                            type: 'Link',
30                            linkType: 'Tag',
31                            id: tagName
32                        }
33                    })
34                }
35                return entry
36            })
37            await entryWithTags.update()
38
39            // Publish the entry with tag
40            const publishedEntry = await environment.getEntry(entryId).then((entry) => {
41                entry.metadata = entry.metadata || {}
42                entry.metadata.tags = entry.metadata.tags || []
43                return entry.publish()
44            })
45
46            console.log(`Published entry with ID ${publishedEntry.sys.id} and tag ${tagName}`)
47        } else {
48            console.error(`Entry not found`)
49        }
50    } catch (error) {
51        console.error(`Error: ${error.message}`)
52    }
53})()

Note

Two alternative ways to include the Contentful library as ES Module are the following:

1// At the beginning of the file
2import contentfulManagement from 'contentful-management'
3
4// Inside a function
5const { default: contentfulManagement } = await import('contentful-management')
6
7// If you are using Bun.sh
8const contentfulManagement = await import('contentful-management')

See also: NodeJS modules import 🔗

🎹 Usage

Here are the methods available in this library and how to use them:

Space/Environment

• getSpace
• getEnvironment
• deleteEnvironment

Content-types/Entries

• getContentTypes
• getContentType
• getAllEntriesByContentType
• getEntryIdByUniqueField
• getEntry
• extractStatusFromSys
• publishEntry
• unpublishEntry

Tags

• getTagExists
• addEntryTag
• removeEntryTag

Locales

• getAllLocales
• getAllLocalesCode
• getDefaultLocale
• getDefaultLocaleCode
• getDefaultValuesForLocales

Release

• duplicateEnvironment
• enableCdaKey
• linkAliasToEnvironment
• syncScheduledActions

• getSpace

The function retrieves a Contentful space object by its ID, using the Contentful Management API.

Parameters

• contentfulManagement - The Contentful Management library.
• contentfulToken - The Contentful access token.
• contentfulSpaceId - The ID of the space to retrieve.
• verbosityLevel - (optional, default 1) the level of console logging verbosity to use. See verbosityLevel.

Return Value

The function returns a Promise that resolves with the Space object, or null if not found.

Example Usage

1import { getSpace } from 'contentful-lib-helpers'
2import contentfulManagement from 'contentful-management'
3const contentfulToken = 'your-access-token'
4const contentfulSpaceId = 'your-space-id'
5
6const space = await getSpace(
7    contentfulManagement, 
8    contentfulToken, 
9    contentfulSpaceId, 
10    2
11)

1{
2  name: 'Contentful Test Space',
3  sys: {
4    type: 'Space',
5    id: 'your-space-id',
6    version: 2,
7    createdBy: { sys: [Object] },
8    createdAt: '2023-03-31T10:41:25Z',
9    updatedBy: { sys: [Object] },
10    updatedAt: '2023-03-31T10:42:41Z',
11    organization: { sys: [Object] }
12  }
13}

• getEnvironment

The function retrieves a Contentful environment object by ID, using the Contentful Management API.

Parameters

• contentfulManagement - The Contentful Management library.
• contentfulToken - The Contentful access token.
• contentfulSpaceId - The ID of the space to retrieve.
• contentfulEnvironmentId - The ID of the environment to retrieve (default master).
• verbosityLevel - (optional, default 1) the level of console logging verbosity to use. See verbosityLevel.

Return Value

The function returns a Promise that resolves with the Environment object, or null if not found.

Example Usage

1import { getEnvironment } from 'contentful-lib-helpers'
2import contentfulManagement from 'contentful-management'
3const contentfulToken = 'your-access-token'
4const contentfulSpaceId = 'your-space-id'
5const contentfulEnvironmentId = 'your-environment-id'
6
7const environment = await getEnvironment(
8    contentfulManagement, 
9    contentfulToken, 
10    contentfulSpaceId,
11    contentfulEnvironmentId,
12    2
13)

1{
2  name: 'master',
3  sys: {
4    type: 'Environment',
5    id: 'master',
6    version: 3,
7    space: { sys: [Object] },
8    status: { sys: [Object] },
9    createdBy: { sys: [Object] },
10    createdAt: '2023-04-04T15:13:55Z',
11    updatedBy: { sys: [Object] },
12    updatedAt: '2023-04-04T15:13:56Z',
13    aliases: []
14  }
15}

• getContentTypes

The function retrieves get all Content-types in a Contentful environment.

Parameters

• environment - Environment Object (you can retrieve it with getEnvironment).
• verbosityLevel - (optional, default 1) the level of console logging verbosity to use. See verbosityLevel.

Return Value

The function returns a Promise that resolves with a Content-type collection if successful, or an empty Collection otherwise.

Note: the decision to return an empty collection, is because collections of any kind are usually looped trough. If we would be returning a null/false value, that would need to be verified before looping through the elements. With the empty collection, the items can be passed to the loop (that won't loop because empty).

Example Usage

1const allContentTypes = await getContentTypes(
2    environment, 
3    2
4)

1{
2  sys: { type: 'Array' },
3  total: 3,
4  skip: 0,
5  limit: 100,
6  items: [
7    {
8      sys: [Object],
9      displayField: 'key',
10      name: 'Translation',
11      description: '',
12      fields: [Array]
13    },
14    {
15      ...
16    },
17    {
18      ...
19    }
20  ]
21}

• getContentType

The function retrieves a Content-type object by its ID.

Parameters

• environment - Environment Object (you can retrieve it with getEnvironment).
• contentTypeId - The ID of the content-type to retrieve.
• verbosityLevel - (optional, default 1) the level of console logging verbosity to use. See verbosityLevel.

Return Value

The function returns a Promise that resolves with the content-type object if it exists, or null otherwise.

Example Usage

1const contentType = await getContentTypes(
2    environment, 
3    'translation',
4    2
5)

1{
2  sys: {
3    space: { sys: [Object] },
4    id: 'translation',
5    type: 'ContentType',
6    createdAt: '2023-03-31T11:12:04.950Z',
7    updatedAt: '2023-03-31T11:18:19.563Z',
8    environment: { sys: [Object] },
9    publishedVersion: 13,
10    publishedAt: '2023-03-31T11:18:19.563Z',
11    firstPublishedAt: '2023-03-31T11:12:05.422Z',
12    createdBy: { sys: [Object] },
13    updatedBy: { sys: [Object] },
14    publishedCounter: 7,
15    version: 14,
16    publishedBy: { sys: [Object] }
17  },
18  displayField: 'key',
19  name: 'Translation',
20  description: '',
21  fields: [
22    {
23      id: 'key',
24      name: 'key',
25      type: 'Symbol',
26      localized: false,
27      required: true,
28      validations: [Array],
29      disabled: false,
30      omitted: false
31    },
32    {
33      id: 'value',
34      name: 'value',
35      type: 'Symbol',
36      localized: true,
37      required: true,
38      validations: [],
39      disabled: false,
40      omitted: false
41    }
42  ]
43}

• getAllEntriesByContentType

It gets a Collection of all the Contentful Entries, by Content-type. The peculiarity of this method is that does the pagination (default 1000 elements) for you, and the returned collection contains all the entries.

Parameters

• environment - Environment Object (you can retrieve it with getEnvironment).
• contentTypeId - The ID of the content-type to retrieve.
• limit - Number of entries to retrieve at each loop. Default 1000.
• verbosityLevel - (optional, default 1) the level of console logging verbosity to use. See verbosityLevel.

Return Value

The function returns a Promise that resolves with a Collection of Contentful Entries, or an empty Collection otherwise.

Note: the decision to return an empty collection, is because collections of any kind are usually looped trough. If we returned a null/false value, that would need to be verified before looping through the elements. With the empty collection, the items can be passed to the loop (that won't loop because empty).

Example Usage

1const allEntries = await getAllEntriesByContentType(
2    environment, 
3    'translation',
4    1000,
5    2
6)

1{
2  sys: { type: 'Array' },
3  total: 5,
4  skip: 0,
5  limit: 5,
6  items: [
7    { metadata: [Object], sys: [Object], fields: [Object] },
8    { metadata: [Object], sys: [Object], fields: [Object] },
9    { metadata: [Object], sys: [Object], fields: [Object] },
10    { metadata: [Object], sys: [Object], fields: [Object] },
11    { metadata: [Object], sys: [Object], fields: [Object] }
12  ]
13}

• getEntryIdByUniqueField

Find an Entry in a specific Content Type and locale by its unique identifier field.

Parameters

• environment - Environment Object (you can retrieve it with getEnvironment).
• fieldId - The ID of the unique field to search for. A unique field is usually a mandatory and unique field in the Content-type (ie: slug).
• fieldValue - The value to search for in the unique field.
• fieldLocale - The locale to search in for the unique field. If not provided, the default locale will be used.
• verbosityLevel - (optional, default 1) the level of console logging verbosity to use. See verbosityLevel.

Return Value

A Promise that resolves to the Entry ID or null otherwise. We can then use getEntry to retrieve the Entry itself.

Example Usage

1const entryId = await getEntryIdByUniqueField(
2    environment,
3    'translation',
4    'key',
5    'test.entry'
6)

AKjzIrXfTQFS6oXjJp71Z

• getEntry

Get a Contentful entry by ID.

Parameters

• environment - Environment Object (you can retrieve it with getEnvironment).
• entryId - The ID of the entry to get.
• verbosityLevel - (optional, default 1) the level of console logging verbosity to use. See verbosityLevel.

Return Value

A Promise that resolves with the entry object, or null if not found.

Example Usage

1const entry = await getEntry(
2    environment,
3    'exampleEntryId',
4    2
5)

1{
2  metadata: { tags: [] },
3  sys: {
4    space: { sys: [Object] },
5    id: 'GKjzIfXfTQFS8oXjJp71Y',
6    type: 'Entry',
7    createdAt: '2023-04-04T15:11:47.018Z',
8    updatedAt: '2023-04-04T17:19:50.990Z',
9    environment: { sys: [Object] },
10    firstPublishedAt: '2023-04-04T17:19:25.915Z',
11    createdBy: { sys: [Object] },
12    updatedBy: { sys: [Object] },
13    publishedCounter: 2,
14    version: 9,
15    automationTags: [],
16    contentType: { sys: [Object] }
17  },
18  fields: { key: { 'en-US': 'test.entry' }, value: { 'en-US': 'Test' } }
19}

• extractStatusFromSys

The function extracts the status of a Contentful Entry from its sys properties.

Parameters

• entrySys - The sys properties of the Entry.

Return Value

It returns the status of an Entry: published, changed, draft and archived (in the unlikely possibility of an error, it would return unknown).

Example Usage

1const entry = await getEntry(
2    environment,
3    'exampleEntryId'
4)
5
6const entryStatus = await extractStatusFromSys(entry?.sys)

published

• publishEntry

Publishes a Contentful entry.

Parameters

• environment - Environment Object (you can retrieve it with getEnvironment).
• entryId - The ID of the entry to publish.
• verbosityLevel - (optional, default 1) the level of console logging verbosity to use. See verbosityLevel.

Return Value

A Promise that resolves with true if the entry was published successfully, or false otherwise.

Example Usage

1const isEntryPublished = await publishEntry(
2    environment,
3    'exampleEntryId',
4    2
5)

true

• unpublishEntry

Unpublishes a Contentful Entry.

Parameters

• environment - Environment Object (you can retrieve it with getEnvironment).
• entryId - The ID of the entry to unpublish.
• verbosityLevel - (optional, default 1) the level of console logging verbosity to use. See verbosityLevel.

Return Value

Promise that resolves with true if the entry was unpublished successfully, or false otherwise.

Example Usage

1const isEntryUnpublished = await unpublishEntry(
2    environment,
3    'exampleEntryId',
4    2
5)

true

• getTagExists

The function checks if a tag exists in a Contentful environment.

Parameters

• environment - Environment Object (you can retrieve it with getEnvironment).
• tagId - The ID of the tag to check.
• verbosityLevel - (optional, default 1) the level of console logging verbosity to use. See verbosityLevel.

Return Value

A Promise that resolves with true if the tag exists, or false otherwise.

Example Usage

1const tagExists = await getTagExists(
2    environment,
3    'country-en',
4    2
5)

true

• addEntryTag

Adds a tag to a Contentful Entry.

Parameters

• environment - Environment Object (you can retrieve it with getEnvironment).
• entryId - he ID of the entry to add the tag to.
• tagId - The ID of the tag to add.
• verbosityLevel - (optional, default 1) the level of console logging verbosity to use. See verbosityLevel.

Return Value

A Promise that resolves with true if the tag was added successfully, or false otherwise.

Note: the entry will need to be republished, after the tag is added. See publishEntry.

Example Usage

1const isTagAdded = await addEntryTag(
2    environment,
3    'exampleEntryId',
4    'exampleTagId',
5    2
6)

true

• removeEntryTag

Removes a tag to a Contentful Entry.

Parameters

• environment - Environment Object (you can retrieve it with getEnvironment).
• entryId - he ID of the entry to remove the tag from.
• tagId - The ID of the tag to remove.
• verbosityLevel - (optional, default 1) the level of console logging verbosity to use. See verbosityLevel.

Return Value

A Promise that resolves with true if the tag was removed successfully, or false otherwise.

Note: the entry will need to be republished, after the tag is removed. See publishEntry.

Example Usage

1const isTagRemoved = await addEntryTag(
2    environment,
3    'exampleEntryId',
4    'exampleTagId',
5    2
6)

true

• deleteEnvironment

The function deletes the given Contentful environment, unless it is protected.

Parameters

• environment - Environment Object (you can retrieve it with getEnvironment).
• verbosityLevel - (optional, default 1) the level of console logging verbosity to use. See verbosityLevel.
• forbiddenEnvironments - An array of environment IDs that are protected and cannot be deleted. Default protected environments: master, staging, uat, dev.

Note: the function has the verbosityLevel as second parameter, instead of the last one. This is to allow using the default value for forbiddenEnvironments, hence protecting the production and testing environments.

Return Value

The function returns true if the environment was successfully deleted, false otherwise.

Example Usage

1import { getEnvironment, deleteEnvironment } from 'contentful-lib-helpers'
2import contentfulManagement from 'contentful-management'
3const contentfulToken = 'your-access-token'
4const contentfulSpaceId = 'your-space-id'
5const contentfulEnvironmentId = 'environment-to-delete'
6
7const environment = await getEnvironment(
8    contentfulManagement,
9    contentfulToken,
10    contentfulSpaceId,
11    contentfulEnvironmentId,
12    2
13)
14
15const isEnvironmentDeleted = await deleteEnvironment(
16    environment,
17    2,
18    ['master', 'staging', 'dev']
19)

true

• getAllLocales

Get all locales for a given environment.

Parameters

• environment - Environment Object (you can retrieve it with getEnvironment).
• verbosityLevel - (optional, default 1) the level of console logging verbosity to use. See verbosityLevel.

Return Value

A Collection of Locale objects.

Example Usage

1const allLocales = await getAllLocales(
2    environment,
3    2
4)

1{
2  sys: { type: 'Array' },
3  total: 2,
4  skip: 0,
5  limit: 100,
6  items: [
7    {
8      name: 'English (United States)',
9      code: 'en-US',
10      fallbackCode: null,
11      default: true,
12      contentManagementApi: true,
13      contentDeliveryApi: true,
14      optional: false,
15      sys: [Object]
16    },
17    {
18      name: 'Italian (Italy)',
19      code: 'it-IT',
20      fallbackCode: 'en-US',
21      default: false,
22      contentManagementApi: true,
23      contentDeliveryApi: true,
24      optional: true,
25      sys: [Object]
26    }
27  ]
28}

• getAllLocalesCode

Get all the locale codes, as an array of strings (ie: ['en-US', 'it-IT'])

Parameters

• environment - Environment Object (you can retrieve it with getEnvironment).
• verbosityLevel - (optional, default 1) the level of console logging verbosity to use. See verbosityLevel.

Return Value

An array of locale codes.

Example Usage

1const allLocalesCode = await getAllLocalesCode(
2    environment,
3    2
4)

1[ 'en-US', 'it-IT' ]

• getDefaultLocale

The function returns the default Locale object.

Parameters

• environment - Environment Object (you can retrieve it with getEnvironment).
• verbosityLevel - (optional, default 1) the level of console logging verbosity to use. See verbosityLevel.

Return Value

The function returns the locale object of the default locale of the Contentful environment.

Example Usage

1const defaultLocale = await getDefaultLocale(
2    environment,
3    2
4)

1{
2    name: 'English (United States)',
3    code: 'en-US',
4    fallbackCode: null,
5    default: true,
6    contentManagementApi: true,
7    contentDeliveryApi: true,
8    optional: false,
9    sys: {
10        type: 'Locale',
11        id: '3XPgmbnnEyfxxtHVQlcfki',
12        version: 1,
13        space: { sys: [Object] },
14        environment: { sys: [Object] },
15        createdBy: { sys: [Object] },
16        createdAt: '2023-04-04T15:13:55Z',
17        updatedBy: { sys: [Object] },
18        updatedAt: '2023-04-04T15:13:55Z'
19    }
20}

• getDefaultLocaleCode

The function returns the default Locale code (ie: en-US).

Parameters

• environment - Environment Object (you can retrieve it with getEnvironment).
• verbosityLevel - (optional, default 1) the level of console logging verbosity to use. See verbosityLevel.

Return Value

The function returns default locale code, as a string.

Example Usage

1const defaultLocaleCode = await getDefaultLocaleCode(
2    environment,
3    2
4)

1en-US

• getDefaultValuseForLocales

This is a very particular function. Passing a 'default' value, that can be anything (null, boolean, string, etc), it returns an object whose keys are the locales, and the values are the default value passed.

This is used by our other NPM package Contentful CLI Migrations, to build locale-agnostic migrations. Meaning that the locales don't need to be hard-coded when setting up default values in a Contentful Javascript migration.

Parameters

• environment - Environment Object (you can retrieve it with getEnvironment).
• defaultValue - It can be a value of any type (usually null, empty string '' or a boolean value true/false)

Return Value

The function returns an object whose keys are the locales and the values are the default value passed.

Example Usage

1const objectDefaultValues = await getDefaultValuesForLocales(
2    environment,
3    true
4)

1{ 'en-US': true, 'it-IT': true }

• duplicateEnvironment

Given a source Environment id (ie: master), it creates a duplicated with a new Environment id. The duplication does not 'copy' the Scheduled Content, for which you will need to use the method syncScheduledActions.

Parameters

• space - Differently from other methods, it uses the Space Object (you can retrieve it with getSpace).
• sourceEnvironmentId - The source environment that will be duplicated (default: master).
• destinationEnvironmentId - The ID/Name of the new environment.
• verbosityLevel - (optional, default 1) the level of console logging verbosity to use. See verbosityLevel.

Return Value

The function returns an Environment object that can be queried or manipulated to perform further actions.

Example Usage

1const newEnvironment = await duplicateEnvironment(
2    space,
3    'master',
4    'release-1.25.5',
5    3
6)

1{
2  name: 'release-1.25.5',
3  sys: {
4    type: 'Environment',
5    id: 'release-1.25.5',
6    version: 1,
7    space: { sys: [Object] },
8    status: { sys: [Object] },
9    createdBy: { sys: [Object] },
10    createdAt: '2023-07-24T14:19:26Z',
11    updatedBy: { sys: [Object] },
12    updatedAt: '2023-07-24T14:19:26Z',
13    aliases: []
14  }
15}

• enableCdaKey

This function is needed when we want to enable an Environment for a particular CDA Key. For example a duplicate of the master Environment will need the same CDA Key that is used to query the current master.

Note: It's a good habit to name the CDA Key with the same name as the Environment. This because the API can query the Key only by name. So it is recommended to a be a lowercase name without punctuation or spaces.

Parameters

• space - Differently from other methods, it uses the Space Object (you can retrieve it with getSpace).
• cdaKeyName - The 'name' of the CDA Key. Usually should match an environment name. Recommended to use lowercase, no punctuation and no spaces.
• targetEnvironmentId - The Environment id for which the CDA Key will be enabled.
• verbosityLevel - (optional, default 1) the level of console logging verbosity to use. See verbosityLevel.

Return Value

true if the CDA Key has been enabled. false otherwise.

Example Usage

1const enabledCdaKey = await enableCdaKey(
2    space,
3    'master',
4    'release-1.25.5',
5    3
6)

1true

• linkAliasToEnvironment

Given an Environment id and and Alias, it links the Alias to that Environment. This function has to be used to switch, for example the current master alias to a new release Envirionment.

Parameters

• space - Differently from other methods, it uses the Space Object (you can retrieve it with getSpace).
• sourceEnvironmentId - The ID of the source Environment that will be linked.
• destinationEnvironmentId - The ID of the Alias to which the Environment will be linked to.
• releaseRegEx - Regular expression to identify release Environments.
• protectedEnvironments - Safety measure when deleting old release to not deleted important Environments.
• deleteOldReleases - If true, it deletes all release Environments, except the newly linked one and the previous one.
• verbosityLevel - (optional, default 1) the level of console logging verbosity to use. See verbosityLevel.

Return Value

The function does not return any value, but it does return a detailed error message in case of failure.

Example Usage

1await linkAliasToEnvironment(
2    space,
3    'release-1.25.5',
4    'master'
5)

• syncScheduledActions

When duplicating an Environment, the Scheduled Actions are not usually carried over. This function copies those Scheduled Actions between two environments.

Parameters

• space - Differently from other methods, it uses the Space Object (you can retrieve it with getSpace).
• sourceEnvironmentId - The source environment that contains the Scheduled Actions.
• destinationEnvironmentId - The destination environment to which those Actions will be copied to.
• verbosityLevel - (optional, default 1) the level of console logging verbosity to use. See verbosityLevel.

Return Value

The function does not return any value, but it does return a detailed error message in case of failure.

Example Usage

1 await syncScheduledActions(
2    space,
3    'master',
4    'release-1.25.5',
5    3
6)

🔊 verbosityLevel

All methods accept an optional verbosityLevel parameter. This parameter is an integer from 0 to 3 that determines the amount of console logging the function should output. A higher number means more logging. The default value is 1 (error logging)

• 0 - No logging.
• 1 - Only errors.
• 2 - Errors and debug information.
• 3 - All logs, including info logs.

📅 Todo

• Add further methods (ie: getAllAssets, uploadAsset, ...)
• Improve Logging (+ Colors).
• Add Tests
• Add Support for Yargs and Chalk

👾 Contributors

@fciacchi

@psyvic

@aalduz

@leslyto

Contributions

Feel free to open issues or pull requests in our GitHub Repository if you have suggestions or improvements to propose.

🎩 Acknowledgements

I would like to express my gratitude to the following parties:

• Atida 🔗, the company that has allowed these scripts to be open sourced. Atida is an e-commerce platform that sells beauty and medical products. Their support for open source is greatly appreciated. A special thank to Shaya Pourmirza that has been a great promoter and supporter of this initiative inside the company.
• Contentful 🔗, for creating their excellent content management platform and the JavaScript CMA SDK that this library is built on. Without their work, this project would not be possible.

Thank you to everyone involved!

📚 Other Scripts in the same collection

We produce a bunch of interesting packages for Contentful. You might want to check them out:

• Contentful Lib Helpers (GitHub and NpmJS): Utility Library for Contentful Management API.
• Contentful CLI Export (GitHub and NpmJS): Simplifies backup of your Contentful Environment.
• Contentful CLI Migrations (GitHub and NpmJS): Tool to automate and scale Contentful Migrations.
• Contentful CLI Release (GitHub and NpmJS): Release utilities to deploy Contentful in a CI/CD.

📄 License

This project is licensed under the MIT License