Merge pull request #248 from contentstack/v2-dev

DX | 29-06-2026 | Beta Release

Author: harshitha-cstk

.github/workflows/release-v2-beta-plugins.yml

@@ -135,6 +135,14 @@ jobs:
           package: ./packages/contentstack-branches/package.json
           tag: beta
 
+      # Apps CLI
+      - name: Publishing apps-cli (Production)
+        uses: JS-DevTools/npm-publish@v3
+        with:
+          token: ${{ secrets.NPM_TOKEN }}
+          package: ./packages/contentstack-apps-cli/package.json
+          tag: latest
+
       # Query Export
       - name: Publishing query-export (Beta)
         uses: JS-DevTools/npm-publish@v3
@@ -183,6 +191,23 @@ jobs:
           package: ./packages/contentstack-migrate-rte/package.json
           access: public
           tag: beta
+      # External Migrate
+      - name: Publishing external-migrate (Beta)
+        uses: JS-DevTools/npm-publish@v3
+        with:
+          token: ${{ secrets.NPM_TOKEN }}
+          package: ./packages/contentstack-external-migrate/package.json
+          access: public
+          tag: beta
+
+      - name: Create Production Release
+        id: create_release
+        env:
+          GITHUB_TOKEN: ${{ secrets.PKG_TOKEN }}
+          VERSION: ${{ steps.publish-plugins.outputs.version }}
+        run: |
+          # Get the previous production release for comparison
+          PREVIOUS_PROD=$(gh release list --limit 10 | grep -v 'prerelease' | head -1 | cut -f1)
 
       # Bulk Operations
       - name: Publishing bulk-operations (Beta)

.talismanrc

@@ -1,4 +1,4 @@
 fileignoreconfig:
 - filename: pnpm-lock.yaml
-  checksum: cdead0797199d22bbc55b9e5b6b86983f28eb760fabe5e1f2d5139c4456a9131
-version: '1.0'
+  checksum: 0feb3713a8f2e4a8a1f5f528218c2c578265dc5b31ff283a283fefc949bbafd2
+version: ""

package.json

@@ -6,7 +6,7 @@
     "pnpm": "^10.28.0"
   },
   "engines": {
-    "node": ">=18.0.0"
+    "node": ">=22.0.0"
   },
   "private": true,
   "scripts": {

packages/contentstack-apps-cli/.eslintignore

@@ -0,0 +1,47 @@
+import tseslint from 'typescript-eslint';
+import globals from 'globals';
+
+export default [
+  ...tseslint.configs.recommended,
+  {
+    ignores: [
+      'lib/**/*',
+      'test/**/*',
+      'dist/**/*',
+    ],
+  },
+  {
+    languageOptions: {
+      parser: tseslint.parser,
+      parserOptions: {
+        project: './tsconfig.json',
+      },
+      sourceType: 'module',
+      globals: {
+        ...globals.node,
+      },
+    },
+    plugins: {
+      '@typescript-eslint': tseslint.plugin,
+    },
+    rules: {
+      '@typescript-eslint/no-unused-vars': [
+        'error',
+        {
+          args: 'none',
+        },
+      ],
+      '@typescript-eslint/prefer-namespace-keyword': 'error',
+      quotes: 'off',
+      semi: 'off',
+      '@typescript-eslint/no-redeclare': 'off',
+      eqeqeq: ['error', 'smart'],
+      'id-match': 'error',
+      'no-eval': 'error',
+      'no-var': 'error',
+      '@typescript-eslint/no-explicit-any': 'off',
+      '@typescript-eslint/no-require-imports': 'off',
+      'prefer-const': 'error',
+    },
+  },
+];

packages/contentstack-apps-cli/.eslintrc

@@ -1,6 +1,6 @@
 {
   "name": "@contentstack/apps-cli",
-  "version": "2.0.0-beta.0",
+  "version": "2.0.0-beta.1",
   "description": "App ClI",
   "author": "Contentstack CLI",
   "homepage": "https://github.com/contentstack/cli-plugins/tree/main/packages/contentstack-apps-cli",
@@ -22,9 +22,9 @@
   ],
   "dependencies": {
     "@apollo/client": "^3.14.1",
-    "@contentstack/cli-command": "~2.0.0-beta.8",
+    "@contentstack/cli-command": "~2.0.0-beta.9",
     "@contentstack/cli-launch": "^1.10.0",
-    "@contentstack/cli-utilities": "~2.0.0-beta.9",
+    "@contentstack/cli-utilities": "~2.0.0-beta.10",
     "adm-zip": "^0.5.17",
     "chalk": "^5.6.2",
     "lodash": "^4.18.1",
@@ -46,7 +46,7 @@
     "axios": "^1.16.1",
     "chai": "^4.5.0",
     "dotenv": "^16.6.1",
-    "eslint": "^8.57.1",
+    "eslint": "^10.5.0",
     "eslint-config-oclif": "^6.0.157",
     "eslint-config-oclif-typescript": "^3.1.14",
     "mocha": "^10.8.2",
@@ -80,7 +80,7 @@
   },
   "scripts": {
     "build": "npm run clean && shx rm -rf lib && tsc -b",
-    "lint": "eslint . --ext .ts --config .eslintrc",
+    "lint": "eslint .",
     "postpack": "shx rm -f oclif.manifest.json",
     "posttest": "npm run lint",
     "prepack": "npm run build && oclif manifest && oclif readme",
@@ -91,7 +91,7 @@
     "test:unit:report:json": "mocha --reporter json --reporter-options output=report.json --forbid-only \"test/unit/**/*.test.ts\" && nyc --reporter=clover --extension .ts mocha --forbid-only \"test/unit/**/*.test.ts\""
   },
   "engines": {
-    "node": ">=16"
+    "node": ">=22.0.0"
   },
   "bugs": "https://github.com/contentstack/cli-plugins/issues",
   "keywords": [

packages/contentstack-apps-cli/eslint.config.js

@@ -120,7 +120,7 @@ function fetchAppInstallations(
   flags: FlagInput,
   orgUid: string,
   options: MarketPlaceOptions
-) {
+): Promise<any> {
   const { marketplaceSdk } = options;
   const app: any = flags["app-uid"];
   return marketplaceSdk
@@ -218,7 +218,7 @@ function uninstallApp(
   orgUid: string,
   options: MarketPlaceOptions,
   installationUid: string
-) {
+): Promise<any> {
   const { marketplaceSdk } = options;
   // const app: any = flags["app-uid"];
   return marketplaceSdk

packages/contentstack-apps-cli/package.json

@@ -0,0 +1,49 @@
+# @contentstack/cli-asset-management
+
+Asset Management 2.0 API adapter for Contentstack CLI export and import. Used by the export and import plugins when Asset Management (AM 2.0) is enabled. To learn how to export and import content in Contentstack, refer to the [Migration guide](https://www.contentstack.com/docs/developers/cli/migration/).
+
+[![License](https://img.shields.io/npm/l/@contentstack/cli)](https://github.com/contentstack/cli/blob/main/LICENSE)
+
+<!-- toc -->
+* [@contentstack/cli-asset-management](#contentstackcli-asset-management)
+* [Overview](#overview)
+* [Usage](#usage)
+* [Exports](#exports)
+<!-- tocstop -->
+
+# Overview
+
+This package provides:
+
+- **AssetManagementAdapter** – HTTP client for the Asset Management API (spaces, assets, folders, fields, asset types).
+- **exportSpaceStructure** – Exports space metadata and full workspace structure (metadata, folders, assets, fields, asset types) for linked workspaces.
+- **Types** – `AssetManagementExportOptions`, `LinkedWorkspace`, `IAssetManagementAdapter`, and related types for export/import integration.
+
+# Usage
+
+This package is consumed by the export and import plugins. When using the export CLI with the `--asset-management` flag (or when the host app enables AM 2.0), the export plugin calls `exportSpaceStructure` with linked workspaces and options:
+
+```ts
+import { exportSpaceStructure } from '@contentstack/cli-asset-management';
+
+await exportSpaceStructure({
+  linkedWorkspaces,
+  exportDir,
+  branchName: 'main',
+  assetManagementUrl,
+  org_uid,
+  context,
+  progressManager,
+  progressProcessName,
+  updateStatus,
+  downloadAsset, // optional
+});
+```
+
+# Exports
+
+| Export | Description |
+|--------|-------------|
+| `exportSpaceStructure` | Async function to export space structure for given linked workspaces. |
+| `AssetManagementAdapter` | Class to call the Asset Management API (getSpace, getWorkspaceFields, getWorkspaceAssets, etc.). |
+| Types from `./types` | `AssetManagementExportOptions`, `ExportSpaceOptions`, `ChunkedJsonWriteOptions`, `LinkedWorkspace`, `SpaceResponse`, `FieldsResponse`, `AssetTypesResponse`, and related API types. |