@tx5dr/contracts 1.7.0 → 1.7.2

package/src/schema/audio.schema.ts

@@ -7,19 +7,46 @@ export const AudioDeviceSchema = z.object({
   isDefault: z.boolean(),
   channels: z.number(),
   sampleRate: z.number(),
+  sampleRates: z.array(z.number().int().positive()).optional(),
   type: z.enum(['input', 'output']),
 });
 
+export const AudioDeviceResolutionStatusSchema = z.enum([
+  'selected',
+  'default',
+  'virtual-selected',
+  'missing',
+]);
+
+export const AudioDeviceResolutionSchema = z.object({
+  configuredDeviceName: z.string().nullable(),
+  configuredDevice: AudioDeviceSchema.nullable(),
+  effectiveDevice: AudioDeviceSchema.nullable(),
+  status: AudioDeviceResolutionStatusSchema,
+  reason: z.string().nullable().optional(),
+});
+
+export const AudioDeviceResolutionSetSchema = z.object({
+  input: AudioDeviceResolutionSchema,
+  output: AudioDeviceResolutionSchema,
+});
+
 // 音频设备列表响应
 export const AudioDevicesResponseSchema = z.object({
   inputDevices: z.array(AudioDeviceSchema),
   outputDevices: z.array(AudioDeviceSchema),
+  inputBufferSizes: z.array(z.number().int().positive()),
+  outputBufferSizes: z.array(z.number().int().positive()),
 });
 
 // 音频设备设置请求
 export const AudioDeviceSettingsSchema = z.object({
   inputDeviceName: z.string().optional(),  // 使用设备名称而非ID
   outputDeviceName: z.string().optional(), // 使用设备名称而非ID  
+  inputSampleRate: z.number().optional(),
+  outputSampleRate: z.number().optional(),
+  inputBufferSize: z.number().optional(),
+  outputBufferSize: z.number().optional(),
   sampleRate: z.number().optional(),
   bufferSize: z.number().optional(),
 });
@@ -29,6 +56,17 @@ export const AudioDeviceSettingsResponseSchema = z.object({
   success: z.boolean(),
   message: z.string().optional(),
   currentSettings: AudioDeviceSettingsSchema,
+  deviceResolution: AudioDeviceResolutionSetSchema,
+});
+
+export const AudioSettingsResolveRequestSchema = z.object({
+  audio: AudioDeviceSettingsSchema,
+  radioType: z.enum(['none', 'network', 'serial', 'icom-wlan']).optional(),
+});
+
+export const AudioSettingsResolveResponseSchema = z.object({
+  success: z.boolean(),
+  deviceResolution: AudioDeviceResolutionSetSchema,
 });
 
 // 音频流配置参数 (用于 Audify/RtAudio)
@@ -64,10 +102,15 @@ export const VolumeGainSchema = z.object({
 
 // 导出类型
 export type AudioDevice = z.infer<typeof AudioDeviceSchema>;
+export type AudioDeviceResolutionStatus = z.infer<typeof AudioDeviceResolutionStatusSchema>;
+export type AudioDeviceResolution = z.infer<typeof AudioDeviceResolutionSchema>;
+export type AudioDeviceResolutionSet = z.infer<typeof AudioDeviceResolutionSetSchema>;
 export type AudioDevicesResponse = z.infer<typeof AudioDevicesResponseSchema>;
 export type AudioDeviceSettings = z.infer<typeof AudioDeviceSettingsSchema>;
 export type AudioDeviceSettingsResponse = z.infer<typeof AudioDeviceSettingsResponseSchema>;
+export type AudioSettingsResolveRequest = z.infer<typeof AudioSettingsResolveRequestSchema>;
+export type AudioSettingsResolveResponse = z.infer<typeof AudioSettingsResolveResponseSchema>;
 export type AudioStreamConfig = z.infer<typeof AudioStreamConfigSchema>;
 export type AudioStreamEventData = z.infer<typeof AudioStreamEventDataSchema>;
 export type AudioMixerConfig = z.infer<typeof AudioMixerConfigSchema>;
-export type VolumeGain = z.infer<typeof VolumeGainSchema>; 
+export type VolumeGain = z.infer<typeof VolumeGainSchema>;

package/src/schema/logbook.schema.ts

@@ -191,6 +191,14 @@ export const LogBookExportOptionsSchema = z.object({
   startDate: z.string().optional(),
   endDate: z.string().optional(),
   callsign: z.string().optional(),
+  grid: z.string().optional(),
+  band: z.string().optional(),
+  mode: z.string().optional(),
+  dxccStatus: z.enum(['deleted']).optional(),
+  qslFlow: z.enum(['two_way_confirmed', 'not_two_way_confirmed']).optional(),
+  /** 排除的模式列表，逗号分隔，如 "FT8,FT4" */
+  excludeModes: z.string().optional(),
+  qslStatus: z.enum(['confirmed', 'uploaded', 'none']).optional(),
 });
 
 export const LogBookImportFormatSchema = z.enum(['adif', 'csv']);

package/src/schema/plugin.schema.ts

@@ -643,11 +643,17 @@ export const PluginRuntimeLogEntrySchema = z.object({
 });
 export type PluginRuntimeLogEntry = z.infer<typeof PluginRuntimeLogEntrySchema>;
 
+export const PluginLogHistoryEntrySchema = z.union([
+  PluginRuntimeLogEntrySchema,
+  PluginLogEntrySchema,
+]);
+export type PluginLogHistoryEntry = z.infer<typeof PluginLogHistoryEntrySchema>;
+
 /**
  * 宿主级插件运行日志历史响应载荷
  */
 export const PluginRuntimeLogHistoryPayloadSchema = z.object({
-  entries: z.array(PluginRuntimeLogEntrySchema),
+  entries: z.array(PluginLogHistoryEntrySchema),
 });
 export type PluginRuntimeLogHistoryPayload = z.infer<typeof PluginRuntimeLogHistoryPayloadSchema>;
 

package/src/schema/system.schema.ts

@@ -37,6 +37,7 @@ export const ClockStatusDetailSchema = ClockStatusSummarySchema.extend({
   syncState: ClockSyncStateSchema,
   serverUsed: z.string().nullable(),
   errorMessage: z.string().nullable(),
+  autoApplyOffset: z.boolean(),
 });
 export type ClockStatusDetail = z.infer<typeof ClockStatusDetailSchema>;
 
@@ -45,6 +46,11 @@ export const SetClockOffsetRequestSchema = z.object({
 });
 export type SetClockOffsetRequest = z.infer<typeof SetClockOffsetRequestSchema>;
 
+export const SetClockAutoApplyRequestSchema = z.object({
+  enabled: z.boolean(),
+});
+export type SetClockAutoApplyRequest = z.infer<typeof SetClockAutoApplyRequestSchema>;
+
 // ===== NTP server list settings =====
 
 function isValidIPv4Address(value: string): boolean {

package/src/schema/update.schema.ts

@@ -0,0 +1,33 @@
+import { z } from 'zod';
+import { PluginDistributionSchema } from './plugin.schema.js';
+
+export const SystemUpdateTargetSchema = z.enum([
+  'electron-app',
+  'linux-server',
+  'docker',
+]);
+export type SystemUpdateTarget = z.infer<typeof SystemUpdateTargetSchema>;
+
+export const SystemUpdateChannelSchema = z.enum(['release', 'nightly']);
+export type SystemUpdateChannel = z.infer<typeof SystemUpdateChannelSchema>;
+
+export const SystemUpdateStatusSchema = z.object({
+  target: SystemUpdateTargetSchema,
+  distribution: PluginDistributionSchema,
+  channel: SystemUpdateChannelSchema,
+  currentVersion: z.string(),
+  currentCommit: z.string().nullable(),
+  currentDigest: z.string().nullable().optional(),
+  latestVersion: z.string().nullable(),
+  latestCommit: z.string().nullable(),
+  latestDigest: z.string().nullable().optional(),
+  latestCommitTitle: z.string().nullable(),
+  publishedAt: z.string().nullable(),
+  releaseNotes: z.string().nullable(),
+  updateAvailable: z.boolean(),
+  identity: z.string().nullable(),
+  websiteUrl: z.string().url(),
+  metadataSource: z.enum(['oss', 'github']).nullable(),
+  errorMessage: z.string().nullable(),
+});
+export type SystemUpdateStatus = z.infer<typeof SystemUpdateStatusSchema>;

package/src/schema/websocket.schema.ts

@@ -113,6 +113,9 @@ export enum WSMessageType {
   PTT_STATUS_CHANGED = 'pttStatusChanged',
   FORCE_STOP_TRANSMISSION = 'forceStopTransmission',
   REMOVE_OPERATOR_FROM_TRANSMISSION = 'removeOperatorFromTransmission',
+  START_TUNE_TONE = 'startTuneTone',
+  STOP_TUNE_TONE = 'stopTuneTone',
+  TUNE_TONE_STATUS_CHANGED = 'tuneToneStatusChanged',
 
   // ===== 电台数值表 =====
   METER_DATA = 'meterData',
@@ -267,6 +270,21 @@ export const PTTStatusSchema = z.object({
   operatorIds: z.array(z.string()),
 });
 
+export const TuneToneStartPayloadSchema = z.object({
+  operatorId: z.string().optional(),
+  toneHz: z.number().min(100).max(3000).optional(),
+});
+export type TuneToneStartPayload = z.infer<typeof TuneToneStartPayloadSchema>;
+
+export const TuneToneStatusSchema = z.object({
+  active: z.boolean(),
+  toneHz: z.number().nullable(),
+  startedAt: z.number().nullable(),
+  maxDurationMs: z.number(),
+  error: z.string().optional(),
+});
+export type TuneToneStatus = z.infer<typeof TuneToneStatusSchema>;
+
 export const SquelchStatusSchema = z.object({
   supported: z.boolean(),
   open: z.boolean().nullable(),
@@ -1022,6 +1040,36 @@ export const WSRemoveOperatorFromTransmissionMessageSchema = WSBaseMessageSchema
 
 export type WSRemoveOperatorFromTransmissionMessage = z.infer<typeof WSRemoveOperatorFromTransmissionMessageSchema>;
 
+/**
+ * 启动外接天调单音调谐（客户端到服务端）
+ */
+export const WSStartTuneToneMessageSchema = WSBaseMessageSchema.extend({
+  type: z.literal(WSMessageType.START_TUNE_TONE),
+  data: TuneToneStartPayloadSchema.optional(),
+});
+
+export type WSStartTuneToneMessage = z.infer<typeof WSStartTuneToneMessageSchema>;
+
+/**
+ * 停止外接天调单音调谐（客户端到服务端）
+ */
+export const WSStopTuneToneMessageSchema = WSBaseMessageSchema.extend({
+  type: z.literal(WSMessageType.STOP_TUNE_TONE),
+  data: z.object({}).optional(),
+});
+
+export type WSStopTuneToneMessage = z.infer<typeof WSStopTuneToneMessageSchema>;
+
+/**
+ * 外接天调单音调谐状态（服务端到客户端）
+ */
+export const WSTuneToneStatusChangedMessageSchema = WSBaseMessageSchema.extend({
+  type: z.literal(WSMessageType.TUNE_TONE_STATUS_CHANGED),
+  data: TuneToneStatusSchema,
+});
+
+export type WSTuneToneStatusChangedMessage = z.infer<typeof WSTuneToneStatusChangedMessageSchema>;
+
 /**
  * 电台数值表数据消息（服务端到客户端）
  */
@@ -1286,6 +1334,9 @@ export const WSMessageSchema = z.discriminatedUnion('type', [
   WSPTTStatusChangedMessageSchema,
   WSForceStopTransmissionMessageSchema,
   WSRemoveOperatorFromTransmissionMessageSchema,
+  WSStartTuneToneMessageSchema,
+  WSStopTuneToneMessageSchema,
+  WSTuneToneStatusChangedMessageSchema,
 
   // 电台数值表消息
   WSMeterDataMessageSchema,
@@ -1420,6 +1471,7 @@ export interface DigitalRadioEngineEvents {
 
   // PTT状态控制事件
   pttStatusChanged: (data: PTTStatus) => void;
+  tuneToneStatusChanged: (data: TuneToneStatus) => void;
 
   // 电台数值表事件
   meterData: (data: MeterData) => void;