@aglyn/aglyn 1.0.0-beta.206 → 1.0.0-beta.209

package/src/lib/app-utils/host-transfer.d.ts

@@ -0,0 +1,55 @@
+/**
+ * @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.
+ */
+/** Why a transfer cannot go ahead, in words a staffer can act on. */
+export interface HostTransferHold {
+    code: 'no-site' | 'no-destination' | 'same-organization' | 'consent-group' | 'site-limit' | 'sending-domain' | 'in-flight';
+    message: string;
+}
+/** Everything a transfer would do, and everything it would not. */
+export interface HostTransferPlan {
+    hostId: string;
+    siteName: string | null;
+    fromOrgId: string | null;
+    fromOrgName: string | null;
+    toOrgId: string;
+    toOrgName: string | null;
+    /** Refusals. The transfer runs only when this is empty. */
+    holds: HostTransferHold[];
+    /** What is true after the transfer that a staffer should say out loud. */
+    warnings: string[];
+    facts: {
+        /** Media in the old organization's library scoped to this site. */
+        mediaStaying: number;
+        /** Plugin documents the site owns that stay as the old organization's history. */
+        ownedDocumentsStaying: Array<{
+            collection: string;
+            count: number;
+        }>;
+        /** Old members whose only reach into the site was a per-site grant. */
+        collaboratorsLosingAccess: number;
+        /** The dedicated sending domain that moves with the site, if any. */
+        sendingDomain: string | null;
+        /** Plugins the site runs now that the destination does not enable. */
+        pluginsLost: string[];
+        /** The destination's sites against its limit. */
+        siteLimit: {
+            used: number;
+            limit: number;
+            allowed: boolean;
+        };
+    };
+}

package/src/lib/app-utils/host-transfer.js

@@ -0,0 +1,23 @@
+/**
+ * @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.
+ */ /*
+ * What moving a site to another organization would do (AGL-3381), as the
+ * staff console's confirmation reads it. Planned and performed by
+ * `transferHost` in `@aglyn/tenant-data-admin/server/transfer-host`; the
+ * shape lives here so the dialog can read it without reaching a server module.
+ */ /** Why a transfer cannot go ahead, in words a staffer can act on. */ /** Everything a transfer would do, and everything it would not. */ export { };
+
+//# sourceMappingURL=host-transfer.js.map

package/src/lib/app-utils/host-transfer.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../libs/aglyn/src/lib/app-utils/host-transfer.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 * What moving a site to another organization would do (AGL-3381), as the\n * staff console's confirmation reads it. Planned and performed by\n * `transferHost` in `@aglyn/tenant-data-admin/server/transfer-host`; the\n * shape lives here so the dialog can read it without reaching a server module.\n */\n\n/** Why a transfer cannot go ahead, in words a staffer can act on. */\nexport interface HostTransferHold {\n  code:\n    | 'no-site'\n    | 'no-destination'\n    | 'same-organization'\n    | 'consent-group'\n    | 'site-limit'\n    | 'sending-domain'\n    | 'in-flight'\n  message: string\n}\n\n/** Everything a transfer would do, and everything it would not. */\nexport interface HostTransferPlan {\n  hostId: string\n  siteName: string | null\n  fromOrgId: string | null\n  fromOrgName: string | null\n  toOrgId: string\n  toOrgName: string | null\n  /** Refusals. The transfer runs only when this is empty. */\n  holds: HostTransferHold[]\n  /** What is true after the transfer that a staffer should say out loud. */\n  warnings: string[]\n  facts: {\n    /** Media in the old organization's library scoped to this site. */\n    mediaStaying: number\n    /** Plugin documents the site owns that stay as the old organization's history. */\n    ownedDocumentsStaying: Array<{ collection: string; count: number }>\n    /** Old members whose only reach into the site was a per-site grant. */\n    collaboratorsLosingAccess: number\n    /** The dedicated sending domain that moves with the site, if any. */\n    sendingDomain: string | null\n    /** Plugins the site runs now that the destination does not enable. */\n    pluginsLost: string[]\n    /** The destination's sites against its limit. */\n    siteLimit: { used: number; limit: number; allowed: boolean }\n  }\n}\n\n"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED;;;;;CAKC,GAED,mEAAmE,GAanE,iEAAiE,GACjE,WAyBC"}

package/src/lib/app-utils/local-business.d.ts

@@ -0,0 +1,161 @@
+/**
+ * @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.
+ */
+/**
+ * A site entity that is a LOCAL BUSINESS (AGL-3383).
+ *
+ * `host.seo.entity.type` answers Organization or Person and keeps answering
+ * it: it is a numeric enum stored as `"1"`/`"2"`, read by the author editor,
+ * the logo card and the AI audit, and a third value there would be a third
+ * value each of them has to learn. A plumber is still an Organization — the
+ * business type REFINES that answer rather than replacing it — so it is a
+ * field of its own, `businessType`, holding the `schema.org` subtype name.
+ *
+ * Every value is checked against {@link LOCAL_BUSINESS_TYPES}, which the
+ * console's Select is built from too. A stored value outside it (a typo, a
+ * type removed from the list) publishes the plain Organization it would have
+ * published before the field existed, rather than an `@type` no consumer
+ * recognizes.
+ */
+/** The `schema.org` LocalBusiness subtypes a site can declare, with their console labels. */
+export declare const LOCAL_BUSINESS_TYPES: readonly [{
+    readonly value: "LocalBusiness";
+    readonly label: "Local business (general)";
+}, {
+    readonly value: "HomeAndConstructionBusiness";
+    readonly label: "Home and construction";
+}, {
+    readonly value: "GeneralContractor";
+    readonly label: "General contractor";
+}, {
+    readonly value: "HousePainter";
+    readonly label: "House painter";
+}, {
+    readonly value: "Plumber";
+    readonly label: "Plumber";
+}, {
+    readonly value: "Electrician";
+    readonly label: "Electrician";
+}, {
+    readonly value: "HVACBusiness";
+    readonly label: "Heating and air (HVAC)";
+}, {
+    readonly value: "Locksmith";
+    readonly label: "Locksmith";
+}, {
+    readonly value: "RoofingContractor";
+    readonly label: "Roofing contractor";
+}, {
+    readonly value: "MovingCompany";
+    readonly label: "Moving company";
+}, {
+    readonly value: "ProfessionalService";
+    readonly label: "Professional service";
+}, {
+    readonly value: "Store";
+    readonly label: "Store";
+}, {
+    readonly value: "FoodEstablishment";
+    readonly label: "Food and drink";
+}, {
+    readonly value: "Restaurant";
+    readonly label: "Restaurant";
+}, {
+    readonly value: "HealthAndBeautyBusiness";
+    readonly label: "Health and beauty";
+}, {
+    readonly value: "MedicalBusiness";
+    readonly label: "Medical practice";
+}, {
+    readonly value: "Dentist";
+    readonly label: "Dentist";
+}, {
+    readonly value: "AutomotiveBusiness";
+    readonly label: "Automotive";
+}, {
+    readonly value: "LegalService";
+    readonly label: "Legal service";
+}, {
+    readonly value: "AccountingService";
+    readonly label: "Accounting";
+}, {
+    readonly value: "RealEstateAgent";
+    readonly label: "Real estate agent";
+}, {
+    readonly value: "SportsActivityLocation";
+    readonly label: "Gym, sports or fitness";
+}, {
+    readonly value: "ChildCare";
+    readonly label: "Child care";
+}, {
+    readonly value: "AnimalShelter";
+    readonly label: "Animal shelter";
+}];
+export type LocalBusinessType = (typeof LOCAL_BUSINESS_TYPES)[number]['value'];
+/** At most this many areas are published; a service area is a list, not a gazetteer. */
+export declare const AREA_SERVED_MAX = 20;
+export declare const AREA_SERVED_NAME_MAX_LENGTH = 120;
+/** Seven days, twice over — room for split shifts without inviting a timetable. */
+export declare const OPENING_HOURS_MAX_ROWS = 14;
+/** Google reads a price range past 100 characters as not being one. */
+export declare const PRICE_RANGE_MAX_LENGTH = 100;
+export declare const PAYMENT_ACCEPTED_MAX_LENGTH = 200;
+/**
+ * The stored business type, as the `schema.org` name it publishes under, or
+ * `undefined` when there is none or it is not on the list.
+ *
+ * Case-insensitive, returning the canonical spelling, because `@type` is
+ * case-sensitive to every consumer and `plumber` would name nothing.
+ */
+export declare function localBusinessType(value: unknown): LocalBusinessType | undefined;
+/**
+ * The areas a business serves: trimmed, blanks dropped, de-duplicated without
+ * regard to case, and capped.
+ *
+ * Accepts the stored array or a newline-separated string, so a value typed
+ * into the console's text box reads the same whichever shape reached the
+ * document.
+ */
+export declare function normalizeAreaServed(value: unknown): string[];
+declare const DAYS: readonly ["Monday", "Tuesday", "Wednesday", "Thursday", "Friday", "Saturday", "Sunday"];
+export type OpeningHoursDay = (typeof DAYS)[number];
+/** One line of opening hours: these days, from `opens` to `closes`. */
+export interface OpeningHoursRow {
+    days: OpeningHoursDay[];
+    /** `HH:MM`, 24-hour. */
+    opens: string;
+    /** `HH:MM`, 24-hour. Earlier than `opens` means the next morning. */
+    closes: string;
+}
+/**
+ * Opening hours, one line per set of days, in the syntax `schema.org`'s own
+ * `openingHours` text uses: `Mo-Fr 09:00-17:00`, `Sa 10:00-14:00`,
+ * `Mo,We,Fr 08:00-12:00`.
+ *
+ * A text box rather than a repeating group of pickers because it is what the
+ * settings forms can hold without a new control, and because it is the form
+ * a business already writes its hours in. A line that does not read — a
+ * mistyped day, `25:00` — is DROPPED rather than guessed at: a published
+ * opening time is a promise a customer drives across town on.
+ */
+export declare function parseOpeningHours(value: unknown): OpeningHoursRow[];
+/**
+ * The 1-based numbers of the lines {@link parseOpeningHours} would drop, so
+ * the console can say which one before it is saved rather than after it
+ * silently fails to publish. Blank lines are not problems.
+ */
+export declare function invalidOpeningHoursLines(value: unknown): number[];
+export {};

package/src/lib/app-utils/local-business.js

@@ -0,0 +1,253 @@
+/**
+ * @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.
+ */ /**
+ * A site entity that is a LOCAL BUSINESS (AGL-3383).
+ *
+ * `host.seo.entity.type` answers Organization or Person and keeps answering
+ * it: it is a numeric enum stored as `"1"`/`"2"`, read by the author editor,
+ * the logo card and the AI audit, and a third value there would be a third
+ * value each of them has to learn. A plumber is still an Organization — the
+ * business type REFINES that answer rather than replacing it — so it is a
+ * field of its own, `businessType`, holding the `schema.org` subtype name.
+ *
+ * Every value is checked against {@link LOCAL_BUSINESS_TYPES}, which the
+ * console's Select is built from too. A stored value outside it (a typo, a
+ * type removed from the list) publishes the plain Organization it would have
+ * published before the field existed, rather than an `@type` no consumer
+ * recognizes.
+ */ /** The `schema.org` LocalBusiness subtypes a site can declare, with their console labels. */ export const LOCAL_BUSINESS_TYPES = [
+    {
+        value: 'LocalBusiness',
+        label: 'Local business (general)'
+    },
+    {
+        value: 'HomeAndConstructionBusiness',
+        label: 'Home and construction'
+    },
+    {
+        value: 'GeneralContractor',
+        label: 'General contractor'
+    },
+    {
+        value: 'HousePainter',
+        label: 'House painter'
+    },
+    {
+        value: 'Plumber',
+        label: 'Plumber'
+    },
+    {
+        value: 'Electrician',
+        label: 'Electrician'
+    },
+    {
+        value: 'HVACBusiness',
+        label: 'Heating and air (HVAC)'
+    },
+    {
+        value: 'Locksmith',
+        label: 'Locksmith'
+    },
+    {
+        value: 'RoofingContractor',
+        label: 'Roofing contractor'
+    },
+    {
+        value: 'MovingCompany',
+        label: 'Moving company'
+    },
+    {
+        value: 'ProfessionalService',
+        label: 'Professional service'
+    },
+    {
+        value: 'Store',
+        label: 'Store'
+    },
+    {
+        value: 'FoodEstablishment',
+        label: 'Food and drink'
+    },
+    {
+        value: 'Restaurant',
+        label: 'Restaurant'
+    },
+    {
+        value: 'HealthAndBeautyBusiness',
+        label: 'Health and beauty'
+    },
+    {
+        value: 'MedicalBusiness',
+        label: 'Medical practice'
+    },
+    {
+        value: 'Dentist',
+        label: 'Dentist'
+    },
+    {
+        value: 'AutomotiveBusiness',
+        label: 'Automotive'
+    },
+    {
+        value: 'LegalService',
+        label: 'Legal service'
+    },
+    {
+        value: 'AccountingService',
+        label: 'Accounting'
+    },
+    {
+        value: 'RealEstateAgent',
+        label: 'Real estate agent'
+    },
+    {
+        value: 'SportsActivityLocation',
+        label: 'Gym, sports or fitness'
+    },
+    {
+        value: 'ChildCare',
+        label: 'Child care'
+    },
+    {
+        value: 'AnimalShelter',
+        label: 'Animal shelter'
+    }
+];
+/** At most this many areas are published; a service area is a list, not a gazetteer. */ export const AREA_SERVED_MAX = 20;
+export const AREA_SERVED_NAME_MAX_LENGTH = 120;
+/** Seven days, twice over — room for split shifts without inviting a timetable. */ export const OPENING_HOURS_MAX_ROWS = 14;
+/** Google reads a price range past 100 characters as not being one. */ export const PRICE_RANGE_MAX_LENGTH = 100;
+export const PAYMENT_ACCEPTED_MAX_LENGTH = 200;
+/**
+ * The stored business type, as the `schema.org` name it publishes under, or
+ * `undefined` when there is none or it is not on the list.
+ *
+ * Case-insensitive, returning the canonical spelling, because `@type` is
+ * case-sensitive to every consumer and `plumber` would name nothing.
+ */ export function localBusinessType(value) {
+    var _LOCAL_BUSINESS_TYPES_find;
+    if (typeof value !== 'string') return undefined;
+    const wanted = value.trim().toLowerCase();
+    if (!wanted) return undefined;
+    return (_LOCAL_BUSINESS_TYPES_find = LOCAL_BUSINESS_TYPES.find((entry)=>entry.value.toLowerCase() === wanted)) == null ? void 0 : _LOCAL_BUSINESS_TYPES_find.value;
+}
+/**
+ * The areas a business serves: trimmed, blanks dropped, de-duplicated without
+ * regard to case, and capped.
+ *
+ * Accepts the stored array or a newline-separated string, so a value typed
+ * into the console's text box reads the same whichever shape reached the
+ * document.
+ */ export function normalizeAreaServed(value) {
+    const items = Array.isArray(value) ? value : typeof value === 'string' ? value.split(/\r?\n/) : [];
+    const seen = new Set();
+    const areas = [];
+    for (const item of items){
+        if (typeof item !== 'string') continue;
+        const name = item.trim().replace(/\s+/g, ' ').slice(0, AREA_SERVED_NAME_MAX_LENGTH);
+        const key = name.toLowerCase();
+        if (!name || seen.has(key)) continue;
+        seen.add(key);
+        areas.push(name);
+        if (areas.length >= AREA_SERVED_MAX) break;
+    }
+    return areas;
+}
+const DAYS = [
+    'Monday',
+    'Tuesday',
+    'Wednesday',
+    'Thursday',
+    'Friday',
+    'Saturday',
+    'Sunday'
+];
+/**
+ * A day token, by the shortest prefix that is unambiguous — `Mo`, `Mon` and
+ * `Monday` all work, which is every way a person abbreviates a weekday. A
+ * single letter is refused: `T` and `S` are each two days.
+ */ const dayIndex = (token)=>{
+    const wanted = token.trim().toLowerCase();
+    if (wanted.length < 2) return -1;
+    return DAYS.findIndex((day)=>day.toLowerCase().startsWith(wanted));
+};
+/** `9:00` → `09:00`; anything that is not a real time of day → `''`. */ const clockTime = (hours, minutes)=>{
+    const h = Number(hours);
+    const m = Number(minutes);
+    if (h > 23 || m > 59) return '';
+    return `${String(h).padStart(2, '0')}:${minutes}`;
+};
+const DASH = /\s*[-–—]\s*/;
+const LINE = /^(.+?)\s+(\d{1,2}):(\d{2})\s*[-–—]\s*(\d{1,2}):(\d{2})$/;
+/** One line, or `null` when any part of it does not read. */ function parseOpeningHoursLine(line) {
+    const match = LINE.exec(line.trim());
+    if (!match) return null;
+    const opens = clockTime(match[2], match[3]);
+    const closes = clockTime(match[4], match[5]);
+    if (!opens || !closes) return null;
+    const days = [];
+    for (const part of match[1].split(',')){
+        const ends = part.trim().split(DASH);
+        if (ends.length > 2) return null;
+        const from = dayIndex(ends[0]);
+        const to = dayIndex(ends[ends.length - 1]);
+        if (from < 0 || to < 0) return null;
+        // A range may wrap the weekend: `Fr-Mo` is Friday through Monday.
+        for(let step = 0; step <= (to - from + 7) % 7; step++){
+            const day = DAYS[(from + step) % 7];
+            if (!days.includes(day)) days.push(day);
+        }
+    }
+    return days.length ? {
+        days,
+        opens,
+        closes
+    } : null;
+}
+const hoursLines = (value)=>typeof value === 'string' ? value.split(/\r?\n/) : [];
+/**
+ * Opening hours, one line per set of days, in the syntax `schema.org`'s own
+ * `openingHours` text uses: `Mo-Fr 09:00-17:00`, `Sa 10:00-14:00`,
+ * `Mo,We,Fr 08:00-12:00`.
+ *
+ * A text box rather than a repeating group of pickers because it is what the
+ * settings forms can hold without a new control, and because it is the form
+ * a business already writes its hours in. A line that does not read — a
+ * mistyped day, `25:00` — is DROPPED rather than guessed at: a published
+ * opening time is a promise a customer drives across town on.
+ */ export function parseOpeningHours(value) {
+    const rows = [];
+    for (const line of hoursLines(value)){
+        if (!line.trim()) continue;
+        const row = parseOpeningHoursLine(line);
+        if (row) rows.push(row);
+        if (rows.length >= OPENING_HOURS_MAX_ROWS) break;
+    }
+    return rows;
+}
+/**
+ * The 1-based numbers of the lines {@link parseOpeningHours} would drop, so
+ * the console can say which one before it is saved rather than after it
+ * silently fails to publish. Blank lines are not problems.
+ */ export function invalidOpeningHoursLines(value) {
+    const invalid = [];
+    hoursLines(value).forEach((line, index)=>{
+        if (line.trim() && !parseOpeningHoursLine(line)) invalid.push(index + 1);
+    });
+    return invalid;
+}
+
+//# sourceMappingURL=local-business.js.map

package/src/lib/app-utils/local-business.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../libs/aglyn/src/lib/app-utils/local-business.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 * A site entity that is a LOCAL BUSINESS (AGL-3383).\n *\n * `host.seo.entity.type` answers Organization or Person and keeps answering\n * it: it is a numeric enum stored as `\"1\"`/`\"2\"`, read by the author editor,\n * the logo card and the AI audit, and a third value there would be a third\n * value each of them has to learn. A plumber is still an Organization — the\n * business type REFINES that answer rather than replacing it — so it is a\n * field of its own, `businessType`, holding the `schema.org` subtype name.\n *\n * Every value is checked against {@link LOCAL_BUSINESS_TYPES}, which the\n * console's Select is built from too. A stored value outside it (a typo, a\n * type removed from the list) publishes the plain Organization it would have\n * published before the field existed, rather than an `@type` no consumer\n * recognizes.\n */\n\n/** The `schema.org` LocalBusiness subtypes a site can declare, with their console labels. */\nexport const LOCAL_BUSINESS_TYPES = [\n  { value: 'LocalBusiness', label: 'Local business (general)' },\n  { value: 'HomeAndConstructionBusiness', label: 'Home and construction' },\n  { value: 'GeneralContractor', label: 'General contractor' },\n  { value: 'HousePainter', label: 'House painter' },\n  { value: 'Plumber', label: 'Plumber' },\n  { value: 'Electrician', label: 'Electrician' },\n  { value: 'HVACBusiness', label: 'Heating and air (HVAC)' },\n  { value: 'Locksmith', label: 'Locksmith' },\n  { value: 'RoofingContractor', label: 'Roofing contractor' },\n  { value: 'MovingCompany', label: 'Moving company' },\n  { value: 'ProfessionalService', label: 'Professional service' },\n  { value: 'Store', label: 'Store' },\n  { value: 'FoodEstablishment', label: 'Food and drink' },\n  { value: 'Restaurant', label: 'Restaurant' },\n  { value: 'HealthAndBeautyBusiness', label: 'Health and beauty' },\n  { value: 'MedicalBusiness', label: 'Medical practice' },\n  { value: 'Dentist', label: 'Dentist' },\n  { value: 'AutomotiveBusiness', label: 'Automotive' },\n  { value: 'LegalService', label: 'Legal service' },\n  { value: 'AccountingService', label: 'Accounting' },\n  { value: 'RealEstateAgent', label: 'Real estate agent' },\n  { value: 'SportsActivityLocation', label: 'Gym, sports or fitness' },\n  { value: 'ChildCare', label: 'Child care' },\n  { value: 'AnimalShelter', label: 'Animal shelter' },\n] as const\n\nexport type LocalBusinessType = (typeof LOCAL_BUSINESS_TYPES)[number]['value']\n\n/** At most this many areas are published; a service area is a list, not a gazetteer. */\nexport const AREA_SERVED_MAX = 20\nexport const AREA_SERVED_NAME_MAX_LENGTH = 120\n/** Seven days, twice over — room for split shifts without inviting a timetable. */\nexport const OPENING_HOURS_MAX_ROWS = 14\n/** Google reads a price range past 100 characters as not being one. */\nexport const PRICE_RANGE_MAX_LENGTH = 100\nexport const PAYMENT_ACCEPTED_MAX_LENGTH = 200\n\n/**\n * The stored business type, as the `schema.org` name it publishes under, or\n * `undefined` when there is none or it is not on the list.\n *\n * Case-insensitive, returning the canonical spelling, because `@type` is\n * case-sensitive to every consumer and `plumber` would name nothing.\n */\nexport function localBusinessType(value: unknown): LocalBusinessType | undefined {\n  if (typeof value !== 'string') return undefined\n  const wanted = value.trim().toLowerCase()\n  if (!wanted) return undefined\n  return LOCAL_BUSINESS_TYPES.find((entry) => entry.value.toLowerCase() === wanted)\n    ?.value\n}\n\n/**\n * The areas a business serves: trimmed, blanks dropped, de-duplicated without\n * regard to case, and capped.\n *\n * Accepts the stored array or a newline-separated string, so a value typed\n * into the console's text box reads the same whichever shape reached the\n * document.\n */\nexport function normalizeAreaServed(value: unknown): string[] {\n  const items = Array.isArray(value)\n    ? value\n    : typeof value === 'string'\n      ? value.split(/\\r?\\n/)\n      : []\n  const seen = new Set<string>()\n  const areas: string[] = []\n  for (const item of items) {\n    if (typeof item !== 'string') continue\n    const name = item.trim().replace(/\\s+/g, ' ').slice(0, AREA_SERVED_NAME_MAX_LENGTH)\n    const key = name.toLowerCase()\n    if (!name || seen.has(key)) continue\n    seen.add(key)\n    areas.push(name)\n    if (areas.length >= AREA_SERVED_MAX) break\n  }\n  return areas\n}\n\nconst DAYS = [\n  'Monday',\n  'Tuesday',\n  'Wednesday',\n  'Thursday',\n  'Friday',\n  'Saturday',\n  'Sunday',\n] as const\n\nexport type OpeningHoursDay = (typeof DAYS)[number]\n\n/** One line of opening hours: these days, from `opens` to `closes`. */\nexport interface OpeningHoursRow {\n  days: OpeningHoursDay[]\n  /** `HH:MM`, 24-hour. */\n  opens: string\n  /** `HH:MM`, 24-hour. Earlier than `opens` means the next morning. */\n  closes: string\n}\n\n/**\n * A day token, by the shortest prefix that is unambiguous — `Mo`, `Mon` and\n * `Monday` all work, which is every way a person abbreviates a weekday. A\n * single letter is refused: `T` and `S` are each two days.\n */\nconst dayIndex = (token: string): number => {\n  const wanted = token.trim().toLowerCase()\n  if (wanted.length < 2) return -1\n  return DAYS.findIndex((day) => day.toLowerCase().startsWith(wanted))\n}\n\n/** `9:00` → `09:00`; anything that is not a real time of day → `''`. */\nconst clockTime = (hours: string, minutes: string): string => {\n  const h = Number(hours)\n  const m = Number(minutes)\n  if (h > 23 || m > 59) return ''\n  return `${String(h).padStart(2, '0')}:${minutes}`\n}\n\nconst DASH = /\\s*[-–—]\\s*/\nconst LINE = /^(.+?)\\s+(\\d{1,2}):(\\d{2})\\s*[-–—]\\s*(\\d{1,2}):(\\d{2})$/\n\n/** One line, or `null` when any part of it does not read. */\nfunction parseOpeningHoursLine(line: string): OpeningHoursRow | null {\n  const match = LINE.exec(line.trim())\n  if (!match) return null\n  const opens = clockTime(match[2], match[3])\n  const closes = clockTime(match[4], match[5])\n  if (!opens || !closes) return null\n  const days: OpeningHoursDay[] = []\n  for (const part of match[1].split(',')) {\n    const ends = part.trim().split(DASH)\n    if (ends.length > 2) return null\n    const from = dayIndex(ends[0])\n    const to = dayIndex(ends[ends.length - 1])\n    if (from < 0 || to < 0) return null\n    // A range may wrap the weekend: `Fr-Mo` is Friday through Monday.\n    for (let step = 0; step <= (to - from + 7) % 7; step++) {\n      const day = DAYS[(from + step) % 7]\n      if (!days.includes(day)) days.push(day)\n    }\n  }\n  return days.length ? { days, opens, closes } : null\n}\n\nconst hoursLines = (value: unknown): string[] =>\n  typeof value === 'string' ? value.split(/\\r?\\n/) : []\n\n/**\n * Opening hours, one line per set of days, in the syntax `schema.org`'s own\n * `openingHours` text uses: `Mo-Fr 09:00-17:00`, `Sa 10:00-14:00`,\n * `Mo,We,Fr 08:00-12:00`.\n *\n * A text box rather than a repeating group of pickers because it is what the\n * settings forms can hold without a new control, and because it is the form\n * a business already writes its hours in. A line that does not read — a\n * mistyped day, `25:00` — is DROPPED rather than guessed at: a published\n * opening time is a promise a customer drives across town on.\n */\nexport function parseOpeningHours(value: unknown): OpeningHoursRow[] {\n  const rows: OpeningHoursRow[] = []\n  for (const line of hoursLines(value)) {\n    if (!line.trim()) continue\n    const row = parseOpeningHoursLine(line)\n    if (row) rows.push(row)\n    if (rows.length >= OPENING_HOURS_MAX_ROWS) break\n  }\n  return rows\n}\n\n/**\n * The 1-based numbers of the lines {@link parseOpeningHours} would drop, so\n * the console can say which one before it is saved rather than after it\n * silently fails to publish. Blank lines are not problems.\n */\nexport function invalidOpeningHoursLines(value: unknown): number[] {\n  const invalid: number[] = []\n  hoursLines(value).forEach((line, index) => {\n    if (line.trim() && !parseOpeningHoursLine(line)) invalid.push(index + 1)\n  })\n  return invalid\n}\n"],"names":["LOCAL_BUSINESS_TYPES","value","label","AREA_SERVED_MAX","AREA_SERVED_NAME_MAX_LENGTH","OPENING_HOURS_MAX_ROWS","PRICE_RANGE_MAX_LENGTH","PAYMENT_ACCEPTED_MAX_LENGTH","localBusinessType","undefined","wanted","trim","toLowerCase","find","entry","normalizeAreaServed","items","Array","isArray","split","seen","Set","areas","item","name","replace","slice","key","has","add","push","length","DAYS","dayIndex","token","findIndex","day","startsWith","clockTime","hours","minutes","h","Number","m","String","padStart","DASH","LINE","parseOpeningHoursLine","line","match","exec","opens","closes","days","part","ends","from","to","step","includes","hoursLines","parseOpeningHours","rows","row","invalidOpeningHoursLines","invalid","forEach","index"],"mappings":"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"}

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

@@ -22,7 +22,7 @@ import type { ITimestamp } from '@aglyn/shared-util-timestamp';
  * their owner. Types follow the common SaaS taxonomy so the console can
  * icon/group them without a registry.
  */
-export type AglynNotificationType = 'billing.invoice' | 'billing.paymentFailed' | 'billing.subscriptionCanceled' | 'billing.usage' | 'team.invite' | 'team.roleChanged' | 'team.hostAccessGranted' | 'content.formSubmission' | 'content.booking' | 'content.order' | 'content.lowStock' | 'content.taskAssigned' | 'content.taskReminder' | 'content.contactAssigned' | 'content.leadAssigned' | 'content.crmDailyDigest' | 'content.insightsDigest' | 'marketplace.review' | 'support.ticketOpened' | 'support.ticketReply' | 'system.announcement' | 'system.pluginVerifierRegression' | 'system.signInMethodRemoved' | 'system.scopeDrift' | 'system.ssoDomainUnverified' | 'system.formSubmissionsPaused' | 'system.visitorRecordsPaused' | 'system.abuseReportUrgent' | 'system.riskNotice' | 'system.dmcaCounterNotice' | 'system.bandwidthCeilingTripped' | 'system.bandwidthCapEngaged' | 'system.billingWebhookHalfApplied' | 'system.disputeUnattributed' | 'staff.userSignedUp' | 'staff.orgCreated' | 'staff.subscriptionStarted' | 'staff.subscriptionCanceled' | 'staff.planChanged' | 'staff.paymentFailed';
+export type AglynNotificationType = 'billing.invoice' | 'billing.paymentFailed' | 'billing.subscriptionCanceled' | 'billing.usage' | 'team.invite' | 'team.roleChanged' | 'team.hostAccessGranted' | 'content.formSubmission' | 'content.booking' | 'content.order' | 'content.lowStock' | 'content.taskAssigned' | 'content.taskReminder' | 'content.contactAssigned' | 'content.leadAssigned' | 'content.crmDailyDigest' | 'content.insightsDigest' | 'marketplace.review' | 'support.ticketOpened' | 'support.ticketReply' | 'system.announcement' | 'system.pluginVerifierRegression' | 'system.signInMethodRemoved' | 'system.scopeDrift' | 'system.ssoDomainUnverified' | 'system.formSubmissionsPaused' | 'system.visitorRecordsPaused' | 'system.abuseReportUrgent' | 'system.riskNotice' | 'system.dmcaCounterNotice' | 'system.bandwidthCeilingTripped' | 'system.bandwidthCapEngaged' | 'system.billingWebhookHalfApplied' | 'system.disputeUnattributed' | 'system.operatorAlert' | 'staff.userSignedUp' | 'staff.orgCreated' | 'staff.subscriptionStarted' | 'staff.subscriptionCanceled' | 'staff.planChanged' | 'staff.paymentFailed';
 export interface AglynNotification {
     $id?: string;
     type: AglynNotificationType;
@@ -237,18 +237,6 @@ export declare const NOTIFICATION_CHANNEL_DEFAULTS: Record<NotificationCategory,
  * notification saying that the digest happened.
  */
 export declare const NOTIFICATION_SELF_SENT_EMAIL_TYPES: ReadonlySet<string>;
-/**
- * Staff notifications the OPERATOR must hear about by email, whoever runs the
- * install and whatever anyone switched on (AGL-3375): fraud and risk alerts,
- * a card dispute nobody owns, a DMCA counter-notice whose statutory clock is
- * running, and a billing webhook that applied only half of what it meant to.
- *
- * The console notification is still written for every staff member. What
- * this adds is one email to the operator's alert inbox, because the email
- * channel defaults OFF and a self-hosted or OSS install that nobody tuned
- * would otherwise learn about card testing on its checkout from its bank.
- */
-export declare const OPERATOR_ALERT_NOTIFICATION_TYPES: ReadonlySet<string>;
 /**
  * Whether a channel is on for one notification, at its own scope.
  *

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

@@ -49,6 +49,7 @@ export const NOTIFICATION_TYPE_LABELS = {
     'system.bandwidthCapEngaged': 'Monthly traffic limit reached',
     'system.billingWebhookHalfApplied': 'Billing webhook half applied',
     'system.disputeUnattributed': 'Card dispute with no owner',
+    'system.operatorAlert': 'Operator alert',
     'staff.userSignedUp': 'New account',
     'staff.orgCreated': 'New workspace',
     'staff.subscriptionStarted': 'New subscription',
@@ -213,22 +214,6 @@ export const NOTIFICATION_SETTINGS_FIELD = 'notificationSettings';
     // Emailed by `notifyRiskEvent` itself, as account mail (AGL-3368).
     'system.riskNotice'
 ]);
-/**
- * Staff notifications the OPERATOR must hear about by email, whoever runs the
- * install and whatever anyone switched on (AGL-3375): fraud and risk alerts,
- * a card dispute nobody owns, a DMCA counter-notice whose statutory clock is
- * running, and a billing webhook that applied only half of what it meant to.
- *
- * The console notification is still written for every staff member. What
- * this adds is one email to the operator's alert inbox, because the email
- * channel defaults OFF and a self-hosted or OSS install that nobody tuned
- * would otherwise learn about card testing on its checkout from its bank.
- */ export const OPERATOR_ALERT_NOTIFICATION_TYPES = new Set([
-    'system.abuseReportUrgent',
-    'system.disputeUnattributed',
-    'system.dmcaCounterNotice',
-    'system.billingWebhookHalfApplied'
-]);
 /**
  * Whether a channel is on for one notification, at its own scope.
  *