feat: add support for AM in import module by naman-contentstack · Pull Request #41 · contentstack/cli-plugins

naman-contentstack · 2026-03-20T14:23:19Z

Import: Asset Management (AM 2.0) integration

Adds support for AM 2.0–style exports alongside the legacy asset flow in @contentstack/cli-cm-import.

Detection: Enables the AM path when the export includes spaces/ and stack metadata indicates am_v2 (see import-config-handler).
Orchestration: contentstack-import delegates space creation, folder/asset upload, org-level fields/asset types, and mapper output to @contentstack/cli-asset-management.
Mappers: Writes mapper/assets/uid-mapping.json, url-mapping.json, and space-uid-mapping.json for entries resolution (pending requests + throughput charts use GCP metrics; URLs map old AM direct URLs → new).
Stack linking: Links imported spaces to the target stack via branch settings (stack.branch(uid).updateSettings / am_v2.linked_workspaces) after mappers are written.
UX: Quantification queue UI: dual-axis charts, shared graph height, refresh button loading state, English copy.

Requires: @contentstack/management with branch updateSettings; region assetManagementUrl for AM API calls.

github-actions · 2026-03-20T14:23:56Z

🔒 Security Scan Results

ℹ️ Note: Only vulnerabilities with available fixes (upgrades or patches) are counted toward thresholds.

Check Type	Threshold	Result
🔴 Critical Severity	10	✅ Passed
🟠 High Severity	25	✅ Passed
🟡 Medium Severity	500	✅ Passed
🔵 Low Severity	1000	✅ Passed

⏱️ SLA Breach Summary

✅ No SLA breaches detected. All vulnerabilities are within acceptable time thresholds.

Severity	SLA Threshold (with/no fixes)	Status
🔴 Critical	15 / 30 days	✅ Passed
🟠 High	30 / 120 days	✅ Passed
🟡 Medium	90 / 365 days	✅ Passed
🔵 Low	180 / 365 days	✅ Passed

✅ BUILD PASSED - All security checks passed

github-actions · 2026-03-24T10:45:40Z

🔒 Security Scan Results

ℹ️ Note: Only vulnerabilities with available fixes (upgrades or patches) are counted toward thresholds.

Check Type	Threshold	Result
🔴 Critical Severity	10	✅ Passed
🟠 High Severity	25	✅ Passed
🟡 Medium Severity	500	✅ Passed
🔵 Low Severity	1000	✅ Passed

⏱️ SLA Breach Summary

✅ No SLA breaches detected. All vulnerabilities are within acceptable time thresholds.

Severity	SLA Threshold (with/no fixes)	Status
🔴 Critical	15 / 30 days	✅ Passed
🟠 High	30 / 120 days	✅ Passed
🟡 Medium	90 / 365 days	✅ Passed
🔵 Low	180 / 365 days	✅ Passed

✅ BUILD PASSED - All security checks passed

github-actions · 2026-03-24T10:59:32Z

🔒 Security Scan Results

ℹ️ Note: Only vulnerabilities with available fixes (upgrades or patches) are counted toward thresholds.

Check Type	Threshold	Result
🔴 Critical Severity	10	✅ Passed
🟠 High Severity	25	✅ Passed
🟡 Medium Severity	500	✅ Passed
🔵 Low Severity	1000	✅ Passed

⏱️ SLA Breach Summary

✅ No SLA breaches detected. All vulnerabilities are within acceptable time thresholds.

Severity	SLA Threshold (with/no fixes)	Status
🔴 Critical	15 / 30 days	✅ Passed
🟠 High	30 / 120 days	✅ Passed
🟡 Medium	90 / 365 days	✅ Passed
🔵 Low	180 / 365 days	✅ Passed

✅ BUILD PASSED - All security checks passed

shafeeqd959

I have not added comments for entire code changes, what I would suggest here that we should follow the export and import designs and code structures and utilities that we used in export and import of other modules here as well, please go through the assets. module export and import similar structure can be followed here, along with assets please check other modules as well, you could easily find the pattern that we followed, I expect the same here as well.

packages/contentstack-asset-management/src/constants/index.ts

packages/contentstack-asset-management/src/import/asset-types.ts

github-actions · 2026-03-27T07:38:29Z

🔒 Security Scan Results

ℹ️ Note: Only vulnerabilities with available fixes (upgrades or patches) are counted toward thresholds.

Check Type	Count (with fixes)	Without fixes	Threshold	Result
🔴 Critical Severity	0	0	10	✅ Passed
🟠 High Severity	15	40	25	✅ Passed
🟡 Medium Severity	15	40	500	✅ Passed
🔵 Low Severity	0	0	1000	✅ Passed

⏱️ SLA Breach Summary

✅ No SLA breaches detected. All vulnerabilities are within acceptable time thresholds.

Severity	SLA Threshold (with/no fixes)	Status
🔴 Critical	15 / 30 days	✅ Passed
🟠 High	30 / 120 days	✅ Passed
🟡 Medium	90 / 365 days	✅ Passed
🔵 Low	180 / 365 days	✅ Passed

ℹ️ Vulnerabilities Without Available Fixes (Informational Only)

The following vulnerabilities were detected but do not have fixes available (no upgrade or patch). These are excluded from failure thresholds:

Critical without fixes: 0
High without fixes: 40
Medium without fixes: 40
Low without fixes: 0

✅ BUILD PASSED - All security checks passed

github-actions · 2026-03-31T10:02:44Z

🔒 Security Scan Results

ℹ️ Note: Only vulnerabilities with available fixes (upgrades or patches) are counted toward thresholds.

Check Type	Count (with fixes)	Without fixes	Threshold	Result
🔴 Critical Severity	0	0	10	✅ Passed
🟠 High Severity	24	117	25	✅ Passed
🟡 Medium Severity	15	40	500	✅ Passed
🔵 Low Severity	0	0	1000	✅ Passed

⏱️ SLA Breach Summary

✅ No SLA breaches detected. All vulnerabilities are within acceptable time thresholds.

Severity	SLA Threshold (with/no fixes)	Status
🔴 Critical	15 / 30 days	✅ Passed
🟠 High	30 / 120 days	✅ Passed
🟡 Medium	90 / 365 days	✅ Passed
🔵 Low	180 / 365 days	✅ Passed

ℹ️ Vulnerabilities Without Available Fixes (Informational Only)

The following vulnerabilities were detected but do not have fixes available (no upgrade or patch). These are excluded from failure thresholds:

Critical without fixes: 0
High without fixes: 117
Medium without fixes: 40
Low without fixes: 0

✅ BUILD PASSED - All security checks passed

packages/contentstack-asset-management/src/export/base.ts

shafeeqd959 · 2026-03-31T10:09:37Z

packages/contentstack-asset-management/src/import/asset-types.ts

+    const stripKeys = this.importContext.assetTypesImportInvalidKeys ?? [...FALLBACK_ASSET_TYPES_IMPORT_INVALID_KEYS];
+    const dir = this.getAssetTypesDir();
+    const indexName = this.importContext.assetTypesFileName ?? 'asset-types.json';
+    const items = await readChunkedJsonItems<Record<string, unknown>>(dir, indexName, this.importContext.context);


using fs utility, we are already have a way to read to this, no need of this implementation at all "readChunkedJsonItems"

packages/contentstack-asset-management/src/import/asset-types.ts

shafeeqd959 · 2026-03-31T10:14:59Z

packages/contentstack-asset-management/src/import/fields.ts

+      toCreate.push({ uid, payload: omit(field, stripKeys) as Record<string, unknown> });
+    }
+
+    await runInBatches(toCreate, this.apiConcurrency, async ({ uid, payload }) => {


suggestion: use the concurrency approach and methods in all other modules in import command

shafeeqd959 · 2026-03-31T10:20:40Z

packages/contentstack-asset-management/src/utils/chunked-json-read.ts

+ * Read all items from a chunked JSON store (index + chunk files) using FsUtility,
+ * matching the pattern used in contentstack-import entry modules.
+ */
+export async function readChunkedJsonItems<T = Record<string, unknown>>(


use existing method

packages/contentstack-asset-management/src/utils/concurrent-batch.ts

packages/contentstack-import/src/import/modules/assets.ts

packages/contentstack-asset-management/src/import/assets.ts

github-actions · 2026-03-31T13:04:05Z

🔒 Security Scan Results

ℹ️ Note: Only vulnerabilities with available fixes (upgrades or patches) are counted toward thresholds.

Check Type	Count (with fixes)	Without fixes	Threshold	Result
🔴 Critical Severity	0	0	10	✅ Passed
🟠 High Severity	24	117	25	✅ Passed
🟡 Medium Severity	15	40	500	✅ Passed
🔵 Low Severity	0	0	1000	✅ Passed

⏱️ SLA Breach Summary

✅ No SLA breaches detected. All vulnerabilities are within acceptable time thresholds.

Severity	SLA Threshold (with/no fixes)	Status
🔴 Critical	15 / 30 days	✅ Passed
🟠 High	30 / 120 days	✅ Passed
🟡 Medium	90 / 365 days	✅ Passed
🔵 Low	180 / 365 days	✅ Passed

ℹ️ Vulnerabilities Without Available Fixes (Informational Only)

The following vulnerabilities were detected but do not have fixes available (no upgrade or patch). These are excluded from failure thresholds:

Critical without fixes: 0
High without fixes: 117
Medium without fixes: 40
Low without fixes: 0

✅ BUILD PASSED - All security checks passed

feat: add support for AM in import module

64c6e36

naman-contentstack self-assigned this Mar 20, 2026

naman-contentstack requested a review from a team as a code owner March 20, 2026 14:23

chore: update implementation for AM import

a01a6fc

Merge branch 'feat/AM2.0' into feat/DX-4976

de7d9bb

shafeeqd959 reviewed Mar 24, 2026

View reviewed changes

naman-contentstack added 2 commits March 25, 2026 16:16

Merge branch 'feat/AM2.0' into feat/DX-4976

bfb990b

chore: made implementation consistent with other modules

cbd6d7f

naman-contentstack requested a review from shafeeqd959 March 30, 2026 10:26

Merge branch 'feat/AM2.0' into feat/DX-4976

93c7444

shafeeqd959 reviewed Mar 31, 2026

View reviewed changes

chore: updated implementation for AM import

2ef8e3a

naman-contentstack requested a review from shafeeqd959 March 31, 2026 13:03

Conversation

naman-contentstack commented Mar 20, 2026

Import: Asset Management (AM 2.0) integration

Uh oh!

github-actions bot commented Mar 20, 2026

🔒 Security Scan Results

⏱️ SLA Breach Summary

Uh oh!

github-actions bot commented Mar 24, 2026

🔒 Security Scan Results

⏱️ SLA Breach Summary

Uh oh!

github-actions bot commented Mar 24, 2026

🔒 Security Scan Results

⏱️ SLA Breach Summary

Uh oh!

shafeeqd959 left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

github-actions bot commented Mar 27, 2026

🔒 Security Scan Results

⏱️ SLA Breach Summary

ℹ️ Vulnerabilities Without Available Fixes (Informational Only)

Uh oh!

github-actions bot commented Mar 31, 2026

🔒 Security Scan Results

⏱️ SLA Breach Summary

ℹ️ Vulnerabilities Without Available Fixes (Informational Only)

Uh oh!

Uh oh!

shafeeqd959 Mar 31, 2026

Choose a reason for hiding this comment

Uh oh!

Uh oh!

shafeeqd959 Mar 31, 2026

Choose a reason for hiding this comment

Uh oh!

shafeeqd959 Mar 31, 2026

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

github-actions bot commented Mar 31, 2026

🔒 Security Scan Results

⏱️ SLA Breach Summary

ℹ️ Vulnerabilities Without Available Fixes (Informational Only)

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants