@antelopejs/interface-dms 0.3.4 → 0.3.6

package/dist/layout-banners.js

@@ -3,15 +3,33 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.internal = exports.LayoutBannerVariant = void 0;
 exports.RegisterLayoutBanner = RegisterLayoutBanner;
 const interface_core_1 = require("@antelopejs/interface-core");
+/**
+ * Semantic look of a layout banner. It also picks the banner's ARIA role:
+ * `error` is announced as an `alert`, `info` and `warning` politely as a
+ * `status`.
+ */
 exports.LayoutBannerVariant = {
     INFO: "info",
     WARNING: "warning",
     ERROR: "error",
 };
+/** @internal */
 var internal;
 (function (internal) {
     internal.RegisterLayoutBanner = new interface_core_1.RegisteringProxy();
 })(internal || (exports.internal = internal = {}));
+/**
+ * Register a global banner under the dashboard header. Banners stack by
+ * `order`, and each one's `visible` resolver is evaluated server-side for every
+ * site layout request, so the banner is in the server-rendered page. When the
+ * state a resolver reads changes, call `NotifyMenuChanged(tenantId)` so the
+ * connected clients re-fetch their site layout.
+ *
+ * The registration is dropped automatically when the registering module stops.
+ *
+ * @returns Removes this banner, for a module that drops it while staying
+ * loaded.
+ */
 function RegisterLayoutBanner(info) {
     internal.RegisterLayoutBanner.register(info);
     return () => internal.RegisterLayoutBanner.unregister(info);

package/dist/layout-banners.js.map

@@ -1 +1 @@
-{"version":3,"file":"layout-banners.js","sourceRoot":"","sources":["../src/layout-banners.ts"],"names":[],"mappings":";;;AAyHA,oDAGC;AA5HD,+DAA8D;AASjD,QAAA,mBAAmB,GAAG;IACjC,IAAI,EAAE,MAAM;IACZ,OAAO,EAAE,SAAS;IAClB,KAAK,EAAE,OAAO;CACN,CAAC;AA0FX,IAAiB,QAAQ,CAIxB;AAJD,WAAiB,QAAQ;IACV,6BAAoB,GAAG,IAAI,iCAAgB,EAErD,CAAC;AACN,CAAC,EAJgB,QAAQ,wBAAR,QAAQ,QAIxB;AAcD,SAAgB,oBAAoB,CAAC,IAAsB;IACzD,QAAQ,CAAC,oBAAoB,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IAC7C,OAAO,GAAG,EAAE,CAAC,QAAQ,CAAC,oBAAoB,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;AAC9D,CAAC"}
+{"version":3,"file":"layout-banners.js","sourceRoot":"","sources":["../src/layout-banners.ts"],"names":[],"mappings":";;;AA0HA,oDAGC;AA7HD,+DAA8D;AAI9D;;;;GAIG;AACU,QAAA,mBAAmB,GAAG;IACjC,IAAI,EAAE,MAAM;IACZ,OAAO,EAAE,SAAS;IAClB,KAAK,EAAE,OAAO;CACN,CAAC;AA0FX,gBAAgB;AAChB,IAAiB,QAAQ,CAIxB;AAJD,WAAiB,QAAQ;IACV,6BAAoB,GAAG,IAAI,iCAAgB,EAErD,CAAC;AACN,CAAC,EAJgB,QAAQ,wBAAR,QAAQ,QAIxB;AAED;;;;;;;;;;;GAWG;AACH,SAAgB,oBAAoB,CAAC,IAAsB;IACzD,QAAQ,CAAC,oBAAoB,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IAC7C,OAAO,GAAG,EAAE,CAAC,QAAQ,CAAC,oBAAoB,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;AAC9D,CAAC"}

package/dist/notifications/builder.d.ts

@@ -1,5 +1,5 @@
 import { SendableNotification } from "./sendable";
-import type { NotificationSubjectInfo, RequiredFields } from "./types";
+import type { NotificationSubjectInfo, NotificationTone, RequiredFields } from "./types";
 export declare class NotificationBuilder<Set extends string = never> {
     private data;
     icon(value: string): NotificationBuilder<Set | "icon">;
@@ -8,5 +8,7 @@ export declare class NotificationBuilder<Set extends string = never> {
     subject(subject: NotificationSubjectInfo): NotificationBuilder<Set | "subject">;
     linkTo(value: string): NotificationBuilder<Set | "linkTo">;
     params(value: Record<string, string | number>): NotificationBuilder<Set | "params">;
+    /** Colours the icon well the notification is listed with. */
+    tone(value: NotificationTone): NotificationBuilder<Set | "tone">;
     build(this: RequiredFields extends Set ? NotificationBuilder<Set> : never): SendableNotification;
 }

package/dist/notifications/builder.js

@@ -1,6 +1,11 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.NotificationBuilder = void 0;
+// The builder tracks which fields are set in a phantom type parameter, so each
+// setter returns `this` widened by one more key. TypeScript cannot narrow
+// `this` to a different instantiation of its own class, which is what makes the
+// chain unavoidable for this pattern.
+/* oxlint-disable anti-slop/no-chained-type-assertions */
 const sendable_1 = require("./sendable");
 class NotificationBuilder {
     data = {};
@@ -28,6 +33,11 @@ class NotificationBuilder {
         this.data.params = value;
         return this;
     }
+    /** Colours the icon well the notification is listed with. */
+    tone(value) {
+        this.data.tone = value;
+        return this;
+    }
     build() {
         return new sendable_1.SendableNotification(this.data);
     }

package/dist/notifications/builder.js.map

@@ -1 +1 @@
-{"version":3,"file":"builder.js","sourceRoot":"","sources":["../../src/notifications/builder.ts"],"names":[],"mappings":";;;AAKA,yCAAkD;AAOlD,MAAa,mBAAmB;IACtB,IAAI,GAA8B,EAAE,CAAC;IAE7C,IAAI,CAAC,KAAa;QAChB,IAAI,CAAC,IAAI,CAAC,IAAI,GAAG,KAAK,CAAC;QACvB,OAAO,IAAoD,CAAC;IAC9D,CAAC;IAED,KAAK,CAAC,KAAa;QACjB,IAAI,CAAC,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACxB,OAAO,IAAqD,CAAC;IAC/D,CAAC;IAED,WAAW,CAAC,KAAa;QACvB,IAAI,CAAC,IAAI,CAAC,WAAW,GAAG,KAAK,CAAC;QAC9B,OAAO,IAA2D,CAAC;IACrE,CAAC;IAED,OAAO,CACL,OAAgC;QAEhC,IAAI,CAAC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QAC5B,OAAO,IAAuD,CAAC;IACjE,CAAC;IAED,MAAM,CAAC,KAAa;QAClB,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;QACzB,OAAO,IAAsD,CAAC;IAChE,CAAC;IAED,MAAM,CACJ,KAAsC;QAEtC,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;QACzB,OAAO,IAAsD,CAAC;IAChE,CAAC;IAED,KAAK;QAGH,OAAO,IAAI,+BAAoB,CAAC,IAAI,CAAC,IAAwB,CAAC,CAAC;IACjE,CAAC;CACF;AA1CD,kDA0CC"}
+{"version":3,"file":"builder.js","sourceRoot":"","sources":["../../src/notifications/builder.ts"],"names":[],"mappings":";;;AAAA,+EAA+E;AAC/E,0EAA0E;AAC1E,gFAAgF;AAChF,sCAAsC;AACtC,yDAAyD;AACzD,yCAAkD;AAQlD,MAAa,mBAAmB;IACtB,IAAI,GAA8B,EAAE,CAAC;IAE7C,IAAI,CAAC,KAAa;QAChB,IAAI,CAAC,IAAI,CAAC,IAAI,GAAG,KAAK,CAAC;QACvB,OAAO,IAAoD,CAAC;IAC9D,CAAC;IAED,KAAK,CAAC,KAAa;QACjB,IAAI,CAAC,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACxB,OAAO,IAAqD,CAAC;IAC/D,CAAC;IAED,WAAW,CAAC,KAAa;QACvB,IAAI,CAAC,IAAI,CAAC,WAAW,GAAG,KAAK,CAAC;QAC9B,OAAO,IAA2D,CAAC;IACrE,CAAC;IAED,OAAO,CACL,OAAgC;QAEhC,IAAI,CAAC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QAC5B,OAAO,IAAuD,CAAC;IACjE,CAAC;IAED,MAAM,CAAC,KAAa;QAClB,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;QACzB,OAAO,IAAsD,CAAC;IAChE,CAAC;IAED,MAAM,CACJ,KAAsC;QAEtC,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;QACzB,OAAO,IAAsD,CAAC;IAChE,CAAC;IAED,6DAA6D;IAC7D,IAAI,CAAC,KAAuB;QAC1B,IAAI,CAAC,IAAI,CAAC,IAAI,GAAG,KAAK,CAAC;QACvB,OAAO,IAAoD,CAAC;IAC9D,CAAC;IAED,KAAK;QAGH,OAAO,IAAI,+BAAoB,CAAC,IAAI,CAAC,IAAwB,CAAC,CAAC;IACjE,CAAC;CACF;AAhDD,kDAgDC"}

package/dist/notifications/index.d.ts

@@ -1,6 +1,7 @@
 import { NotificationBuilder } from "./builder";
 import { internal } from "./internal";
 export { internal };
+export * from "./types";
 import type { NotificationCategoryInfo, NotificationSubjectInfo } from "./types";
 export declare function Notification(): NotificationBuilder;
 export declare function NotificationCategory(id: string, category: Omit<NotificationCategoryInfo, "id">): NotificationCategoryInfo;

package/dist/notifications/index.js

@@ -1,4 +1,18 @@
 "use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.AutomationSubject = exports.CollaborationSubject = exports.AccountSubject = exports.SecuritySubject = exports.GeneralSubject = exports.SystemCategory = exports.internal = void 0;
 exports.Notification = Notification;
@@ -7,6 +21,7 @@ exports.NotificationSubject = NotificationSubject;
 const builder_1 = require("./builder");
 const internal_1 = require("./internal");
 Object.defineProperty(exports, "internal", { enumerable: true, get: function () { return internal_1.internal; } });
+__exportStar(require("./types"), exports);
 function Notification() {
     return new builder_1.NotificationBuilder();
 }
@@ -35,6 +50,7 @@ exports.SystemCategory = NotificationCategory("system", {
 exports.GeneralSubject = NotificationSubject("general", {
     category: exports.SystemCategory,
     labelKey: "dms.notifications.subjects.general",
+    descriptionKey: "dms.notifications.subjects.general_desc",
     togglePermission: "forbidden",
 });
 exports.SecuritySubject = NotificationSubject("security", {

package/dist/notifications/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/notifications/index.ts"],"names":[],"mappings":";;;AASA,oCAEC;AAED,oDAUC;AAED,kDAUC;AAnCD,uCAAgD;AAChD,yCAAsC;AAE7B,yFAFA,mBAAQ,OAEA;AAMjB,SAAgB,YAAY;IAC1B,OAAO,IAAI,6BAAmB,EAAE,CAAC;AACnC,CAAC;AAED,SAAgB,oBAAoB,CAClC,EAAU,EACV,QAA8C;IAE9C,MAAM,oBAAoB,GAA6B;QACrD,EAAE;QACF,GAAG,QAAQ;KACZ,CAAC;IACF,mBAAQ,CAAC,4BAA4B,CAAC,QAAQ,CAAC,oBAAoB,CAAC,CAAC;IACrE,OAAO,oBAAoB,CAAC;AAC9B,CAAC;AAED,SAAgB,mBAAmB,CACjC,EAAU,EACV,OAA4C;IAE5C,MAAM,mBAAmB,GAA4B;QACnD,EAAE;QACF,GAAG,OAAO;KACX,CAAC;IACF,mBAAQ,CAAC,2BAA2B,CAAC,QAAQ,CAAC,mBAAmB,CAAC,CAAC;IACnE,OAAO,mBAAmB,CAAC;AAC7B,CAAC;AAEY,QAAA,cAAc,GAAG,oBAAoB,CAAC,QAAQ,EAAE;IAC3D,QAAQ,EAAE,qCAAqC;IAC/C,cAAc,EAAE,0CAA0C;IAC1D,IAAI,EAAE,WAAW;IACjB,gBAAgB,EAAE,SAAS;CAC5B,CAAC,CAAC;AAEU,QAAA,cAAc,GAAG,mBAAmB,CAAC,SAAS,EAAE;IAC3D,QAAQ,EAAE,sBAAc;IACxB,QAAQ,EAAE,oCAAoC;IAC9C,gBAAgB,EAAE,WAAW;CAC9B,CAAC,CAAC;AAEU,QAAA,eAAe,GAAG,mBAAmB,CAAC,UAAU,EAAE;IAC7D,QAAQ,EAAE,sBAAc;IACxB,QAAQ,EAAE,qCAAqC;IAC/C,cAAc,EAAE,0CAA0C;IAC1D,gBAAgB,EAAE,SAAS;CAC5B,CAAC,CAAC;AAEU,QAAA,cAAc,GAAG,mBAAmB,CAAC,SAAS,EAAE;IAC3D,QAAQ,EAAE,sBAAc;IACxB,QAAQ,EAAE,oCAAoC;IAC9C,cAAc,EAAE,yCAAyC;IACzD,gBAAgB,EAAE,SAAS;CAC5B,CAAC,CAAC;AAEU,QAAA,oBAAoB,GAAG,mBAAmB,CAAC,eAAe,EAAE;IACvE,QAAQ,EAAE,sBAAc;IACxB,QAAQ,EAAE,0CAA0C;IACpD,cAAc,EAAE,+CAA+C;IAC/D,gBAAgB,EAAE,SAAS;CAC5B,CAAC,CAAC;AAEU,QAAA,iBAAiB,GAAG,mBAAmB,CAAC,YAAY,EAAE;IACjE,QAAQ,EAAE,sBAAc;IACxB,QAAQ,EAAE,uCAAuC;IACjD,cAAc,EAAE,4CAA4C;IAC5D,gBAAgB,EAAE,SAAS;CAC5B,CAAC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/notifications/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAUA,oCAEC;AAED,oDAUC;AAED,kDAUC;AApCD,uCAAgD;AAChD,yCAAsC;AAE7B,yFAFA,mBAAQ,OAEA;AACjB,0CAAwB;AAMxB,SAAgB,YAAY;IAC1B,OAAO,IAAI,6BAAmB,EAAE,CAAC;AACnC,CAAC;AAED,SAAgB,oBAAoB,CAClC,EAAU,EACV,QAA8C;IAE9C,MAAM,oBAAoB,GAA6B;QACrD,EAAE;QACF,GAAG,QAAQ;KACZ,CAAC;IACF,mBAAQ,CAAC,4BAA4B,CAAC,QAAQ,CAAC,oBAAoB,CAAC,CAAC;IACrE,OAAO,oBAAoB,CAAC;AAC9B,CAAC;AAED,SAAgB,mBAAmB,CACjC,EAAU,EACV,OAA4C;IAE5C,MAAM,mBAAmB,GAA4B;QACnD,EAAE;QACF,GAAG,OAAO;KACX,CAAC;IACF,mBAAQ,CAAC,2BAA2B,CAAC,QAAQ,CAAC,mBAAmB,CAAC,CAAC;IACnE,OAAO,mBAAmB,CAAC;AAC7B,CAAC;AAEY,QAAA,cAAc,GAAG,oBAAoB,CAAC,QAAQ,EAAE;IAC3D,QAAQ,EAAE,qCAAqC;IAC/C,cAAc,EAAE,0CAA0C;IAC1D,IAAI,EAAE,WAAW;IACjB,gBAAgB,EAAE,SAAS;CAC5B,CAAC,CAAC;AAEU,QAAA,cAAc,GAAG,mBAAmB,CAAC,SAAS,EAAE;IAC3D,QAAQ,EAAE,sBAAc;IACxB,QAAQ,EAAE,oCAAoC;IAC9C,cAAc,EAAE,yCAAyC;IACzD,gBAAgB,EAAE,WAAW;CAC9B,CAAC,CAAC;AAEU,QAAA,eAAe,GAAG,mBAAmB,CAAC,UAAU,EAAE;IAC7D,QAAQ,EAAE,sBAAc;IACxB,QAAQ,EAAE,qCAAqC;IAC/C,cAAc,EAAE,0CAA0C;IAC1D,gBAAgB,EAAE,SAAS;CAC5B,CAAC,CAAC;AAEU,QAAA,cAAc,GAAG,mBAAmB,CAAC,SAAS,EAAE;IAC3D,QAAQ,EAAE,sBAAc;IACxB,QAAQ,EAAE,oCAAoC;IAC9C,cAAc,EAAE,yCAAyC;IACzD,gBAAgB,EAAE,SAAS;CAC5B,CAAC,CAAC;AAEU,QAAA,oBAAoB,GAAG,mBAAmB,CAAC,eAAe,EAAE;IACvE,QAAQ,EAAE,sBAAc;IACxB,QAAQ,EAAE,0CAA0C;IACpD,cAAc,EAAE,+CAA+C;IAC/D,gBAAgB,EAAE,SAAS;CAC5B,CAAC,CAAC;AAEU,QAAA,iBAAiB,GAAG,mBAAmB,CAAC,YAAY,EAAE;IACjE,QAAQ,EAAE,sBAAc;IACxB,QAAQ,EAAE,uCAAuC;IACjD,cAAc,EAAE,4CAA4C;IAC5D,gBAAgB,EAAE,SAAS;CAC5B,CAAC,CAAC"}

package/dist/notifications/internal.d.ts

@@ -1,11 +1,14 @@
 import { RegisteringProxy } from "@antelopejs/interface-core";
-import type { NotificationCategoryInfo, NotificationData, NotificationSubjectInfo, ReadScope } from "./types";
+import type { DeliveryOptions, NotificationCategoryInfo, NotificationData, NotificationSubjectInfo, ReadScope } from "./types";
+/**
+ * @internal
+ */
 export declare namespace internal {
     const SupportsIdempotency: () => Promise<boolean>;
     const RegisterNotificationCategory: RegisteringProxy<(info: NotificationCategoryInfo) => void>;
     const RegisterNotificationSubject: RegisteringProxy<(info: NotificationSubjectInfo) => void>;
-    const SendToUser: (userId: string, data: NotificationData, groupId?: string | undefined, idempotencyKey?: string | undefined) => Promise<void>;
-    const SendToUsers: (userIds: string[], data: NotificationData, readScope?: ReadScope | undefined, idempotencyKey?: string | undefined) => Promise<void>;
-    const SendToRoles: (roleIds: string[], data: NotificationData, readScope?: ReadScope | undefined, idempotencyKey?: string | undefined) => Promise<void>;
-    const SendToAll: (data: NotificationData, readScope?: ReadScope | undefined, idempotencyKey?: string | undefined) => Promise<void>;
+    const SendToUser: (userId: string, data: NotificationData, groupId?: string | undefined, idempotencyKey?: string | undefined, delivery?: DeliveryOptions | undefined) => Promise<void>;
+    const SendToUsers: (userIds: string[], data: NotificationData, readScope?: ReadScope | undefined, idempotencyKey?: string | undefined, delivery?: DeliveryOptions | undefined) => Promise<void>;
+    const SendToRoles: (roleIds: string[], data: NotificationData, readScope?: ReadScope | undefined, idempotencyKey?: string | undefined, delivery?: DeliveryOptions | undefined) => Promise<void>;
+    const SendToAll: (data: NotificationData, readScope?: ReadScope | undefined, idempotencyKey?: string | undefined, delivery?: DeliveryOptions | undefined) => Promise<void>;
 }

package/dist/notifications/internal.js

@@ -2,6 +2,12 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.internal = void 0;
 const interface_core_1 = require("@antelopejs/interface-core");
+// On its own rather than in index.ts: sendable.ts sends through these proxies
+// and index.ts imports the builder that imports sendable, so reading them from
+// the barrel closed a cycle.
+/**
+ * @internal
+ */
 var internal;
 (function (internal) {
     internal.SupportsIdempotency = (0, interface_core_1.InterfaceFunction)();

package/dist/notifications/internal.js.map

@@ -1 +1 @@
-{"version":3,"file":"internal.js","sourceRoot":"","sources":["../../src/notifications/internal.ts"],"names":[],"mappings":";;;AAAA,+DAGoC;AAepC,IAAiB,QAAQ,CAiDxB;AAjDD,WAAiB,QAAQ;IACV,4BAAmB,GAC9B,IAAA,kCAAiB,GAA0B,CAAC;IAEjC,qCAA4B,GAAG,IAAI,iCAAgB,EAE7D,CAAC;IACS,oCAA2B,GAAG,IAAI,iCAAgB,EAE5D,CAAC;IAES,mBAAU,GACrB,IAAA,kCAAiB,GAOd,CAAC;IAEO,oBAAW,GACtB,IAAA,kCAAiB,GAOd,CAAC;IAEO,oBAAW,GACtB,IAAA,kCAAiB,GAOd,CAAC;IAEO,kBAAS,GACpB,IAAA,kCAAiB,GAMd,CAAC;AACR,CAAC,EAjDgB,QAAQ,wBAAR,QAAQ,QAiDxB"}
+{"version":3,"file":"internal.js","sourceRoot":"","sources":["../../src/notifications/internal.ts"],"names":[],"mappings":";;;AAAA,+DAGoC;AASpC,8EAA8E;AAC9E,+EAA+E;AAC/E,6BAA6B;AAE7B;;GAEG;AACH,IAAiB,QAAQ,CAqDxB;AArDD,WAAiB,QAAQ;IACV,4BAAmB,GAC9B,IAAA,kCAAiB,GAA0B,CAAC;IAEjC,qCAA4B,GAAG,IAAI,iCAAgB,EAE7D,CAAC;IACS,oCAA2B,GAAG,IAAI,iCAAgB,EAE5D,CAAC;IAES,mBAAU,GACrB,IAAA,kCAAiB,GAQd,CAAC;IAEO,oBAAW,GACtB,IAAA,kCAAiB,GAQd,CAAC;IAEO,oBAAW,GACtB,IAAA,kCAAiB,GAQd,CAAC;IAEO,kBAAS,GACpB,IAAA,kCAAiB,GAOd,CAAC;AACR,CAAC,EArDgB,QAAQ,wBAAR,QAAQ,QAqDxB"}

package/dist/notifications/sendable.d.ts

@@ -2,8 +2,14 @@ import type { NotificationData, SendOptions } from "./types";
 export declare class SendableNotification {
     private readonly data;
     constructor(data: NotificationData);
+    /**
+     * Sends to one recipient, optionally deduplicating a stable event key. A
+     * repeat of what the recipient received in the last 10 seconds is dropped
+     * unless `dedupe: false` (see {@link DeliveryOptions}).
+     */
     toUser(userId: string, options?: SendOptions): Promise<void>;
     toUsers(userIds: string[], options?: SendOptions): Promise<void>;
+    /** Explicit capability for durable outbox delivery; older DMS versions do not expose this method. */
     toUsersIdempotently(userIds: string[], idempotencyKey: string, options?: SendOptions): Promise<void>;
     toRoles(roleIds: string[], options?: SendOptions): Promise<void>;
     broadcast(options?: SendOptions): Promise<void>;

package/dist/notifications/sendable.js

@@ -2,29 +2,38 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SendableNotification = void 0;
 const internal_1 = require("./internal");
+function deliveryOf(options) {
+    return { dedupe: options.dedupe };
+}
 class SendableNotification {
     data;
     constructor(data) {
         this.data = Object.freeze({ ...data });
     }
+    /**
+     * Sends to one recipient, optionally deduplicating a stable event key. A
+     * repeat of what the recipient received in the last 10 seconds is dropped
+     * unless `dedupe: false` (see {@link DeliveryOptions}).
+     */
     async toUser(userId, options = {}) {
         await this.requireIdempotencySupport(options);
-        await internal_1.internal.SendToUser(userId, this.data, undefined, options.idempotencyKey);
+        await internal_1.internal.SendToUser(userId, this.data, undefined, options.idempotencyKey, deliveryOf(options));
     }
     async toUsers(userIds, options = {}) {
         await this.requireIdempotencySupport(options);
-        await internal_1.internal.SendToUsers(userIds, this.data, options.readScope, options.idempotencyKey);
+        await internal_1.internal.SendToUsers(userIds, this.data, options.readScope, options.idempotencyKey, deliveryOf(options));
     }
+    /** Explicit capability for durable outbox delivery; older DMS versions do not expose this method. */
     async toUsersIdempotently(userIds, idempotencyKey, options = {}) {
         await this.toUsers(userIds, { ...options, idempotencyKey });
     }
     async toRoles(roleIds, options = {}) {
         await this.requireIdempotencySupport(options);
-        await internal_1.internal.SendToRoles(roleIds, this.data, options.readScope, options.idempotencyKey);
+        await internal_1.internal.SendToRoles(roleIds, this.data, options.readScope, options.idempotencyKey, deliveryOf(options));
     }
     async broadcast(options = {}) {
         await this.requireIdempotencySupport(options);
-        await internal_1.internal.SendToAll(this.data, options.readScope, options.idempotencyKey);
+        await internal_1.internal.SendToAll(this.data, options.readScope, options.idempotencyKey, deliveryOf(options));
     }
     async requireIdempotencySupport(options) {
         if (options.idempotencyKey === undefined)

package/dist/notifications/sendable.js.map

@@ -1 +1 @@
-{"version":3,"file":"sendable.js","sourceRoot":"","sources":["../../src/notifications/sendable.ts"],"names":[],"mappings":";;;AAAA,yCAAsC;AAGtC,MAAa,oBAAoB;IACd,IAAI,CAAmB;IAExC,YAAY,IAAsB;QAChC,IAAI,CAAC,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,IAAI,EAAE,CAAqB,CAAC;IAC7D,CAAC;IAGD,KAAK,CAAC,MAAM,CAAC,MAAc,EAAE,UAAuB,EAAE;QACpD,MAAM,IAAI,CAAC,yBAAyB,CAAC,OAAO,CAAC,CAAC;QAC9C,MAAM,mBAAQ,CAAC,UAAU,CACvB,MAAM,EACN,IAAI,CAAC,IAAI,EACT,SAAS,EACT,OAAO,CAAC,cAAc,CACvB,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,OAAiB,EAAE,UAAuB,EAAE;QACxD,MAAM,IAAI,CAAC,yBAAyB,CAAC,OAAO,CAAC,CAAC;QAC9C,MAAM,mBAAQ,CAAC,WAAW,CACxB,OAAO,EACP,IAAI,CAAC,IAAI,EACT,OAAO,CAAC,SAAS,EACjB,OAAO,CAAC,cAAc,CACvB,CAAC;IACJ,CAAC;IAGD,KAAK,CAAC,mBAAmB,CACvB,OAAiB,EACjB,cAAsB,EACtB,UAAuB,EAAE;QAEzB,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,GAAG,OAAO,EAAE,cAAc,EAAE,CAAC,CAAC;IAC9D,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,OAAiB,EAAE,UAAuB,EAAE;QACxD,MAAM,IAAI,CAAC,yBAAyB,CAAC,OAAO,CAAC,CAAC;QAC9C,MAAM,mBAAQ,CAAC,WAAW,CACxB,OAAO,EACP,IAAI,CAAC,IAAI,EACT,OAAO,CAAC,SAAS,EACjB,OAAO,CAAC,cAAc,CACvB,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,UAAuB,EAAE;QACvC,MAAM,IAAI,CAAC,yBAAyB,CAAC,OAAO,CAAC,CAAC;QAC9C,MAAM,mBAAQ,CAAC,SAAS,CACtB,IAAI,CAAC,IAAI,EACT,OAAO,CAAC,SAAS,EACjB,OAAO,CAAC,cAAc,CACvB,CAAC;IACJ,CAAC;IAEO,KAAK,CAAC,yBAAyB,CAAC,OAAoB;QAC1D,IAAI,OAAO,CAAC,cAAc,KAAK,SAAS;YAAE,OAAO;QACjD,IAAI,CAAC,MAAM,mBAAQ,CAAC,mBAAmB,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC;YACpD,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;QACzE,CAAC;IACH,CAAC;CACF;AA9DD,oDA8DC"}
+{"version":3,"file":"sendable.js","sourceRoot":"","sources":["../../src/notifications/sendable.ts"],"names":[],"mappings":";;;AAAA,yCAAsC;AAGtC,SAAS,UAAU,CAAC,OAAoB;IACtC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC;AACpC,CAAC;AAED,MAAa,oBAAoB;IACd,IAAI,CAAmB;IAExC,YAAY,IAAsB;QAChC,IAAI,CAAC,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,IAAI,EAAE,CAAqB,CAAC;IAC7D,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,MAAM,CAAC,MAAc,EAAE,UAAuB,EAAE;QACpD,MAAM,IAAI,CAAC,yBAAyB,CAAC,OAAO,CAAC,CAAC;QAC9C,MAAM,mBAAQ,CAAC,UAAU,CACvB,MAAM,EACN,IAAI,CAAC,IAAI,EACT,SAAS,EACT,OAAO,CAAC,cAAc,EACtB,UAAU,CAAC,OAAO,CAAC,CACpB,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,OAAiB,EAAE,UAAuB,EAAE;QACxD,MAAM,IAAI,CAAC,yBAAyB,CAAC,OAAO,CAAC,CAAC;QAC9C,MAAM,mBAAQ,CAAC,WAAW,CACxB,OAAO,EACP,IAAI,CAAC,IAAI,EACT,OAAO,CAAC,SAAS,EACjB,OAAO,CAAC,cAAc,EACtB,UAAU,CAAC,OAAO,CAAC,CACpB,CAAC;IACJ,CAAC;IAED,qGAAqG;IACrG,KAAK,CAAC,mBAAmB,CACvB,OAAiB,EACjB,cAAsB,EACtB,UAAuB,EAAE;QAEzB,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,GAAG,OAAO,EAAE,cAAc,EAAE,CAAC,CAAC;IAC9D,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,OAAiB,EAAE,UAAuB,EAAE;QACxD,MAAM,IAAI,CAAC,yBAAyB,CAAC,OAAO,CAAC,CAAC;QAC9C,MAAM,mBAAQ,CAAC,WAAW,CACxB,OAAO,EACP,IAAI,CAAC,IAAI,EACT,OAAO,CAAC,SAAS,EACjB,OAAO,CAAC,cAAc,EACtB,UAAU,CAAC,OAAO,CAAC,CACpB,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,UAAuB,EAAE;QACvC,MAAM,IAAI,CAAC,yBAAyB,CAAC,OAAO,CAAC,CAAC;QAC9C,MAAM,mBAAQ,CAAC,SAAS,CACtB,IAAI,CAAC,IAAI,EACT,OAAO,CAAC,SAAS,EACjB,OAAO,CAAC,cAAc,EACtB,UAAU,CAAC,OAAO,CAAC,CACpB,CAAC;IACJ,CAAC;IAEO,KAAK,CAAC,yBAAyB,CAAC,OAAoB;QAC1D,IAAI,OAAO,CAAC,cAAc,KAAK,SAAS;YAAE,OAAO;QACjD,IAAI,CAAC,MAAM,mBAAQ,CAAC,mBAAmB,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC;YACpD,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;QACzE,CAAC;IACH,CAAC;CACF;AAtED,oDAsEC"}

package/dist/notifications/types.d.ts

@@ -1,11 +1,19 @@
+import type { Tone } from "../base/types/tone";
 export type TogglePermission = "allowed" | "forbidden" | "default";
 export type ReadScope = "individual" | "shared";
+/**
+ * Colour of the icon well a notification is listed with. The former `accent`
+ * is still read as `primary` in 0.4, with a warning.
+ */
+export type NotificationTone = Extract<Tone, "neutral" | "primary" | "success" | "warning" | "error">;
 export interface NotificationCategoryInfo {
     id: string;
     labelKey: string;
     descriptionKey?: string;
     icon: string;
     togglePermission?: TogglePermission;
+    /** Translation key of a short module tag (`SaaS`) shown next to the category and on its notifications. */
+    tagKey?: string;
 }
 export interface NotificationSubjectInfo {
     id: string;
@@ -13,9 +21,24 @@ export interface NotificationSubjectInfo {
     labelKey: string;
     descriptionKey?: string;
     togglePermission?: TogglePermission;
+    /** Translation key of a badge shown next to the subject label (`Developer mode`). */
+    badgeKey?: string;
 }
-export interface SendOptions {
+/** How a delivery is stored, whoever receives it. */
+export interface DeliveryOptions {
+    /**
+     * By default, a notification identical to one the same recipient received
+     * less than 10 seconds before is not stored again: a form submitted twice,
+     * a hook firing on every instance, a retried request. Identical means the
+     * same title, description, params, link, category, subject, tone and icon.
+     * `false` stores every send. A keyed send (`idempotencyKey`) is stored once
+     * per key either way.
+     */
+    dedupe?: boolean;
+}
+export interface SendOptions extends DeliveryOptions {
     readScope?: ReadScope;
+    /** Stable event key, unique across notification producers. Retries preserve delivery and dismissal state. */
     idempotencyKey?: string;
 }
 export interface NotificationData {
@@ -25,5 +48,7 @@ export interface NotificationData {
     subject: NotificationSubjectInfo;
     linkTo?: string;
     params?: Record<string, string | number>;
+    /** Icon well colour; unset notifications use `primary` while unread, neutral once read. */
+    tone?: NotificationTone;
 }
 export type RequiredFields = "icon" | "title" | "description" | "subject";

package/dist/page/categories.d.ts

@@ -1,32 +1,40 @@
 import type { ControllerClass } from "@antelopejs/interface-api";
 import { RegisteringProxy } from "@antelopejs/interface-core";
-import { type RegistrationIdentity } from "./registry";
-import { type CategoryInfo, type DynamicMenuProviderInfo, type MenuOptions, type ModuleInfo, type PageExtensionInfo, type PageInfo } from "./types";
+import { type RegistrationIdentity } from "./internal/registry";
+import type { CategoryInfo, DynamicMenuProviderInfo, ModuleInfo, PageExtensionInfo, PageInfo } from "./types";
+/**
+ * A registration proxy that accepts a per-context view of its entries.
+ *
+ * `RegisteringProxy` looks its entries up by object reference, and anything
+ * that crossed the interface boundary comes back as a view of itself. A caller
+ * unregistering with the object it holds — a module tearing its pages down, or
+ * a test holding `metadata.pageInfo` — would match nothing, and the page would
+ * stay in the registry, routed and still serving. Every entry point resolves
+ * the view back to the reference the registration was filed under first.
+ */
 declare class IdentifiedRegisteringProxy<T extends object> extends RegisteringProxy<(value: T) => void> {
     private readonly identity;
     constructor(identity: RegistrationIdentity<T>);
     register(value: T): void;
     unregister(value: T): void;
 }
+/**
+ * Captures the registering module's context before the extension reaches the
+ * DMS, which applies it -- now and on every later sync -- from its own.
+ */
 declare class PageExtensionRegisteringProxy extends IdentifiedRegisteringProxy<PageExtensionInfo> {
     constructor();
     register(value: PageExtensionInfo): void;
 }
+/**
+ * @internal
+ */
 export declare namespace internal {
     const RegisterCategory: IdentifiedRegisteringProxy<CategoryInfo>;
     const RegisterPage: IdentifiedRegisteringProxy<PageInfo>;
     const RegisterModule: IdentifiedRegisteringProxy<ModuleInfo>;
     const RegisterDynamicMenuProvider: IdentifiedRegisteringProxy<DynamicMenuProviderInfo>;
     const RegisterPageExtension: PageExtensionRegisteringProxy;
-    function clearModuleResolution(id: string): void;
-    function applyPageExtension(info: PageExtensionInfo): void;
-    function revokePageExtension(info: PageExtensionInfo): void;
-    function clearPageMetadata(fullId: string, expected?: PageInfo): void;
-    interface RootCategoryOptions extends Omit<MenuOptions, "category"> {
-        category?: CategoryInfo | ControllerClass;
-        isModuleRoot?: boolean;
-    }
-    function RootCategory(id: string, options: RootCategoryOptions): CategoryInfo;
 }
 interface ModuleEntry {
     module?: string;
@@ -34,10 +42,4 @@ interface ModuleEntry {
     isModuleRoot?: boolean;
 }
 export declare function isInsideModule(entry: ModuleEntry): boolean;
-export declare function resolveCategoryInfo(category: CategoryInfo | ControllerClass | undefined): CategoryInfo | undefined;
-export declare function calculateFullSlug(id: string, options: MenuOptions | internal.RootCategoryOptions): string;
-export declare function validateNotInsideSettings(moduleId: string | undefined, resolved: CategoryInfo | undefined): void;
-export declare function createCategoryFunction(id: string, options: internal.RootCategoryOptions): CategoryInfo;
-export declare function createCategoryFunction(id: string, options: MenuOptions): CategoryInfo;
-export declare function applyModuleResolution(id: string, options: MenuOptions): MenuOptions;
 export {};

package/dist/page/categories.js

@@ -2,18 +2,23 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.internal = void 0;
 exports.isInsideModule = isInsideModule;
-exports.resolveCategoryInfo = resolveCategoryInfo;
-exports.calculateFullSlug = calculateFullSlug;
-exports.validateNotInsideSettings = validateNotInsideSettings;
-exports.createCategoryFunction = createCategoryFunction;
-exports.applyModuleResolution = applyModuleResolution;
 const interface_core_1 = require("@antelopejs/interface-core");
-const logging_1 = require("@antelopejs/interface-core/logging");
-const fire_and_forget_1 = require("../utils/fire-and-forget");
-const permissions_1 = require("../permissions");
-const metadata_1 = require("./metadata");
-const registry_1 = require("./registry");
-const types_1 = require("./types");
+const registry_1 = require("./internal/registry");
+// Category creation in internal/categories registers through the proxies
+// declared here, and isInsideModule resolves categories through it: neither
+// module dereferences the other while it evaluates.
+// oxlint-disable-next-line import/no-cycle
+const categories_1 = require("./internal/categories");
+/**
+ * A registration proxy that accepts a per-context view of its entries.
+ *
+ * `RegisteringProxy` looks its entries up by object reference, and anything
+ * that crossed the interface boundary comes back as a view of itself. A caller
+ * unregistering with the object it holds — a module tearing its pages down, or
+ * a test holding `metadata.pageInfo` — would match nothing, and the page would
+ * stay in the registry, routed and still serving. Every entry point resolves
+ * the view back to the reference the registration was filed under first.
+ */
 class IdentifiedRegisteringProxy extends interface_core_1.RegisteringProxy {
     identity;
     constructor(identity) {
@@ -30,6 +35,10 @@ class IdentifiedRegisteringProxy extends interface_core_1.RegisteringProxy {
         super.unregister(registered);
     }
 }
+/**
+ * Captures the registering module's context before the extension reaches the
+ * DMS, which applies it -- now and on every later sync -- from its own.
+ */
 class PageExtensionRegisteringProxy extends IdentifiedRegisteringProxy {
     constructor() {
         super(registry_1.pageExtensionIdentity);
@@ -39,6 +48,9 @@ class PageExtensionRegisteringProxy extends IdentifiedRegisteringProxy {
         super.register(value);
     }
 }
+/**
+ * @internal
+ */
 var internal;
 (function (internal) {
     internal.RegisterCategory = new IdentifiedRegisteringProxy(registry_1.categoryIdentity);
@@ -46,48 +58,6 @@ var internal;
     internal.RegisterModule = new IdentifiedRegisteringProxy(registry_1.moduleIdentity);
     internal.RegisterDynamicMenuProvider = new IdentifiedRegisteringProxy(registry_1.dynamicMenuProviderIdentity);
     internal.RegisterPageExtension = new PageExtensionRegisteringProxy();
-    function clearModuleResolution(id) {
-        registry_1.moduleRootCategories.delete(id);
-        registry_1.moduleDefaultCategories.delete(id);
-    }
-    internal.clearModuleResolution = clearModuleResolution;
-    function applyPageExtension(info) {
-        const registered = registry_1.pageExtensions.get(info.targetFullId) ?? [];
-        registered.push(info);
-        registry_1.pageExtensions.set(info.targetFullId, registered);
-        if (!(0, registry_1.acceptsPageExtensions)(info.targetFullId)) {
-            logging_1.Logging.Info(`[dms] page extension "${info.extensionName}" is waiting for page "${info.targetFullId}" to finish registering`);
-        }
-        (0, fire_and_forget_1.fireAndForget)((0, registry_1.syncTargetExtensions)(info.targetFullId), `page extension "${info.extensionName}"`);
-    }
-    internal.applyPageExtension = applyPageExtension;
-    function revokePageExtension(info) {
-        const registered = registry_1.pageExtensions.get(info.targetFullId);
-        if (!registered)
-            return;
-        const remaining = registered.filter((entry) => !registry_1.pageExtensionIdentity.isSame(entry, info));
-        if (remaining.length === 0) {
-            registry_1.pageExtensions.delete(info.targetFullId);
-        }
-        else {
-            registry_1.pageExtensions.set(info.targetFullId, remaining);
-        }
-        (0, fire_and_forget_1.fireAndForget)((0, registry_1.syncTargetExtensions)(info.targetFullId), `page extension "${info.extensionName}" teardown`);
-    }
-    internal.revokePageExtension = revokePageExtension;
-    function clearPageMetadata(fullId, expected) {
-        const metadata = registry_1.pageMetadataByFullId.get(fullId);
-        if (!metadata)
-            return;
-        if (expected && !(0, registry_1.isSamePageRegistration)(metadata.pageInfo, expected))
-            return;
-        metadata.Dispose();
-    }
-    internal.clearPageMetadata = clearPageMetadata;
-    function RootCategory(id, options) {
-        return createCategoryFunction(id, options);
-    }
-    internal.RootCategory = RootCategory;
 })(internal || (exports.internal = internal = {}));
 function isInsideModule(entry) {
     if (entry.isModuleRoot)
@@ -96,7 +66,7 @@ function isInsideModule(entry) {
         return true;
     let current = entry.category;
     while (current) {
-        const resolved = resolveCategoryInfo(current);
+        const resolved = (0, categories_1.resolveCategoryInfo)(current);
         if (!resolved)
             return false;
         if (resolved.isModuleRoot)
@@ -105,118 +75,4 @@ function isInsideModule(entry) {
     }
     return false;
 }
-function resolveCategoryInfo(category) {
-    if (!category) {
-        return undefined;
-    }
-    if (typeof category === "function") {
-        const meta = (0, interface_core_1.GetMetadata)(category, metadata_1.PageMetadata);
-        if (!meta.pageInfo) {
-            throw new Error(`PageMetadata not initialized for controller class.`);
-        }
-        return meta.pageInfo;
-    }
-    return category;
-}
-function calculateFullSlug(id, options) {
-    const resolvedCategory = resolveCategoryInfo(options.category);
-    const parentSlug = resolvedCategory?.fullSlug || "";
-    const urlSlug = options.urlSlug || id;
-    let fullSlug = parentSlug ? `${parentSlug}/${urlSlug}` : `/${urlSlug}`;
-    fullSlug = fullSlug.replace(/\/+/g, "/");
-    if (fullSlug !== "/" && fullSlug.endsWith("/")) {
-        fullSlug = fullSlug.slice(0, -1);
-    }
-    return fullSlug;
-}
-function isCategoryDescendantOf(candidate, ancestorFullId) {
-    let current = candidate;
-    while (current) {
-        const resolved = resolveCategoryInfo(current);
-        if (!resolved)
-            return false;
-        if (resolved.fullId === ancestorFullId)
-            return true;
-        current = resolved.category;
-    }
-    return false;
-}
-function resolveCategoryFromOptions(id, options) {
-    if (options.category) {
-        if (options.module) {
-            validateExplicitCategoryMatchesModule(id, options.category, options.module);
-        }
-        return options.category;
-    }
-    if (options.module) {
-        const moduleRoot = registry_1.moduleRootCategories.get(options.module);
-        if (!moduleRoot) {
-            throw new Error(`"${id}" references unknown module "${options.module}". Make sure RegisterModule was called before registration.`);
-        }
-        return registry_1.moduleDefaultCategories.get(options.module) ?? moduleRoot;
-    }
-    return undefined;
-}
-function validateExplicitCategoryMatchesModule(id, category, moduleId) {
-    const moduleRoot = registry_1.moduleRootCategories.get(moduleId);
-    if (!moduleRoot) {
-        throw new Error(`Page "${id}" references unknown module "${moduleId}". Make sure RegisterModule was called before page registration.`);
-    }
-    const resolved = resolveCategoryInfo(category);
-    if (!isCategoryDescendantOf(resolved, moduleRoot.fullId)) {
-        throw new Error(`Page "${id}" declares module "${moduleId}" but its explicit category is not a descendant of that module's root.`);
-    }
-}
-const SETTINGS_ROOT_FULL_ID = "settings";
-function validateNotInsideSettings(moduleId, resolved) {
-    if (!moduleId || !resolved)
-        return;
-    if (isCategoryDescendantOf(resolved, SETTINGS_ROOT_FULL_ID)) {
-        throw new Error(`Pages of module "${moduleId}" cannot use the settings category — declare a settings page inside your module instead.`);
-    }
-}
-function createCategoryFunction(id, options) {
-    const hasModuleField = "module" in options && options.module !== undefined;
-    const effectiveOptions = hasModuleField
-        ? applyModuleResolution(id, options)
-        : options;
-    const category = effectiveOptions.category;
-    const resolvedCategory = resolveCategoryInfo(category);
-    if (hasModuleField) {
-        validateNotInsideSettings(effectiveOptions.module, resolvedCategory);
-    }
-    const parentFullId = resolvedCategory?.fullId || "";
-    const fullId = parentFullId ? `${parentFullId}.${id}` : id;
-    const fullSlug = calculateFullSlug(id, effectiveOptions);
-    const categoryInfo = {
-        ...effectiveOptions,
-        category: resolvedCategory,
-        id,
-        fullId,
-        fullSlug,
-        urlTransparent: fullSlug === (resolvedCategory?.fullSlug || types_1.ROOT_SLUG),
-        hidden: effectiveOptions.hidden || resolvedCategory?.hidden,
-        bypassTenantAccessGate: effectiveOptions.bypassTenantAccessGate ||
-            resolvedCategory?.bypassTenantAccessGate,
-    };
-    internal.RegisterCategory.register(categoryInfo);
-    const categoryPermission = {
-        id: categoryInfo.fullId,
-        title: categoryInfo.displayName,
-        icon: categoryInfo.icon,
-        defaultGranted: categoryInfo.publicAccess,
-        ...categoryInfo.permission,
-    };
-    if (isInsideModule(categoryInfo)) {
-        (0, permissions_1.MarkModuleScopedPermission)(categoryPermission.id);
-    }
-    else {
-        (0, permissions_1.RegisterPermission)(categoryPermission.id, categoryPermission);
-    }
-    return categoryInfo;
-}
-function applyModuleResolution(id, options) {
-    const resolvedReference = resolveCategoryFromOptions(id, options);
-    return { ...options, category: resolvedReference };
-}
 //# sourceMappingURL=categories.js.map

package/dist/page/categories.js.map

@@ -1 +1 @@
-{"version":3,"file":"categories.js","sourceRoot":"","sources":["../../src/page/categories.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"categories.js","sourceRoot":"","sources":["../../src/page/categories.ts"],"names":[],"mappings":";;;AA+FA,wCAWC;AAzGD,+DAA8D;AAC9D,kDAQ6B;AAQ7B,yEAAyE;AACzE,4EAA4E;AAC5E,oDAAoD;AACpD,2CAA2C;AAC3C,sDAA4D;AAE5D;;;;;;;;;GASG;AACH,MAAM,0BAA6C,SAAQ,iCAE1D;IAC8B;IAA7B,YAA6B,QAAiC;QAC5D,KAAK,EAAE,CAAC;QADmB,aAAQ,GAAR,QAAQ,CAAyB;IAE9D,CAAC;IAEQ,QAAQ,CAAC,KAAQ;QACxB,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QAC9B,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IACxB,CAAC;IAEQ,UAAU,CAAC,KAAQ;QAC1B,MAAM,UAAU,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QAChD,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;QACjC,KAAK,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;IAC/B,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,6BAA8B,SAAQ,0BAA6C;IACvF;QACE,KAAK,CAAC,gCAAqB,CAAC,CAAC;IAC/B,CAAC;IAEQ,QAAQ,CAAC,KAAwB;QACxC,IAAA,sCAA2B,EAAC,KAAK,CAAC,CAAC;QACnC,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IACxB,CAAC;CACF;AAED;;GAEG;AACH,IAAiB,QAAQ,CAgBxB;AAhBD,WAAiB,QAAQ;IACV,yBAAgB,GAAG,IAAI,0BAA0B,CAC5D,2BAAgB,CACjB,CAAC;IACW,qBAAY,GAAG,IAAI,0BAA0B,CACxD,uBAAY,CACb,CAAC;IACW,uBAAc,GAAG,IAAI,0BAA0B,CAC1D,yBAAc,CACf,CAAC;IACW,oCAA2B,GACtC,IAAI,0BAA0B,CAC5B,sCAA2B,CAC5B,CAAC;IAES,8BAAqB,GAAG,IAAI,6BAA6B,EAAE,CAAC;AAC3E,CAAC,EAhBgB,QAAQ,wBAAR,QAAQ,QAgBxB;AAQD,SAAgB,cAAc,CAAC,KAAkB;IAC/C,IAAI,KAAK,CAAC,YAAY;QAAE,OAAO,IAAI,CAAC;IACpC,IAAI,KAAK,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC;IAC9B,IAAI,OAAO,GAA+C,KAAK,CAAC,QAAQ,CAAC;IACzE,OAAO,OAAO,EAAE,CAAC;QACf,MAAM,QAAQ,GAAG,IAAA,gCAAmB,EAAC,OAAO,CAAC,CAAC;QAC9C,IAAI,CAAC,QAAQ;YAAE,OAAO,KAAK,CAAC;QAC5B,IAAI,QAAQ,CAAC,YAAY;YAAE,OAAO,IAAI,CAAC;QACvC,OAAO,GAAG,QAAQ,CAAC,QAAQ,CAAC;IAC9B,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}