@kontent-ai/migration-toolkit 1.0.0 → 1.1.0

package/dist/es2022/zip/zip-transformer.js

@@ -1,5 +1,5 @@
-import { getDefaultLogger, mapAsync } from '../core/index.js';
 import chalk from 'chalk';
+import { MigrationItemsSchema, ZipMigrationAssetsSchema, getDefaultLogger, mapAsync } from '../core/index.js';
 export function zipTransformer(zip, logger) {
     const loggerToUse = logger ?? getDefaultLogger();
     const filename = 'items.json';
@@ -37,15 +37,18 @@ export function zipTransformer(zip, logger) {
         zip.addFile(assetsFilename, JSON.stringify(assetRecords));
     };
     const parseItems = async () => {
-        const fileContent = await zip.getFileContentAsync(filename);
-        return fileContent ? JSON.parse(fileContent) : [];
+        const content = await zip.getFileContentAsync(filename);
+        if (!content) {
+            return [];
+        }
+        return MigrationItemsSchema.parse(JSON.parse(content));
     };
     const parseAssets = async () => {
-        const text = await zip.getFileContentAsync(assetsFilename);
-        if (!text) {
+        const content = await zip.getFileContentAsync(assetsFilename);
+        if (!content) {
             return [];
         }
-        const assetRecords = JSON.parse(text);
+        const assetRecords = ZipMigrationAssetsSchema.parse(JSON.parse(content));
         return await mapAsync(assetRecords, async (assetRecord) => {
             const binaryFile = await zip.getBinaryDataAsync(`${assetRecord._zipFilename}`);
             if (!binaryFile) {

package/dist/es2022/zip/zip-transformer.js.map

@@ -1 +1 @@
-{"version":3,"file":"zip-transformer.js","sourceRoot":"","sources":["../../../lib/zip/zip-transformer.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"zip-transformer.js","sourceRoot":"","sources":["../../../lib/zip/zip-transformer.ts"],"names":[],"mappings":"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"}

package/dist/es2022/zip/zip.models.d.ts

@@ -2,7 +2,7 @@ import { Logger } from '../core/index.js';
 export type FileBinaryData = Buffer | Blob;
 export type ZipCompressionLevel = 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9;
 export type ZipPackager = {
-    addFile(filePath: string, data: string | Blob | Buffer): void;
+    addFile(filePath: string, data: string | FileBinaryData): void;
     addFolder(name: string): ZipPackager;
     generateZipAsync(config: {
         logger?: Logger;

package/lib/core/index.ts

@@ -12,6 +12,7 @@ export * from './utils/management-client-utils.js';
 export * from './models/log.models.js';
 export * from './models/core.models.js';
 export * from './models/migration.models.js';
+export * from './models/migration.schema.js';
 
 export * from './logs/loggers.js';
 export * from './helpers/workflow-helper.js';

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

@@ -1,165 +1,62 @@
-export type MigrationElementType =
-    | 'text'
-    | 'rich_text'
-    | 'number'
-    | 'multiple_choice'
-    | 'date_time'
-    | 'asset'
-    | 'modular_content'
-    | 'taxonomy'
-    | 'url_slug'
-    | 'custom'
-    | 'subpages';
-
-export type MigrationUrlSlugMode = 'autogenerated' | 'custom';
-
-export interface MigrationRichTextElementValue {
-    value: string;
-    components: readonly MigrationComponent[];
-}
-
-export interface MigrationUrlSlugElementValue {
-    value: string | undefined;
-    mode: MigrationUrlSlugMode;
-}
-
-export interface MigrationComponent {
-    system: {
-        id: string;
-        type: MigrationReference;
-    };
-    elements: MigrationElements;
-}
-
-export type MigrationElementValue =
-    | string
-    | undefined
-    | MigrationReference[]
-    | number
-    | MigrationRichTextElementValue
-    | MigrationUrlSlugElementValue;
-
-export interface MigrationElement<
-    TElementType extends MigrationElementType = MigrationElementType,
-    TValue extends MigrationElementValue = MigrationElementValue
-> {
-    /**
-     * Value of the element
-     */
-    readonly value: TValue;
-
-    /**
-     * Type of the element
-     */
-    readonly type: TElementType;
-}
+import { z } from 'zod';
+import {
+    MigrationComponentSchema,
+    MigrationElementTypeSchema,
+    MigrationElementValueSchema,
+    MigrationReferenceSchema,
+    MigrationUrlSlugElementValueSchema,
+    MigrationUrlSlugModeSchema,
+    MigrationRichTextElementValueSchema,
+    MigrationElementSchema,
+    MigrationElementsSchema,
+    MigrationAssetDescriptionSchema,
+    MigrationDataSchema,
+    MigrationAssetSchema,
+    BaseMigrationItemSchema,
+    BaseMigrationItemVersionSchema
+} from './migration.schema.js';
 
 export namespace MigrationElementModels {
-    export interface TextElement extends MigrationElement<'text', string | undefined> {}
-    export interface NumberElement extends MigrationElement<'number', number | undefined> {}
-    export interface RichTextElement extends MigrationElement<'rich_text', MigrationRichTextElementValue | undefined> {}
-    export interface MultipleChoiceElement
-        extends MigrationElement<'multiple_choice', MigrationReference[] | undefined> {}
-    export interface DateTimeElement extends MigrationElement<'date_time', string | undefined> {}
-    export interface AssetElement extends MigrationElement<'asset', MigrationReference[] | undefined> {}
-    export interface LinkedItemsElement extends MigrationElement<'modular_content', MigrationReference[] | undefined> {}
-    export interface TaxonomyElement extends MigrationElement<'taxonomy', MigrationReference[] | undefined> {}
-    export interface UrlSlugElement extends MigrationElement<'url_slug', MigrationUrlSlugElementValue | undefined> {}
-    export interface CustomElement extends MigrationElement<'custom', string | undefined> {}
-    export interface SubpagesElement extends MigrationElement<'subpages', MigrationReference[] | undefined> {}
-}
-
-export interface MigrationElements {
-    [elementCodename: string]: MigrationElement;
-}
+    type MigrationElementDef<
+        TElementType extends MigrationElementType = MigrationElementType,
+        TValue extends MigrationElementValue = MigrationElementValue
+    > = {
+        readonly value: TValue;
+        readonly type: TElementType;
+    };
 
-export interface MigrationItemVersion<TElements extends MigrationElements = MigrationElements> {
+    export type TextElement = MigrationElementDef<'text', string | undefined>;
+    export type NumberElement = MigrationElementDef<'number', number | undefined>;
+    export type RichTextElement = MigrationElementDef<'rich_text', MigrationRichTextElementValue | undefined>;
+    export type MultipleChoiceElement = MigrationElementDef<'multiple_choice', MigrationReference[] | undefined>;
+    export type DateTimeElement = MigrationElementDef<'date_time', string | undefined>;
+    export type AssetElement = MigrationElementDef<'asset', MigrationReference[] | undefined>;
+    export type LinkedItemsElement = MigrationElementDef<'modular_content', MigrationReference[] | undefined>;
+    export type TaxonomyElement = MigrationElementDef<'taxonomy', MigrationReference[] | undefined>;
+    export type UrlSlugElement = MigrationElementDef<'url_slug', MigrationUrlSlugElementValue | undefined>;
+    export type CustomElement = MigrationElementDef<'custom', string | undefined>;
+    export type SubpagesElement = MigrationElementDef<'subpages', MigrationReference[] | undefined>;
+}
+
+export type MigrationReference = z.infer<typeof MigrationReferenceSchema>;
+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 MigrationElements = z.infer<typeof MigrationElementsSchema>;
+export type MigrationAssetDescription = z.infer<typeof MigrationAssetDescriptionSchema>;
+export type MigrationAsset = z.infer<typeof MigrationAssetSchema>;
+export type MigrationData = z.infer<typeof MigrationDataSchema>;
+
+export type MigrationItemVersion<TElements extends MigrationElements = MigrationElements> = z.infer<
+    typeof BaseMigrationItemVersionSchema
+> & {
     readonly elements: TElements;
-    readonly workflow_step: MigrationReference;
-}
-
-export interface MigrationItem<TElements extends MigrationElements = MigrationElements> {
-    readonly system: {
-        /**
-         * Codename of the content item
-         */
-        readonly codename: string;
-        /**
-         * Name of the content item
-         */
-        readonly name: string;
-        /**
-         * Language of the language variant
-         */
-        readonly language: MigrationReference;
-        /**
-         * Content type of the item
-         */
-        readonly type: MigrationReference;
-        /**
-         * Collection of the item
-         */
-        readonly collection: MigrationReference;
+};
 
-        /**
-         * Workflow of the item
-         */
-        readonly workflow: MigrationReference;
-    };
+export type MigrationItem<TElements extends MigrationElements = MigrationElements> = z.infer<typeof BaseMigrationItemSchema> & {
     readonly versions: MigrationItemVersion<TElements>[];
-}
-
-export interface MigrationReference {
-    /**
-     * Codename of the referenced object
-     */
-    readonly codename: string;
-}
-
-export interface MigrationAssetDescription {
-    readonly language: MigrationReference;
-    readonly description?: string;
-}
-
-export interface MigrationAsset {
-    /**
-     * Codename of the asset
-     */
-    readonly codename: string;
-    /**
-     * Binary data of the asset
-     */
-    readonly binaryData: Buffer | Blob;
-    /**
-     * Filename of the asset, will be used as a filename in Kontent.ai after importing the asset
-     */
-    readonly filename: string;
-    /**
-     * Title of the asset
-     */
-    readonly title: string;
-
-    /**
-     * Optional
-     * Collection of the asset
-     */
-    readonly collection?: MigrationReference;
-
-    /**
-     * Optional.
-     * Descriptions of the assets
-     */
-    readonly descriptions?: readonly MigrationAssetDescription[];
-}
-
-export interface MigrationData {
-    /**
-     * Array of migration items to process (export / import)
-     */
-    readonly items: readonly MigrationItem[];
-
-    /**
-     * Array of migration assets to process
-     */
-    readonly assets: readonly MigrationAsset[];
-}
+};

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

@@ -0,0 +1,180 @@
+import { z } from 'zod';
+
+interface Elements {
+    readonly [key: string]: Element;
+}
+
+type UrlSlugMode = 'autogenerated' | 'custom';
+
+type UrlSlugElementValue = {
+    readonly value?: string;
+    readonly mode: UrlSlugMode;
+};
+
+type Reference = { readonly codename: string };
+
+type Component = {
+    readonly system: {
+        readonly id: string;
+        readonly type: Reference;
+    };
+    readonly elements: Elements;
+};
+
+type RichTextElementValue = {
+    readonly value: string;
+    readonly components: Readonly<Component[]>;
+};
+
+type ElementValue = string | undefined | number | Reference[] | RichTextElementValue | UrlSlugElementValue;
+
+type Element = {
+    readonly type: ElementType;
+    readonly value?: ElementValue;
+};
+
+type ElementType =
+    | 'text'
+    | 'rich_text'
+    | 'number'
+    | 'multiple_choice'
+    | 'date_time'
+    | 'asset'
+    | 'modular_content'
+    | 'taxonomy'
+    | 'url_slug'
+    | 'custom'
+    | 'subpages';
+
+export const MigrationUrlSlugModeSchema = z.enum(['autogenerated', 'custom']).readonly();
+export const MigrationElementTypeSchema = z
+    .enum([
+        'text',
+        'rich_text',
+        'number',
+        'multiple_choice',
+        'date_time',
+        'asset',
+        'modular_content',
+        'taxonomy',
+        'url_slug',
+        'custom',
+        'subpages'
+    ])
+    .readonly();
+
+export const MigrationReferenceSchema = z
+    .strictObject({
+        codename: z.string().readonly()
+    })
+    .readonly();
+
+/**
+ * ZodType is needed to be specified here due to the use of 'lazy' & circular dependency between types
+ * Otherwise TS has no way of statically inferring the type
+ */
+export const MigrationElementsSchema: z.ZodReadonly<z.ZodType<Elements>> = z
+    .record(
+        z.string(),
+        z.lazy(() => MigrationElementSchema)
+    )
+    .readonly();
+
+export const MigrationComponentSchema = z
+    .strictObject({
+        system: z.strictObject({
+            id: z.string(),
+            type: MigrationReferenceSchema
+        }),
+        elements: MigrationElementsSchema
+    })
+    .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 MigrationElementSchema = z
+    .strictObject({
+        type: MigrationElementTypeSchema,
+        value: MigrationElementValueSchema
+    })
+    .readonly();
+
+export const BaseMigrationItemVersionSchema = z.strictObject({
+    workflow_step: MigrationReferenceSchema
+});
+
+export const MigrationItemVersionSchema = BaseMigrationItemVersionSchema.extend({
+    elements: MigrationElementsSchema
+}).readonly();
+
+export const BaseMigrationItemSchema = z.strictObject({
+    system: z
+        .strictObject({
+            codename: z.string(),
+            name: z.string(),
+            language: MigrationReferenceSchema,
+            type: MigrationReferenceSchema,
+            collection: MigrationReferenceSchema,
+            workflow: MigrationReferenceSchema
+        })
+        .readonly()
+});
+
+export const MigrationItemSchema = BaseMigrationItemSchema.extend({
+    versions: z.array(MigrationItemVersionSchema)
+}).readonly();
+
+export const MigrationAssetDescriptionSchema = z
+    .strictObject({
+        language: MigrationReferenceSchema,
+        description: z.optional(z.string())
+    })
+    .readonly();
+
+const BaseMigrationAssetSchema = z.strictObject({
+    codename: z.string(),
+    filename: z.string(),
+    title: z.string(),
+    collection: z.optional(MigrationReferenceSchema),
+    descriptions: z.optional(z.array(MigrationAssetDescriptionSchema)).readonly()
+});
+
+export const MigrationAssetSchema = BaseMigrationAssetSchema.extend({
+    binaryData: z.union([z.instanceof(Buffer), z.instanceof(Blob)])
+}).readonly();
+
+export const ZipMigrationAssetSchema = BaseMigrationAssetSchema.extend({
+    _zipFilename: z.string()
+}).readonly();
+
+export const MigrationAssetsSchema = z.array(MigrationAssetSchema).readonly();
+export const ZipMigrationAssetsSchema = z.array(ZipMigrationAssetSchema).readonly();
+export const MigrationItemsSchema = z.array(MigrationItemSchema).readonly();
+
+export const MigrationDataSchema = z
+    .strictObject({
+        items: MigrationItemsSchema,
+        assets: MigrationAssetsSchema
+    })
+    .readonly();

package/lib/core/utils/confirm.utils.ts

@@ -23,7 +23,7 @@ export async function confirmExportAsync(data: {
         data.dataToExport.itemsCount
     )}' content ${getItemsPluralText(data.dataToExport.itemsCount)} from ${chalk.yellow(
         environment.name
-    )} (${chalk.yellow(environment.environment)}?`;
+    )} (${chalk.magenta(environment.environment)})?`;
 
     await confirmAsync({
         force: data.force,
@@ -65,9 +65,9 @@ export async function confirmMigrateAsync(data: {
 
     const text: string = `Are you sure to migrate '${chalk.cyan(data.dataToMigrate.itemsCount)}' ${getItemsPluralText(
         data.dataToMigrate.itemsCount
-    )} from ${chalk.yellow(sourceEnvironment.name)} (${chalk.yellow(
+    )} from ${chalk.yellow(sourceEnvironment.name)} (${chalk.magenta(
         sourceEnvironment.environment
-    )}) to environment ${chalk.yellow(targetEnvironment.name)} (${chalk.yellow(targetEnvironment.environment)}) ?`;
+    )}) to environment ${chalk.yellow(targetEnvironment.name)} (${chalk.magenta(targetEnvironment.environment)}) ?`;
 
     await confirmAsync({
         force: data.force,
@@ -91,7 +91,7 @@ export async function confirmImportAsync(data: {
         data.logger
     ).getEnvironmentAsync();
 
-    const text: string = `Are you sure to import data into ${chalk.yellow(environment.name)} (${chalk.yellow(
+    const text: string = `Are you sure to import data into ${chalk.yellow(environment.name)} (${chalk.magenta(
         environment.environment
     )})?`;
 

package/lib/core/utils/error.utils.ts

@@ -1,6 +1,7 @@
 import { SharedModels } from '@kontent-ai/management-sdk';
 import chalk from 'chalk';
 import { ErrorData, OriginalManagementError } from '../models/core.models.js';
+import { ZodError } from 'zod';
 
 export function extractErrorData(error: unknown): ErrorData {
     let isUnknownError: boolean = true;
@@ -10,15 +11,17 @@ export function extractErrorData(error: unknown): ErrorData {
 
     if (error instanceof SharedModels.ContentManagementBaseKontentError) {
         isUnknownError = false;
-        message = `${error.message}`;
-
-        const originalError: OriginalManagementError | undefined = error.originalError as
-            | OriginalManagementError
-            | undefined;
+        const originalError = error.originalError as OriginalManagementError | undefined;
 
         requestUrl = originalError?.response?.config?.url;
         requestData = originalError?.response?.config?.data;
-        message += error.validationErrors.map((m) => m.message).join(', ');
+
+        message = `${error.message}: ${error.validationErrors.map((m) => m.message).join(', ')}`;
+    } else if (error instanceof ZodError) {
+        isUnknownError = false;
+        message = `Found '${chalk.red(error.issues.length)}' parsing errors: \n${error.issues.reduce<string>((current, issue, index) => {
+            return (current += `\n${index + 1}. ${chalk.red(issue.message)} (${chalk.yellow('path')}: ${issue.path.join(',')})`);
+        }, '')}`;
     } else if (error instanceof Error) {
         message = error.message;
     }

package/lib/core/utils/global.utils.ts

@@ -3,6 +3,8 @@ import { ITrackingEventData, getTrackingService } from '@kontent-ai-consulting/t
 import { isBrowser, isNode, isWebWorker } from 'browser-or-node';
 import { EnvContext } from '../models/core.models.js';
 
+export type Writeable<T> = { -readonly [P in keyof T]: T[P] };
+
 export const isNotUndefined = <T>(item: T | undefined): item is T => item !== undefined;
 
 export function formatBytes(bytes: number): string {
@@ -28,9 +30,7 @@ export function getCurrentEnvironment(): EnvContext {
     throw Error(`Invalid current environment. This library can be used in node.js or in browsers.`);
 }
 
-export function getDefaultZipFilename(): string {
-    return `data.zip`;
-}
+export const defaultZipFilename: string = 'data.zip';
 
 export async function executeWithTrackingAsync<TResult>(data: {
     func: () => Promise<TResult extends void ? void : Readonly<TResult>>;

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

@@ -62,10 +62,11 @@ export async function exportContextFetcherAsync(config: DefaultExportContextConf
         return await runMapiRequestAsync({
             logger: config.logger,
             logSpinner: logSpinner,
-            func: async () =>
-                (
+            func: async () => {
+                return (
                     await config.managementClient.viewContentItem().byItemCodename(sourceItem.itemCodename).toPromise()
-                ).data,
+                ).data;
+            },
             action: 'view',
             type: 'contentItem',
             itemName: `codename -> ${sourceItem.itemCodename}`
@@ -79,14 +80,16 @@ export async function exportContextFetcherAsync(config: DefaultExportContextConf
         return await runMapiRequestAsync({
             logger: config.logger,
             logSpinner: logSpinner,
-            func: async () =>
-                (
+            func: async () => {
+                return (
                     await config.managementClient
                         .viewLanguageVariant()
                         .byItemCodename(sourceItem.itemCodename)
                         .byLanguageCodename(sourceItem.languageCodename)
                         .toPromise()
-                ).data,
+                ).data;
+            },
+
             action: 'view',
             type: 'languageVariant',
             itemName: `codename -> ${sourceItem.itemCodename} -> latest (${sourceItem.languageCodename})`