@nivaro/react 0.1.215 → 0.1.217

package/dist/index.d.ts

@@ -939,6 +939,8 @@ export declare function deriveGroupKey<T extends QueueGroupingRow>(row: T, attri
 
 export declare function describeCron(cron: string): string;
 
+declare type DigestFrequency = 'instant' | 'daily' | 'weekly';
+
 declare type DimensionCascadeRule = {
     /** Sibling dimension's field whose picked value drives this filter. */
     parent_field: string;
@@ -2362,6 +2364,12 @@ export declare type NavigationContextValue = {
      *  admin shape `/users/:id`; return null = host has no such page, the
      *  action is hidden instead of navigating into the host's 404 fallback. */
     userUrl?: (userId: string) => string | null;
+    /** Route for an ADMIN CONSOLE page given its admin-shaped path
+     *  (`/notification-subscriptions`, `/pipelines/:id`). Absent = the path is
+     *  used as-is (the admin app); return null = the host has no such page and
+     *  the link is hidden. Headless hosts that embed the admin elsewhere can
+     *  return an absolute URL. */
+    consoleUrl?: (adminPath: string) => string | null;
 };
 
 export declare function networkdaysBetween(a: Date, b: Date): number;
@@ -2469,7 +2477,26 @@ export declare function NotificationRulesCard(): JSX.Element;
  */
 export declare type NotificationSound = 'off' | 'subtle' | 'chime';
 
-export declare function NotificationSourcesCard(): JSX.Element | null;
+export declare function NotificationSourcesCard({ only, bare }?: NotificationSourcesCardProps): JSX.Element | null;
+
+declare interface NotificationSourcesCardProps {
+    /** 'subscriptions' = only the two subscription sections (the My
+     *  Subscriptions page); default = every source + the History tab. */
+    only?: 'subscriptions';
+    /** Hide the card chrome (border, header, tab strip) — the host supplies its own. */
+    bare?: boolean;
+}
+
+/**
+ * "My Subscriptions" as a full page: the profile's subscription sections
+ * (same rows, same trigger/paused/criteria treatment) with create, edit,
+ * pause, delivery + channel changes and removal — one component for the
+ * admin console page and any headless host. Needs NivaroProvider (+ an
+ * optional NavigationContext for the "Manage →" links).
+ */
+export declare function NotificationSubscriptionsView({ title }: {
+    title?: string;
+}): JSX.Element;
 
 export declare type NotificationTarget = {
     type: 'path';
@@ -3901,6 +3928,55 @@ export declare function startRum(opts?: {
     apiBase?: string;
 }): void;
 
+/**
+ * The one subscription editor — create + edit for nivaro_notification_subscriptions,
+ * shared by the profile's Notifications & alerts card and the My Subscriptions
+ * page (admin hosts the same view). Every write goes through the user's own
+ * /notification-subscriptions routes; both query keys that render
+ * subscriptions are invalidated so the two surfaces never disagree.
+ */
+declare const SUBSCRIPTION_EVENT_TYPES: readonly ["all", "create", "update", "delete", "workflow_transition"];
+
+/** Create/edit dialog. `subscription` null = create; an object = edit it. */
+export declare function SubscriptionDialog({ open, onOpenChange, subscription, initial }: {
+    open: boolean;
+    onOpenChange: (open: boolean) => void;
+    subscription?: SubscriptionRecord | null;
+    /** Seed for a NEW subscription (e.g. a collection preselected by the caller). */
+    initial?: Partial<SubscriptionFormState>;
+}): JSX.Element;
+
+declare type SubscriptionEventType = (typeof SUBSCRIPTION_EVENT_TYPES)[number];
+
+declare interface SubscriptionFormState {
+    label: string;
+    collection: string;
+    event_type: SubscriptionEventType;
+    filter_field: string;
+    filter_value: string;
+    filters_json: string;
+    is_active: boolean;
+    digest_frequency: DigestFrequency;
+    notify_inapp: boolean;
+    notify_email: boolean;
+}
+
+declare interface SubscriptionRecord {
+    id: number;
+    collection: string | null;
+    queue_id?: string | null;
+    event_type: string;
+    filter_field: string | null;
+    filter_value: string | null;
+    /** Parsed array, a JSON string (some list routes hand the raw column through), or null. */
+    filters?: unknown;
+    label: string | null;
+    is_active: boolean | number;
+    digest_frequency: string | null;
+    notify_inapp?: boolean;
+    notify_email?: boolean;
+}
+
 declare type TabKey = 'catalog' | 'rules' | 'subscriptions' | 'history' | 'widget_alerts' | 'widget_alert_history' | 'anomaly_rules' | 'anomaly_history';
 
 export declare type TabState = {
@@ -4380,6 +4456,21 @@ attachments?: string[];
 
 export declare function useSessionRecorder(options?: SessionRecorderOptions): void;
 
+/** Mutations for the user's own subscriptions. Invalidates BOTH readers —
+ *  the flat list (My Subscriptions) and the profile's sources aggregate. */
+export declare function useSubscriptionMutations(): {
+    create: UseMutationResult<unknown, Error, SubscriptionFormState, unknown>;
+    update: UseMutationResult<unknown, Error, {
+    id: number;
+    form: SubscriptionFormState;
+    }, unknown>;
+    patchFields: UseMutationResult<unknown, Error, {
+    id: number;
+    body: Record<string, unknown>;
+    }, unknown>;
+    remove: UseMutationResult<unknown, Error, number, unknown>;
+};
+
 export declare function useTabState(form: UseNivaroFormReturn): TabState;
 
 export declare function useTogglePin(room: string): UseMutationResult<unknown, Error, number, unknown>;