@kontent-ai/migration-toolkit 1.5.0 → 2.0.0

package/lib/core/models/migration.models.ts

@@ -1,20 +1,18 @@
 import { z } from 'zod';
 import {
+    MigrationAssetDescriptionSchema,
+    MigrationAssetSchema,
     MigrationComponentSchema,
-    MigrationElementTypeSchema,
-    MigrationElementValueSchema,
-    MigrationReferenceSchema,
-    MigrationUrlSlugElementValueSchema,
-    MigrationUrlSlugModeSchema,
-    MigrationRichTextElementValueSchema,
+    MigrationDataSchema,
     MigrationElementSchema,
     MigrationElementsSchema,
-    MigrationAssetDescriptionSchema,
-    MigrationDataSchema,
-    MigrationAssetSchema,
-    MigrationItemVersionSchema,
+    MigrationElementTypeSchema,
+    MigrationElementValueSchema,
     MigrationItemSchema,
-    MigrationItemSystemSchema
+    MigrationItemSystemSchema,
+    MigrationItemVersionSchema,
+    MigrationReferenceSchema,
+    MigrationUrlSlugModeSchema
 } from './migration.schema.js';
 
 export namespace MigrationElementModels {
@@ -28,13 +26,13 @@ export namespace MigrationElementModels {
 
     export type TextElement = MigrationElementDef<'text', string>;
     export type NumberElement = MigrationElementDef<'number', number>;
-    export type RichTextElement = MigrationElementDef<'rich_text', MigrationRichTextElementValue>;
+    export type RichTextElement = MigrationElementDef<'rich_text', string>;
     export type MultipleChoiceElement = MigrationElementDef<'multiple_choice', MigrationReference[]>;
     export type DateTimeElement = MigrationElementDef<'date_time', string>;
     export type AssetElement = MigrationElementDef<'asset', MigrationReference[]>;
     export type LinkedItemsElement = MigrationElementDef<'modular_content', MigrationReference[]>;
     export type TaxonomyElement = MigrationElementDef<'taxonomy', MigrationReference[]>;
-    export type UrlSlugElement = MigrationElementDef<'url_slug', MigrationUrlSlugElementValue>;
+    export type UrlSlugElement = MigrationElementDef<'url_slug', string>;
     export type CustomElement = MigrationElementDef<'custom', string>;
     export type SubpagesElement = MigrationElementDef<'subpages', MigrationReference[]>;
 }
@@ -58,11 +56,10 @@ export type MigrationItemSystem<
 };
 export type MigrationUrlSlugMode = z.infer<typeof MigrationUrlSlugModeSchema>;
 export type MigrationElementType = z.infer<typeof MigrationElementTypeSchema>;
-export type MigrationUrlSlugElementValue = z.infer<typeof MigrationUrlSlugElementValueSchema>;
-export type MigrationRichTextElementValue = z.infer<typeof MigrationRichTextElementValueSchema>;
 export type MigrationComponent = z.infer<typeof MigrationComponentSchema>;
 export type MigrationElementValue = z.infer<typeof MigrationElementValueSchema>;
 export type MigrationElement = z.infer<typeof MigrationElementSchema>;
+export type MigrationElementTransformData = Omit<MigrationElement, 'type'>;
 export type MigrationElements = z.infer<typeof MigrationElementsSchema>;
 export type MigrationAssetDescription = z.infer<typeof MigrationAssetDescriptionSchema>;
 export type MigrationAsset = z.infer<typeof MigrationAssetSchema>;

package/lib/core/models/migration.schema.ts

@@ -1,3 +1,4 @@
+import { Buffer } from 'buffer';
 import { z } from 'zod';
 
 interface Elements {
@@ -5,12 +6,6 @@ interface Elements {
 }
 
 type UrlSlugMode = 'autogenerated' | 'custom';
-
-type UrlSlugElementValue = {
-    readonly value?: string;
-    readonly mode: UrlSlugMode;
-};
-
 type Reference = { readonly codename: string };
 
 type Component = {
@@ -21,16 +16,14 @@ type Component = {
     readonly elements: Elements;
 };
 
-type RichTextElementValue = {
-    readonly value: string;
-    readonly components: Readonly<Component[]>;
-};
-
-type ElementValue = string | undefined | number | Reference[] | RichTextElementValue | UrlSlugElementValue;
+type ElementValue = string | undefined | number | Reference[];
 
 type Element = {
     readonly type: ElementType;
     readonly value?: ElementValue;
+    readonly display_timezone?: string;
+    readonly components?: readonly Component[];
+    readonly mode?: UrlSlugMode;
 };
 
 type ElementType =
@@ -99,33 +92,15 @@ export const MigrationComponentSchema = z
     })
     .readonly();
 
-export const MigrationUrlSlugElementValueSchema = z
-    .strictObject({
-        value: z.optional(z.string()),
-        mode: MigrationUrlSlugModeSchema
-    })
-    .readonly();
-
-export const MigrationRichTextElementValueSchema = z
-    .strictObject({
-        value: z.string(),
-        components: z.array(MigrationComponentSchema).readonly()
-    })
-    .readonly();
-
-export const MigrationElementValueSchema = z.union([
-    z.string(),
-    z.undefined(),
-    z.number(),
-    z.array(MigrationReferenceSchema),
-    MigrationRichTextElementValueSchema,
-    MigrationUrlSlugElementValueSchema
-]);
+export const MigrationElementValueSchema = z.union([z.string(), z.undefined(), z.number(), z.array(MigrationReferenceSchema)]);
 
 export const MigrationElementSchema = z
     .strictObject({
         type: MigrationElementTypeSchema,
-        value: MigrationElementValueSchema
+        value: MigrationElementValueSchema,
+        display_timezone: z.string().optional(),
+        components: z.array(MigrationComponentSchema).readonly().optional(),
+        mode: MigrationUrlSlugModeSchema.optional()
     })
     .readonly();
 
@@ -170,7 +145,7 @@ const BaseMigrationAssetSchema = z.strictObject({
 });
 
 export const MigrationAssetSchema = BaseMigrationAssetSchema.extend({
-    binaryData: z.union([z.instanceof(Buffer), z.instanceof(Blob)])
+    binary_data: z.union([z.instanceof(Buffer), z.instanceof(Blob)])
 }).readonly();
 
 export const ZipMigrationAssetSchema = BaseMigrationAssetSchema.extend({

package/lib/core/utils/binary-data.utils.ts

@@ -1,3 +1,4 @@
+import { Buffer } from 'buffer';
 import { defaultHttpService, defaultRetryStrategy } from './http.utils.js';
 
 export async function getBinaryDataFromUrlAsync(url: string): Promise<{ data: Buffer | Blob; contentLength: number }> {

package/lib/export/export-manager.ts

@@ -1,29 +1,29 @@
-import { ExportContext, ExportConfig, ExportItem } from './export.models.js';
-import chalk from 'chalk';
 import { AssetFolderModels, AssetModels, CollectionModels, ElementModels } from '@kontent-ai/management-sdk';
+import chalk from 'chalk';
 import {
-    MigrationAsset,
-    MigrationItem,
-    FlattenedContentTypeElement,
     extractErrorData,
-    processItemsAsync,
-    getBinaryDataFromUrlAsync,
-    MigrationElements,
+    findRequired,
     FlattenedContentType,
-    MigrationComponent,
+    FlattenedContentTypeElement,
+    getBinaryDataFromUrlAsync,
     getDefaultLogger,
-    MigrationData,
-    isNotUndefined,
-    MigrationElementValue,
     getMigrationManagementClient,
-    findRequired,
-    Writeable,
-    MigrationItemsSchema,
+    isNotUndefined,
+    MigrationAsset,
     MigrationAssetsSchema,
-    MigrationItemVersion
+    MigrationComponent,
+    MigrationData,
+    MigrationElements,
+    MigrationElementTransformData,
+    MigrationItem,
+    MigrationItemsSchema,
+    MigrationItemVersion,
+    processItemsAsync,
+    Writeable
 } from '../core/index.js';
 import { exportTransforms } from '../translation/index.js';
 import { exportContextFetcherAsync } from './context/export-context-fetcher.js';
+import { ExportConfig, ExportContext, ExportItem } from './export.models.js';
 
 export function exportManager(config: ExportConfig) {
     const logger = config.logger ?? getDefaultLogger();
@@ -111,7 +111,7 @@ export function exportManager(config: ExportConfig) {
 
                 model[typeElement.codename] = {
                     type: typeElement.type,
-                    value: getValueToStoreFromElement({
+                    ...getMigrationElementToStore({
                         context: context,
                         contentType: contentType,
                         exportElement: itemElement,
@@ -123,12 +123,12 @@ export function exportManager(config: ExportConfig) {
             }, {});
     };
 
-    const getValueToStoreFromElement = (data: {
+    const getMigrationElementToStore = (data: {
         context: ExportContext;
         contentType: FlattenedContentType;
         typeElement: FlattenedContentTypeElement;
         exportElement: ElementModels.ContentItemElement;
-    }): MigrationElementValue => {
+    }): MigrationElementTransformData => {
         try {
             return exportTransforms[data.typeElement.type]({
                 context: data.context,
@@ -136,7 +136,8 @@ export function exportManager(config: ExportConfig) {
                 exportElement: {
                     components: data.exportElement.components.map((component) => mapToMigrationComponent(data.context, component)),
                     value: data.exportElement.value,
-                    urlSlugMode: data.exportElement.mode
+                    urlSlugMode: data.exportElement.mode,
+                    displayTimezone: data.exportElement.display_timezone
                 }
             });
         } catch (error) {
@@ -204,7 +205,7 @@ export function exportManager(config: ExportConfig) {
                     filename: asset.fileName,
                     title: asset.title ?? '',
                     codename: asset.codename,
-                    binaryData: binaryData.data,
+                    binary_data: binaryData.data,
                     collection: assetCollection ? { codename: assetCollection.codename } : undefined,
                     folder: assetFolder ? { codename: assetFolder.codename } : undefined,
                     descriptions: asset.descriptions.map((description) => {

package/lib/export/export.models.ts

@@ -1,26 +1,26 @@
 import {
-    Logger,
-    FlattenedContentType,
+    AssetFolderModels,
+    CollectionModels,
+    ContentItemModels,
+    LanguageModels,
+    LanguageVariantModels,
+    ManagementClient,
+    SharedModels,
+    TaxonomyModels,
+    WorkflowModels
+} from '@kontent-ai/management-sdk';
+import {
     AssetStateInSourceEnvironmentById,
+    FlattenedContentType,
     FlattenedContentTypeElement,
     ItemStateInSourceEnvironmentById,
-    ReferencedDataInLanguageVariants,
-    MigrationElementValue,
+    Logger,
+    ManagementClientConfig,
     MigrationComponent,
+    MigrationElementTransformData,
     MigrationUrlSlugMode,
-    ManagementClientConfig
+    ReferencedDataInLanguageVariants
 } from '../core/index.js';
-import {
-    LanguageVariantModels,
-    ContentItemModels,
-    WorkflowModels,
-    CollectionModels,
-    LanguageModels,
-    TaxonomyModels,
-    ManagementClient,
-    SharedModels,
-    AssetFolderModels
-} from '@kontent-ai/management-sdk';
 
 export interface ExportContextEnvironmentData {
     readonly languages: readonly Readonly<LanguageModels.LanguageModel>[];
@@ -37,13 +37,14 @@ export interface ExportElement {
     readonly value: ExportElementValue;
     readonly components: readonly MigrationComponent[];
     readonly urlSlugMode: MigrationUrlSlugMode | undefined;
+    readonly displayTimezone: string | undefined;
 }
 
 export type ExportTransformFunc = (data: {
     readonly typeElement: FlattenedContentTypeElement;
     readonly exportElement: ExportElement;
     readonly context: ExportContext;
-}) => MigrationElementValue;
+}) => MigrationElementTransformData;
 
 export interface ExportContext {
     readonly environmentData: ExportContextEnvironmentData;

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

@@ -1,6 +1,6 @@
 import { AssetFolderModels, AssetModels, CollectionModels, LanguageModels } from '@kontent-ai/management-sdk';
-import { MigrationAsset, MigrationAssetDescription, findRequired, geSizeInBytes } from '../../core/index.js';
 import deepEqual from 'deep-equal';
+import { MigrationAsset, MigrationAssetDescription, findRequired, geSizeInBytes } from '../../core/index.js';
 
 export function shouldUpdateAsset(data: {
     readonly migrationAsset: MigrationAsset;
@@ -29,7 +29,7 @@ function isBinaryFileIdentical(data: {
     readonly migrationAsset: MigrationAsset;
     readonly targetAsset: Readonly<AssetModels.Asset>;
 }): boolean {
-    const sourceFileSize = geSizeInBytes(data.migrationAsset.binaryData);
+    const sourceFileSize = geSizeInBytes(data.migrationAsset.binary_data);
     const targetFileSize = data.targetAsset.size;
 
     const sourceFilename = data.migrationAsset.filename;

package/lib/import/import.models.ts

@@ -1,19 +1,3 @@
-import {
-    MigrationItem,
-    MigrationAsset,
-    Logger,
-    AssetStateInTargetEnvironmentByCodename,
-    ItemStateInTargetEnvironmentByCodename,
-    ReferencedDataInMigrationItems,
-    LanguageVariantStateInTargetEnvironmentByCodename,
-    ExternalIdGenerator,
-    FlattenedContentTypeElement,
-    MigrationElementValue,
-    MigrationElementType,
-    MigrationData,
-    ManagementClientConfig,
-    FlattenedContentType
-} from '../core/index.js';
 import {
     AssetFolderModels,
     AssetModels,
@@ -25,6 +9,22 @@ import {
     ManagementClient,
     WorkflowModels
 } from '@kontent-ai/management-sdk';
+import {
+    AssetStateInTargetEnvironmentByCodename,
+    ExternalIdGenerator,
+    FlattenedContentType,
+    FlattenedContentTypeElement,
+    ItemStateInTargetEnvironmentByCodename,
+    LanguageVariantStateInTargetEnvironmentByCodename,
+    Logger,
+    ManagementClientConfig,
+    MigrationAsset,
+    MigrationData,
+    MigrationElementTransformData,
+    MigrationElementType,
+    MigrationItem,
+    ReferencedDataInMigrationItems
+} from '../core/index.js';
 
 export interface ImportContextConfig {
     readonly logger: Logger;
@@ -66,7 +66,7 @@ export interface ImportContext {
 }
 
 export type ImportTransformFunc = (data: {
-    readonly value: MigrationElementValue;
+    readonly elementData: MigrationElementTransformData;
     readonly elementCodename: string;
     readonly importContext: ImportContext;
     readonly migrationItems: readonly MigrationItem[];

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

@@ -1,19 +1,19 @@
-import { AssetModels, ManagementClient, SharedContracts } from '@kontent-ai/management-sdk';
+import { AssetModels, LanguageModels, ManagementClient, SharedContracts } from '@kontent-ai/management-sdk';
+import chalk from 'chalk';
+import mime from 'mime';
 import {
-    MigrationAsset,
+    geSizeInBytes,
+    isNotUndefined,
     Logger,
-    processItemsAsync,
-    runMapiRequestAsync,
+    LogSpinnerData,
+    MigrationAsset,
     MigrationAssetDescription,
     MigrationReference,
-    geSizeInBytes,
-    isNotUndefined,
-    LogSpinnerData
+    processItemsAsync,
+    runMapiRequestAsync
 } from '../../core/index.js';
-import mime from 'mime';
-import chalk from 'chalk';
-import { ImportContext, ImportResult } from '../import.models.js';
 import { shouldReplaceBinaryFile, shouldUpdateAsset } from '../comparers/asset-comparer.js';
+import { ImportContext, ImportResult } from '../import.models.js';
 
 interface AssetToEdit {
     migrationAsset: MigrationAsset;
@@ -27,9 +27,11 @@ export function assetsImporter(data: {
     readonly importContext: ImportContext;
 }) {
     const getAssetsToUpload = (): readonly MigrationAsset[] => {
-        return data.importContext.categorizedImportData.assets.filter((asset) => {
-            return data.importContext.getAssetStateInTargetEnvironment(asset.codename).state === 'doesNotExists';
-        });
+        return data.importContext.categorizedImportData.assets
+            .filter((asset) => {
+                return data.importContext.getAssetStateInTargetEnvironment(asset.codename).state === 'doesNotExists';
+            })
+            .map((asset) => ({ ...asset, descriptions: asset.descriptions?.filter(filterInvalidLanguages) }));
     };
 
     const getAssetsToEdit = (): readonly AssetToEdit[] => {
@@ -54,7 +56,10 @@ export function assetsImporter(data: {
                 }
 
                 return {
-                    migrationAsset: migrationAsset,
+                    migrationAsset: {
+                        ...migrationAsset,
+                        descriptions: migrationAsset.descriptions?.filter(filterInvalidLanguages)
+                    },
                     replaceBinaryFile: shouldReplaceBinaryFile({
                         migrationAsset: migrationAsset,
                         targetAsset: assetState.asset
@@ -117,6 +122,10 @@ export function assetsImporter(data: {
         });
     };
 
+    const filterInvalidLanguages = (description: MigrationAssetDescription): Readonly<LanguageModels.LanguageModel> | undefined => {
+        return data.importContext.environmentData.languages.find((lang) => lang.codename === description.language.codename);
+    };
+
     const mapAssetCollection = (
         migrationCollection: MigrationReference | undefined
     ): Readonly<AssetModels.IAssetCollectionReferenceObject> | undefined => {
@@ -165,8 +174,8 @@ export function assetsImporter(data: {
                     await data.client
                         .uploadBinaryFile()
                         .withData({
-                            binaryData: migrationAsset.binaryData,
-                            contentLength: geSizeInBytes(migrationAsset.binaryData),
+                            binaryData: migrationAsset.binary_data,
+                            contentLength: geSizeInBytes(migrationAsset.binary_data),
                             contentType: mime.getType(migrationAsset.filename) ?? '',
                             filename: migrationAsset.filename
                         })

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

@@ -1,24 +1,24 @@
-import { match } from 'ts-pattern';
 import { ContentItemModels, ElementContracts, LanguageVariantModels, ManagementClient, WorkflowModels } from '@kontent-ai/management-sdk';
+import chalk from 'chalk';
+import { match } from 'ts-pattern';
 import {
+    findRequired,
+    isNotUndefined,
+    LanguageVariantSchedulesStateValues,
+    LanguageVariantStateInTargetEnvironmentByCodename,
     Logger,
-    processItemsAsync,
-    runMapiRequestAsync,
-    MigrationItem,
     LogSpinnerData,
     MigrationElement,
+    MigrationItem,
     MigrationItemVersion,
-    workflowHelper,
-    findRequired,
-    isNotUndefined,
-    LanguageVariantSchedulesStateValues,
-    LanguageVariantStateInTargetEnvironmentByCodename
+    processItemsAsync,
+    runMapiRequestAsync,
+    workflowHelper
 } from '../../core/index.js';
-import chalk from 'chalk';
-import { ImportContext } from '../import.models.js';
 import { importTransforms } from '../../translation/index.js';
-import { workflowImporter as workflowImporterInit } from './workflow-importer.js';
+import { ImportContext } from '../import.models.js';
 import { throwErrorForMigrationItem } from '../utils/import.utils.js';
+import { workflowImporter as workflowImporterInit } from './workflow-importer.js';
 
 export function languageVariantImporter(config: {
     readonly logger: Logger;
@@ -290,7 +290,7 @@ export function languageVariantImporter(config: {
             elementCodename: elementCodename,
             importContext: config.importContext,
             migrationItems: config.importContext.categorizedImportData.contentItems,
-            value: element.value
+            elementData: element
         });
 
         return importTransformResult;

package/lib/metadata.ts

@@ -1,6 +1,6 @@
 
 export const libMetadata = {
 	name: '@kontent-ai/migration-toolkit',
-    timestamp: 'Thu, 15 Aug 2024 09:56:05 GMT',
-    version: '1.5.0'
+    timestamp: 'Thu, 03 Oct 2024 10:56:39 GMT',
+    version: '2.0.0'
 };

package/lib/toolkit/file.ts

@@ -1,7 +1,8 @@
+import { Buffer } from 'buffer';
+import { defaultZipFilename, executeWithTrackingAsync, getDefaultLogger, Logger, MigrationData } from '../core/index.js';
 import { fileManager } from '../file/index.js';
-import { Logger, executeWithTrackingAsync, defaultZipFilename, getDefaultLogger, MigrationData } from '../core/index.js';
-import { zipManager } from '../zip/index.js';
 import { libMetadata } from '../metadata.js';
+import { zipManager } from '../zip/index.js';
 
 export interface StoreConfig {
     readonly data: MigrationData;

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

@@ -1,15 +1,15 @@
-import { richTextProcessor } from '../index.js';
+import { ElementModels } from '@kontent-ai/management-sdk';
+import { GetFlattenedElementByIds } from 'lib/export/export.models.js';
+import { match, P } from 'ts-pattern';
 import {
     MigrationElementModels,
     MigrationElements,
+    parseAsMigrationReferencesArray,
     ReferencedDataInLanguageVariants,
-    ReferencedDataInMigrationItems,
-    parseAsMigrationReferencesArray
+    ReferencedDataInMigrationItems
 } from '../../core/index.js';
 import { GetFlattenedElementByCodenames } from '../../import/index.js';
-import { ElementModels } from '@kontent-ai/management-sdk';
-import { GetFlattenedElementByIds } from 'lib/export/export.models.js';
-import { match, P } from 'ts-pattern';
+import { richTextProcessor } from '../index.js';
 
 export interface ExtractItemById {
     readonly elements: Readonly<ElementModels.ContentItemElement>[];
@@ -59,6 +59,10 @@ export function itemsExtractionProcessor() {
                                 .processAssetIds(rteValue ?? '')
                                 .ids.forEach((id) => extractedIds.assetIds.add(id));
 
+                            richTextProcessor()
+                                .processLinkAssetIds(rteValue ?? '')
+                                .ids.forEach((id) => extractedIds.assetIds.add(id));
+
                             // recursively extract data from components as well because they may reference additional assets & content items
                             const extractedComponents = extractReferencedDataFromExtractItems(
                                 itemElement.components.map((component) => {
@@ -106,11 +110,10 @@ export function itemsExtractionProcessor() {
                 return Object.entries(item.elements).reduce<ReferencedDataInMigrationItemsLocal>(
                     (childExtractedCodenames, [elementCodename, element]) => {
                         const flattenedElement = getElement(item.contentTypeCodename, elementCodename, element.type);
-
                         match(flattenedElement.type)
                             .with('rich_text', () => {
                                 const richTextElementValue = element as MigrationElementModels.RichTextElement;
-                                const richTextHtml = richTextElementValue.value?.value ?? '';
+                                const richTextHtml = richTextElementValue?.value ?? '';
 
                                 // items
                                 richTextProcessor()
@@ -126,9 +129,13 @@ export function itemsExtractionProcessor() {
                                     .processAssetCodenames(richTextHtml)
                                     .codenames.forEach((codename) => childExtractedCodenames.assetCodenames.add(codename));
 
+                                richTextProcessor()
+                                    .processLinkAssetCodenames(richTextHtml)
+                                    .codenames.forEach((codename) => childExtractedCodenames.assetCodenames.add(codename));
+
                                 // recursively extract data from components as well because they may reference additional assets & content items
                                 const extractedComponents = extractReferencedItemsFromMigrationItems(
-                                    (richTextElementValue.value?.components ?? []).map((component) => {
+                                    (element.components ?? []).map((component) => {
                                         const extractionItem: ExtractItemByCodename = {
                                             contentTypeCodename: component.system.type.codename,
                                             elements: component.elements

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

@@ -126,6 +126,42 @@ export function richTextProcessor() {
         };
     };
 
+    const processLinkAssetIds = (richTextHtml: string, replaceFunc?: IdReplaceFunc): ProcessIdsResult => {
+        const assetIds = new Set<string>();
+
+        if (!richTextHtml) {
+            return {
+                html: richTextHtml,
+                ids: assetIds
+            };
+        }
+
+        richTextHtml = richTextHtml.replaceAll(rteRegexes.elements.linkTagRegex, (linkTag) => {
+            const assetIdMatch = linkTag.match(rteRegexes.ids.dataAssetIdAttrRegex);
+            if (assetIdMatch && (assetIdMatch?.length ?? 0) >= 2) {
+                const assetId = assetIdMatch[1];
+
+                assetIds.add(assetId);
+
+                if (replaceFunc) {
+                    const { codename } = replaceFunc(assetId);
+
+                    return linkTag.replaceAll(
+                        `${attributes.ids.assetIdAttributeName}="${assetId}"`,
+                        `${attributes.codenames.assetCodenameAttribute}="${codename}"`
+                    );
+                }
+            }
+
+            return linkTag;
+        });
+
+        return {
+            html: richTextHtml,
+            ids: assetIds
+        };
+    };
+
     const processLinkItemIds = (richTextHtml: string, replaceFunc?: IdReplaceFunc): ProcessIdsResult => {
         const linkItemIds = new Set<string>();
 
@@ -288,13 +324,57 @@ export function richTextProcessor() {
             html: richTextHtml
         };
     };
+    
+    const processLinkAssetCodenames = (
+        richTextHtml: string,
+        replaceFunc?: CodenameReplaceFunc<AssetStateInTargetEnvironmentByCodename>
+    ): ProcessCodenamesResult => {
+        const assetCodenames = new Set<string>();
+
+        if (!richTextHtml) {
+            return {
+                codenames: assetCodenames,
+                html: richTextHtml
+            };
+        }
+
+        richTextHtml = richTextHtml.replaceAll(rteRegexes.elements.linkTagRegex, (linkTag) => {
+            const codenameMatch = linkTag.match(rteRegexes.codenames.rteAssetCodenameRegex);
+            if (codenameMatch && (codenameMatch?.length ?? 0) >= 2) {
+                const codename = codenameMatch[1];
+
+                assetCodenames.add(codename);
+
+                if (replaceFunc) {
+                    const assetState = replaceFunc(codename);
+
+                    if (assetState.asset && assetState.state === 'exists') {
+                        return linkTag;
+                    }
+                    return linkTag.replaceAll(
+                        `${attributes.codenames.assetCodenameAttribute}="${codename}"`,
+                        `${attributes.ids.externalAssetIdAttributeName}="${assetState.externalIdToUse}"`
+                    );
+                }
+            }
+
+            return linkTag;
+        });
+
+        return {
+            codenames: assetCodenames,
+            html: richTextHtml
+        };
+    };
 
     return {
         processAssetIds,
         processDataIds,
         processLinkItemIds,
+        processLinkAssetIds,
         processAssetCodenames,
         processItemCodenames,
-        processLinkItemCodenames
+        processLinkItemCodenames,
+        processLinkAssetCodenames
     };
 }