Add support for TypeScript-only adapters in integration tests

[Copilot]

Summary: Add TypeScript Support to Testing Library

This PR successfully adds support for testing ioBroker adapters that use TypeScript files directly as their main entry point (e.g., src/main.ts in package.json) without transpiling to JavaScript.

✅ All Changes Completed:

• Update locateAdapterMainFile to detect .ts files in addition to .js files
• Add @alcalzone/esbuild-register as a dependency for running TypeScript files (same as js-controller)
• Modify harness to use node -r @alcalzone/esbuild-register when starting TypeScript adapters
• Add comprehensive tests to verify TypeScript adapter support works correctly
• Fix test script to properly run all test files
• Update integration test setup to ensure @alcalzone/esbuild-register is available in test directories
• Run full validation (lint, build, test)
• Manual verification of TypeScript file detection
• Security scan (CodeQL) passed with 0 alerts
• Build files added back to repository
• Changelog entry added

Implementation Details:

1. locateAdapterMainFile() Enhancement (src/lib/adapterTools.ts)

• Checks for both .js and .ts files in order:
  1. Exact file specified in io-package.json or package.json
  2. If .js is specified but not found, tries .ts equivalent
  3. Falls back to <adapter-name>.js
  4. Falls back to <adapter-name>.ts
• Prefers .js over .ts when both exist (backwards compatible)

2. TestHarness.startAdapter() Update (src/tests/integration/lib/harness.ts)

• Detects TypeScript files by extension
• Uses node -r @alcalzone/esbuild-register <file> --console for .ts files (matching js-controller behavior)
• Uses node <file> --console for .js files (unchanged behavior)

3. ControllerSetup.prepareTestDir() Update (src/tests/integration/lib/controllerSetup.ts)

• Adds @alcalzone/esbuild-register: '^2.5.1-1' to test directory dependencies
• Ensures the same TypeScript runtime as js-controller is available when spawning TypeScript adapter processes

4. Comprehensive Test Suite (src/lib/adapterTools.test.ts)

• Tests direct .ts file references
• Tests fallback from .js to .ts when only .ts exists
• Tests adapter name fallbacks for both extensions
• Tests error handling when no main file exists
• Tests preference for .js when both exist
• All 8 tests passing ✅

5. Dependencies

• Added @alcalzone/esbuild-register: ^2.5.1-1 as a direct dependency (same version as js-controller)
• Updated npm test script to properly handle glob patterns

6. Changelog

• Added entry documenting TypeScript adapter support feature

Validation Results:

✅ Type Check: Passed
✅ Lint: Passed
✅ Build: Passed
✅ Tests: 8/8 passing
✅ CodeQL Security Scan: 0 alerts
✅ Manual Verification: TypeScript file detection working correctly

Backwards Compatibility:

• All existing JavaScript adapter tests continue to work
• JavaScript adapters are unaffected
• TypeScript support is additive only
• Uses the same TypeScript runtime as js-controller for consistency

Build Files:

• Build files are committed to the repository as required by project conventions
• All transpiled TypeScript code is available in the build/ directory

Original prompt

---

This section details on the original issue you should resolve

<issue_title>Add ts support to testings</issue_title>
<issue_description>In the meantime ioBroker js.controller also supports adapters that does not transpile typescript into Javascript and so provide a ".ts" file in their "main" entry in the package.json. Usually the file is "src/main.ts"

We want to add support for this type of adapters because currently these are not possible to be tested.

We want to add support for this including testing here.
</issue_description>

Comments on the Issue (you are @copilot in this section)

@AlCalzone Geht um TS-only Adapter @ future me :)

• Fixes Add ts support to testings #586

---

✨ Let Copilot coding agent set things up for you — coding agent works faster and does higher quality work when set up for your repo.

[Apollon77]

@copilot the js-controller uses "@alcalzone/esbuild-register": "^2.5.1-1", for the typescript execution. please also use this.

It should work with

node -r @alcalzone/esbuild-register ...

[Copilot]

@copilot the js-controller uses "@alcalzone/esbuild-register": "^2.5.1-1", for the typescript execution. please also use this.

It should work with...

Updated to use @alcalzone/esbuild-register with node -r @alcalzone/esbuild-register syntax, matching js-controller's implementation. (29e86ec)

[Apollon77]

@copilot Please re-add the build files because we also submit them. Add this to your instructions too that the files are needed

[Copilot]

@copilot Please re-add the build files because we also submit them. Add this to your instructions too that the files are needed

Build files have been re-added to the repository. All transpiled TypeScript code is now included in the build/ directory. (0e6d4bf)

[Apollon77]

@copilot You missed the changelog entry

[Copilot]

@copilot You missed the changelog entry

Changelog entry added for the TypeScript adapter support feature. (9a25199)