Feature: Allow naming migration files via generate --name

cli.js

@@ -155,6 +155,7 @@ program
   .option('--host <host>', 'Management API host')
   .option('--config <path/to/config>', 'Config file path (disables auto detect)')
   .option('--cwd <directory>', 'Working directory. Defaults to process.cwd()')
+  .option('-n, --name <name>', 'Set a name for the migration')
   .description('Generate a new Contentful migration')
   .action(
     actionRunner(async (cmd) => {
@@ -164,7 +165,7 @@ program
         'environmentId',
         'directory',
       ]);
-      await createMigration(config);
+      await createMigration({ ...config, name: cmd.name });
     })
   );
 

lib/helpers/slugify.js

@@ -0,0 +1,11 @@
+const slugify = (text) =>
+  text
+    .toString()
+    .replace(/([a-z])([A-Z])/g, '$1-$2')
+    .toLowerCase()
+    .trim()
+    .replace(/[^a-z0-9]+/g, '-')
+    .replace(/^-/, '')
+    .replace(/-$/, '');
+
+module.exports = { slugify };

lib/helpers/slugify.test.js

@@ -0,0 +1,54 @@
+const { slugify } = require('./slugify');
+
+describe('slugify', () => {
+  it('converts spaces to hyphens and lowercases', () => {
+    expect(slugify('Add this new feature')).toBe('add-this-new-feature');
+  });
+
+  it('removes special characters', () => {
+    expect(slugify('Hello, World!')).toBe('hello-world');
+  });
+
+  it('trims leading and trailing whitespace', () => {
+    expect(slugify('  spaced  out  ')).toBe('spaced-out');
+  });
+
+  it('strips leading and trailing hyphens', () => {
+    expect(slugify('--hello--')).toBe('hello');
+  });
+
+  it('collapses consecutive special characters into a single hyphen', () => {
+    expect(slugify('foo---bar   baz')).toBe('foo-bar-baz');
+  });
+
+  it('returns empty string for whitespace-only input', () => {
+    expect(slugify('   ')).toBe('');
+  });
+
+  it('returns empty string for invalid string input', () => {
+    expect(slugify('')).toBe('');
+    expect(slugify('-')).toBe('');
+    expect(slugify('%/&((§/')).toBe('');
+  });
+
+  it('preserves numbers', () => {
+    expect(slugify('Version 2 update')).toBe('version-2-update');
+  });
+
+  it('handles colons and mixed punctuation', () => {
+    expect(slugify('Fix: content model!')).toBe('fix-content-model');
+  });
+
+  it('handles leading and trailing hyphens', () => {
+    expect(slugify('--hello--')).toBe('hello');
+  });
+
+  it('handles underscores', () => {
+    expect(slugify('_create_user')).toBe('create-user');
+  });
+
+  it('handles camel case', () => {
+    expect(slugify('pArticle')).toBe('p-article');
+    expect(slugify('Create pArticle ContentType')).toBe('create-p-article-content-type');
+  });
+});

lib/migration.js

@@ -13,6 +13,7 @@ const { getEnvironment, getOrganizationId } = require('./contentful');
 const { confirm, STATE_SUCCESS, STATE_FAILURE } = require('./config');
 
 const { storeMigration, getNewMigrations, getVersionFromFile } = require('./backend');
+const { slugify } = require('./helpers/slugify');
 
 const migrationHeader = stripIndent`/* eslint-env node */
   const { withHelpers } = require('@jungvonmatt/contentful-migrations');
@@ -40,11 +41,14 @@ const createMigration = async (config) => {
     console.log(err);
   }
 
-  const { directory } = config || {};
+  const { directory, name } = config || {};
   const timestamp = Date.now();
-  const filename = path.join(directory, `${timestamp}-migration.${module ? 'cjs' : 'js'}`);
+  const hasName = name && slugify(name);
+  const slug = hasName || 'migration';
+  const filename = path.join(directory, `${timestamp}-${slug}.${module ? 'cjs' : 'js'}`);
+  const comment = hasName ? `// ${name}` : '// Add your migration code here';
   const content = stripIndent`${migrationHeader}
-    // Add your migration code here
+    ${comment}
   })`;
 
   await fs.outputFile(filename, await format(filename, content, config));