@warlock.js/notifications 4.2.0

package/esm/in-app/in-app.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"in-app.d.mts","names":[],"sources":["../../../../../../../@warlock.js/notifications/src/in-app/in-app.ts"],"mappings":";;;;;;;;;;;;KA4CY,wBAAA,GAA2B,+BAA+B,CAAC,mBAAA;;;;;;KAO3D,gBAAA;EACN,KAAA,EAAO,sBAAA;EAAwB,UAAA;AAAA;EAC/B,UAAA,EAAY,2BAA2B;EAAE,KAAA;AAAA;AAAA,cAKzC,KAAA;EAAA,QACI,IAAA;EA0D+B;;;;EApDhC,SAAA,CAAU,OAAA,EAAS,gBAAA,GAAmB,OAAA,CAAQ,eAAA;EAAA,YAQzC,UAAA;EARL;EAmBA,IAAA,CAAK,SAAA,EAAW,UAAA,GAAa,EAAA,EAAI,OAAA,GAAU,wBAAA;EAnBjC;EAwBV,UAAA,CAAW,SAAA,EAAW,UAAA,GAAa,EAAA,EAAI,OAAA,GAAU,wBAAA;EAxBH;;;;EAgC9C,WAAA,CAAY,SAAA,EAAW,UAAA,GAAa,EAAA;EAb/B;EAkBL,IAAA,CAAK,SAAA,EAAW,UAAA,GAAa,EAAA,EAAI,EAAA,EAAI,EAAA,GAAE,OAAA,CAAA,oBAAA;EAlBN;EAuBjC,UAAA,CAAW,SAAA,EAAW,UAAA,GAAa,EAAA,EAAI,EAAA,GAAK,EAAA,GAAE,OAAA;EAlBxB;EAuBtB,YAAA,CAAa,SAAA,EAAW,UAAA,GAAa,EAAA,EAAI,EAAA,GAAK,EAAA,GAAE,OAAA;EAvBrC;EA4BX,OAAA,CAAQ,SAAA,EAAW,UAAA,GAAa,EAAA,EAAI,EAAA,GAAK,EAAA,GAAE,OAAA;AAAA;;cAMvC,KAAA,EAAK,KAAc"}

package/esm/in-app/in-app.mjs

@@ -0,0 +1,67 @@
+import { databaseChannel } from "../channels/database-channel.mjs";
+import { BaseNotificationsRepository } from "./base-notifications-repository.mjs";
+
+//#region ../@warlock.js/notifications/src/in-app/in-app.ts
+const idOf = (recipient) => typeof recipient === "object" ? recipient.id : recipient;
+var InApp = class {
+	repo;
+	/**
+	* Bind the in-app store AND return the `database` channel. Called once
+	* from `config/notifications.ts`. Subsequent calls REPLACE the binding.
+	*/
+	configure(options) {
+		this.repo = "repository" in options && options.repository ? options.repository : new BaseNotificationsRepository(options.model);
+		return databaseChannel(this.repo);
+	}
+	get repository() {
+		if (!this.repo) throw new Error("In-app notifications not configured — add `database: inApp.configure({ model: Notification })` to config/notifications.ts");
+		return this.repo;
+	}
+	/** General list — scoped to recipient; pass `options` for paging + filters. */
+	list(recipient, options) {
+		return this.repository.list({
+			...options,
+			recipientId: idOf(recipient)
+		});
+	}
+	/** Unread-only list — common case for badges + dashboards. */
+	listUnread(recipient, options) {
+		return this.repository.list({
+			...options,
+			recipientId: idOf(recipient),
+			unread: true
+		});
+	}
+	/**
+	* Cached unread count — backs the badge. Auto-invalidated by the repo's
+	* model create/update events (`RepositoryManager.registerEvents`).
+	*/
+	countUnread(recipient) {
+		return this.repository.countCached({
+			recipientId: idOf(recipient),
+			unread: true
+		});
+	}
+	/** Find one notification for a recipient — for a detail view. */
+	find(recipient, id) {
+		return this.repository.findFor(idOf(recipient), id);
+	}
+	/** Mark read — `id` omitted = all unread for this recipient. */
+	markAsRead(recipient, id) {
+		return this.repository.markRead(idOf(recipient), id);
+	}
+	/** Mark unread — same recipient-scoping. */
+	markAsUnread(recipient, id) {
+		return this.repository.markUnread(idOf(recipient), id);
+	}
+	/** Delete/dismiss — `id` omitted = clear all for this recipient. */
+	dismiss(recipient, id) {
+		return this.repository.deleteFor(idOf(recipient), id);
+	}
+};
+/** Single in-app facade — bound at boot via `inApp.configure(...)`. */
+const inApp = new InApp();
+
+//#endregion
+export { inApp };
+//# sourceMappingURL=in-app.mjs.map

package/esm/in-app/in-app.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"in-app.mjs","names":[],"sources":["../../../../../../../@warlock.js/notifications/src/in-app/in-app.ts"],"sourcesContent":["/**\n * `inApp` — app-facing facade for the in-app/database channel.\n *\n * `inApp.configure({ model | repository })` binds the in-app store AND\n * returns the `database` channel — so the read side and the dispatched\n * write side share ONE repository instance.\n *   • `{ model: Notification }`  — 90% case; default repo built internally.\n *   • `{ repository: myRepo }`   — 10% case; custom column mapping / extras.\n *\n * No zero-arg form: the package ships no concrete model/table (thin eject),\n * so the dev MUST tell us which model to use.\n *\n * Every read + mutation is RECIPIENT-SCOPED by construction — `markAsRead(user,\n * id)` cannot flip a row belonging to a different recipient even if handed a\n * foreign id (the recipient id is forced into the filter → 0 rows match).\n *\n * @example\n *   // src/config/notifications.ts:\n *   inApp.configure({ model: Notification }),\n *\n *   // anywhere:\n *   const unread = await inApp.listUnread(user);\n *   const badge  = await inApp.countUnread(user);\n *   const one    = await inApp.find(user, \"ntf_123\");\n *   await inApp.markAsRead(user, \"ntf_123\");\n *   await inApp.markAsRead(user);            // mark ALL unread\n *   await inApp.dismiss(user, \"ntf_123\");    // delete one\n *   await inApp.dismiss(user);               // clear all for this recipient\n */\nimport type { TypedRepositoryOptionsWithPages } from \"@warlock.js/core\";\nimport { databaseChannel } from \"../channels/database-channel\";\nimport type { Channel } from \"../contracts\";\nimport type { DatabasePayload, Id, Notifiable } from \"../types\";\nimport {\n  BaseNotificationsRepository,\n  type NotificationModelClass,\n  type NotificationsFilter,\n} from \"./base-notifications-repository\";\n\n/**\n * List options for the read methods — the repository's paginated options\n * (`page` / `limit` / `orderBy` / filter keys). `recipientId` is always forced\n * from the recipient argument, so passing it here has no effect.\n */\nexport type NotificationsListOptions = TypedRepositoryOptionsWithPages<NotificationsFilter>;\n\n/**\n * Configure options — discriminated so `model` and `repository` are mutually\n * exclusive at the type level. Future knobs (cache / realtime / naming) slot\n * in here without breaking the signature.\n */\nexport type ConfigureOptions =\n  | { model: NotificationModelClass; repository?: never }\n  | { repository: BaseNotificationsRepository; model?: never };\n\nconst idOf = (recipient: Notifiable | Id): Id =>\n  typeof recipient === \"object\" ? recipient.id : recipient;\n\nclass InApp {\n  private repo?: BaseNotificationsRepository;\n\n  /**\n   * Bind the in-app store AND return the `database` channel. Called once\n   * from `config/notifications.ts`. Subsequent calls REPLACE the binding.\n   */\n  public configure(options: ConfigureOptions): Channel<DatabasePayload> {\n    this.repo =\n      \"repository\" in options && options.repository\n        ? options.repository\n        : new BaseNotificationsRepository(options.model);\n    return databaseChannel(this.repo);\n  }\n\n  private get repository(): BaseNotificationsRepository {\n    if (!this.repo) {\n      throw new Error(\n        \"In-app notifications not configured — add \" +\n          \"`database: inApp.configure({ model: Notification })` to config/notifications.ts\",\n      );\n    }\n    return this.repo;\n  }\n\n  /** General list — scoped to recipient; pass `options` for paging + filters. */\n  public list(recipient: Notifiable | Id, options?: NotificationsListOptions) {\n    return this.repository.list({ ...options, recipientId: idOf(recipient) });\n  }\n\n  /** Unread-only list — common case for badges + dashboards. */\n  public listUnread(recipient: Notifiable | Id, options?: NotificationsListOptions) {\n    return this.repository.list({ ...options, recipientId: idOf(recipient), unread: true });\n  }\n\n  /**\n   * Cached unread count — backs the badge. Auto-invalidated by the repo's\n   * model create/update events (`RepositoryManager.registerEvents`).\n   */\n  public countUnread(recipient: Notifiable | Id) {\n    return this.repository.countCached({ recipientId: idOf(recipient), unread: true });\n  }\n\n  /** Find one notification for a recipient — for a detail view. */\n  public find(recipient: Notifiable | Id, id: Id) {\n    return this.repository.findFor(idOf(recipient), id);\n  }\n\n  /** Mark read — `id` omitted = all unread for this recipient. */\n  public markAsRead(recipient: Notifiable | Id, id?: Id) {\n    return this.repository.markRead(idOf(recipient), id);\n  }\n\n  /** Mark unread — same recipient-scoping. */\n  public markAsUnread(recipient: Notifiable | Id, id?: Id) {\n    return this.repository.markUnread(idOf(recipient), id);\n  }\n\n  /** Delete/dismiss — `id` omitted = clear all for this recipient. */\n  public dismiss(recipient: Notifiable | Id, id?: Id) {\n    return this.repository.deleteFor(idOf(recipient), id);\n  }\n}\n\n/** Single in-app facade — bound at boot via `inApp.configure(...)`. */\nexport const inApp = new InApp();\n"],"mappings":";;;;AAuDA,MAAM,QAAQ,cACZ,OAAO,cAAc,WAAW,UAAU,KAAK;AAEjD,IAAM,QAAN,MAAY;CACV,AAAQ;;;;;CAMR,AAAO,UAAU,SAAqD;EACpE,KAAK,OACH,gBAAgB,WAAW,QAAQ,aAC/B,QAAQ,aACR,IAAI,4BAA4B,QAAQ,KAAK;EACnD,OAAO,gBAAgB,KAAK,IAAI;CAClC;CAEA,IAAY,aAA0C;EACpD,IAAI,CAAC,KAAK,MACR,MAAM,IAAI,MACR,2HAEF;EAEF,OAAO,KAAK;CACd;;CAGA,AAAO,KAAK,WAA4B,SAAoC;EAC1E,OAAO,KAAK,WAAW,KAAK;GAAE,GAAG;GAAS,aAAa,KAAK,SAAS;EAAE,CAAC;CAC1E;;CAGA,AAAO,WAAW,WAA4B,SAAoC;EAChF,OAAO,KAAK,WAAW,KAAK;GAAE,GAAG;GAAS,aAAa,KAAK,SAAS;GAAG,QAAQ;EAAK,CAAC;CACxF;;;;;CAMA,AAAO,YAAY,WAA4B;EAC7C,OAAO,KAAK,WAAW,YAAY;GAAE,aAAa,KAAK,SAAS;GAAG,QAAQ;EAAK,CAAC;CACnF;;CAGA,AAAO,KAAK,WAA4B,IAAQ;EAC9C,OAAO,KAAK,WAAW,QAAQ,KAAK,SAAS,GAAG,EAAE;CACpD;;CAGA,AAAO,WAAW,WAA4B,IAAS;EACrD,OAAO,KAAK,WAAW,SAAS,KAAK,SAAS,GAAG,EAAE;CACrD;;CAGA,AAAO,aAAa,WAA4B,IAAS;EACvD,OAAO,KAAK,WAAW,WAAW,KAAK,SAAS,GAAG,EAAE;CACvD;;CAGA,AAAO,QAAQ,WAA4B,IAAS;EAClD,OAAO,KAAK,WAAW,UAAU,KAAK,SAAS,GAAG,EAAE;CACtD;AACF;;AAGA,MAAa,QAAQ,IAAI,MAAM"}

package/esm/in-app/index.d.mts

@@ -0,0 +1,4 @@
+import { NotificationColumnMap, NotificationColumnMapHost, ResolvedNotificationColumnMap, resolveColumnMap } from "./column-map.mjs";
+import { DatabaseNotification } from "./database-notification.mjs";
+import { BaseNotificationsRepository, NotificationModelClass, NotificationsFilter } from "./base-notifications-repository.mjs";
+import { ConfigureOptions, NotificationsListOptions, inApp } from "./in-app.mjs";

package/esm/in-app/index.mjs

@@ -0,0 +1,6 @@
+import { resolveColumnMap } from "./column-map.mjs";
+import { BaseNotificationsRepository } from "./base-notifications-repository.mjs";
+import { DatabaseNotification } from "./database-notification.mjs";
+import { inApp } from "./in-app.mjs";
+
+export {  };

package/esm/index.d.mts

@@ -0,0 +1,25 @@
+import { ChannelName, DatabasePayload, Id, MailPayload, Notifiable, NotificationChannels, NotificationEvents, NotificationInput, RenderContext, SendOptions } from "./types.mjs";
+import { Channel } from "./contracts/channel.contract.mjs";
+import { NotificationContract } from "./contracts/notification.contract.mjs";
+import { PreferenceProvider } from "./contracts/preference-provider.contract.mjs";
+import { QueueDispatcher } from "./contracts/queue-dispatcher.contract.mjs";
+import { RateLimiter } from "./contracts/rate-limiter.contract.mjs";
+import { ChannelNotFoundError, MissingRendererError, NoQueueDispatcherError, NotificationsNotConfiguredError, UnresolvableRouteError } from "./errors.mjs";
+import { ChannelMap, NotificationConfig, getNotificationConfig, resetNotificationConfig, setNotificationConfig } from "./config.mjs";
+import { defineChannel } from "./dispatch/define-channel.mjs";
+import { DefinedNotification, NotificationDef, defineNotification } from "./dispatch/define-notification.mjs";
+import { Notify, notify } from "./dispatch/notify.mjs";
+import { notifications } from "./dispatch/notifications-event-bus.mjs";
+import { NotificationColumnMap, NotificationColumnMapHost, ResolvedNotificationColumnMap, resolveColumnMap } from "./in-app/column-map.mjs";
+import { DatabaseNotification } from "./in-app/database-notification.mjs";
+import { BaseNotificationsRepository, NotificationModelClass, NotificationsFilter } from "./in-app/base-notifications-repository.mjs";
+import { databaseChannel } from "./channels/database-channel.mjs";
+import { MailChannelConfig, mailChannel } from "./channels/mail-channel.mjs";
+import { ConfigureOptions, NotificationsListOptions, inApp } from "./in-app/in-app.mjs";
+import { notificationColumns } from "./migration/notification-columns.mjs";
+import { HeraldQueueOptions, heraldQueue } from "./queue/herald-queue.mjs";
+import { WorkerOptions, startNotificationsWorker } from "./queue/notifications-worker.mjs";
+import { DEFAULT_QUEUE_CHANNEL } from "./queue/load-herald.mjs";
+export { BaseNotificationsRepository, Channel, ChannelMap, ChannelName, ChannelNotFoundError, ConfigureOptions, DEFAULT_QUEUE_CHANNEL, DatabaseNotification, DatabasePayload, DefinedNotification, HeraldQueueOptions, Id, MailChannelConfig, MailPayload, MissingRendererError, NoQueueDispatcherError, Notifiable, NotificationChannels, NotificationColumnMap, NotificationColumnMapHost, NotificationConfig, NotificationContract, NotificationDef, NotificationEvents, NotificationInput, NotificationModelClass, NotificationsFilter, NotificationsListOptions, NotificationsNotConfiguredError, Notify, PreferenceProvider, QueueDispatcher, RateLimiter, RenderContext, ResolvedNotificationColumnMap, SendOptions, UnresolvableRouteError, WorkerOptions, databaseChannel, defineChannel, defineNotification, getNotificationConfig, heraldQueue, inApp, mailChannel, notificationColumns, notifications, notify, resetNotificationConfig, resolveColumnMap, setNotificationConfig, startNotificationsWorker };
+import "./dispatch/define-channel.mjs";
+import "./types.mjs";

package/esm/index.mjs

@@ -0,0 +1,23 @@
+import { ChannelNotFoundError, MissingRendererError, NoQueueDispatcherError, NotificationsNotConfiguredError, UnresolvableRouteError } from "./errors.mjs";
+import { getNotificationConfig, resetNotificationConfig, setNotificationConfig } from "./config.mjs";
+import { defineChannel } from "./dispatch/define-channel.mjs";
+import { notifications } from "./dispatch/notifications-event-bus.mjs";
+import { defineNotification } from "./dispatch/define-notification.mjs";
+import { notify } from "./dispatch/notify.mjs";
+import "./dispatch/index.mjs";
+import { databaseChannel } from "./channels/database-channel.mjs";
+import { mailChannel } from "./channels/mail-channel.mjs";
+import "./channels/index.mjs";
+import { resolveColumnMap } from "./in-app/column-map.mjs";
+import { BaseNotificationsRepository } from "./in-app/base-notifications-repository.mjs";
+import { DatabaseNotification } from "./in-app/database-notification.mjs";
+import { inApp } from "./in-app/in-app.mjs";
+import "./in-app/index.mjs";
+import { notificationColumns } from "./migration/notification-columns.mjs";
+import "./migration/index.mjs";
+import { DEFAULT_QUEUE_CHANNEL } from "./queue/load-herald.mjs";
+import { heraldQueue } from "./queue/herald-queue.mjs";
+import { startNotificationsWorker } from "./queue/notifications-worker.mjs";
+import "./queue/index.mjs";
+
+export { BaseNotificationsRepository, ChannelNotFoundError, DEFAULT_QUEUE_CHANNEL, DatabaseNotification, MissingRendererError, NoQueueDispatcherError, NotificationsNotConfiguredError, UnresolvableRouteError, databaseChannel, defineChannel, defineNotification, getNotificationConfig, heraldQueue, inApp, mailChannel, notificationColumns, notifications, notify, resetNotificationConfig, resolveColumnMap, setNotificationConfig, startNotificationsWorker };

package/esm/migration/index.d.mts

@@ -0,0 +1 @@
+import { notificationColumns } from "./notification-columns.mjs";

package/esm/migration/index.mjs

@@ -0,0 +1,3 @@
+import { notificationColumns } from "./notification-columns.mjs";
+
+export {  };

package/esm/migration/notification-columns.d.mts

@@ -0,0 +1,13 @@
+import { NotificationColumnMapHost } from "../in-app/column-map.mjs";
+import { ColumnMap } from "@warlock.js/cascade";
+
+//#region ../@warlock.js/notifications/src/migration/notification-columns.d.ts
+/**
+ * Returns the column map for a notification table, named from the model's
+ * `columnMap`. Without a model, falls back to the resolved defaults
+ * (`user_id` recipient + `read_at` read-state).
+ */
+declare function notificationColumns(model?: NotificationColumnMapHost): ColumnMap;
+//#endregion
+export { notificationColumns };
+//# sourceMappingURL=notification-columns.d.mts.map

package/esm/migration/notification-columns.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"notification-columns.d.mts","names":[],"sources":["../../../../../../../@warlock.js/notifications/src/migration/notification-columns.ts"],"mappings":";;;;;;;;;iBAiCgB,mBAAA,CAAoB,KAAA,GAAQ,yBAAA,GAA4B,SAAS"}

package/esm/migration/notification-columns.mjs

@@ -0,0 +1,53 @@
+import { resolveColumnMap } from "../in-app/column-map.mjs";
+import { boolCol, json, string, text, timestamp, uuid } from "@warlock.js/cascade";
+
+//#region ../@warlock.js/notifications/src/migration/notification-columns.ts
+/**
+* Column factory for the notifications table, driven by the model's
+* `columnMap`. The recipient / read-state / tenant columns take the NAMES the
+* model declares, so the table, the repository, and the model accessors all
+* agree by construction. The stable lexical columns (`type`, `title`, `body`,
+* `payload`, `idempotency_key`) keep fixed names.
+*
+* Read-state follows the map's presence rules (see `NotificationColumnMap`):
+* `readAt` → a nullable timestamp, `isRead` → an indexed boolean, both → both.
+*
+* Spread + extend for app-specific extras (FK references, composite indexes).
+*
+* @example
+*   import { Migration } from "@warlock.js/cascade";
+*   import { notificationColumns } from "@warlock.js/notifications";
+*   import { Notification } from "../notification.model";
+*
+*   export default Migration.create(Notification, notificationColumns(Notification));
+*
+* @example  // with extras (multi-tenant FK)
+*   export default Migration.create(Notification, {
+*     ...notificationColumns(Notification),
+*     organization_id: uuid().references(Organization.table).notNullable(),
+*   });
+*/
+/**
+* Returns the column map for a notification table, named from the model's
+* `columnMap`. Without a model, falls back to the resolved defaults
+* (`user_id` recipient + `read_at` read-state).
+*/
+function notificationColumns(model) {
+	const { recipient, tenant, readAt, isRead } = resolveColumnMap(model?.columnMap);
+	const columns = {
+		[recipient]: uuid().index().notNullable(),
+		type: string().index().notNullable(),
+		title: string().notNullable(),
+		body: text().nullable(),
+		payload: json().nullable()
+	};
+	if (readAt) columns[readAt] = timestamp().nullable();
+	if (isRead) columns[isRead] = boolCol().default(false).index();
+	if (tenant) columns[tenant] = uuid().index().notNullable();
+	columns.idempotency_key = string().nullable().unique();
+	return columns;
+}
+
+//#endregion
+export { notificationColumns };
+//# sourceMappingURL=notification-columns.mjs.map

package/esm/migration/notification-columns.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"notification-columns.mjs","names":[],"sources":["../../../../../../../@warlock.js/notifications/src/migration/notification-columns.ts"],"sourcesContent":["/**\n * Column factory for the notifications table, driven by the model's\n * `columnMap`. The recipient / read-state / tenant columns take the NAMES the\n * model declares, so the table, the repository, and the model accessors all\n * agree by construction. The stable lexical columns (`type`, `title`, `body`,\n * `payload`, `idempotency_key`) keep fixed names.\n *\n * Read-state follows the map's presence rules (see `NotificationColumnMap`):\n * `readAt` → a nullable timestamp, `isRead` → an indexed boolean, both → both.\n *\n * Spread + extend for app-specific extras (FK references, composite indexes).\n *\n * @example\n *   import { Migration } from \"@warlock.js/cascade\";\n *   import { notificationColumns } from \"@warlock.js/notifications\";\n *   import { Notification } from \"../notification.model\";\n *\n *   export default Migration.create(Notification, notificationColumns(Notification));\n *\n * @example  // with extras (multi-tenant FK)\n *   export default Migration.create(Notification, {\n *     ...notificationColumns(Notification),\n *     organization_id: uuid().references(Organization.table).notNullable(),\n *   });\n */\nimport { boolCol, type ColumnMap, json, string, text, timestamp, uuid } from \"@warlock.js/cascade\";\nimport { type NotificationColumnMapHost, resolveColumnMap } from \"../in-app/column-map\";\n\n/**\n * Returns the column map for a notification table, named from the model's\n * `columnMap`. Without a model, falls back to the resolved defaults\n * (`user_id` recipient + `read_at` read-state).\n */\nexport function notificationColumns(model?: NotificationColumnMapHost): ColumnMap {\n  const { recipient, tenant, readAt, isRead } = resolveColumnMap(model?.columnMap);\n\n  const columns: ColumnMap = {\n    [recipient]: uuid().index().notNullable(),\n    type: string().index().notNullable(),\n    title: string().notNullable(),\n    body: text().nullable(),\n    payload: json().nullable(),\n  };\n\n  if (readAt) {\n    columns[readAt] = timestamp().nullable();\n  }\n\n  if (isRead) {\n    columns[isRead] = boolCol().default(false).index();\n  }\n\n  if (tenant) {\n    columns[tenant] = uuid().index().notNullable();\n  }\n\n  // Unique so a retried send can't insert a duplicate. Nullable: most rows\n  // have no key (NULLs are distinct in a unique index). `createFor` does\n  // find-or-create; this constraint is the race backstop.\n  columns.idempotency_key = string().nullable().unique();\n\n  return columns;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAiCA,SAAgB,oBAAoB,OAA8C;CAChF,MAAM,EAAE,WAAW,QAAQ,QAAQ,WAAW,iBAAiB,OAAO,SAAS;CAE/E,MAAM,UAAqB;GACxB,YAAY,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC,YAAY;EACxC,MAAM,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC,YAAY;EACnC,OAAO,OAAO,CAAC,CAAC,YAAY;EAC5B,MAAM,KAAK,CAAC,CAAC,SAAS;EACtB,SAAS,KAAK,CAAC,CAAC,SAAS;CAC3B;CAEA,IAAI,QACF,QAAQ,UAAU,UAAU,CAAC,CAAC,SAAS;CAGzC,IAAI,QACF,QAAQ,UAAU,QAAQ,CAAC,CAAC,QAAQ,KAAK,CAAC,CAAC,MAAM;CAGnD,IAAI,QACF,QAAQ,UAAU,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC,YAAY;CAM/C,QAAQ,kBAAkB,OAAO,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO;CAErD,OAAO;AACT"}

package/esm/queue/herald-queue.d.mts

@@ -0,0 +1,10 @@
+import { QueueDispatcher } from "../contracts/queue-dispatcher.contract.mjs";
+//#region ../@warlock.js/notifications/src/queue/herald-queue.d.ts
+type HeraldQueueOptions = {
+  /** Herald channel to publish jobs to. Default `"notifications.dispatch"`. */channel?: string; /** Herald broker name (multi-broker setups). Default broker if omitted. */
+  broker?: string;
+};
+declare function heraldQueue(options?: HeraldQueueOptions): QueueDispatcher;
+//#endregion
+export { HeraldQueueOptions, heraldQueue };
+//# sourceMappingURL=herald-queue.d.mts.map

package/esm/queue/herald-queue.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"herald-queue.d.mts","names":[],"sources":["../../../../../../../@warlock.js/notifications/src/queue/herald-queue.ts"],"mappings":";;KAyBY,kBAAA;+EAEV,OAAA;EAEA,MAAM;AAAA;AAAA,iBAGQ,WAAA,CAAY,OAAA,GAAS,kBAAA,GAA0B,eAAe"}

package/esm/queue/herald-queue.mjs

@@ -0,0 +1,14 @@
+import { DEFAULT_QUEUE_CHANNEL, loadHerald } from "./load-herald.mjs";
+
+//#region ../@warlock.js/notifications/src/queue/herald-queue.ts
+function heraldQueue(options = {}) {
+	const channelName = options.channel ?? "notifications.dispatch";
+	return { async dispatch(job) {
+		const { herald } = await loadHerald();
+		await herald(options.broker).channel(channelName).publish(job);
+	} };
+}
+
+//#endregion
+export { heraldQueue };
+//# sourceMappingURL=herald-queue.mjs.map

package/esm/queue/herald-queue.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"herald-queue.mjs","names":[],"sources":["../../../../../../../@warlock.js/notifications/src/queue/herald-queue.ts"],"sourcesContent":["/**\n * Herald-backed `QueueDispatcher` — the production backend for `.queue()`.\n *\n * `defineNotification` renders payloads + resolves routes BEFORE handing a job\n * to the dispatcher, so the job is fully serializable (`{ channel, route,\n * payload, options }`) — no model re-hydration or closure serialization. This\n * dispatcher just publishes the job onto a herald channel; the worker\n * (`startNotificationsWorker`) consumes it and runs `channel.send`.\n *\n * Connection is the app's job — the `@warlock.js/herald` connector connects the\n * broker from `config/herald.ts` at boot; this dispatcher only calls `herald()`.\n *\n * @example  src/config/notifications.ts — declarative; the connector registers it\n *   import { type NotificationConfig, heraldQueue, inApp, mailChannel } from \"@warlock.js/notifications\";\n *\n *   const config: NotificationConfig = {\n *     channels: { mail: mailChannel(), database: inApp.configure({ model: Notification }) },\n *     queue: heraldQueue(),                 // → `.queue()` now works\n *   };\n *\n *   export default config;\n */\nimport type { QueueDispatcher } from \"../contracts\";\nimport { DEFAULT_QUEUE_CHANNEL, loadHerald } from \"./load-herald\";\n\nexport type HeraldQueueOptions = {\n  /** Herald channel to publish jobs to. Default `\"notifications.dispatch\"`. */\n  channel?: string;\n  /** Herald broker name (multi-broker setups). Default broker if omitted. */\n  broker?: string;\n};\n\nexport function heraldQueue(options: HeraldQueueOptions = {}): QueueDispatcher {\n  const channelName = options.channel ?? DEFAULT_QUEUE_CHANNEL;\n\n  return {\n    async dispatch(job) {\n      const { herald } = await loadHerald();\n      await herald(options.broker).channel(channelName).publish(job);\n    },\n  };\n}\n"],"mappings":";;;AAgCA,SAAgB,YAAY,UAA8B,CAAC,GAAoB;CAC7E,MAAM,cAAc,QAAQ;CAE5B,OAAO,EACL,MAAM,SAAS,KAAK;EAClB,MAAM,EAAE,WAAW,MAAM,WAAW;EACpC,MAAM,OAAO,QAAQ,MAAM,CAAC,CAAC,QAAQ,WAAW,CAAC,CAAC,QAAQ,GAAG;CAC/D,EACF;AACF"}

package/esm/queue/index.d.mts

@@ -0,0 +1,3 @@
+import { HeraldQueueOptions, heraldQueue } from "./herald-queue.mjs";
+import { WorkerOptions, startNotificationsWorker } from "./notifications-worker.mjs";
+import { DEFAULT_QUEUE_CHANNEL } from "./load-herald.mjs";

package/esm/queue/index.mjs

@@ -0,0 +1,5 @@
+import { DEFAULT_QUEUE_CHANNEL } from "./load-herald.mjs";
+import { heraldQueue } from "./herald-queue.mjs";
+import { startNotificationsWorker } from "./notifications-worker.mjs";
+
+export {  };

package/esm/queue/load-herald.d.mts

@@ -0,0 +1,6 @@
+//#region ../@warlock.js/notifications/src/queue/load-herald.d.ts
+/** The herald channel notification jobs are published to / consumed from. */
+declare const DEFAULT_QUEUE_CHANNEL = "notifications.dispatch";
+//#endregion
+export { DEFAULT_QUEUE_CHANNEL };
+//# sourceMappingURL=load-herald.d.mts.map

package/esm/queue/load-herald.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-herald.d.mts","names":[],"sources":["../../../../../../../@warlock.js/notifications/src/queue/load-herald.ts"],"mappings":";AAmCA;AAAA,cAAa,qBAAA"}

package/esm/queue/load-herald.mjs

@@ -0,0 +1,35 @@
+//#region ../@warlock.js/notifications/src/queue/load-herald.ts
+/**
+* Lazily load `@warlock.js/herald` — the optional peer backing `.queue()`.
+*
+* Memoized: the dynamic import runs at most once. A missing package surfaces a
+* curated install message at use time rather than a boot-time resolution error
+* (the lazy-optional-peer pattern used across the framework's drivers).
+*/
+let heraldModule;
+const INSTALL_INSTRUCTIONS = `
+The notifications queue requires the @warlock.js/herald package.
+Install it with:
+
+  npm install @warlock.js/herald
+
+Or with your preferred package manager:
+
+  pnpm add @warlock.js/herald
+  yarn add @warlock.js/herald
+`.trim();
+async function loadHerald() {
+	if (heraldModule) return heraldModule;
+	try {
+		heraldModule = await import("@warlock.js/herald");
+		return heraldModule;
+	} catch {
+		throw new Error(INSTALL_INSTRUCTIONS);
+	}
+}
+/** The herald channel notification jobs are published to / consumed from. */
+const DEFAULT_QUEUE_CHANNEL = "notifications.dispatch";
+
+//#endregion
+export { DEFAULT_QUEUE_CHANNEL, loadHerald };
+//# sourceMappingURL=load-herald.mjs.map

package/esm/queue/load-herald.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-herald.mjs","names":[],"sources":["../../../../../../../@warlock.js/notifications/src/queue/load-herald.ts"],"sourcesContent":["/**\n * Lazily load `@warlock.js/herald` — the optional peer backing `.queue()`.\n *\n * Memoized: the dynamic import runs at most once. A missing package surfaces a\n * curated install message at use time rather than a boot-time resolution error\n * (the lazy-optional-peer pattern used across the framework's drivers).\n */\nlet heraldModule: typeof import(\"@warlock.js/herald\") | undefined;\n\nconst INSTALL_INSTRUCTIONS = `\nThe notifications queue requires the @warlock.js/herald package.\nInstall it with:\n\n  npm install @warlock.js/herald\n\nOr with your preferred package manager:\n\n  pnpm add @warlock.js/herald\n  yarn add @warlock.js/herald\n`.trim();\n\nexport async function loadHerald(): Promise<typeof import(\"@warlock.js/herald\")> {\n  if (heraldModule) {\n    return heraldModule;\n  }\n\n  try {\n    heraldModule = await import(\"@warlock.js/herald\");\n    return heraldModule;\n  } catch {\n    throw new Error(INSTALL_INSTRUCTIONS);\n  }\n}\n\n/** The herald channel notification jobs are published to / consumed from. */\nexport const DEFAULT_QUEUE_CHANNEL = \"notifications.dispatch\";\n"],"mappings":";;;;;;;;AAOA,IAAI;AAEJ,MAAM,uBAAuB;;;;;;;;;;EAU3B,KAAK;AAEP,eAAsB,aAA2D;CAC/E,IAAI,cACF,OAAO;CAGT,IAAI;EACF,eAAe,MAAM,OAAO;EAC5B,OAAO;CACT,QAAQ;EACN,MAAM,IAAI,MAAM,oBAAoB;CACtC;AACF;;AAGA,MAAa,wBAAwB"}

package/esm/queue/notifications-worker.d.mts

@@ -0,0 +1,9 @@
+//#region ../@warlock.js/notifications/src/queue/notifications-worker.d.ts
+type WorkerOptions = {
+  /** Herald channel to consume from. Must match the dispatcher. Default `"notifications.dispatch"`. */channel?: string; /** Herald broker name. Default broker if omitted. */
+  broker?: string;
+};
+declare function startNotificationsWorker(options?: WorkerOptions): Promise<void>;
+//#endregion
+export { WorkerOptions, startNotificationsWorker };
+//# sourceMappingURL=notifications-worker.d.mts.map

package/esm/queue/notifications-worker.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"notifications-worker.d.mts","names":[],"sources":["../../../../../../../@warlock.js/notifications/src/queue/notifications-worker.ts"],"mappings":";KAyBY,aAAA;EAAA,qGAEV,OAAA;EAEA,MAAM;AAAA;AAAA,iBAGc,wBAAA,CAAyB,OAAA,GAAS,aAAA,GAAqB,OAAO"}

package/esm/queue/notifications-worker.mjs

@@ -0,0 +1,46 @@
+import { getNotificationConfig } from "../config.mjs";
+import { DEFAULT_QUEUE_CHANNEL, loadHerald } from "./load-herald.mjs";
+import { log } from "@warlock.js/logger";
+
+//#region ../@warlock.js/notifications/src/queue/notifications-worker.ts
+/**
+* Notification queue worker — consumes the jobs `heraldQueue` publishes and
+* runs the actual `channel.send`. Call this once in a worker process (or the
+* web process) after the notifications config + herald broker are up.
+*
+* The job carries an ALREADY-RENDERED payload + resolved route, so the worker
+* only looks the channel up by name and dispatches — no notifiable needed.
+*
+* @example
+*   // in a worker entrypoint, after the notifications config + broker are up
+*   import { startNotificationsWorker } from "@warlock.js/notifications";
+*   await startNotificationsWorker();
+*/
+async function startNotificationsWorker(options = {}) {
+	const channelName = options.channel ?? "notifications.dispatch";
+	const { herald } = await loadHerald();
+	await herald(options.broker).channel(channelName).subscribe(async (message, ctx) => {
+		const job = message.payload;
+		try {
+			const channel = getNotificationConfig().channels[job.channel];
+			if (!channel) {
+				log.error("notifications", "queue.worker", `Unknown channel "${job.channel}" — dropping job`);
+				await ctx.ack();
+				return;
+			}
+			await channel.send({
+				payload: job.payload,
+				route: job.route,
+				options: job.options
+			});
+			await ctx.ack();
+		} catch (error) {
+			log.error("notifications", "queue.worker", error);
+			await ctx.ack();
+		}
+	});
+}
+
+//#endregion
+export { startNotificationsWorker };
+//# sourceMappingURL=notifications-worker.mjs.map

package/esm/queue/notifications-worker.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"notifications-worker.mjs","names":[],"sources":["../../../../../../../@warlock.js/notifications/src/queue/notifications-worker.ts"],"sourcesContent":["/**\n * Notification queue worker — consumes the jobs `heraldQueue` publishes and\n * runs the actual `channel.send`. Call this once in a worker process (or the\n * web process) after the notifications config + herald broker are up.\n *\n * The job carries an ALREADY-RENDERED payload + resolved route, so the worker\n * only looks the channel up by name and dispatches — no notifiable needed.\n *\n * @example\n *   // in a worker entrypoint, after the notifications config + broker are up\n *   import { startNotificationsWorker } from \"@warlock.js/notifications\";\n *   await startNotificationsWorker();\n */\nimport { log } from \"@warlock.js/logger\";\nimport { getNotificationConfig } from \"../config\";\nimport type { ChannelName, SendOptions } from \"../types\";\nimport { DEFAULT_QUEUE_CHANNEL, loadHerald } from \"./load-herald\";\n\ntype NotificationJob = {\n  channel: string;\n  route: unknown;\n  payload: unknown;\n  options: SendOptions;\n};\n\nexport type WorkerOptions = {\n  /** Herald channel to consume from. Must match the dispatcher. Default `\"notifications.dispatch\"`. */\n  channel?: string;\n  /** Herald broker name. Default broker if omitted. */\n  broker?: string;\n};\n\nexport async function startNotificationsWorker(options: WorkerOptions = {}): Promise<void> {\n  const channelName = options.channel ?? DEFAULT_QUEUE_CHANNEL;\n  const { herald } = await loadHerald();\n\n  await herald(options.broker)\n    .channel(channelName)\n    .subscribe(async (message: { payload: unknown }, ctx: { ack(): Promise<void> }) => {\n      const job = message.payload as NotificationJob;\n\n      try {\n        const channel = getNotificationConfig().channels[job.channel as ChannelName];\n\n        if (!channel) {\n          // Unknown channel — log and ack to avoid a poison-message loop.\n          log.error(\"notifications\", \"queue.worker\", `Unknown channel \"${job.channel}\" — dropping job`);\n          await ctx.ack();\n          return;\n        }\n\n        await channel.send({\n          payload: job.payload as never,\n          route: job.route as never,\n          options: job.options,\n        });\n\n        await ctx.ack();\n      } catch (error) {\n        // Phase 2: log + ack (no retry/DLQ yet — that lands with the\n        // delay-aware worker). A dead-letter strategy is a follow-up.\n        log.error(\"notifications\", \"queue.worker\", error as Error);\n        await ctx.ack();\n      }\n    });\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAgCA,eAAsB,yBAAyB,UAAyB,CAAC,GAAkB;CACzF,MAAM,cAAc,QAAQ;CAC5B,MAAM,EAAE,WAAW,MAAM,WAAW;CAEpC,MAAM,OAAO,QAAQ,MAAM,CAAC,CACzB,QAAQ,WAAW,CAAC,CACpB,UAAU,OAAO,SAA+B,QAAkC;EACjF,MAAM,MAAM,QAAQ;EAEpB,IAAI;GACF,MAAM,UAAU,sBAAsB,CAAC,CAAC,SAAS,IAAI;GAErD,IAAI,CAAC,SAAS;IAEZ,IAAI,MAAM,iBAAiB,gBAAgB,oBAAoB,IAAI,QAAQ,iBAAiB;IAC5F,MAAM,IAAI,IAAI;IACd;GACF;GAEA,MAAM,QAAQ,KAAK;IACjB,SAAS,IAAI;IACb,OAAO,IAAI;IACX,SAAS,IAAI;GACf,CAAC;GAED,MAAM,IAAI,IAAI;EAChB,SAAS,OAAO;GAGd,IAAI,MAAM,iBAAiB,gBAAgB,KAAc;GACzD,MAAM,IAAI,IAAI;EAChB;CACF,CAAC;AACL"}

package/esm/types.d.mts

@@ -0,0 +1,130 @@
+import { Model } from "@warlock.js/cascade";
+
+//#region ../@warlock.js/notifications/src/types.d.ts
+/**
+ * A recipient you send TO (a User, etc.) — NOT the stored record.
+ * It's a cascade `Model` instance, so `.id` (number | string) and `.get(path)`
+ * are native. Routing is a CHANNEL concern (convention column + per-channel
+ * `route` override in config), not a model concern — there is intentionally
+ * NO `routeNotificationFor` on the model.
+ */
+type Notifiable = Model;
+/** An identifier — string (uuid / objectId) or number (auto-increment). */
+type Id = string | number;
+/** What the `mail` channel renders to and `core.sendMail` consumes. */
+type MailPayload = {
+  subject: string;
+  html?: string;
+  text?: string;
+  cc?: string | string[];
+};
+/** Normalized in-app record shape written through the database channel. */
+type NotificationInput = {
+  recipientId: Id;
+  type: string;
+  title: string;
+  body?: string;
+  payload?: Record<string, unknown>; /** Unique-per-recipient dedupe key — see `SendOptions.idempotencyKey`. */
+  idempotencyKey?: string;
+};
+/**
+ * Database payload as seen by RENDERERS — `recipientId` is set by the channel
+ * from the resolved route, not by the render closure.
+ */
+type DatabasePayload = Omit<NotificationInput, "recipientId">;
+/**
+ * Channel REGISTRY — the single declaration-merge target mapping channel NAME
+ * → payload type. Drives `notify.<channel>` proxy typing and
+ * `defineNotification` renderers. Custom channels extend via:
+ *
+ *   declare module "@warlock.js/notifications" {
+ *     interface NotificationChannels { discord: { content: string } }
+ *   }
+ *
+ * Phase 1 ships ONLY `mail` and `database`. Bridges-backed channels
+ * (`whatsapp`, `telegram`, `push`, `slack`) ship in Phase 2 as the same
+ * declaration-merge pattern.
+ */
+interface NotificationChannels {
+  mail: MailPayload;
+  database: DatabasePayload;
+}
+type ChannelName = keyof NotificationChannels;
+/**
+ * Per-send options — the optional 3rd arg of `notify.<channel>` / `send` /
+ * `queue`. Lean by design: `queue` and `only` are METHODS on a defined
+ * notification (one path each), not flags here.
+ *
+ * - `force` bypasses `PreferenceProvider` (security/critical sends). It does
+ *   NOT bypass `RateLimiter` — that's a safety valve, not a UX preference.
+ * - `idempotencyKey` dedupes on insert (database channel unique constraint)
+ *   and on enqueue (queue dispatcher). Use for any send that may be retried.
+ * - `type` opts ad-hoc `notify.<channel>` sends into preference/rate-limit
+ *   gating. `defineNotification` reads its own `def.type` and ignores this.
+ */
+type SendOptions = {
+  /**
+   * Delay the dispatch, e.g. `"10m"` / `"3d"` / `600` (seconds). RESERVED —
+   * NOT honored yet: `.send()` always dispatches immediately, and the current
+   * `.queue()` worker runs each job the moment it's consumed. Delayed delivery
+   * lands with the delay-aware worker (Phase 2); until then this field is a
+   * no-op on both paths.
+   */
+  delay?: number | string; /** Locale for rendering — passed to renderers via `RenderContext`. */
+  locale?: string; /** Passthrough to channels + every observability event (via `options`). */
+  meta?: Record<string, unknown>; /** Dedupe key for retry-safe sends. */
+  idempotencyKey?: string; /** Bypass `PreferenceProvider`. Does NOT bypass `RateLimiter`. */
+  force?: boolean; /** Notification type for ad-hoc gating (unused by `defineNotification`). */
+  type?: string;
+};
+/** What a renderer receives as its 3rd arg — i18n + meta passthrough only. */
+type RenderContext = Pick<SendOptions, "locale" | "meta">;
+/**
+ * Event surface for metrics, logging, audits. Fires per (channel, recipient)
+ * — fan-out emits N events.
+ *
+ * `dispatchId` is a unique id for ONE (channel, recipient) dispatch: `sending`
+ * and its terminal `sent` / `failed` share it, so observers can pair them (for
+ * spans, latency, or detecting a `sending` with no terminal — a hung send). A
+ * `skipped` carries its own id (nothing precedes it).
+ *
+ * `durationMs` on `sent` / `failed` is the transport time for a synchronous
+ * send; on a queued send it is the enqueue time (real delivery timing is
+ * worker-side).
+ */
+type NotificationEvents = {
+  sending: {
+    dispatchId: string;
+    channel: string;
+    notifiable?: Notifiable;
+    payload: unknown;
+    options: SendOptions;
+  };
+  sent: {
+    dispatchId: string;
+    channel: string;
+    notifiable?: Notifiable;
+    payload: unknown;
+    options: SendOptions;
+    durationMs: number;
+  };
+  failed: {
+    dispatchId: string;
+    channel: string;
+    notifiable?: Notifiable;
+    payload: unknown;
+    error: Error;
+    options: SendOptions;
+    durationMs: number;
+  };
+  skipped: {
+    dispatchId: string;
+    channel: string;
+    notifiable?: Notifiable;
+    reason: "preference" | "rate-limit";
+    options: SendOptions;
+  };
+};
+//#endregion
+export { ChannelName, DatabasePayload, Id, MailPayload, Notifiable, NotificationChannels, NotificationEvents, NotificationInput, RenderContext, SendOptions };
+//# sourceMappingURL=types.d.mts.map

package/esm/types.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.mts","names":[],"sources":["../../../../../../@warlock.js/notifications/src/types.ts"],"mappings":";;;AAqBA;;;;AAAc;AAKd;;AALA,KAHY,UAAA,GAAa,KAAK;;KAGlB,EAAA;;KAKA,WAAA;EACV,OAAA;EACA,IAAA;EACA,IAAA;EACA,EAAA;AAAA;;KAIU,iBAAA;EACV,WAAA,EAAa,EAAA;EACb,IAAA;EACA,KAAA;EACA,IAAA;EACA,OAAA,GAAU,MAAM,mBAAhB;EAEA,cAAA;AAAA;;AAAc;AAOhB;;KAAY,eAAA,GAAkB,IAAI,CAAC,iBAAA;;AAAiB;AAiBpD;;;;;;;;;AAE2B;AAG3B;UALiB,oBAAA;EACf,IAAA,EAAM,WAAA;EACN,QAAA,EAAU,eAAe;AAAA;AAAA,KAGf,WAAA,SAAoB,oBAAoB;;;;;;;;;;;;AAkC9C;KAlBM,WAAA;EAsBa;;;AAAmB;AAiB5C;;;EA/BE,KAAA,oBAqCW;EAnCX,MAAA,WA0CW;EAxCX,IAAA,GAAO,MAAM,mBAgDJ;EA9CT,cAAA,WAqDe;EAnDf,KAAA,YAqDsB;EAnDtB,IAAA;AAAA;;KAIU,aAAA,GAAgB,IAAI,CAAC,WAAA;;;;;;;;;;;;;;KAiBrB,kBAAA;EACV,OAAA;IACE,UAAA;IACA,OAAA;IACA,UAAA,GAAa,UAAA;IACb,OAAA;IACA,OAAA,EAAS,WAAA;EAAA;EAEX,IAAA;IACE,UAAA;IACA,OAAA;IACA,UAAA,GAAa,UAAA;IACb,OAAA;IACA,OAAA,EAAS,WAAA;IACT,UAAA;EAAA;EAEF,MAAA;IACE,UAAA;IACA,OAAA;IACA,UAAA,GAAa,UAAA;IACb,OAAA;IACA,KAAA,EAAO,KAAA;IACP,OAAA,EAAS,WAAA;IACT,UAAA;EAAA;EAEF,OAAA;IACE,UAAA;IACA,OAAA;IACA,UAAA,GAAa,UAAA;IACb,MAAA;IACA,OAAA,EAAS,WAAA;EAAA;AAAA"}