@kontent-ai/migration-toolkit 3.2.0-preview.1 → 3.2.1

package/lib/toolkit/import.ts

@@ -1,37 +1,20 @@
 import { writeFile } from "node:fs/promises";
 import chalk from "chalk";
-import { executeWithTrackingAsync } from "../core/utils/global.utils.js";
 import type { ImportConfig, ImportResult } from "../import/import.models.js";
 import { importManager as _importManager } from "../import/import-manager.js";
-import { libMetadata } from "../metadata.js";
 
 export async function importAsync(config: ImportConfig): Promise<ImportResult> {
-	return await executeWithTrackingAsync({
-		event: {
-			tool: "migrationToolkit",
-			package: {
-				name: libMetadata.name,
-				version: libMetadata.version,
-			},
-			action: "import",
-			relatedEnvironmentId: undefined,
-			details: {},
-		},
-		func: async () => {
-			const importManager = _importManager(config);
-			const importResult = await importManager.importAsync();
+	const importManager = _importManager(config);
+	const importResult = await importManager.importAsync();
 
-			if (config.createReportFile) {
-				const reportFile = importManager.getReportFile(importResult);
-				await writeFile(reportFile.filename, reportFile.content);
-				config.logger?.log({
-					type: "writeFs",
-					message: `Report '${chalk.yellow(reportFile.filename)}' was created`,
-				});
-			}
+	if (config.createReportFile) {
+		const reportFile = importManager.getReportFile(importResult);
+		await writeFile(reportFile.filename, reportFile.content);
+		config.logger?.log({
+			type: "writeFs",
+			message: `Report '${chalk.yellow(reportFile.filename)}' was created`,
+		});
+	}
 
-			return importResult;
-		},
-		logger: config.logger,
-	});
+	return importResult;
 }

package/lib/toolkit/migrate.ts

@@ -3,11 +3,9 @@ import { getDefaultLogger } from "../core/logs/loggers.js";
 import type { Logger } from "../core/models/log.models.js";
 import type { MigrationData } from "../core/models/migration.models.js";
 import type { ExternalIdGenerator } from "../core/utils/external-id.utils.js";
-import { executeWithTrackingAsync } from "../core/utils/global.utils.js";
 import type { ManagementClientConfig } from "../core/utils/management-client-utils.js";
 import type { SourceExportItem } from "../export/export.models.js";
 import type { ImportResult } from "../import/import.models.js";
-import { libMetadata } from "../metadata.js";
 import { exportAsync } from "./export.js";
 import { importAsync } from "./import.js";
 
@@ -37,39 +35,22 @@ export type MigrationResult = {
 export async function migrateAsync(config: MigrationConfig): Promise<MigrationResult> {
 	const logger = config.logger ?? getDefaultLogger();
 
-	return await executeWithTrackingAsync({
-		event: {
-			tool: "migrationToolkit",
-			package: {
-				name: libMetadata.name,
-				version: libMetadata.version,
-			},
-			action: "migrate",
-			relatedEnvironmentId: undefined,
-			details: {
-				itemsCount: config.sourceEnvironment.items.length,
-			},
-		},
-		func: async () => {
-			const migrationData = await exportAsync({
-				...config.sourceEnvironment,
-				logger: logger,
-				exportItems: config.sourceEnvironment.items,
-				skipMissingReferences: config.sourceEnvironment.skipMissingReferences,
-			});
-
-			const importResult = await importAsync({
-				...config.targetEnvironment,
-				logger: logger,
-				data: migrationData,
-				externalIdGenerator: config.externalIdGenerator,
-			});
+	const migrationData = await exportAsync({
+		...config.sourceEnvironment,
+		logger: logger,
+		exportItems: config.sourceEnvironment.items,
+		skipMissingReferences: config.sourceEnvironment.skipMissingReferences,
+	});
 
-			return {
-				importResult,
-				migrationData,
-			};
-		},
-		logger: config.logger,
+	const importResult = await importAsync({
+		...config.targetEnvironment,
+		logger: logger,
+		data: migrationData,
+		externalIdGenerator: config.externalIdGenerator,
 	});
+
+	return {
+		importResult,
+		migrationData,
+	};
 }

package/lib/translation/helpers/rich-text.processor.ts

@@ -190,12 +190,6 @@ export function richTextProcessor() {
 						return objectTag;
 					}
 
-					if (!itemState.externalIdToUse) {
-						// when external_id is not available, try falling back to initial codename - this can fail
-						// if the item does not exist in the target env
-						return objectTag;
-					}
-
 					return objectTag.replaceAll(
 						`${attributes.codenames.itemCodenameAttribute}="${codename}"`,
 						`${attributes.ids.externalIdAttributeName}="${itemState.externalIdToUse}"`,
@@ -231,13 +225,6 @@ export function richTextProcessor() {
 					if (itemState.item && itemState.state === "exists") {
 						return linkTag;
 					}
-
-					if (!itemState.externalIdToUse) {
-						// when external_id is not available, try falling back to initial codename - this can fail
-						// if the item does not exist in the target env
-						return linkTag;
-					}
-
 					return linkTag.replaceAll(
 						`${attributes.codenames.linkItemCodenameAttribute}="${codename}"`,
 						`${attributes.ids.itemExternalIdAttributeName}="${itemState.externalIdToUse}"`,
@@ -273,13 +260,6 @@ export function richTextProcessor() {
 					if (assetState.asset && assetState.state === "exists") {
 						return figureTag;
 					}
-
-					if (!assetState.externalIdToUse) {
-						// when external_id is not available, try falling back to initial codename - this can fail
-						// if the asset does not exist in the target env
-						return figureTag;
-					}
-
 					return figureTag.replaceAll(
 						`${attributes.codenames.assetCodenameAttribute}="${codename}"`,
 						`${attributes.ids.externalAssetIdAttributeName}="${assetState.externalIdToUse}"`,
@@ -315,13 +295,6 @@ export function richTextProcessor() {
 					if (assetState.asset && assetState.state === "exists") {
 						return linkTag;
 					}
-
-					if (!assetState.externalIdToUse) {
-						// when external_id is not available, try falling back to initial codename - this can fail
-						// if the asset does not exist in the target env
-						return linkTag;
-					}
-
 					return linkTag.replaceAll(
 						`${attributes.codenames.assetCodenameAttribute}="${codename}"`,
 						`${attributes.ids.externalAssetIdAttributeName}="${assetState.externalIdToUse}"`,

package/lib/translation/transforms/import-transforms.ts

@@ -1,7 +1,7 @@
 import { type LanguageVariantElements, LanguageVariantElementsBuilder, type SharedContracts } from "@kontent-ai/management-sdk";
 import type { MigrationElementTransformData, MigrationElementType, MigrationItem } from "../../core/models/migration.models.js";
 import { parseAsMigrationReferencesArray } from "../../core/utils/array.utils.js";
-import { isNotUndefined, isString } from "../../core/utils/global.utils.js";
+import { isString } from "../../core/utils/global.utils.js";
 import type { ImportContext, ImportTransformFunc } from "../../import/import.models.js";
 import { richTextProcessor } from "../helpers/rich-text.processor.js";
 
@@ -27,25 +27,16 @@ export const importTransforms: Readonly<Record<MigrationElementType, ImportTrans
 	asset: (data) => {
 		const assetReferences = parseAsMigrationReferencesArray(data.elementData.value)
 			.map((reference) => reference.codename)
-			.map<Readonly<SharedContracts.IReferenceObjectContract> | undefined>((codename) => {
+			.map<Readonly<SharedContracts.IReferenceObjectContract>>((codename) => {
 				const assetState = data.importContext.getAssetStateInTargetEnvironment(codename);
-				if (assetState.asset) {
-					return {
-						id: assetState.asset.id,
-					};
-				}
-
-				if (!assetState.externalIdToUse && !assetState.asset) {
-					return {
-						codename: assetState.assetCodename,
-					};
-				}
 
+				// only reference with external_id if item does not exist in target env
+				// API currently only supports referencing assets by ids only, not by codenames
 				return {
-					external_id: assetState.externalIdToUse,
+					id: assetState.asset ? assetState.asset.id : undefined,
+					external_id: assetState.asset ? undefined : assetState.externalIdToUse,
 				};
-			})
-			.filter(isNotUndefined);
+			});
 
 		return elementsBuilder.assetElement({
 			element: {
@@ -74,26 +65,15 @@ export const importTransforms: Readonly<Record<MigrationElementType, ImportTrans
 	modular_content: (data) => {
 		const linkedItemReferences = parseAsMigrationReferencesArray(data.elementData.value)
 			.map((reference) => reference.codename)
-			.map<Readonly<SharedContracts.IReferenceObjectContract> | undefined>((codename) => {
+			.map<Readonly<SharedContracts.IReferenceObjectContract>>((codename) => {
 				const itemState = data.importContext.getItemStateInTargetEnvironment(codename);
 
-				if (itemState.item) {
-					return {
-						codename: itemState.item.codename,
-					};
-				}
-
-				if (!itemState.externalIdToUse && !itemState.item) {
-					return {
-						codename: itemState.itemCodename,
-					};
-				}
-
+				// only reference with external_id if item does not exist in target env
 				return {
-					external_id: itemState.externalIdToUse,
+					codename: itemState.item ? itemState.item.codename : undefined,
+					external_id: itemState.item ? undefined : itemState.externalIdToUse,
 				};
-			})
-			.filter(isNotUndefined);
+			});
 
 		return elementsBuilder.linkedItemsElement({
 			element: {

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@kontent-ai/migration-toolkit",
-	"version": "3.2.0-preview.1",
+	"version": "3.2.1",
 	"description": "This program can be used to import content related data into Kontent.ai from various sources. The included functionality enables the content & asset export/import from Kontent.ai environments.",
 	"preferGlobal": true,
 	"private": false,
@@ -32,6 +32,7 @@
 		"biome:fix:unsafe": "biome check --write --unsafe",
 		"clean": "tsx scripts/clean.ts",
 		"update:version": "tsx ./scripts/version/update-version.ts && npm run biome:fix",
+		"test:clean": "cd scripts/test && tsx test-clean.ts",
 		"test:migrate": "cd scripts/test && tsx test-migrate.ts",
 		"test:import": "cd scripts/test && tsx test-import.ts",
 		"test:export": "cd scripts/test && tsx test-export.ts",
@@ -49,8 +50,7 @@
 	],
 	"license": "MIT",
 	"dependencies": {
-		"@kontent-ai-consulting/tools-analytics": "0.0.12",
-		"@kontent-ai/management-sdk": "8.5.1",
+		"@kontent-ai/management-sdk": "8.5.4",
 		"browser-or-node": "3.0.0",
 		"buffer": "6.0.3",
 		"bytes": "3.1.2",
@@ -59,7 +59,7 @@
 		"dotenv": "17.4.2",
 		"jszip": "3.10.1",
 		"mime": "4.1.0",
-		"ora": "9.4.0",
+		"ora": "9.4.1",
 		"p-limit": "7.3.0",
 		"prompts": "2.4.2",
 		"ts-pattern": "5.9.0",
@@ -67,20 +67,21 @@
 		"zod": "4.4.3"
 	},
 	"devDependencies": {
-		"@kontent-ai/biome-config": "0.7.0",
+		"@kontent-ai/data-ops": "2.7.0",
+		"@kontent-ai/biome-config": "0.7.3",
 		"@kontent-ai/eslint-config": "2.4.1",
-		"@biomejs/biome": "2.4.15",
+		"@biomejs/biome": "2.5.1",
 		"@eslint/js": "10.0.1",
 		"@types/browser-or-node": "1.3.2",
 		"@types/bytes": "3.1.5",
 		"@types/deep-equal": "1.0.4",
-		"@types/node": "25.7.0",
+		"@types/node": "26.1.0",
 		"@types/prompts": "2.4.9",
 		"@types/yargs": "17.0.35",
-		"eslint": "10.3.0",
+		"eslint": "10.6.0",
 		"tslib": "2.8.1",
-		"tsx": "4.21.0",
+		"tsx": "4.22.5",
 		"typescript": "6.0.3",
-		"vitest": "4.1.6"
+		"vitest": "4.1.9"
 	}
 }