@debugbundle/shared-types 2.0.0 → 2.1.0

package/README.md

@@ -36,5 +36,6 @@ EventEnvelopeSchema.parse(event);
 
 ## Notes
 
+- Version 2.1 adds browser page lifecycle and bounded target-attribute capture matchers, alert noise policies, and optional correlated recovery evidence. Bundle schemas remain version 1 and existing SDK event envelopes stay compatible.
 - Published from the core-owned shared-package release workflow in `debugbundle/debugbundle`.
 - Source remains core-owned in the DebugBundle workspace and is published through the shared-package release workflow.

package/dist/alert-notification-policy.d.ts

@@ -0,0 +1,71 @@
+import { z } from "zod";
+export declare const AlertEmailConfigSchema: z.ZodObject<{
+    to: z.ZodString;
+    aggregation_window_seconds: z.ZodOptional<z.ZodNumber>;
+}, "strict", z.ZodTypeAny, {
+    to: string;
+    aggregation_window_seconds?: number | undefined;
+}, {
+    to: string;
+    aggregation_window_seconds?: number | undefined;
+}>;
+export declare const AlertSlackConfigSchema: z.ZodUnion<[z.ZodObject<{
+    webhook_url: z.ZodString;
+    cooldown_scope: z.ZodOptional<z.ZodEnum<["incident", "project"]>>;
+}, "strict", z.ZodTypeAny, {
+    webhook_url: string;
+    cooldown_scope?: "incident" | "project" | undefined;
+}, {
+    webhook_url: string;
+    cooldown_scope?: "incident" | "project" | undefined;
+}>, z.ZodObject<{
+    slack_destination_id: z.ZodString;
+    cooldown_scope: z.ZodOptional<z.ZodEnum<["incident", "project"]>>;
+}, "strict", z.ZodTypeAny, {
+    slack_destination_id: string;
+    cooldown_scope?: "incident" | "project" | undefined;
+}, {
+    slack_destination_id: string;
+    cooldown_scope?: "incident" | "project" | undefined;
+}>]>;
+export declare const AlertDiscordConfigSchema: z.ZodObject<{
+    webhook_url: z.ZodString;
+    cooldown_scope: z.ZodOptional<z.ZodEnum<["incident", "project"]>>;
+}, "strict", z.ZodTypeAny, {
+    webhook_url: string;
+    cooldown_scope?: "incident" | "project" | undefined;
+}, {
+    webhook_url: string;
+    cooldown_scope?: "incident" | "project" | undefined;
+}>;
+export declare const AlertWebhookConfigSchema: z.ZodObject<{
+    target_url: z.ZodString;
+    cooldown_scope: z.ZodOptional<z.ZodEnum<["incident", "project"]>>;
+}, "strict", z.ZodTypeAny, {
+    target_url: string;
+    cooldown_scope?: "incident" | "project" | undefined;
+}, {
+    target_url: string;
+    cooldown_scope?: "incident" | "project" | undefined;
+}>;
+/** A digest retains distinct incidents. Immediate-channel project cooldowns are opt-in,
+ * scoped to the selected rule, environment and severity so an escalation still alerts. */
+export declare function resolveAlertNoisePolicy(input: {
+    channel: string;
+    config: Record<string, unknown>;
+    projectId: string;
+    incidentId: string;
+    environment: string;
+    severity: string;
+    notificationKey: string;
+    cooldownSeconds: number;
+    coalescingWindowSeconds?: number;
+    coalescingKey?: string;
+}): {
+    notification_key: string;
+    cooldown_seconds: number;
+    aggregation_window_seconds: number;
+};
+/** Destination-only edits retain API-configured noise options on the same channel. */
+export declare function preserveAlertNoiseSettings(channel: string, previous: Record<string, unknown> | undefined, next: Record<string, unknown>): Record<string, unknown>;
+//# sourceMappingURL=alert-notification-policy.d.ts.map

package/dist/alert-notification-policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"alert-notification-policy.d.ts","sourceRoot":"","sources":["../src/alert-notification-policy.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,sBAAsB;;;;;;;;;EAKxB,CAAC;AAEZ,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;IAGjC,CAAC;AACH,eAAO,MAAM,wBAAwB;;;;;;;;;EAE1B,CAAC;AACZ,eAAO,MAAM,wBAAwB;;;;;;;;;EAE1B,CAAC;AAEZ;0FAC0F;AAC1F,wBAAgB,uBAAuB,CAAC,KAAK,EAAE;IAC7C,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,EAAE,MAAM,CAAC;IACxB,eAAe,EAAE,MAAM,CAAC;IACxB,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,GAAG;IAAE,gBAAgB,EAAE,MAAM,CAAC;IAAC,gBAAgB,EAAE,MAAM,CAAC;IAAC,0BAA0B,EAAE,MAAM,CAAA;CAAE,CAoB7F;AAED,sFAAsF;AACtF,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,EAC7C,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAUzB"}

package/dist/alert-notification-policy.js

@@ -0,0 +1,54 @@
+import { z } from "zod";
+export const AlertEmailConfigSchema = z
+    .object({
+    to: z.string().email(),
+    aggregation_window_seconds: z.number().int().min(1).max(300).optional()
+})
+    .strict();
+const cooldownScope = z.enum(["incident", "project"]).optional();
+export const AlertSlackConfigSchema = z.union([
+    z.object({ webhook_url: z.string().url().max(2000), cooldown_scope: cooldownScope }).strict(),
+    z.object({ slack_destination_id: z.string().uuid(), cooldown_scope: cooldownScope }).strict()
+]);
+export const AlertDiscordConfigSchema = z
+    .object({ webhook_url: z.string().url().max(2000), cooldown_scope: cooldownScope })
+    .strict();
+export const AlertWebhookConfigSchema = z
+    .object({ target_url: z.string().url().max(2000), cooldown_scope: cooldownScope })
+    .strict();
+/** A digest retains distinct incidents. Immediate-channel project cooldowns are opt-in,
+ * scoped to the selected rule, environment and severity so an escalation still alerts. */
+export function resolveAlertNoisePolicy(input) {
+    const email = input.channel === "email";
+    const configuredWindow = AlertEmailConfigSchema.safeParse(input.config);
+    return {
+        notification_key: email
+            ? input.coalescingWindowSeconds === undefined
+                ? input.notificationKey
+                : input.incidentId
+            : input.config["cooldown_scope"] === "project"
+                ? JSON.stringify(["project_alert", input.projectId, input.environment, input.severity])
+                : input.notificationKey,
+        // Legacy queued jobs used one key for both checks; retain their bounded behavior.
+        cooldown_seconds: email || input.coalescingKey !== undefined
+            ? input.cooldownSeconds
+            : Math.max(input.cooldownSeconds, input.coalescingWindowSeconds ?? 0),
+        aggregation_window_seconds: configuredWindow.success
+            ? (configuredWindow.data.aggregation_window_seconds ?? 10)
+            : 10
+    };
+}
+/** Destination-only edits retain API-configured noise options on the same channel. */
+export function preserveAlertNoiseSettings(channel, previous, next) {
+    if (previous === undefined)
+        return next;
+    if (channel === "email") {
+        const parsed = AlertEmailConfigSchema.safeParse(previous);
+        return parsed.success && parsed.data.aggregation_window_seconds !== undefined
+            ? { aggregation_window_seconds: parsed.data.aggregation_window_seconds, ...next }
+            : next;
+    }
+    const scope = cooldownScope.safeParse(previous["cooldown_scope"]);
+    return scope.success && scope.data !== undefined ? { cooldown_scope: scope.data, ...next } : next;
+}
+//# sourceMappingURL=alert-notification-policy.js.map

package/dist/alert-notification-policy.js.map

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

package/dist/analytics-product.d.ts

@@ -525,20 +525,20 @@ export declare const AnalyticsBundleV1Schema: z.ZodObject<{
         to: z.ZodString;
         granularity: z.ZodEnum<["hour", "day", "week", "month"]>;
     }, "strict", z.ZodTypeAny, {
-        from: string;
         to: string;
+        from: string;
         granularity: "hour" | "day" | "week" | "month";
     }, {
-        from: string;
         to: string;
+        from: string;
         granularity: "hour" | "day" | "week" | "month";
     }>, {
-        from: string;
         to: string;
+        from: string;
         granularity: "hour" | "day" | "week" | "month";
     }, {
-        from: string;
         to: string;
+        from: string;
         granularity: "hour" | "day" | "week" | "month";
     }>;
     summary: z.ZodObject<{
@@ -597,6 +597,11 @@ export declare const AnalyticsBundleV1Schema: z.ZodObject<{
         input_fingerprint: string;
     }>;
 }, "strict", z.ZodTypeAny, {
+    project: {
+        project_id: string;
+        service: string | null;
+        environment: string | null;
+    };
     schema_version: "analytics_bundle.v1";
     summary: {
         title: string;
@@ -607,14 +612,9 @@ export declare const AnalyticsBundleV1Schema: z.ZodObject<{
     journey_patterns: Record<string, unknown>[];
     analysis_kind: "usage_summary" | "route_health" | "funnel_dropoff" | "journey_friction" | "feature_usage" | "incident_impact" | "deploy_comparison" | "conversion_path";
     bundle_type: "analytics";
-    project: {
-        project_id: string;
-        service: string | null;
-        environment: string | null;
-    };
     analysis_window: {
-        from: string;
         to: string;
+        from: string;
         granularity: "hour" | "day" | "week" | "month";
     };
     metrics: {
@@ -636,6 +636,11 @@ export declare const AnalyticsBundleV1Schema: z.ZodObject<{
         input_fingerprint: string;
     };
 }, {
+    project: {
+        project_id: string;
+        service: string | null;
+        environment: string | null;
+    };
     schema_version: "analytics_bundle.v1";
     summary: {
         title: string;
@@ -646,14 +651,9 @@ export declare const AnalyticsBundleV1Schema: z.ZodObject<{
     journey_patterns: Record<string, unknown>[];
     analysis_kind: "usage_summary" | "route_health" | "funnel_dropoff" | "journey_friction" | "feature_usage" | "incident_impact" | "deploy_comparison" | "conversion_path";
     bundle_type: "analytics";
-    project: {
-        project_id: string;
-        service: string | null;
-        environment: string | null;
-    };
     analysis_window: {
-        from: string;
         to: string;
+        from: string;
         granularity: "hour" | "day" | "week" | "month";
     };
     metrics: {