react-semaphor 0.1.252 → 0.1.253

package/dist/surfboard/index.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const r=require("../chunks/index-DvjTd3ue.js"),a=require("../types/index.cjs"),e=require("../chunks/dashboard-summary-settings-dialog-5tiQcv5v.js");exports.Surfboard=r.DashboardPlus;exports.EMPTY_SELECTION=a.EMPTY_SELECTION;exports.CalendarPreferencesDialog=e.CalendarPreferencesDialog;exports.DashboardSummarySettingsDialog=e.DashboardSummarySettingsDialog;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const r=require("../chunks/index-9_GiUNMO.js"),a=require("../types/index.cjs"),e=require("../chunks/dashboard-summary-settings-dialog-BtpW7fJ0.js");exports.Surfboard=r.DashboardPlus;exports.EMPTY_SELECTION=a.EMPTY_SELECTION;exports.CalendarPreferencesDialog=e.CalendarPreferencesDialog;exports.DashboardSummarySettingsDialog=e.DashboardSummarySettingsDialog;

package/dist/surfboard/index.js

@@ -1,6 +1,6 @@
-import { a as o } from "../chunks/index-BDN1Q9RG.js";
+import { a as o } from "../chunks/index-DsMIsFii.js";
 import { EMPTY_SELECTION as s } from "../types/index.js";
-import { C as m, D as t } from "../chunks/dashboard-summary-settings-dialog-aTE5vsbO.js";
+import { C as m, D as t } from "../chunks/dashboard-summary-settings-dialog-CHhYvPUB.js";
 export {
   m as CalendarPreferencesDialog,
   t as DashboardSummarySettingsDialog,

package/dist/types/main.d.ts

@@ -1,3 +1,4 @@
+import { ActionDispatch } from 'react';
 import { Chart as Chart_2 } from 'chart.js';
 import { ChartConfiguration } from 'chart.js';
 import { ClassProp } from 'class-variance-authority/types';
@@ -331,12 +332,7 @@ export declare interface Alert {
     sourceHealth?: 'OK' | 'SOURCE_MISSING' | 'SOURCE_ERROR' | 'STALE';
     alertState?: AlertState | null;
     jobConfig: AlertJobConfig;
-    deliveryConfig: {
-        recipients: AlertRecipient[];
-        channels: AlertDeliveryChannel[];
-        subject?: string;
-        message?: string;
-    };
+    deliveryConfig: DeliveryConfig;
     createdAt: string;
     updatedAt: string;
 }
@@ -357,8 +353,6 @@ export declare interface AlertBacktestResult {
 
 export declare type AlertConditionOperator = 'gt' | 'gte' | 'lt' | 'lte' | 'eq' | 'neq' | 'pct_change_gt' | 'pct_change_lt';
 
-export declare type AlertContextAuthoringMode = 'basic' | 'conversational' | 'manual';
-
 export declare interface AlertContextInterpretResponse {
     workflowDef: Record<string, unknown>;
     contextSources: ContextSource[];
@@ -367,28 +361,41 @@ export declare interface AlertContextInterpretResponse {
 
 export declare type AlertContextSourceKind = 'trend_window' | 'peer_comparison' | 'related_metric' | 'breakdown' | 'custom_query';
 
-export declare function AlertCreationDialog({ open, onOpenChange, prefilledSource, prefilledSeries, onCreated, contextBuilderEnabled, }: AlertCreationDialogProps): JSX.Element;
-
-declare type AlertCreationDialogProps = {
-    open: boolean;
-    onOpenChange: (open: boolean) => void;
-    prefilledSource?: AlertSource;
-    prefilledSeries?: BacktestPoint[];
-    onCreated?: (alertId: string) => void;
-    contextBuilderEnabled?: boolean;
-};
-
 export declare interface AlertDeliverablePreview {
     mode: 'standard_fallback' | 'custom';
     html: string;
     warnings?: string[];
 }
 
-export declare type AlertDeliveryChannel = 'EMAIL' | 'WEBHOOK' | 'SLACK' | 'IN_APP';
+export declare type AlertDeliveryChannel = 'EMAIL' | 'WEBHOOK' | 'SLACK' | 'IN_APP' | 'TELEGRAM';
 
-declare type AlertDraft = Partial<CreateAlertRequest> & {
-    contextSources?: ContextSource[];
-    presentationPrompt?: string;
+export declare function AlertDetailPageEmbedded({ alertId, onBack }: AlertDetailPageEmbeddedProps): JSX.Element;
+
+declare type AlertDetailPageEmbeddedProps = {
+    alertId: string;
+    onBack?: () => void;
+};
+
+declare type AlertDraft = {
+    name?: string;
+    description?: string | null;
+    scheduleExpr?: string;
+    timezone?: string;
+    workflowDef?: Record<string, unknown> | null;
+    jobConfig?: Partial<AlertJobConfig>;
+    deliveryConfig?: Partial<DeliveryConfig>;
+};
+
+export declare type AlertExecutionFilterContext = {
+    active_filters: TFilterValue[];
+};
+
+export declare type AlertExecutionQueryConfig = {
+    cardType: TChartType;
+    cardMode: CardMode;
+    cardConfig: CardConfig;
+    cardDataSource: DataSource;
+    connectionId?: string;
 };
 
 declare type AlertFilters = {
@@ -434,16 +441,19 @@ export declare type AlertJobConfig = {
     severity: AlertSeverity;
     consecutiveCount?: number;
     notifyPolicy: 'on_state_change';
-    contextAuthoringMode?: AlertContextAuthoringMode;
     contextSources?: ContextSource[];
     presentationPrompt?: string;
+    sensitivityPreset?: SensitivityPreset | null;
 };
 
-export declare function AlertManagementPage({ scope, prefilledSource, }: AlertManagementPageProps): JSX.Element;
+export declare function AlertManagementPage({ scope, prefilledSource, allowCreateSignalWatch, onOpenAlertDetail, onCreateSignalWatch, }: AlertManagementPageProps): JSX.Element;
 
 declare type AlertManagementPageProps = {
     scope?: AlertManagementScope;
     prefilledSource?: AlertSource;
+    allowCreateSignalWatch?: boolean;
+    onOpenAlertDetail?: (alert: Alert) => void;
+    onCreateSignalWatch?: () => void;
 };
 
 declare type AlertManagementScope = {
@@ -499,18 +509,19 @@ export declare type AlertSeverity = 'LOW' | 'MEDIUM' | 'HIGH' | 'CRITICAL';
 
 export declare type AlertSource = {
     type: 'saved_metric';
-    metricId: string;
+    visualId: string;
     title?: string;
+    format?: CanonicalFormatSpec;
 } | {
     type: 'dashboard_metric';
     dashboardId: string;
     visualId: string;
     cardId: string;
     title?: string;
+    format?: CanonicalFormatSpec;
     executionSnapshot: {
-        queryConfig: Record<string, unknown>;
-        filterContext: Record<string, unknown>;
-        formattingContext: Record<string, unknown>;
+        queryConfig: AlertExecutionQueryConfig;
+        filterContext: AlertExecutionFilterContext;
         connectionId: string;
         calendarContext?: {
             tz: string;
@@ -559,6 +570,14 @@ declare type AlertStoreState = {
     draft: AlertDraft;
 };
 
+export declare function AlertWizardDialog({ open, onOpenChange, cardSnapshot, }: AlertWizardDialogProps): JSX.Element;
+
+declare interface AlertWizardDialogProps {
+    open: boolean;
+    onOpenChange: (open: boolean) => void;
+    cardSnapshot: CardSnapshot | null;
+}
+
 export declare type AssistantId = 'dashboard-assistant' | 'editor-assistant';
 
 export declare type AuthToken = {
@@ -607,11 +626,6 @@ export declare type AxisConfig = {
 
 export declare function backtestAlert(apiServiceUrl: string, token: string, id: string | undefined, payload?: Record<string, unknown>): Promise<AlertBacktestResult>;
 
-declare type BacktestPoint = {
-    at: string;
-    value: number;
-};
-
 export declare interface BaseColumn {
     id: string;
     name: string;
@@ -765,6 +779,8 @@ declare interface CalendarPreferencesDialogProps {
  */
 export declare function cancelExport(apiServiceUrl: string, token: string, exportId: string): Promise<void>;
 
+export declare type CanonicalFormatSpec = NumericCanonicalFormat | DateCanonicalFormat | StringCanonicalFormat;
+
 export declare function CardAlertIndicator({ cardId }: CardAlertIndicatorProps): JSX.Element | null;
 
 declare type CardAlertIndicatorProps = {
@@ -840,6 +856,18 @@ export declare interface CardInteractionConfig {
 
 export declare type CardMode = 'explorer' | 'dev';
 
+export declare interface CardSnapshot {
+    dashboardId: string;
+    visualId: string;
+    cardId: string;
+    title?: string;
+    currentValue?: number | null;
+    format?: AlertSource['format'];
+    executionSnapshot?: Extract<AlertSource, {
+        type: 'dashboard_metric';
+    }>['executionSnapshot'];
+}
+
 export declare function CardSummary({ card, mode }: CardSummaryProps): JSX.Element | null;
 
 declare type CardSummaryProps = {
@@ -867,6 +895,34 @@ declare type CardWithFooter = BaseCustomCard & {
     }>;
 };
 
+export declare type ChannelFormatConfig = {
+    formatProfile: FormatProfile;
+    subjectOverride?: string;
+    titleOverride?: string;
+    summaryOverride?: string;
+    actionBlockVisible?: boolean;
+    webhookConfig?: {
+        url: string;
+        method: string;
+        headers: Record<string, string>;
+        secretEncrypted?: string;
+    };
+};
+
+declare type ChannelFormatConfig_2 = {
+    formatProfile: FormatProfile_2;
+    subjectOverride?: string;
+    titleOverride?: string;
+    summaryOverride?: string;
+    actionBlockVisible?: boolean;
+    webhookConfig?: {
+        url: string;
+        method: string;
+        headers: Record<string, string>;
+        secretEncrypted?: string;
+    };
+};
+
 export declare interface ClickedMetricValue {
     field: Field;
     value: number;
@@ -1068,16 +1124,17 @@ export declare interface CreateAlertRequest {
     description?: string;
     scheduleExpr: string;
     timezone?: string;
-    source: AlertSource;
-    operator: AlertConditionOperator;
-    threshold: number;
+    source?: AlertSource;
+    operator?: AlertConditionOperator;
+    threshold?: number;
     severity?: AlertSeverity;
     consecutiveCount?: number;
-    recipients: AlertRecipient[];
+    recipients?: AlertRecipient[];
     channels?: AlertDeliveryChannel[];
-    contextAuthoringMode?: AlertContextAuthoringMode;
     contextSources?: ContextSource[];
     presentationPrompt?: string;
+    jobConfig?: AlertJobConfig;
+    deliveryConfig?: DeliveryConfig;
     workflowDef?: Record<string, unknown>;
 }
 
@@ -1325,6 +1382,17 @@ export declare type DataType = 'string' | 'number' | 'date' | 'datetime' | 'bool
 
 export declare const DATE_FORMAT_VALUES: readonly ["MM-DD-YYYY", "YYYY-MM-DD", "MM/DD/YYYY", "DD/MM/YYYY", "MMMM DD, YYYY", "MMM DD, YYYY", "DD MMM YYYY", "YYYY-MM-DD HH:mm", "YYYY-MM-DD HH:mm:ss", "YYYY-MM-DD HH:mm Z", "YYYY-MM-DD HH:mm:ss Z", "Week of MMM DD, YYYY", "Week of MMMM DD, YYYY", "YYYY-WW", "MMM YYYY", "MMMM YYYY", "YYYY-MM", "MM/YYYY", "YYYY MMM", "Q1 YYYY", "YYYY Q1", "1st Quarter YYYY", "YYYY-Q1", "Quarter 1, YYYY", "YYYY", "YY", "custom"];
 
+declare type DateCanonicalFormat = {
+    type: 'date';
+    locale?: string;
+    pattern?: string;
+    relative?: boolean;
+    timezone?: string;
+    sourceTimezone?: string;
+    prefix?: string;
+    suffix?: string;
+};
+
 declare type DateComparisonOperation = '=' | '!=' | '>' | '>=' | '<' | '<=' | 'between' | 'not between' | 'is null' | 'is not null';
 
 export declare type DateFormatOption = {
@@ -1360,6 +1428,16 @@ export declare function deleteAlert(apiServiceUrl: string, token: string, id: st
     success: boolean;
 }>;
 
+declare type DeliveryChannel = 'EMAIL' | 'WEBHOOK' | 'SLACK' | 'IN_APP' | 'TELEGRAM';
+
+export declare type DeliveryConfig = {
+    recipients: AlertRecipient[];
+    channels: AlertDeliveryChannel[];
+    subject?: string;
+    message?: string;
+    channelConfigs?: Record<string, ChannelFormatConfig>;
+};
+
 /**
  * Field configuration for detail table columns.
  * Unlike GroupByField, DetailField does not support aggregation or granularity.
@@ -1433,6 +1511,24 @@ export declare interface DomainCalculatedMetric {
 
 export declare function downloadPdf(apiServiceUrl: string, authToken: AuthToken | undefined, password?: string, sheetSelection?: 'current' | 'all', expandedState?: Record<string, boolean>): Promise<void>;
 
+declare type DraftDeliveryConfig = {
+    channels: DeliveryChannel[];
+    channelConfigs?: Record<string, ChannelFormatConfig_2>;
+    recipients?: Array<{
+        type: string;
+        [key: string]: unknown;
+    }>;
+};
+
+declare type DraftJobConfig = {
+    source?: AlertSource;
+    operator?: AlertConditionOperator;
+    threshold?: number;
+    severity?: AlertSeverity;
+    consecutiveCount?: number;
+    sensitivityPreset?: SensitivityPreset_2 | null;
+};
+
 declare interface DrillActions {
     updateDrillHierarchies: (h: DrillHierarchy[]) => void;
     addDrillHierarchy: (h: DrillHierarchy) => void;
@@ -1673,6 +1769,15 @@ export declare interface DrillUpInteraction {
     label?: string;
 }
 
+declare type DriverCandidate = {
+    id: string;
+    label: string;
+    sourceKind: 'same_dashboard' | 'same_connection' | 'same_project';
+    provenance: string;
+    metricType: string;
+    referenceId: string;
+};
+
 export declare type DropdownItem = {
     id: string;
     name: string;
@@ -2153,6 +2258,10 @@ export declare function fmt(str: string): string;
  */
 export declare function formatFileSize(bytes?: number): string;
 
+export declare type FormatProfile = 'concise' | 'balanced' | 'detailed';
+
+declare type FormatProfile_2 = 'concise' | 'balanced' | 'detailed';
+
 export declare type FormatSpec = {
     type: 'number' | 'currency' | 'percent' | 'percentage' | 'scientific';
     locale?: string;
@@ -2446,11 +2555,6 @@ export declare interface InteractionTrigger {
     field: Field;
 }
 
-export declare function interpretAlertContext(apiServiceUrl: string, token: string, payload: {
-    intent: string;
-    ruleId?: string;
-}): Promise<AlertContextInterpretResponse>;
-
 export declare function invalidateToken(apiServiceUrl: string): Promise<any>;
 
 export declare function isBooleanDataType(dataType: string): boolean;
@@ -2694,6 +2798,21 @@ export declare type NumberOptions = {
     colorRanges?: ColorRange[];
 };
 
+declare type NumericCanonicalFormat = {
+    type: 'number' | 'currency' | 'percent' | 'scientific';
+    locale?: string;
+    minimumFractionDigits?: number;
+    maximumFractionDigits?: number;
+    useGrouping?: boolean;
+    prefix?: string;
+    suffix?: string;
+    negativeStyle?: 'minus' | 'parentheses';
+    compact?: boolean;
+    scale?: number;
+    currency?: string;
+    percentValueMode?: 'fraction' | 'whole';
+};
+
 export declare type OldFilterValue = string | number | null | (string | number)[] | RangeValue;
 
 declare type Operation = '=' | '>' | '<' | '>=' | '<=' | '!=' | 'in' | 'not in' | 'like' | 'not like' | 'between' | 'not between' | 'is null' | 'is not null';
@@ -2981,6 +3100,10 @@ declare function SemaphorQueryClient({ children, }: {
 export { SemaphorQueryClient as SemaphorDataProvider }
 export { SemaphorQueryClient }
 
+export declare type SensitivityPreset = 'low_noise' | 'standard' | 'early_warning';
+
+declare type SensitivityPreset_2 = 'low_noise' | 'standard' | 'early_warning';
+
 /**
  * Stable serializer for dashboard dirty checks.
  * This consolidates normalization + serialization into one call site, so
@@ -3027,6 +3150,12 @@ export declare type SqlGen = {
 
 declare type StateSerializer<T> = (value: T) => string;
 
+declare type StringCanonicalFormat = {
+    type: 'string';
+    prefix?: string;
+    suffix?: string;
+};
+
 declare type StringOptions = {
     maxLength?: number;
 };
@@ -3508,7 +3637,7 @@ export declare type TChartOptions = {
     treemapColorMode?: 'branch' | 'category';
 };
 
-declare type TChartType = 'bar' | 'horizontalBar' | 'line' | 'area' | 'stackedArea' | 'combo' | 'pie' | 'doughnut' | 'radar' | 'polarArea' | 'bubble' | 'scatter' | 'stackedBar' | 'stackedLine' | 'table' | 'pivotTable' | 'aggregateTable' | 'detailTable' | 'tableBuilder' | 'kpi' | 'pyramid' | 'tornado' | 'range' | 'text' | 'map' | 'funnel' | 'bullet' | 'heatmap' | 'treemap' | 'custom';
+export declare type TChartType = 'bar' | 'horizontalBar' | 'line' | 'area' | 'stackedArea' | 'combo' | 'pie' | 'doughnut' | 'radar' | 'polarArea' | 'bubble' | 'scatter' | 'stackedBar' | 'stackedLine' | 'table' | 'pivotTable' | 'aggregateTable' | 'detailTable' | 'tableBuilder' | 'kpi' | 'pyramid' | 'tornado' | 'range' | 'text' | 'map' | 'funnel' | 'bullet' | 'heatmap' | 'treemap' | 'custom';
 
 export declare type TColumnSetting<T extends DisplayDataType> = {
     columnIdx: number;
@@ -4193,9 +4322,12 @@ export declare interface UpdateAlertRequest {
     consecutiveCount?: number;
     recipients?: AlertRecipient[];
     channels?: AlertDeliveryChannel[];
-    contextAuthoringMode?: AlertContextAuthoringMode;
     contextSources?: ContextSource[];
     presentationPrompt?: string;
+    sensitivityPreset?: SensitivityPreset | null;
+    channelConfigs?: Record<string, ChannelFormatConfig>;
+    jobConfig?: AlertJobConfig;
+    deliveryConfig?: DeliveryConfig;
     workflowDef?: Record<string, unknown> | null;
 }
 
@@ -4255,8 +4387,6 @@ export declare const useAlertActions: () => AlertStoreActions;
 
 export declare function useAlertBacktest(alertId?: string): UseMutationResult<AlertBacktestResult, Error, Record<string, unknown> | undefined, unknown>;
 
-export declare function useAlertContextBuilder(ruleId?: string): UseMutationResult<AlertContextInterpretResponse, Error, string, unknown>;
-
 export declare function useAlertDeliveries(alertId: string | undefined, runId: string | undefined): UseQueryResult<    {
 attempts: Array<Record<string, unknown>>;
 }, Error>;
@@ -4669,6 +4799,19 @@ setState(nextStateOrUpdater: AlertStore | Partial<AlertStore> | ((state: Writabl
 setState(nextStateOrUpdater: AlertStore | ((state: WritableDraft<AlertStore>) => void), shouldReplace: true): void;
 }>;
 
+export declare function useAlertWizard({ cardSnapshot }: {
+    cardSnapshot: CardSnapshot | null;
+}): {
+    state: WizardState;
+    dispatch: ActionDispatch<[action: WizardAction]>;
+    nextStep: () => void;
+    prevStep: () => void;
+    toggleDriver: (id: string) => void;
+    updateJobConfig: (config: Partial<DraftJobConfig>) => void;
+    updateDeliveryConfig: (config: Partial<DraftDeliveryConfig>) => void;
+    setSensitivity: (preset: SensitivityPreset_2) => void;
+};
+
 export declare function useCard(cardId: string): {
     data: any;
     card: TCard;
@@ -5087,4 +5230,62 @@ export declare interface WindowTransform {
     };
 }
 
+declare type WizardAction = {
+    type: 'START_PREFILL';
+} | {
+    type: 'RESET_PREFILL';
+} | {
+    type: 'SET_PREFILL';
+    payload: WizardPrefillResponse;
+} | {
+    type: 'SET_PREFILL_ERROR';
+    error: string;
+} | {
+    type: 'NEXT_STEP';
+} | {
+    type: 'PREV_STEP';
+} | {
+    type: 'SET_SENSITIVITY';
+    payload: SensitivityPreset_2;
+} | {
+    type: 'TOGGLE_DRIVER';
+    driverId: string;
+} | {
+    type: 'UPDATE_JOB_CONFIG';
+    payload: Partial<DraftJobConfig>;
+} | {
+    type: 'UPDATE_DELIVERY_CONFIG';
+    payload: Partial<DraftDeliveryConfig>;
+};
+
+declare type WizardPrefillResponse = {
+    source: AlertSource;
+    metricLabel: string;
+    currentValue: number | null;
+    snapshotAge: {
+        capturedAt: string;
+        ageMinutes: number;
+        isStale: boolean;
+    };
+    suggestedName: string;
+    connectionName: string | null;
+    dashboardName: string | null;
+    calendarContext: {
+        tz: string;
+        weekStart: number;
+    } | null;
+    driverCandidates: DriverCandidate[];
+    snapshotWarning?: 'missing' | 'invalid' | 'stale';
+};
+
+declare type WizardState = {
+    step: 1 | 2 | 3;
+    prefillData: WizardPrefillResponse | null;
+    prefillLoading: boolean;
+    prefillError: string | null;
+    draftJobConfig: DraftJobConfig;
+    draftDeliveryConfig: DraftDeliveryConfig;
+    selectedDrivers: string[];
+};
+
 export { }