@tx5dr/plugin-api 1.7.12 → 2.5.0

package/dist/toolkit/contest/FT8ContestPlugin.d.ts

@@ -0,0 +1,55 @@
+import type { PluginPermission } from '@tx5dr/contracts';
+import type { PluginCleanupContext, PluginContextFor, StrategyPluginContext } from '../../context.js';
+import type { PluginDefinition } from '../../definition.js';
+import type { PluginHooks } from '../../hooks.js';
+import { type QueuedStrategyRuntime, type StrategyRuntime } from '../../runtime.js';
+import type { ContestLogbookModule } from './ContestLogbook.js';
+import type { VersionedContestSession } from './ContestSessionRepository.js';
+import type { FT8ContestDefinition } from './FT8ContestDefinition.js';
+import type { FT8ContestQso } from './FT8ContestModules.js';
+export declare const FT8_CONTEST_MIN_PLUGIN_API_VERSION = "2.5.0";
+export interface FT8RuntimeModule<TContest> {
+    readonly id: string;
+    create(contest: TContest, context: StrategyPluginContext): StrategyRuntime;
+}
+export type FT8ParallelRuntime = QueuedStrategyRuntime & Required<Pick<StrategyRuntime, 'getTransmissions' | 'onTransmissionsCompleted'>>;
+export type FT8RuntimeFactory<TContest> = (contest: TContest, context: StrategyPluginContext) => StrategyRuntime;
+export declare function defineFT8RuntimeModule<TContest>(module: FT8RuntimeModule<TContest>): FT8RuntimeModule<TContest>;
+export type ContestModuleCleanup = (context: PluginCleanupContext) => void | Promise<void>;
+export interface ContestLifecycleModule<TContest, Permissions extends readonly PluginPermission[] = readonly []> {
+    readonly id: string;
+    setup(input: {
+        contest: TContest;
+        context: PluginContextFor<Permissions>;
+        /** Stable owner used by modules that publish process-global events. */
+        pluginName: string;
+    }): void | ContestModuleCleanup | Promise<void | ContestModuleCleanup>;
+}
+/** Lifecycle module for versioned contest state. Storage mechanics stay module-owned. */
+export interface ContestSessionModule<TContest, Permissions extends readonly PluginPermission[] = readonly []> extends ContestLifecycleModule<TContest, Permissions> {
+}
+/** Lifecycle module for an optional contest page/workbench protocol. */
+export interface ContestWorkbenchModule<TContest, Permissions extends readonly PluginPermission[] = readonly []> extends ContestLifecycleModule<TContest, Permissions> {
+}
+export declare function defineContestSessionModule<TContest, Permissions extends readonly PluginPermission[] = readonly []>(module: ContestSessionModule<TContest, Permissions>): ContestSessionModule<TContest, Permissions>;
+export declare function defineContestWorkbenchModule<TContest, Permissions extends readonly PluginPermission[] = readonly []>(module: ContestWorkbenchModule<TContest, Permissions>): ContestWorkbenchModule<TContest, Permissions>;
+export interface ComposeFT8ContestPluginInput<TExchange, TQso extends FT8ContestQso<TExchange>, TSubmissionOptions, Permissions extends readonly PluginPermission[], SessionPermissions extends readonly PluginPermission[] = Permissions, WorkbenchPermissions extends readonly PluginPermission[] = Permissions> extends Omit<PluginDefinition<Permissions>, 'apiVersion' | 'type' | 'createStrategyRuntime' | 'onLoad' | 'onUnload' | 'hooks'> {
+    contest: FT8ContestDefinition<TExchange, TQso, TSubmissionOptions>;
+    runtime: FT8RuntimeModule<FT8ContestDefinition<TExchange, TQso, TSubmissionOptions>> | FT8RuntimeFactory<FT8ContestDefinition<TExchange, TQso, TSubmissionOptions>>;
+    session?: ContestSessionModule<FT8ContestDefinition<TExchange, TQso, TSubmissionOptions>, SessionPermissions> & RequiredPermissionsAvailable<Permissions, SessionPermissions>;
+    workbench?: ContestWorkbenchModule<FT8ContestDefinition<TExchange, TQso, TSubmissionOptions>, WorkbenchPermissions> & RequiredPermissionsAvailable<Permissions, WorkbenchPermissions>;
+    logbook?: ContestLogbookModule<FT8ContestDefinition<TExchange, TQso, TSubmissionOptions>, VersionedContestSession, Permissions>;
+    hooks?: PluginHooks<Permissions>;
+    onLoad?(context: PluginContextFor<Permissions>): void | Promise<void>;
+    onUnload?(context: PluginCleanupContext): void | Promise<void>;
+}
+type RequiredPermissionsAvailable<Actual extends readonly PluginPermission[], Required extends readonly PluginPermission[]> = Exclude<Required[number], Actual[number]> extends never ? unknown : {
+    readonly missingPluginPermissions: Exclude<Required[number], Actual[number]>;
+};
+/**
+ * Convenience assembler for an operator-scoped FT8 strategy plugin.
+ * Authors can skip it and wire the same public modules through definePlugin().
+ */
+export declare function composeFT8ContestPlugin<TExchange, TQso extends FT8ContestQso<TExchange>, TSubmissionOptions = void, const Permissions extends readonly PluginPermission[] = readonly [], SessionPermissions extends readonly PluginPermission[] = Permissions, WorkbenchPermissions extends readonly PluginPermission[] = Permissions>(input: ComposeFT8ContestPluginInput<TExchange, TQso, TSubmissionOptions, Permissions, SessionPermissions, WorkbenchPermissions>): PluginDefinition<Permissions>;
+export {};
+//# sourceMappingURL=FT8ContestPlugin.d.ts.map

package/dist/toolkit/contest/FT8ContestPlugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FT8ContestPlugin.d.ts","sourceRoot":"","sources":["../../../src/toolkit/contest/FT8ContestPlugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,KAAK,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AACtG,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAE5D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAEL,KAAK,qBAAqB,EAG1B,KAAK,eAAe,EACrB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAChE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,+BAA+B,CAAC;AAC7E,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACtE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAE5D,eAAO,MAAM,kCAAkC,UAAU,CAAC;AAE1D,MAAM,WAAW,gBAAgB,CAAC,QAAQ;IACxC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,qBAAqB,GAAG,eAAe,CAAC;CAC5E;AAED,MAAM,MAAM,kBAAkB,GAAG,qBAAqB,GAAG,QAAQ,CAAC,IAAI,CACpE,eAAe,EACf,kBAAkB,GAAG,0BAA0B,CAChD,CAAC,CAAC;AAEH,MAAM,MAAM,iBAAiB,CAAC,QAAQ,IAAI,CACxC,OAAO,EAAE,QAAQ,EACjB,OAAO,EAAE,qBAAqB,KAC3B,eAAe,CAAC;AAErB,wBAAgB,sBAAsB,CAAC,QAAQ,EAC7C,MAAM,EAAE,gBAAgB,CAAC,QAAQ,CAAC,GACjC,gBAAgB,CAAC,QAAQ,CAAC,CAE5B;AAED,MAAM,MAAM,oBAAoB,GAAG,CACjC,OAAO,EAAE,oBAAoB,KAC1B,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAE1B,MAAM,WAAW,sBAAsB,CACrC,QAAQ,EACR,WAAW,SAAS,SAAS,gBAAgB,EAAE,GAAG,SAAS,EAAE;IAE7D,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,KAAK,EAAE;QACX,OAAO,EAAE,QAAQ,CAAC;QAClB,OAAO,EAAE,gBAAgB,CAAC,WAAW,CAAC,CAAC;QACvC,uEAAuE;QACvE,UAAU,EAAE,MAAM,CAAC;KACpB,GAAG,IAAI,GAAG,oBAAoB,GAAG,OAAO,CAAC,IAAI,GAAG,oBAAoB,CAAC,CAAC;CACxE;AAED,yFAAyF;AACzF,MAAM,WAAW,oBAAoB,CACnC,QAAQ,EACR,WAAW,SAAS,SAAS,gBAAgB,EAAE,GAAG,SAAS,EAAE,CAC7D,SAAQ,sBAAsB,CAAC,QAAQ,EAAE,WAAW,CAAC;CAAG;AAE1D,wEAAwE;AACxE,MAAM,WAAW,sBAAsB,CACrC,QAAQ,EACR,WAAW,SAAS,SAAS,gBAAgB,EAAE,GAAG,SAAS,EAAE,CAC7D,SAAQ,sBAAsB,CAAC,QAAQ,EAAE,WAAW,CAAC;CAAG;AAE1D,wBAAgB,0BAA0B,CACxC,QAAQ,EACR,WAAW,SAAS,SAAS,gBAAgB,EAAE,GAAG,SAAS,EAAE,EAE7D,MAAM,EAAE,oBAAoB,CAAC,QAAQ,EAAE,WAAW,CAAC,GAClD,oBAAoB,CAAC,QAAQ,EAAE,WAAW,CAAC,CAE7C;AAED,wBAAgB,4BAA4B,CAC1C,QAAQ,EACR,WAAW,SAAS,SAAS,gBAAgB,EAAE,GAAG,SAAS,EAAE,EAE7D,MAAM,EAAE,sBAAsB,CAAC,QAAQ,EAAE,WAAW,CAAC,GACpD,sBAAsB,CAAC,QAAQ,EAAE,WAAW,CAAC,CAE/C;AAED,MAAM,WAAW,4BAA4B,CAC3C,SAAS,EACT,IAAI,SAAS,aAAa,CAAC,SAAS,CAAC,EACrC,kBAAkB,EAClB,WAAW,SAAS,SAAS,gBAAgB,EAAE,EAC/C,kBAAkB,SAAS,SAAS,gBAAgB,EAAE,GAAG,WAAW,EACpE,oBAAoB,SAAS,SAAS,gBAAgB,EAAE,GAAG,WAAW,CACtE,SAAQ,IAAI,CACV,gBAAgB,CAAC,WAAW,CAAC,EAC7B,YAAY,GAAG,MAAM,GAAG,uBAAuB,GAAG,QAAQ,GAAG,UAAU,GAAG,OAAO,CAClF;IACD,OAAO,EAAE,oBAAoB,CAAC,SAAS,EAAE,IAAI,EAAE,kBAAkB,CAAC,CAAC;IACnE,OAAO,EACH,gBAAgB,CAAC,oBAAoB,CAAC,SAAS,EAAE,IAAI,EAAE,kBAAkB,CAAC,CAAC,GAC3E,iBAAiB,CAAC,oBAAoB,CAAC,SAAS,EAAE,IAAI,EAAE,kBAAkB,CAAC,CAAC,CAAC;IACjF,OAAO,CAAC,EAAE,oBAAoB,CAC5B,oBAAoB,CAAC,SAAS,EAAE,IAAI,EAAE,kBAAkB,CAAC,EACzD,kBAAkB,CACnB,GAAG,4BAA4B,CAAC,WAAW,EAAE,kBAAkB,CAAC,CAAC;IAClE,SAAS,CAAC,EAAE,sBAAsB,CAChC,oBAAoB,CAAC,SAAS,EAAE,IAAI,EAAE,kBAAkB,CAAC,EACzD,oBAAoB,CACrB,GAAG,4BAA4B,CAAC,WAAW,EAAE,oBAAoB,CAAC,CAAC;IACpE,OAAO,CAAC,EAAE,oBAAoB,CAC5B,oBAAoB,CAAC,SAAS,EAAE,IAAI,EAAE,kBAAkB,CAAC,EACzD,uBAAuB,EACvB,WAAW,CACZ,CAAC;IACF,KAAK,CAAC,EAAE,WAAW,CAAC,WAAW,CAAC,CAAC;IACjC,MAAM,CAAC,CAAC,OAAO,EAAE,gBAAgB,CAAC,WAAW,CAAC,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACtE,QAAQ,CAAC,CAAC,OAAO,EAAE,oBAAoB,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAChE;AAED,KAAK,4BAA4B,CAC/B,MAAM,SAAS,SAAS,gBAAgB,EAAE,EAC1C,QAAQ,SAAS,SAAS,gBAAgB,EAAE,IAC1C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,KAAK,GACvD,OAAO,GACP;IAAE,QAAQ,CAAC,wBAAwB,EAAE,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,CAAA;CAAE,CAAC;AAgMrF;;;GAGG;AACH,wBAAgB,uBAAuB,CACrC,SAAS,EACT,IAAI,SAAS,aAAa,CAAC,SAAS,CAAC,EACrC,kBAAkB,GAAG,IAAI,EACzB,KAAK,CAAC,WAAW,SAAS,SAAS,gBAAgB,EAAE,GAAG,SAAS,EAAE,EACnE,kBAAkB,SAAS,SAAS,gBAAgB,EAAE,GAAG,WAAW,EACpE,oBAAoB,SAAS,SAAS,gBAAgB,EAAE,GAAG,WAAW,EAEtE,KAAK,EAAE,4BAA4B,CACjC,SAAS,EACT,IAAI,EACJ,kBAAkB,EAClB,WAAW,EACX,kBAAkB,EAClB,oBAAoB,CACrB,GACA,gBAAgB,CAAC,WAAW,CAAC,CAwJ/B"}

package/dist/toolkit/contest/FT8ContestPlugin.js

@@ -0,0 +1,322 @@
+import { assertPluginApiCompatible, comparePluginApiVersions } from '../../compatibility.js';
+import { isQueuedStrategyRuntime, } from '../../runtime.js';
+export const FT8_CONTEST_MIN_PLUGIN_API_VERSION = '2.5.0';
+export function defineFT8RuntimeModule(module) {
+    return module;
+}
+export function defineContestSessionModule(module) {
+    return module;
+}
+export function defineContestWorkbenchModule(module) {
+    return module;
+}
+function runtimeFactory(runtime) {
+    return typeof runtime === 'function' ? runtime : (contest, context) => runtime.create(contest, context);
+}
+function contestRuntimeContext(context, getMessagePresentation) {
+    if (!getMessagePresentation)
+        return context;
+    return {
+        ...context,
+        operator: {
+            ...context.operator,
+            async hasWorkedCallsign(callsign, options) {
+                const presentation = getMessagePresentation(context.operator.id);
+                if (!presentation)
+                    return context.operator.hasWorkedCallsign(callsign, options);
+                const normalizedCallsign = callsign.trim().toUpperCase();
+                const currentBand = context.radio.band.trim().toUpperCase();
+                return presentation.assignments.some((assignment) => (assignment.subject.trim().toUpperCase() === normalizedCallsign
+                    && (options?.anyBand === true || assignment.partition?.trim().toUpperCase() === currentBand)));
+            },
+        },
+    };
+}
+function decorateRuntime(runtime, decorate, context, getMessagePresentation) {
+    return new Proxy(runtime, {
+        get(target, property, receiver) {
+            if (property === 'decide') {
+                return async (...args) => {
+                    const result = await target.decide(...args);
+                    const messagePresentation = getMessagePresentation?.(context.operator.id);
+                    const qsoCompletion = result.qsoCompletion
+                        ? decorate(result.qsoCompletion, context)
+                        : undefined;
+                    const qsoCompletions = result.qsoCompletions?.map((effect) => decorate(effect, context));
+                    return {
+                        ...result,
+                        snapshot: messagePresentation
+                            ? { ...result.snapshot, messagePresentation }
+                            : result.snapshot,
+                        ...(qsoCompletion ? { qsoCompletion } : {}),
+                        ...(qsoCompletions ? { qsoCompletions } : {}),
+                    };
+                };
+            }
+            if (property === 'getSnapshot') {
+                return () => {
+                    const snapshot = target.getSnapshot();
+                    const messagePresentation = getMessagePresentation?.(context.operator.id);
+                    return messagePresentation ? { ...snapshot, messagePresentation } : snapshot;
+                };
+            }
+            const value = Reflect.get(target, property, receiver);
+            return typeof value === 'function' ? value.bind(target) : value;
+        },
+    });
+}
+function mergeHooks(hooks) {
+    const active = hooks.filter((hook) => hook !== undefined);
+    if (active.length === 0)
+        return undefined;
+    return {
+        async onAutoCallCandidate(slotInfo, messages, ctx) {
+            let proposal;
+            for (const hook of active) {
+                proposal = await hook.onAutoCallCandidate?.(slotInfo, messages, ctx) ?? proposal;
+            }
+            return proposal;
+        },
+        async onConfigureAutoCallExecution(request, plan, ctx) {
+            let nextPlan = plan;
+            for (const hook of active) {
+                nextPlan = await hook.onConfigureAutoCallExecution?.(request, nextPlan, ctx) ?? nextPlan;
+            }
+            return nextPlan;
+        },
+        async onFilterCandidates(candidates, ctx) {
+            let next = candidates;
+            for (const hook of active) {
+                next = await hook.onFilterCandidates?.(next, ctx) ?? next;
+            }
+            return next;
+        },
+        async onScoreCandidates(candidates, ctx) {
+            let next = candidates;
+            for (const hook of active) {
+                next = await hook.onScoreCandidates?.(next, ctx) ?? next;
+            }
+            return next;
+        },
+        async onSlotStart(slotInfo, messages, ctx) {
+            for (const hook of active)
+                await hook.onSlotStart?.(slotInfo, messages, ctx);
+        },
+        async onSlotActivity(event, ctx) {
+            for (const hook of active)
+                await hook.onSlotActivity?.(event, ctx);
+        },
+        async onDecode(messages, ctx) {
+            for (const hook of active)
+                await hook.onDecode?.(messages, ctx);
+        },
+        async onFrequencyChange(state, ctx) {
+            for (const hook of active)
+                await hook.onFrequencyChange?.(state, ctx);
+        },
+        async onQSOStart(info, ctx) {
+            for (const hook of active)
+                await hook.onQSOStart?.(info, ctx);
+        },
+        async onQSOComplete(record, ctx) {
+            for (const hook of active)
+                await hook.onQSOComplete?.(record, ctx);
+        },
+        async onQSOFail(info, ctx) {
+            for (const hook of active)
+                await hook.onQSOFail?.(info, ctx);
+        },
+        async onTimer(timerId, ctx) {
+            for (const hook of active)
+                await hook.onTimer?.(timerId, ctx);
+        },
+        async onUserAction(actionId, payload, ctx) {
+            for (const hook of active)
+                await hook.onUserAction?.(actionId, payload, ctx);
+        },
+        async onConfigChange(changes, ctx) {
+            for (const hook of active)
+                await hook.onConfigChange?.(changes, ctx);
+        },
+    };
+}
+function mergeRecordMap(first, second) {
+    const merged = { ...(first ?? {}), ...(second ?? {}) };
+    return (Object.keys(merged).length > 0 ? merged : undefined);
+}
+function mergeArrayById(first, second) {
+    const result = [];
+    const index = new Map();
+    for (const item of [...first ?? [], ...second ?? []]) {
+        const existing = index.get(item.id);
+        if (existing === undefined) {
+            index.set(item.id, result.length);
+            result.push(item);
+            continue;
+        }
+        result[existing] = item;
+    }
+    return result.length > 0 ? result : undefined;
+}
+function mergeQuickSettings(first, second) {
+    const result = [];
+    const index = new Map();
+    for (const item of [...first ?? [], ...second ?? []]) {
+        const existing = index.get(item.settingKey);
+        if (existing === undefined) {
+            index.set(item.settingKey, result.length);
+            result.push(item);
+            continue;
+        }
+        result[existing] = item;
+    }
+    return result.length > 0 ? result : undefined;
+}
+function assertContestRuntimeFeatures(runtime, features) {
+    if (features.targetQueue === 1 && !isQueuedStrategyRuntime(runtime)) {
+        throw new Error('contest_runtime_target_queue_requires_queued_strategy');
+    }
+    if (features.parallelTargetQueue === 1
+        && (typeof runtime.getTransmissions !== 'function'
+            || typeof runtime.onTransmissionsCompleted !== 'function')) {
+        throw new Error('contest_runtime_parallel_queue_requires_parallel_runtime');
+    }
+}
+/**
+ * Convenience assembler for an operator-scoped FT8 strategy plugin.
+ * Authors can skip it and wire the same public modules through definePlugin().
+ */
+export function composeFT8ContestPlugin(input) {
+    const { contest, runtime, session, workbench, logbook, hooks, settings, quickSettings, panels, ui, onLoad, onUnload, strategyFeatures, minPluginApiVersion: declaredMinPluginApiVersion, ...metadata } = input;
+    if (declaredMinPluginApiVersion
+        && (comparePluginApiVersions(declaredMinPluginApiVersion, FT8_CONTEST_MIN_PLUGIN_API_VERSION) ?? -1) < 0) {
+        throw new Error(`contest_plugin_api_floor_too_low:${declaredMinPluginApiVersion}`);
+    }
+    const minPluginApiVersion = declaredMinPluginApiVersion
+        ?? FT8_CONTEST_MIN_PLUGIN_API_VERSION;
+    const createRuntime = runtimeFactory(runtime);
+    const cleanups = new Map();
+    const requiredOperatingFeatures = {
+        ...(contest.operating.humanInitiation === 'required' ? { manualInitiation: 1 } : {}),
+        maxConcurrentStreams: contest.operating.maxConcurrentQsos,
+        maxSimultaneousSignals: contest.operating.maxSimultaneousSignals,
+    };
+    for (const key of [
+        'manualInitiation',
+        'maxConcurrentStreams',
+        'maxSimultaneousSignals',
+    ]) {
+        if (requiredOperatingFeatures[key] !== undefined
+            && strategyFeatures?.[key] !== undefined
+            && strategyFeatures[key] !== requiredOperatingFeatures[key]) {
+            throw new Error(`contest_operating_strategy_feature_conflict:${key}`);
+        }
+    }
+    const mergedFeatures = {
+        ...strategyFeatures,
+        ...requiredOperatingFeatures,
+    };
+    if (contest.operating.maxConcurrentQsos > 1) {
+        mergedFeatures.targetQueue = 1;
+        mergedFeatures.parallelTargetQueue = 1;
+    }
+    if (mergedFeatures.parallelTargetQueue === 1 && mergedFeatures.targetQueue !== 1) {
+        throw new Error('contest_operating_parallel_queue_requires_target_queue');
+    }
+    if (mergedFeatures.queueActivation !== undefined && mergedFeatures.targetQueue !== 1) {
+        throw new Error('contest_operating_queue_activation_requires_target_queue');
+    }
+    if (logbook && !metadata.permissions?.includes('logbook:session')) {
+        throw new Error('contest_logbook_missing_permission:logbook:session');
+    }
+    if (logbook && !metadata.permissions?.includes('plugin:event-bus')) {
+        throw new Error('contest_logbook_missing_permission:plugin:event-bus');
+    }
+    const mergedHooks = mergeHooks([logbook?.hooks, hooks]);
+    const mergedSettings = mergeRecordMap(logbook?.settings, settings);
+    const mergedQuickSettings = mergeQuickSettings(logbook?.quickSettings, quickSettings);
+    const mergedPanels = mergeArrayById(logbook?.panels, panels);
+    const mergedUi = logbook?.ui || ui
+        ? {
+            dir: ui?.dir ?? logbook?.ui?.dir,
+            pages: mergeArrayById(logbook?.ui?.pages, ui?.pages),
+        }
+        : undefined;
+    const mergedSession = (session ?? logbook?.session);
+    const mergedWorkbench = (workbench ?? logbook?.workbench);
+    return {
+        ...metadata,
+        apiVersion: 2,
+        minPluginApiVersion,
+        type: 'strategy',
+        strategyFeatures: mergedFeatures,
+        ...(mergedSettings ? { settings: mergedSettings } : {}),
+        ...(mergedQuickSettings ? { quickSettings: mergedQuickSettings } : {}),
+        ...(mergedPanels ? { panels: mergedPanels } : {}),
+        ...(mergedUi ? { ui: mergedUi } : {}),
+        hooks: mergedHooks,
+        createStrategyRuntime(context) {
+            assertPluginApiCompatible(minPluginApiVersion, metadata.name, context.pluginApiVersion);
+            const runtime = createRuntime(contest, contestRuntimeContext(context, logbook?.getMessagePresentation));
+            assertContestRuntimeFeatures(runtime, mergedFeatures);
+            if (!logbook?.decorateCompletion && !logbook?.getMessagePresentation)
+                return runtime;
+            const decorateCompletion = logbook.decorateCompletion
+                ?? ((effect) => effect);
+            return decorateRuntime(runtime, decorateCompletion, context, logbook.getMessagePresentation);
+        },
+        async onLoad(context) {
+            const instanceCleanups = [];
+            cleanups.set(context.operator.id, instanceCleanups);
+            try {
+                if (mergedSession) {
+                    const cleanup = await mergedSession.setup({
+                        contest,
+                        context: context,
+                        pluginName: metadata.name,
+                    });
+                    if (cleanup)
+                        instanceCleanups.push(cleanup);
+                }
+                if (mergedWorkbench) {
+                    const cleanup = await mergedWorkbench.setup({
+                        contest,
+                        context: context,
+                        pluginName: metadata.name,
+                    });
+                    if (cleanup)
+                        instanceCleanups.push(cleanup);
+                }
+                await onLoad?.(context);
+            }
+            catch (error) {
+                cleanups.delete(context.operator.id);
+                for (const cleanup of instanceCleanups.reverse())
+                    await cleanup(context);
+                throw error;
+            }
+        },
+        async onUnload(context) {
+            let firstError;
+            try {
+                await onUnload?.(context);
+            }
+            catch (error) {
+                firstError = error;
+            }
+            const instanceCleanups = cleanups.get(context.operator.id) ?? [];
+            cleanups.delete(context.operator.id);
+            for (const cleanup of instanceCleanups.reverse()) {
+                try {
+                    await cleanup(context);
+                }
+                catch (error) {
+                    firstError ??= error;
+                }
+            }
+            if (firstError)
+                throw firstError;
+        },
+    };
+}
+//# sourceMappingURL=FT8ContestPlugin.js.map

package/dist/toolkit/contest/FT8ContestPlugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FT8ContestPlugin.js","sourceRoot":"","sources":["../../../src/toolkit/contest/FT8ContestPlugin.ts"],"names":[],"mappings":"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"}

package/dist/toolkit/contest/FT8ContestTestKit.d.ts

@@ -0,0 +1,12 @@
+import { type FT8ContestDefinition } from './FT8ContestDefinition.js';
+import type { CompletionEvidence, ContestExchangeFields, ContestScoreSummary, FT8ContestQso } from './FT8ContestModules.js';
+/** Framework-neutral golden assertions for a composed contest definition. */
+export declare function createFT8ContestTestKit<TExchange, TQso extends FT8ContestQso<TExchange>, TSubmissionOptions = void>(contest: FT8ContestDefinition<TExchange, TQso, TSubmissionOptions>): {
+    exchange(fields: ContestExchangeFields, expected: TExchange, canonicalFields?: ContestExchangeFields): void;
+    invalidExchange(fields: Readonly<Record<string, string>>, expectedCode: string): void;
+    completion(evidence: CompletionEvidence<TExchange>, expected: boolean): void;
+    dupe(first: TQso, second: TQso, expected?: boolean): void;
+    score(records: readonly TQso[], expected: Partial<ContestScoreSummary>): void;
+    submission(records: readonly TQso[], options: TSubmissionOptions, expected: string): void;
+};
+//# sourceMappingURL=FT8ContestTestKit.d.ts.map

package/dist/toolkit/contest/FT8ContestTestKit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FT8ContestTestKit.d.ts","sourceRoot":"","sources":["../../../src/toolkit/contest/FT8ContestTestKit.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,oBAAoB,EAC1B,MAAM,2BAA2B,CAAC;AACnC,OAAO,KAAK,EACV,kBAAkB,EAClB,qBAAqB,EACrB,mBAAmB,EACnB,aAAa,EACd,MAAM,wBAAwB,CAAC;AAwBhC,6EAA6E;AAC7E,wBAAgB,uBAAuB,CACrC,SAAS,EACT,IAAI,SAAS,aAAa,CAAC,SAAS,CAAC,EACrC,kBAAkB,GAAG,IAAI,EACzB,OAAO,EAAE,oBAAoB,CAAC,SAAS,EAAE,IAAI,EAAE,kBAAkB,CAAC;qBAGtD,qBAAqB,YACnB,SAAS,oBACF,qBAAqB,GACrC,IAAI;4BAciB,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,gBAAgB,MAAM,GAAG,IAAI;yBAMhE,kBAAkB,CAAC,SAAS,CAAC,YAAY,OAAO,GAAG,IAAI;gBAGhE,IAAI,UAAU,IAAI,uBAAoB,IAAI;mBAGvC,SAAS,IAAI,EAAE,YAAY,OAAO,CAAC,mBAAmB,CAAC,GAAG,IAAI;wBAMzD,SAAS,IAAI,EAAE,WAAW,kBAAkB,YAAY,MAAM,GAAG,IAAI;EAI5F"}

package/dist/toolkit/contest/FT8ContestTestKit.js

@@ -0,0 +1,60 @@
+import { formatFT8ContestSubmission, scoreFT8ContestQsos, } from './FT8ContestDefinition.js';
+function canonicalize(value) {
+    if (Array.isArray(value))
+        return value.map(canonicalize);
+    if (value && typeof value === 'object') {
+        return Object.fromEntries(Object.entries(value)
+            .sort(([left], [right]) => left.localeCompare(right))
+            .map(([key, nested]) => [key, canonicalize(nested)]));
+    }
+    return value;
+}
+function stableJson(value) {
+    return JSON.stringify(canonicalize(value));
+}
+function assertEqual(actual, expected, label) {
+    if (stableJson(actual) !== stableJson(expected)) {
+        throw new Error(`${label}: expected ${JSON.stringify(expected)}, received ${JSON.stringify(actual)}`);
+    }
+}
+/** Framework-neutral golden assertions for a composed contest definition. */
+export function createFT8ContestTestKit(contest) {
+    return {
+        exchange(fields, expected, canonicalFields = contest.exchange.encode(expected)) {
+            const decoded = contest.exchange.decode(fields);
+            if (!decoded.ok) {
+                throw new Error(`contest_exchange_decode_failed:${decoded.issues.map((issue) => issue.code).join(',')}`);
+            }
+            assertEqual(decoded.value, expected, 'contest_exchange_mismatch');
+            const encoded = contest.exchange.encode(decoded.value);
+            assertEqual(encoded, canonicalFields, 'contest_exchange_canonical_fields_mismatch');
+            const roundTripped = contest.exchange.decode(encoded);
+            if (!roundTripped.ok) {
+                throw new Error(`contest_exchange_round_trip_failed:${roundTripped.issues.map((issue) => issue.code).join(',')}`);
+            }
+            assertEqual(roundTripped.value, expected, 'contest_exchange_round_trip_mismatch');
+        },
+        invalidExchange(fields, expectedCode) {
+            const decoded = contest.exchange.decode(fields);
+            if (decoded.ok || !decoded.issues.some((issue) => issue.code === expectedCode)) {
+                throw new Error(`contest_exchange_expected_issue:${expectedCode}`);
+            }
+        },
+        completion(evidence, expected) {
+            assertEqual(contest.completion.evaluate(evidence).complete, expected, 'contest_completion_mismatch');
+        },
+        dupe(first, second, expected = true) {
+            assertEqual(contest.dupe.key(first) === contest.dupe.key(second), expected, 'contest_dupe_mismatch');
+        },
+        score(records, expected) {
+            const summary = scoreFT8ContestQsos(contest, records);
+            for (const [key, value] of Object.entries(expected)) {
+                assertEqual(summary[key], value, `contest_score_${key}_mismatch`);
+            }
+        },
+        submission(records, options, expected) {
+            assertEqual(formatFT8ContestSubmission(contest, records, options), expected, 'contest_submission_mismatch');
+        },
+    };
+}
+//# sourceMappingURL=FT8ContestTestKit.js.map

package/dist/toolkit/contest/FT8ContestTestKit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FT8ContestTestKit.js","sourceRoot":"","sources":["../../../src/toolkit/contest/FT8ContestTestKit.ts"],"names":[],"mappings":"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"}

package/dist/toolkit/contest/contest-toolkit.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=contest-toolkit.test.d.ts.map

package/dist/toolkit/contest/contest-toolkit.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contest-toolkit.test.d.ts","sourceRoot":"","sources":["../../../src/toolkit/contest/contest-toolkit.test.ts"],"names":[],"mappings":""}