@tx5dr/plugin-api 1.0.0

package/dist/__tests__/ft8-message-type.test.d.ts

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

package/dist/__tests__/ft8-message-type.test.d.ts.map

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

package/dist/__tests__/ft8-message-type.test.js

@@ -0,0 +1,9 @@
+import { describe, it, expect } from 'vitest';
+import { FT8MessageType as InlinedType } from '../ft8-message-type.js';
+import { FT8MessageType as ContractsType } from '@tx5dr/contracts';
+describe('FT8MessageType inlining', () => {
+    it('must match the contracts source of truth', () => {
+        expect(InlinedType).toStrictEqual(ContractsType);
+    });
+});
+//# sourceMappingURL=ft8-message-type.test.js.map

package/dist/__tests__/ft8-message-type.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ft8-message-type.test.js","sourceRoot":"","sources":["../../src/__tests__/ft8-message-type.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,cAAc,IAAI,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACvE,OAAO,EAAE,cAAc,IAAI,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEnE,QAAQ,CAAC,yBAAyB,EAAE,GAAG,EAAE;IACvC,EAAE,CAAC,0CAA0C,EAAE,GAAG,EAAE;QAClD,MAAM,CAAC,WAAW,CAAC,CAAC,aAAa,CAAC,aAAa,CAAC,CAAC;IACnD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/__tests__/testing-utils.test.d.ts

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

package/dist/__tests__/testing-utils.test.d.ts.map

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

package/dist/__tests__/testing-utils.test.js

@@ -0,0 +1,151 @@
+import { describe, it, expect } from 'vitest';
+import { createMockKVStore, createMockLogger, createMockTimers, createMockUIBridge, createMockContext, createMockSlotInfo, createMockParsedMessage, createMockOperatorControl, createMockRadioControl, createMockLogbookAccess, createMockBandAccess, } from '../testing/index.js';
+describe('plugin-api testing utilities', () => {
+    describe('createMockKVStore', () => {
+        it('supports get/set/delete/getAll', () => {
+            const store = createMockKVStore({ key1: 'value1' });
+            expect(store.get('key1')).toBe('value1');
+            expect(store.get('missing', 'default')).toBe('default');
+            store.set('key2', 42);
+            expect(store._data.get('key2')).toBe(42);
+            store.delete('key1');
+            expect(store.getAll()).toEqual({ key2: 42 });
+        });
+    });
+    describe('createMockLogger', () => {
+        it('records all log calls', () => {
+            const log = createMockLogger();
+            log.debug('d', { a: 1 });
+            log.info('i');
+            log.warn('w');
+            log.error('e', new Error('test'));
+            expect(log._calls).toHaveLength(4);
+            expect(log._calls[0]).toEqual({ level: 'debug', message: 'd', data: { a: 1 } });
+            expect(log._calls[1]).toEqual({ level: 'info', message: 'i', data: undefined });
+        });
+    });
+    describe('createMockTimers', () => {
+        it('tracks active timers', () => {
+            const timers = createMockTimers();
+            timers.set('poll', 5000);
+            expect(timers._active.get('poll')).toBe(5000);
+            timers.clear('poll');
+            expect(timers._active.size).toBe(0);
+        });
+        it('clearAll removes all timers', () => {
+            const timers = createMockTimers();
+            timers.set('a', 100);
+            timers.set('b', 200);
+            timers.clearAll();
+            expect(timers._active.size).toBe(0);
+        });
+    });
+    describe('createMockUIBridge', () => {
+        it('captures sent panel data', () => {
+            const ui = createMockUIBridge();
+            ui.send('my-panel', { count: 1 });
+            ui.send('my-panel', { count: 2 });
+            expect(ui._sentData.get('my-panel')).toEqual([{ count: 1 }, { count: 2 }]);
+        });
+    });
+    describe('createMockContext', () => {
+        it('creates a full context with defaults', () => {
+            const ctx = createMockContext();
+            expect(ctx.operator.callsign).toBe('W1AW');
+            expect(ctx.operator.grid).toBe('FN31');
+            expect(ctx.radio.isConnected).toBe(true);
+            expect(ctx.config).toEqual({});
+        });
+        it('accepts overrides', () => {
+            const ctx = createMockContext({
+                callsign: 'JA1ABC',
+                grid: 'PM95',
+                config: { watchNewDxcc: true },
+                radio: { band: '40m', frequency: 7074000 },
+            });
+            expect(ctx.operator.callsign).toBe('JA1ABC');
+            expect(ctx.operator.grid).toBe('PM95');
+            expect(ctx.config).toEqual({ watchNewDxcc: true });
+            expect(ctx.radio.band).toBe('40m');
+        });
+        it('provides typed access to sub-mocks', () => {
+            const ctx = createMockContext();
+            ctx.store.global.set('k', 'v');
+            expect(ctx.store.global._data.get('k')).toBe('v');
+            ctx.log.info('test');
+            expect(ctx.log._calls).toHaveLength(1);
+        });
+    });
+    describe('createMockOperatorControl', () => {
+        it('has reasonable defaults', () => {
+            const op = createMockOperatorControl();
+            expect(op.isTransmitting).toBe(false);
+            expect(op.mode.name).toBe('FT8');
+        });
+        it('supports partial overrides', () => {
+            const op = createMockOperatorControl({ isTransmitting: true, callsign: 'K1ABC' });
+            expect(op.isTransmitting).toBe(true);
+            expect(op.callsign).toBe('K1ABC');
+        });
+    });
+    describe('createMockRadioControl', () => {
+        it('provides connected radio by default', () => {
+            const radio = createMockRadioControl();
+            expect(radio.isConnected).toBe(true);
+            expect(radio.frequency).toBe(14074000);
+        });
+    });
+    describe('createMockLogbookAccess', () => {
+        it('returns false by default for all queries', async () => {
+            const logbook = createMockLogbookAccess();
+            expect(await logbook.hasWorked('W1AW')).toBe(false);
+            expect(await logbook.hasWorkedDXCC('US')).toBe(false);
+            expect(await logbook.hasWorkedGrid('FN31')).toBe(false);
+        });
+        it('accepts custom implementations', async () => {
+            const worked = new Set(['W1AW']);
+            const logbook = createMockLogbookAccess({
+                hasWorked: async (cs) => worked.has(cs),
+            });
+            expect(await logbook.hasWorked('W1AW')).toBe(true);
+            expect(await logbook.hasWorked('K2ABC')).toBe(false);
+        });
+    });
+    describe('createMockBandAccess', () => {
+        it('returns empty/null defaults', () => {
+            const band = createMockBandAccess();
+            expect(band.getActiveCallers()).toEqual([]);
+            expect(band.getLatestSlotPack()).toBeNull();
+            expect(band.findIdleTransmitFrequency()).toBeNull();
+        });
+    });
+    describe('createMockSlotInfo', () => {
+        it('provides FT8 defaults', () => {
+            const slot = createMockSlotInfo();
+            expect(slot.mode).toBe('FT8');
+            expect(slot.id).toBe('slot-0');
+        });
+        it('accepts overrides', () => {
+            const slot = createMockSlotInfo({ id: 'slot-42', cycleNumber: 5 });
+            expect(slot.id).toBe('slot-42');
+            expect(slot.cycleNumber).toBe(5);
+        });
+    });
+    describe('createMockParsedMessage', () => {
+        it('creates a CQ message by default', () => {
+            const msg = createMockParsedMessage();
+            expect(msg.message.type).toBe('cq');
+            expect(msg.rawMessage).toBe('CQ TEST W1AW FN31');
+        });
+        it('accepts overrides', () => {
+            const msg = createMockParsedMessage({
+                snr: 5,
+                rawMessage: 'CQ DX JA1ABC PM95',
+                message: { type: 'cq', senderCallsign: 'JA1ABC', grid: 'PM95' },
+            });
+            expect(msg.snr).toBe(5);
+            expect(msg.rawMessage).toBe('CQ DX JA1ABC PM95');
+        });
+    });
+});
+//# sourceMappingURL=testing-utils.test.js.map

package/dist/__tests__/testing-utils.test.js.map

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

package/dist/context.d.ts

@@ -0,0 +1,82 @@
+import type { KVStore, PluginLogger, PluginTimers, OperatorControl, RadioControl, LogbookAccess, BandAccess, UIBridge } from './helpers.js';
+/**
+ * Runtime services exposed to a plugin instance.
+ *
+ * The host creates a {@link PluginContext} for each loaded plugin/operator
+ * combination. It is the main entry point for everything that a plugin can do
+ * at runtime: read resolved settings, persist state, control the operator,
+ * interact with the radio, publish UI updates and, when permitted, perform HTTP
+ * requests.
+ *
+ * The context is intentionally capability-oriented. If a method is not exposed
+ * here, plugin code should treat it as unavailable rather than reaching into
+ * TX-5DR internals.
+ */
+export interface PluginContext {
+    /**
+     * Resolved plugin configuration values.
+     *
+     * The host validates and persists settings, then injects the final values into
+     * this readonly map before invoking hooks or lifecycle methods. Use
+     * {@link PluginHooks.onConfigChange} to react to updates.
+     */
+    readonly config: Readonly<Record<string, unknown>>;
+    /**
+     * Persistent key-value stores provisioned for the plugin.
+     *
+     * Each scope is isolated by plugin identity. Use `global` for shared plugin
+     * data and `operator` for values that should not leak across operators.
+     */
+    readonly store: {
+        /**
+         * Storage shared by all operators and all sessions of this plugin.
+         */
+        readonly global: KVStore;
+        /**
+         * Storage isolated to the current operator instance.
+         */
+        readonly operator: KVStore;
+    };
+    /**
+     * Structured logger scoped to the plugin.
+     *
+     * Messages typically appear in backend logs and, when applicable, in frontend
+     * plugin log views.
+     */
+    readonly log: PluginLogger;
+    /**
+     * Named timer manager owned by the host.
+     *
+     * Timers created here are automatically cleaned up when the plugin unloads, so
+     * prefer this over raw `setInterval` calls inside plugin code.
+     */
+    readonly timers: PluginTimers;
+    /**
+     * Control surface for the current operator.
+     */
+    readonly operator: OperatorControl;
+    /**
+     * Access to the physical radio state and tuning controls.
+     */
+    readonly radio: RadioControl;
+    /**
+     * Read-only access to logbook-derived history.
+     */
+    readonly logbook: LogbookAccess;
+    /**
+     * Read-only access to current-band and slot decode data.
+     */
+    readonly band: BandAccess;
+    /**
+     * Bridge for pushing structured data into declarative plugin panels.
+     */
+    readonly ui: UIBridge;
+    /**
+     * Permission-gated HTTP client.
+     *
+     * This method is only available when the plugin declares the corresponding
+     * network permission. Treat it as optional and feature-detect before calling.
+     */
+    readonly fetch?: (url: string, init?: RequestInit) => Promise<Response>;
+}
+//# sourceMappingURL=context.d.ts.map

package/dist/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,OAAO,EACP,YAAY,EACZ,YAAY,EACZ,eAAe,EACf,YAAY,EACZ,aAAa,EACb,UAAU,EACV,QAAQ,EACT,MAAM,cAAc,CAAC;AAEtB;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,aAAa;IAC5B;;;;;;OAMG;IACH,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAEnD;;;;;OAKG;IACH,QAAQ,CAAC,KAAK,EAAE;QACd;;WAEG;QACH,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;QAEzB;;WAEG;QACH,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;KAC5B,CAAC;IAEF;;;;;OAKG;IACH,QAAQ,CAAC,GAAG,EAAE,YAAY,CAAC;IAE3B;;;;;OAKG;IACH,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAE9B;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAC;IAEnC;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;IAE7B;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC;IAEhC;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAE1B;;OAEG;IACH,QAAQ,CAAC,EAAE,EAAE,QAAQ,CAAC;IAEtB;;;;;OAKG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;CACzE"}

package/dist/context.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=context.js.map

package/dist/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":""}

package/dist/definition.d.ts

@@ -0,0 +1,181 @@
+import type { PluginSettingDescriptor, PluginQuickAction, PluginQuickSetting, PluginPanelDescriptor, PluginPermission, PluginType } from '@tx5dr/contracts';
+import type { PluginContext } from './context.js';
+import type { PluginHooks } from './hooks.js';
+import type { StrategyRuntime } from './runtime.js';
+/**
+ * Describes a TX-5DR plugin module.
+ *
+ * The default export of a plugin package or entry file must satisfy this
+ * interface. It combines declarative metadata, optional UI descriptors and the
+ * runtime callbacks that the host invokes after the plugin is loaded.
+ *
+ * A plugin can be one of two categories:
+ * - `strategy`: owns the operator automation state machine and is mutually
+ *   exclusive per operator.
+ * - `utility`: augments the pipeline or UI and can run alongside other utility
+ *   plugins.
+ *
+ * The TX-5DR host reads this definition once during load, validates the static
+ * fields and then wires the lifecycle callbacks and hooks into the plugin
+ * subsystem.
+ *
+ * @example
+ * ```js
+ * /** @type {import('@tx5dr/plugin-api').PluginDefinition} *\/
+ * export default {
+ *   name: 'my-plugin',
+ *   version: '1.0.0',
+ *   type: 'utility',
+ *   description: 'Annotates interesting decoded stations.',
+ *   hooks: {
+ *     onDecode(messages, ctx) {
+ *       ctx.log.info('decoded', { count: messages.length });
+ *     },
+ *   },
+ * };
+ * ```
+ *
+ * @example
+ * ```ts
+ * import type { PluginDefinition } from '@tx5dr/plugin-api';
+ *
+ * const plugin: PluginDefinition = {
+ *   name: 'my-strategy',
+ *   version: '1.0.0',
+ *   type: 'strategy',
+ *   createStrategyRuntime(ctx) {
+ *     return {
+ *       decide() {
+ *         return { stop: false };
+ *       },
+ *       getTransmitText() {
+ *         return null;
+ *       },
+ *       requestCall() {},
+ *       getSnapshot() {
+ *         return { currentState: 'idle' };
+ *       },
+ *       patchContext() {},
+ *       setState() {},
+ *       setSlotContent() {},
+ *       reset() {},
+ *     };
+ *   },
+ * };
+ *
+ * export default plugin;
+ * ```
+ */
+export interface PluginDefinition {
+    /**
+     * Stable machine-readable plugin identifier.
+     *
+     * This value is used as the plugin's identity in manifests, persisted
+     * configuration, log records and runtime lookups. Treat it as an immutable ID
+     * once the plugin is released.
+     */
+    name: string;
+    /**
+     * Semantic version of the plugin implementation.
+     *
+     * The host does not currently enforce a compatibility policy, but publishing a
+     * valid semver string makes diagnostics and upgrades much easier.
+     */
+    version: string;
+    /**
+     * Declares how the host should schedule and combine this plugin.
+     *
+     * - `strategy` plugins provide a {@link StrategyRuntime} and are selected as
+     *   the active automation implementation for an operator.
+     * - `utility` plugins participate in filters, scoring, monitoring and UI, but
+     *   do not own the core automation state machine.
+     */
+    type: PluginType;
+    /**
+     * Human-readable summary shown in plugin management UIs.
+     *
+     * Keep this short and product-oriented so operators can quickly understand the
+     * plugin's purpose.
+     */
+    description?: string;
+    /**
+     * Explicitly declares privileged capabilities required by the plugin.
+     *
+     * Permissions allow the host to gate sensitive features such as network
+     * access. Always declare the smallest set that the plugin truly needs.
+     */
+    permissions?: PluginPermission[];
+    /**
+     * Declarative settings schema for generated configuration forms.
+     *
+     * Each key becomes a persisted config entry. The host validates and stores the
+     * values, then exposes the resolved runtime config through
+     * {@link PluginContext.config}. Use this for durable, user-facing settings
+     * rather than ephemeral runtime state.
+     */
+    settings?: Record<string, PluginSettingDescriptor>;
+    /**
+     * Lightweight button actions shown in operator-facing quick action areas.
+     *
+     * These are intended for one-shot commands such as reset, clear or manual
+     * trigger operations. When clicked, the host invokes
+     * {@link PluginHooks.onUserAction} with the configured action id.
+     */
+    quickActions?: PluginQuickAction[];
+    /**
+     * Quick settings surfaced in compact operator-facing automation panels.
+     *
+     * Use these for high-frequency adjustments that operators may need to tweak
+     * during operation, such as a threshold, target list or enable flag.
+     */
+    quickSettings?: PluginQuickSetting[];
+    /**
+     * Panel descriptors used to render plugin-owned UI sections.
+     *
+     * Panels are declarative containers. Plugins push live data into them through
+     * {@link PluginContext.ui} rather than rendering custom frontend code.
+     */
+    panels?: PluginPanelDescriptor[];
+    /**
+     * Declares which persistent storage scopes should be provisioned.
+     *
+     * Request `global` storage for data shared by the whole station, and
+     * `operator` storage for per-operator state. The corresponding stores are then
+     * available via {@link PluginContext.store}.
+     */
+    storage?: {
+        scopes: ('global' | 'operator')[];
+    };
+    /**
+     * Creates the strategy runtime for a `strategy` plugin.
+     *
+     * This method is required when {@link PluginDefinition.type} is `strategy` and
+     * should be omitted for utility plugins. The returned runtime becomes the
+     * operator's active automation controller.
+     */
+    createStrategyRuntime?(ctx: PluginContext): StrategyRuntime;
+    /**
+     * Runs after the plugin instance has been loaded and the context is ready.
+     *
+     * Use this for startup work such as warming caches, scheduling timers or
+     * sending initial panel data. Keep it fast; long-running work should be
+     * deferred or done asynchronously.
+     */
+    onLoad?(ctx: PluginContext): void | Promise<void>;
+    /**
+     * Runs before the plugin instance is unloaded.
+     *
+     * Use this to release external resources or flush state that is not already
+     * handled through the host abstractions. Any timers created via
+     * {@link PluginContext.timers} are cleared automatically by the host.
+     */
+    onUnload?(ctx: PluginContext): void | Promise<void>;
+    /**
+     * Event and pipeline hooks implemented by the plugin.
+     *
+     * Hooks let utility plugins observe or transform the message flow, and let the
+     * active strategy participate in decision making.
+     */
+    hooks?: PluginHooks;
+}
+//# sourceMappingURL=definition.d.ts.map

package/dist/definition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"definition.d.ts","sourceRoot":"","sources":["../src/definition.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,uBAAuB,EACvB,iBAAiB,EACjB,kBAAkB,EAClB,qBAAqB,EACrB,gBAAgB,EAChB,UAAU,EACX,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAEpD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+DG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;;;;OAMG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;;;;OAKG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;;;;;;OAOG;IACH,IAAI,EAAE,UAAU,CAAC;IAEjB;;;;;OAKG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;;;;OAKG;IACH,WAAW,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAEjC;;;;;;;OAOG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,uBAAuB,CAAC,CAAC;IAEnD;;;;;;OAMG;IACH,YAAY,CAAC,EAAE,iBAAiB,EAAE,CAAC;IAEnC;;;;;OAKG;IACH,aAAa,CAAC,EAAE,kBAAkB,EAAE,CAAC;IAErC;;;;;OAKG;IACH,MAAM,CAAC,EAAE,qBAAqB,EAAE,CAAC;IAEjC;;;;;;OAMG;IACH,OAAO,CAAC,EAAE;QAAE,MAAM,EAAE,CAAC,QAAQ,GAAG,UAAU,CAAC,EAAE,CAAA;KAAE,CAAC;IAEhD;;;;;;OAMG;IACH,qBAAqB,CAAC,CAAC,GAAG,EAAE,aAAa,GAAG,eAAe,CAAC;IAE5D;;;;;;OAMG;IACH,MAAM,CAAC,CAAC,GAAG,EAAE,aAAa,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAElD;;;;;;OAMG;IACH,QAAQ,CAAC,CAAC,GAAG,EAAE,aAAa,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEpD;;;;;OAKG;IACH,KAAK,CAAC,EAAE,WAAW,CAAC;CACrB"}

package/dist/definition.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=definition.js.map

package/dist/definition.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"definition.js","sourceRoot":"","sources":["../src/definition.ts"],"names":[],"mappings":""}

package/dist/ft8-message-type.d.ts

@@ -0,0 +1,21 @@
+/**
+ * FT8 message type discriminator values.
+ *
+ * Inlined from `@tx5dr/contracts` to keep `@tx5dr/plugin-api` free of runtime
+ * dependencies. The values MUST remain identical to those in
+ * `packages/contracts/src/schema/ft8.schema.ts`.
+ *
+ * A cross-check test in this package verifies they stay in sync.
+ */
+export declare const FT8MessageType: {
+    readonly CQ: "cq";
+    readonly CALL: "call";
+    readonly SIGNAL_REPORT: "signal_report";
+    readonly ROGER_REPORT: "roger_report";
+    readonly RRR: "rrr";
+    readonly SEVENTY_THREE: "73";
+    readonly FOX_RR73: "fox_rr73";
+    readonly CUSTOM: "custom";
+    readonly UNKNOWN: "unknown";
+};
+//# sourceMappingURL=ft8-message-type.d.ts.map

package/dist/ft8-message-type.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ft8-message-type.d.ts","sourceRoot":"","sources":["../src/ft8-message-type.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,eAAO,MAAM,cAAc;;;;;;;;;;CAUjB,CAAC"}

package/dist/ft8-message-type.js

@@ -0,0 +1,21 @@
+/**
+ * FT8 message type discriminator values.
+ *
+ * Inlined from `@tx5dr/contracts` to keep `@tx5dr/plugin-api` free of runtime
+ * dependencies. The values MUST remain identical to those in
+ * `packages/contracts/src/schema/ft8.schema.ts`.
+ *
+ * A cross-check test in this package verifies they stay in sync.
+ */
+export const FT8MessageType = {
+    CQ: 'cq',
+    CALL: 'call',
+    SIGNAL_REPORT: 'signal_report',
+    ROGER_REPORT: 'roger_report',
+    RRR: 'rrr',
+    SEVENTY_THREE: '73',
+    FOX_RR73: 'fox_rr73',
+    CUSTOM: 'custom',
+    UNKNOWN: 'unknown',
+};
+//# sourceMappingURL=ft8-message-type.js.map

package/dist/ft8-message-type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ft8-message-type.js","sourceRoot":"","sources":["../src/ft8-message-type.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,EAAE,EAAE,IAAI;IACR,IAAI,EAAE,MAAM;IACZ,aAAa,EAAE,eAAe;IAC9B,YAAY,EAAE,cAAc;IAC5B,GAAG,EAAE,KAAK;IACV,aAAa,EAAE,IAAI;IACnB,QAAQ,EAAE,UAAU;IACpB,MAAM,EAAE,QAAQ;IAChB,OAAO,EAAE,SAAS;CACV,CAAC"}