@camstack/types 1.1.16 → 1.1.18

package/dist/interfaces/notification.d.ts

@@ -1,17 +1,22 @@
+import type { z } from 'zod';
 import type { ConfigUISchema } from './config-ui.js';
+import type { NotificationSchema } from '../capabilities/notification-output.cap.js';
 /**
- * A notification to be sent through configured output channels.
+ * The canonical notification — single source of truth is the
+ * `notification-output` cap's `NotificationSchema`. Callers emit this shape;
+ * providers degrade it per their `TargetKind.caps`.
  */
-export interface Notification {
-    readonly title: string;
-    readonly message: string;
-    readonly severity: 'info' | 'warning' | 'critical';
+export type Notification = z.infer<typeof NotificationSchema>;
+/**
+ * Consumer-side envelope. `category` + `timestamp` are routing / rate-limit
+ * concerns owned by `NotificationService`, NOT wire concerns — the cap `send`
+ * payload stays the canonical `Notification`. The service strips these before
+ * dispatching to a target.
+ */
+export type RoutedNotification = Notification & {
     readonly category: string;
-    readonly data?: Record<string, unknown>;
-    readonly imageUrl?: string;
-    readonly deviceId?: number;
     readonly timestamp: number;
-}
+};
 /**
  * A toast notification for the admin UI.
  */
@@ -33,20 +38,25 @@ export interface IToastService {
     sendToUser(userId: string, toast: Toast): void;
 }
 /**
- * Pluggable notification output channel.
- * Each addon implements a notification channel (Telegram, webhook, email, etc.).
+ * Legacy single-channel output view.
+ *
+ * @deprecated The canonical surface is the `notification-output` cap's
+ * collection provider (`INotificationOutputProvider`, one per addon, keyed by
+ * `addonId` and addressing individual targets via `send({ targetId, ... })`).
+ * This interface survives only for `advanced-notifier`'s internal console
+ * output; new providers implement the cap.
  */
 export interface INotificationOutput {
     readonly id: string;
     readonly name: string;
     readonly icon: string;
-    /** Send a notification */
+    /** Send a canonical notification through this single channel. */
     send(notification: Notification): Promise<void>;
-    /** Test the notification channel */
+    /** Test the notification channel. */
     sendTest?(): Promise<{
         success: boolean;
         error?: string;
     }>;
-    /** Config schema for the admin UI */
+    /** Config schema for the admin UI. */
     getConfigSchema?(): ConfigUISchema;
 }

package/dist/interfaces/stream-broker.d.ts

@@ -1,8 +1,8 @@
 import { z } from 'zod';
+import type { SubscribeAudioChunksResult, SubscribeFramesInput, SubscribeFramesResult } from '../capabilities/schemas/streaming-shared.js';
+import type { BrokerConsumerAttribution } from '../capabilities/stream-broker.cap.js';
 import type { FrameFormat } from '../types/io.js';
 import type { FrameHandle } from './frame-handle.js';
-import type { SubscribeFramesInput, SubscribeFramesResult, SubscribeAudioChunksResult } from '../capabilities/schemas/streaming-shared.js';
-import type { BrokerConsumerAttribution } from '../capabilities/stream-broker.cap.js';
 export declare const DecoderStatsSchema: z.ZodObject<{
     inputFps: z.ZodNumber;
     outputFps: z.ZodNumber;
@@ -74,6 +74,17 @@ export interface StreamSource {
      * stall is an error).
      */
     readonly allowStall?: boolean;
+    /**
+     * When set, the broker ingests this source THROUGH ffmpeg (`-c copy`) instead
+     * of a native TS client — the "ffmpeg parser". Carries the transport + operator
+     * normalization args. Set by the manager from the per-camStream `sourceParser`
+     * override. Absent = native ingest.
+     */
+    readonly ffmpegParser?: {
+        readonly transport: 'tcp' | 'udp';
+        readonly inputArgs?: readonly string[];
+        readonly outputArgs?: readonly string[];
+    };
 }
 export interface StreamSourceOption {
     readonly id: string;

package/dist/notification/degrade-engine.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Capability-gated notification degrade engine (Apprise-style).
+ *
+ * PURE — no I/O. Given a kind's `TargetKind.caps` and a canonical
+ * `Notification`, it transcodes the format down, resolves the native level,
+ * filters + caps attachments, slices actions, gates scalar features, and
+ * splits/truncates the body — producing a `PreparedNotification` the adapter
+ * turns into an HTTP request. Attachment url→bytes fetching is expressed as a
+ * `needsFetch` directive the adapter executes (the engine never fetches).
+ *
+ * Lives in `@camstack/types` because both the system `notifiers` addon and the
+ * HA addon need it and addons may not cross-import.
+ */
+import type { z } from 'zod';
+import type { AttachmentMediaType, NotificationAction, NotificationFormat, NotificationSchema, RenderedAs, TargetKindCaps } from '../capabilities/notification-output.cap.js';
+type Notification = z.infer<typeof NotificationSchema>;
+/** The resolved native level the adapter maps onto its wire payload. */
+export interface ResolvedLevel {
+    readonly id: string;
+    readonly ordinal: number | null;
+    readonly flags?: {
+        readonly critical?: boolean;
+        readonly silent?: boolean;
+        readonly noPush?: boolean;
+    };
+    /** e.g. Pushover `emergency` → `['retry','expire']` — adapter injects config defaults. */
+    readonly requires?: readonly string[];
+}
+/** An attachment after filtering, with a fetch directive for the adapter. */
+export interface PreparedAttachment {
+    readonly mediaType: AttachmentMediaType;
+    readonly url?: string;
+    readonly bytes?: Uint8Array;
+    readonly mime?: string;
+    readonly name?: string;
+    /** `true` when the adapter must fetch `url` into bytes (mode:'bytes', url-only). */
+    readonly needsFetch: boolean;
+}
+export type PreparedAction = NotificationAction;
+export interface PreparedNotification {
+    readonly body: string;
+    readonly title?: string;
+    readonly format: NotificationFormat;
+    readonly level: ResolvedLevel | null;
+    readonly attachments: readonly PreparedAttachment[];
+    readonly actions: readonly PreparedAction[];
+    readonly clickUrl: string | null;
+    readonly sound: string | null;
+    readonly ttl: number | null;
+    readonly tag: string | null;
+    /** Overflow: `bodyParts[0]` is the truncate view; the full array is the split. */
+    readonly bodyParts: readonly string[];
+    readonly renderedAs: RenderedAs;
+}
+/**
+ * Prepare a canonical notification for one kind. Never throws — degradation is
+ * always reported in `renderedAs`, never surfaced as an error.
+ */
+export declare function prepareNotification(caps: TargetKindCaps, n: Notification): PreparedNotification;
+export {};

package/dist/notification/format-transcode.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Pure format transcoding for the notification degrade engine (Apprise-style).
+ * No I/O — used by both the system `notifiers` addon and the HA addon (which
+ * may not cross-import), so it lives in `@camstack/types`.
+ */
+import type { NotificationFormat } from '../capabilities/notification-output.cap.js';
+export type { NotificationFormat };
+/** Strip a small, safe subset of Markdown down to plain text. */
+export declare function markdownToText(md: string): string;
+/** Strip HTML tags, decode a few entities, map block/br elements to newlines. */
+export declare function htmlToText(html: string): string;
+/** Plain text → HTML-lite (escape + newlines to <br>). */
+export declare function textToHtml(text: string): string;
+/** Markdown → HTML-lite (bold/italic/code/links; used e.g. for Pushover). */
+export declare function markdownToHtmlLite(md: string): string;
+/** Pick the best target format the kind supports for a given source format. */
+export declare function resolveFormat(source: NotificationFormat, supported: readonly NotificationFormat[]): NotificationFormat;
+/** Transcode a body between formats. */
+export declare function transcodeBody(body: string, from: NotificationFormat, to: NotificationFormat): string;

package/dist/{sleep-BQzZ7joF.js → sleep-BabrCASa.js}

@@ -1366,6 +1366,7 @@ var CamStreamKindSchema = zod.z.enum([
 	"pull-rtsp",
 	"pull-rtmp",
 	"pull-http",
+	"pull-flv",
 	"pull-rfc4571",
 	"push-annexb",
 	"derived"

package/dist/{sleep-C2M2zF7x.mjs → sleep-MHm--th-.mjs}

@@ -1366,6 +1366,7 @@ var CamStreamKindSchema = z.enum([
 	"pull-rtsp",
 	"pull-rtmp",
 	"pull-http",
+	"pull-flv",
 	"pull-rfc4571",
 	"push-annexb",
 	"derived"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@camstack/types",
-  "version": "1.1.16",
+  "version": "1.1.18",
   "description": "Shared types, interfaces, and model catalogs for the CamStack detection ecosystem",
   "keywords": [
     "camstack",