@aglyn/aglyn 1.0.0-beta.264 → 1.0.0-beta.268

package/src/lib/app-utils/live-document-count.client.d.ts

@@ -0,0 +1,28 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { type Query } from 'firebase/firestore';
+/**
+ * The web SDK's half of the live-count rule (AGL-3918): how many of
+ * [documents] are not deleted, as `/api/hosts/resources` counts them for a
+ * plan allowance. Every document less the tombstones (`deletedAt != null`);
+ * an archived document is live and counted. See `live-document-count.ts` for
+ * why it is two aggregates.
+ *
+ * Rejects when either aggregate is refused, so a caller keeps whatever
+ * fallback it already has rather than reading a confident 0.
+ */
+export declare function getLiveCountFromServer(documents: Query): Promise<number>;

package/src/lib/app-utils/live-document-count.client.js

@@ -0,0 +1,35 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */ import { getCountFromServer, query, where } from "firebase/firestore";
+import { liveDocumentCount, TOMBSTONE_FIELD } from "./live-document-count.js";
+/**
+ * The web SDK's half of the live-count rule (AGL-3918): how many of
+ * [documents] are not deleted, as `/api/hosts/resources` counts them for a
+ * plan allowance. Every document less the tombstones (`deletedAt != null`);
+ * an archived document is live and counted. See `live-document-count.ts` for
+ * why it is two aggregates.
+ *
+ * Rejects when either aggregate is refused, so a caller keeps whatever
+ * fallback it already has rather than reading a confident 0.
+ */ export async function getLiveCountFromServer(documents) {
+    const [total, tombstones] = await Promise.all([
+        getCountFromServer(documents),
+        getCountFromServer(query(documents, where(TOMBSTONE_FIELD, '!=', null)))
+    ]);
+    return liveDocumentCount(total.data().count, tombstones.data().count);
+}
+
+//# sourceMappingURL=live-document-count.client.js.map

package/src/lib/app-utils/live-document-count.client.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../libs/aglyn/src/lib/app-utils/live-document-count.client.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { getCountFromServer, query, where, type Query } from 'firebase/firestore'\nimport { liveDocumentCount, TOMBSTONE_FIELD } from './live-document-count'\n\n/**\n * The web SDK's half of the live-count rule (AGL-3918): how many of\n * [documents] are not deleted, as `/api/hosts/resources` counts them for a\n * plan allowance. Every document less the tombstones (`deletedAt != null`);\n * an archived document is live and counted. See `live-document-count.ts` for\n * why it is two aggregates.\n *\n * Rejects when either aggregate is refused, so a caller keeps whatever\n * fallback it already has rather than reading a confident 0.\n */\nexport async function getLiveCountFromServer(documents: Query): Promise<number> {\n  const [total, tombstones] = await Promise.all([\n    getCountFromServer(documents),\n    getCountFromServer(query(documents, where(TOMBSTONE_FIELD, '!=', null))),\n  ])\n  return liveDocumentCount(total.data().count, tombstones.data().count)\n}\n"],"names":["getCountFromServer","query","where","liveDocumentCount","TOMBSTONE_FIELD","getLiveCountFromServer","documents","total","tombstones","Promise","all","data","count"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED,SAASA,kBAAkB,EAAEC,KAAK,EAAEC,KAAK,QAAoB,qBAAoB;AACjF,SAASC,iBAAiB,EAAEC,eAAe,QAAQ,2BAAuB;AAE1E;;;;;;;;;CASC,GACD,OAAO,eAAeC,uBAAuBC,SAAgB;IAC3D,MAAM,CAACC,OAAOC,WAAW,GAAG,MAAMC,QAAQC,GAAG,CAAC;QAC5CV,mBAAmBM;QACnBN,mBAAmBC,MAAMK,WAAWJ,MAAME,iBAAiB,MAAM;KAClE;IACD,OAAOD,kBAAkBI,MAAMI,IAAI,GAAGC,KAAK,EAAEJ,WAAWG,IAAI,GAAGC,KAAK;AACtE"}

package/src/lib/app-utils/live-document-count.d.ts

@@ -0,0 +1,91 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * How a plan allowance counts a collection whose delete is a SOFT delete
+ * (AGL-3918).
+ *
+ * The rule: a deleted document frees its slot, an archived one keeps it.
+ * Deleting stamps `deletedAt` and leaves the document in place (a tenant page
+ * keeps grafting until its next revalidate, a past order still names the
+ * product), so a plain `count()` charged a site for everything it had ever
+ * deleted: a product deleted on Starter never gave its slot back, and the
+ * Automation card read "4/25 workflows" beside a list of three. Archiving is a
+ * status the owner can reverse in place, so an archived product or a disabled
+ * workflow is still counted.
+ *
+ * ## Why total minus tombstones
+ *
+ * A live document has no `deletedAt` at all (created through
+ * `/api/hosts/resources`) or an explicit `deletedAt: null` (every product
+ * writer, a marketplace install). Firestore cannot match an absent field, so
+ * `where('deletedAt', '==', null)` counts the second shape alone. The
+ * TOMBSTONES are one shape — a value that is not `null` — and
+ * `where('deletedAt', '!=', null)` matches exactly them, so the total less
+ * that count is exactly the documents the server calls live. Two aggregates,
+ * one billed read each at these sizes, on the automatic single-field index
+ * `deletedAt` already has; no composite index.
+ *
+ * This module is SDK-agnostic: it names the Admin SDK's query shape
+ * structurally so a plugin, core and the console reach it without a second
+ * copy of the rule. The web SDK's counterpart is
+ * `live-document-count.client.ts`.
+ */
+/** The field every soft-deleting collection stamps on delete. */
+export declare const TOMBSTONE_FIELD = "deletedAt";
+/** The live count from the two aggregates, never below zero: they are separate reads, and a delete landing between them can make the second the larger. */
+export declare function liveDocumentCount(total: number, tombstones: number): number;
+/** Whether a stored document is live: no `deletedAt`, or `deletedAt: null`. */
+export declare function isLiveDocument(deletedAt: unknown): boolean;
+/** An aggregate query's snapshot, as the Admin SDK's `AggregateQuerySnapshot` answers it. */
+export interface LiveCountSnapshot {
+    data(): {
+        count: number;
+    };
+}
+/** An aggregate query the Admin SDK can execute directly. */
+export interface LiveCountAggregate {
+    get(): Promise<LiveCountSnapshot>;
+}
+/** A collection or query the Admin SDK can count and filter. */
+export interface LiveCountQuery<A extends LiveCountAggregate> {
+    count(): A;
+    where(field: string, op: '!=', value: null): {
+        count(): A;
+    };
+}
+/**
+ * The live documents [documents] matches: every one less the tombstones.
+ *
+ * `read` executes each aggregate, and defaults to executing it directly. A
+ * create that counts and writes in one transaction passes
+ * `(aggregate) => tx.get(aggregate)`, so both counts are the TRANSACTION's
+ * reads and the lock they take serializes a concurrent create (AGL-2231).
+ */
+export declare function countLiveDocuments<A extends LiveCountAggregate>(documents: LiveCountQuery<A>, read?: (aggregate: A) => Promise<LiveCountSnapshot>): Promise<number>;
+/** The `source.type` a platform-seeded starter template carries (AGL-687). */
+export declare const STARTER_TEMPLATE_SOURCE = "starter";
+/**
+ * Of a site's deleted templates, how many `templatesPerHost`'s first count
+ * included: `where('source.type', '!=', 'starter')` matches a template that
+ * carries a `source.type` other than a starter's, and skips one without the
+ * field. Subtracting these from that count leaves the live templates the
+ * allowance counts, without the composite index a second inequality on
+ * `deletedAt` beside it would need.
+ */
+export declare function deletedTemplatesCounted(tombstones: ReadonlyArray<{
+    get(field: string): unknown;
+}>): number;

package/src/lib/app-utils/live-document-count.js

@@ -0,0 +1,81 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */ /**
+ * How a plan allowance counts a collection whose delete is a SOFT delete
+ * (AGL-3918).
+ *
+ * The rule: a deleted document frees its slot, an archived one keeps it.
+ * Deleting stamps `deletedAt` and leaves the document in place (a tenant page
+ * keeps grafting until its next revalidate, a past order still names the
+ * product), so a plain `count()` charged a site for everything it had ever
+ * deleted: a product deleted on Starter never gave its slot back, and the
+ * Automation card read "4/25 workflows" beside a list of three. Archiving is a
+ * status the owner can reverse in place, so an archived product or a disabled
+ * workflow is still counted.
+ *
+ * ## Why total minus tombstones
+ *
+ * A live document has no `deletedAt` at all (created through
+ * `/api/hosts/resources`) or an explicit `deletedAt: null` (every product
+ * writer, a marketplace install). Firestore cannot match an absent field, so
+ * `where('deletedAt', '==', null)` counts the second shape alone. The
+ * TOMBSTONES are one shape — a value that is not `null` — and
+ * `where('deletedAt', '!=', null)` matches exactly them, so the total less
+ * that count is exactly the documents the server calls live. Two aggregates,
+ * one billed read each at these sizes, on the automatic single-field index
+ * `deletedAt` already has; no composite index.
+ *
+ * This module is SDK-agnostic: it names the Admin SDK's query shape
+ * structurally so a plugin, core and the console reach it without a second
+ * copy of the rule. The web SDK's counterpart is
+ * `live-document-count.client.ts`.
+ */ /** The field every soft-deleting collection stamps on delete. */ export const TOMBSTONE_FIELD = 'deletedAt';
+/** The live count from the two aggregates, never below zero: they are separate reads, and a delete landing between them can make the second the larger. */ export function liveDocumentCount(total, tombstones) {
+    return Math.max(0, (Number(total) || 0) - (Number(tombstones) || 0));
+}
+/** Whether a stored document is live: no `deletedAt`, or `deletedAt: null`. */ export function isLiveDocument(deletedAt) {
+    return deletedAt == null;
+}
+/**
+ * The live documents [documents] matches: every one less the tombstones.
+ *
+ * `read` executes each aggregate, and defaults to executing it directly. A
+ * create that counts and writes in one transaction passes
+ * `(aggregate) => tx.get(aggregate)`, so both counts are the TRANSACTION's
+ * reads and the lock they take serializes a concurrent create (AGL-2231).
+ */ export async function countLiveDocuments(documents, read = (aggregate)=>aggregate.get()) {
+    const [total, tombstones] = await Promise.all([
+        read(documents.count()),
+        read(documents.where(TOMBSTONE_FIELD, '!=', null).count())
+    ]);
+    return liveDocumentCount(total.data().count, tombstones.data().count);
+}
+/** The `source.type` a platform-seeded starter template carries (AGL-687). */ export const STARTER_TEMPLATE_SOURCE = 'starter';
+/**
+ * Of a site's deleted templates, how many `templatesPerHost`'s first count
+ * included: `where('source.type', '!=', 'starter')` matches a template that
+ * carries a `source.type` other than a starter's, and skips one without the
+ * field. Subtracting these from that count leaves the live templates the
+ * allowance counts, without the composite index a second inequality on
+ * `deletedAt` beside it would need.
+ */ export function deletedTemplatesCounted(tombstones) {
+    return tombstones.filter((entry)=>{
+        const type = entry.get('source.type');
+        return type != null && type !== STARTER_TEMPLATE_SOURCE;
+    }).length;
+}
+
+//# sourceMappingURL=live-document-count.js.map

package/src/lib/app-utils/live-document-count.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../libs/aglyn/src/lib/app-utils/live-document-count.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\n/**\n * How a plan allowance counts a collection whose delete is a SOFT delete\n * (AGL-3918).\n *\n * The rule: a deleted document frees its slot, an archived one keeps it.\n * Deleting stamps `deletedAt` and leaves the document in place (a tenant page\n * keeps grafting until its next revalidate, a past order still names the\n * product), so a plain `count()` charged a site for everything it had ever\n * deleted: a product deleted on Starter never gave its slot back, and the\n * Automation card read \"4/25 workflows\" beside a list of three. Archiving is a\n * status the owner can reverse in place, so an archived product or a disabled\n * workflow is still counted.\n *\n * ## Why total minus tombstones\n *\n * A live document has no `deletedAt` at all (created through\n * `/api/hosts/resources`) or an explicit `deletedAt: null` (every product\n * writer, a marketplace install). Firestore cannot match an absent field, so\n * `where('deletedAt', '==', null)` counts the second shape alone. The\n * TOMBSTONES are one shape — a value that is not `null` — and\n * `where('deletedAt', '!=', null)` matches exactly them, so the total less\n * that count is exactly the documents the server calls live. Two aggregates,\n * one billed read each at these sizes, on the automatic single-field index\n * `deletedAt` already has; no composite index.\n *\n * This module is SDK-agnostic: it names the Admin SDK's query shape\n * structurally so a plugin, core and the console reach it without a second\n * copy of the rule. The web SDK's counterpart is\n * `live-document-count.client.ts`.\n */\n\n/** The field every soft-deleting collection stamps on delete. */\nexport const TOMBSTONE_FIELD = 'deletedAt'\n\n/** The live count from the two aggregates, never below zero: they are separate reads, and a delete landing between them can make the second the larger. */\nexport function liveDocumentCount(total: number, tombstones: number): number {\n  return Math.max(0, (Number(total) || 0) - (Number(tombstones) || 0))\n}\n\n/** Whether a stored document is live: no `deletedAt`, or `deletedAt: null`. */\nexport function isLiveDocument(deletedAt: unknown): boolean {\n  return deletedAt == null\n}\n\n/** An aggregate query's snapshot, as the Admin SDK's `AggregateQuerySnapshot` answers it. */\nexport interface LiveCountSnapshot {\n  data(): { count: number }\n}\n\n/** An aggregate query the Admin SDK can execute directly. */\nexport interface LiveCountAggregate {\n  get(): Promise<LiveCountSnapshot>\n}\n\n/** A collection or query the Admin SDK can count and filter. */\nexport interface LiveCountQuery<A extends LiveCountAggregate> {\n  count(): A\n  where(field: string, op: '!=', value: null): { count(): A }\n}\n\n/**\n * The live documents [documents] matches: every one less the tombstones.\n *\n * `read` executes each aggregate, and defaults to executing it directly. A\n * create that counts and writes in one transaction passes\n * `(aggregate) => tx.get(aggregate)`, so both counts are the TRANSACTION's\n * reads and the lock they take serializes a concurrent create (AGL-2231).\n */\nexport async function countLiveDocuments<A extends LiveCountAggregate>(\n  documents: LiveCountQuery<A>,\n  read: (aggregate: A) => Promise<LiveCountSnapshot> = (aggregate) => aggregate.get(),\n): Promise<number> {\n  const [total, tombstones] = await Promise.all([\n    read(documents.count()),\n    read(documents.where(TOMBSTONE_FIELD, '!=', null).count()),\n  ])\n  return liveDocumentCount(total.data().count, tombstones.data().count)\n}\n\n/** The `source.type` a platform-seeded starter template carries (AGL-687). */\nexport const STARTER_TEMPLATE_SOURCE = 'starter'\n\n/**\n * Of a site's deleted templates, how many `templatesPerHost`'s first count\n * included: `where('source.type', '!=', 'starter')` matches a template that\n * carries a `source.type` other than a starter's, and skips one without the\n * field. Subtracting these from that count leaves the live templates the\n * allowance counts, without the composite index a second inequality on\n * `deletedAt` beside it would need.\n */\nexport function deletedTemplatesCounted(\n  tombstones: ReadonlyArray<{ get(field: string): unknown }>,\n): number {\n  return tombstones.filter((entry) => {\n    const type = entry.get('source.type')\n    return type != null && type !== STARTER_TEMPLATE_SOURCE\n  }).length\n}\n"],"names":["TOMBSTONE_FIELD","liveDocumentCount","total","tombstones","Math","max","Number","isLiveDocument","deletedAt","countLiveDocuments","documents","read","aggregate","get","Promise","all","count","where","data","STARTER_TEMPLATE_SOURCE","deletedTemplatesCounted","filter","entry","type","length"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA6BC,GAED,+DAA+D,GAC/D,OAAO,MAAMA,kBAAkB,YAAW;AAE1C,yJAAyJ,GACzJ,OAAO,SAASC,kBAAkBC,KAAa,EAAEC,UAAkB;IACjE,OAAOC,KAAKC,GAAG,CAAC,GAAG,AAACC,CAAAA,OAAOJ,UAAU,CAAA,IAAMI,CAAAA,OAAOH,eAAe,CAAA;AACnE;AAEA,6EAA6E,GAC7E,OAAO,SAASI,eAAeC,SAAkB;IAC/C,OAAOA,aAAa;AACtB;AAkBA;;;;;;;CAOC,GACD,OAAO,eAAeC,mBACpBC,SAA4B,EAC5BC,OAAqD,CAACC,YAAcA,UAAUC,GAAG,EAAE;IAEnF,MAAM,CAACX,OAAOC,WAAW,GAAG,MAAMW,QAAQC,GAAG,CAAC;QAC5CJ,KAAKD,UAAUM,KAAK;QACpBL,KAAKD,UAAUO,KAAK,CAACjB,iBAAiB,MAAM,MAAMgB,KAAK;KACxD;IACD,OAAOf,kBAAkBC,MAAMgB,IAAI,GAAGF,KAAK,EAAEb,WAAWe,IAAI,GAAGF,KAAK;AACtE;AAEA,4EAA4E,GAC5E,OAAO,MAAMG,0BAA0B,UAAS;AAEhD;;;;;;;CAOC,GACD,OAAO,SAASC,wBACdjB,UAA0D;IAE1D,OAAOA,WAAWkB,MAAM,CAAC,CAACC;QACxB,MAAMC,OAAOD,MAAMT,GAAG,CAAC;QACvB,OAAOU,QAAQ,QAAQA,SAASJ;IAClC,GAAGK,MAAM;AACX"}

package/src/lib/app-utils/notification-sounds.d.ts

@@ -0,0 +1,49 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * The notification sounds a person picks from (Notification settings), the
+ * same on every surface: the console's chime, the APNs `sound` the Apple apps
+ * play and the Android notification channel.
+ *
+ * NO IMPORTS, on purpose: the native apps read this list through the
+ * generated contracts, so it must stay a plain module.
+ *
+ * The audio is synthesized by `tools/notification-sounds/generate.py`, which
+ * writes each sound to the three paths named here; the two lists name the
+ * same ids.
+ */
+/** `users/{uid}.notificationSound`: the id of the sound the person picked. */
+export declare const NOTIFICATION_SOUND_FIELD = "notificationSound";
+export interface NotificationSound {
+    id: string;
+    label: string;
+    /** The console's file, served from `apps/console/public`. */
+    web: string;
+    /** The file in both Apple apps' bundles, named in the APNs payload's `sound`. */
+    apple: string;
+    /**
+     * The Android raw resource and the notification channel that plays it. A
+     * channel's sound cannot change once created, so each sound has its own.
+     */
+    android: string;
+}
+/** In the order the picker lists them; the first is the default. */
+export declare const NOTIFICATION_SOUNDS: readonly NotificationSound[];
+/** What a person hears before they pick one. */
+export declare const DEFAULT_NOTIFICATION_SOUND = "xylophone";
+/** The stored pick as a sound, the default for no pick or an id no longer listed. */
+export declare function notificationSound(value: unknown): NotificationSound;

package/src/lib/app-utils/notification-sounds.js

@@ -0,0 +1,54 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */ /**
+ * The notification sounds a person picks from (Notification settings), the
+ * same on every surface: the console's chime, the APNs `sound` the Apple apps
+ * play and the Android notification channel.
+ *
+ * NO IMPORTS, on purpose: the native apps read this list through the
+ * generated contracts, so it must stay a plain module.
+ *
+ * The audio is synthesized by `tools/notification-sounds/generate.py`, which
+ * writes each sound to the three paths named here; the two lists name the
+ * same ids.
+ */ /** `users/{uid}.notificationSound`: the id of the sound the person picked. */ export const NOTIFICATION_SOUND_FIELD = 'notificationSound';
+function sound(id, label) {
+    return {
+        id,
+        label,
+        web: `/sounds/notifications/${id}.wav`,
+        apple: `aglyn-${id}.caf`,
+        android: `aglyn_sound_${id}`
+    };
+}
+/** In the order the picker lists them; the first is the default. */ export const NOTIFICATION_SOUNDS = [
+    sound('xylophone', 'Xylophone'),
+    sound('signature', 'Signature'),
+    sound('tada', 'Ta-da'),
+    sound('plink', 'Plink'),
+    sound('arcade', 'Arcade'),
+    sound('cowbell', 'Cowbell'),
+    sound('bubbles', 'Bubbles'),
+    sound('steel_pan', 'Steel pan'),
+    sound('cash_register', 'Cash register')
+];
+/** What a person hears before they pick one. */ export const DEFAULT_NOTIFICATION_SOUND = 'xylophone';
+/** The stored pick as a sound, the default for no pick or an id no longer listed. */ export function notificationSound(value) {
+    var _NOTIFICATION_SOUNDS_find;
+    return (_NOTIFICATION_SOUNDS_find = NOTIFICATION_SOUNDS.find((entry)=>entry.id === value)) != null ? _NOTIFICATION_SOUNDS_find : NOTIFICATION_SOUNDS.find((entry)=>entry.id === DEFAULT_NOTIFICATION_SOUND);
+}
+
+//# sourceMappingURL=notification-sounds.js.map

package/src/lib/app-utils/notification-sounds.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../libs/aglyn/src/lib/app-utils/notification-sounds.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\n/**\n * The notification sounds a person picks from (Notification settings), the\n * same on every surface: the console's chime, the APNs `sound` the Apple apps\n * play and the Android notification channel.\n *\n * NO IMPORTS, on purpose: the native apps read this list through the\n * generated contracts, so it must stay a plain module.\n *\n * The audio is synthesized by `tools/notification-sounds/generate.py`, which\n * writes each sound to the three paths named here; the two lists name the\n * same ids.\n */\n\n/** `users/{uid}.notificationSound`: the id of the sound the person picked. */\nexport const NOTIFICATION_SOUND_FIELD = 'notificationSound'\n\nexport interface NotificationSound {\n  id: string\n  label: string\n  /** The console's file, served from `apps/console/public`. */\n  web: string\n  /** The file in both Apple apps' bundles, named in the APNs payload's `sound`. */\n  apple: string\n  /**\n   * The Android raw resource and the notification channel that plays it. A\n   * channel's sound cannot change once created, so each sound has its own.\n   */\n  android: string\n}\n\nfunction sound(id: string, label: string): NotificationSound {\n  return {\n    id,\n    label,\n    web: `/sounds/notifications/${id}.wav`,\n    apple: `aglyn-${id}.caf`,\n    android: `aglyn_sound_${id}`,\n  }\n}\n\n/** In the order the picker lists them; the first is the default. */\nexport const NOTIFICATION_SOUNDS: readonly NotificationSound[] = [\n  sound('xylophone', 'Xylophone'),\n  sound('signature', 'Signature'),\n  sound('tada', 'Ta-da'),\n  sound('plink', 'Plink'),\n  sound('arcade', 'Arcade'),\n  sound('cowbell', 'Cowbell'),\n  sound('bubbles', 'Bubbles'),\n  sound('steel_pan', 'Steel pan'),\n  sound('cash_register', 'Cash register'),\n]\n\n/** What a person hears before they pick one. */\nexport const DEFAULT_NOTIFICATION_SOUND = 'xylophone'\n\n/** The stored pick as a sound, the default for no pick or an id no longer listed. */\nexport function notificationSound(value: unknown): NotificationSound {\n  return (\n    NOTIFICATION_SOUNDS.find((entry) => entry.id === value) ??\n    (NOTIFICATION_SOUNDS.find((entry) => entry.id === DEFAULT_NOTIFICATION_SOUND) as NotificationSound)\n  )\n}\n"],"names":["NOTIFICATION_SOUND_FIELD","sound","id","label","web","apple","android","NOTIFICATION_SOUNDS","DEFAULT_NOTIFICATION_SOUND","notificationSound","value","find","entry"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED;;;;;;;;;;;CAWC,GAED,4EAA4E,GAC5E,OAAO,MAAMA,2BAA2B,oBAAmB;AAgB3D,SAASC,MAAMC,EAAU,EAAEC,KAAa;IACtC,OAAO;QACLD;QACAC;QACAC,KAAK,CAAC,sBAAsB,EAAEF,GAAG,IAAI,CAAC;QACtCG,OAAO,CAAC,MAAM,EAAEH,GAAG,IAAI,CAAC;QACxBI,SAAS,CAAC,YAAY,EAAEJ,IAAI;IAC9B;AACF;AAEA,kEAAkE,GAClE,OAAO,MAAMK,sBAAoD;IAC/DN,MAAM,aAAa;IACnBA,MAAM,aAAa;IACnBA,MAAM,QAAQ;IACdA,MAAM,SAAS;IACfA,MAAM,UAAU;IAChBA,MAAM,WAAW;IACjBA,MAAM,WAAW;IACjBA,MAAM,aAAa;IACnBA,MAAM,iBAAiB;CACxB,CAAA;AAED,8CAA8C,GAC9C,OAAO,MAAMO,6BAA6B,YAAW;AAErD,mFAAmF,GACnF,OAAO,SAASC,kBAAkBC,KAAc;QAE5CH;IADF,QACEA,4BAAAA,oBAAoBI,IAAI,CAAC,CAACC,QAAUA,MAAMV,EAAE,KAAKQ,kBAAjDH,4BACCA,oBAAoBI,IAAI,CAAC,CAACC,QAAUA,MAAMV,EAAE,KAAKM;AAEtD"}

package/src/lib/app-utils/notifications.d.ts

@@ -349,6 +349,8 @@ export declare const NOTIFICATION_CHANNEL_DEFAULTS: Readonly<Record<Notification
  * see {@link NOTIFICATION_SELF_SENT_EMAIL_TYPES} and the `skipEmail` callers.
  */
 export declare const NOTIFICATION_TYPE_CHANNEL_DEFAULTS: Partial<Record<AglynNotificationType, Partial<Record<NotificationChannel, boolean>>>>;
+/** The words on a notification email's button: the record it opens, else "Open in {product}". */
+export declare function notificationEmailAction(type: AglynNotificationType | string, productName: string): string;
 /** What a type does on a channel when nobody has answered for it or its category. */
 export declare function notificationTypeChannelDefault(type: AglynNotificationType | string, channel: NotificationChannel): boolean;
 /**

package/src/lib/app-utils/notifications.js

@@ -300,7 +300,7 @@ export const NOTIFICATION_SETTINGS_FIELD = 'notificationSettings';
 /**
  * What a category does when nobody has said otherwise.
  *
- * Console on, email OFF, for every category. The types a person needs to hear
+ * Console on, email OFF, for every category but `staff`. The types a person needs to hear
  * about without opening the console are the exception, by type, in
  * {@link NOTIFICATION_TYPE_CHANNEL_DEFAULTS}. Email defaults off because the inbox is
  * not ours to fill: the product already sends transactional mail nobody opted
@@ -335,13 +335,13 @@ export const NOTIFICATION_SETTINGS_FIELD = 'notificationSettings';
         console: true,
         email: false
     },
-    // Console ON, because the complaint this answers is that staff never heard
-    // about a sign-up at all; email off, like everything else, because that is
-    // what the channel defaults to and a sign-up is not urgent enough to be the
-    // exception that starts filling inboxes by default.
+    // Console and email ON: staff are the platform's own people, every one of
+    // them is meant to hear about growth and money moving, and an account that
+    // never opened its settings heard about almost none of it. The one category
+    // whose recipients are all us, so the inbox reasoning above does not apply.
     staff: {
         console: true,
-        email: false
+        email: true
     }
 };
 export const NOTIFICATION_CHANNEL_DEFAULTS = inCategoryOrder(CORE_CHANNEL_DEFAULTS, (declaration)=>_extends({}, declaration.defaults));
@@ -437,12 +437,40 @@ export const NOTIFICATION_CHANNEL_DEFAULTS = inCategoryOrder(CORE_CHANNEL_DEFAUL
     },
     'system.disputeUnattributed': {
         email: true
-    },
-    // Staff hear when somebody starts building.
-    'staff.siteCreated': {
-        email: true
     }
 };
+/**
+ * What a notification email's button says it opens (AGL-3897), by type: the
+ * record the notification links to, named, rather than "Open in Aglyn" on
+ * every one. A type with no entry keeps that general label.
+ */ const NOTIFICATION_EMAIL_ACTIONS = {
+    'content.formSubmission': 'View submission',
+    'content.booking': 'View booking',
+    'content.order': 'View order',
+    'content.lowStock': 'View product',
+    'content.taskAssigned': 'Open task',
+    'content.taskReminder': 'Open task',
+    'content.contactAssigned': 'Open contact',
+    'content.leadAssigned': 'Open lead',
+    'billing.invoice': 'Open billing',
+    'billing.paymentFailed': 'Update payment method',
+    'billing.subscriptionCanceled': 'Open billing',
+    'billing.usage': 'Open billing',
+    'support.ticketOpened': 'Open ticket',
+    'support.ticketReply': 'Open ticket',
+    'marketplace.review': 'Open listing',
+    'staff.userSignedUp': 'Open account',
+    'staff.orgCreated': 'Open workspace',
+    'staff.siteCreated': 'Open site',
+    'staff.subscriptionStarted': 'Open workspace',
+    'staff.subscriptionCanceled': 'Open workspace',
+    'staff.planChanged': 'Open workspace',
+    'staff.paymentFailed': 'Open workspace'
+};
+/** The words on a notification email's button: the record it opens, else "Open in {product}". */ export function notificationEmailAction(type, productName) {
+    var _NOTIFICATION_EMAIL_ACTIONS_type;
+    return (_NOTIFICATION_EMAIL_ACTIONS_type = NOTIFICATION_EMAIL_ACTIONS[type]) != null ? _NOTIFICATION_EMAIL_ACTIONS_type : `Open in ${productName}`;
+}
 /** What a type does on a channel when nobody has answered for it or its category. */ export function notificationTypeChannelDefault(type, channel) {
     var _NOTIFICATION_TYPE_CHANNEL_DEFAULTS_type;
     const own = (_NOTIFICATION_TYPE_CHANNEL_DEFAULTS_type = NOTIFICATION_TYPE_CHANNEL_DEFAULTS[type]) == null ? void 0 : _NOTIFICATION_TYPE_CHANNEL_DEFAULTS_type[channel];