@nivaro/react 0.2.4 → 0.2.5

package/dist/index.d.ts

@@ -482,6 +482,10 @@ export declare function BroadcastView({ className }: {
     className?: string;
 }): JSX.Element;
 
+export declare function BrowserPushCard({ serviceWorkerPath }: {
+    serviceWorkerPath?: string;
+}): JSX.Element;
+
 export declare function buildCopyAs(input: CopyAsInput): CopyAsSnippets;
 
 export declare function buildGroups<T extends QueueGroupingRow>(rows: T[], attribute: string): QueueGroup<T>[];
@@ -649,8 +653,35 @@ declare interface ChannelMeta {
     topic: string | null;
     created_by: string | null;
     is_direct?: boolean;
+    /** One of the fixed channel icons (ChannelLook.tsx); null = plain "#". */
+    icon?: string | null;
+    /** #rrggbb from the fixed palette; null = neutral tile. */
+    color?: string | null;
+    announce?: boolean;
+    description?: string | null;
+    links?: Array<{
+        label: string;
+        url: string;
+    }>;
+    welcome_note?: string | null;
+    default_roles?: string[];
 }
 
+export declare function ChatAnalyticsView(): JSX.Element;
+
+/** Where a room view opens: the newest messages, or around a message / day. */
+declare type ChatAnchor = {
+    around: number;
+} | {
+    date: string;
+} | null;
+
+/**
+ * "Appear away" (#952): the Online list, badges and DM headers show you as
+ * away whatever you are doing, until you switch it off or the time runs out.
+ */
+export declare function ChatAppearAwayRow(): JSX.Element;
+
 export declare function chatAvatarColor(id: string): string;
 
 /**
@@ -732,6 +763,38 @@ export declare interface ChatMessage {
     reactions?: ChatReaction[];
     /** The admin who was masquerading as the sender when it was sent. */
     masquerade_admin_name?: string | null;
+    /** Thread reply (#927): the root it answers. Null on the timeline. */
+    parent_id?: number | null;
+    /** Quoted message (#928). */
+    quote_id?: number | null;
+    quote?: {
+        id: number;
+        sender_name: string | null;
+        message: string;
+        deleted: boolean;
+        has_attachments: boolean;
+    } | null;
+    /** Replies under this message (roots only). */
+    thread?: {
+        count: number;
+        last_reply_at: string | null;
+        people: Array<{
+            id: string;
+            name: string | null;
+        }>;
+    } | null;
+    urgent?: boolean;
+    /** A platform line (record activity, flows) rather than a person. */
+    is_system?: boolean;
+    /** The sender removed the link preview. */
+    no_preview?: boolean;
+    client_id?: string | null;
+    mentions?: string[];
+    /** Times written in the message, as stored instants (#962). */
+    time_refs?: Array<{
+        text: string;
+        at: string;
+    }>;
 }
 
 export declare interface ChatOnlineUser {
@@ -813,17 +876,19 @@ declare interface ChatReaction {
     user_name: string | null;
 }
 
-export declare function ChatRoomList({ rooms, onOpen, onNewGroup, archivedView, loading }: {
+export declare function ChatRoomList({ rooms, onOpen, onNewGroup, archivedView, loading, onView }: {
     rooms: RoomInfo[];
-    onOpen: (room: RoomInfo) => void;
+    onOpen: (room: RoomInfo, anchor?: ChatAnchor) => void;
     /** Opens the group-conversation composer (host renders the dialog). */
     onNewGroup?: () => void;
+    /** Opens the mentions / scheduled / catch-up views (host renders them). */
+    onView?: (view: 'mentions' | 'scheduled' | 'catchup') => void;
     /** The Archived tab: no assistant entry, rows offer Unarchive. */
     archivedView?: boolean;
     loading?: boolean;
 }): JSX.Element;
 
-export declare function ChatRoomView({ room, label, onBack, onOpenSettings, renderMessageBody, initialUnread }: {
+export declare function ChatRoomView({ room, label, onBack, onOpenSettings, renderMessageBody, initialUnread, anchor: anchorProp }: {
     room: string;
     label: string;
     onBack: () => void;
@@ -834,10 +899,24 @@ export declare function ChatRoomView({ room, label, onBack, onOpenSettings, rend
     }) => React.ReactNode;
     /** Unread count at open — anchors the "New messages" divider. */
     initialUnread?: number;
+    /** Open around a message (a search hit, #977) or a day (#976). */
+    anchor?: ChatAnchor;
 }): JSX.Element;
 
+/** Search every room in MY sidebar (server enforces visibility by
+ *  construction — the room set is the user's own). */
+declare interface ChatSearchFilters {
+    sender?: string | null;
+    room?: string | null;
+    from?: string | null;
+    to?: string | null;
+    has_attachment?: boolean;
+    mentions_me?: boolean;
+}
+
 declare interface ChatSearchHit {
     id: number;
+    parent_id?: number | null;
     room: string;
     sender: string | null;
     sender_name: string | null;
@@ -845,6 +924,18 @@ declare interface ChatSearchHit {
     date_created: string;
 }
 
+/**
+ * The mentions / scheduled / catch-up views for hosts that lay chat out
+ * themselves (the admin /chat workspace). The slide-over panel renders the
+ * same views internally.
+ */
+export declare function ChatSideView({ view, rooms, onBack, onOpen }: {
+    view: 'mentions' | 'scheduled' | 'catchup';
+    rooms: RoomInfo[];
+    onBack: () => void;
+    onOpen: (room: string, label: string, anchor?: ChatAnchor) => void;
+}): JSX.Element;
+
 /**
  * Nivaro chat UI — a complete team panel (Online tab, grouped rooms, live
  * conversations with mentions, typing, receipts, search).
@@ -1394,6 +1485,8 @@ declare interface DirectoryChannel {
     role: string | null;
     joined: boolean;
     members: number;
+    icon?: string | null;
+    color?: string | null;
 }
 
 /** Forget a run: stops watching it (the server run continues on its own). */
@@ -3967,6 +4060,8 @@ export declare interface NotificationRouteMap {
     approvals?: () => string | null;
     access_requests?: () => string | null;
     my_work?: () => string | null;
+    /** A support ticket (#999); hosts without a support page fall back to the server url. */
+    support?: (id?: string | null) => string | null;
 }
 
 export declare function NotificationRulesCard(): JSX.Element;
@@ -4016,7 +4111,7 @@ export declare type NotificationTarget = {
 /** Server-side target spec (services/notification-target.ts) — what the
  *  notification is about and what a click should offer. */
 export declare interface NotificationTargetSpec {
-    kind: 'record' | 'task' | 'approval' | 'access_request' | 'sla' | 'chat' | 'queue' | 'report' | 'alerts' | 'issue' | 'import' | 'dashboard' | 'my_work' | 'home' | 'external';
+    kind: 'record' | 'task' | 'approval' | 'access_request' | 'sla' | 'chat' | 'queue' | 'report' | 'alerts' | 'issue' | 'import' | 'dashboard' | 'my_work' | 'home' | 'support' | 'external';
     collection?: string | null;
     id?: string | number | null;
     room?: string | null;
@@ -4634,13 +4729,15 @@ export declare function ProfileSectionCard({ icon, title, hint, children, action
  * notifications, security, preferences); anyone else's is PersonProfile —
  * slim for a colleague, full-featured for an admin.
  */
-export declare function ProfileView({ userId, className, initialTab, extra }: {
+export declare function ProfileView({ userId, className, initialTab, extra, pushServiceWorker }: {
     userId?: string | null;
     className?: string;
     /** Which tab an admin lands on for someone else's page. */
     initialTab?: 'overview' | 'access' | 'activity' | 'tools';
     /** Host-only cards for the OWN profile (a browser-push card, say), rendered in the right column. */
     extra?: React.ReactNode;
+    /** Service worker the Browser notifications card registers (same origin); false hides the card. */
+    pushServiceWorker?: string | false;
 }): JSX.Element;
 
 /**
@@ -5647,6 +5744,11 @@ export declare interface RoomInfo {
     channel: ChannelMeta | null;
     /** Put away by this person — lives in the Archived tab, never alerts. */
     archived?: boolean;
+    /** Pinned to the top of this person's list (#957). */
+    starred?: boolean;
+    /** Unread messages that name this person. */
+    mentions?: number;
+    welcome_seen_at?: string | null;
 }
 
 /**
@@ -5854,6 +5956,15 @@ export declare function seedQuickPickerSteps(fieldConfig: Array<{
 
 export declare function SelectField({ field, value, onChange, error, disabled, readOnly, inputId, errorId }: FieldComponentProps): JSX.Element;
 
+declare interface SendInput {
+    text: string;
+    mentions?: string[];
+    attachments?: string[];
+    parentId?: number | null;
+    quoteId?: number | null;
+    urgent?: boolean;
+}
+
 /**
  * rrweb session recorder for headless frontends — two modes, one hook
  * (the exact model the admin app runs; see admin/src/lib/use-session-recorder.ts).
@@ -6139,6 +6250,121 @@ declare interface SubscriptionRecord {
     notify_email?: boolean;
 }
 
+export declare interface SupportCategory {
+    id: number;
+    name: string;
+    description: string | null;
+    /** The kind of record this type is for; null = offered everywhere. */
+    collection: string | null;
+    team_id: number | null;
+    team_name: string | null;
+    default_assignee: string | null;
+    default_assignee_name: string | null;
+    is_active: boolean;
+    sort: number;
+    legacy: boolean;
+}
+
+/**
+ * Raise a support request (#999). With a record it is a change request about
+ * that record and offers the types meant for its collection; without one it is
+ * General Support. The request lands with the administrators (or the type's
+ * team), who are told at once.
+ */
+export declare function SupportRequestDialog({ open, onOpenChange, collection, item, recordLabel, onCreated }: {
+    open: boolean;
+    onOpenChange: (open: boolean) => void;
+    collection?: string | null;
+    item?: string | number | null;
+    /** Friendly id of the record ("CM26-79811"), shown in the title. */
+    recordLabel?: string | null;
+    onCreated?: (ticket: SupportTicket) => void;
+}): JSX.Element;
+
+export declare function SupportStatusPill({ status, label }: {
+    status: TicketStatus;
+    label?: string;
+}): JSX.Element;
+
+export declare interface SupportSummary {
+    mine_open: number;
+    desk: boolean;
+    unassigned: number;
+    assigned_to_me: number;
+}
+
+export declare interface SupportTicket {
+    id: number;
+    title: string;
+    description: string | null;
+    status: TicketStatus;
+    status_label: string;
+    priority: 'low' | 'normal' | 'urgent';
+    collection: string | null;
+    item: string | null;
+    record_label: string | null;
+    category_id: number | null;
+    category_name: string | null;
+    team_id: number | null;
+    team_name: string | null;
+    assignee: string | null;
+    assignee_name: string | null;
+    created_by: string;
+    requester_name: string | null;
+    attachments: string[];
+    replies: number;
+    legacy: boolean;
+    created_at: string;
+    updated_at: string | null;
+    completed_at: string | null;
+}
+
+export declare interface SupportTicketDetail extends SupportTicket {
+    files: Array<{
+        id: string;
+        title: string | null;
+        filename_download: string | null;
+        type: string | null;
+        filesize: number | string | null;
+    }>;
+    thread: Array<{
+        id: string;
+        text: string;
+        user: string;
+        user_name: string | null;
+        created_at: string;
+        from_requester: boolean;
+    }>;
+    history: Array<{
+        id: number;
+        text: string;
+        user: string | null;
+        user_name: string | null;
+        at: string;
+    }>;
+    can: {
+        work: boolean;
+        reply: boolean;
+        cancel: boolean;
+        reopen: boolean;
+    };
+}
+
+/**
+ * The support page (#999). Everyone sees My requests (raise one, follow it).
+ * Administrators — and members of a team a type routes to — also get the Desk
+ * (pick up, reply, close) and, for administrators, the list of request types.
+ *
+ * `initialTicketId` opens a ticket on arrival (/support?ticket=12, the link in
+ * every support notification); `onTicketChange` lets the host keep the URL in
+ * step.
+ */
+export declare function SupportView({ initialTicketId, onTicketChange, className }: {
+    initialTicketId?: number | null;
+    onTicketChange?: (id: number | null) => void;
+    className?: string;
+}): JSX.Element;
+
 declare type TabKey = 'catalog' | 'rules' | 'subscriptions' | 'history' | 'widget_alerts' | 'widget_alert_history' | 'anomaly_rules' | 'anomaly_history';
 
 export declare type TabState = {
@@ -6198,6 +6424,18 @@ export declare function TickerNumber({ value, format, durationMs }: {
     durationMs?: number;
 }): JSX.Element;
 
+/**
+ * One support ticket (#999): what was asked, the thread, the history, and —
+ * for whoever works it — claim, status, type and assignee.
+ */
+export declare function TicketDetailSheet({ ticketId, onOpenChange }: {
+    ticketId: number | null;
+    onOpenChange: (open: boolean) => void;
+}): JSX.Element;
+
+/** Shapes served by /api/support (#999). */
+declare type TicketStatus = 'open' | 'in_progress' | 'done' | 'cancelled';
+
 export declare function TimezoneCard(): JSX.Element;
 
 export declare function TipLayer(): ReactPortal | null;
@@ -6279,6 +6517,16 @@ export declare function useChannelAdmin(channelId: number | null): {
     visibility?: "open" | "role" | "private";
     role?: string | null;
     is_archived?: boolean;
+    icon?: string | null;
+    color?: string | null;
+    announce?: boolean;
+    description?: string | null;
+    links?: Array<{
+    label: string;
+    url: string;
+    }>;
+    welcome_note?: string | null;
+    default_roles?: string[];
     }, unknown>;
     addMember: UseMutationResult<unknown, Error, string, unknown>;
     removeMember: UseMutationResult<unknown, Error, string, unknown>;
@@ -6298,9 +6546,19 @@ export declare function useChannelMembers(channelId: number | null): {
 
 export declare function useChatConfig(): ChatConfig;
 
-export declare function useChatMessages(room: string | null): {
-    messages: NoInfer<ChatMessage[]>;
+/**
+ * A room's timeline (thread replies excluded). Opens on the newest messages,
+ * or around a message / a day when `anchor` is given (#976, #977); older and
+ * newer history loads on demand.
+ */
+export declare function useChatMessages(room: string | null, anchor?: ChatAnchor): {
+    messages: ChatMessage[];
     loading: boolean;
+    hasOlder: boolean;
+    hasNewer: boolean;
+    anchorId: number | null;
+    loadOlder: () => Promise<void>;
+    loadingOlder: boolean;
 };
 
 /** Id + name only — /api/roles is admin-gated, so the channel picker reads the
@@ -6323,9 +6581,7 @@ export declare function useChatRooms(): {
     loading: boolean;
 };
 
-/** Search every room in MY sidebar (server enforces visibility by
- *  construction — the room set is the user's own). */
-export declare function useChatSearch(q: string): {
+export declare function useChatSearch(q: string, filters?: ChatSearchFilters): {
     hits: NoInfer<ChatSearchHit[]>;
     loading: boolean;
 };
@@ -6336,6 +6592,8 @@ key?: string;
 topic?: string;
 visibility?: "open" | "role" | "private";
 role?: string | null;
+icon?: string | null;
+color?: string | null;
 }, unknown>;
 
 export declare function useCreateGroupDm(): UseMutationResult<    {
@@ -6640,9 +6898,11 @@ export declare function UserAvatar({ userId, fallback, className, style, alt }:
     alt?: string;
 }): JSX.Element;
 
-export declare function UserChip({ userId, size }: {
+export declare function UserChip({ userId, size, children }: {
     userId: string;
     size?: 'default' | 'compact';
+    /** A custom trigger (e.g. a chat avatar) that opens the same user card. */
+    children?: React_2.ReactElement;
 }): React_2.JSX.Element;
 
 /** Integration events about one record, newest first, one page at a time. */
@@ -6689,6 +6949,11 @@ export declare function useRoomMembership(): {
     room: string;
     archived: boolean;
     }, unknown>;
+    setStarred: UseMutationResult<unknown, Error, {
+    room: string;
+    starred: boolean;
+    }, unknown>;
+    dismissWelcome: UseMutationResult<unknown, Error, string, unknown>;
 };
 
 export declare function useRoomPins(room: string | null): NoInfer<PinnedMessage[]>;
@@ -6708,11 +6973,16 @@ export declare function useScopeDimensions(): ScopeDimensionLite[];
 
 export declare function useSectionState(form: UseNivaroFormReturn, defaultCollapsed?: string[]): SectionState;
 
-export declare function useSendChatMessage(room: string): UseMutationResult<void, Error, string | {
-text: string;
-mentions?: string[];
-attachments?: string[];
-}, unknown>;
+/**
+ * Send through the outbox (#983, #984): the message shows at once as
+ * "Sending…", a network failure keeps it queued and retries in order when the
+ * connection is back, a refusal marks it failed with Retry. The client id rides
+ * the request, so a retry of a send that actually landed is not posted twice.
+ */
+export declare function useSendChatMessage(room: string): {
+    mutate: (input: string | SendInput) => void;
+    isPending: boolean;
+};
 
 export declare function useSessionRecorder(options?: SessionRecorderOptions): void;