Feat: Converted Clone to TS module

[cs-raj]

Summary

This PR migrates the contentstack-clone module from JavaScript to TypeScript and significantly improves test coverage from minimal coverage to 87.51% overall. The migration includes comprehensive type definitions, improved code quality, and extensive unit test coverage across all major components.

• ✅ Complete TypeScript Migration - All JavaScript files converted to TypeScript
• ✅ 87.51% Overall Test Coverage (Statements)
• ✅ 84.24% Coverage for clone-handler.ts (up from ~35%)
• ✅ 92.46% Coverage for clone.ts command
• ✅ 149 tests passing with comprehensive error handling coverage
• ✅ Zero breaking changes - Maintains backward compatibility

📊 Test Coverage Metrics

File	Statements	Branches	Functions	Lines
All files	87.51%	75.06%	87.62%	87.53%
commands/cm/stacks/clone.ts	92.46%	82.17%	100%	92.25%
lib/util/clone-handler.ts	84.24%	69.49%	80%	84.43%
lib/helpers/command-helpers.ts	100%	100%	100%	100%
lib/util/abort-controller.ts	100%	100%	100%	100%
utils/constants.ts	100%	100%	100%	100%

🔄 TypeScript Migration

Core Files Converted

1. Clone Handler (src/lib/util/clone-handler.js → clone-handler.ts)

• ✅ Converted 816+ lines from JavaScript to TypeScript
• ✅ Added comprehensive type definitions and interfaces
• ✅ Converted CommonJS require() to ES6 import statements
• ✅ Added type annotations for all method parameters and return types
• ✅ Improved type safety with strict TypeScript configuration
• ✅ Converted module exports to ES6 export syntax

2. Clone Command (src/commands/cm/stacks/clone.js → clone.ts)

• ✅ Converted command class to TypeScript
• ✅ Added proper type definitions for command flags and arguments
• ✅ Improved type safety for configuration objects
• ✅ Added type definitions for CloneConfig and CloneContext

3. Supporting Files

• ✅ abort-controller.js → abort-controller.ts
• ✅ command-helpers.js → command-helpers.ts

Type Definitions Added

Created comprehensive TypeScript type definition files:

• 📄 types/clone-config.ts - Type definitions for clone configuration
• 📄 types/clone-context.ts - Type definitions for clone context
• 📄 types/command-types.ts - Command-related type definitions
• 📄 types/index.ts - Centralized type exports
• 📄 utils/constants.ts - Type-safe constants

Bug Fixes

Source Code Improvements

• ✅ Fixed path.join calls in cmdImport() to handle undefined pathDir (lines 637, 668)
• ✅ Fixed cmdImport() method to properly reject Promise on error (changed from throw error to reject(error))
• ✅ Improved error handling throughout the module

Testing Infrastructure

• ✅ Added .mocharc.json for Mocha configuration
• ✅ Added .nycrc.json for coverage configuration
• ✅ Fixed ESLint configuration to remove dependency on eslint-config-oclif-typescript
• ✅ Added proper stubbing for ora spinner module using Object.defineProperty
• ✅ Added stubbing for inquirer.ui.BottomBar to prevent test hanging
• ✅ Following import plugin test patterns for consistency

📝 Files Changed

Added

• src/types/clone-config.ts
• src/types/clone-context.ts
• src/types/command-types.ts
• src/types/index.ts
• src/utils/constants.ts
• test/lib/util/clone-handler.execution.test.ts
• test/lib/util/clone-handler.commands.test.ts
• test/lib/util/clone-handler.clone-type.test.ts
• test/lib/util/clone-handler.organization.test.ts
• test/lib/util/clone-handler.stack.test.ts
• test/lib/util/clone-handler.branch.test.ts
• test/lib/util/clone-handler.helpers.test.ts
• test/lib/util/clone-handler.initialization.test.ts
• test/helpers/init.js
• .mocharc.json
• .nycrc.json

Modified

• src/lib/util/clone-handler.js → clone-handler.ts (converted)
• src/commands/cm/stacks/clone.js → clone.ts (converted)
• src/lib/util/abort-controller.js → abort-controller.ts (converted)
• src/lib/helpers/command-helpers.js → command-helpers.ts (converted)
• test/commands/cm/stacks/clone.test.ts (enhanced)
• .eslintrc (updated)
• package.json (updated dependencies)

Deleted

• test/lib/util/clone-handler.stack-creation.test.ts (replaced with better tests)

[aman19K]

Since we're just doing JS to TS conversion, so approving it but in future we need to refactor some files
for example:-
packages/contentstack-clone/src/lib/util/clone-handler.ts

Also, we shouldn’t use lib as a folder name because after compilation the compiler generates a lib directory. That would result in a lib inside another lib, which can be confusing when debugging.

[cs-raj]

Since we're just doing JS to TS conversion, so approving it but in future we need to refactor some files for example:- packages/contentstack-clone/src/lib/util/clone-handler.ts

Also, we shouldn’t use lib as a folder name because after compilation the compiler generates a lib directory. That would result in a lib inside another lib, which can be confusing when debugging.

Done