chore: [SVLS-5187] improve typing

[ava-silver]

What does this PR do?

Replaces TypeScript any types with proper type definitions throughout the codebase to improve type safety and code maintainability.

Motivation

The codebase contained numerous any type annotations which bypass TypeScript's type checking system. This refactoring introduces proper type definitions including Record<string, unknown>, specific interfaces, and union types to provide better type safety and developer experience.

Testing Guidelines

Existing tests should continue to pass as this is primarily a type safety improvement without changing runtime behavior. Type checking should now catch more potential issues at compile time.

Additional Notes

Key changes include:

• Replaced any with Record<string, unknown> for object types
• Added proper interfaces for CloudFormation resources (CfnResource, StateMachineCfnResource)
• Created specific types for step function configurations (StepFunctionConfig, StepFunctionLoggingConfig)
• Improved type guards with proper null checking
• Used nullish coalescing operator (??) for cleaner default value assignments
• Added proper type assertions where necessary while maintaining type safety

Minor bug fixes included

• Fixed stateMachine.Properties.Tags default value: Changed from ??= {} (object) to ??= [] (array), since CloudFormation Tags are arrays of {Key, Value} objects.
• Fixed isLogsConfig null handling: Added an explicit obj === null check, since typeof null === "object" in JavaScript would previously allow null to pass the type guard.

Types of changes

• Misc (docs, refactoring, dependency upgrade, etc.)

Check all that apply

• This PR's description is comprehensive
• This PR contains breaking changes that are documented in the description
• This PR introduces new APIs or parameters that are documented and unlikely to change in the foreseeable future
• This PR impacts documentation, and it has been updated (or a ticket has been logged)
• This PR's changes are covered by the automated tests
• This PR collects user input/sensitive content into Datadog

[ava-silver]

• chore: [SVLS-5187] improve typing #669 👈 (View in Graphite)
• main

This stack of pull requests is managed by Graphite. Learn more about stacking.

[nina9753]

The linter just needs to pass