@whooshbang/sdk 5.0.0 → 6.0.0

package/dist/recipient/quiet-view.js

@@ -0,0 +1,250 @@
+/**
+ * A person's quiet hours, as the "Quiet hours" tab edits them (FXO-2103).
+ *
+ * Pure, so the rules — what a save sends, what counts as a change, which
+ * field an error belongs to — are testable without a browser and shared by
+ * the subscriber panel and the dashboard, which cannot then drift apart.
+ */
+/** The channels quiet hours set a behaviour for, in the order they show. */
+export const QUIET_CHANNELS = ["telegram", "slack", "email"];
+/** ISO weekdays, Monday first. */
+export const QUIET_DAYS = [1, 2, 3, 4, 5, 6, 7];
+export const QUIET_WINDOWS_MAX = 7;
+/** What a new period suggests: every night, 22:00 to 07:00. */
+export const QUIET_SUGGESTED_WINDOW = {
+    days: [...QUIET_DAYS],
+    end: "07:00",
+    start: "22:00",
+};
+/** The browser's own named time zone, or UTC when it has none. */
+export function browserTimeZone() {
+    try {
+        const zone = Intl.DateTimeFormat().resolvedOptions().timeZone;
+        return zone.length > 0 ? zone : "UTC";
+    }
+    catch {
+        return "UTC";
+    }
+}
+/** The zone the times are shown in: the one quiet hours follow, else the browser's. */
+export function quietTimeZone(quiet, fallback) {
+    return quiet.effective_time_zone ?? quiet.time_zone ?? fallback;
+}
+/**
+ * Whether the person picks their own time zone. One an administrator set, or
+ * one their application supplies, wins over a saved one, so a picker there
+ * would change nothing.
+ */
+export function quietTimeZoneEditable(quiet) {
+    return (quiet.time_zone_source !== "administrator" &&
+        quiet.time_zone_source !== "application");
+}
+export function startQuietDraft(quiet, fallbackTimeZone) {
+    const saved = quiet.quiet_channel?.binding_id;
+    const offered = saved !== undefined &&
+        quiet.quiet_channel_options.some((option) => option.binding_id === saved);
+    return {
+        channels: {
+            email: quiet.channels.email,
+            slack: quiet.channels.slack,
+            telegram: quiet.channels.telegram,
+        },
+        criticalBreakthrough: quiet.critical_breakthrough,
+        quietChannelBindingId: offered ? saved : undefined,
+        timeZone: quietTimeZone(quiet, fallbackTimeZone),
+        whenWithheld: quiet.when_withheld,
+        // Nothing saved yet: suggest every night, so turning quiet hours on is
+        // one press. Saved and empty stays empty.
+        windows: quiet.configured
+            ? quiet.windows.map((window) => ({
+                days: [...window.days],
+                end: window.end,
+                start: window.start,
+            }))
+            : [QUIET_SUGGESTED_WINDOW],
+    };
+}
+function signature(draft) {
+    return JSON.stringify([
+        draft.windows.map((window) => [
+            [...window.days].sort((a, b) => a - b),
+            window.start,
+            window.end,
+        ]),
+        QUIET_CHANNELS.map((channel) => draft.channels[channel]),
+        draft.criticalBreakthrough,
+        draft.whenWithheld,
+        draft.whenWithheld === "quiet_channel" ? draft.quietChannelBindingId : null,
+        draft.timeZone,
+    ]);
+}
+/** Whether the person changed anything since the tab showed what is saved. */
+export function quietEdited(draft, quiet, fallbackTimeZone) {
+    return (draft !== null &&
+        signature(draft) !== signature(startQuietDraft(quiet, fallbackTimeZone)));
+}
+/** Whether Save would change anything. Nothing saved yet always would. */
+export function quietChanged(draft, quiet, fallbackTimeZone) {
+    return !quiet.configured || quietEdited(draft, quiet, fallbackTimeZone);
+}
+/** Whether any channel keeps messages back, so "where they go" matters. */
+export function quietWithholds(draft) {
+    return QUIET_CHANNELS.some((channel) => draft.channels[channel] === "withhold");
+}
+export function quietSaveRequest(draft) {
+    return {
+        channels: { ...draft.channels },
+        critical_breakthrough: draft.criticalBreakthrough,
+        ...(draft.whenWithheld === "quiet_channel" &&
+            draft.quietChannelBindingId !== undefined
+            ? { quiet_channel_binding_id: draft.quietChannelBindingId }
+            : {}),
+        time_zone: draft.timeZone,
+        when_withheld: draft.whenWithheld,
+        windows: draft.windows.map((window) => ({
+            days: [...window.days].sort((a, b) => a - b),
+            end: window.end,
+            start: window.start,
+        })),
+    };
+}
+const TIME = /^(?:[01]\d|2[0-3]):[0-5]\d$/u;
+/**
+ * The mistakes the panel can see before asking: a period with no days, a
+ * missing time, a period that starts and ends together, and a quiet channel
+ * not chosen. The service checks everything again.
+ */
+export function quietDraftErrors(draft) {
+    const errors = {};
+    if (draft.windows.length > QUIET_WINDOWS_MAX)
+        errors["/windows"] = "window_limit";
+    draft.windows.forEach((window, index) => {
+        const at = `/windows/${String(index)}`;
+        if (window.days.length === 0)
+            errors[`${at}/days`] = "window_days_invalid";
+        if (!TIME.test(window.start))
+            errors[`${at}/start`] = "window_time_invalid";
+        if (!TIME.test(window.end))
+            errors[`${at}/end`] = "window_time_invalid";
+        else if (window.start === window.end)
+            errors[`${at}/end`] = "window_empty";
+    });
+    if (draft.whenWithheld === "quiet_channel" &&
+        draft.quietChannelBindingId === undefined)
+        errors["/quiet_channel_binding_id"] = "quiet_channel_required";
+    return errors;
+}
+/** The service's field errors, by field, from a `request_invalid` problem. */
+export function quietProblemErrors(problem) {
+    const errors = {};
+    for (const error of problem.field_errors ?? [])
+        errors[error.field.startsWith("/") ? error.field : `/${error.field}`] ??=
+            error.code;
+    return errors;
+}
+/**
+ * The control a field error belongs to, by the `data-action` both editors
+ * give it, so focus can go there after a refused save.
+ */
+export function quietErrorControl(field, draft) {
+    const window = /^\/windows\/(\d+)\/(days|start|end)/u.exec(field);
+    if (window) {
+        const [, index = "0", part = "days"] = window;
+        return part === "days"
+            ? `quiet:day:${index}:${String(QUIET_DAYS[0])}`
+            : `quiet:${part}:${index}`;
+    }
+    const channel = /^\/channels\/(telegram|slack|email)/u.exec(field)?.[1];
+    if (channel !== undefined)
+        return `quiet:channel:${channel}:${draft.channels[channel]}`;
+    if (field === "/windows")
+        return "quiet:add";
+    if (field.startsWith("/quiet_channel"))
+        return draft.whenWithheld === "quiet_channel"
+            ? "quiet:quiet-channel"
+            : "quiet:withheld:quiet_channel";
+    if (field === "/time_zone")
+        return "quiet:time-zone";
+    return null;
+}
+/** A period ending at or before its start runs past midnight. */
+export function quietOvernight(window) {
+    return TIME.test(window.start) && TIME.test(window.end)
+        ? window.end < window.start
+        : false;
+}
+export function setQuietWindow(draft, index, change) {
+    return {
+        ...draft,
+        windows: draft.windows.map((window, position) => position === index ? { ...window, ...change } : window),
+    };
+}
+export function toggleQuietDay(draft, index, day) {
+    const window = draft.windows[index];
+    if (window === undefined)
+        return draft;
+    const days = window.days.includes(day)
+        ? window.days.filter((candidate) => candidate !== day)
+        : [...window.days, day].sort((a, b) => a - b);
+    return setQuietWindow(draft, index, { days });
+}
+export function addQuietWindow(draft) {
+    if (draft.windows.length >= QUIET_WINDOWS_MAX)
+        return draft;
+    return { ...draft, windows: [...draft.windows, QUIET_SUGGESTED_WINDOW] };
+}
+export function removeQuietWindow(draft, index) {
+    return {
+        ...draft,
+        windows: draft.windows.filter((_, position) => position !== index),
+    };
+}
+/** Day names in the reader's language: short for the toggle, long for its name. */
+export function quietDayName(locale, day, width) {
+    // 1 January 2024 was a Monday.
+    const date = new Date(Date.UTC(2024, 0, day));
+    try {
+        return new Intl.DateTimeFormat(locale, {
+            timeZone: "UTC",
+            weekday: width,
+        }).format(date);
+    }
+    catch {
+        return new Intl.DateTimeFormat("en", {
+            timeZone: "UTC",
+            weekday: width,
+        }).format(date);
+    }
+}
+/**
+ * When quiet hours end, as the person reads a clock in their zone: "07:00",
+ * or with the day when it is more than a day away.
+ */
+export function quietEndsText(locale, endsAt, timeZone, now = new Date()) {
+    const end = new Date(endsAt);
+    const options = {
+        hour: "2-digit",
+        minute: "2-digit",
+        ...(end.getTime() - now.getTime() > 24 * 60 * 60 * 1000
+            ? { weekday: "short" }
+            : {}),
+    };
+    try {
+        return new Intl.DateTimeFormat(locale, { ...options, timeZone }).format(end);
+    }
+    catch {
+        return new Intl.DateTimeFormat(locale, options).format(end);
+    }
+}
+/** Every named zone the browser knows, with the current one always included. */
+export function quietTimeZones(current) {
+    let zones;
+    try {
+        zones = Intl.supportedValuesOf("timeZone");
+    }
+    catch {
+        zones = [];
+    }
+    return [...new Set([...zones, "UTC", current])].sort((a, b) => a.localeCompare(b));
+}
+//# sourceMappingURL=quiet-view.js.map

package/dist/recipient/quiet-view.js.map

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

package/dist/recipient/view.d.ts

@@ -27,6 +27,8 @@ export interface RecipientCategoryView {
     readonly description?: string;
     readonly enabled: boolean;
     readonly canTurnOff: boolean;
+    /** The urgency its messages escalate at, for "Used for" (FXO-3672). */
+    readonly level?: "low" | "normal" | "high" | "critical";
 }
 export interface RecipientView {
     readonly accentColor: string;

package/dist/recipient/view.js.map

@@ -1 +1 @@
-{"version":3,"file":"view.js","sourceRoot":"","sources":["../../src/recipient/view.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"view.js","sourceRoot":"","sources":["../../src/recipient/view.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,oCAAoC,GAIrC,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAoE/E;;;;;;GAMG;AACH,OAAO,EAAE,sBAAsB,EAAE,CAAC;AAElC,MAAM,cAAc,GAAqC;IACvD,KAAK,EAAE,OAAO;IACd,QAAQ,EAAE,UAAU;CACrB,CAAC;AAEF,MAAM,UAAU,YAAY,CAAC,OAAe,EAAE,MAAM,GAAG,IAAI;IACzD,OAAO,CACL,kBAAkB,CAAC,MAAM,CAAC,CAAC,YAAY,CAAC,OAAO,CAAC;QAChD,cAAc,CAAC,OAAO,CAAC;QACvB,OAAO,CACR,CAAC;AACJ,CAAC;AAED;;;;;;;;GAQG;AACH,SAAS,wBAAwB,CAC/B,OAAyB,EACzB,UAAwC;IAExC,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,KAAK,GAAG,OAAO,CAAC,QAAQ,CAAC,IAAI,CACjC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,UAAU,KAAK,UAAU,CAAC,UAAU,CAC1D,CAAC;IACF,IAAI,KAAK,EAAE,KAAK,KAAK,WAAW,EAAE,CAAC;QACjC,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,KAAK,EAAE,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,QAAQ,CAAC;IAClB,CAAC;IACD,6EAA6E;IAC7E,wCAAwC;IACxC,OAAO,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,KAAK,WAAW,CAAC;QACtE,CAAC,CAAC,QAAQ;QACV,CAAC,CAAC,SAAS,CAAC;AAChB,CAAC;AASD;;;;;;;GAOG;AACH,MAAM,UAAU,aAAa,CAAC,KAAyB;IACrD,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC;IAC9B,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO;YACL,WAAW,EAAE,oCAAoC;YACjD,SAAS,EAAE,EAAE;YACb,QAAQ,EAAE,EAAE;YACZ,UAAU,EAAE,EAAE;YACd,WAAW,EAAE,QAAQ;YACrB,SAAS,EAAE,KAAK;YAChB,MAAM,EAAE,IAAI;YACZ,WAAW,EAAE,IAAI;YACjB,OAAO,EAAE,KAAK,CAAC,OAAO,IAAI,IAAI;YAC9B,SAAS,EAAE,EAAE;YACb,oBAAoB,EAAE,CAAC;YACvB,qBAAqB,EAAE,IAAI;YAC3B,KAAK,EAAE,KAAK,CAAC,KAAK;SACnB,CAAC;IACJ,CAAC;IACD,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;IACtC,MAAM,cAAc,GAAG,wBAAwB,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;IACrE,MAAM,cAAc,GAAG,OAAO,CAAC,QAAQ,CAAC,MAAM,CAC5C,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,KAAK,WAAW,CAC3C,CAAC,MAAM,CAAC;IACT,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE;QAChD,MAAM,SAAS,GAAG,OAAO,CAAC,KAAK,KAAK,WAAW,CAAC;QAChD,MAAM,MAAM,GAAG,OAAO,CAAC,KAAK,KAAK,QAAQ,CAAC;QAC1C,OAAO;YACL,SAAS,EAAE,OAAO,CAAC,UAAU,IAAI,IAAI;YACrC,QAAQ,EAAE,SAAS;YACnB,wEAAwE;YACxE,uEAAuE;YACvE,qEAAqE;YACrE,uEAAuE;YACvE,qEAAqE;YACrE,yCAAyC;YACzC,SAAS,EACP,SAAS;gBACT,CAAC,OAAO,CAAC,SAAS;gBAClB,CAAC,cAAc,GAAG,CAAC,IAAI,cAAc,KAAK,QAAQ,CAAC;YACrD,SAAS,EAAE,MAAM;YACjB,cAAc,EAAE,SAAS,IAAI,MAAM;YACnC,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,SAAS;YACT,KAAK,EAAE,YAAY,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC;YACpD,MAAM;YACN,SAAS,EAAE,OAAO,CAAC,SAAS;SAC7B,CAAC;IACJ,CAAC,CAAC,CAAC;IACH,MAAM,KAAK,GACT,OAAO,CAAC,KAAK,KAAK,SAAS;QACzB,CAAC,CAAC,SAAS;QACX,CAAC,CAAC,OAAO,CAAC,KAAK,KAAK,SAAS;YAC3B,CAAC,CAAC,aAAa;YACf,CAAC,CAAC,KAAK,CAAC,KAAK,KAAK,SAAS;gBACzB,CAAC,CAAC,OAAO;gBACT,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC;IACtB,OAAO;QACL,WAAW,EAAE,OAAO,CAAC,KAAK,CAAC,YAAY;QACvC,SAAS,EAAE,OAAO,CAAC,KAAK,CAAC,YAAY;QACrC,QAAQ;QACR,UAAU,EAAE,KAAK,CAAC,UAAU,IAAI,EAAE;QAClC,WAAW,EAAE,OAAO,CAAC,KAAK,CAAC,YAAY;QACvC,SAAS,EAAE,sBAAsB,CAAC,OAAO,CAAC,MAAM,CAAC;QACjD,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,WAAW,EAAE,OAAO,CAAC,KAAK,CAAC,aAAa,IAAI,IAAI;QAChD,OAAO,EAAE,KAAK,CAAC,OAAO,IAAI,IAAI;QAC9B,SAAS,EAAE,OAAO,CAAC,UAAU;QAC7B,oBAAoB,EAAE,UAAU,EAAE,WAAW,IAAI,CAAC;QAClD,qBAAqB,EAAE,cAAc;QACrC,KAAK,EAAE,QAAQ,CAAC,MAAM,KAAK,CAAC,IAAI,KAAK,KAAK,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK;KACpE,CAAC;AACJ,CAAC"}

package/dist/webhooks.d.ts

@@ -1,9 +1,33 @@
 import { verifyWebhookSignature } from "@whooshbang/contracts";
 import type { VerifyWebhookSignatureOptions, WebhookVerificationFailureReason, WhooshBangEventV1ContractDocument } from "@whooshbang/contracts";
+/** A signed event this SDK knows, typed by its `type`. */
 export interface VerifiedWhooshBangEvent {
     readonly attempt: number;
     readonly event: WhooshBangEventV1ContractDocument;
     readonly eventId: string;
+    readonly recognized: true;
+    readonly timestamp: number;
+    readonly verified: true;
+}
+/**
+ * A correctly signed event of a type newer than this SDK. Answer it with a
+ * 2xx: a 4xx stops its delivery and holds the endpoint's backlog behind it.
+ */
+export interface UnrecognizedWhooshBangEvent {
+    readonly created_at: string;
+    readonly data: Readonly<Record<string, unknown>>;
+    readonly environment: string;
+    readonly id: string;
+    readonly organization_id: string;
+    readonly project_id: string;
+    readonly schema: "whooshbang.event.v1";
+    readonly type: string;
+}
+export interface VerifiedUnrecognizedWhooshBangEvent {
+    readonly attempt: number;
+    readonly event: UnrecognizedWhooshBangEvent;
+    readonly eventId: string;
+    readonly recognized: false;
     readonly timestamp: number;
     readonly verified: true;
 }
@@ -11,7 +35,7 @@ export interface RejectedWhooshBangEvent {
     readonly reason: WebhookVerificationFailureReason | "event_contract_mismatch" | "event_id_mismatch";
     readonly verified: false;
 }
-export type WhooshBangEventVerification = RejectedWhooshBangEvent | VerifiedWhooshBangEvent;
+export type WhooshBangEventVerification = RejectedWhooshBangEvent | VerifiedUnrecognizedWhooshBangEvent | VerifiedWhooshBangEvent;
 /**
  * Verifies a signed customer event and returns its typed body.
  *
@@ -23,6 +47,11 @@ export type WhooshBangEventVerification = RejectedWhooshBangEvent | VerifiedWhoo
  * checks pass, so unsigned or stale bytes are never decoded. Supplying both
  * the previous and the current secret verifies through a rotation-overlap
  * window without a gap.
+ *
+ * Newer events stay verifiable, the same way API responses do. A known type
+ * with fields or enum values added after this SDK was built verifies as that
+ * type, with the new values kept. A type this SDK has never seen verifies as
+ * `recognized: false` with only the shared envelope checked; answer it 2xx.
  */
 export declare function verifyWhooshBangEvent(options: VerifyWebhookSignatureOptions): Promise<WhooshBangEventVerification>;
 /** Signature-only verification over the exact raw request bytes. */

package/dist/webhooks.js

@@ -1,4 +1,46 @@
-import { validateWhooshBangEvent, verifyWebhookSignature, } from "@whooshbang/contracts";
+import { validateAgentBindingDegradedEvent, validateEscalationClosedEvent, validateInteractionExpiredEvent, validateInteractionReceivedEvent, validateMessageDeliveredEvent, validateMessageExpiredEvent, validateMessageFailedEvent, validateMessageProviderAcceptedEvent, validateSubscriptionActivatedEvent, validateSubscriptionAssertedEvent, validateSubscriptionAssertedRevokedEvent, validateSubscriptionRevokedEvent, verifyWebhookSignature, } from "@whooshbang/contracts";
+import { validateAdditiveCompatible } from "./additive-compatibility.js";
+/**
+ * Each event type this SDK version knows, with its own validator. The `Record`
+ * makes the compiler refuse a contract update that adds a type without one.
+ */
+const EVENT_VALIDATORS = {
+    "agent_binding.degraded": validateAgentBindingDegradedEvent,
+    "escalation.closed": validateEscalationClosedEvent,
+    "interaction.expired": validateInteractionExpiredEvent,
+    "interaction.received": validateInteractionReceivedEvent,
+    "message.delivered": validateMessageDeliveredEvent,
+    "message.expired": validateMessageExpiredEvent,
+    "message.failed": validateMessageFailedEvent,
+    "message.provider_accepted": validateMessageProviderAcceptedEvent,
+    "subscription.activated": validateSubscriptionActivatedEvent,
+    "subscription.asserted": validateSubscriptionAssertedEvent,
+    "subscription.asserted_revoked": validateSubscriptionAssertedRevokedEvent,
+    "subscription.revoked": validateSubscriptionRevokedEvent,
+};
+function isKnownEventType(type) {
+    return typeof type === "string" && Object.hasOwn(EVENT_VALIDATORS, type);
+}
+function isNonEmptyString(value) {
+    return typeof value === "string" && value.length > 0;
+}
+/** The version-1 envelope every event shares, whatever its type. */
+function isEventEnvelope(value) {
+    if (typeof value !== "object" || value === null || Array.isArray(value)) {
+        return false;
+    }
+    const event = value;
+    return (event.schema === "whooshbang.event.v1" &&
+        isNonEmptyString(event.id) &&
+        isNonEmptyString(event.type) &&
+        isNonEmptyString(event.created_at) &&
+        isNonEmptyString(event.organization_id) &&
+        isNonEmptyString(event.project_id) &&
+        isNonEmptyString(event.environment) &&
+        typeof event.data === "object" &&
+        event.data !== null &&
+        !Array.isArray(event.data));
+}
 /**
  * Verifies a signed customer event and returns its typed body.
  *
@@ -10,6 +52,11 @@ import { validateWhooshBangEvent, verifyWebhookSignature, } from "@whooshbang/co
  * checks pass, so unsigned or stale bytes are never decoded. Supplying both
  * the previous and the current secret verifies through a rotation-overlap
  * window without a gap.
+ *
+ * Newer events stay verifiable, the same way API responses do. A known type
+ * with fields or enum values added after this SDK was built verifies as that
+ * type, with the new values kept. A type this SDK has never seen verifies as
+ * `recognized: false` with only the shared envelope checked; answer it 2xx.
  */
 export async function verifyWhooshBangEvent(options) {
     const verification = await verifyWebhookSignature(options);
@@ -23,7 +70,7 @@ export async function verifyWhooshBangEvent(options) {
     catch {
         return { reason: "event_contract_mismatch", verified: false };
     }
-    if (!validateWhooshBangEvent(parsed)) {
+    if (!isEventEnvelope(parsed)) {
         return { reason: "event_contract_mismatch", verified: false };
     }
     // The signed `webhook-id` and the body's own identifier must agree, or a
@@ -32,13 +79,19 @@ export async function verifyWhooshBangEvent(options) {
     if (parsed.id !== verification.eventId) {
         return { reason: "event_id_mismatch", verified: false };
     }
-    return {
+    const delivery = {
         attempt: verification.attempt,
-        event: parsed,
         eventId: verification.eventId,
         timestamp: verification.timestamp,
         verified: true,
     };
+    if (!isKnownEventType(parsed.type)) {
+        return { ...delivery, event: parsed, recognized: false };
+    }
+    if (!validateAdditiveCompatible(parsed, EVENT_VALIDATORS[parsed.type])) {
+        return { reason: "event_contract_mismatch", verified: false };
+    }
+    return { ...delivery, event: parsed, recognized: true };
 }
 /** Signature-only verification over the exact raw request bytes. */
 export async function verifyWhooshBangWebhook(options) {

package/dist/webhooks.js.map

@@ -1 +1 @@
-{"version":3,"file":"webhooks.js","sourceRoot":"","sources":["../src/webhooks.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,uBAAuB,EACvB,sBAAsB,GACvB,MAAM,uBAAuB,CAAC;AA2B/B;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,OAAsC;IAEtC,MAAM,YAAY,GAAG,MAAM,sBAAsB,CAAC,OAAO,CAAC,CAAC;IAC3D,IAAI,CAAC,YAAY,CAAC,QAAQ,EAAE,CAAC;QAC3B,OAAO,EAAE,MAAM,EAAE,YAAY,CAAC,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;IAC1D,CAAC;IACD,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CACjB,IAAI,WAAW,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAClE,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,MAAM,EAAE,yBAAyB,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;IAChE,CAAC;IACD,IAAI,CAAC,uBAAuB,CAAC,MAAM,CAAC,EAAE,CAAC;QACrC,OAAO,EAAE,MAAM,EAAE,yBAAyB,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;IAChE,CAAC;IACD,yEAAyE;IACzE,2EAA2E;IAC3E,SAAS;IACT,IAAI,MAAM,CAAC,EAAE,KAAK,YAAY,CAAC,OAAO,EAAE,CAAC;QACvC,OAAO,EAAE,MAAM,EAAE,mBAAmB,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;IAC1D,CAAC;IACD,OAAO;QACL,OAAO,EAAE,YAAY,CAAC,OAAO;QAC7B,KAAK,EAAE,MAAM;QACb,OAAO,EAAE,YAAY,CAAC,OAAO;QAC7B,SAAS,EAAE,YAAY,CAAC,SAAS;QACjC,QAAQ,EAAE,IAAI;KACf,CAAC;AACJ,CAAC;AAED,oEAAoE;AACpE,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,OAAsC;IAEtC,OAAO,sBAAsB,CAAC,OAAO,CAAC,CAAC;AACzC,CAAC"}
+{"version":3,"file":"webhooks.js","sourceRoot":"","sources":["../src/webhooks.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@whooshbang/sdk",
-  "version": "5.0.0",
+  "version": "6.0.0",
   "description": "JavaScript client and browser recipient settings UI for WhooshBang V1",
   "private": false,
   "license": "MIT",
@@ -52,6 +52,16 @@
       "import": "./dist/recipient/i18n/catalog.js",
       "default": "./dist/recipient/i18n/catalog.js"
     },
+    "./recipient/order": {
+      "types": "./dist/recipient/order-view.d.ts",
+      "import": "./dist/recipient/order-view.js",
+      "default": "./dist/recipient/order-view.js"
+    },
+    "./recipient/quiet": {
+      "types": "./dist/recipient/quiet-view.d.ts",
+      "import": "./dist/recipient/quiet-view.js",
+      "default": "./dist/recipient/quiet-view.js"
+    },
     "./package.json": "./package.json"
   },
   "bin": {
@@ -64,7 +74,7 @@
     "type-check": "tsc --noEmit -p tsconfig.json"
   },
   "dependencies": {
-    "@whooshbang/contracts": "4.0.0"
+    "@whooshbang/contracts": "5.0.0"
   },
   "engines": {
     "node": ">=22.13.0"