@tolinax/ayoune-interfaces 2026.61.1 → 2026.63.0

package/interfaces/INotificationAction.d.ts

@@ -3,7 +3,7 @@
  * in the in-app notifications panel and (up to two primary actions) as native
  * Web-Push action buttons on supporting platforms.
  *
- * Four dispatch modes:
+ * Five dispatch modes:
  *   - `link`       — internal router navigation (`href` relative to the app)
  *   - `api`        — `fetch()` call to an absolute endpoint, optionally with
  *                    a confirm prompt; the service-worker can execute this
@@ -12,10 +12,21 @@
  *                    dialog in the PWA; the text is POSTed to `endpoint`.
  *   - `ai-copilot` — opens the Comm-Sidebar Copilot panel with
  *                    `copilotContext` pre-populated as the first user message.
+ *   - `sidebar`    — opens a specific Comm-Sidebar panel with an optional
+ *                    `itemId` / `threadId` / `messageId` target so the
+ *                    PWA scrolls/loads directly to the target item.
+ *                    Consumed by `SidebarDeeplinkService` in the
+ *                    `@tolinax/ayoune-comm-sidebar` library.
  */
-export type NotificationActionType = "link" | "api" | "reply" | "ai-copilot";
+export type NotificationActionType = "link" | "api" | "reply" | "ai-copilot" | "sidebar";
 /** Visual weight of the action button. */
 export type NotificationActionStyle = "primary" | "secondary" | "danger";
+/**
+ * Target panel for `type: "sidebar"` actions. Mirrors the `SidebarPanel`
+ * union in `@tolinax/ayoune-comm-sidebar` — duplicated here so the
+ * interfaces package stays free of Angular/runtime deps.
+ */
+export type NotificationSidebarPanel = "copilot" | "notifications" | "phone" | "video" | "chat" | "contacts" | "channels" | "support" | "inbox";
 export interface INotificationAction {
     /** Stable identifier per notification — used as the Web-Push `action` id. */
     id: string;
@@ -40,6 +51,21 @@ export interface INotificationAction {
      *  that are rendered against the notification's `data` context before
      *  being inserted into the input. */
     copilotContext?: string;
+    /** For `type: "sidebar"` — the target panel to open. */
+    panel?: NotificationSidebarPanel;
+    /** For `type: "sidebar"` — optional target item inside the panel
+     *  (notification id, ticket id, external-inbox conversation id, etc.). */
+    itemId?: string;
+    /** For `type: "sidebar"` with `panel: "chat"` or `panel: "channels"` —
+     *  the thread/channel id to load before scrolling. */
+    threadId?: string;
+    /** For `type: "sidebar"` with `panel: "chat"` or `panel: "channels"` —
+     *  optional message id to scroll into view after the thread loads. */
+    messageId?: string;
+    /** For `type: "sidebar"` with `panel: "phone"` — dialer sub-action
+     *  (`accept`, `reject`, `dial`). Auto-fires `CommBridgeService.voice.*`
+     *  on arrival when set. */
+    panelAction?: "accept" | "reject" | "dial" | "join";
     /** Should this action close/dismiss the notification after firing? */
     dismissOnComplete?: boolean;
 }

package/interfaces/INotificationAttachment.d.ts

@@ -38,6 +38,10 @@ interface INotificationAttachmentBase {
      *  cover, customer branding. Absolute URL (served from media CDN or
      *  customer-meta). */
     image?: string;
+    /** Per-attachment action buttons. Worker fills from
+     *  `defaultActionsByAttachmentType` when producer didn't set any — see
+     *  INotificationAction for the discriminated-union shape. */
+    actions?: import("./INotificationAction").INotificationAction[];
 }
 export interface ICalendarEntryPreview extends INotificationAttachmentBase {
     summary?: string;

package/interfaces/INotificationPolicy.d.ts

@@ -1,4 +1,21 @@
 import { IDefaultFields } from "./IDefaultFields";
+/**
+ * Per-policy control for the core's `autoEnrichAttachments()` helper.
+ * Defaults to `{ consumer: true, self: true }` — opt-out rather than opt-in
+ * so every policy that's ever rendered gets rich notifications by default.
+ * Set `consumer: false` for policies where the consumer card would leak
+ * privacy-sensitive data to recipients who shouldn't see it. Set `self: false`
+ * for event types where the entity itself is context, not the main card
+ * (e.g. MailLogs, FormSubmissions, Leads — already excluded by SELF_ATTACH_TYPES
+ * in core, but an extra per-policy kill-switch for edge cases).
+ */
+export interface INotificationAutoEnrichConfig {
+    /** Auto-attach consumer card when entity/data has _consumerID. Default true. */
+    consumer?: boolean;
+    /** Auto-attach entity itself as main card for SELF_ATTACH_TYPES (Task,
+     *  Invoice, Offer, Contract, SupplierOrder, CalendarEntry). Default true. */
+    self?: boolean;
+}
 export interface INotificationPolicy extends IDefaultFields {
     _customerID: ObjectId;
     name: string;
@@ -14,4 +31,7 @@ export interface INotificationPolicy extends IDefaultFields {
     };
     active?: boolean;
     order?: number;
+    /** Opt-out toggles for auto-attach-on-enqueue. See
+     *  INotificationAutoEnrichConfig. Omit to accept defaults (both true). */
+    autoEnrich?: INotificationAutoEnrichConfig;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tolinax/ayoune-interfaces",
-  "version": "2026.61.1",
+  "version": "2026.63.0",
   "description": "Houses TypeScript interfaces for aYOUne",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",