@raidiant/notifai 9.2.2 → 10.0.0

package/src/sound-ref.test.ts

@@ -0,0 +1,31 @@
+import { describe, expect, it } from 'vitest'
+import { SOUND_NAME_MAX_LENGTH, SOUND_REF_MAX_LENGTH } from '@raidiant/notifai-protocol'
+import { isCliSoundRef, unknownSoundMessage } from './sound-ref.js'
+
+describe('isCliSoundRef', () => {
+  it('accepts shipped names and the silent spelling', () => {
+    for (const ref of ['default', 'done', 'attention', 'alert', 'none']) {
+      expect(isCliSoundRef(ref), ref).toBe(true)
+    }
+  })
+
+  it('accepts an Account custom sound id and a display name', () => {
+    expect(isCliSoundRef('snd_01HQTEST')).toBe(true)
+    expect(isCliSoundRef('Kitchen timer')).toBe(true)
+    expect(isCliSoundRef('airhorn')).toBe(true)
+  })
+
+  it('rejects empty, blank, and over-long values', () => {
+    expect(isCliSoundRef('')).toBe(false)
+    expect(isCliSoundRef('   ')).toBe(false)
+    expect(isCliSoundRef('n'.repeat(SOUND_NAME_MAX_LENGTH + 1))).toBe(false)
+    expect(isCliSoundRef(`snd_${'a'.repeat(SOUND_REF_MAX_LENGTH)}`)).toBe(false)
+  })
+})
+
+describe('unknownSoundMessage', () => {
+  it('points at the list command rather than only the shipped set', () => {
+    expect(unknownSoundMessage('nope')).toContain('notifai sounds')
+    expect(unknownSoundMessage('nope')).toContain('custom sound')
+  })
+})

package/src/sound-ref.ts

@@ -0,0 +1,34 @@
+import {
+  CLI_SOUNDS,
+  SOUND_NAME_MAX_LENGTH,
+  SOUND_REF_MAX_LENGTH,
+  isCustomSoundId,
+} from '@raidiant/notifai-protocol'
+
+/**
+ * What `--sound` and the saved `sound` key accept: shipped semantic names,
+ * the CLI silent spelling, an Account custom sound id, or a custom display name.
+ */
+export function isCliSoundRef(value: string): boolean {
+  if ((CLI_SOUNDS as readonly string[]).includes(value)) return true
+  if (value.length < 1 || value.length > SOUND_REF_MAX_LENGTH) return false
+  if (isCustomSoundId(value)) return true
+  const trimmed = value.trim()
+  return trimmed.length >= 1 && trimmed.length <= SOUND_NAME_MAX_LENGTH
+}
+
+export function unknownSoundMessage(sound: string): string {
+  return (
+    `Unknown sound "${sound}" — use a shipped name (${CLI_SOUNDS.join(', ')}), ` +
+    'a custom sound id, or a custom sound name. Run `notifai sounds` to list what this Account can play.'
+  )
+}
+
+/** Shipped names plus the CLI silent spelling, with User-facing labels. */
+export const SHIPPED_SOUND_LISTING = [
+  { ref: 'default', name: 'Device default' },
+  { ref: 'done', name: 'completion chime' },
+  { ref: 'attention', name: 'attention tone' },
+  { ref: 'alert', name: 'most insistent tone' },
+  { ref: 'none', name: 'silent' },
+] as const

package/src/ui/config-view.test.ts

@@ -85,5 +85,6 @@ describe('renderConfigExplain', () => {
       expect(text, choice).toContain(choice)
     }
     expect(text).toContain('the completion chime')
+    expect(text).toContain('Device default')
   })
 })