refactor: Unify substream actions into substream_{on,off} (#2497)

## Summary

- Collapse `live_substream_{on,off,select}` into a unified
`substream_{on,off}` pair, symmetric with `call_{start,end}`.
- Rename the `camera` field on the former `live_substream_select` to
`stream` (it always was a stream ID).
- Add optional `camera` field to both new actions for targeting a
non-selected base camera.
- YAML configs are migrated automatically; URL bookmarks must be updated
by hand.

## Migration

### Cycling between camera and substream (toggle button)

Before:
```yaml
tap_action:
  action: custom:advanced-camera-card-action
  advanced_camera_card_action: live_substream_on
```

After:
```yaml
tap_action:
  action: custom:advanced-camera-card-action
  advanced_camera_card_action: substream_on
```

### Selecting a specific substream

Before:
```yaml
tap_action:
  action: custom:advanced-camera-card-action
  advanced_camera_card_action: live_substream_select
  camera: camera.front_door_hd
```

After:
```yaml
tap_action:
  action: custom:advanced-camera-card-action
  advanced_camera_card_action: substream_on
  stream: camera.front_door_hd
```

### Turning the substream off

Before:
```yaml
tap_action:
  action: custom:advanced-camera-card-action
  advanced_camera_card_action: live_substream_off
```

After:
```yaml
tap_action:
  action: custom:advanced-camera-card-action
  advanced_camera_card_action: substream_off
```

### URL querystrings (manual update required)

| Before | After |
| --- | --- |
|
`?advanced-camera-card-action.live_substream_select=camera.front_door_hd`
| `?advanced-camera-card-action.substream_on=camera.front_door_hd` |

src/config/schema/actions/custom/general.ts

@@ -8,8 +8,6 @@ const GENERAL_ACTIONS = [
   'expand',
   'fullscreen',
   'info',
-  'live_substream_off',
-  'live_substream_on',
   'menu_toggle',
   'microphone_connect',
   'microphone_disconnect',

src/config/schema/actions/custom/substream-off.ts

@@ -0,0 +1,12 @@
+import { z } from 'zod';
+import { advancedCameraCardCustomActionsBaseSchema } from './base';
+
+export const substreamOffActionConfigSchema =
+  advancedCameraCardCustomActionsBaseSchema.extend({
+    advanced_camera_card_action: z.literal('substream_off'),
+
+    // The camera whose substream override to clear. Defaults to the selected
+    // camera. A no-op if that camera has no substream engaged.
+    camera: z.string().optional(),
+  });
+export type SubstreamOffActionConfig = z.infer<typeof substreamOffActionConfigSchema>;

src/config/schema/actions/custom/substream-on.ts

@@ -0,0 +1,16 @@
+import { z } from 'zod';
+import { advancedCameraCardCustomActionsBaseSchema } from './base';
+
+export const substreamOnActionConfigSchema =
+  advancedCameraCardCustomActionsBaseSchema.extend({
+    advanced_camera_card_action: z.literal('substream_on'),
+
+    // The camera that owns the substream. Defaults to the selected camera.
+    camera: z.string().optional(),
+
+    // The substream to engage: one of `camera`'s `substream` dependencies. When
+    // omitted, repeated calls advance through `camera`'s `substream`
+    // dependencies in order, wrapping back to no substream engaged.
+    stream: z.string().optional(),
+  });
+export type SubstreamOnActionConfig = z.infer<typeof substreamOnActionConfigSchema>;

src/config/schema/actions/custom/substream-select.ts

@@ -1,11 +0,0 @@
-import { z } from 'zod';
-import { advancedCameraCardCustomActionsBaseSchema } from './base';
-
-export const substreamSelectActionConfigSchema =
-  advancedCameraCardCustomActionsBaseSchema.extend({
-    advanced_camera_card_action: z.literal('live_substream_select'),
-    camera: z.string(),
-  });
-export type SubstreamSelectActionConfig = z.infer<
-  typeof substreamSelectActionConfigSchema
->;

src/config/schema/actions/types.ts

@@ -18,7 +18,8 @@ import { ptzDigitalActionConfigSchema } from './custom/ptz-digital';
 import { ptzMultiActionSchema } from './custom/ptz-multi';
 import { setReviewActionConfigSchema } from './custom/set-review';
 import { sleepActionConfigSchema } from './custom/sleep';
-import { substreamSelectActionConfigSchema } from './custom/substream-select';
+import { substreamOffActionConfigSchema } from './custom/substream-off';
+import { substreamOnActionConfigSchema } from './custom/substream-on';
 import { viewActionConfigSchema } from './custom/view';
 import { stockActionSchema } from './stock/types';
 
@@ -76,7 +77,8 @@ const advancedCameraCardCustomActionSchema = z.union([
   setReviewActionConfigSchema,
   sleepActionConfigSchema,
   statusBarActionConfigSchema,
-  substreamSelectActionConfigSchema,
+  substreamOffActionConfigSchema,
+  substreamOnActionConfigSchema,
   viewActionConfigSchema,
   viewDisplayModeActionConfigSchema,
 ]);