@nivaro/react 0.1.57 → 0.1.59

package/dist/index.d.ts

@@ -1150,7 +1150,12 @@ declare interface MessageToken {
     mention?: string;
 }
 
-export declare function MyWorkView(): JSX.Element;
+export declare function MyWorkView({ notificationRoutes, onOpenPath }?: {
+    /** Host page map so notification clicks land on real pages (reports, queues,
+     *  alerts…); without it only record targets are clickable. */
+    notificationRoutes?: NotificationRouteMap_2;
+    onOpenPath?: (path: string) => void;
+}): JSX.Element;
 
 export declare const NavigationContext: React_2.Context<NavigationContextValue>;
 
@@ -1230,6 +1235,64 @@ export declare function NivaroProvider({ client, children }: {
  */
 export declare function normalizeFieldType(rawType: string, iface: string | null, relation: FormFieldDescriptor['relation']): FormFieldType;
 
+/**
+ * Every in-app notification must land somewhere meaningful — this is the ONE
+ * resolver both bells, the notifications page, and My Work use to decide what
+ * a click does. A row that resolves to null renders as plain text (no hover,
+ * no cursor), which is the honest state for broadcast-style messages; it must
+ * never render as a link that goes nowhere.
+ *
+ * Server writers use `collection` + `item` as the target: business collections
+ * point at records (or the collection list when item is null), a handful of
+ * system collections map to their owning pages, and the pseudo-collection
+ * `__chat__` carries a chat room key.
+ */
+
+export declare interface NotificationRouteMap {
+    /** Record route for a business collection — return null when the host has none. */
+    record: (collection: string, item: string) => string | null
+    /** Collection listing (item-less business notifications, e.g. view digests). */
+    list?: (collection: string) => string | null
+    report?: (id: string) => string | null
+    queue?: (id: string) => string | null
+    dashboard?: (id: string) => string | null
+    /** Alert-manager page (metric/anomaly/per-record alert notifications). */
+    alerts?: () => string | null
+    imports?: () => string | null
+    issues?: () => string | null
+}
+
+/**
+ * Every in-app notification must land somewhere meaningful — this is the ONE
+ * resolver both bells, the notifications page, and My Work use to decide what
+ * a click does. A row that resolves to null renders as plain text (no hover,
+ * no cursor), which is the honest state for broadcast-style messages; it must
+ * never render as a link that goes nowhere.
+ *
+ * Server writers use `collection` + `item` as the target: business collections
+ * point at records (or the collection list when item is null), a handful of
+ * system collections map to their owning pages, and the pseudo-collection
+ * `__chat__` carries a chat room key.
+ */
+declare interface NotificationRouteMap_2 {
+    /** Record route for a business collection — return null when the host has none. */
+    record: (collection: string, item: string) => string | null;
+    /** Collection listing (item-less business notifications, e.g. view digests). */
+    list?: (collection: string) => string | null;
+    report?: (id: string) => string | null;
+    queue?: (id: string) => string | null;
+    dashboard?: (id: string) => string | null;
+    /** Alert-manager page (metric/anomaly/per-record alert notifications). */
+    alerts?: () => string | null;
+    imports?: () => string | null;
+    issues?: () => string | null;
+}
+
+export declare type NotificationTarget =
+| { type: 'path'; path: string }
+| { type: 'chat'; room: string }
+| null
+
 export declare function NumberField({ field, value, onChange, error, disabled, readOnly, inputId, errorId }: FieldComponentProps): JSX.Element;
 
 declare interface O2MFieldInfo {
@@ -1597,6 +1660,57 @@ export declare interface ReportViewProps {
     emptyState?: React.ReactNode;
 }
 
+export declare function resolveNotificationTarget(
+collection: string | null | undefined,
+item: string | null | undefined,
+routes: NotificationRouteMap
+): NotificationTarget {
+    const c = collection?.trim()
+    if (!c) return null
+    const i = item != null && String(item).trim() !== '' ? String(item) : null
+
+    if (c === '__chat__') {
+        // Opening a room needs a registered chat dock — without one there is no
+        // chat surface to open, so the row stays plain.
+        return i && canOpenChatRoom() ? { type: 'chat', room: i } : null
+    }
+
+    if (c === 'nivaro_report_defs') {
+        const p = i ? routes.report?.(i) : null
+        return p ? { type: 'path', path: p } : null
+    }
+    if (c === 'nivaro_queues') {
+        const p = i ? routes.queue?.(i) : null
+        return p ? { type: 'path', path: p } : null
+    }
+    if (c === 'nivaro_dashboards') {
+        const p = i ? routes.dashboard?.(i) : null
+        return p ? { type: 'path', path: p } : null
+    }
+    if (ALERT_COLLECTIONS.has(c)) {
+        const p = routes.alerts?.()
+        return p ? { type: 'path', path: p } : null
+    }
+    if (IMPORT_COLLECTIONS.has(c)) {
+        const p = routes.imports?.()
+        return p ? { type: 'path', path: p } : null
+    }
+    if (c === 'nivaro_issues') {
+        const p = routes.issues?.()
+        return p ? { type: 'path', path: p } : null
+    }
+    // Any other system collection has no user-facing page — plain row, never a
+    // /collections/nivaro_* route that would 404 or 403.
+    if (/^nivaro_/i.test(c) || /^directus_/i.test(c)) return null
+
+    if (i) {
+        const p = routes.record(c, i)
+        return p ? { type: 'path', path: p } : null
+    }
+    const p = routes.list?.(c)
+    return p ? { type: 'path', path: p } : null
+}
+
 export declare function RevisionsPanel({ collection, item, onRollback, triggerClassName, inlineTableFields, open, onOpenChange }: {
     collection: string;
     item: string;
@@ -1629,6 +1743,20 @@ export declare interface RoomInfo {
  */
 declare type RoomOpener = (room: string, label?: string) => void;
 
+/** Convenience: run a resolved target (navigate or open the chat room). */
+export declare function runNotificationTarget(
+target: NotificationTarget,
+navigate: (path: string) => void
+): boolean {
+    if (!target) return false
+    if (target.type === 'chat') {
+        openChatRoom(target.room)
+        return true
+    }
+    navigate(target.path)
+    return true
+}
+
 export declare type SectionState = {
     isCollapsed: (key: string) => boolean;
     toggle: (key: string) => void;