storyblok 3.25.3 → 3.27.0

package/.github/.dependabot.yml

@@ -0,0 +1,13 @@
+# https://docs.github.com/github/administering-a-repository/configuration-options-for-dependency-updates
+# https://docs.github.com/en/code-security/dependabot/dependabot-version-updates/configuration-options-for-the-dependabot.yml-file
+
+version: 2
+updates:
+  - package-ecosystem: "npm"
+    directory: "/"
+    schedule:
+      interval: "monthly"
+    allow:
+      - dependency-name: "@storyblok/region-helper"
+    reviewers:
+      - "storyblok/plugins-team"

package/.github/workflows/release.yml

@@ -12,7 +12,7 @@ jobs:
       - uses: actions/checkout@v3
       - uses: actions/setup-node@v3
         with:
-          node-version: 18
+          node-version: 20.11
           cache: 'yarn'
       - name: Install dependencies
         run: yarn

package/README.md

@@ -44,7 +44,10 @@ $ storyblok login
 
 **For Both login options you nedd to pass the region**
 
-* `region`: region you would like to work in. Please keep in mind that the region must match the region of your space. You can use `us`, `cn` or `eu`, if left empty, default is `eu`. This region flag will be used for the other cli's commands. 
+* `region` (default: `eu`): the region you would like to work in. All the supported regions can be found [here](https://www.storyblok.com/faq/define-specific-region-storyblok-api).
+
+> [!NOTE]
+> Please keep in mind that the region must match the region of your space, and also that it will be used for all future commands you may perform.
 
 #### Login with token flag
 You can also add the token directly from the login’s command, like the example below:

package/__mocks__/axios.js

@@ -1,5 +1,4 @@
-const { LOGIN_URL, SIGNUP_URL } = require('../src/constants')
-const { EMAIL_TEST, PASSWORD_TEST, TOKEN_TEST } = require('../tests/constants')
+const { USERS_ROUTES, EMAIL_TEST, PASSWORD_TEST, TOKEN_TEST } = require('../tests/constants')
 
 const isCredCorrects = (email, pass) => {
   return email === EMAIL_TEST && pass === PASSWORD_TEST
@@ -9,7 +8,7 @@ const axios = {
   post: jest.fn((path, data) => {
     const { email, password } = data || {}
 
-    if (path === LOGIN_URL && isCredCorrects(email, password)) {
+    if (path === USERS_ROUTES.LOGIN && isCredCorrects(email, password)) {
       return Promise.resolve({
         data: {
           access_token: TOKEN_TEST
@@ -17,7 +16,7 @@ const axios = {
       })
     }
 
-    if (path === SIGNUP_URL && isCredCorrects(email, password)) {
+    if (path === USERS_ROUTES.SIGNUP && isCredCorrects(email, password)) {
       return Promise.resolve({
         data: {
           access_token: TOKEN_TEST

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "storyblok",
-  "version": "3.25.3",
+  "version": "3.27.0",
   "description": "A simple CLI to start Storyblok from your command line.",
   "repository": {
     "type": "git",
@@ -25,6 +25,7 @@
   "author": "Dominik Angerer <dominikangerer1@gmail.com>, Alexander Feiglstorfer <delooks@gmail.com>",
   "license": "MIT",
   "dependencies": {
+    "@storyblok/region-helper": "^1.0.0",
     "axios": "^0.27.2",
     "chalk": "^4.1.0",
     "clear": "0.1.0",

package/src/cli.js

@@ -7,6 +7,7 @@ const chalk = require('chalk')
 const clear = require('clear')
 const figlet = require('figlet')
 const inquirer = require('inquirer')
+const { ALL_REGIONS, EU_CODE, isRegion } = require('@storyblok/region-helper')
 
 const updateNotifier = require('update-notifier')
 const pkg = require('../package.json')
@@ -14,6 +15,7 @@ const pkg = require('../package.json')
 const tasks = require('./tasks')
 const { getQuestions, lastStep, api, creds } = require('./utils')
 const { SYNC_TYPES, COMMANDS } = require('./constants')
+const allRegionsText = ALL_REGIONS.join(', ')
 
 clear()
 console.log(chalk.cyan(figlet.textSync('storyblok')))
@@ -39,8 +41,8 @@ program
 program
   .command(COMMANDS.LOGIN)
   .description('Login to the Storyblok cli')
-  .option('-t, --token <token>', 'Token to login directly without questions, like for CI enviroments')
-  .option('-r, --region <region>', 'The region you would like to work in. Please keep in mind that the region must match the region of your space. You can use us, cn or eu, if left empty, default is eu. This region flag will be used for the other cli\'s commands')
+  .option('-t, --token <token>', 'Token to login directly without questions, like for CI environments')
+  .option('-r, --region <region>', `The region you would like to work in. Please keep in mind that the region must match the region of your space. This region flag will be used for the other cli's commands. You can use the values: ${allRegionsText}.`, EU_CODE)
   .action(async (options) => {
     const { token, region } = options
 
@@ -49,6 +51,11 @@ program
       return
     }
 
+    if (!isRegion(region)) {
+      console.log(chalk.red('X') + `The provided region ${region} is not valid. Please use one of the following: ${allRegionsText}`)
+      return
+    }
+
     try {
       await api.processLogin(token, region)
       process.exit(0)
@@ -492,29 +499,29 @@ program
     }
   })
 
-  // delete-datasources
+// delete-datasources
 program
-.command(COMMANDS.DELETE_DATASOURCES)
-.requiredOption('--space-id <SPACE_ID>', 'Space id')
-.option('--by-slug <SLUG>', 'Delete datasources by slug')
-.option('--by-name <name>', 'Delete datasources by name')
-.action(async (options) => {
-  console.log(`${chalk.blue('-')} Executing ${COMMANDS.DELETE_DATASOURCES} task`)
-
-  const { spaceId, bySlug, byName } = options
-
-  try {
-    if (!api.isAuthorized()) {
-      await api.processLogin()
-    }
+  .command(COMMANDS.DELETE_DATASOURCES)
+  .requiredOption('--space-id <SPACE_ID>', 'Space id')
+  .option('--by-slug <SLUG>', 'Delete datasources by slug')
+  .option('--by-name <name>', 'Delete datasources by name')
+  .action(async (options) => {
+    console.log(`${chalk.blue('-')} Executing ${COMMANDS.DELETE_DATASOURCES} task`)
 
-    api.setSpaceId(spaceId)
+    const { spaceId, bySlug, byName } = options
 
-    await tasks.deleteDatasources(api, { byName, bySlug })
-  } catch (e) {
-    errorHandler(e, COMMANDS.DELETE_DATASOURCES)
-  }
-})
+    try {
+      if (!api.isAuthorized()) {
+        await api.processLogin()
+      }
+
+      api.setSpaceId(spaceId)
+
+      await tasks.deleteDatasources(api, { byName, bySlug })
+    } catch (e) {
+      errorHandler(e, COMMANDS.DELETE_DATASOURCES)
+    }
+  })
 
 program.parse(process.argv)
 
@@ -524,7 +531,8 @@ if (program.rawArgs.length <= 2) {
 
 function errorHandler (e, command) {
   if (/404/.test(e.message)) {
-    console.log(chalk.yellow('/!\\') + ' If your space was created under US or CN region, you must provide the region us or cn upon login.')
+    const allRegionsButDefault = ALL_REGIONS.filter(region => region !== EU_CODE).join(' ,')
+    console.log(chalk.yellow('/!\\') + ` If your space was not created under ${EU_CODE} region, you must provide the region (${allRegionsButDefault}) upon login.`)
   } else {
     console.log(chalk.red('X') + ' An error occurred when executing the ' + command + ' task: ' + e || e.message)
   }

package/src/constants.js

@@ -1,16 +1,4 @@
-const API_URL = 'https://api.storyblok.com/v1/'
-const US_API_URL = 'https://api-us.storyblok.com/v1/'
-const CN_API_URL = 'https://app.storyblokchina.cn/v1/'
-const LOGIN_URL = `${API_URL}users/login`
-const SIGNUP_URL = `${API_URL}users/signup`
-
-const SYNC_TYPES = [
-  'folders',
-  'components',
-  'roles',
-  'stories',
-  'datasources'
-]
+const SYNC_TYPES = ['folders', 'components', 'roles', 'stories', 'datasources']
 
 const COMMANDS = {
   GENERATE_MIGRATION: 'generate-migration',
@@ -35,12 +23,7 @@ const DEFAULT_AGENT = {
 }
 
 module.exports = {
-  LOGIN_URL,
-  SIGNUP_URL,
-  API_URL,
   SYNC_TYPES,
-  US_API_URL,
-  CN_API_URL,
   COMMANDS,
   DEFAULT_AGENT
 }

package/src/tasks/delete-datasources.js

@@ -13,26 +13,25 @@ const deleteDatasources = async (api, options) => {
     let datasources = await api.getDatasources()
 
     if (bySlug) {
-      datasources = datasources.filter(datasource => datasource.slug.toLowerCase().startsWith(bySlug.toLowerCase()));
-      const filteredSlugs = datasources.map(obj => obj.slug);
-      const formattedSlugs = filteredSlugs.join(', ');
+      datasources = datasources.filter(datasource => datasource.slug.toLowerCase().startsWith(bySlug.toLowerCase()))
+      const filteredSlugs = datasources.map(obj => obj.slug)
+      const formattedSlugs = filteredSlugs.join(', ')
 
-      console.log(`${chalk.blue('-')} Datasources where slug starts with ${bySlug}: ${formattedSlugs}`);
+      console.log(`${chalk.blue('-')} Datasources where slug starts with ${bySlug}: ${formattedSlugs}`)
     }
 
     if (byName) {
-      datasources = datasources.filter(datasource => datasource.name.toLowerCase().startsWith(byName.toLowerCase()));
-      const filteredNames = datasources.map(obj => obj.name);
-      const formattedNames = filteredNames.join(', ');
+      datasources = datasources.filter(datasource => datasource.name.toLowerCase().startsWith(byName.toLowerCase()))
+      const filteredNames = datasources.map(obj => obj.name)
+      const formattedNames = filteredNames.join(', ')
 
-      console.log(`${chalk.blue('-')} Datasources where name starts with ${byName}: ${formattedNames}`);
+      console.log(`${chalk.blue('-')} Datasources where name starts with ${byName}: ${formattedNames}`)
     }
 
     for (const datasource of datasources) {
       console.log(`${chalk.blue('-')} Deleting ${datasource.name}`)
       await api.deleteDatasource(datasource.id)
     }
-
   } catch (e) {
     console.error(`${chalk.red('X')} An error ocurred in delete-components task when deleting a datasource`)
     return Promise.reject(new Error(e))

package/src/tasks/list-spaces.js

@@ -1,4 +1,5 @@
 const chalk = require('chalk')
+const { ALL_REGIONS, getRegionName, CN_CODE } = require('@storyblok/region-helper')
 /**
  * @method listSpaces
  * @param api - Pass the api instance as a parameter
@@ -6,11 +7,8 @@ const chalk = require('chalk')
  */
 
 const listSpaces = async (api, currentRegion) => {
-  const isChinaEnv = currentRegion === 'cn'
-  const regionOptions = {
-    eu: 'Europe',
-    us: 'United States'
-  }
+  const isChinaEnv = currentRegion === CN_CODE
+
   console.log()
   console.log(chalk.green('✓') + ' Loading spaces...')
 
@@ -36,7 +34,8 @@ const listSpaces = async (api, currentRegion) => {
     return spaces
   } else {
     const spacesList = []
-    for (const key in regionOptions) {
+    for (const key of ALL_REGIONS) {
+      if (key === CN_CODE) continue
       spacesList.push(await api.getAllSpacesByRegion(key)
         .then((res) => {
           return {
@@ -52,7 +51,7 @@ const listSpaces = async (api, currentRegion) => {
     }
     spacesList.forEach(region => {
       console.log()
-      console.log(`${chalk.blue(' -')} Spaces From ${regionOptions[region.key]} region:`)
+      console.log(`${chalk.blue(' -')} Spaces From ${getRegionName(region.key)} region:`)
       region.res.forEach((space) => {
         console.log(`    ${space.name} (id: ${space.id})`)
       })

package/src/tasks/sync-commands/components.js

@@ -73,10 +73,10 @@ class SyncComponents {
 
       if (this.componentsGroups && !this.componentsGroups.includes(sourceGroupUuid)) {
         console.log(
-          chalk.yellow("-") +
+          chalk.yellow('-') +
             ` Component ${component.name} does not belong to the ${this.componentsGroups} group(s).`
-        );
-        continue;
+        )
+        continue
       }
 
       // if the component belongs to a group
@@ -112,7 +112,7 @@ class SyncComponents {
           await this.presetsLib.createPresets(componentPresets, componentCreated.id)
         }
       } catch (e) {
-        if (e.response && e.response.status || e.status === 422) {
+        if ((e.response && e.response.status) || e.status === 422) {
           console.log(
             `${chalk.yellow('-')} Component ${component.name} already exists, updating it...`
           )
@@ -217,7 +217,10 @@ class SyncComponents {
     return Object.keys(sourceSchema).reduce((acc, key) => {
       // handle blocks separately
       const sourceSchemaItem = sourceSchema[key]
-      if (sourceSchemaItem?.type === 'bloks' || sourceSchemaItem?.type === 'richtext') {
+      const isBloksType = sourceSchemaItem && sourceSchemaItem.type === 'bloks'
+      const isRichtextType = sourceSchemaItem && sourceSchemaItem.type === 'richtext'
+
+      if (isBloksType || isRichtextType) {
         acc[key] = this.mergeBloksSchema(sourceSchemaItem)
         return acc
       }

package/src/utils/api.js

@@ -5,7 +5,9 @@ const inquirer = require('inquirer')
 
 const creds = require('./creds')
 const getQuestions = require('./get-questions')
-const { SIGNUP_URL, API_URL, US_API_URL, CN_API_URL, DEFAULT_AGENT } = require('../constants')
+const { DEFAULT_AGENT } = require('../constants')
+const { getRegionApiEndpoint } = require('./region')
+const { EU_CODE } = require('@storyblok/region-helper')
 
 module.exports = {
   accessToken: '',
@@ -39,7 +41,7 @@ module.exports = {
   },
 
   async login (content) {
-    const { email, password, region } = content
+    const { email, password, region = EU_CODE } = content
     try {
       const response = await axios.post(`${this.apiSwitcher(region)}users/login`, {
         email: email,
@@ -96,7 +98,7 @@ module.exports = {
     }
   },
 
-  persistCredentials (email, token = null, region = 'eu') {
+  persistCredentials (email, token = null, region = EU_CODE) {
     if (token) {
       this.oauthToken = token
       creds.set(email, token, region)
@@ -168,8 +170,8 @@ module.exports = {
     creds.set(null)
   },
 
-  signup (email, password, region = 'eu') {
-    return axios.post(SIGNUP_URL, {
+  signup (email, password, region = EU_CODE) {
+    return axios.post(`${this.apiSwitcher(region)}users/signup`, {
       email: email,
       password: password,
       region
@@ -255,7 +257,6 @@ module.exports = {
       .catch(err => Promise.reject(err))
   },
 
-
   post (path, props) {
     return this.sendRequest(path, 'post', props)
   },
@@ -310,12 +311,6 @@ module.exports = {
   },
 
   apiSwitcher (region) {
-    const apiList = {
-      us: US_API_URL,
-      cn: CN_API_URL,
-      eu: API_URL
-    }
-
-    return region ? apiList[region] : apiList[this.region]
+    return region ? getRegionApiEndpoint(region) : getRegionApiEndpoint(this.region)
   }
 }

package/src/utils/get-questions.js

@@ -1,3 +1,5 @@
+const { ALL_REGIONS, EU_CODE } = require('@storyblok/region-helper')
+
 const getOptions = (subCommand, argv = {}, api = {}) => {
   let email = ''
   const moreOptions = [
@@ -9,14 +11,14 @@ const getOptions = (subCommand, argv = {}, api = {}) => {
   const regionInput = {
     type: 'input',
     name: 'region',
-    message: 'Please enter the region you would like to work in (us, eu or cn) - if not set, default is eu:',
+    message: `Please enter the region you would like to work in (${ALL_REGIONS}):`,
+    default: EU_CODE,
     validate: function (value) {
-      const flagList = ['us', 'cn', 'eu']
-      if (flagList.indexOf(value) > -1) {
+      if (ALL_REGIONS.indexOf(value) > -1) {
         return true
       }
 
-      return 'Please enter a valid region: us, eu or cn'
+      return `Please enter a valid region: ${ALL_REGIONS}`
     }
   }
 

package/src/utils/index.js

@@ -6,5 +6,6 @@ module.exports = {
   capitalize: require('./capitalize'),
   findByProperty: require('./find-by-property'),
   parseError: require('./parse-error'),
+  region: require('./region'),
   saveFileFactory: require('./save-file-factory')
 }

package/src/utils/last-step.js

@@ -49,7 +49,7 @@ const lastStep = answers => {
     console.log(chalk.green('✓') + ' - The github repository ' + gitRepo + ' will be cloned now...')
 
     ghdownload(gitRepo, outputDir, async (err) => {
-      if(err) {
+      if (err) {
         if (err.code === 'ENOTEMPTY') {
           console.log(chalk.red('  Oh Snap! It seems that you already have a project with the name: ' + name))
           reject(new Error('This repository already has been cloned'))

package/src/utils/region.js

@@ -0,0 +1,7 @@
+const { getRegionBaseUrl } = require('@storyblok/region-helper')
+
+const getRegionApiEndpoint = (region) => `${getRegionBaseUrl(region)}/v1/`
+
+module.exports = {
+  getRegionApiEndpoint
+}

package/tests/constants.js

@@ -1,7 +1,9 @@
+const { getRegionApiEndpoint } = require('../src/utils/region')
+const { EU_CODE } = require('@storyblok/region-helper')
 const EMAIL_TEST = 'test@storyblok.com'
 const PASSWORD_TEST = 'test'
 const TOKEN_TEST = 'storyblok1234'
-const REGION_TEST = 'eu'
+const REGION_TEST = EU_CODE
 
 // use functions to always returns 'new' data
 const FAKE_COMPONENTS = () => [
@@ -289,9 +291,15 @@ const FAKE_PRESET = () => ({
   description: 'page preset'
 })
 
+const USERS_ROUTES = {
+  LOGIN: `${getRegionApiEndpoint(EU_CODE)}users/login`,
+  SIGNUP: `${getRegionApiEndpoint(EU_CODE)}users/signup`
+}
+
 module.exports = {
   EMAIL_TEST,
   TOKEN_TEST,
+  USERS_ROUTES,
   FAKE_STORIES,
   PASSWORD_TEST,
   FAKE_COMPONENTS,

package/tests/units/list-spaces.spec.js

@@ -1,11 +1,6 @@
 const { listSpaces } = require('../../src/tasks/')
 const { FAKE_SPACES } = require('../constants')
-
-const REGION_FLAGS = {
-  UNITED_STATES: 'us',
-  EUROPE: 'eu',
-  CHINA: 'cn'
-}
+const { EU_CODE, US_CODE, AP_CODE, CA_CODE, CN_CODE } = require('@storyblok/region-helper')
 
 describe('Test spaces method', () => {
   it('Testing list-spaces funtion without api instance', async () => {
@@ -22,28 +17,36 @@ describe('Test spaces method', () => {
       getAllSpacesByRegion: jest.fn(() => Promise.resolve(FAKE_SPACES()))
     }
     expect(
-      await listSpaces(FAKE_API, REGION_FLAGS.CHINA)
+      await listSpaces(FAKE_API, CN_CODE)
     ).toEqual(FAKE_SPACES())
     expect(FAKE_API.getAllSpacesByRegion).toHaveBeenCalled()
   })
 
-  it('Testing list-spaces funtion for Europe and United States regions', async () => {
+  it('Testing list-spaces funtion for all regions', async () => {
     const FAKE_API = {
       getAllSpacesByRegion: jest.fn(() => Promise.resolve(FAKE_SPACES()))
     }
     const response = [
       {
-        key: REGION_FLAGS.EUROPE,
+        key: EU_CODE,
+        res: [...FAKE_SPACES()]
+      },
+      {
+        key: US_CODE,
+        res: [...FAKE_SPACES()]
+      },
+      {
+        key: CA_CODE,
         res: [...FAKE_SPACES()]
       },
       {
-        key: REGION_FLAGS.UNITED_STATES,
+        key: AP_CODE,
         res: [...FAKE_SPACES()]
       }
     ]
 
     expect(
-      await listSpaces(FAKE_API, REGION_FLAGS.EUROPE)
+      await listSpaces(FAKE_API, EU_CODE)
     ).toEqual(response)
   })
 })

package/tests/units/push-components.spec.js

@@ -1,7 +1,8 @@
 const pushComponents = require('../../src/tasks/push-components')
 const Storyblok = require('storyblok-js-client')
 const api = require('../../src/utils/api')
-const { API_URL } = require('../../src/constants')
+const { getRegionApiEndpoint } = require('../../src/utils/region')
+const { EU_CODE } = require('@storyblok/region-helper')
 
 jest.mock('fs')
 jest.unmock('axios')
@@ -10,7 +11,7 @@ const deleteDocComponent = async () => {
   if (process.env.STORYBLOK_TOKEN) {
     const client = new Storyblok({
       oauthToken: process.env.STORYBLOK_TOKEN
-    }, API_URL)
+    }, getRegionApiEndpoint(EU_CODE))
 
     try {
       const path = `spaces/${process.env.STORYBLOK_SPACE}/components`

package/tests/units/quickstart.spec.js

@@ -4,7 +4,8 @@ const path = require('path')
 const quickstart = require('../../src/tasks/quickstart')
 const Storyblok = require('storyblok-js-client')
 const api = require('../../src/utils/api')
-const { API_URL } = require('../../src/constants')
+const { getRegionApiEndpoint } = require('../../src/utils/region')
+const { EU_CODE } = require('@storyblok/region-helper')
 
 jest.unmock('fs')
 jest.unmock('axios')
@@ -60,7 +61,7 @@ describe('testing quickstart()', () => {
 
       const client = new Storyblok({
         oauthToken: process.env.STORYBLOK_TOKEN
-      }, API_URL)
+      }, getRegionApiEndpoint(EU_CODE))
 
       const response = await client.get('spaces')
       const spaces = response.data.spaces

package/tests/units/scaffold.spec.js

@@ -3,7 +3,8 @@ const fs = require('fs')
 const scaffold = require('../../src/tasks/scaffold')
 const Storyblok = require('storyblok-js-client')
 const api = require('../../src/utils/api')
-const { API_URL } = require('../../src/constants')
+const { getRegionApiEndpoint } = require('../../src/utils/region')
+const { EU_CODE } = require('@storyblok/region-helper')
 
 jest.mock('fs')
 jest.unmock('axios')
@@ -12,7 +13,7 @@ const deleteTestComponent = async () => {
   if (process.env.STORYBLOK_TOKEN) {
     const client = new Storyblok({
       oauthToken: process.env.STORYBLOK_TOKEN
-    }, API_URL)
+    }, getRegionApiEndpoint(EU_CODE))
 
     try {
       const path = `spaces/${process.env.STORYBLOK_SPACE}/components`

package/tests/units/sync.spec.js

@@ -1,6 +1,7 @@
 const sync = require('../../src/tasks/sync')
 const Storyblok = require('storyblok-js-client')
-const { API_URL } = require('../../src/constants')
+const { getRegionApiEndpoint } = require('../../src/utils/region')
+const { EU_CODE } = require('@storyblok/region-helper')
 
 jest.unmock('axios')
 
@@ -32,7 +33,7 @@ describe('testing sync function', () => {
 
         const client = new Storyblok({
           oauthToken: process.env.STORYBLOK_TOKEN
-        }, API_URL)
+        }, getRegionApiEndpoint(EU_CODE))
 
         const sourceStories = await getData(
           client,