@kontent-ai/migration-toolkit 2.9.1 → 3.0.0-1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (239) hide show
  1. package/README.md +19 -17
  2. package/dist/core/config.js +3 -3
  3. package/dist/core/config.js.map +1 -1
  4. package/dist/core/helpers/workflow-helper.d.ts +1 -1
  5. package/dist/core/helpers/workflow-helper.js +28 -26
  6. package/dist/core/helpers/workflow-helper.js.map +1 -1
  7. package/dist/core/logs/loggers.d.ts +1 -1
  8. package/dist/core/logs/loggers.js +15 -15
  9. package/dist/core/logs/loggers.js.map +1 -1
  10. package/dist/core/models/core.models.d.ts +29 -22
  11. package/dist/core/models/error.models.d.ts +26 -0
  12. package/dist/core/models/error.models.js +104 -0
  13. package/dist/core/models/error.models.js.map +1 -0
  14. package/dist/core/models/log.models.d.ts +2 -2
  15. package/dist/core/models/migration.models.d.ts +17 -19
  16. package/dist/core/models/migration.schema.d.ts +9 -9
  17. package/dist/core/models/migration.schema.js +28 -28
  18. package/dist/core/models/migration.schema.js.map +1 -1
  19. package/dist/core/utils/array.utils.d.ts +1 -1
  20. package/dist/core/utils/array.utils.js +4 -3
  21. package/dist/core/utils/array.utils.js.map +1 -1
  22. package/dist/core/utils/binary-data.utils.d.ts +1 -1
  23. package/dist/core/utils/binary-data.utils.js +6 -6
  24. package/dist/core/utils/binary-data.utils.js.map +1 -1
  25. package/dist/core/utils/confirm.utils.d.ts +3 -1
  26. package/dist/core/utils/confirm.utils.js +92 -24
  27. package/dist/core/utils/confirm.utils.js.map +1 -1
  28. package/dist/core/utils/error.utils.d.ts +1 -1
  29. package/dist/core/utils/error.utils.js +16 -14
  30. package/dist/core/utils/error.utils.js.map +1 -1
  31. package/dist/core/utils/external-id.utils.js +1 -1
  32. package/dist/core/utils/external-id.utils.js.map +1 -1
  33. package/dist/core/utils/global.utils.d.ts +3 -3
  34. package/dist/core/utils/global.utils.js +20 -18
  35. package/dist/core/utils/global.utils.js.map +1 -1
  36. package/dist/core/utils/http.utils.d.ts +2 -2
  37. package/dist/core/utils/http.utils.js +4 -4
  38. package/dist/core/utils/http.utils.js.map +1 -1
  39. package/dist/core/utils/management-client-utils.d.ts +4 -4
  40. package/dist/core/utils/management-client-utils.js +37 -34
  41. package/dist/core/utils/management-client-utils.js.map +1 -1
  42. package/dist/core/utils/processing-utils.d.ts +4 -4
  43. package/dist/core/utils/processing-utils.js +13 -13
  44. package/dist/core/utils/processing-utils.js.map +1 -1
  45. package/dist/core/utils/run.utils.d.ts +2 -2
  46. package/dist/core/utils/run.utils.js +7 -7
  47. package/dist/core/utils/run.utils.js.map +1 -1
  48. package/dist/core/utils/try.utils.d.ts +14 -0
  49. package/dist/core/utils/try.utils.js +18 -0
  50. package/dist/core/utils/try.utils.js.map +1 -0
  51. package/dist/export/context/export-context-fetcher.d.ts +1 -1
  52. package/dist/export/context/export-context-fetcher.js +92 -62
  53. package/dist/export/context/export-context-fetcher.js.map +1 -1
  54. package/dist/export/export-manager.d.ts +2 -2
  55. package/dist/export/export-manager.js +73 -59
  56. package/dist/export/export-manager.js.map +1 -1
  57. package/dist/export/export.models.d.ts +21 -2
  58. package/dist/export/utils/export.utils.d.ts +1 -1
  59. package/dist/export/utils/export.utils.js +3 -2
  60. package/dist/export/utils/export.utils.js.map +1 -1
  61. package/dist/file/file-manager.d.ts +2 -2
  62. package/dist/file/file-manager.js +7 -7
  63. package/dist/file/file-manager.js.map +1 -1
  64. package/dist/import/comparers/asset-comparer.d.ts +2 -2
  65. package/dist/import/comparers/asset-comparer.js +12 -11
  66. package/dist/import/comparers/asset-comparer.js.map +1 -1
  67. package/dist/import/context/import-context-fetcher.d.ts +1 -1
  68. package/dist/import/context/import-context-fetcher.js +77 -73
  69. package/dist/import/context/import-context-fetcher.js.map +1 -1
  70. package/dist/import/import-manager.d.ts +1 -1
  71. package/dist/import/import-manager.js +59 -56
  72. package/dist/import/import-manager.js.map +1 -1
  73. package/dist/import/import.models.d.ts +6 -2
  74. package/dist/import/importers/assets-importer.d.ts +3 -3
  75. package/dist/import/importers/assets-importer.js +46 -43
  76. package/dist/import/importers/assets-importer.js.map +1 -1
  77. package/dist/import/importers/content-items-importer.d.ts +3 -3
  78. package/dist/import/importers/content-items-importer.js +28 -25
  79. package/dist/import/importers/content-items-importer.js.map +1 -1
  80. package/dist/import/importers/language-variant-importer.d.ts +3 -3
  81. package/dist/import/importers/language-variant-importer.js +45 -45
  82. package/dist/import/importers/language-variant-importer.js.map +1 -1
  83. package/dist/import/importers/workflow-importer.d.ts +3 -2
  84. package/dist/import/importers/workflow-importer.js +58 -54
  85. package/dist/import/importers/workflow-importer.js.map +1 -1
  86. package/dist/import/utils/import.utils.d.ts +1 -1
  87. package/dist/import/utils/import.utils.js +3 -2
  88. package/dist/import/utils/import.utils.js.map +1 -1
  89. package/dist/index.d.ts +11 -7
  90. package/dist/index.js +10 -8
  91. package/dist/index.js.map +1 -1
  92. package/dist/metadata.js +3 -3
  93. package/dist/metadata.js.map +1 -1
  94. package/dist/node/cli/actions/export-action.d.ts +1 -1
  95. package/dist/node/cli/actions/export-action.js +29 -23
  96. package/dist/node/cli/actions/export-action.js.map +1 -1
  97. package/dist/node/cli/actions/import-action.d.ts +1 -1
  98. package/dist/node/cli/actions/import-action.js +15 -12
  99. package/dist/node/cli/actions/import-action.js.map +1 -1
  100. package/dist/node/cli/actions/migrate-action.d.ts +1 -1
  101. package/dist/node/cli/actions/migrate-action.js +26 -22
  102. package/dist/node/cli/actions/migrate-action.js.map +1 -1
  103. package/dist/node/cli/app.js +13 -12
  104. package/dist/node/cli/app.js.map +1 -1
  105. package/dist/node/cli/args/args-fetcher.d.ts +1 -1
  106. package/dist/node/cli/args/args-fetcher.js +14 -13
  107. package/dist/node/cli/args/args-fetcher.js.map +1 -1
  108. package/dist/node/cli/args/args-setter.d.ts +1 -1
  109. package/dist/node/cli/args/args-setter.js +8 -6
  110. package/dist/node/cli/args/args-setter.js.map +1 -1
  111. package/dist/node/cli/cli.models.d.ts +2 -2
  112. package/dist/node/cli/commands.js +68 -56
  113. package/dist/node/cli/commands.js.map +1 -1
  114. package/dist/toolkit/elements-builder.d.ts +1 -1
  115. package/dist/toolkit/elements-builder.js +12 -12
  116. package/dist/toolkit/elements-builder.js.map +1 -1
  117. package/dist/toolkit/export.d.ts +2 -2
  118. package/dist/toolkit/export.js +8 -8
  119. package/dist/toolkit/export.js.map +1 -1
  120. package/dist/toolkit/file.d.ts +2 -1
  121. package/dist/toolkit/file.js +18 -16
  122. package/dist/toolkit/file.js.map +1 -1
  123. package/dist/toolkit/import.d.ts +1 -1
  124. package/dist/toolkit/import.js +12 -12
  125. package/dist/toolkit/import.js.map +1 -1
  126. package/dist/toolkit/migrate.d.ts +13 -4
  127. package/dist/toolkit/migrate.js +15 -13
  128. package/dist/toolkit/migrate.js.map +1 -1
  129. package/dist/translation/extraction/items-extraction.processor.d.ts +5 -4
  130. package/dist/translation/extraction/items-extraction.processor.js +73 -35
  131. package/dist/translation/extraction/items-extraction.processor.js.map +1 -1
  132. package/dist/translation/helpers/export-placeholder.utils.d.ts +11 -0
  133. package/dist/translation/helpers/export-placeholder.utils.js +11 -0
  134. package/dist/translation/helpers/export-placeholder.utils.js.map +1 -0
  135. package/dist/translation/helpers/rich-text.processor.d.ts +6 -6
  136. package/dist/translation/helpers/rich-text.processor.js +38 -38
  137. package/dist/translation/helpers/rich-text.processor.js.map +1 -1
  138. package/dist/translation/transforms/export-transforms.d.ts +2 -2
  139. package/dist/translation/transforms/export-transforms.js +93 -67
  140. package/dist/translation/transforms/export-transforms.js.map +1 -1
  141. package/dist/translation/transforms/import-transforms.d.ts +2 -2
  142. package/dist/translation/transforms/import-transforms.js +38 -40
  143. package/dist/translation/transforms/import-transforms.js.map +1 -1
  144. package/dist/zip/zip-manager.d.ts +4 -3
  145. package/dist/zip/zip-manager.js +9 -9
  146. package/dist/zip/zip-manager.js.map +1 -1
  147. package/dist/zip/zip-packager.d.ts +2 -2
  148. package/dist/zip/zip-packager.js +19 -17
  149. package/dist/zip/zip-packager.js.map +1 -1
  150. package/dist/zip/zip-transformer.d.ts +3 -2
  151. package/dist/zip/zip-transformer.js +16 -15
  152. package/dist/zip/zip-transformer.js.map +1 -1
  153. package/dist/zip/zip.models.d.ts +2 -2
  154. package/lib/core/config.ts +6 -6
  155. package/lib/core/helpers/workflow-helper.ts +190 -185
  156. package/lib/core/logs/loggers.ts +52 -52
  157. package/lib/core/models/core.models.ts +130 -119
  158. package/lib/core/models/error.models.ts +148 -0
  159. package/lib/core/models/log.models.ts +20 -20
  160. package/lib/core/models/migration.models.ts +54 -57
  161. package/lib/core/models/migration.schema.ts +108 -108
  162. package/lib/core/utils/array.utils.ts +43 -42
  163. package/lib/core/utils/binary-data.utils.ts +16 -16
  164. package/lib/core/utils/confirm.utils.ts +184 -106
  165. package/lib/core/utils/error.utils.ts +69 -72
  166. package/lib/core/utils/external-id.utils.ts +4 -4
  167. package/lib/core/utils/global.utils.ts +81 -75
  168. package/lib/core/utils/http.utils.ts +23 -23
  169. package/lib/core/utils/management-client-utils.ts +189 -186
  170. package/lib/core/utils/processing-utils.ts +82 -82
  171. package/lib/core/utils/run.utils.ts +50 -50
  172. package/lib/core/utils/try.utils.ts +30 -0
  173. package/lib/export/context/export-context-fetcher.ts +472 -447
  174. package/lib/export/export-manager.ts +250 -232
  175. package/lib/export/export.models.ts +71 -56
  176. package/lib/export/utils/export.utils.ts +9 -7
  177. package/lib/file/file-manager.ts +28 -28
  178. package/lib/import/comparers/asset-comparer.ts +107 -106
  179. package/lib/import/context/import-context-fetcher.ts +462 -462
  180. package/lib/import/import-manager.ts +243 -240
  181. package/lib/import/import.models.ts +69 -67
  182. package/lib/import/importers/assets-importer.ts +240 -236
  183. package/lib/import/importers/content-items-importer.ts +126 -122
  184. package/lib/import/importers/language-variant-importer.ts +324 -328
  185. package/lib/import/importers/workflow-importer.ts +372 -367
  186. package/lib/import/utils/import.utils.ts +9 -7
  187. package/lib/index.ts +12 -8
  188. package/lib/metadata.ts +3 -4
  189. package/lib/node/cli/actions/export-action.ts +44 -38
  190. package/lib/node/cli/actions/import-action.ts +32 -29
  191. package/lib/node/cli/actions/migrate-action.ts +50 -46
  192. package/lib/node/cli/app.ts +21 -21
  193. package/lib/node/cli/args/args-fetcher.ts +55 -54
  194. package/lib/node/cli/args/args-setter.ts +34 -32
  195. package/lib/node/cli/cli.models.ts +17 -17
  196. package/lib/node/cli/commands.ts +165 -153
  197. package/lib/toolkit/elements-builder.ts +69 -69
  198. package/lib/toolkit/export.ts +21 -21
  199. package/lib/toolkit/file.ts +59 -53
  200. package/lib/toolkit/import.ts +32 -32
  201. package/lib/toolkit/migrate.ts +60 -49
  202. package/lib/translation/extraction/items-extraction.processor.ts +203 -173
  203. package/lib/translation/helpers/export-placeholder.utils.ts +10 -0
  204. package/lib/translation/helpers/rich-text.processor.ts +311 -311
  205. package/lib/translation/transforms/export-transforms.ts +313 -279
  206. package/lib/translation/transforms/import-transforms.ts +188 -191
  207. package/lib/zip/zip-manager.ts +28 -27
  208. package/lib/zip/zip-packager.ts +75 -73
  209. package/lib/zip/zip-transformer.ts +112 -107
  210. package/lib/zip/zip.models.ts +7 -7
  211. package/package.json +91 -84
  212. package/dist/core/index.d.ts +0 -16
  213. package/dist/core/index.js +0 -17
  214. package/dist/core/index.js.map +0 -1
  215. package/dist/export/index.d.ts +0 -2
  216. package/dist/export/index.js +0 -3
  217. package/dist/export/index.js.map +0 -1
  218. package/dist/file/index.d.ts +0 -1
  219. package/dist/file/index.js +0 -2
  220. package/dist/file/index.js.map +0 -1
  221. package/dist/import/index.d.ts +0 -2
  222. package/dist/import/index.js +0 -3
  223. package/dist/import/index.js.map +0 -1
  224. package/dist/toolkit/index.d.ts +0 -5
  225. package/dist/toolkit/index.js +0 -6
  226. package/dist/toolkit/index.js.map +0 -1
  227. package/dist/translation/index.d.ts +0 -4
  228. package/dist/translation/index.js +0 -5
  229. package/dist/translation/index.js.map +0 -1
  230. package/dist/zip/index.d.ts +0 -4
  231. package/dist/zip/index.js +0 -5
  232. package/dist/zip/index.js.map +0 -1
  233. package/lib/core/index.ts +0 -18
  234. package/lib/export/index.ts +0 -2
  235. package/lib/file/index.ts +0 -1
  236. package/lib/import/index.ts +0 -2
  237. package/lib/toolkit/index.ts +0 -5
  238. package/lib/translation/index.ts +0 -4
  239. package/lib/zip/index.ts +0 -4
@@ -1,102 +1,104 @@
1
1
  import type {
2
- AssetFolderModels,
3
- AssetModels,
4
- CollectionModels,
5
- ContentItemModels,
6
- LanguageModels,
7
- LanguageVariantElements,
8
- LanguageVariantModels,
9
- ManagementClient,
10
- WorkflowModels
11
- } from '@kontent-ai/management-sdk';
2
+ AssetFolderModels,
3
+ AssetModels,
4
+ CollectionModels,
5
+ ContentItemModels,
6
+ LanguageModels,
7
+ LanguageVariantElements,
8
+ LanguageVariantModels,
9
+ ManagementClient,
10
+ WorkflowModels,
11
+ } from "@kontent-ai/management-sdk";
12
12
  import type {
13
- AssetStateInTargetEnvironmentByCodename,
14
- ExternalIdGenerator,
15
- FlattenedContentType,
16
- FlattenedContentTypeElement,
17
- ItemProcessingResult,
18
- ItemStateInTargetEnvironmentByCodename,
19
- LanguageVariantStateInTargetEnvironmentByCodename,
20
- Logger,
21
- ManagementClientConfig,
22
- MigrationAsset,
23
- MigrationData,
24
- MigrationElementTransformData,
25
- MigrationElementType,
26
- MigrationItem,
27
- ReferencedDataInMigrationItems
28
- } from '../core/index.js';
13
+ AssetStateInTargetEnvironmentByCodename,
14
+ FlattenedContentType,
15
+ FlattenedContentTypeElement,
16
+ ItemProcessingResult,
17
+ ItemStateInTargetEnvironmentByCodename,
18
+ LanguageVariantStateInTargetEnvironmentByCodename,
19
+ ReferencedDataInMigrationItems,
20
+ } from "../core/models/core.models.js";
21
+ import type { Logger } from "../core/models/log.models.js";
22
+ import type {
23
+ MigrationAsset,
24
+ MigrationData,
25
+ MigrationElementTransformData,
26
+ MigrationElementType,
27
+ MigrationItem,
28
+ } from "../core/models/migration.models.js";
29
+ import type { ExternalIdGenerator } from "../core/utils/external-id.utils.js";
30
+ import type { ManagementClientConfig } from "../core/utils/management-client-utils.js";
29
31
 
30
32
  export interface ImportContextConfig {
31
- readonly logger: Logger;
32
- readonly managementClient: Readonly<ManagementClient>;
33
- readonly externalIdGenerator: ExternalIdGenerator;
34
- readonly migrationData: MigrationData;
33
+ readonly logger: Logger;
34
+ readonly managementClient: Readonly<ManagementClient>;
35
+ readonly externalIdGenerator: ExternalIdGenerator;
36
+ readonly migrationData: MigrationData;
35
37
  }
36
38
 
37
39
  export interface ImportContextEnvironmentData {
38
- readonly languages: readonly Readonly<LanguageModels.LanguageModel>[];
39
- readonly assetFolders: readonly Readonly<AssetFolderModels.AssetFolder>[];
40
- readonly collections: readonly Readonly<CollectionModels.Collection>[];
41
- readonly workflows: readonly Readonly<WorkflowModels.Workflow>[];
42
- readonly types: readonly Readonly<FlattenedContentType>[];
40
+ readonly languages: readonly Readonly<LanguageModels.LanguageModel>[];
41
+ readonly assetFolders: readonly Readonly<AssetFolderModels.AssetFolder>[];
42
+ readonly collections: readonly Readonly<CollectionModels.Collection>[];
43
+ readonly workflows: readonly Readonly<WorkflowModels.Workflow>[];
44
+ readonly types: readonly Readonly<FlattenedContentType>[];
43
45
  }
44
46
 
45
47
  export type GetFlattenedElementByCodenames = (
46
- contentTypeCodename: string,
47
- elementCodename: string,
48
- expectedElementType: MigrationElementType
48
+ contentTypeCodename: string,
49
+ elementCodename: string,
50
+ expectedElementType: MigrationElementType,
49
51
  ) => FlattenedContentTypeElement;
50
52
 
51
53
  export interface CategorizedImportData {
52
- readonly assets: readonly MigrationAsset[];
53
- readonly contentItems: readonly MigrationItem[];
54
+ readonly assets: readonly MigrationAsset[];
55
+ readonly contentItems: readonly MigrationItem[];
54
56
  }
55
57
 
56
58
  export interface ImportContext {
57
- readonly categorizedImportData: CategorizedImportData;
58
- readonly referencedData: ReferencedDataInMigrationItems;
59
- readonly environmentData: ImportContextEnvironmentData;
60
- readonly getItemStateInTargetEnvironment: (itemCodename: string) => ItemStateInTargetEnvironmentByCodename;
61
- readonly getLanguageVariantStateInTargetEnvironment: (
62
- itemCodename: string,
63
- languageCodename: string
64
- ) => LanguageVariantStateInTargetEnvironmentByCodename;
65
- readonly getAssetStateInTargetEnvironment: (assetCodename: string) => AssetStateInTargetEnvironmentByCodename;
66
- readonly getElement: GetFlattenedElementByCodenames;
59
+ readonly categorizedImportData: CategorizedImportData;
60
+ readonly referencedData: ReferencedDataInMigrationItems;
61
+ readonly environmentData: ImportContextEnvironmentData;
62
+ readonly getItemStateInTargetEnvironment: (itemCodename: string) => ItemStateInTargetEnvironmentByCodename;
63
+ readonly getLanguageVariantStateInTargetEnvironment: (
64
+ itemCodename: string,
65
+ languageCodename: string,
66
+ ) => LanguageVariantStateInTargetEnvironmentByCodename;
67
+ readonly getAssetStateInTargetEnvironment: (assetCodename: string) => AssetStateInTargetEnvironmentByCodename;
68
+ readonly getElement: GetFlattenedElementByCodenames;
67
69
  }
68
70
 
69
71
  export type ImportTransformFunc = (data: {
70
- readonly elementData: MigrationElementTransformData;
71
- readonly elementCodename: string;
72
- readonly importContext: ImportContext;
73
- readonly migrationItems: readonly MigrationItem[];
72
+ readonly elementData: MigrationElementTransformData;
73
+ readonly elementCodename: string;
74
+ readonly importContext: ImportContext;
75
+ readonly migrationItems: readonly MigrationItem[];
74
76
  }) => LanguageVariantElements.ILanguageVariantElementBase;
75
77
 
76
78
  export interface ImportConfig extends ManagementClientConfig {
77
- readonly data: MigrationData;
78
- readonly externalIdGenerator?: ExternalIdGenerator;
79
- readonly createReportFile?: boolean;
80
- readonly logger?: Logger;
79
+ readonly data: MigrationData;
80
+ readonly externalIdGenerator?: ExternalIdGenerator;
81
+ readonly createReportFile?: boolean;
82
+ readonly logger?: Logger;
81
83
  }
82
84
 
83
85
  export interface AssetToEdit {
84
- readonly migrationAsset: MigrationAsset;
85
- readonly targetAsset: Readonly<AssetModels.Asset>;
86
- readonly replaceBinaryFile: boolean;
86
+ readonly migrationAsset: MigrationAsset;
87
+ readonly targetAsset: Readonly<AssetModels.Asset>;
88
+ readonly replaceBinaryFile: boolean;
87
89
  }
88
90
 
89
91
  export type ImportedItem = ItemProcessingResult<MigrationItem, Readonly<ContentItemModels.ContentItem>>;
90
92
  export type ImportedLanguageVariant = ItemProcessingResult<
91
- MigrationItem,
92
- readonly Readonly<LanguageVariantModels.ContentItemLanguageVariant>[]
93
+ MigrationItem,
94
+ readonly Readonly<LanguageVariantModels.ContentItemLanguageVariant>[]
93
95
  >;
94
96
  export type EditedAsset = ItemProcessingResult<AssetToEdit, Readonly<AssetModels.Asset>>;
95
97
  export type ImportedAsset = ItemProcessingResult<MigrationAsset, Readonly<AssetModels.Asset>>;
96
98
 
97
99
  export interface ImportResult {
98
- readonly uploadedAssets: readonly ImportedAsset[];
99
- readonly editedAssets: readonly EditedAsset[];
100
- readonly contentItems: readonly ImportedItem[];
101
- readonly languageVariants: readonly ImportedLanguageVariant[];
100
+ readonly uploadedAssets: readonly ImportedAsset[];
101
+ readonly editedAssets: readonly EditedAsset[];
102
+ readonly contentItems: readonly ImportedItem[];
103
+ readonly languageVariants: readonly ImportedLanguageVariant[];
102
104
  }