@wildo-ai/saas-models 1.0.1 → 1.1.0

package/dist/esm/notifications/notification-badges.schemas.d.ts

@@ -1,75 +1,179 @@
 import { z } from "zod";
-import { ResourcePrimaryScope } from "../resources/resources.shared.schemas.js";
-export declare enum CoreNotificationBadgeIdentifiers {
-    USER_SELF_NEW_MESSAGES = "user_self_new_messages",
-    ORGANIZATION_UNPAID_INVOICES = "organization_unpaid_invoices"
-}
-export declare const NotificationBadgeIdentifierSchema: z.ZodUnion<readonly [z.ZodEnum<typeof CoreNotificationBadgeIdentifiers>, z.ZodString]>;
-export declare const NotificationScopeSchema: z.ZodUnion<readonly [z.ZodEnum<typeof ResourcePrimaryScope>, z.ZodString]>;
+import { IndicatorVariant } from '@wildo-ai/presets-components-models';
+import { ResourcePrimaryScope } from "../resources/resources.shared.schemas";
+/**
+ * Notification badge identifier.
+ *
+ * No canonical (core) identifiers ship today — the two aspirational placeholders
+ * (`new messages` / `unpaid invoices`) were removed because nothing produced them
+ * (see `.claude/plans/badge-launcher-retract.md`). When the badge surfacing is
+ * reintroduced with a real producer (Reintroduction Contract R1), core identifiers
+ * come back as a `CoreNotificationBadgeIdentifiers` enum unioned in here.
+ */
+export declare const NotificationBadgeIdentifierSchema: z.ZodString;
+/**
+ * Notification badge scope. Tightened to USER_SELF | ORGANIZATIONS only.
+ *
+ * The APPLICATION variant was dropped in the polymorphism refactor
+ * (`.cursor/plans/notification-badges-polymorphism-refactor.md`):
+ *   - No canonical badges were ever declared at APPLICATION scope (see
+ *     `notification-badges.core.definitions.ts`).
+ *   - The two surviving variants (USER + ORG) each own their own resource type
+ *     and MongoDB collection. Allowing APPLICATION here would let consumers
+ *     write a payload that no resource configuration / collection accepts.
+ *
+ * `WS_BadgeUpdatePayload` semantics are unchanged — the dispatcher in
+ * `NotificationBadgeBackendService.emitBadgeUpdate` still routes USER badges to
+ * `sendToUser` and ORG badges to `sendToOrganization`.
+ */
+export declare const NotificationScopeSchema: z.ZodEnum<{
+    user_self: ResourcePrimaryScope.USER_SELF;
+    organizations: ResourcePrimaryScope.ORGANIZATIONS;
+}>;
 export declare enum NotificationBadgeOperation {
     INCREMENT = "increment",
     DECREMENT = "decrement",
     SET = "set",
     RESET = "reset"
 }
+/**
+ * How a badge's count is CALCULATED — the load-bearing distinction (R1).
+ *
+ * - `EVENT_COUNTER`: a stored counter mutated imperatively on domain events
+ *   (arrive → increment, seen → reset). Correct for "unread messages" style
+ *   badges. The count lives in the badge document.
+ * - `DERIVED_QUERY`: the count is a LIVE aggregate over a resource collection
+ *   (`count(resourceType where filter, scoped)`), recomputed on that resource's
+ *   mutations. Correct for "incomplete todos" / "unpaid invoices" — quantities
+ *   derived from data that would DRIFT if tracked with a stored counter.
+ */
+export declare enum NotificationBadgeSourceKind {
+    EVENT_COUNTER = "event_counter",
+    DERIVED_QUERY = "derived_query"
+}
+/** How the badge is presented. `NONE` = suppressed even when the count is > 0. */
+export declare enum NotificationBadgeDisplayMode {
+    /** A colored signal dot ("≥ 1"), no number. */
+    DOT = "dot",
+    /** The numeric count (truncated at the display cap). */
+    COUNT = "count",
+    /** Rendered as nothing (count still computed/available). */
+    NONE = "none"
+}
+/**
+ * WHETHER / WHEN a badge draws attention. The LOOK of the pulse is theme-owned
+ * (`UIBehaviorRecipe.motion.attention`), so a definition only declares intent.
+ */
+export declare enum NotificationBadgePulse {
+    NONE = "none",
+    /** Transitional — pulse briefly when the count rises (recommended). */
+    ON_INCREASE = "on_increase",
+    /** Persistent — pulse while the count is > 0. */
+    WHILE_ACTIVE = "while_active"
+}
+/** EVENT_COUNTER source — no extra config; the stored counter is the truth. */
+export declare const NotificationBadgeEventCounterSourceSchema: z.ZodObject<{
+    kind: z.ZodLiteral<NotificationBadgeSourceKind.EVENT_COUNTER>;
+}, z.core.$strip>;
+/**
+ * DERIVED_QUERY source — the count is `count(resourceType where filter)` with the
+ * scope bound via `scopeField` (the FK field on the counted resource that equals
+ * the badge's `scopeId`, e.g. `userId` for a USER_SELF badge). Recomputed by the
+ * backend on any mutation of `resourceType` (see backend R5).
+ */
+export declare const NotificationBadgeDerivedQuerySourceSchema: z.ZodObject<{
+    kind: z.ZodLiteral<NotificationBadgeSourceKind.DERIVED_QUERY>;
+    resourceType: z.ZodString;
+    filter: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    scopeField: z.ZodString;
+}, z.core.$strip>;
+/** Discriminated union over the calculation kinds. */
+export declare const NotificationBadgeSourceSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    kind: z.ZodLiteral<NotificationBadgeSourceKind.EVENT_COUNTER>;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<NotificationBadgeSourceKind.DERIVED_QUERY>;
+    resourceType: z.ZodString;
+    filter: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    scopeField: z.ZodString;
+}, z.core.$strip>], "kind">;
+/**
+ * Presentation declaration. `tone` reuses the design-system `IndicatorVariant`
+ * (single source — the `Badge` component maps the same enum). `pulse` is a
+ * trigger only; the theme owns the animation.
+ */
+export declare const NotificationBadgeDisplaySchema: z.ZodObject<{
+    mode: z.ZodDefault<z.ZodEnum<typeof NotificationBadgeDisplayMode>>;
+    tone: z.ZodDefault<z.ZodEnum<typeof IndicatorVariant>>;
+    pulse: z.ZodDefault<z.ZodEnum<typeof NotificationBadgePulse>>;
+}, z.core.$strip>;
+/**
+ * Badge DEFINITION — the declaration app/framework authors register: identity +
+ * how the count is calculated (`source`) + how it is presented (`display`).
+ */
 export declare const NotificationBadgeDefinitionSchema: z.ZodObject<{
-    identifier: z.ZodUnion<readonly [z.ZodEnum<typeof CoreNotificationBadgeIdentifiers>, z.ZodString]>;
-    scope: z.ZodUnion<readonly [z.ZodEnum<typeof ResourcePrimaryScope>, z.ZodString]>;
-}, z.core.$strip, core.$ZodObjectExtra>;
+    identifier: z.ZodString;
+    scope: z.ZodEnum<{
+        user_self: ResourcePrimaryScope.USER_SELF;
+        organizations: ResourcePrimaryScope.ORGANIZATIONS;
+    }>;
+    source: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<NotificationBadgeSourceKind.EVENT_COUNTER>;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<NotificationBadgeSourceKind.DERIVED_QUERY>;
+        resourceType: z.ZodString;
+        filter: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        scopeField: z.ZodString;
+    }, z.core.$strip>], "kind">;
+    display: z.ZodObject<{
+        mode: z.ZodDefault<z.ZodEnum<typeof NotificationBadgeDisplayMode>>;
+        tone: z.ZodDefault<z.ZodEnum<typeof IndicatorVariant>>;
+        pulse: z.ZodDefault<z.ZodEnum<typeof NotificationBadgePulse>>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
 export declare const NotificationBadgeOrganizationSchema: z.ZodObject<{
-    identifier: z.ZodUnion<readonly [z.ZodEnum<typeof CoreNotificationBadgeIdentifiers>, z.ZodString]>;
+    identifier: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodString>;
     _id: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodString>;
-    count: z.ZodNumber;
+    count: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodNumber>;
     createdAt: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodDefault<z.ZodDate>>;
-    updatedAt: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodDefault<z.ZodDate>>;
+    updatedAt: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodDefault<z.ZodDate>>>;
     scope: z.ZodLiteral<ResourcePrimaryScope.ORGANIZATIONS>;
     organizationId: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodString>>;
-}, z.core.$strip, core.$ZodObjectExtra>;
-export declare const NotificationBadgeApplicationSchema: z.ZodObject<{
-    identifier: z.ZodUnion<readonly [z.ZodEnum<typeof CoreNotificationBadgeIdentifiers>, z.ZodString]>;
-    _id: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodString>;
-    count: z.ZodNumber;
-    createdAt: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodDefault<z.ZodDate>>;
-    updatedAt: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodDefault<z.ZodDate>>;
-    scope: z.ZodLiteral<ResourcePrimaryScope.APPLICATION>;
-    applicationId: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodString>>;
-}, z.core.$strip, core.$ZodObjectExtra>;
+}, z.core.$strip>;
 export declare const NotificationBadgeUserSelfSchema: z.ZodObject<{
-    identifier: z.ZodUnion<readonly [z.ZodEnum<typeof CoreNotificationBadgeIdentifiers>, z.ZodString]>;
+    identifier: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodString>;
     _id: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodString>;
-    count: z.ZodNumber;
+    count: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodNumber>;
     createdAt: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodDefault<z.ZodDate>>;
-    updatedAt: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodDefault<z.ZodDate>>;
+    updatedAt: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodDefault<z.ZodDate>>>;
     scope: z.ZodLiteral<ResourcePrimaryScope.USER_SELF>;
     userId: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodString>>;
-}, z.core.$strip, core.$ZodObjectExtra>;
+}, z.core.$strip>;
+/**
+ * Discriminated union over the two surviving badge scopes (USER_SELF / ORGANIZATIONS).
+ * The APPLICATION variant was dropped — see `NotificationScopeSchema` JSDoc above.
+ */
 export declare const NotificationBadgeSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
-    identifier: z.ZodUnion<readonly [z.ZodEnum<typeof CoreNotificationBadgeIdentifiers>, z.ZodString]>;
+    identifier: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodString>;
     _id: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodString>;
-    count: z.ZodNumber;
+    count: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodNumber>;
     createdAt: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodDefault<z.ZodDate>>;
-    updatedAt: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodDefault<z.ZodDate>>;
+    updatedAt: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodDefault<z.ZodDate>>>;
     scope: z.ZodLiteral<ResourcePrimaryScope.ORGANIZATIONS>;
     organizationId: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodString>>;
-}, z.core.$strip, core.$ZodObjectExtra>, z.ZodObject<{
-    identifier: z.ZodUnion<readonly [z.ZodEnum<typeof CoreNotificationBadgeIdentifiers>, z.ZodString]>;
-    _id: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodString>;
-    count: z.ZodNumber;
-    createdAt: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodDefault<z.ZodDate>>;
-    updatedAt: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodDefault<z.ZodDate>>;
-    scope: z.ZodLiteral<ResourcePrimaryScope.APPLICATION>;
-    applicationId: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodString>>;
-}, z.core.$strip, core.$ZodObjectExtra>, z.ZodObject<{
-    identifier: z.ZodUnion<readonly [z.ZodEnum<typeof CoreNotificationBadgeIdentifiers>, z.ZodString]>;
+}, z.core.$strip>, z.ZodObject<{
+    identifier: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodString>;
     _id: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodString>;
-    count: z.ZodNumber;
+    count: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodNumber>;
     createdAt: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodDefault<z.ZodDate>>;
-    updatedAt: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodDefault<z.ZodDate>>;
+    updatedAt: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodDefault<z.ZodDate>>>;
     scope: z.ZodLiteral<ResourcePrimaryScope.USER_SELF>;
     userId: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodString>>;
-}, z.core.$strip, core.$ZodObjectExtra>], "scope">;
+}, z.core.$strip>], "scope">;
 export type NotificationBadgeDefinition = z.infer<typeof NotificationBadgeDefinitionSchema>;
 export type NotificationBadgeIdentifier = z.infer<typeof NotificationBadgeIdentifierSchema>;
 export type NotificationScope = z.infer<typeof NotificationScopeSchema>;
 export type NotificationBadge = z.infer<typeof NotificationBadgeSchema>;
+export type NotificationBadgeSource = z.infer<typeof NotificationBadgeSourceSchema>;
+export type NotificationBadgeDerivedQuerySource = z.infer<typeof NotificationBadgeDerivedQuerySourceSchema>;
+export type NotificationBadgeDisplay = z.infer<typeof NotificationBadgeDisplaySchema>;
 //# sourceMappingURL=notification-badges.schemas.d.ts.map

package/dist/esm/notifications/notification-badges.schemas.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"notification-badges.schemas.d.ts","sourceRoot":"","sources":["../../../src/notifications/notification-badges.schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,OAAO,EAAE,oBAAoB,EAAE,MAAM,uCAAuC,CAAC;AAG7E,oBAAY,gCAAgC;IACxC,sBAAsB,2BAA2B;IACjD,4BAA4B,iCAAiC;CAChE;AAED,eAAO,MAAM,iCAAiC,wFAG5C,CAAC;AAEH,eAAO,MAAM,uBAAuB,4EAGlC,CAAC;AAEH,oBAAY,0BAA0B;IAClC,SAAS,cAAc;IACvB,SAAS,cAAc;IACvB,GAAG,QAAQ;IACX,KAAK,UAAU;CAClB;AAED,eAAO,MAAM,iCAAiC;;;uCAG5C,CAAC;AASH,eAAO,MAAM,mCAAmC;;;;;;;;uCAG9C,CAAC;AAEH,eAAO,MAAM,kCAAkC;;;;;;;;uCAG7C,CAAC;AAEH,eAAO,MAAM,+BAA+B;;;;;;;;uCAG1C,CAAC;AAEH,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;kDAIlC,CAAC;AAEH,MAAM,MAAM,2BAA2B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iCAAiC,CAAC,CAAC;AAC5F,MAAM,MAAM,2BAA2B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iCAAiC,CAAC,CAAC;AAC5F,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AACxE,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC"}
+{"version":3,"file":"notification-badges.schemas.d.ts","sourceRoot":"","sources":["../../../../src/notifications/notification-badges.schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,OAAO,EAAE,gBAAgB,EAAE,MAAM,qCAAqC,CAAC;AACvE,OAAO,EAAE,oBAAoB,EAAE,MAAM,uCAAuC,CAAC;AAG7E;;;;;;;;GAQG;AACH,eAAO,MAAM,iCAAiC,aAA4E,CAAC;AAE3H;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,uBAAuB;;;EAGlC,CAAC;AAEH,oBAAY,0BAA0B;IAClC,SAAS,cAAc;IACvB,SAAS,cAAc;IACvB,GAAG,QAAQ;IACX,KAAK,UAAU;CAClB;AAED;;;;;;;;;;GAUG;AACH,oBAAY,2BAA2B;IACnC,aAAa,kBAAkB;IAC/B,aAAa,kBAAkB;CAClC;AAED,kFAAkF;AAClF,oBAAY,4BAA4B;IACpC,+CAA+C;IAC/C,GAAG,QAAQ;IACX,wDAAwD;IACxD,KAAK,UAAU;IACf,4DAA4D;IAC5D,IAAI,SAAS;CAChB;AAED;;;GAGG;AACH,oBAAY,sBAAsB;IAC9B,IAAI,SAAS;IACb,uEAAuE;IACvE,WAAW,gBAAgB;IAC3B,iDAAiD;IACjD,YAAY,iBAAiB;CAChC;AAED,+EAA+E;AAC/E,eAAO,MAAM,yCAAyC;;iBAEpD,CAAC;AAEH;;;;;GAKG;AACH,eAAO,MAAM,yCAAyC;;;;;iBAKpD,CAAC;AAEH,sDAAsD;AACtD,eAAO,MAAM,6BAA6B;;;;;;;2BAGxC,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,8BAA8B;;;;iBAIzC,CAAC;AAYH;;;GAGG;AACH,eAAO,MAAM,iCAAiC;;;;;;;;;;;;;;;;;;;iBAG5C,CAAC;AAkBH,eAAO,MAAM,mCAAmC;;;;;;;;iBAG9C,CAAC;AAEH,eAAO,MAAM,+BAA+B;;;;;;;;iBAG1C,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;4BAGlC,CAAC;AAEH,MAAM,MAAM,2BAA2B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iCAAiC,CAAC,CAAC;AAC5F,MAAM,MAAM,2BAA2B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iCAAiC,CAAC,CAAC;AAC5F,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AACxE,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AACxE,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,6BAA6B,CAAC,CAAC;AACpF,MAAM,MAAM,mCAAmC,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yCAAyC,CAAC,CAAC;AAC5G,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,8BAA8B,CAAC,CAAC"}

package/dist/esm/notifications/notification-badges.schemas.js

@@ -1,19 +1,36 @@
 import { z } from "zod";
 import { initZodDecorators } from '@wildo-ai/zod-decorators';
 initZodDecorators(z);
+import { IndicatorVariant } from '@wildo-ai/presets-components-models';
 import { ResourcePrimaryScope } from "../resources/resources.shared.schemas.js";
-export var CoreNotificationBadgeIdentifiers;
-(function (CoreNotificationBadgeIdentifiers) {
-    CoreNotificationBadgeIdentifiers["USER_SELF_NEW_MESSAGES"] = "user_self_new_messages";
-    CoreNotificationBadgeIdentifiers["ORGANIZATION_UNPAID_INVOICES"] = "organization_unpaid_invoices";
-})(CoreNotificationBadgeIdentifiers || (CoreNotificationBadgeIdentifiers = {}));
-export const NotificationBadgeIdentifierSchema = z.union([
-    z.enum(CoreNotificationBadgeIdentifiers),
-    z.string().min(1, { error: 'Notification badge identifier is required' }),
-]);
-export const NotificationScopeSchema = z.union([
-    z.enum(ResourcePrimaryScope),
-    z.string().min(1, { error: 'Notification scope is required' }),
+/**
+ * Notification badge identifier.
+ *
+ * No canonical (core) identifiers ship today — the two aspirational placeholders
+ * (`new messages` / `unpaid invoices`) were removed because nothing produced them
+ * (see `.claude/plans/badge-launcher-retract.md`). When the badge surfacing is
+ * reintroduced with a real producer (Reintroduction Contract R1), core identifiers
+ * come back as a `CoreNotificationBadgeIdentifiers` enum unioned in here.
+ */
+export const NotificationBadgeIdentifierSchema = z.string().min(1, { error: 'Notification badge identifier is required' });
+/**
+ * Notification badge scope. Tightened to USER_SELF | ORGANIZATIONS only.
+ *
+ * The APPLICATION variant was dropped in the polymorphism refactor
+ * (`.cursor/plans/notification-badges-polymorphism-refactor.md`):
+ *   - No canonical badges were ever declared at APPLICATION scope (see
+ *     `notification-badges.core.definitions.ts`).
+ *   - The two surviving variants (USER + ORG) each own their own resource type
+ *     and MongoDB collection. Allowing APPLICATION here would let consumers
+ *     write a payload that no resource configuration / collection accepts.
+ *
+ * `WS_BadgeUpdatePayload` semantics are unchanged — the dispatcher in
+ * `NotificationBadgeBackendService.emitBadgeUpdate` still routes USER badges to
+ * `sendToUser` and ORG badges to `sendToOrganization`.
+ */
+export const NotificationScopeSchema = z.enum([
+    ResourcePrimaryScope.USER_SELF,
+    ResourcePrimaryScope.ORGANIZATIONS,
 ]);
 export var NotificationBadgeOperation;
 (function (NotificationBadgeOperation) {
@@ -22,31 +39,121 @@ export var NotificationBadgeOperation;
     NotificationBadgeOperation["SET"] = "set";
     NotificationBadgeOperation["RESET"] = "reset";
 })(NotificationBadgeOperation || (NotificationBadgeOperation = {}));
-export const NotificationBadgeDefinitionSchema = z.object({
+/**
+ * How a badge's count is CALCULATED — the load-bearing distinction (R1).
+ *
+ * - `EVENT_COUNTER`: a stored counter mutated imperatively on domain events
+ *   (arrive → increment, seen → reset). Correct for "unread messages" style
+ *   badges. The count lives in the badge document.
+ * - `DERIVED_QUERY`: the count is a LIVE aggregate over a resource collection
+ *   (`count(resourceType where filter, scoped)`), recomputed on that resource's
+ *   mutations. Correct for "incomplete todos" / "unpaid invoices" — quantities
+ *   derived from data that would DRIFT if tracked with a stored counter.
+ */
+export var NotificationBadgeSourceKind;
+(function (NotificationBadgeSourceKind) {
+    NotificationBadgeSourceKind["EVENT_COUNTER"] = "event_counter";
+    NotificationBadgeSourceKind["DERIVED_QUERY"] = "derived_query";
+})(NotificationBadgeSourceKind || (NotificationBadgeSourceKind = {}));
+/** How the badge is presented. `NONE` = suppressed even when the count is > 0. */
+export var NotificationBadgeDisplayMode;
+(function (NotificationBadgeDisplayMode) {
+    /** A colored signal dot ("≥ 1"), no number. */
+    NotificationBadgeDisplayMode["DOT"] = "dot";
+    /** The numeric count (truncated at the display cap). */
+    NotificationBadgeDisplayMode["COUNT"] = "count";
+    /** Rendered as nothing (count still computed/available). */
+    NotificationBadgeDisplayMode["NONE"] = "none";
+})(NotificationBadgeDisplayMode || (NotificationBadgeDisplayMode = {}));
+/**
+ * WHETHER / WHEN a badge draws attention. The LOOK of the pulse is theme-owned
+ * (`UIBehaviorRecipe.motion.attention`), so a definition only declares intent.
+ */
+export var NotificationBadgePulse;
+(function (NotificationBadgePulse) {
+    NotificationBadgePulse["NONE"] = "none";
+    /** Transitional — pulse briefly when the count rises (recommended). */
+    NotificationBadgePulse["ON_INCREASE"] = "on_increase";
+    /** Persistent — pulse while the count is > 0. */
+    NotificationBadgePulse["WHILE_ACTIVE"] = "while_active";
+})(NotificationBadgePulse || (NotificationBadgePulse = {}));
+/** EVENT_COUNTER source — no extra config; the stored counter is the truth. */
+export const NotificationBadgeEventCounterSourceSchema = z.object({
+    kind: z.literal(NotificationBadgeSourceKind.EVENT_COUNTER),
+});
+/**
+ * DERIVED_QUERY source — the count is `count(resourceType where filter)` with the
+ * scope bound via `scopeField` (the FK field on the counted resource that equals
+ * the badge's `scopeId`, e.g. `userId` for a USER_SELF badge). Recomputed by the
+ * backend on any mutation of `resourceType` (see backend R5).
+ */
+export const NotificationBadgeDerivedQuerySourceSchema = z.object({
+    kind: z.literal(NotificationBadgeSourceKind.DERIVED_QUERY),
+    resourceType: z.string().min(1, { error: 'Derived-badge resourceType is required' }),
+    filter: z.record(z.string(), z.unknown()),
+    scopeField: z.string().min(1, { error: 'Derived-badge scopeField is required' }),
+});
+/** Discriminated union over the calculation kinds. */
+export const NotificationBadgeSourceSchema = z.discriminatedUnion('kind', [
+    NotificationBadgeEventCounterSourceSchema,
+    NotificationBadgeDerivedQuerySourceSchema,
+]);
+/**
+ * Presentation declaration. `tone` reuses the design-system `IndicatorVariant`
+ * (single source — the `Badge` component maps the same enum). `pulse` is a
+ * trigger only; the theme owns the animation.
+ */
+export const NotificationBadgeDisplaySchema = z.object({
+    mode: z.enum(NotificationBadgeDisplayMode).default(NotificationBadgeDisplayMode.COUNT),
+    tone: z.enum(IndicatorVariant).default(IndicatorVariant.NEUTRAL),
+    pulse: z.enum(NotificationBadgePulse).default(NotificationBadgePulse.NONE),
+});
+/**
+ * Badge IDENTITY — the (identifier, scope) tuple shared by the declaration and
+ * the persisted document. Kept separate so the stored badge doc does NOT absorb
+ * declaration-only fields (`source` / `display`).
+ */
+const NotificationBadgeIdentitySchema = z.object({
     identifier: NotificationBadgeIdentifierSchema,
     scope: NotificationScopeSchema,
 });
-const NotificationBadgeBaseSchema = NotificationBadgeDefinitionSchema.extend({
-    _id: z.string().isDBIndexed().min(1, { error: 'Notification badge ID is required' }),
-    count: z.number().min(0, { error: 'Notification badge count must be greater than or equal to 0' }),
+/**
+ * Badge DEFINITION — the declaration app/framework authors register: identity +
+ * how the count is calculated (`source`) + how it is presented (`display`).
+ */
+export const NotificationBadgeDefinitionSchema = NotificationBadgeIdentitySchema.extend({
+    source: NotificationBadgeSourceSchema,
+    display: NotificationBadgeDisplaySchema,
+});
+const NotificationBadgeBaseSchema = NotificationBadgeIdentitySchema.extend({
+    // A compact badge without its application-defined identifier is not interpretable: callers
+    // could see a number but not what the number counts. Override the identity field here (rather
+    // than decorating NotificationBadgeIdentitySchema) so persisted API rows gain summary metadata
+    // while application-authored badge definitions remain a plain declaration schema.
+    identifier: NotificationBadgeIdentifierSchema.isSummaryField(),
+    // `isPrimaryKey` (composite: excludeFromCreate + isHidden + isUnique + isDBIndexed) —
+    // the server generates `_id`, so it must NOT be required on the create DTO. Using bare
+    // `.isDBIndexed()` here left `_id` create-required, which failed the dispatcher-driven
+    // badge materialization (`buildNewBadge` supplies no `_id`).
+    _id: z.string().min(1, { error: 'Notification badge ID is required' }).isPrimaryKey(),
+    count: z.number().min(0, { error: 'Notification badge count must be greater than or equal to 0' }).isSummaryField(),
     createdAt: z.date().default(() => new Date()).isDBIndexed(),
-    updatedAt: z.date().default(() => new Date()).isDBIndexed(),
+    updatedAt: z.date().default(() => new Date()).isDBIndexed().isSummaryField(),
 });
 export const NotificationBadgeOrganizationSchema = NotificationBadgeBaseSchema.extend({
     scope: z.literal(ResourcePrimaryScope.ORGANIZATIONS),
     organizationId: z.string().min(1, { error: 'Organization ID is required' }).isDBIndexed().isForeignKey(),
 });
-export const NotificationBadgeApplicationSchema = NotificationBadgeBaseSchema.extend({
-    scope: z.literal(ResourcePrimaryScope.APPLICATION),
-    applicationId: z.string().min(1, { error: 'Application ID is required' }).isDBIndexed().isForeignKey(),
-});
 export const NotificationBadgeUserSelfSchema = NotificationBadgeBaseSchema.extend({
     scope: z.literal(ResourcePrimaryScope.USER_SELF),
     userId: z.string().min(1, { error: 'User ID is required' }).isDBIndexed().isForeignKey(),
 });
+/**
+ * Discriminated union over the two surviving badge scopes (USER_SELF / ORGANIZATIONS).
+ * The APPLICATION variant was dropped — see `NotificationScopeSchema` JSDoc above.
+ */
 export const NotificationBadgeSchema = z.discriminatedUnion('scope', [
     NotificationBadgeOrganizationSchema,
-    NotificationBadgeApplicationSchema,
     NotificationBadgeUserSelfSchema,
 ]);
-//# sourceMappingURL=notification-badges.schemas.js.map
+//# sourceMappingURL=notification-badges.schemas.js.map

package/dist/esm/notifications/notification-badges.schemas.js.map

@@ -1 +1 @@
-{"version":3,"file":"notification-badges.schemas.js","sourceRoot":"","sources":["../../../src/notifications/notification-badges.schemas.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"notification-badges.schemas.js","sourceRoot":"","sources":["../../../../src/notifications/notification-badges.schemas.ts"],"names":[],"mappings":"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","sourcesContent":["import { z } from \"zod\";\nimport { initZodDecorators } from '@wildo-ai/zod-decorators';\n\ninitZodDecorators(z);\n\nimport { IndicatorVariant } from '@wildo-ai/presets-components-models';\nimport { ResourcePrimaryScope } from \"../resources/resources.shared.schemas\";\n\n\n/**\n * Notification badge identifier.\n *\n * No canonical (core) identifiers ship today — the two aspirational placeholders\n * (`new messages` / `unpaid invoices`) were removed because nothing produced them\n * (see `.claude/plans/badge-launcher-retract.md`). When the badge surfacing is\n * reintroduced with a real producer (Reintroduction Contract R1), core identifiers\n * come back as a `CoreNotificationBadgeIdentifiers` enum unioned in here.\n */\nexport const NotificationBadgeIdentifierSchema = z.string().min(1, { error: 'Notification badge identifier is required' });\n\n/**\n * Notification badge scope. Tightened to USER_SELF | ORGANIZATIONS only.\n *\n * The APPLICATION variant was dropped in the polymorphism refactor\n * (`.cursor/plans/notification-badges-polymorphism-refactor.md`):\n *   - No canonical badges were ever declared at APPLICATION scope (see\n *     `notification-badges.core.definitions.ts`).\n *   - The two surviving variants (USER + ORG) each own their own resource type\n *     and MongoDB collection. Allowing APPLICATION here would let consumers\n *     write a payload that no resource configuration / collection accepts.\n *\n * `WS_BadgeUpdatePayload` semantics are unchanged — the dispatcher in\n * `NotificationBadgeBackendService.emitBadgeUpdate` still routes USER badges to\n * `sendToUser` and ORG badges to `sendToOrganization`.\n */\nexport const NotificationScopeSchema = z.enum([\n    ResourcePrimaryScope.USER_SELF,\n    ResourcePrimaryScope.ORGANIZATIONS,\n]);\n\nexport enum NotificationBadgeOperation {\n    INCREMENT = 'increment',\n    DECREMENT = 'decrement',\n    SET = 'set',\n    RESET = 'reset',\n}\n\n/**\n * How a badge's count is CALCULATED — the load-bearing distinction (R1).\n *\n * - `EVENT_COUNTER`: a stored counter mutated imperatively on domain events\n *   (arrive → increment, seen → reset). Correct for \"unread messages\" style\n *   badges. The count lives in the badge document.\n * - `DERIVED_QUERY`: the count is a LIVE aggregate over a resource collection\n *   (`count(resourceType where filter, scoped)`), recomputed on that resource's\n *   mutations. Correct for \"incomplete todos\" / \"unpaid invoices\" — quantities\n *   derived from data that would DRIFT if tracked with a stored counter.\n */\nexport enum NotificationBadgeSourceKind {\n    EVENT_COUNTER = 'event_counter',\n    DERIVED_QUERY = 'derived_query',\n}\n\n/** How the badge is presented. `NONE` = suppressed even when the count is > 0. */\nexport enum NotificationBadgeDisplayMode {\n    /** A colored signal dot (\"≥ 1\"), no number. */\n    DOT = 'dot',\n    /** The numeric count (truncated at the display cap). */\n    COUNT = 'count',\n    /** Rendered as nothing (count still computed/available). */\n    NONE = 'none',\n}\n\n/**\n * WHETHER / WHEN a badge draws attention. The LOOK of the pulse is theme-owned\n * (`UIBehaviorRecipe.motion.attention`), so a definition only declares intent.\n */\nexport enum NotificationBadgePulse {\n    NONE = 'none',\n    /** Transitional — pulse briefly when the count rises (recommended). */\n    ON_INCREASE = 'on_increase',\n    /** Persistent — pulse while the count is > 0. */\n    WHILE_ACTIVE = 'while_active',\n}\n\n/** EVENT_COUNTER source — no extra config; the stored counter is the truth. */\nexport const NotificationBadgeEventCounterSourceSchema = z.object({\n    kind: z.literal(NotificationBadgeSourceKind.EVENT_COUNTER),\n});\n\n/**\n * DERIVED_QUERY source — the count is `count(resourceType where filter)` with the\n * scope bound via `scopeField` (the FK field on the counted resource that equals\n * the badge's `scopeId`, e.g. `userId` for a USER_SELF badge). Recomputed by the\n * backend on any mutation of `resourceType` (see backend R5).\n */\nexport const NotificationBadgeDerivedQuerySourceSchema = z.object({\n    kind: z.literal(NotificationBadgeSourceKind.DERIVED_QUERY),\n    resourceType: z.string().min(1, { error: 'Derived-badge resourceType is required' }),\n    filter: z.record(z.string(), z.unknown()),\n    scopeField: z.string().min(1, { error: 'Derived-badge scopeField is required' }),\n});\n\n/** Discriminated union over the calculation kinds. */\nexport const NotificationBadgeSourceSchema = z.discriminatedUnion('kind', [\n    NotificationBadgeEventCounterSourceSchema,\n    NotificationBadgeDerivedQuerySourceSchema,\n]);\n\n/**\n * Presentation declaration. `tone` reuses the design-system `IndicatorVariant`\n * (single source — the `Badge` component maps the same enum). `pulse` is a\n * trigger only; the theme owns the animation.\n */\nexport const NotificationBadgeDisplaySchema = z.object({\n    mode: z.enum(NotificationBadgeDisplayMode).default(NotificationBadgeDisplayMode.COUNT),\n    tone: z.enum(IndicatorVariant).default(IndicatorVariant.NEUTRAL),\n    pulse: z.enum(NotificationBadgePulse).default(NotificationBadgePulse.NONE),\n});\n\n/**\n * Badge IDENTITY — the (identifier, scope) tuple shared by the declaration and\n * the persisted document. Kept separate so the stored badge doc does NOT absorb\n * declaration-only fields (`source` / `display`).\n */\nconst NotificationBadgeIdentitySchema = z.object({\n    identifier: NotificationBadgeIdentifierSchema,\n    scope: NotificationScopeSchema,\n});\n\n/**\n * Badge DEFINITION — the declaration app/framework authors register: identity +\n * how the count is calculated (`source`) + how it is presented (`display`).\n */\nexport const NotificationBadgeDefinitionSchema = NotificationBadgeIdentitySchema.extend({\n    source: NotificationBadgeSourceSchema,\n    display: NotificationBadgeDisplaySchema,\n});\n\nconst NotificationBadgeBaseSchema = NotificationBadgeIdentitySchema.extend({\n    // A compact badge without its application-defined identifier is not interpretable: callers\n    // could see a number but not what the number counts. Override the identity field here (rather\n    // than decorating NotificationBadgeIdentitySchema) so persisted API rows gain summary metadata\n    // while application-authored badge definitions remain a plain declaration schema.\n    identifier: NotificationBadgeIdentifierSchema.isSummaryField(),\n    // `isPrimaryKey` (composite: excludeFromCreate + isHidden + isUnique + isDBIndexed) —\n    // the server generates `_id`, so it must NOT be required on the create DTO. Using bare\n    // `.isDBIndexed()` here left `_id` create-required, which failed the dispatcher-driven\n    // badge materialization (`buildNewBadge` supplies no `_id`).\n    _id: z.string().min(1, { error: 'Notification badge ID is required' }).isPrimaryKey(),\n    count: z.number().min(0, { error: 'Notification badge count must be greater than or equal to 0' }).isSummaryField(),\n    createdAt: z.date().default(() => new Date()).isDBIndexed(),\n    updatedAt: z.date().default(() => new Date()).isDBIndexed().isSummaryField(),\n});\n\nexport const NotificationBadgeOrganizationSchema = NotificationBadgeBaseSchema.extend({\n    scope: z.literal(ResourcePrimaryScope.ORGANIZATIONS),\n    organizationId: z.string().min(1, { error: 'Organization ID is required' }).isDBIndexed().isForeignKey(),\n});\n\nexport const NotificationBadgeUserSelfSchema = NotificationBadgeBaseSchema.extend({\n    scope: z.literal(ResourcePrimaryScope.USER_SELF),\n    userId: z.string().min(1, { error: 'User ID is required' }).isDBIndexed().isForeignKey(),\n});\n\n/**\n * Discriminated union over the two surviving badge scopes (USER_SELF / ORGANIZATIONS).\n * The APPLICATION variant was dropped — see `NotificationScopeSchema` JSDoc above.\n */\nexport const NotificationBadgeSchema = z.discriminatedUnion('scope', [\n    NotificationBadgeOrganizationSchema,\n    NotificationBadgeUserSelfSchema,\n]);\n\nexport type NotificationBadgeDefinition = z.infer<typeof NotificationBadgeDefinitionSchema>;\nexport type NotificationBadgeIdentifier = z.infer<typeof NotificationBadgeIdentifierSchema>;\nexport type NotificationScope = z.infer<typeof NotificationScopeSchema>;\nexport type NotificationBadge = z.infer<typeof NotificationBadgeSchema>;\nexport type NotificationBadgeSource = z.infer<typeof NotificationBadgeSourceSchema>;\nexport type NotificationBadgeDerivedQuerySource = z.infer<typeof NotificationBadgeDerivedQuerySourceSchema>;\nexport type NotificationBadgeDisplay = z.infer<typeof NotificationBadgeDisplaySchema>;\n\n"]}

package/dist/esm/notifications/notification-badges.shared.resources-config.schemas.d.ts

@@ -1,22 +1,47 @@
-import { NotificationBadgeSchema } from './notification-badges.schemas.js';
-import { CoreResourceOperation } from '../resources/resources.shared.core.definitions.js';
-import { ResourceRelationship } from '../resources/resources.shared.schemas.js';
-import { ResourceConfiguration } from '../resources/resources-config.shared.schemas.js';
 /**
- * Notification Badges Resource Configuration (Repository-only)
+ * Notification Badges Shared Resource Configurations
  *
- * Provides repository operations for storing notification badge counts.
- * Badges are system-managed counters used to show unread counts, pending items, etc.
+ * Polymorphic dual-scope (USER + ORGANIZATION). Two completely separate factories,
+ * each registered against its own `ResourceType` member and backed by its own
+ * MongoDB collection. We follow the lifecycle-state / guidance-state pattern
+ * (two side-by-side factories) rather than `createPolymorphicResourceConfigurations`
+ * because the variants have:
+ *   - Different schemas (`NotificationBadgeUserSelfSchema` vs
+ *     `NotificationBadgeOrganizationSchema`),
+ *   - Different role surfaces (`APP_USER` reads on the USER variant vs
+ *     `ORG_MEMBER` reads on the ORG variant), and
+ *   - Different parent-scope anchors (USERS vs ORGANIZATIONS).
  *
- * Primary scope: APPLICATION (badges span multiple scopes internally)
+ * Both variants:
+ *   - Operations: READ / LIST / CREATE / UPDATE (no DELETE — badges are reset to 0).
+ *   - `isSystemResource: true` — internal infrastructure, accessed via
+ *     `NotificationBadgeBackendService` (the public API is `increment`,
+ *     `decrement`, `set`, `reset` — never raw repository calls from app code).
  *
- * Operations:
- * - READ: Get a specific badge
- * - LIST: Get all badges for a scope
- * - CREATE: Create a new badge (internal use)
- * - UPDATE: Update badge count (internal use)
+ * Role + variant assignments per D-2 of `.cursor/plans/notification-badges-polymorphism-refactor.md`
+ * (mirrors the lifecycle-state precedent: READ/LIST exposed as `API_CALL` so
+ * the user can read their own badges through the framework's HTTP surface;
+ * CREATE/UPDATE stay `REPOSITORY_ONLY` because badge writes are exclusively
+ * driven by `NotificationBadgeBackendService` from internal dispatchers):
+ *   - USER variant:
+ *       READ / LIST  → `[CORE_APP_ROLES.APP_USER]` via `API_CALL`
+ *       CREATE/UPDATE → `[CORE_APP_ROLES.APP_ADMIN_SUPER_ADMIN]` via `REPOSITORY_ONLY`
+ *   - ORG variant:
+ *       READ / LIST  → `[CORE_ORG_ROLES.ORG_MEMBER]` via `API_CALL`
+ *                      (any org member can see aggregate org badges; matches
+ *                      the lifecycle-state pattern's symmetric ORG_MEMBER read)
+ *       CREATE/UPDATE → `[CORE_APP_ROLES.APP_ADMIN_SUPER_ADMIN]` via `REPOSITORY_ONLY`
  *
- * Note: No DELETE operation - badges are reset to 0 instead of deleted.
+ * @see notification-badges.schemas.ts — discriminated union at the data layer
+ * @see .cursor/plans/notification-badges-polymorphism-refactor.md
  */
-export declare const notificationBadgesResourceConfiguration_InitializationFactory: (resourcesRelationships: ResourceRelationship[]) => ResourceConfiguration<undefined, CoreResourceOperation.READ | CoreResourceOperation.LIST | CoreResourceOperation.CREATE | CoreResourceOperation.UPDATE, typeof NotificationBadgeSchema>;
+import { NotificationBadgeUserSelfSchema, NotificationBadgeOrganizationSchema } from './notification-badges.schemas';
+import { CoreResourceOperation } from '../resources/resources.shared.core.definitions';
+import { ResourceRelationship } from '../resources/resources.shared.schemas';
+import { ResourceConfiguration } from '../resources/resources-config.shared.schemas';
+type UserNotificationBadgesCoreOperations = CoreResourceOperation.READ | CoreResourceOperation.LIST | CoreResourceOperation.CREATE | CoreResourceOperation.UPDATE | CoreResourceOperation.DELETE;
+export declare const userNotificationBadgesResourceConfiguration_InitializationFactory: (resourcesRelationships: ResourceRelationship[]) => ResourceConfiguration<undefined, UserNotificationBadgesCoreOperations, typeof NotificationBadgeUserSelfSchema>;
+type OrganizationNotificationBadgesCoreOperations = CoreResourceOperation.READ | CoreResourceOperation.LIST | CoreResourceOperation.CREATE | CoreResourceOperation.UPDATE | CoreResourceOperation.DELETE;
+export declare const organizationNotificationBadgesResourceConfiguration_InitializationFactory: (resourcesRelationships: ResourceRelationship[]) => ResourceConfiguration<undefined, OrganizationNotificationBadgesCoreOperations, typeof NotificationBadgeOrganizationSchema>;
+export {};
 //# sourceMappingURL=notification-badges.shared.resources-config.schemas.d.ts.map

package/dist/esm/notifications/notification-badges.shared.resources-config.schemas.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"notification-badges.shared.resources-config.schemas.d.ts","sourceRoot":"","sources":["../../../src/notifications/notification-badges.shared.resources-config.schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,+BAA+B,CAAC;AAExE,OAAO,EAAE,qBAAqB,EAAwD,MAAM,gDAAgD,CAAC;AAC7I,OAAO,EAA4D,oBAAoB,EAAE,MAAM,uCAAuC,CAAC;AACvI,OAAO,EAAE,qBAAqB,EAAE,MAAM,8CAA8C,CAAC;AAGrF;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,6DAA6D,GACxE,wBAAwB,oBAAoB,EAAE,KAC7C,qBAAqB,CACtB,SAAS,EACT,qBAAqB,CAAC,IAAI,GAAG,qBAAqB,CAAC,IAAI,GAAG,qBAAqB,CAAC,MAAM,GAAG,qBAAqB,CAAC,MAAM,EACrH,OAAO,uBAAuB,CA4D9B,CAAC"}
+{"version":3,"file":"notification-badges.shared.resources-config.schemas.d.ts","sourceRoot":"","sources":["../../../../src/notifications/notification-badges.shared.resources-config.schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AAEH,OAAO,EACL,+BAA+B,EAC/B,mCAAmC,EACpC,MAAM,+BAA+B,CAAC;AAEvC,OAAO,EACL,qBAAqB,EAGtB,MAAM,gDAAgD,CAAC;AACxD,OAAO,EAGL,oBAAoB,EACrB,MAAM,uCAAuC,CAAC;AAC/C,OAAO,EAAE,qBAAqB,EAAE,MAAM,8CAA8C,CAAC;AAOrF,KAAK,oCAAoC,GACrC,qBAAqB,CAAC,IAAI,GAC1B,qBAAqB,CAAC,IAAI,GAC1B,qBAAqB,CAAC,MAAM,GAC5B,qBAAqB,CAAC,MAAM,GAC5B,qBAAqB,CAAC,MAAM,CAAC;AAEjC,eAAO,MAAM,iEAAiE,GAC5E,wBAAwB,oBAAoB,EAAE,KAC7C,qBAAqB,CACtB,SAAS,EACT,oCAAoC,EACpC,OAAO,+BAA+B,CAyFtC,CAAC;AAIH,KAAK,4CAA4C,GAC7C,qBAAqB,CAAC,IAAI,GAC1B,qBAAqB,CAAC,IAAI,GAC1B,qBAAqB,CAAC,MAAM,GAC5B,qBAAqB,CAAC,MAAM,GAC5B,qBAAqB,CAAC,MAAM,CAAC;AAEjC,eAAO,MAAM,yEAAyE,GACpF,wBAAwB,oBAAoB,EAAE,KAC7C,qBAAqB,CACtB,SAAS,EACT,4CAA4C,EAC5C,OAAO,mCAAmC,CAoF1C,CAAC"}