@squiz/dxp-cli-next 5.26.0-develop.2 → 5.26.0-develop.4

package/lib/migration/get/getMigration.js

@@ -36,6 +36,7 @@ const getMigrationCommand = () => {
             spinner.succeed(`Migration details: ${JSON.stringify(response, null, 2)}`);
         }
         catch (error) {
+            spinner.fail();
             (0, utils_1.handleCommandError)(getCommand, error);
         }
     }));

package/lib/migration/index.js

@@ -6,9 +6,13 @@ Object.defineProperty(exports, "__esModule", { value: true });
 const commander_1 = require("commander");
 const createMigration_1 = __importDefault(require("./create/createMigration"));
 const getMigration_1 = __importDefault(require("./get/getMigration"));
+const revert_1 = __importDefault(require("./revert/revert"));
+const setMigrationSettings_1 = __importDefault(require("./settings/setMigrationSettings"));
 const migrationCommand = new commander_1.Command('migration');
 migrationCommand
     .description('AI Page Migration Service Commands')
     .addCommand((0, createMigration_1.default)())
-    .addCommand((0, getMigration_1.default)());
+    .addCommand((0, getMigration_1.default)())
+    .addCommand((0, revert_1.default)())
+    .addCommand((0, setMigrationSettings_1.default)());
 exports.default = migrationCommand;

package/lib/migration/revert/revert.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+declare const revertMigrationCommand: () => Command;
+export default revertMigrationCommand;

package/lib/migration/revert/revert.js

@@ -0,0 +1,48 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const chalk_1 = __importDefault(require("chalk"));
+const commander_1 = require("commander");
+const utils_1 = require("../utils");
+const ora_1 = __importDefault(require("ora"));
+const revertMigrationCommand = () => {
+    const revertCommand = new commander_1.Command('revert')
+        .name('revert')
+        .description('Revert the current stage of a migration using the AI Page migration service')
+        .addOption(new commander_1.Option('--migration-id <string>', 'The ID of the migration to revert').makeOptionMandatory())
+        .addOption(new commander_1.Option('--asset-id <string>', 'The ID of the asset to revert the migration for'))
+        .addOption(new commander_1.Option('-t, --tenant <string>', 'Tenant ID to run against. If not provided will use configured tenant from login'))
+        .configureOutput({
+        outputError(str, write) {
+            write(chalk_1.default.red(str));
+        },
+    })
+        .action((options) => __awaiter(void 0, void 0, void 0, function* () {
+        const spinner = (0, ora_1.default)('Reverting...').start();
+        yield (0, utils_1.throwErrorIfNotLoggedIn)(revertCommand);
+        try {
+            const response = yield (0, utils_1.revertMigration)(options);
+            spinner.succeed(response.message);
+        }
+        catch (error) {
+            spinner.fail();
+            (0, utils_1.handleCommandError)(revertCommand, error);
+        }
+    }));
+    if (process.env.ENABLE_OVERRIDE_MIGRATION_URL === 'true') {
+        revertCommand.addOption(new commander_1.Option('-ou, --overrideUrl <string>', 'Developer option to override the entire migration url with a custom value'));
+    }
+    return revertCommand;
+};
+exports.default = revertMigrationCommand;

package/lib/migration/revert/revert.spec.d.ts

@@ -0,0 +1 @@
+export {};

package/lib/migration/revert/revert.spec.js

@@ -0,0 +1,150 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const revert_1 = __importDefault(require("./revert"));
+const utils = __importStar(require("../utils"));
+jest.mock('../utils');
+jest.mock('../../ApplicationStore');
+const mockUtils = utils;
+describe('revertMigrationCommand', () => {
+    beforeEach(() => {
+        jest.clearAllMocks();
+        jest.resetAllMocks();
+    });
+    describe('command configuration', () => {
+        it('should have correct command name and description', () => {
+            const program = (0, revert_1.default)();
+            expect(program.name()).toBe('revert');
+            expect(program.description()).toBe('Revert the current stage of a migration using the AI Page migration service');
+        });
+        it('should have required migration-id option', () => {
+            const program = (0, revert_1.default)();
+            const options = program.options;
+            const migrationIdOption = options.find((opt) => opt.long === '--migration-id');
+            expect(migrationIdOption).toBeDefined();
+            expect(migrationIdOption === null || migrationIdOption === void 0 ? void 0 : migrationIdOption.mandatory).toBe(true);
+        });
+        it('should have optional asset-id option', () => {
+            const program = (0, revert_1.default)();
+            const options = program.options;
+            const assetIdOption = options.find((opt) => opt.long === '--asset-id');
+            expect(assetIdOption).toBeDefined();
+            expect(assetIdOption === null || assetIdOption === void 0 ? void 0 : assetIdOption.mandatory).toBe(false);
+        });
+        it('should have optional tenant option', () => {
+            const program = (0, revert_1.default)();
+            const options = program.options;
+            const tenantOption = options.find((opt) => opt.long === '--tenant');
+            expect(tenantOption).toBeDefined();
+            expect(tenantOption === null || tenantOption === void 0 ? void 0 : tenantOption.mandatory).toBe(false);
+        });
+    });
+    describe('command execution', () => {
+        it('should revert migration successfully with required options', () => __awaiter(void 0, void 0, void 0, function* () {
+            const mockResponse = { message: 'Migration reverted successfully' };
+            mockUtils.revertMigration.mockResolvedValue(mockResponse);
+            mockUtils.throwErrorIfNotLoggedIn.mockResolvedValue();
+            const program = (0, revert_1.default)();
+            yield program.parseAsync([
+                'node',
+                'dxp-cli',
+                'migration',
+                'revert',
+                '--migration-id',
+                'migration-123',
+                '--asset-id',
+                'asset-456',
+            ]);
+            expect(mockUtils.throwErrorIfNotLoggedIn).toHaveBeenCalledWith(program);
+            expect(mockUtils.revertMigration).toHaveBeenCalledWith({
+                migrationId: 'migration-123',
+                assetId: 'asset-456',
+            });
+            expect(mockUtils.handleCommandError).not.toHaveBeenCalled();
+        }));
+        it('should revert migration with tenant option', () => __awaiter(void 0, void 0, void 0, function* () {
+            const mockResponse = { message: 'Migration reverted successfully' };
+            mockUtils.revertMigration.mockResolvedValue(mockResponse);
+            mockUtils.throwErrorIfNotLoggedIn.mockResolvedValue();
+            const program = (0, revert_1.default)();
+            yield program.parseAsync([
+                'node',
+                'dxp-cli',
+                'migration',
+                'revert',
+                '--migration-id',
+                'migration-123',
+                '--asset-id',
+                'asset-456',
+                '--tenant',
+                'test-tenant',
+            ]);
+            expect(mockUtils.revertMigration).toHaveBeenCalledWith({
+                migrationId: 'migration-123',
+                assetId: 'asset-456',
+                tenant: 'test-tenant',
+            });
+        }));
+        it('should handle revert migration error', () => __awaiter(void 0, void 0, void 0, function* () {
+            const error = new Error('Revert failed');
+            mockUtils.revertMigration.mockRejectedValue(error);
+            mockUtils.throwErrorIfNotLoggedIn.mockResolvedValue();
+            const program = (0, revert_1.default)();
+            yield program.parseAsync([
+                'node',
+                'dxp-cli',
+                'migration',
+                'revert',
+                '--migration-id',
+                'migration-123',
+                '--asset-id',
+                'asset-456',
+            ]);
+            expect(mockUtils.handleCommandError).toHaveBeenCalledWith(program, error);
+        }));
+        it('should include override URL option when environment variable is set', () => __awaiter(void 0, void 0, void 0, function* () {
+            const originalEnv = process.env.ENABLE_OVERRIDE_MIGRATION_URL;
+            process.env.ENABLE_OVERRIDE_MIGRATION_URL = 'true';
+            const program = (0, revert_1.default)();
+            const options = program.options;
+            const overrideUrlOption = options.find((opt) => opt.long === '--overrideUrl');
+            expect(overrideUrlOption).toBeDefined();
+            expect(overrideUrlOption === null || overrideUrlOption === void 0 ? void 0 : overrideUrlOption.mandatory).toBe(false);
+            process.env.ENABLE_OVERRIDE_MIGRATION_URL = originalEnv;
+        }));
+    });
+});

package/lib/migration/settings/setMigrationSettings.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+declare const setMigrationSettingsCommand: () => Command;
+export default setMigrationSettingsCommand;

package/lib/migration/settings/setMigrationSettings.js

@@ -0,0 +1,49 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const chalk_1 = __importDefault(require("chalk"));
+const commander_1 = require("commander");
+const utils_1 = require("../utils");
+const ora_1 = __importDefault(require("ora"));
+const setMigrationSettingsCommand = () => {
+    const settingsCommand = new commander_1.Command('settings')
+        .name('settings')
+        .description('Set settings for the migration service')
+        .addOption(new commander_1.Option('--matrix-url <string>', 'The URL of the Matrix instance').makeOptionMandatory())
+        .addOption(new commander_1.Option('--matrix-identifier <string>', 'The component service identifier used by the asset and components being migrated').makeOptionMandatory())
+        .addOption(new commander_1.Option('--matrix-key <string>', 'The Asset Management API key for the Migrator API to interact with Matrix API').makeOptionMandatory())
+        .addOption(new commander_1.Option('-t, --tenant <string>', 'Tenant ID to run against. If not provided will use configured tenant from login'))
+        .configureOutput({
+        outputError(str, write) {
+            write(chalk_1.default.red(str));
+        },
+    })
+        .action((options) => __awaiter(void 0, void 0, void 0, function* () {
+        const spinner = (0, ora_1.default)('Setting migration configuration...').start();
+        yield (0, utils_1.throwErrorIfNotLoggedIn)(settingsCommand);
+        try {
+            const response = yield (0, utils_1.setMigrationSetting)(options);
+            spinner.succeed(`Migration settings updated: ${JSON.stringify(response, null, 2)}`);
+        }
+        catch (error) {
+            spinner.fail();
+            (0, utils_1.handleCommandError)(settingsCommand, error);
+        }
+    }));
+    if (process.env.ENABLE_OVERRIDE_MIGRATION_URL === 'true') {
+        settingsCommand.addOption(new commander_1.Option('-ou, --overrideUrl <string>', 'Developer option to override the entire migration url with a custom value'));
+    }
+    return settingsCommand;
+};
+exports.default = setMigrationSettingsCommand;

package/lib/migration/settings/setMigrationSettings.spec.d.ts

@@ -0,0 +1 @@
+export {};

package/lib/migration/settings/setMigrationSettings.spec.js

@@ -0,0 +1,275 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const nock_1 = __importDefault(require("nock"));
+const setMigrationSettings_1 = __importDefault(require("./setMigrationSettings"));
+const utils = __importStar(require("../utils"));
+const ApplicationStore = __importStar(require("../../ApplicationStore"));
+jest.mock('../utils');
+jest.mock('../../ApplicationStore');
+const mockUtils = utils;
+const mockApplicationStore = ApplicationStore;
+describe('setMigrationSettingsCommand', () => {
+    let logSpy;
+    let mockSetMigrationSettingResponse;
+    beforeEach(() => {
+        nock_1.default.cleanAll();
+        jest.clearAllMocks();
+        jest.resetAllMocks();
+        logSpy = jest.spyOn(console, 'log').mockImplementation(() => { });
+        mockApplicationStore.getApplicationFile.mockResolvedValue('session-cookie');
+        mockUtils.throwErrorIfNotLoggedIn.mockResolvedValue(undefined);
+        mockSetMigrationSettingResponse = {
+            matrixUrl: 'https://matrix.example.com',
+            matrixIdentifier: '@user:matrix.example.com',
+            matrixKey: '***********123',
+        };
+        mockUtils.setMigrationSetting.mockResolvedValue(mockSetMigrationSettingResponse);
+    });
+    afterEach(() => {
+        logSpy.mockRestore();
+    });
+    describe('successful migration setting update', () => {
+        it('should set migration settings successfully with required options', () => __awaiter(void 0, void 0, void 0, function* () {
+            const program = (0, setMigrationSettings_1.default)();
+            yield program.parseAsync([
+                'node',
+                'dxp-cli',
+                'migration',
+                'settings',
+                '--matrix-url',
+                'https://matrix.example.com',
+                '--matrix-identifier',
+                '@user:matrix.example.com',
+                '--matrix-key',
+                'secret-key-123',
+            ]);
+            expect(mockUtils.throwErrorIfNotLoggedIn).toHaveBeenCalledWith(program);
+            expect(mockUtils.setMigrationSetting).toHaveBeenCalledWith({
+                matrixUrl: 'https://matrix.example.com',
+                matrixIdentifier: '@user:matrix.example.com',
+                matrixKey: 'secret-key-123',
+            });
+            expect(mockUtils.setMigrationSetting).toHaveBeenCalledTimes(1);
+            expect(mockUtils.handleCommandError).not.toHaveBeenCalled();
+        }));
+        it('should set migration settings with tenant option', () => __awaiter(void 0, void 0, void 0, function* () {
+            const program = (0, setMigrationSettings_1.default)();
+            yield program.parseAsync([
+                'node',
+                'dxp-cli',
+                'migration',
+                'settings',
+                '--matrix-url',
+                'https://matrix.example.com',
+                '--matrix-identifier',
+                '@user:matrix.example.com',
+                '--matrix-key',
+                'secret-key-123',
+                '--tenant',
+                'test-tenant',
+            ]);
+            expect(mockUtils.setMigrationSetting).toHaveBeenCalledWith({
+                matrixUrl: 'https://matrix.example.com',
+                matrixIdentifier: '@user:matrix.example.com',
+                matrixKey: 'secret-key-123',
+                tenant: 'test-tenant',
+            });
+        }));
+        it('should set migration settings with override URL when environment variable is set', () => __awaiter(void 0, void 0, void 0, function* () {
+            const originalEnv = process.env.ENABLE_OVERRIDE_MIGRATION_URL;
+            process.env.ENABLE_OVERRIDE_MIGRATION_URL = 'true';
+            const program = (0, setMigrationSettings_1.default)();
+            yield program.parseAsync([
+                'node',
+                'dxp-cli',
+                'migration',
+                'settings',
+                '--matrix-url',
+                'https://matrix.example.com',
+                '--matrix-identifier',
+                '@user:matrix.example.com',
+                '--matrix-key',
+                'secret-key-123',
+                '--overrideUrl',
+                'https://custom.migration.url',
+            ]);
+            expect(mockUtils.setMigrationSetting).toHaveBeenCalledWith({
+                matrixUrl: 'https://matrix.example.com',
+                matrixIdentifier: '@user:matrix.example.com',
+                matrixKey: 'secret-key-123',
+                overrideUrl: 'https://custom.migration.url',
+            });
+            process.env.ENABLE_OVERRIDE_MIGRATION_URL = originalEnv;
+        }));
+    });
+    describe('error scenarios', () => {
+        it('should handle setMigrationSetting API error', () => __awaiter(void 0, void 0, void 0, function* () {
+            const apiError = new Error('Settings update failed');
+            mockUtils.setMigrationSetting.mockRejectedValue(apiError);
+            mockUtils.handleCommandError.mockImplementation(() => { });
+            const program = (0, setMigrationSettings_1.default)();
+            yield program.parseAsync([
+                'node',
+                'dxp-cli',
+                'migration',
+                'settings',
+                '--matrix-url',
+                'https://matrix.example.com',
+                '--matrix-identifier',
+                '@user:matrix.example.com',
+                '--matrix-key',
+                'secret-key-123',
+            ]);
+            expect(mockUtils.handleCommandError).toHaveBeenCalledWith(program, apiError);
+        }));
+        it('should handle network error', () => __awaiter(void 0, void 0, void 0, function* () {
+            const networkError = new Error('Network connection failed');
+            mockUtils.setMigrationSetting.mockRejectedValue(networkError);
+            mockUtils.handleCommandError.mockImplementation(() => { });
+            const program = (0, setMigrationSettings_1.default)();
+            yield program.parseAsync([
+                'node',
+                'dxp-cli',
+                'migration',
+                'settings',
+                '--matrix-url',
+                'https://matrix.example.com',
+                '--matrix-identifier',
+                '@user:matrix.example.com',
+                '--matrix-key',
+                'secret-key-123',
+            ]);
+            expect(mockUtils.handleCommandError).toHaveBeenCalledWith(program, networkError);
+        }));
+    });
+    describe('required options validation', () => {
+        it('should require matrixUrl option', () => {
+            const program = (0, setMigrationSettings_1.default)().exitOverride();
+            expect(() => {
+                program.parse([
+                    'node',
+                    'dxp-cli',
+                    'migration',
+                    'settings',
+                    '--matrix-identifier',
+                    '@user:matrix.example.com',
+                    '--matrix-key',
+                    'secret-key-123',
+                ]);
+            }).toThrow();
+        });
+        it('should require matrixIdentifier option', () => {
+            const program = (0, setMigrationSettings_1.default)().exitOverride();
+            expect(() => {
+                program.parse([
+                    'node',
+                    'dxp-cli',
+                    'migration',
+                    'settings',
+                    '--matrix-url',
+                    'https://matrix.example.com',
+                    '--matrix-key',
+                    'secret-key-123',
+                ]);
+            }).toThrow();
+        });
+        it('should require matrixKey option', () => {
+            const program = (0, setMigrationSettings_1.default)().exitOverride();
+            expect(() => {
+                program.parse([
+                    'node',
+                    'dxp-cli',
+                    'migration',
+                    'settings',
+                    '--matrix-url',
+                    'https://matrix.example.com',
+                    '--matrix-identifier',
+                    '@user:matrix.example.com',
+                ]);
+            }).toThrow();
+        });
+    });
+    describe('command configuration', () => {
+        it('should have correct command name and description', () => {
+            const program = (0, setMigrationSettings_1.default)();
+            expect(program.name()).toBe('settings');
+            expect(program.description()).toBe('Set settings for the migration service');
+        });
+        it('should parse options correctly', () => {
+            const program = (0, setMigrationSettings_1.default)();
+            program.parse([
+                'node',
+                'dxp-cli',
+                'migration',
+                'settings',
+                '--matrix-url',
+                'https://matrix.example.com',
+                '--matrix-identifier',
+                '@user:matrix.example.com',
+                '--matrix-key',
+                'secret-key-123',
+                '--tenant',
+                'test-tenant',
+            ]);
+            const opts = program.opts();
+            expect(opts.matrixUrl).toBe('https://matrix.example.com');
+            expect(opts.matrixIdentifier).toBe('@user:matrix.example.com');
+            expect(opts.matrixKey).toBe('secret-key-123');
+            expect(opts.tenant).toBe('test-tenant');
+        });
+        it('should parse options with kebab-case to camelCase conversion', () => {
+            const program = (0, setMigrationSettings_1.default)();
+            program.parse([
+                'node',
+                'dxp-cli',
+                'migration',
+                'settings',
+                '--matrix-url',
+                'https://matrix.example.com',
+                '--matrix-identifier',
+                '@user:matrix.example.com',
+                '--matrix-key',
+                'secret-key-123',
+            ]);
+            const opts = program.opts();
+            expect(opts.matrixUrl).toBe('https://matrix.example.com');
+            expect(opts.matrixIdentifier).toBe('@user:matrix.example.com');
+            expect(opts.matrixKey).toBe('secret-key-123');
+        });
+    });
+});

package/lib/migration/types.d.ts

@@ -35,3 +35,20 @@ export interface GetMigrationAPIResponse {
     previewPageAssetId?: string;
     componentsTarDownloadUrl?: string;
 }
+export interface RevertMigrationOptions extends GetMigrationOptions {
+}
+export interface RevertMigrationAPIResponse {
+    message: string;
+}
+export interface SetMigrationSettingOptions {
+    matrixUrl: string;
+    matrixIdentifier: string;
+    matrixKey: string;
+    tenant?: string;
+    overrideUrl?: string;
+}
+export interface SetMigrationSettingAPIResponse {
+    matrixUrl: string;
+    matrixIdentifier: string;
+    matrixKey: string;
+}

package/lib/migration/utils.d.ts

@@ -1,12 +1,15 @@
 import { Command } from 'commander';
-import { CreateMigrationOptions, CreateMigrationAPIResponse, GetMigrationOptions, GetMigrationAPIResponse } from './types';
+import { CreateMigrationOptions, CreateMigrationAPIResponse, GetMigrationOptions, GetMigrationAPIResponse, RevertMigrationOptions, RevertMigrationAPIResponse, SetMigrationSettingOptions, SetMigrationSettingAPIResponse } from './types';
 export declare function handleCommandError(command: Command, error: Error): void;
 export declare function throwErrorIfNotLoggedIn(command: Command): Promise<void>;
 export declare function buildMigrationUrl(tenantID?: string, overrideUrl?: string): Promise<string>;
 export declare function validateAxiosStatus(status: number): boolean;
+export declare function redactKey(key: string, visibleChars?: number): string;
 export declare function validateExportFolder(exportPath: string): void;
 export declare function createTarFile(exportPath: string): Promise<string>;
 export declare function getMigrationHeaders(tenantID?: string): Promise<Record<string, string>>;
 export declare function uploadFileToS3(uploadUrl: string, filePath: string, tenantID?: string): Promise<string>;
 export declare function createMigration(options: CreateMigrationOptions): Promise<CreateMigrationAPIResponse>;
 export declare function getMigration(options: GetMigrationOptions): Promise<GetMigrationAPIResponse>;
+export declare function revertMigration(options: RevertMigrationOptions): Promise<RevertMigrationAPIResponse>;
+export declare function setMigrationSetting(options: SetMigrationSettingOptions): Promise<SetMigrationSettingAPIResponse>;

package/lib/migration/utils.js

@@ -12,7 +12,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getMigration = exports.createMigration = exports.uploadFileToS3 = exports.getMigrationHeaders = exports.createTarFile = exports.validateExportFolder = exports.validateAxiosStatus = exports.buildMigrationUrl = exports.throwErrorIfNotLoggedIn = exports.handleCommandError = void 0;
+exports.setMigrationSetting = exports.revertMigration = exports.getMigration = exports.createMigration = exports.uploadFileToS3 = exports.getMigrationHeaders = exports.createTarFile = exports.validateExportFolder = exports.redactKey = exports.validateAxiosStatus = exports.buildMigrationUrl = exports.throwErrorIfNotLoggedIn = exports.handleCommandError = void 0;
 const fs_1 = __importDefault(require("fs"));
 const path_1 = __importDefault(require("path"));
 const chalk_1 = __importDefault(require("chalk"));
@@ -70,6 +70,16 @@ function validateAxiosStatus(status) {
     return status < 400;
 }
 exports.validateAxiosStatus = validateAxiosStatus;
+function redactKey(key, visibleChars = 3) {
+    if (!key)
+        return '';
+    const len = key.length;
+    if (len <= visibleChars)
+        return '*'.repeat(len);
+    const masked = '*'.repeat(len - visibleChars);
+    return masked + key.slice(-visibleChars);
+}
+exports.redactKey = redactKey;
 function validateExportFolder(exportPath) {
     // Check if the export folder exists
     if (!fs_1.default.existsSync(exportPath)) {
@@ -223,3 +233,66 @@ function getMigration(options) {
     });
 }
 exports.getMigration = getMigration;
+function revertMigration(options) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const apiService = new ApiService_1.ApiService({
+            validateStatus: validateAxiosStatus,
+        });
+        const migrationUrl = yield buildMigrationUrl(options.tenant, options.overrideUrl);
+        try {
+            const response = yield apiService.client.post(`${migrationUrl}/migrations/${options.migrationId}/assets/${options.assetId}/rollback`, {}, {
+                headers: Object.assign({ 'Content-Type': 'application/json' }, (yield getMigrationHeaders(options.tenant))),
+            });
+            if (response.status !== 200) {
+                throw new Error(`Failed to revert migration: ${response.status}`);
+            }
+            return response.data;
+        }
+        catch (error) {
+            if (error instanceof Error) {
+                throw error;
+            }
+            throw new Error(`Failed to revert migration: ${error}`);
+        }
+    });
+}
+exports.revertMigration = revertMigration;
+function setMigrationSetting(options) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const apiService = new ApiService_1.ApiService({
+            validateStatus: validateAxiosStatus,
+        });
+        const migrationUrl = yield buildMigrationUrl(options.tenant, options.overrideUrl);
+        try {
+            const payload = {
+                matrixUrl: options.matrixUrl,
+                matrixIdentifier: options.matrixIdentifier,
+                matrixKey: options.matrixKey,
+            };
+            const response = yield apiService.client.post(`${migrationUrl}/settings`, payload, {
+                headers: Object.assign({ 'Content-Type': 'application/json' }, (yield getMigrationHeaders(options.tenant))),
+            });
+            if (response.status !== 200 && response.status !== 201) {
+                throw new Error(`Migration settings update failed with status: ${response.status}`);
+            }
+            if (!(response === null || response === void 0 ? void 0 : response.data)) {
+                throw new Error('No data returned from migration service');
+            }
+            const responseData = {
+                matrixUrl: response.data.matrixUrl,
+                matrixIdentifier: response.data.matrixIdentifier,
+                matrixKey: response.data.matrixKey
+                    ? redactKey(response.data.matrixKey, 3)
+                    : '',
+            };
+            return responseData;
+        }
+        catch (error) {
+            if (error instanceof Error) {
+                throw error;
+            }
+            throw new Error(`Failed to set migration settings: ${error}`);
+        }
+    });
+}
+exports.setMigrationSetting = setMigrationSetting;

package/lib/migration/utils.spec.js

@@ -145,6 +145,13 @@ describe('Migration Utils', () => {
             expect((0, utils_1.validateAxiosStatus)(500)).toBe(false);
         });
     });
+    describe('redactKey', () => {
+        it('redacts key correctly', () => {
+            expect((0, utils_1.redactKey)('1234567890', 3)).toBe('*******890');
+            expect((0, utils_1.redactKey)('1234567890', 1)).toBe('*********0');
+            expect((0, utils_1.redactKey)('1234567890', 10)).toBe('**********');
+        });
+    });
     describe('validateExportFolder', () => {
         beforeEach(() => {
             mockPath.join.mockImplementation((...paths) => paths.join('/'));
@@ -540,4 +547,71 @@ describe('Migration Utils', () => {
             expect(mockApiServiceInstance.client.get).toHaveBeenCalledWith('https://example.com/__dxp/service/aiapps/migration/migrations/migration-123/assets/asset-456', expect.any(Object));
         }));
     });
+    describe('revertMigration', () => {
+        const mockOptions = {
+            migrationId: 'migration-123',
+            assetId: 'asset-456',
+            tenant: 'test-tenant',
+        };
+        const mockApiServiceInstance = {
+            client: {
+                post: jest.fn(),
+            },
+        };
+        beforeEach(() => {
+            mockApiService.mockImplementation(() => mockApiServiceInstance);
+            mockFetchApplicationConfig.mockResolvedValue({
+                baseUrl: 'https://test.example.com',
+                tenant: 'test-tenant',
+                region: 'us-east-1',
+            });
+        });
+        it('should revert migration successfully', () => __awaiter(void 0, void 0, void 0, function* () {
+            const mockResponse = {
+                status: 200,
+                data: { message: 'Migration reverted successfully' },
+            };
+            mockApiServiceInstance.client.post.mockResolvedValue(mockResponse);
+            const result = yield (0, utils_1.revertMigration)(mockOptions);
+            expect(result).toEqual({ message: 'Migration reverted successfully' });
+            expect(mockApiServiceInstance.client.post).toHaveBeenCalledWith('https://test.example.com/__dxp/service/aiapps/migration/migrations/migration-123/assets/asset-456/rollback', {}, {
+                headers: {
+                    'Content-Type': 'application/json',
+                    'x-dxp-tenant': 'test-tenant',
+                },
+            });
+        }));
+        it('should handle non-success status codes', () => __awaiter(void 0, void 0, void 0, function* () {
+            const mockResponse = {
+                status: 400,
+                data: {},
+            };
+            mockApiServiceInstance.client.post.mockResolvedValue(mockResponse);
+            yield expect((0, utils_1.revertMigration)(mockOptions)).rejects.toThrow('Failed to revert migration: 400');
+        }));
+        it('should handle API service errors', () => __awaiter(void 0, void 0, void 0, function* () {
+            const error = new Error('Network error');
+            mockApiServiceInstance.client.post.mockRejectedValue(error);
+            yield expect((0, utils_1.revertMigration)(mockOptions)).rejects.toThrow('Network error');
+        }));
+        it('should handle unknown errors', () => __awaiter(void 0, void 0, void 0, function* () {
+            mockApiServiceInstance.client.post.mockRejectedValue('Unknown error');
+            yield expect((0, utils_1.revertMigration)(mockOptions)).rejects.toThrow('Failed to revert migration: Unknown error');
+        }));
+        it('should use override URL when provided', () => __awaiter(void 0, void 0, void 0, function* () {
+            const mockResponse = {
+                status: 200,
+                data: { message: 'Migration reverted successfully' },
+            };
+            mockApiServiceInstance.client.post.mockResolvedValue(mockResponse);
+            const optionsWithOverride = Object.assign(Object.assign({}, mockOptions), { overrideUrl: 'https://custom.migration.url' });
+            yield (0, utils_1.revertMigration)(optionsWithOverride);
+            expect(mockApiServiceInstance.client.post).toHaveBeenCalledWith('https://custom.migration.url/migrations/migration-123/assets/asset-456/rollback', {}, {
+                headers: {
+                    'Content-Type': 'application/json',
+                    'x-dxp-tenant': 'test-tenant',
+                },
+            });
+        }));
+    });
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@squiz/dxp-cli-next",
-  "version": "5.26.0-develop.2",
+  "version": "5.26.0-develop.4",
   "repository": {
     "url": "https://gitlab.squiz.net/dxp/dxp-cli-next"
   },