@kontent-ai/migration-toolkit 2.3.0 → 2.5.0

package/lib/export/utils/export.utils.ts

@@ -1,5 +1,5 @@
 import chalk from 'chalk';
-import { SourceExportItem } from '../export.models.js';
+import type { SourceExportItem } from '../export.models.js';
 
 export function throwErrorForItemRequest(itemRequest: SourceExportItem, message: string): never {
     throw Error(

package/lib/file/file-manager.ts

@@ -1,7 +1,7 @@
-import { Buffer as BufferProxy } from 'buffer';
+import type { Buffer as BufferProxy } from 'buffer';
 import chalk from 'chalk';
 import { promises } from 'fs';
-import { Logger } from '../core/index.js';
+import type { Logger } from '../core/index.js';
 
 export function fileManager(logger: Logger) {
     const getFilePath = (filename: string): string => {

package/lib/import/comparers/asset-comparer.ts

@@ -1,6 +1,7 @@
-import { AssetFolderModels, AssetModels, CollectionModels, LanguageModels } from '@kontent-ai/management-sdk';
+import type { AssetFolderModels, AssetModels, CollectionModels, LanguageModels } from '@kontent-ai/management-sdk';
 import deepEqual from 'deep-equal';
-import { MigrationAsset, MigrationAssetDescription, findRequired, geSizeInBytes } from '../../core/index.js';
+import type { MigrationAsset, MigrationAssetDescription } from '../../core/index.js';
+import { findRequired, geSizeInBytes } from '../../core/index.js';
 
 export function shouldUpdateAsset(data: {
     readonly migrationAsset: MigrationAsset;

package/lib/import/context/import-context-fetcher.ts

@@ -1,7 +1,7 @@
-import { AssetModels, ContentItemModels, LanguageVariantModels } from '@kontent-ai/management-sdk';
+import type { AssetModels, ContentItemModels, LanguageVariantModels } from '@kontent-ai/management-sdk';
 import chalk from 'chalk';
 import { match } from 'ts-pattern';
-import {
+import type {
     AssetStateInTargetEnvironmentByCodename,
     ItemStateInTargetEnvironmentByCodename,
     LanguageVariantSchedulesStateValues,
@@ -11,7 +11,9 @@ import {
     LanguageVariantWorkflowStateValues,
     LogSpinnerData,
     MigrationItem,
-    WorkflowStep,
+    WorkflowStep
+} from '../../core/index.js';
+import {
     findRequired,
     is404Error,
     managementClientUtils,
@@ -19,8 +21,9 @@ import {
     runMapiRequestAsync,
     workflowHelper as workflowHelperInit
 } from '../../core/index.js';
-import { ExtractItemByCodename, itemsExtractionProcessor } from '../../translation/index.js';
-import { GetFlattenedElementByCodenames, ImportContext, ImportContextConfig, ImportContextEnvironmentData } from '../import.models.js';
+import type { ExtractItemByCodename } from '../../translation/index.js';
+import { itemsExtractionProcessor } from '../../translation/index.js';
+import type { GetFlattenedElementByCodenames, ImportContext, ImportContextConfig, ImportContextEnvironmentData } from '../import.models.js';
 
 interface LanguageVariantWrapper {
     readonly draftLanguageVariant: Readonly<LanguageVariantModels.ContentItemLanguageVariant> | undefined;

package/lib/import/import-manager.ts

@@ -1,8 +1,9 @@
-import { ManagementClient } from '@kontent-ai/management-sdk';
+import type { ManagementClient } from '@kontent-ai/management-sdk';
 import chalk from 'chalk';
-import { defaultExternalIdGenerator, extractErrorData, getDefaultLogger, getMigrationManagementClient, Logger } from '../core/index.js';
+import type { Logger } from '../core/index.js';
+import { defaultExternalIdGenerator, extractErrorData, getDefaultLogger, getMigrationManagementClient } from '../core/index.js';
 import { importContextFetcherAsync } from './context/import-context-fetcher.js';
-import { ImportConfig, ImportContext, ImportedItem, ImportedLanguageVariant, ImportResult } from './import.models.js';
+import type { ImportConfig, ImportContext, ImportedItem, ImportedLanguageVariant, ImportResult } from './import.models.js';
 import { assetsImporter } from './importers/assets-importer.js';
 import { contentItemsImporter } from './importers/content-items-importer.js';
 import { languageVariantImporter } from './importers/language-variant-importer.js';
@@ -167,7 +168,7 @@ export function importManager(config: ImportConfig) {
                             codename: m.inputItem.system.codename,
                             language: m.inputItem.system.language,
                             type: m.inputItem.system.type,
-                            error: extractErrorData(m.state === 'error').message
+                            error: extractErrorData(m.error).message
                         };
                     })
             }
@@ -175,7 +176,7 @@ export function importManager(config: ImportConfig) {
     };
 
     const printReportToConsole = (reportResult: ReportResult, logger: Logger): void => {
-        const errors = [
+        const errors: readonly string[][] = [
             ...reportResult.assets.failed.map((m) => [
                 `Object type: ${chalk.yellow('Asset')}`,
                 `Codename: ${chalk.yellow(m.codename)}`,

package/lib/import/import.models.ts

@@ -1,4 +1,4 @@
-import {
+import type {
     AssetFolderModels,
     AssetModels,
     CollectionModels,
@@ -9,7 +9,7 @@ import {
     ManagementClient,
     WorkflowModels
 } from '@kontent-ai/management-sdk';
-import {
+import type {
     AssetStateInTargetEnvironmentByCodename,
     ExternalIdGenerator,
     FlattenedContentType,

package/lib/import/importers/assets-importer.ts

@@ -1,19 +1,10 @@
-import { AssetModels, LanguageModels, ManagementClient, SharedContracts } from '@kontent-ai/management-sdk';
+import type { AssetModels, LanguageModels, ManagementClient, SharedContracts } from '@kontent-ai/management-sdk';
 import chalk from 'chalk';
 import mime from 'mime';
-import {
-    geSizeInBytes,
-    isNotUndefined,
-    Logger,
-    LogSpinnerData,
-    MigrationAsset,
-    MigrationAssetDescription,
-    MigrationReference,
-    processItemsAsync,
-    runMapiRequestAsync
-} from '../../core/index.js';
+import type { Logger, LogSpinnerData, MigrationAsset, MigrationAssetDescription, MigrationReference } from '../../core/index.js';
+import { geSizeInBytes, isNotUndefined, processItemsAsync, runMapiRequestAsync } from '../../core/index.js';
 import { shouldReplaceBinaryFile, shouldUpdateAsset } from '../comparers/asset-comparer.js';
-import { AssetToEdit, EditedAsset, ImportContext, ImportedAsset, ImportResult } from '../import.models.js';
+import type { AssetToEdit, EditedAsset, ImportContext, ImportedAsset, ImportResult } from '../import.models.js';
 
 export function assetsImporter(data: {
     readonly logger: Logger;

package/lib/import/importers/content-items-importer.ts

@@ -1,33 +1,29 @@
-import { ContentItemModels, ManagementClient } from '@kontent-ai/management-sdk';
+import type { ContentItemModels, ManagementClient } from '@kontent-ai/management-sdk';
 import chalk from 'chalk';
-import { LogSpinnerData, Logger, MigrationItem, findRequired, processItemsAsync, runMapiRequestAsync } from '../../core/index.js';
-import { ImportContext, ImportedItem } from '../import.models.js';
+import type { LogSpinnerData, Logger, MigrationItem } from '../../core/index.js';
+import { findRequired, processItemsAsync, runMapiRequestAsync } from '../../core/index.js';
+import type { ImportContext, ImportedItem } from '../import.models.js';
 
 export function contentItemsImporter(data: {
     readonly logger: Logger;
     readonly client: Readonly<ManagementClient>;
     readonly importContext: ImportContext;
 }) {
-    const shouldUpdateContentItem = (
-        migrationContentItem: MigrationItem,
-        contentItem: Readonly<ContentItemModels.ContentItem>
-    ): boolean => {
+    const shouldUpdateContentItem = (migrationItem: MigrationItem, contentItem: Readonly<ContentItemModels.ContentItem>): boolean => {
         const collection = findRequired(
             data.importContext.environmentData.collections,
-            (collection) => collection.codename === migrationContentItem.system.collection.codename,
-            `Invalid collection '${migrationContentItem.system.collection.codename}'`
+            (collection) => collection.id === contentItem.collection.id,
+            `Invalid collection with id '${contentItem.collection.id}' for content item '${contentItem.codename}'`
         );
 
-        return (
-            migrationContentItem.system.name !== contentItem.name || migrationContentItem.system.collection.codename !== collection.codename
-        );
+        return migrationItem.system.name !== contentItem.name || migrationItem.system.collection.codename !== collection.codename;
     };
 
     const prepareContentItemAsync = async (
         logSpinner: LogSpinnerData,
-        migrationContentItem: MigrationItem
+        migrationItem: MigrationItem
     ): Promise<{ contentItem: Readonly<ContentItemModels.ContentItem>; status: 'created' | 'itemAlreadyExists' }> => {
-        const itemStateInTargetEnv = data.importContext.getItemStateInTargetEnvironment(migrationContentItem.system.codename);
+        const itemStateInTargetEnv = data.importContext.getItemStateInTargetEnvironment(migrationItem.system.codename);
 
         if (itemStateInTargetEnv.state === 'exists' && itemStateInTargetEnv.item) {
             return {
@@ -43,14 +39,14 @@ export function contentItemsImporter(data: {
                     await data.client
                         .addContentItem()
                         .withData({
-                            name: migrationContentItem.system.name,
+                            name: migrationItem.system.name,
                             type: {
-                                codename: migrationContentItem.system.type.codename
+                                codename: migrationItem.system.type.codename
                             },
                             external_id: itemStateInTargetEnv.externalIdToUse,
-                            codename: migrationContentItem.system.codename,
+                            codename: migrationItem.system.codename,
                             collection: {
-                                codename: migrationContentItem.system.collection.codename
+                                codename: migrationItem.system.collection.codename
                             }
                         })
                         .toPromise()
@@ -58,7 +54,7 @@ export function contentItemsImporter(data: {
             action: 'create',
             type: 'contentItem',
             logSpinner: logSpinner,
-            itemName: `${migrationContentItem.system.codename} (${migrationContentItem.system.language.codename})`
+            itemName: `${migrationItem.system.codename} (${migrationItem.system.language.codename})`
         });
 
         return {

package/lib/import/importers/language-variant-importer.ts

@@ -1,22 +1,18 @@
-import { ElementContracts, LanguageVariantModels, ManagementClient, WorkflowModels } from '@kontent-ai/management-sdk';
+import type { ElementContracts, LanguageVariantModels, ManagementClient, WorkflowModels } from '@kontent-ai/management-sdk';
 import chalk from 'chalk';
 import { match } from 'ts-pattern';
-import {
-    findRequired,
-    isNotUndefined,
+import type {
     LanguageVariantSchedulesStateValues,
     LanguageVariantStateInTargetEnvironmentByCodename,
     Logger,
     LogSpinnerData,
     MigrationElement,
     MigrationItem,
-    MigrationItemVersion,
-    processItemsAsync,
-    runMapiRequestAsync,
-    workflowHelper
+    MigrationItemVersion
 } from '../../core/index.js';
+import { findRequired, isNotUndefined, processItemsAsync, runMapiRequestAsync, workflowHelper } from '../../core/index.js';
 import { importTransforms } from '../../translation/index.js';
-import { ImportContext, ImportedItem, ImportedLanguageVariant } from '../import.models.js';
+import type { ImportContext, ImportedItem, ImportedLanguageVariant } from '../import.models.js';
 import { throwErrorForMigrationItem } from '../utils/import.utils.js';
 import { workflowImporter as workflowImporterInit } from './workflow-importer.js';
 

package/lib/import/importers/workflow-importer.ts

@@ -1,15 +1,8 @@
-import { LanguageVariantModels, ManagementClient, SharedModels, WorkflowModels } from '@kontent-ai/management-sdk';
+import type { LanguageVariantModels, ManagementClient, WorkflowModels } from '@kontent-ai/management-sdk';
+import { SharedModels } from '@kontent-ai/management-sdk';
 import { match } from 'ts-pattern';
-import {
-    Logger,
-    LogSpinnerData,
-    MigrationItem,
-    MigrationItemVersion,
-    runMapiRequestAsync,
-    ShortestPathResult,
-    workflowHelper as workflowHelperInit,
-    WorkflowStep
-} from '../../core/index.js';
+import type { Logger, LogSpinnerData, MigrationItem, MigrationItemVersion, ShortestPathResult, WorkflowStep } from '../../core/index.js';
+import { runMapiRequestAsync, workflowHelper as workflowHelperInit } from '../../core/index.js';
 
 export function workflowImporter(config: {
     readonly logger: Logger;

package/lib/import/index.ts

@@ -1,2 +1,2 @@
-export * from './import.models.js';
 export * from './import-manager.js';
+export * from './import.models.js';

package/lib/import/utils/import.utils.ts

@@ -1,5 +1,5 @@
 import chalk from 'chalk';
-import { MigrationItem } from 'lib/core/index.js';
+import type { MigrationItem } from '../../core/index.js';
 
 export function throwErrorForMigrationItem(migrationItem: MigrationItem, message: string): never {
     throw Error(

package/lib/index.ts

@@ -1,9 +1,8 @@
 // Public API
 export * from './core/index.js';
 export * from './export/index.js';
-export * from './import/index.js';
 export * from './file/index.js';
-export * from './zip/index.js';
+export * from './import/index.js';
 export * from './toolkit/index.js';
-export * from './file/index.js';
 export * from './translation/index.js';
+export * from './zip/index.js';

package/lib/metadata.ts

@@ -1,6 +1,6 @@
 
 export const libMetadata = {
 	name: '@kontent-ai/migration-toolkit',
-    timestamp: 'Thu, 12 Dec 2024 13:23:40 GMT',
-    version: '2.3.0'
+    timestamp: 'Tue, 11 Mar 2025 11:12:11 GMT',
+    version: '2.5.0'
 };

package/lib/node/cli/actions/export-action.ts

@@ -1,6 +1,6 @@
 import { confirmExportAsync, defaultZipFilename, getDefaultLogger } from '../../../core/index.js';
 import { exportAsync, storeAsync } from '../../../toolkit/index.js';
-import { CliArgumentsFetcher } from '../cli.models.js';
+import type { CliArgumentsFetcher } from '../cli.models.js';
 
 export async function exportActionAsync(cliFetcher: CliArgumentsFetcher): Promise<void> {
     const logger = getDefaultLogger();

package/lib/node/cli/actions/import-action.ts

@@ -1,6 +1,6 @@
 import { confirmImportAsync, defaultZipFilename, getDefaultLogger } from '../../../core/index.js';
 import { extractAsync, importAsync } from '../../../toolkit/index.js';
-import { CliArgumentsFetcher } from '../cli.models.js';
+import type { CliArgumentsFetcher } from '../cli.models.js';
 
 export async function importActionAsync(argsFetcher: CliArgumentsFetcher): Promise<void> {
     const log = getDefaultLogger();

package/lib/node/cli/actions/migrate-action.ts

@@ -1,7 +1,7 @@
-import { migrateAsync } from '../../../toolkit/index.js';
 import { confirmMigrateAsync, getDefaultLogger } from '../../../core/index.js';
-import { SourceExportItem } from '../../../export/index.js';
-import { CliArgumentsFetcher } from '../cli.models.js';
+import type { SourceExportItem } from '../../../export/index.js';
+import { migrateAsync } from '../../../toolkit/index.js';
+import type { CliArgumentsFetcher } from '../cli.models.js';
 
 export async function migrateActionAsync(argsFetcher: CliArgumentsFetcher): Promise<void> {
     const log = getDefaultLogger();

package/lib/node/cli/app.ts

@@ -1,13 +1,13 @@
 #!/usr/bin/env node
 import chalk from 'chalk';
 
-import { handleError, exitProgram } from '../../core/index.js';
+import { match } from 'ts-pattern';
+import { exitProgram, handleError } from '../../core/index.js';
 import { exportActionAsync } from './actions/export-action.js';
 import { importActionAsync } from './actions/import-action.js';
 import { migrateActionAsync } from './actions/migrate-action.js';
 import { argumentsFetcherAsync } from './args/args-fetcher.js';
 import { cliArgs } from './commands.js';
-import { match } from 'ts-pattern';
 
 // Need to register --help commands
 cliArgs.registerCommands();

package/lib/node/cli/args/args-fetcher.ts

@@ -1,9 +1,10 @@
-import yargs from 'yargs';
-import { hideBin } from 'yargs/helpers';
 import chalk from 'chalk';
-import { CliAction, exitProgram, LiteralUnion } from '../../../core/index.js';
-import { CliArgumentsFetcher } from '../cli.models.js';
 import { match } from 'ts-pattern';
+import yargs from 'yargs';
+import { hideBin } from 'yargs/helpers';
+import type { CliAction, LiteralUnion } from '../../../core/index.js';
+import { exitProgram } from '../../../core/index.js';
+import type { CliArgumentsFetcher } from '../cli.models.js';
 
 type ArgvResult = {
     [x: string]: unknown;

package/lib/node/cli/args/args-setter.ts

@@ -1,6 +1,6 @@
 import yargs from 'yargs';
 import { hideBin } from 'yargs/helpers';
-import { CliArgumentsSetter, Command, CommandOption } from '../cli.models.js';
+import type { CliArgumentsSetter, Command, CommandOption } from '../cli.models.js';
 
 export function argumentsSetter(): CliArgumentsSetter {
     const argv = yargs(hideBin(process.argv));

package/lib/node/cli/cli.models.ts

@@ -1,4 +1,4 @@
-import { CliAction } from '../../core/index.js';
+import type { CliAction } from '../../core/index.js';
 
 export interface Command {
     readonly name: string;

package/lib/node/cli/commands.ts

@@ -4,9 +4,7 @@ export const cliArgs = argumentsSetter()
     .withCommand({
         name: 'export',
         description: 'Exports content (items & assets) from Kontent.ai environment',
-        examples: [
-            `kontent-ai-migration-toolkit export --sourceEnvironmentId=x --sourceApiKey=x --language=default --items=itemA,itemB`
-        ],
+        examples: [`kontent-ai-migration-toolkit export --sourceEnvironmentId=x --sourceApiKey=x --language=default --items=itemA,itemB`],
         options: [
             {
                 name: `sourceApiKey`,
@@ -95,8 +93,7 @@ export const cliArgs = argumentsSetter()
 
     .withCommand({
         name: 'migrate',
-        description:
-            'Migrates content (items & assets) from one Kontent.ai environment into another Kontent.ai environment',
+        description: 'Migrates content (items & assets) from one Kontent.ai environment into another Kontent.ai environment',
         examples: [
             `kontent-ai-migration-toolkit migrate --targetEnvironmentId=x --targetApiKey=x --sourceEnvironmentId=x --sourceApiKey=x --language=default --items=itemA,itemB`
         ],

package/lib/toolkit/elements-builder.ts

@@ -1,4 +1,4 @@
-import { MigrationElementModels } from '../core/index.js';
+import type { MigrationElementModels } from '../core/index.js';
 
 export const elementsBuilder = {
     textElement: (data: Omit<MigrationElementModels.TextElement, 'type'>): MigrationElementModels.TextElement => {
@@ -19,17 +19,13 @@ export const elementsBuilder = {
             type: 'custom'
         };
     },
-    dateTimeElement: (
-        data: Omit<MigrationElementModels.DateTimeElement, 'type'>
-    ): MigrationElementModels.DateTimeElement => {
+    dateTimeElement: (data: Omit<MigrationElementModels.DateTimeElement, 'type'>): MigrationElementModels.DateTimeElement => {
         return {
             ...data,
             type: 'date_time'
         };
     },
-    linkedItemsElement: (
-        data: Omit<MigrationElementModels.LinkedItemsElement, 'type'>
-    ): MigrationElementModels.LinkedItemsElement => {
+    linkedItemsElement: (data: Omit<MigrationElementModels.LinkedItemsElement, 'type'>): MigrationElementModels.LinkedItemsElement => {
         return {
             ...data,
             type: 'modular_content'
@@ -49,33 +45,25 @@ export const elementsBuilder = {
             type: 'number'
         };
     },
-    richTextElement: (
-        data: Omit<MigrationElementModels.RichTextElement, 'type'>
-    ): MigrationElementModels.RichTextElement => {
+    richTextElement: (data: Omit<MigrationElementModels.RichTextElement, 'type'>): MigrationElementModels.RichTextElement => {
         return {
             ...data,
             type: 'rich_text'
         };
     },
-    subpagesElement: (
-        data: Omit<MigrationElementModels.SubpagesElement, 'type'>
-    ): MigrationElementModels.SubpagesElement => {
+    subpagesElement: (data: Omit<MigrationElementModels.SubpagesElement, 'type'>): MigrationElementModels.SubpagesElement => {
         return {
             ...data,
             type: 'subpages'
         };
     },
-    taxonomyElement: (
-        data: Omit<MigrationElementModels.TaxonomyElement, 'type'>
-    ): MigrationElementModels.TaxonomyElement => {
+    taxonomyElement: (data: Omit<MigrationElementModels.TaxonomyElement, 'type'>): MigrationElementModels.TaxonomyElement => {
         return {
             ...data,
             type: 'taxonomy'
         };
     },
-    urlSlugElement: (
-        data: Omit<MigrationElementModels.UrlSlugElement, 'type'>
-    ): MigrationElementModels.UrlSlugElement => {
+    urlSlugElement: (data: Omit<MigrationElementModels.UrlSlugElement, 'type'>): MigrationElementModels.UrlSlugElement => {
         return {
             ...data,
             type: 'url_slug'

package/lib/toolkit/export.ts

@@ -1,5 +1,7 @@
-import { MigrationData, executeWithTrackingAsync } from '../core/index.js';
-import { ExportConfig, exportManager } from '../export/index.js';
+import type { MigrationData } from '../core/index.js';
+import { executeWithTrackingAsync } from '../core/index.js';
+import type { ExportConfig } from '../export/index.js';
+import { exportManager } from '../export/index.js';
 import { libMetadata } from '../metadata.js';
 
 export async function exportAsync(config: ExportConfig): Promise<MigrationData> {

package/lib/toolkit/file.ts

@@ -1,5 +1,6 @@
 import { Buffer as BufferProxy } from 'buffer';
-import { defaultZipFilename, executeWithTrackingAsync, getDefaultLogger, Logger, MigrationData } from '../core/index.js';
+import type { Logger, MigrationData } from '../core/index.js';
+import { defaultZipFilename, executeWithTrackingAsync, getDefaultLogger } from '../core/index.js';
 import { fileManager } from '../file/index.js';
 import { libMetadata } from '../metadata.js';
 import { zipManager } from '../zip/index.js';

package/lib/toolkit/import.ts

@@ -1,7 +1,8 @@
 import chalk from 'chalk';
 import { writeFile } from 'fs/promises';
 import { executeWithTrackingAsync } from '../core/index.js';
-import { ImportConfig, ImportResult, importManager as _importManager } from '../import/index.js';
+import type { ImportConfig, ImportResult } from '../import/index.js';
+import { importManager as _importManager } from '../import/index.js';
 import { libMetadata } from '../metadata.js';
 
 export async function importAsync(config: ImportConfig): Promise<ImportResult> {

package/lib/toolkit/index.ts

@@ -1,5 +1,5 @@
+export * from './elements-builder.js';
 export * from './export.js';
+export * from './file.js';
 export * from './import.js';
-export * from './elements-builder.js';
 export * from './migrate.js';
-export * from './file.js';

package/lib/toolkit/migrate.ts

@@ -1,14 +1,8 @@
-import { IRetryStrategyOptions } from '@kontent-ai/core-sdk';
-import {
-    ExternalIdGenerator,
-    Logger,
-    ManagementClientConfig,
-    MigrationData,
-    executeWithTrackingAsync,
-    getDefaultLogger
-} from '../core/index.js';
-import { SourceExportItem } from '../export/index.js';
-import { ImportResult } from '../import/index.js';
+import type { IRetryStrategyOptions } from '@kontent-ai/core-sdk';
+import type { ExternalIdGenerator, Logger, ManagementClientConfig, MigrationData } from '../core/index.js';
+import { executeWithTrackingAsync, getDefaultLogger } from '../core/index.js';
+import type { SourceExportItem } from '../export/index.js';
+import type { ImportResult } from '../import/index.js';
 import { libMetadata } from '../metadata.js';
 import { exportAsync } from './export.js';
 import { importAsync } from './import.js';

package/lib/translation/extraction/items-extraction.processor.ts

@@ -1,14 +1,14 @@
-import { ElementModels } from '@kontent-ai/management-sdk';
-import { GetFlattenedElementByIds } from 'lib/export/export.models.js';
+import type { ElementModels } from '@kontent-ai/management-sdk';
 import { match, P } from 'ts-pattern';
-import {
+import type {
     MigrationElementModels,
     MigrationElements,
-    parseAsMigrationReferencesArray,
     ReferencedDataInLanguageVariants,
     ReferencedDataInMigrationItems
 } from '../../core/index.js';
-import { GetFlattenedElementByCodenames } from '../../import/index.js';
+import { isArray, isString, parseAsMigrationReferencesArray } from '../../core/index.js';
+import type { GetFlattenedElementByIds } from '../../export/export.models.js';
+import type { GetFlattenedElementByCodenames } from '../../import/index.js';
 import { richTextProcessor } from '../index.js';
 
 export interface ExtractItemById {
@@ -43,24 +43,24 @@ export function itemsExtractionProcessor() {
 
                     match(typeElement.type)
                         .with('rich_text', () => {
-                            const rteValue = itemElement.value?.toString();
+                            const rteValue = itemElement.value && isString(itemElement.value) ? itemElement.value : '';
 
                             // extract referenced items
                             richTextProcessor()
-                                .processDataIds(rteValue ?? '')
+                                .processDataIds(rteValue)
                                 .ids.forEach((id) => extractedIds.itemIds.add(id));
 
                             richTextProcessor()
-                                .processLinkItemIds(rteValue ?? '')
+                                .processLinkItemIds(rteValue)
                                 .ids.forEach((id) => extractedIds.itemIds.add(id));
 
                             // extract referenced assets
                             richTextProcessor()
-                                .processAssetIds(rteValue ?? '')
+                                .processAssetIds(rteValue)
                                 .ids.forEach((id) => extractedIds.assetIds.add(id));
 
                             richTextProcessor()
-                                .processLinkAssetIds(rteValue ?? '')
+                                .processLinkAssetIds(rteValue)
                                 .ids.forEach((id) => extractedIds.assetIds.add(id));
 
                             // recursively extract data from components as well because they may reference additional assets & content items
@@ -78,12 +78,12 @@ export function itemsExtractionProcessor() {
                             extractedComponents.assetIds.forEach((id) => extractedIds.assetIds.add(id));
                         })
                         .with(P.union('modular_content', 'subpages'), () => {
-                            if (itemElement.value && Array.isArray(itemElement.value)) {
+                            if (itemElement.value && isArray(itemElement.value)) {
                                 itemElement.value.forEach((value) => (value.id ? extractedIds.itemIds.add(value.id) : {}));
                             }
                         })
                         .with('asset', () => {
-                            if (itemElement.value && Array.isArray(itemElement.value)) {
+                            if (itemElement.value && isArray(itemElement.value)) {
                                 itemElement.value.forEach((value) => (value.id ? extractedIds.assetIds.add(value.id) : {}));
                             }
                         })