@spottoai/types-package 1.0.2-beta.42 → 1.0.2-beta.421

package/dist/events/baseAlert.d.ts

@@ -0,0 +1,141 @@
+import type { PaginationParams } from '../common/pagination.js';
+export type AlertSeverity = 'info' | 'warning' | 'critical';
+export type AlertStatus = 'open' | 'acknowledged' | 'resolved';
+export type AlertLifecycleEvent = 'open' | 'acknowledged' | 'resolved';
+export type AlertCategory = 'cost' | 'performance' | 'other';
+export type TagMatchMode = 'any' | 'all';
+export interface BaseAlertTag {
+    key: string;
+    value: string;
+}
+export interface BaseAlertScope {
+    subscriptionIds?: string[];
+    cloudAccountIds?: string[];
+    tags?: BaseAlertTag[];
+    tagMatch?: TagMatchMode;
+}
+export interface BaseAlertDestinationSlackOrTeams {
+    name: string;
+    webhookUrl?: string | null;
+}
+export interface BaseAlertDestinationWebhook {
+    name: string;
+    url?: string | null;
+    /**
+     * v1 defaults to sending only 'open'; when unspecified, treat as ['open'].
+     */
+    events?: AlertLifecycleEvent[];
+    auth?: {
+        type: 'bearer';
+        tokenRef?: string | null;
+    };
+}
+export interface BaseAlertDestinationJira {
+    enabled: boolean;
+    projectKey: string;
+    issueType: string;
+    labels?: string[];
+    epicKey?: string;
+}
+export interface BaseAlertDestinations {
+    slack?: BaseAlertDestinationSlackOrTeams[];
+    teams?: BaseAlertDestinationSlackOrTeams[];
+    webhooks?: BaseAlertDestinationWebhook[];
+    jira?: BaseAlertDestinationJira;
+    emails?: BaseAlertDestinationEmail[];
+}
+export interface BaseAlertDestinationEmail {
+    name?: string;
+    email?: string | null;
+    events?: AlertLifecycleEvent[];
+}
+export interface BaseAlertDefinition<TCriteria = unknown, TDestinations = BaseAlertDestinations, TScope = BaseAlertScope, TType extends string = string> {
+    id: string;
+    companyId: string;
+    name: string;
+    enabled: boolean;
+    category: AlertCategory;
+    type: TType;
+    scope: TScope;
+    criteria?: TCriteria;
+    actionGroupId?: string;
+    notifyOn?: AlertLifecycleEvent[];
+    destinations?: TDestinations;
+    /**
+     * Server-authored audit fields. Optional on create/update requests; always present on persisted records.
+     */
+    createdAt?: string;
+    createdByUserId?: string;
+    updatedAt?: string;
+    updatedByUserId?: string;
+}
+type AlertDefinitionServerAuthoredKey = 'id' | 'companyId' | 'createdAt' | 'createdByUserId' | 'updatedAt' | 'updatedByUserId';
+export type CreateAlertDefinitionInput<TDefinition extends BaseAlertDefinition = BaseAlertDefinition> = TDefinition extends BaseAlertDefinition ? Omit<TDefinition, AlertDefinitionServerAuthoredKey> : never;
+export type UpdateAlertDefinitionInput<TDefinition extends BaseAlertDefinition = BaseAlertDefinition, TCriteria = TDefinition['criteria']> = TDefinition extends BaseAlertDefinition ? Pick<TDefinition, 'name' | 'enabled' | 'scope' | 'actionGroupId' | 'notifyOn' | 'destinations'> & {
+    criteria?: TCriteria;
+} : never;
+export type BaseAlertSummary = Record<string, unknown>;
+export interface BaseAlertComment {
+    id: string;
+    userId: string;
+    userName?: string;
+    message: string;
+    createdAt: string;
+    /**
+     * Optional edit tracking; omit if edits are not supported.
+     */
+    updatedAt?: string;
+    editedByUserId?: string;
+}
+export interface BaseAlertInstance<TSummary = BaseAlertSummary, TScope = BaseAlertScope, TType extends string = string, TBreakdown = unknown> {
+    id: string;
+    companyId: string;
+    companyName: string;
+    definitionId: string;
+    category: AlertCategory;
+    type: TType;
+    status: AlertStatus;
+    severity: AlertSeverity;
+    scope: TScope;
+    discriminator?: {
+        kind: string;
+        value: string;
+    };
+    scopeSignature?: string;
+    createdAt: string;
+    /**
+     * If not yet updated, set equal to createdAt.
+     */
+    lastSeenAt?: string;
+    acknowledgedAt?: string | null;
+    acknowledgedByUserId?: string | null;
+    acknowledgedByUserName?: string | null;
+    /**
+     * Optional freeform note captured when acknowledging an alert.
+     */
+    acknowledgedNote?: string | null;
+    resolvedAt?: string | null;
+    resolvedByUserId?: string | null;
+    resolvedByUserName?: string | null;
+    /**
+     * Optional freeform note captured when resolving an alert.
+     */
+    resolvedNote?: string | null;
+    jiraIssueKey?: string;
+    comments?: BaseAlertComment[];
+    summary?: TSummary;
+    breakdown?: TBreakdown;
+    detailPath?: string;
+    /** Internal definition snapshot used to keep history readable after definition deletion. */
+    definitionSnapshot?: string;
+}
+export interface ListAlertsParams<TType extends string = string> extends PaginationParams {
+    status?: AlertStatus;
+    type?: TType;
+    definitionId?: string;
+    since?: string;
+    until?: string;
+}
+export type ListAlertDefinitionsParams = PaginationParams;
+export {};
+//# sourceMappingURL=baseAlert.d.ts.map

package/dist/events/baseAlert.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"baseAlert.d.ts","sourceRoot":"","sources":["../../src/events/baseAlert.ts"],"names":[],"mappings":"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"}

package/dist/events/baseAlert.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=baseAlert.js.map

package/dist/events/baseAlert.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"baseAlert.js","sourceRoot":"","sources":["../../src/events/baseAlert.ts"],"names":[],"mappings":""}

package/dist/events/cost.d.ts

@@ -0,0 +1,371 @@
+import { AlertSeverity, AlertStatus, AlertLifecycleEvent, TagMatchMode, BaseAlertScope, BaseAlertDestinationSlackOrTeams, BaseAlertDestinationWebhook, BaseAlertDestinationJira, BaseAlertDestinationEmail, BaseAlertDestinations, BaseAlertComment, BaseAlertDefinition, BaseAlertInstance, ListAlertsParams, ListAlertDefinitionsParams } from './baseAlert.js';
+export type CostAlertSeverity = AlertSeverity;
+export type CostAlertCategory = 'cost';
+export type CostAlertType = 'costAnomaly' | 'budget';
+export type CostAlertStatus = AlertStatus;
+export type { TagMatchMode };
+export interface CostAlertTag {
+    key: string;
+    value: string;
+}
+export interface CostAlertScope extends BaseAlertScope {
+    tags?: CostAlertTag[];
+}
+export type CostAlertTriggerType = 'threshold' | 'baseline' | 'pricing_missing' | 'missing_metrics' | 'default';
+export interface CostAlertContext {
+    triggerType?: CostAlertTriggerType;
+    trigger?: {
+        label?: string;
+        value?: number;
+        source?: string;
+        overPct?: number;
+        severity?: CostAlertSeverity;
+    };
+    estimate?: {
+        amount?: number;
+        currency?: string;
+        source?: string;
+    };
+    baseline?: {
+        lastDay?: number;
+        prevDay?: number;
+        avg7?: number;
+        avg14?: number;
+        tokenLastDay?: number;
+        tokenPrevDay?: number;
+        tokenAvg7?: number;
+        tokenAvg14?: number;
+        dodPct?: number;
+        tokenDodPct?: number;
+    };
+    reason?: string;
+}
+export interface CostAlert {
+    id: string;
+    severity: CostAlertSeverity;
+    title: string;
+    description: string;
+    eventId: string;
+    eventTimestamp: string;
+    resourceId: string;
+    resourceType: string;
+    serviceCategory?: string;
+    subscriptionId?: string;
+    resourceGroup?: string;
+    estimatedCost?: number;
+    createdAt: string;
+    context?: CostAlertContext;
+}
+export interface CostAlertFile {
+    generatedAt: string;
+    items: CostAlert[];
+}
+/**
+ * New Alert Definition (Table Storage row / API DTO).
+ */
+export interface CostAlertDefinition extends BaseAlertDefinition<CostAlertCriteria, CostAlertDestinations, CostAlertScope, CostAlertType> {
+    type: CostAlertType;
+    scope: CostAlertScope;
+    criteria?: CostAlertCriteria;
+    destinations?: CostAlertDestinations;
+    /** Whether the current user has permission to edit this alert definition. Added by API. */
+    canEdit?: boolean;
+    /** Whether the current user has permission to delete this alert definition. Added by API. */
+    canDelete?: boolean;
+}
+export type ListCostAlertDefinitionsParams = ListAlertDefinitionsParams;
+export type ListCostAlertsParams = ListAlertsParams<CostAlertType>;
+export interface CostAlertCriteria {
+    confidence?: Array<'High' | 'Medium' | 'Low'>;
+    minDelta?: number;
+    minPercentChange?: number;
+    minCost?: number;
+    tagRelevance?: {
+        minScopeSharePercent?: number;
+    };
+    /**
+     * Data source selection:
+     * - auto: use actual billing if available, else estimated
+     * - actual: billing artifacts only
+     * - estimated: metrics/pricing estimation only
+     */
+    dataSource?: 'auto' | 'actual' | 'estimated';
+    period?: 'monthly' | 'last_30_days';
+    budgetAmount?: number;
+    budgetCurrency?: string;
+    budgetThresholdPercents?: number[];
+    budgetThresholdAmounts?: number[];
+    forecastThresholdPercents?: number[];
+    forecastThresholdAmounts?: number[];
+    /**
+     * Optional day-over-day / month-over-month thresholds (cost anomaly extensions).
+     * These are additive to minDelta/minPercentChange when compare window is DoD/MoM.
+     */
+    dodThresholdPercents?: number[];
+    dodThresholdAmounts?: number[];
+    momThresholdPercents?: number[];
+    momThresholdAmounts?: number[];
+}
+/**
+ * Destination types for cost alerts are used for both:
+ * - API request payloads (create/update), where secrets are required by validation
+ * - API responses, where secrets may be redacted/omitted for non-admin readers
+ *
+ * For that reason, secret-bearing fields are optional at the type level.
+ */
+export interface CostAlertDestinationSlackOrTeams extends Omit<BaseAlertDestinationSlackOrTeams, 'webhookUrl'> {
+    webhookUrl?: string | null;
+}
+export interface CostAlertDestinationWebhook extends Omit<BaseAlertDestinationWebhook, 'url' | 'auth'> {
+    url?: string | null;
+    auth?: {
+        type: 'bearer';
+        tokenRef?: string | null;
+    };
+    events?: AlertLifecycleEvent[];
+}
+export interface CostAlertDestinationEmail extends Omit<BaseAlertDestinationEmail, 'email'> {
+    email?: string | null;
+}
+export type CostAlertDestinationJira = BaseAlertDestinationJira;
+export interface CostAlertDestinations extends BaseAlertDestinations {
+    slack?: CostAlertDestinationSlackOrTeams[];
+    teams?: CostAlertDestinationSlackOrTeams[];
+    webhooks?: CostAlertDestinationWebhook[];
+    jira?: CostAlertDestinationJira;
+    emails?: CostAlertDestinationEmail[];
+}
+export interface CostAlertDiscriminator {
+    kind: 'anomalyDate' | 'periodStart' | string;
+    value: string;
+}
+export type CostAlertComment = BaseAlertComment;
+export interface CostAlertSummary {
+    currencyCode?: string;
+    confidence?: 'High' | 'Medium' | 'Low';
+    delta?: number;
+    percentChange?: number;
+    amount?: number;
+    budgetAmount?: number;
+    forecastAmount?: number;
+    /**
+     * Time window for the computed amount (ISO date).
+     * This represents the period for current cost (from periodStart to today).
+     */
+    periodStart?: string;
+    periodEnd?: string;
+    /**
+     * Optional window size for estimated spend (days).
+     * This represents the number of days in the forecast window.
+     */
+    windowDays?: number;
+    /**
+     * Forecast period start date (ISO date).
+     * Forecast is projected from this date to forecastPeriodEnd.
+     */
+    forecastPeriodStart?: string;
+    /**
+     * Forecast period end date (ISO date).
+     * Forecast is projected until this date.
+     */
+    forecastPeriodEnd?: string;
+    /**
+     * Full period start date (ISO date).
+     * This represents the start of the entire period (e.g., month start for monthly budgets).
+     */
+    fullPeriodStart?: string;
+    /**
+     * Full period end date (ISO date).
+     * This represents the end of the entire period (e.g., month end for monthly budgets).
+     */
+    fullPeriodEnd?: string;
+    /**
+     * actual | estimated (resolved at evaluation time)
+     */
+    dataSource?: 'actual' | 'estimated' | 'blended' | 'unknown' | 'metrics_pricing';
+    /**
+     * Estimated coverage (0-100) when using estimated spend.
+     */
+    coveragePercent?: number;
+    reconciliationStatus?: 'pending' | 'matched' | 'mismatch';
+    actualShare?: number;
+    estimatedShare?: number;
+    estimationMethod?: string;
+    estimatedDays?: string[];
+    estimatedDaysSource?: 'metrics' | 'ma7' | 'ma14' | 'ma';
+    periodType?: 'calendar_month' | 'billing_period' | 'rolling_30_days';
+    dataShare?: {
+        actual?: number;
+        estimated?: number;
+        forecast?: number;
+        estimatedByMethod?: {
+            metrics_pricing?: number;
+            moving_average?: number;
+            other?: number;
+        };
+        qualityScore?: number;
+        qualityLevel?: 'high' | 'medium' | 'low';
+    };
+    tagFilterApplied?: boolean;
+    /**
+     * Human-readable summary text for display in alerts list and notifications.
+     * Generated from structured summary data for easy consumption.
+     */
+    summaryText?: string;
+    /**
+     * Forecast confidence level (High, Medium, Low) based on data availability and elapsed days.
+     * Used to indicate the reliability of forecast calculations.
+     */
+    forecastConfidence?: 'high' | 'medium' | 'low';
+    /**
+     * Forecast method used to calculate the forecast amount.
+     * Values: 'conservative-blended', 'conservative-linear', 'trend-based', 'linear', 'rolling-current', 'fallback'
+     */
+    forecastMethod?: string;
+    /**
+     * Detailed information about the forecast calculation, including:
+     * - elapsedDays: Number of days elapsed in the period
+     * - totalDays: Total days in the period
+     * - remainingDays: Number of days remaining in the forecast period
+     * - dailyRate: Daily spending rate
+     * - For conservative-blended: historicalAverage, historicalDailyRate, blendedDailyRate, blendRatio
+     * - For conservative-linear: multiplier
+     * - For trend-based: trendAdjustment, growthRate, growthRateApplied
+     * - For recent-average-decreasing: recentAverageDailyRate, isDecreasingTrend
+     * - For weighted-average: recentAverageDailyRate
+     * - For rolling-current: method, note
+     */
+    forecastDetails?: Record<string, unknown>;
+    /**
+     * Human-readable explanation combining data confidence, estimated mix, and forecast approach.
+     */
+    dataStatusExplaination?: string;
+    /**
+     * Daily forecast costs for the remaining days in the period.
+     * Each entry contains the date (YYYYMMDD format), predicted cost, and method used.
+     * This allows frontend to visualize how the forecast is distributed across days.
+     */
+    forecastDailyCosts?: Array<{
+        date: number;
+        cost: number;
+        dataSource: 'forecast';
+        method: string;
+    }>;
+    /**
+     * Trigger reason indicating why the alert was triggered.
+     * For budget alerts: 'budget-threshold-percent' | 'budget-threshold-amount' | 'forecast-threshold-percent' | 'forecast-threshold-amount' | 'budget-threshold' | 'forecast-threshold' | 'both'
+     * For cost anomaly alerts: 'confidence' | 'minDelta' | 'minPercentChange' | 'minCost' | 'dodThreshold' | 'momThreshold' | string
+     */
+    triggerReason?: string | string[];
+    /**
+     * Earliest configured actual-spend trigger converted to an amount in the alert currency.
+     * Used to explain the budget condition in UI summaries and notifications.
+     */
+    actualTriggerAmount?: number;
+    /**
+     * Earliest configured forecast trigger converted to an amount in the alert currency.
+     * Used to explain the forecast condition in UI summaries and notifications.
+     */
+    forecastTriggerAmount?: number;
+}
+/**
+ * Daily cost data point for breakdown visualization
+ */
+export interface DailyCostDataPoint {
+    /** Date in YYYYMMDD format (number) */
+    date: number;
+    /** Cost for this day */
+    cost: number;
+    /** Data source: actual (from billing/metrics), estimated (MA-based), or forecast (projected) */
+    dataSource: 'actual' | 'estimated' | 'forecast';
+    /** For estimated/forecast: method used (e.g., 'moving-average-7', 'moving-average-14', 'moving-average', 'metrics_pricing', 'linear', 'trend') */
+    method?: string;
+    /** For actual: whether this came from metrics (true) or billing (false) */
+    fromMetrics?: boolean;
+}
+export interface CostAlertBreakdownResource {
+    resourceId: string;
+    name?: string;
+    delta?: number;
+    cost?: number;
+    percentage?: number;
+    /**
+     * Combined tags (Azure + spottoTags) for client-side filtering (ANY/ALL).
+     */
+    tags?: Record<string, string>;
+    /** Optional: metrics inputs for this resource (e.g., tokensIn/out). */
+    metricsInput?: Record<string, unknown>;
+    /** Optional: unit rates applied to compute cost. */
+    unitRates?: Record<string, number>;
+    /** Optional: estimated vs actual composition for UI. */
+    dataSource?: 'estimated' | 'actual' | 'blended' | 'metrics_pricing';
+    actualShare?: number;
+    estimatedShare?: number;
+    estimationMethod?: string;
+    /**
+     * Resource type (e.g., "microsoft.cognitiveservices/accounts")
+     * Helps frontend determine how to display this resource and its children
+     */
+    resourceType?: string;
+    /**
+     * Daily cost breakdown for this resource
+     * Includes actual, estimated, and forecast days
+     */
+    dailyCosts?: DailyCostDataPoint[];
+    /**
+     * Deployment-level breakdown (only for resources that have sub-components)
+     * For cognitive services: contains deployment/model information
+     * Limited to top N deployments to keep breakdown size manageable
+     */
+    deployments?: Array<{
+        deployment?: string;
+        model?: string;
+        cost: number;
+        percentage?: number;
+        metricsInput?: Record<string, unknown>;
+        unitRates?: Record<string, number>;
+        /** Daily cost breakdown for this deployment */
+        dailyCosts?: DailyCostDataPoint[];
+    }>;
+}
+export interface CostAlertBreakdownService {
+    serviceName: string;
+    delta?: number;
+    cost?: number;
+    percentage?: number;
+    dataSource?: 'estimated' | 'actual' | 'blended' | 'metrics_pricing';
+    /** Daily cost breakdown aggregated at service level */
+    dailyCosts?: DailyCostDataPoint[];
+    resources?: CostAlertBreakdownResource[];
+    unmappedResourceNames?: string[];
+}
+export interface CostAlertBreakdownTop {
+    subscriptionId: string;
+    subscriptionName?: string;
+    cost?: number;
+    percentage?: number;
+    /** Daily cost breakdown aggregated at subscription level */
+    dailyCosts?: DailyCostDataPoint[];
+    services?: CostAlertBreakdownService[];
+}
+export interface CostAlertBreakdownSummary {
+    top?: CostAlertBreakdownTop[];
+}
+/**
+ * New Alert Instance (Table Storage row / API DTO).
+ * Legacy CostAlert can map into this with status=open and category=cost.
+ */
+export interface CostAlertInstance extends BaseAlertInstance<CostAlertSummary, CostAlertScope, CostAlertType, CostAlertBreakdownSummary> {
+    category: CostAlertCategory;
+    discriminator: CostAlertDiscriminator;
+    /**
+     * Derived signature of scope (subs + tags) for idempotency/dedupe.
+     */
+    scopeSignature?: string;
+    jiraIssueKey?: string;
+    comments?: CostAlertComment[];
+    summary?: CostAlertSummary;
+    breakdown?: CostAlertBreakdownSummary;
+    definitionSnapshot?: string;
+}
+//# sourceMappingURL=cost.d.ts.map

package/dist/events/cost.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cost.d.ts","sourceRoot":"","sources":["../../src/events/cost.ts"],"names":[],"mappings":"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"}

package/dist/events/cost.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=cost.js.map

package/dist/events/cost.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cost.js","sourceRoot":"","sources":["../../src/events/cost.ts"],"names":[],"mappings":""}

package/dist/events/costAnomalies.d.ts

@@ -0,0 +1,47 @@
+import type { BillingAnomalyDriver } from '../azure/billingPlots.js';
+/**
+ * A compact representation of anomaly drivers that are treated as subscription-level spend
+ * (i.e. no stable resourceId to deep link to), used in cost anomaly notifications.
+ */
+export interface CostAnomalySubscriptionPlan {
+    name: string;
+    summary?: string;
+    resourceId?: string;
+    serviceName?: string;
+    cost?: number;
+    delta?: number;
+    percentChange?: number | null;
+}
+export type CostAnomalyStatus = 'new' | 'notified';
+/**
+ * Persisted cost anomaly record used for notification dedupe and anomaly history.
+ */
+export interface CostAnomalyRecord {
+    subscriptionId: string;
+    anomalyId: string;
+    /** Unix timestamp for the anomaly date */
+    date: number;
+    summary: string;
+    confidence?: string;
+    cost?: number;
+    delta?: number;
+    percentChange?: number | null;
+    currencyCode?: string;
+    detectedAt: string;
+    notifiedAt?: string;
+    status: CostAnomalyStatus;
+    drivers?: BillingAnomalyDriver[];
+    notes?: string[];
+    metadata?: Record<string, unknown>;
+    resourceIds?: string[];
+    resourceNames?: string[];
+    subscriptionPlans?: CostAnomalySubscriptionPlan[];
+}
+export interface CostAnomalyListResult {
+    results: CostAnomalyRecord[];
+    continuation?: {
+        NextPartitionKey?: string;
+        NextRowKey?: string;
+    };
+}
+//# sourceMappingURL=costAnomalies.d.ts.map

package/dist/events/costAnomalies.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"costAnomalies.d.ts","sourceRoot":"","sources":["../../src/events/costAnomalies.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAErE;;;GAGG;AACH,MAAM,WAAW,2BAA2B;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B;AAED,MAAM,MAAM,iBAAiB,GAAG,KAAK,GAAG,UAAU,CAAC;AAEnD;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,0CAA0C;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,iBAAiB,CAAC;IAC1B,OAAO,CAAC,EAAE,oBAAoB,EAAE,CAAC;IACjC,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,iBAAiB,CAAC,EAAE,2BAA2B,EAAE,CAAC;CACnD;AAED,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,iBAAiB,EAAE,CAAC;IAC7B,YAAY,CAAC,EAAE;QAAE,gBAAgB,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACnE"}

package/dist/events/costAnomalies.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=costAnomalies.js.map

package/dist/events/costAnomalies.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"costAnomalies.js","sourceRoot":"","sources":["../../src/events/costAnomalies.ts"],"names":[],"mappings":""}

package/dist/events/costViews.d.ts

@@ -0,0 +1,25 @@
+import type { CostAlertCriteria, CostAlertDefinition, CostAlertInstance } from './cost';
+/**
+ * Lightweight definition reference included alongside instances in list views.
+ * This is not persisted as part of the alert instance row.
+ */
+export interface CostAlertDefinitionReference {
+    id: string;
+    name: string;
+    criteria?: CostAlertCriteria;
+    /** The referenced definition no longer exists, but the alert instance remains in history. */
+    deleted?: boolean;
+}
+/**
+ * API/Portal view model for an alert instance.
+ * Extends the persisted `CostAlertInstance` with runtime-only convenience fields.
+ */
+export interface CostAlertInstanceView extends CostAlertInstance {
+    /**
+     * Hydrated definition data for UI rendering. This is not stored in Table Storage.
+     * - List endpoints often return a lightweight `CostAlertDefinitionReference`.
+     * - Detail endpoints may return the full `CostAlertDefinition` (or a superset).
+     */
+    definition?: CostAlertDefinitionReference | CostAlertDefinition;
+}
+//# sourceMappingURL=costViews.d.ts.map

package/dist/events/costViews.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"costViews.d.ts","sourceRoot":"","sources":["../../src/events/costViews.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,QAAQ,CAAC;AAExF;;;GAGG;AACH,MAAM,WAAW,4BAA4B;IAC3C,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,iBAAiB,CAAC;IAC7B,6FAA6F;IAC7F,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;;GAGG;AACH,MAAM,WAAW,qBAAsB,SAAQ,iBAAiB;IAC9D;;;;OAIG;IACH,UAAU,CAAC,EAAE,4BAA4B,GAAG,mBAAmB,CAAC;CACjE"}

package/dist/events/costViews.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=costViews.js.map

package/dist/events/costViews.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"costViews.js","sourceRoot":"","sources":["../../src/events/costViews.ts"],"names":[],"mappings":""}