@tolinax/ayoune-interfaces 2026.48.0 → 2026.50.0

package/interfaces/INotificationAttachment.d.ts

@@ -21,7 +21,7 @@
  * shipping, productionorder, creditnote, internalorder, offer, assignment,
  * question, snippet, media).
  */
-export type NotificationAttachmentType = "calendarentry" | "task" | "invoice" | "permissionrequest" | "supplierorder";
+export type NotificationAttachmentType = "calendarentry" | "task" | "invoice" | "permissionrequest" | "supplierorder" | "document" | "consumer" | "shipping" | "contract" | "productionorder" | "creditnote" | "internalorder" | "offer" | "assignment" | "question" | "snippet";
 /** Shared shape — all previews carry an optional deep-link override and
  *  an optional thumbnail image. The image is used both by the in-app
  *  preview card (rendered as a left-aligned thumbnail beside the metadata)
@@ -123,6 +123,159 @@ export interface ISupplierOrderPreview extends INotificationAttachmentBase {
     };
     expectedDelivery?: Date | string;
 }
+export interface IDocumentPreview extends INotificationAttachmentBase {
+    title?: string;
+    filename?: string;
+    /** Mime type — used to choose the leading icon (pdf / image / audio / video / generic). */
+    contentType?: string;
+    /** Size in bytes — rendered as a human chip `2.3 MB`. */
+    size?: number;
+    /** Direct download URL (served by the media / uploads service). */
+    url?: string;
+    /** Author / uploader — rendered small. */
+    uploadedBy?: {
+        _id?: ObjectId;
+        name?: string;
+    };
+}
+export interface IConsumerPreview extends INotificationAttachmentBase {
+    /** Short reference label (sr-number in the legacy system). */
+    sr?: string;
+    /** Display name — individual OR company. */
+    name?: string;
+    /** Company-line (used when `name` is the person). */
+    company?: string;
+    email?: string;
+    phone?: string;
+    /** Optional avatar / logo URL — separate from the generic `image`
+     *  base field which the card uses as a 40x40 thumbnail anyway. */
+    avatar?: string;
+    /** Lifecycle status — "lead", "customer", "archived", etc. */
+    status?: string;
+    /** Number of open items (tickets/tasks/deals) — rendered as a chip. */
+    openItemsCount?: number;
+}
+export interface IShippingPreview extends INotificationAttachmentBase {
+    /** Shipping identifier — internal and/or carrier tracking number. */
+    nbr?: string | number;
+    trackingNumber?: string;
+    /** Carrier slug or name — DHL, UPS, FedEx, etc. */
+    carrier?: string;
+    /** Lifecycle status — created / picked / in-transit / delivered / exception. */
+    status?: string;
+    destinationCity?: string;
+    destinationCountry?: string;
+    /** Expected / actual delivery timestamps. */
+    expectedDelivery?: Date | string;
+    deliveredAt?: Date | string;
+    /** Linked receiver (Consumer ref) — rendered as the recipient chip. */
+    receiver?: {
+        _id?: ObjectId;
+        name?: string;
+    };
+}
+export interface IContractPreview extends INotificationAttachmentBase {
+    title?: string;
+    nbr?: string | number;
+    status?: string;
+    startDate?: Date | string;
+    endDate?: Date | string;
+    value?: number;
+    currency?: string;
+    partner?: {
+        _id?: ObjectId;
+        name?: string;
+    };
+    signed?: boolean;
+}
+export interface IProductionOrderPreview extends INotificationAttachmentBase {
+    nbr?: string | number;
+    title?: string;
+    status?: string;
+    /** 0-100 percent complete — rendered as a thin progress bar under the title. */
+    progress?: number;
+    product?: {
+        _id?: ObjectId;
+        name?: string;
+    };
+    quantity?: number;
+    workCenter?: string;
+    dueDate?: Date | string;
+}
+export interface ICreditNotePreview extends INotificationAttachmentBase {
+    nbr?: string | number;
+    referenceNumber?: string;
+    total?: number;
+    currency?: string;
+    reason?: string;
+    status?: string;
+    receiver?: {
+        _id?: ObjectId;
+        name?: string;
+    };
+    issuedAt?: Date | string;
+}
+export interface IInternalOrderPreview extends INotificationAttachmentBase {
+    nbr?: string | number;
+    title?: string;
+    status?: string;
+    requester?: {
+        _id?: ObjectId;
+        name?: string;
+    };
+    department?: string;
+    total?: number;
+    currency?: string;
+    urgent?: boolean;
+}
+export interface IOfferPreview extends INotificationAttachmentBase {
+    nbr?: string | number;
+    title?: string;
+    total?: number;
+    currency?: string;
+    status?: string;
+    validUntil?: Date | string;
+    receiver?: {
+        _id?: ObjectId;
+        name?: string;
+    };
+    sent?: boolean;
+    accepted?: boolean;
+    declined?: boolean;
+}
+export interface IAssignmentPreview extends INotificationAttachmentBase {
+    title?: string;
+    nbr?: string | number;
+    status?: string;
+    assignee?: {
+        _id?: ObjectId;
+        name?: string;
+        avatar?: string;
+    };
+    due?: Date | string;
+    priority?: string;
+    type?: string;
+}
+export interface IQuestionPreview extends INotificationAttachmentBase {
+    question?: string;
+    category?: string;
+    askedBy?: {
+        _id?: ObjectId;
+        name?: string;
+        avatar?: string;
+    };
+    answered?: boolean;
+    answerCount?: number;
+    askedAt?: Date | string;
+}
+export interface ISnippetPreview extends INotificationAttachmentBase {
+    title?: string;
+    /** Raw code string — truncated at render time to fit a 3-line preview. */
+    code?: string;
+    language?: string;
+    lineCount?: number;
+    fileName?: string;
+}
 export type INotificationAttachment = {
     type: "calendarentry";
     preview: ICalendarEntryPreview;
@@ -138,6 +291,39 @@ export type INotificationAttachment = {
 } | {
     type: "supplierorder";
     preview: ISupplierOrderPreview;
+} | {
+    type: "document";
+    preview: IDocumentPreview;
+} | {
+    type: "consumer";
+    preview: IConsumerPreview;
+} | {
+    type: "shipping";
+    preview: IShippingPreview;
+} | {
+    type: "contract";
+    preview: IContractPreview;
+} | {
+    type: "productionorder";
+    preview: IProductionOrderPreview;
+} | {
+    type: "creditnote";
+    preview: ICreditNotePreview;
+} | {
+    type: "internalorder";
+    preview: IInternalOrderPreview;
+} | {
+    type: "offer";
+    preview: IOfferPreview;
+} | {
+    type: "assignment";
+    preview: IAssignmentPreview;
+} | {
+    type: "question";
+    preview: IQuestionPreview;
+} | {
+    type: "snippet";
+    preview: ISnippetPreview;
 };
 /** Producer-side shape — accepts either a bare reference (orchestrator will
  *  enrich) or a fully-populated attachment. */

package/package.json

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