@wildo-ai/saas-models 1.1.4 → 1.1.6

package/dist/esm/notifications/notifications.shared.schemas.d.ts

@@ -1,9 +1,17 @@
 import { z } from "zod";
 import { ResourcePrimaryScope } from "../resources/resources.shared.schemas";
+/**
+ * The channels the dispatcher delivers a user notification through.
+ *
+ * `SMS` and `PUSH` were members until #1799 and neither delivered: the dispatcher logged "not yet
+ * implemented" and returned, no notification in the engine or its applications declared either, and a
+ * notification definition had no text to send. They are removed rather than kept as channels an author
+ * could declare and never have sent. An SMS channel is buildable on the existing SMS provider — it
+ * needs a per-notification text contract and the verified phone — and returns when it is built; push
+ * has no infrastructure at all.
+ */
 export declare enum CoreUserNotificationChannel {
     EMAIL = "email",
-    SMS = "sms",
-    PUSH = "push",
     WEBSOCKET = "websocket",
     FRONT_END_SUCCESS = "front_end_success"
 }
@@ -13,7 +21,8 @@ export declare enum UserNotificationLevel {
     WARNING = "warning",
     ERROR = "error"
 }
-export declare const UserNotificationChannelSchema: z.ZodUnion<readonly [z.ZodEnum<typeof CoreUserNotificationChannel>, z.ZodString]>;
+/** A user notification channel: exactly the channels the dispatcher delivers (#1874). */
+export declare const UserNotificationChannelSchema: z.ZodEnum<typeof CoreUserNotificationChannel>;
 /** @wildo_source:part:start saas.models.notifications.targets facet:layer:shared facet:audience:app-developer */
 /**
  * WHO a declared `userNotifications` entry reaches — and, on the EMAIL channel, whether the tenant
@@ -28,25 +37,28 @@ export declare const UserNotificationChannelSchema: z.ZodUnion<readonly [z.ZodEn
  *    other target reaches somebody because of a ROLE they hold, and a personal switch must not
  *    silently disable a tenant's administrative monitoring. See
  *    {@link userNotificationTargetIsSuppressibleByRecipientPreference};
- * 3. **whether `userRoles` is read at all** — see {@link userNotificationTargetReadsUserRoles}. On the
- *    two tenant-wide targets the field is REFUSED rather than ignored, because "everyone in the
- *    tenant" is not a set a role list may narrow.
+ * 3. **whether `userRoles` is read at all** — see {@link userNotificationTargetReadsUserRoles}. Where it
+ *    is not read it is REFUSED rather than ignored — on the two tenant-wide targets because "everyone
+ *    in the tenant" is not a set a role list may narrow, and everywhere else because a filter that
+ *    does nothing misleads whoever reads the declaration.
  *
  * ## Who each target resolves to
  *
  * | target | recipients |
  * |---|---|
  * | `USER_SELF` | the initiator of the operation |
- * | `USERS_CUSTOM` | whatever your `userIdsSelector` returns. Without that function the target resolves nobody |
+ * | `USERS_CUSTOM` | whatever your `userIdsSelector` returns. The function is required |
  * | `ORGANIZATION`, `ORGANIZATION_USERS` | every member of the initiator's tenant. `userRoles` is refused here |
  * | `ORGANIZATION_BILLING`, `ORGANIZATION_SECURITY`, `ORGANIZATION_USER_MANAGEMENT`, `ORGANIZATION_ADMINISTRATIVE` | members of the tenant holding `ORG_OWNER` or `ORG_ADMIN`, unless `userRoles` names a different set |
  * | `APPLICATION_BILLING` | holders of `APP_ADMIN_BILLING_MANAGER` or `APP_ADMIN_SUPER_ADMIN`, application-wide |
  * | `APPLICATION_ADMIN_VIEWER` | holders of `APP_ADMIN_VIEWER` or `APP_ADMIN_SUPER_ADMIN` |
  * | every other `APPLICATION_*` | holders of `APP_ADMIN_SUPER_ADMIN` |
- * | `INBOUND_CONTACT` | nobody, deliberately. The recipient is not a user of your application, so this target is only usable with an EMAIL notification declaring `recipientEmailField` |
+ * | `INBOUND_CONTACT` | on EMAIL, the contact themselves, through `recipientEmailField` (required: the contact is not a user of your application, so no target resolves them). On WEBSOCKET and FRONT_END_SUCCESS, an in-app alert to holders of `APP_ADMIN_SUPER_ADMIN`, unless `userRoles` names a different set |
  *
- * A target the dispatcher has no rule for resolves nobody and logs a warning — so a custom target
- * string (the schema accepts one) sends nothing on the email and websocket paths.
+ * The target must be one of these members, and a declaration that would reach nobody — `USERS_CUSTOM`
+ * without a `userIdsSelector`, `INBOUND_CONTACT` on EMAIL without `recipientEmailField` — is refused
+ * when the resource configuration is built, as is a `userRoles` or `userIdsSelector` the target never
+ * reads.
  *
  * ## The tenant can redirect or silence an ORGANIZATION-flavoured EMAIL, and you cannot override it
  *
@@ -59,8 +71,9 @@ export declare const UserNotificationChannelSchema: z.ZodUnion<readonly [z.ZodEn
  * - **the category switch suppresses the notification entirely**, whether or not an address is
  *   configured. A tenant that turns billing notifications off means it for the members too.
  *
- * `ORGANIZATION` and `ORGANIZATION_USERS` are tenant-wide and belong to no category, so no switch can
- * silence them; a tenant-wide default address still redirects them.
+ * `ORGANIZATION` belongs to no category, so no category switch silences it; the tenant-wide
+ * `defaultEmailAddress` can redirect it. `ORGANIZATION_USERS` always keeps its member fan-out:
+ * neither a category switch nor the tenant-wide default address redirects or suppresses that target.
  *
  * This applies to EMAIL only. The websocket and in-product paths always fan out to the members.
  */
@@ -84,7 +97,7 @@ export declare enum CoreUserNotificationTarget {
 }
 /**
  * Whether a notification aimed at this target may be SUPPRESSED by the recipient's own channel
- * preference (`UserPreferences.notifications.email` / `.sms` / `.push` / `.inApp`).
+ * preference (`UserPreferences.notifications.email` / `.inApp`).
  *
  * DERIVED from the target rather than declared per notification, because the target already carries
  * the distinction and a second field would be one more thing to get wrong on 87 declarations.
@@ -109,9 +122,11 @@ export declare function userNotificationTargetIsSuppressibleByRecipientPreferenc
  * The targets on which `userRoles` MEANS anything (#495).
  *
  * `userRoles` is not a recipient FILTER, which is how its name reads and how it has been authored. It
- * is the role-SELECTION override for the eleven role-scoped targets: `mapOrganizationTargetToRoles`
- * and `mapApplicationTargetToRoles` take it in place of their per-target default, and nothing else
- * anywhere reads it.
+ * is the role-SELECTION override for the eleven role-scoped targets — `mapOrganizationTargetToRoles`
+ * and `mapApplicationTargetToRoles` take it in place of their per-target default — and for
+ * `INBOUND_CONTACT` on the in-app channels, where it names the application roles alerted about a new
+ * contact in place of the default `APP_ADMIN_SUPER_ADMIN`. On EMAIL that target reaches the contact
+ * through `recipientEmailField` and reads no role, hence the `channel` parameter.
  *
  * On every other target it is inert, and inert in three different ways that all looked the same to an
  * author: `USER_SELF` addresses the initiator, `USERS_CUSTOM` goes straight to `userIdsSelector`, and
@@ -122,20 +137,36 @@ export declare function userNotificationTargetIsSuppressibleByRecipientPreferenc
  * defect was never specific to `USERS_CUSTOM` — refusing it there alone would leave the other three
  * free to mislead the next author in exactly the same way.
  */
-export declare function userNotificationTargetReadsUserRoles(target: string): boolean;
+export declare function userNotificationTargetReadsUserRoles(target: string, channel: string): boolean;
 /** @wildo_source:part:end saas.models.notifications.targets */
-export declare const UserNotificationTargetSchema: z.ZodUnion<readonly [z.ZodEnum<typeof CoreUserNotificationTarget>, z.ZodString]>;
 /**
- * How the frontend renders a celebration after a successful operation.
- * - OVERLAY: Full-screen overlay with animation (e.g., confetti + message)
- * - CONFETTI: Lightweight confetti burst (no overlay)
- * - LOTTIE: Custom Lottie animation (resolved by notification identifier)
+ * A user notification target: exactly the members of {@link CoreUserNotificationTarget}.
+ *
+ * This accepted any string beside the enum, and a string the dispatcher had no rule for resolved nobody — a
+ * notification that type-checked, built, and reached no one. Every member has an arm in the dispatcher, so the
+ * vocabulary IS the set of targets that can be delivered, and a declaration naming anything else is refused when
+ * the resource configuration is built.
+ */
+export declare const UserNotificationTargetSchema: z.ZodEnum<typeof CoreUserNotificationTarget>;
+/** @wildo_source:part:start saas.models.milestone-celebration */
+/**
+ * How the frontend renders a celebration after a successful operation — the value a milestone's
+ * `celebrationMode` takes. Import from `@wildo-ai/saas-models`.
+ * - CONFETTI: a lightweight, non-blocking confetti burst over the page. Decorative only: no message,
+ *   no next step, nothing to dismiss.
+ * - OVERLAY: a dialog carrying the celebration animation, the milestone's title, the message, an
+ *   optional next-step action and a dismiss.
+ * - LOTTIE: in the framework's DEFAULT celebration overlay, identical to OVERLAY — the same dialog
+ *   and the same animation. It is the mode to use when the application's OWN celebration-overlay
+ *   preset draws something distinct for it, such as a per-milestone animation chosen from the
+ *   notification identifier the preset receives.
  */
 export declare enum CelebrationDisplayMode {
     OVERLAY = "overlay",
     CONFETTI = "confetti",
     LOTTIE = "lottie"
 }
+/** @wildo_source:part:end saas.models.milestone-celebration */
 /**
  * Type of next-step suggestion attached to a notification.
  * - OPERATION: Navigate to and/or trigger a resource operation
@@ -180,10 +211,10 @@ export type FrontendDisplayHints = z.infer<typeof FrontendDisplayHintsSchema>;
  *
  * ## What actually sends
  *
- * `EMAIL`, `WEBSOCKET` and `FRONT_END_SUCCESS` deliver. **`SMS` and `PUSH` are declaration vocabulary
- * only** — the dispatcher's branch for them logs and returns without sending. The framework does have
- * an SMS transport (authentication's one-time codes use it) and this dispatcher is not wired to it,
- * so declaring an SMS notification is inert rather than pending.
+ * `EMAIL`, `WEBSOCKET` and `FRONT_END_SUCCESS` are the channels, and all three deliver. There is no
+ * SMS or push notification channel: both were declaration vocabulary that the dispatcher logged and
+ * dropped, and were removed. The framework's SMS transport serves authentication's one-time codes, not
+ * resource notifications.
  *
  * For an EMAIL, create the template directory the reference names. The startup validator resolves
  * every declared reference through the configured locale chain before the application takes traffic,
@@ -199,8 +230,10 @@ export type FrontendDisplayHints = z.infer<typeof FrontendDisplayHintsSchema>;
  *  - a recipient with NO preferences row at all, because preferences are created lazily and a missing
  *    record must never read as "everything off".
  *
- * The `inApp` switch governs the notification CENTRE on the frontend rather than the socket frame —
- * suppressing the frame would also suppress the live UI updates that ride the same channel.
+ * The `inApp` switch suppresses optional personal message presentation (toast, centre and celebration),
+ * not the socket frame. Declarative frames carry target and alwaysDeliver to the frontend gate;
+ * required and responsibility-addressed messages remain visible. Local operation feedback and
+ * resource refresh events are independent of this personal-message preference.
  *
  * ## `condition` gates the notification, not the operation
  *
@@ -221,7 +254,7 @@ export type FrontendDisplayHints = z.infer<typeof FrontendDisplayHintsSchema>;
  */
 export declare const UserNotificationDefinition_BaseSchema: z.ZodObject<{
     identifier: z.ZodString;
-    target: z.ZodString;
+    target: z.ZodEnum<typeof CoreUserNotificationTarget>;
     level: z.ZodOptional<z.ZodEnum<typeof UserNotificationLevel>>;
     primaryScope: z.ZodEnum<typeof ResourcePrimaryScope>;
     userRoles: z.ZodOptional<z.ZodArray<z.ZodString>>;
@@ -281,7 +314,7 @@ export declare const UserNotificationDefinition_BaseSchema: z.ZodObject<{
 /** EMAIL channel — template-oriented (email-specific fields handled by email templates) */
 export declare const UserNotificationDefinition_EmailSchema: z.ZodObject<{
     identifier: z.ZodString;
-    target: z.ZodString;
+    target: z.ZodEnum<typeof CoreUserNotificationTarget>;
     level: z.ZodOptional<z.ZodEnum<typeof UserNotificationLevel>>;
     primaryScope: z.ZodEnum<typeof ResourcePrimaryScope>;
     userRoles: z.ZodOptional<z.ZodArray<z.ZodString>>;
@@ -343,7 +376,7 @@ export declare const UserNotificationDefinition_EmailSchema: z.ZodObject<{
 /** WEBSOCKET channel — pure WebSocket push (no frontend display) */
 export declare const UserNotificationDefinition_WebSocketSchema: z.ZodObject<{
     identifier: z.ZodString;
-    target: z.ZodString;
+    target: z.ZodEnum<typeof CoreUserNotificationTarget>;
     level: z.ZodOptional<z.ZodEnum<typeof UserNotificationLevel>>;
     primaryScope: z.ZodEnum<typeof ResourcePrimaryScope>;
     userRoles: z.ZodOptional<z.ZodArray<z.ZodString>>;
@@ -421,7 +454,7 @@ export declare const UserNotificationDefinition_WebSocketSchema: z.ZodObject<{
  */
 export declare const UserNotificationDefinition_FrontEndSuccessSchema: z.ZodObject<{
     identifier: z.ZodString;
-    target: z.ZodString;
+    target: z.ZodEnum<typeof CoreUserNotificationTarget>;
     level: z.ZodOptional<z.ZodEnum<typeof UserNotificationLevel>>;
     primaryScope: z.ZodEnum<typeof ResourcePrimaryScope>;
     userRoles: z.ZodOptional<z.ZodArray<z.ZodString>>;
@@ -486,198 +519,19 @@ export declare const UserNotificationDefinition_FrontEndSuccessSchema: z.ZodObje
         type: z.ZodDefault<z.ZodEnum<typeof NotificationNextStepType>>;
     }, z.core.$strip>>;
 }, z.core.$strip>;
-/** SMS channel — not yet implemented, plain base */
-export declare const UserNotificationDefinition_SMSSchema: z.ZodObject<{
-    identifier: z.ZodString;
-    target: z.ZodString;
-    level: z.ZodOptional<z.ZodEnum<typeof UserNotificationLevel>>;
-    primaryScope: z.ZodEnum<typeof ResourcePrimaryScope>;
-    userRoles: z.ZodOptional<z.ZodArray<z.ZodString>>;
-    userIdsSelector: z.ZodOptional<z.ZodCustom<(params: {
-        currentObject: any;
-        inputDto: any;
-        objectContext: {
-            parents: Record<string, any>;
-            children: Record<string, any>;
-        };
-        initiatorIds: {
-            userId?: string;
-            organizationId?: string;
-            applicationId?: string;
-        };
-    }) => string[], (params: {
-        currentObject: any;
-        inputDto: any;
-        objectContext: {
-            parents: Record<string, any>;
-            children: Record<string, any>;
-        };
-        initiatorIds: {
-            userId?: string;
-            organizationId?: string;
-            applicationId?: string;
-        };
-    }) => string[]>>;
-    condition: z.ZodOptional<z.ZodCustom<(params: {
-        currentObject: any;
-        inputDto: any;
-        objectContext: {
-            parents: Record<string, any>;
-            children: Record<string, any>;
-        };
-        initiatorIds: {
-            userId?: string;
-            organizationId?: string;
-            applicationId?: string;
-        };
-    }) => boolean, (params: {
-        currentObject: any;
-        inputDto: any;
-        objectContext: {
-            parents: Record<string, any>;
-            children: Record<string, any>;
-        };
-        initiatorIds: {
-            userId?: string;
-            organizationId?: string;
-            applicationId?: string;
-        };
-    }) => boolean>>;
-    customNotificationRef: z.ZodOptional<z.ZodString>;
-    alwaysDeliver: z.ZodOptional<z.ZodBoolean>;
-    channel: z.ZodLiteral<CoreUserNotificationChannel.SMS>;
-}, z.core.$strip>;
-/** PUSH channel — not yet implemented, plain base */
-export declare const UserNotificationDefinition_PushSchema: z.ZodObject<{
-    identifier: z.ZodString;
-    target: z.ZodString;
-    level: z.ZodOptional<z.ZodEnum<typeof UserNotificationLevel>>;
-    primaryScope: z.ZodEnum<typeof ResourcePrimaryScope>;
-    userRoles: z.ZodOptional<z.ZodArray<z.ZodString>>;
-    userIdsSelector: z.ZodOptional<z.ZodCustom<(params: {
-        currentObject: any;
-        inputDto: any;
-        objectContext: {
-            parents: Record<string, any>;
-            children: Record<string, any>;
-        };
-        initiatorIds: {
-            userId?: string;
-            organizationId?: string;
-            applicationId?: string;
-        };
-    }) => string[], (params: {
-        currentObject: any;
-        inputDto: any;
-        objectContext: {
-            parents: Record<string, any>;
-            children: Record<string, any>;
-        };
-        initiatorIds: {
-            userId?: string;
-            organizationId?: string;
-            applicationId?: string;
-        };
-    }) => string[]>>;
-    condition: z.ZodOptional<z.ZodCustom<(params: {
-        currentObject: any;
-        inputDto: any;
-        objectContext: {
-            parents: Record<string, any>;
-            children: Record<string, any>;
-        };
-        initiatorIds: {
-            userId?: string;
-            organizationId?: string;
-            applicationId?: string;
-        };
-    }) => boolean, (params: {
-        currentObject: any;
-        inputDto: any;
-        objectContext: {
-            parents: Record<string, any>;
-            children: Record<string, any>;
-        };
-        initiatorIds: {
-            userId?: string;
-            organizationId?: string;
-            applicationId?: string;
-        };
-    }) => boolean>>;
-    customNotificationRef: z.ZodOptional<z.ZodString>;
-    alwaysDeliver: z.ZodOptional<z.ZodBoolean>;
-    channel: z.ZodLiteral<CoreUserNotificationChannel.PUSH>;
-}, z.core.$strip>;
-/** Catch-all for custom channels (any string not matching core channels) */
-export declare const UserNotificationDefinition_CustomChannelSchema: z.ZodObject<{
-    identifier: z.ZodString;
-    target: z.ZodString;
-    level: z.ZodOptional<z.ZodEnum<typeof UserNotificationLevel>>;
-    primaryScope: z.ZodEnum<typeof ResourcePrimaryScope>;
-    userRoles: z.ZodOptional<z.ZodArray<z.ZodString>>;
-    userIdsSelector: z.ZodOptional<z.ZodCustom<(params: {
-        currentObject: any;
-        inputDto: any;
-        objectContext: {
-            parents: Record<string, any>;
-            children: Record<string, any>;
-        };
-        initiatorIds: {
-            userId?: string;
-            organizationId?: string;
-            applicationId?: string;
-        };
-    }) => string[], (params: {
-        currentObject: any;
-        inputDto: any;
-        objectContext: {
-            parents: Record<string, any>;
-            children: Record<string, any>;
-        };
-        initiatorIds: {
-            userId?: string;
-            organizationId?: string;
-            applicationId?: string;
-        };
-    }) => string[]>>;
-    condition: z.ZodOptional<z.ZodCustom<(params: {
-        currentObject: any;
-        inputDto: any;
-        objectContext: {
-            parents: Record<string, any>;
-            children: Record<string, any>;
-        };
-        initiatorIds: {
-            userId?: string;
-            organizationId?: string;
-            applicationId?: string;
-        };
-    }) => boolean, (params: {
-        currentObject: any;
-        inputDto: any;
-        objectContext: {
-            parents: Record<string, any>;
-            children: Record<string, any>;
-        };
-        initiatorIds: {
-            userId?: string;
-            organizationId?: string;
-            applicationId?: string;
-        };
-    }) => boolean>>;
-    customNotificationRef: z.ZodOptional<z.ZodString>;
-    alwaysDeliver: z.ZodOptional<z.ZodBoolean>;
-    channel: z.ZodString;
-}, z.core.$strip>;
 /**
- * Final union of all notification channel variants.
- * Uses z.union() (not z.discriminatedUnion) because the catch-all custom channel
- * uses z.string() which is not a literal discriminant.
- * Order matters: specific literals are tried before the catch-all string.
+ * Final union of all notification channel variants — exactly the channels the dispatcher delivers (#1874).
+ *
+ * There used to be a fourth member, a catch-all `channel: z.string()` "for custom channels". Nothing delivered a
+ * custom channel: the dispatcher's `default` arm logged at debug and sent nothing, so `channel: 'slack'` passed
+ * validation and every dispatch was silently empty — the class #1799 removed for SMS and push. A channel is now one
+ * of `CoreUserNotificationChannel`, and the resource factory parses every declared notification against this schema
+ * (`processUserNotifications`), so an unknown one is refused when the configuration is built. A new channel is
+ * added by giving it a member here AND a delivery arm in the dispatcher, never by naming it.
  */
 export declare const UserNotificationDefinitionSchema: z.ZodUnion<readonly [z.ZodObject<{
     identifier: z.ZodString;
-    target: z.ZodString;
+    target: z.ZodEnum<typeof CoreUserNotificationTarget>;
     level: z.ZodOptional<z.ZodEnum<typeof UserNotificationLevel>>;
     primaryScope: z.ZodEnum<typeof ResourcePrimaryScope>;
     userRoles: z.ZodOptional<z.ZodArray<z.ZodString>>;
@@ -737,7 +591,7 @@ export declare const UserNotificationDefinitionSchema: z.ZodUnion<readonly [z.Zo
     recipientEmailField: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>, z.ZodObject<{
     identifier: z.ZodString;
-    target: z.ZodString;
+    target: z.ZodEnum<typeof CoreUserNotificationTarget>;
     level: z.ZodOptional<z.ZodEnum<typeof UserNotificationLevel>>;
     primaryScope: z.ZodEnum<typeof ResourcePrimaryScope>;
     userRoles: z.ZodOptional<z.ZodArray<z.ZodString>>;
@@ -796,7 +650,7 @@ export declare const UserNotificationDefinitionSchema: z.ZodUnion<readonly [z.Zo
     channel: z.ZodLiteral<CoreUserNotificationChannel.WEBSOCKET>;
 }, z.core.$strip>, z.ZodObject<{
     identifier: z.ZodString;
-    target: z.ZodString;
+    target: z.ZodEnum<typeof CoreUserNotificationTarget>;
     level: z.ZodOptional<z.ZodEnum<typeof UserNotificationLevel>>;
     primaryScope: z.ZodEnum<typeof ResourcePrimaryScope>;
     userRoles: z.ZodOptional<z.ZodArray<z.ZodString>>;
@@ -860,183 +714,6 @@ export declare const UserNotificationDefinitionSchema: z.ZodUnion<readonly [z.Zo
         operationRef: z.ZodString;
         type: z.ZodDefault<z.ZodEnum<typeof NotificationNextStepType>>;
     }, z.core.$strip>>;
-}, z.core.$strip>, z.ZodObject<{
-    identifier: z.ZodString;
-    target: z.ZodString;
-    level: z.ZodOptional<z.ZodEnum<typeof UserNotificationLevel>>;
-    primaryScope: z.ZodEnum<typeof ResourcePrimaryScope>;
-    userRoles: z.ZodOptional<z.ZodArray<z.ZodString>>;
-    userIdsSelector: z.ZodOptional<z.ZodCustom<(params: {
-        currentObject: any;
-        inputDto: any;
-        objectContext: {
-            parents: Record<string, any>;
-            children: Record<string, any>;
-        };
-        initiatorIds: {
-            userId?: string;
-            organizationId?: string;
-            applicationId?: string;
-        };
-    }) => string[], (params: {
-        currentObject: any;
-        inputDto: any;
-        objectContext: {
-            parents: Record<string, any>;
-            children: Record<string, any>;
-        };
-        initiatorIds: {
-            userId?: string;
-            organizationId?: string;
-            applicationId?: string;
-        };
-    }) => string[]>>;
-    condition: z.ZodOptional<z.ZodCustom<(params: {
-        currentObject: any;
-        inputDto: any;
-        objectContext: {
-            parents: Record<string, any>;
-            children: Record<string, any>;
-        };
-        initiatorIds: {
-            userId?: string;
-            organizationId?: string;
-            applicationId?: string;
-        };
-    }) => boolean, (params: {
-        currentObject: any;
-        inputDto: any;
-        objectContext: {
-            parents: Record<string, any>;
-            children: Record<string, any>;
-        };
-        initiatorIds: {
-            userId?: string;
-            organizationId?: string;
-            applicationId?: string;
-        };
-    }) => boolean>>;
-    customNotificationRef: z.ZodOptional<z.ZodString>;
-    alwaysDeliver: z.ZodOptional<z.ZodBoolean>;
-    channel: z.ZodLiteral<CoreUserNotificationChannel.SMS>;
-}, z.core.$strip>, z.ZodObject<{
-    identifier: z.ZodString;
-    target: z.ZodString;
-    level: z.ZodOptional<z.ZodEnum<typeof UserNotificationLevel>>;
-    primaryScope: z.ZodEnum<typeof ResourcePrimaryScope>;
-    userRoles: z.ZodOptional<z.ZodArray<z.ZodString>>;
-    userIdsSelector: z.ZodOptional<z.ZodCustom<(params: {
-        currentObject: any;
-        inputDto: any;
-        objectContext: {
-            parents: Record<string, any>;
-            children: Record<string, any>;
-        };
-        initiatorIds: {
-            userId?: string;
-            organizationId?: string;
-            applicationId?: string;
-        };
-    }) => string[], (params: {
-        currentObject: any;
-        inputDto: any;
-        objectContext: {
-            parents: Record<string, any>;
-            children: Record<string, any>;
-        };
-        initiatorIds: {
-            userId?: string;
-            organizationId?: string;
-            applicationId?: string;
-        };
-    }) => string[]>>;
-    condition: z.ZodOptional<z.ZodCustom<(params: {
-        currentObject: any;
-        inputDto: any;
-        objectContext: {
-            parents: Record<string, any>;
-            children: Record<string, any>;
-        };
-        initiatorIds: {
-            userId?: string;
-            organizationId?: string;
-            applicationId?: string;
-        };
-    }) => boolean, (params: {
-        currentObject: any;
-        inputDto: any;
-        objectContext: {
-            parents: Record<string, any>;
-            children: Record<string, any>;
-        };
-        initiatorIds: {
-            userId?: string;
-            organizationId?: string;
-            applicationId?: string;
-        };
-    }) => boolean>>;
-    customNotificationRef: z.ZodOptional<z.ZodString>;
-    alwaysDeliver: z.ZodOptional<z.ZodBoolean>;
-    channel: z.ZodLiteral<CoreUserNotificationChannel.PUSH>;
-}, z.core.$strip>, z.ZodObject<{
-    identifier: z.ZodString;
-    target: z.ZodString;
-    level: z.ZodOptional<z.ZodEnum<typeof UserNotificationLevel>>;
-    primaryScope: z.ZodEnum<typeof ResourcePrimaryScope>;
-    userRoles: z.ZodOptional<z.ZodArray<z.ZodString>>;
-    userIdsSelector: z.ZodOptional<z.ZodCustom<(params: {
-        currentObject: any;
-        inputDto: any;
-        objectContext: {
-            parents: Record<string, any>;
-            children: Record<string, any>;
-        };
-        initiatorIds: {
-            userId?: string;
-            organizationId?: string;
-            applicationId?: string;
-        };
-    }) => string[], (params: {
-        currentObject: any;
-        inputDto: any;
-        objectContext: {
-            parents: Record<string, any>;
-            children: Record<string, any>;
-        };
-        initiatorIds: {
-            userId?: string;
-            organizationId?: string;
-            applicationId?: string;
-        };
-    }) => string[]>>;
-    condition: z.ZodOptional<z.ZodCustom<(params: {
-        currentObject: any;
-        inputDto: any;
-        objectContext: {
-            parents: Record<string, any>;
-            children: Record<string, any>;
-        };
-        initiatorIds: {
-            userId?: string;
-            organizationId?: string;
-            applicationId?: string;
-        };
-    }) => boolean, (params: {
-        currentObject: any;
-        inputDto: any;
-        objectContext: {
-            parents: Record<string, any>;
-            children: Record<string, any>;
-        };
-        initiatorIds: {
-            userId?: string;
-            organizationId?: string;
-            applicationId?: string;
-        };
-    }) => boolean>>;
-    customNotificationRef: z.ZodOptional<z.ZodString>;
-    alwaysDeliver: z.ZodOptional<z.ZodBoolean>;
-    channel: z.ZodString;
 }, z.core.$strip>]>;
 export type UserNotificationDefinition = z.infer<typeof UserNotificationDefinitionSchema>;
 /** @wildo_source:part:end saas.models.notifications.user-notification-definition */
@@ -1052,17 +729,18 @@ export declare enum CoreM2MNotificationChannel {
     WEBHOOK_ORGANIZATION = "webhook_organization",
     WEBHOOK_APPLICATION = "webhook_application"
 }
-export declare const M2MNotificationChannelSchema: z.ZodUnion<readonly [z.ZodEnum<typeof CoreM2MNotificationChannel>, z.ZodString]>;
+/**
+ * An M2M notification channel: exactly the two webhook channels the dispatcher delivers.
+ *
+ * This accepted any string, and the dispatcher threw "not implemented" for anything but the two webhooks — at
+ * dispatch, after the write, where the throw also skipped every later M2M notification of the same operation. The
+ * resource factory now refuses any other channel when the configuration is built.
+ */
+export declare const M2MNotificationChannelSchema: z.ZodEnum<typeof CoreM2MNotificationChannel>;
 export declare const M2MNotificationDefinitionSchema: z.ZodObject<{
     identifier: z.ZodString;
-    channel: z.ZodString;
+    channel: z.ZodEnum<typeof CoreM2MNotificationChannel>;
     level: z.ZodOptional<z.ZodEnum<typeof M2MNotificationLevel>>;
 }, z.core.$strip>;
 export type M2MNotificationDefinition = z.infer<typeof M2MNotificationDefinitionSchema>;
-/**
- * Inferred types (interfaces defined above for isolatedDeclarations compatibility)
- */
-export type UserNotificationTarget = string;
-export type NotificationChannel = string;
-export type M2MNotificationChannel = string;
 //# sourceMappingURL=notifications.shared.schemas.d.ts.map