Add public interface for conversion

Author: stefanschramm

retroload-lib/src/conversion/ConverterManager.test.ts

@@ -1,7 +1,7 @@
 import {getLocalPathByDirAndFile} from '../Examples.js';
 import {BufferAccess} from '../common/BufferAccess.js';
 import {type OptionValues} from '../encoding/Options.js';
-import {convert} from './ConverterManager.js';
+import {convert, getConverters} from './ConverterManager.js';
 import * as fs from 'fs';
 
 type TestDefinition = {
@@ -29,6 +29,10 @@ const formatTests: TestDefinition[] = [
   },
 ];
 
+test('getConverters() returns non empty list', () => {
+  expect(getConverters().length).toBeGreaterThan(0);
+});
+
 describe('Formats are converted correctly', () => {
   it.each(formatTests.map((t: TestDefinition) => ({label: getTestLabel(t), definition: t})))(
     '$label',

retroload-lib/src/conversion/ConverterManager.ts

@@ -2,7 +2,11 @@ import {type BufferAccess} from '../common/BufferAccess.js';
 import {FormatNotFoundError} from '../common/Exceptions.js';
 import {OptionContainer, type OptionValues} from '../encoding/Options.js';
 import {converters} from './ConverterProvider.js';
-import {type ConverterDefinition} from './converter/ConverterDefinition.js';
+import {type PublicConverterDefinition, type ConverterDefinition} from './converter/ConverterDefinition.js';
+
+export function getConverters(): PublicConverterDefinition[] {
+  return converters;
+}
 
 export function convert(data: BufferAccess, identifier: string, options: OptionValues): BufferAccess {
   const chosenConverters = converters.filter((c: ConverterDefinition) => c.identifier === identifier);

retroload-lib/src/conversion/converter/ConverterDefinition.ts

@@ -1,9 +1,12 @@
 import {type BufferAccess} from '../../common/BufferAccess.js';
 import {type OptionContainer, type PublicOptionDefinition} from '../../encoding/Options.js';
 
-export type ConverterDefinition = {
+export type PublicConverterDefinition = {
   readonly name: string;
   readonly identifier: string;
   readonly options: PublicOptionDefinition[];
+};
+
+export type ConverterDefinition = PublicConverterDefinition & {
   readonly convert: (ba: BufferAccess, options: OptionContainer) => BufferAccess;
 };

retroload-lib/src/index.ts

@@ -3,6 +3,7 @@ export {WaveRecorder} from './encoding/recorder/WaveRecorder.js';
 export {Logger} from './common/logging/Logger.js';
 export {BufferAccess} from './common/BufferAccess.js';
 export * as AdapterManager from './encoding/AdapterManager.js';
+export * as ConverterManager from './conversion/ConverterManager.js';
 export * as Exception from './common/Exceptions.js';
 export * as DecoderManager from './decoding/DecoderManager.js';
 export {tokenizers as BasicTokenizers} from './tokenizing/TokenizerProvider.js';