@tx5dr/contracts 1.2.2 → 1.4.0

package/src/schema/websocket.schema.ts

@@ -26,6 +26,7 @@ import { RadioInfoSchema, HamlibConfigSchema, TunerStatusSchema, TunerCapabiliti
 import { RadioProfileSchema, ProfileChangedEventSchema } from './radio-profile.schema.js';
 import { UserRole } from './auth.schema.js';
 import type { VoicePTTLock } from './voice.schema.js';
+import type { VoiceKeyerStatus } from './voice-keyer.schema.js';
 import { CapabilityListSchema, CapabilityStateSchema, WriteCapabilityPayloadSchema } from './radio-capability.schema.js';
 import { RadioPowerStateEventSchema } from './radio-power.schema.js';
 import { AudioSidecarStatusPayloadSchema } from './audio-sidecar.schema.js';
@@ -116,6 +117,9 @@ export enum WSMessageType {
   // ===== 电台数值表 =====
   METER_DATA = 'meterData',
 
+  // ===== 电台实际静噪状态 =====
+  SQUELCH_STATUS_CHANGED = 'squelchStatusChanged',
+
   // ===== 极简文本消息 =====
   TEXT_MESSAGE = 'textMessage',
 
@@ -164,6 +168,9 @@ export enum WSMessageType {
   VOICE_PTT_LOCK_CHANGED = 'voicePttLockChanged',
   VOICE_SET_RADIO_MODE = 'voiceSetRadioMode',
   VOICE_RADIO_MODE_CHANGED = 'voiceRadioModeChanged',
+  VOICE_KEYER_PLAY = 'voiceKeyerPlay',
+  VOICE_KEYER_STOP = 'voiceKeyerStop',
+  VOICE_KEYER_STATUS_CHANGED = 'voiceKeyerStatusChanged',
 
   // ===== 进程监控 =====
   PROCESS_SNAPSHOT = 'processSnapshot',
@@ -259,6 +266,14 @@ export const PTTStatusSchema = z.object({
   operatorIds: z.array(z.string()),
 });
 
+export const SquelchStatusSchema = z.object({
+  supported: z.boolean(),
+  open: z.boolean().nullable(),
+  muted: z.boolean(),
+  source: z.enum(['hamlib-dcd', 'unsupported']),
+  updatedAt: z.number(),
+});
+
 export const OperatorRuntimeSlotSchema = z.enum(['TX1', 'TX2', 'TX3', 'TX4', 'TX5', 'TX6']);
 export type OperatorRuntimeSlot = z.infer<typeof OperatorRuntimeSlotSchema>;
 
@@ -357,6 +372,7 @@ export type SubWindowInfo = z.infer<typeof SubWindowInfoSchema>;
 export type DecodeErrorInfo = z.infer<typeof DecodeErrorInfoSchema>;
 export type FrequencyState = z.infer<typeof FrequencyStateSchema>;
 export type PTTStatus = z.infer<typeof PTTStatusSchema>;
+export type SquelchStatus = z.infer<typeof SquelchStatusSchema>;
 export type MeterData = z.infer<typeof MeterDataSchema>;
 
 // ===== WebSocket消息Schema定义 =====
@@ -526,11 +542,6 @@ export const OperatorStatusSchema = z.object({
     availableSlots: z.array(z.string()),
   }),
   runtime: StrategyRuntimeSnapshotSchema.optional(),
-  cycleInfo: z.object({
-    currentCycle: z.number(),
-    isTransmitCycle: z.boolean(),
-    cycleProgress: z.number().min(0).max(1), // 0-1 表示周期进度百分比
-  }).optional(),
   // TX1-TX6 时隙内容
   slots: z.object({
     TX1: z.string().optional(),
@@ -1020,6 +1031,13 @@ export const WSMeterDataMessageSchema = WSBaseMessageSchema.extend({
 
 export type WSMeterDataMessage = z.infer<typeof WSMeterDataMessageSchema>;
 
+export const WSSquelchStatusChangedMessageSchema = WSBaseMessageSchema.extend({
+  type: z.literal(WSMessageType.SQUELCH_STATUS_CHANGED),
+  data: SquelchStatusSchema,
+});
+
+export type WSSquelchStatusChangedMessage = z.infer<typeof WSSquelchStatusChangedMessageSchema>;
+
 /**
  * 文本消息（Toast通知）
  * 用于向客户端推送提示信息
@@ -1270,6 +1288,7 @@ export const WSMessageSchema = z.discriminatedUnion('type', [
 
   // 电台数值表消息
   WSMeterDataMessageSchema,
+  WSSquelchStatusChangedMessageSchema,
 
   // 文本消息（Toast通知）
   WSTextMessageSchema,
@@ -1404,6 +1423,9 @@ export interface DigitalRadioEngineEvents {
   // 电台数值表事件
   meterData: (data: MeterData) => void;
 
+  // 电台实际静噪状态事件
+  squelchStatusChanged: (data: SquelchStatus) => void;
+
   // QSO 日志事件
   qsoRecordAdded: (data: { operatorId: string; logBookId: string; qsoRecord: z.infer<typeof QSORecordSchema> }) => void;
   qsoRecordUpdated: (data: { operatorId: string; logBookId: string; qsoRecord: z.infer<typeof QSORecordSchema> }) => void;
@@ -1439,6 +1461,7 @@ export interface DigitalRadioEngineEvents {
   // 语音模式事件
   voicePttLockChanged: (data: VoicePTTLock) => void;
   voiceRadioModeChanged: (data: { radioMode: string }) => void;
+  voiceKeyerStatusChanged: (data: VoiceKeyerStatus) => void;
 
   // 进程监控事件
   processSnapshot: (data: import('./process-monitor.schema.js').ProcessSnapshot) => void;

package/test/plugin-slot-schema.test.ts

@@ -0,0 +1,30 @@
+import { describe, expect, it } from 'vitest';
+import { PluginPanelDescriptorSchema, PluginPanelSlotSchema } from '../src/schema/plugin.schema';
+
+describe('PluginPanelSlotSchema', () => {
+  it('accepts every supported plugin panel slot', () => {
+    expect(PluginPanelSlotSchema.parse('operator')).toBe('operator');
+    expect(PluginPanelSlotSchema.parse('automation')).toBe('automation');
+    expect(PluginPanelSlotSchema.parse('main-right')).toBe('main-right');
+    expect(PluginPanelSlotSchema.parse('voice-left-top')).toBe('voice-left-top');
+    expect(PluginPanelSlotSchema.parse('voice-right-top')).toBe('voice-right-top');
+  });
+
+  it('validates iframe panels declared in the new host slots', () => {
+    expect(() => PluginPanelDescriptorSchema.parse({
+      id: 'main-pane',
+      title: 'mainPaneTitle',
+      component: 'iframe',
+      pageId: 'main-pane',
+      slot: 'main-right',
+    })).not.toThrow();
+
+    expect(() => PluginPanelDescriptorSchema.parse({
+      id: 'voice-top',
+      title: 'voiceTopTitle',
+      component: 'iframe',
+      pageId: 'voice-top',
+      slot: 'voice-right-top',
+    })).not.toThrow();
+  });
+});