@aglyn/aglyn 1.0.0-beta.269 → 1.0.0-beta.271

package/src/lib/app-utils/site-care.d.ts

@@ -0,0 +1,268 @@
+/**
+ * @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 OwnerApprovalRecord } from './owner-approval-record';
+/**
+ * SITE CARE REQUESTS: THE ARITHMETIC (AGL-3959).
+ *
+ * A Site Care owner asks for a change by email or from the console, and the
+ * request is a support ticket tagged `siteCare`. Staff open it (a timer
+ * starts), make the change, and close it with one number: the minutes. This
+ * module is everything about that which needs no Firestore and no Stripe —
+ * the month a request counts in, how its minutes are counted against the
+ * included hour, what the close allows, what extra time bills, and the
+ * statement the month adds up to. The routes, the staff panel, the owner's
+ * Billing card and the reconciliation all read it, so they cannot disagree.
+ *
+ * ## The rules, from the Decision Log of 2026-10-19
+ *
+ * - The included hour is `SITE_CARE_INCLUDED_MINUTES` a month, no rollover,
+ *   plus any goodwill minutes staff add to that month. Each request counts
+ *   against it in `SITE_CARE_INCLUDED_BLOCK_MINUTES` blocks, rounded UP.
+ * - A request's share of the hour is fixed when it closes, against what the
+ *   month's earlier requests left. Correcting one request's minutes later
+ *   recomputes that request alone, against the same remainder, so a fix
+ *   never moves a charge on a request nobody touched.
+ * - Past the hour, extra time bills at `SITE_CARE_EXTRA_HOUR_USD` per
+ *   STARTED hour — whole hours, rounded up — and never less than the hours
+ *   the owner approved. With no approval on file, or more time than was
+ *   approved, the close is blocked: ask the owner first, or absorb it (no
+ *   charge, the minutes still count).
+ */
+/** The `kind` a Site Care support ticket carries. */
+export declare const SITE_CARE_TICKET_KIND = "siteCare";
+/** Site Care's promise: done within two business days. */
+export declare const SITE_CARE_RESPONSE_BUSINESS_DAYS = 2;
+/** The zone a Site Care month is drawn in: where the work is done. */
+export declare const SITE_CARE_TIME_ZONE = "America/Chicago";
+/** The close's minutes are rounded up to this step. */
+export declare const SITE_CARE_CLOSE_STEP_MINUTES = 5;
+/** The most minutes one request may log. */
+export declare const SITE_CARE_MAX_REQUEST_MINUTES: number;
+/**
+ * The tax code the extra-time item is billed under: the code every Aglyn
+ * product carries (the Decision Log of 2026-10-18), read off the Site Care
+ * product, which is checked to carry it before anything is charged.
+ */
+export declare const SITE_CARE_EXTRA_TIME_TAX_CODE = "txcd_10103001";
+/** The local part of the inbound address: `care@<inbound mail domain>`. */
+export declare const SITE_CARE_INBOUND_LOCAL_PART = "care";
+/** The longest title and message a request keeps. */
+export declare const SITE_CARE_SUBJECT_MAX = 150;
+export declare const SITE_CARE_BODY_MAX = 5000;
+/** Stripe's limit on an invoice item's description is generous; ours is not. */
+export declare const SITE_CARE_LINE_DESCRIPTION_MAX = 480;
+/** Where a request came from. */
+export type SiteCareSource = 'email' | 'console';
+/**
+ * Where an extra-time charge stands, as the platform recorded it.
+ *
+ * `creating` is written BEFORE the Stripe call and `pending` after it, so a
+ * call that succeeded with no row behind it shows as `creating` with no item
+ * id — which the reconciliation reports. Whether a `pending` item has been
+ * invoiced yet is read from Stripe when it matters, never assumed.
+ */
+export type SiteCareChargeStatus = 'creating' | 'pending' | 'failed' | 'voided' | 'credited' | 'refunded';
+/** Charges that still bill, or are about to. */
+export declare const SITE_CARE_LIVE_CHARGE_STATUSES: readonly SiteCareChargeStatus[];
+export interface SiteCareCharge {
+    status: SiteCareChargeStatus;
+    /** Whole hours billed. */
+    hours: number;
+    /** `hours × rate`, in cents, before tax. */
+    amountCents: number;
+    /** The invoice line description, exactly as it was sent. */
+    description: string;
+    /** The key the create was sent under, so a retry makes nothing twice. */
+    idempotencyKey: string;
+    invoiceItemId: string | null;
+    /** The invoice the item landed on, once read. */
+    invoiceId: string | null;
+    creditNoteId: string | null;
+    refundId: string | null;
+    /** What Stripe said, when a call failed. */
+    error: string | null;
+    updatedAtMs: number;
+}
+/** The site publish that shipped the change, from the site's activity log. */
+export interface SiteCarePublishLink {
+    hostId: string;
+    activityId: string;
+    action: string;
+    targetName: string | null;
+    targetId: string | null;
+    atMs: number;
+}
+/** The `siteCare` map on a Site Care ticket. */
+export interface SiteCareRequest {
+    source: SiteCareSource;
+    hostId: string | null;
+    requesterEmail: string | null;
+    state: 'open' | 'closed';
+    /** The month the request counts in: opened, until it closes; then closed. */
+    month: string;
+    timerStartedAtMs: number | null;
+    timerStartedByUid: string | null;
+    closedAtMs: number | null;
+    /** The one number staff entered at close, or the latest correction of it. */
+    minutesLogged: number | null;
+    /** The timer's own minutes at close, unrounded, for the record. */
+    timerMinutes: number | null;
+    countedMinutes: number;
+    includedMinutesUsed: number;
+    overMinutes: number;
+    billedHours: number;
+    absorbed: boolean;
+    approval: OwnerApprovalRecord | null;
+    charge: SiteCareCharge | null;
+    /** How many charges this request has ever started; keys each one. */
+    chargeSeq: number;
+    publish: SiteCarePublishLink | null;
+}
+/** Whether a value is a `YYYY-MM` month key. */
+export declare function isSiteCareMonthKey(value: unknown): value is string;
+/** The month an instant falls in, in Site Care's zone: `2026-10`. */
+export declare function siteCareMonthKey(ms: number): string;
+/** The month before a month key. */
+export declare function previousSiteCareMonthKey(key: string): string;
+/** "October 2026". */
+export declare function siteCareMonthLabel(key: string): string;
+/** The document id of an org's month: `{orgId}_{YYYY-MM}`, and the ticket field. */
+export declare function siteCareOrgMonth(orgId: string, month: string): string;
+/** "45 min", "1 h", "1 h 15 min". */
+export declare function formatSiteCareMinutes(minutes: number): string;
+/** "$79", "$158.00" → always whole-dollar style when whole. */
+export declare function formatSiteCareUsd(cents: number): string;
+/**
+ * The close's number from the timer: elapsed minutes rounded UP to the next
+ * five, and never less than five — a request somebody opened and closed was
+ * still a request worked.
+ */
+export declare function closeMinutesFromTimer(startedAtMs: number | null, nowMs: number): number;
+/** Staff's number read back, or null when it is not a usable count of minutes. */
+export declare function readSiteCareMinutes(value: unknown): number | null;
+/** Minutes as they count against the included hour: whole blocks, rounded up. */
+export declare function countedSiteCareMinutes(minutes: number): number;
+/** The month's included minutes: the hour plus goodwill. */
+export declare function siteCareIncludedPool(goodwillMinutes: number): number;
+export interface SiteCareAllocation {
+    countedMinutes: number;
+    includedMinutesUsed: number;
+    overMinutes: number;
+    /** Whole hours the over-time needs, rounded up; 0 when within the hour. */
+    requiredHours: number;
+    /** Included minutes the month had left before this request. */
+    remainingBefore: number;
+}
+/**
+ * One request's minutes against what the month's OTHER closed requests left
+ * of the included pool.
+ */
+export declare function allocateSiteCareMinutes(input: {
+    minutes: number;
+    otherIncludedUsed: number;
+    goodwillMinutes: number;
+}): SiteCareAllocation;
+export type SiteCareCloseVerdict = {
+    ok: true;
+    billedHours: number;
+    absorbed: boolean;
+} | {
+    ok: false;
+    /** No approval on file, or one for fewer hours than the work took. */
+    reason: 'no-approval' | 'approval-exceeded';
+    requiredHours: number;
+    approvedHours: number | null;
+};
+/**
+ * What a close (or a correction) may do with a request's extra time.
+ *
+ * Within the hour nothing bills. Past it, `absorb` closes with no charge;
+ * otherwise an approval must cover the whole hours needed, and the bill is
+ * the larger of those and the approved hours — the approved amount is the
+ * floor. Nothing bills without the owner's recorded yes.
+ */
+export declare function siteCareCloseVerdict(input: {
+    requiredHours: number;
+    approval: Pick<OwnerApprovalRecord, 'hours'> | null;
+    absorb: boolean;
+}): SiteCareCloseVerdict;
+/** Extra time in cents, before tax. */
+export declare function siteCareExtraTimeCents(hours: number): number;
+/** One request as the month's statement counts it. */
+export interface SiteCareStatementRequest {
+    requestId: string;
+    title: string;
+    state: 'open' | 'closed';
+    closedAtMs: number | null;
+    minutesLogged: number | null;
+    countedMinutes: number;
+    includedMinutesUsed: number;
+    overMinutes: number;
+    billedHours: number;
+    absorbed: boolean;
+    chargeStatus: SiteCareChargeStatus | null;
+    chargeCents: number;
+}
+export interface SiteCareMonthStatement {
+    month: string;
+    monthLabel: string;
+    includedMinutes: number;
+    goodwillMinutes: number;
+    poolMinutes: number;
+    requests: number;
+    openRequests: number;
+    minutesLogged: number;
+    countedMinutes: number;
+    includedMinutesUsed: number;
+    minutesLeft: number;
+    /** Hours on charges that still bill. */
+    extraHoursBilled: number;
+    extraBilledCents: number;
+    /** Cents voided, credited or refunded. */
+    extraReversedCents: number;
+}
+/** A request's facts as the statement reads them, from the stored map. */
+export declare function siteCareStatementRequest(requestId: string, title: string, request: Partial<SiteCareRequest> | null | undefined): SiteCareStatementRequest;
+/** The month, summed. */
+export declare function siteCareMonthStatement(input: {
+    month: string;
+    requests: readonly SiteCareStatementRequest[];
+    goodwillMinutes: number;
+}): SiteCareMonthStatement;
+/** The month's totals in one line, as the statement and the invoice line say them. */
+export declare function siteCareMonthSentence(statement: SiteCareMonthStatement): string;
+/**
+ * The extra-time invoice line's description: the request, its minutes, the
+ * hours billed and why, and the month's statement — what the owner reads on
+ * the invoice, and what the reconciliation compares Stripe's copy against.
+ */
+export declare function siteCareExtraTimeDescription(input: {
+    title: string;
+    minutesLogged: number;
+    overMinutes: number;
+    billedHours: number;
+    approvedHours: number | null;
+    statement: SiteCareMonthStatement;
+}): string;
+/** A charge's standing in the owner's words. */
+export declare function siteCareChargeWords(status: SiteCareChargeStatus | null): string;
+/** Whether a site activity row is a publish a request can be linked to. */
+export declare function isSiteCarePublishAction(action: unknown): boolean;
+/** A publish link as a sentence: "Published “Home” on Oct 19, 2026, 3:04 PM". */
+export declare function siteCarePublishSentence(publish: SiteCarePublishLink | null, formatDate: (ms: number) => string): string | null;
+/** A date as the owner's emails and statement write it, in Site Care's zone. */
+export declare function formatSiteCareDate(ms: number): string;

package/src/lib/app-utils/site-care.js

@@ -0,0 +1,283 @@
+/**
+ * @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 { SITE_CARE_EXTRA_HOUR_USD, SITE_CARE_INCLUDED_BLOCK_MINUTES, SITE_CARE_INCLUDED_MINUTES } from "./plan-entitlements.js";
+import { describeHours } from "./owner-approval-record.js";
+/**
+ * SITE CARE REQUESTS: THE ARITHMETIC (AGL-3959).
+ *
+ * A Site Care owner asks for a change by email or from the console, and the
+ * request is a support ticket tagged `siteCare`. Staff open it (a timer
+ * starts), make the change, and close it with one number: the minutes. This
+ * module is everything about that which needs no Firestore and no Stripe —
+ * the month a request counts in, how its minutes are counted against the
+ * included hour, what the close allows, what extra time bills, and the
+ * statement the month adds up to. The routes, the staff panel, the owner's
+ * Billing card and the reconciliation all read it, so they cannot disagree.
+ *
+ * ## The rules, from the Decision Log of 2026-10-19
+ *
+ * - The included hour is `SITE_CARE_INCLUDED_MINUTES` a month, no rollover,
+ *   plus any goodwill minutes staff add to that month. Each request counts
+ *   against it in `SITE_CARE_INCLUDED_BLOCK_MINUTES` blocks, rounded UP.
+ * - A request's share of the hour is fixed when it closes, against what the
+ *   month's earlier requests left. Correcting one request's minutes later
+ *   recomputes that request alone, against the same remainder, so a fix
+ *   never moves a charge on a request nobody touched.
+ * - Past the hour, extra time bills at `SITE_CARE_EXTRA_HOUR_USD` per
+ *   STARTED hour — whole hours, rounded up — and never less than the hours
+ *   the owner approved. With no approval on file, or more time than was
+ *   approved, the close is blocked: ask the owner first, or absorb it (no
+ *   charge, the minutes still count).
+ */ /** The `kind` a Site Care support ticket carries. */ export const SITE_CARE_TICKET_KIND = 'siteCare';
+/** Site Care's promise: done within two business days. */ export const SITE_CARE_RESPONSE_BUSINESS_DAYS = 2;
+/** The zone a Site Care month is drawn in: where the work is done. */ export const SITE_CARE_TIME_ZONE = 'America/Chicago';
+/** The close's minutes are rounded up to this step. */ export const SITE_CARE_CLOSE_STEP_MINUTES = 5;
+/** The most minutes one request may log. */ export const SITE_CARE_MAX_REQUEST_MINUTES = 60 * 40;
+/**
+ * The tax code the extra-time item is billed under: the code every Aglyn
+ * product carries (the Decision Log of 2026-10-18), read off the Site Care
+ * product, which is checked to carry it before anything is charged.
+ */ export const SITE_CARE_EXTRA_TIME_TAX_CODE = 'txcd_10103001';
+/** The local part of the inbound address: `care@<inbound mail domain>`. */ export const SITE_CARE_INBOUND_LOCAL_PART = 'care';
+/** The longest title and message a request keeps. */ export const SITE_CARE_SUBJECT_MAX = 150;
+export const SITE_CARE_BODY_MAX = 5000;
+/** Stripe's limit on an invoice item's description is generous; ours is not. */ export const SITE_CARE_LINE_DESCRIPTION_MAX = 480;
+/** Charges that still bill, or are about to. */ export const SITE_CARE_LIVE_CHARGE_STATUSES = [
+    'creating',
+    'pending'
+];
+/** Whether a value is a `YYYY-MM` month key. */ export function isSiteCareMonthKey(value) {
+    return typeof value === 'string' && /^\d{4}-(0[1-9]|1[0-2])$/.test(value);
+}
+/** The month an instant falls in, in Site Care's zone: `2026-10`. */ export function siteCareMonthKey(ms) {
+    var _ref, _ref1;
+    var _parts_find, _parts_find1;
+    const parts = new Intl.DateTimeFormat('en-US', {
+        timeZone: SITE_CARE_TIME_ZONE,
+        year: 'numeric',
+        month: '2-digit'
+    }).formatToParts(new Date(ms));
+    const year = (_ref = (_parts_find = parts.find((part)=>part.type === 'year')) == null ? void 0 : _parts_find.value) != null ? _ref : '1970';
+    const month = (_ref1 = (_parts_find1 = parts.find((part)=>part.type === 'month')) == null ? void 0 : _parts_find1.value) != null ? _ref1 : '01';
+    return `${year}-${month}`;
+}
+/** The month before a month key. */ export function previousSiteCareMonthKey(key) {
+    const [year, month] = key.split('-').map(Number);
+    return month === 1 ? `${year - 1}-12` : `${year}-${String(month - 1).padStart(2, '0')}`;
+}
+/** "October 2026". */ export function siteCareMonthLabel(key) {
+    if (!isSiteCareMonthKey(key)) return key;
+    const [year, month] = key.split('-').map(Number);
+    return new Date(Date.UTC(year, month - 1, 15)).toLocaleString('en-US', {
+        month: 'long',
+        year: 'numeric',
+        timeZone: 'UTC'
+    });
+}
+/** The document id of an org's month: `{orgId}_{YYYY-MM}`, and the ticket field. */ export function siteCareOrgMonth(orgId, month) {
+    return `${orgId}_${month}`;
+}
+/** "45 min", "1 h", "1 h 15 min". */ export function formatSiteCareMinutes(minutes) {
+    const total = Math.max(0, Math.round(Number(minutes) || 0));
+    if (total < 60) return `${total} min`;
+    const hours = Math.floor(total / 60);
+    const rest = total % 60;
+    return rest ? `${hours} h ${rest} min` : `${hours} h`;
+}
+/** "$79", "$158.00" → always whole-dollar style when whole. */ export function formatSiteCareUsd(cents) {
+    const dollars = Math.round(Number(cents) || 0) / 100;
+    return Number.isInteger(dollars) ? `$${dollars}` : `$${dollars.toFixed(2)}`;
+}
+/**
+ * The close's number from the timer: elapsed minutes rounded UP to the next
+ * five, and never less than five — a request somebody opened and closed was
+ * still a request worked.
+ */ export function closeMinutesFromTimer(startedAtMs, nowMs) {
+    if (!startedAtMs || nowMs <= startedAtMs) return SITE_CARE_CLOSE_STEP_MINUTES;
+    const elapsed = (nowMs - startedAtMs) / 60000;
+    const rounded = Math.ceil(elapsed / SITE_CARE_CLOSE_STEP_MINUTES) * SITE_CARE_CLOSE_STEP_MINUTES;
+    return Math.min(SITE_CARE_MAX_REQUEST_MINUTES, Math.max(SITE_CARE_CLOSE_STEP_MINUTES, rounded));
+}
+/** Staff's number read back, or null when it is not a usable count of minutes. */ export function readSiteCareMinutes(value) {
+    const minutes = Number(value);
+    if (!Number.isInteger(minutes) || minutes < 1 || minutes > SITE_CARE_MAX_REQUEST_MINUTES) {
+        return null;
+    }
+    return minutes;
+}
+/** Minutes as they count against the included hour: whole blocks, rounded up. */ export function countedSiteCareMinutes(minutes) {
+    const value = Math.max(0, Number(minutes) || 0);
+    return Math.ceil(value / SITE_CARE_INCLUDED_BLOCK_MINUTES) * SITE_CARE_INCLUDED_BLOCK_MINUTES;
+}
+/** The month's included minutes: the hour plus goodwill. */ export function siteCareIncludedPool(goodwillMinutes) {
+    return SITE_CARE_INCLUDED_MINUTES + Math.max(0, Math.floor(Number(goodwillMinutes) || 0));
+}
+/**
+ * One request's minutes against what the month's OTHER closed requests left
+ * of the included pool.
+ */ export function allocateSiteCareMinutes(input) {
+    const countedMinutes = countedSiteCareMinutes(input.minutes);
+    const remainingBefore = Math.max(0, siteCareIncludedPool(input.goodwillMinutes) - Math.max(0, input.otherIncludedUsed));
+    const includedMinutesUsed = Math.min(countedMinutes, remainingBefore);
+    const overMinutes = countedMinutes - includedMinutesUsed;
+    return {
+        countedMinutes,
+        includedMinutesUsed,
+        overMinutes,
+        requiredHours: overMinutes > 0 ? Math.ceil(overMinutes / 60) : 0,
+        remainingBefore
+    };
+}
+/**
+ * What a close (or a correction) may do with a request's extra time.
+ *
+ * Within the hour nothing bills. Past it, `absorb` closes with no charge;
+ * otherwise an approval must cover the whole hours needed, and the bill is
+ * the larger of those and the approved hours — the approved amount is the
+ * floor. Nothing bills without the owner's recorded yes.
+ */ export function siteCareCloseVerdict(input) {
+    if (input.requiredHours <= 0) return {
+        ok: true,
+        billedHours: 0,
+        absorbed: false
+    };
+    if (input.absorb) return {
+        ok: true,
+        billedHours: 0,
+        absorbed: true
+    };
+    if (!input.approval) {
+        return {
+            ok: false,
+            reason: 'no-approval',
+            requiredHours: input.requiredHours,
+            approvedHours: null
+        };
+    }
+    if (input.approval.hours < input.requiredHours) {
+        return {
+            ok: false,
+            reason: 'approval-exceeded',
+            requiredHours: input.requiredHours,
+            approvedHours: input.approval.hours
+        };
+    }
+    return {
+        ok: true,
+        billedHours: Math.max(input.requiredHours, input.approval.hours),
+        absorbed: false
+    };
+}
+/** Extra time in cents, before tax. */ export function siteCareExtraTimeCents(hours) {
+    return Math.max(0, Math.floor(hours)) * SITE_CARE_EXTRA_HOUR_USD * 100;
+}
+/** A request's facts as the statement reads them, from the stored map. */ export function siteCareStatementRequest(requestId, title, request) {
+    var _ref, _ref1, _ref2, _ref3;
+    const charge = (_ref = request == null ? void 0 : request.charge) != null ? _ref : null;
+    return {
+        requestId,
+        title,
+        state: (request == null ? void 0 : request.state) === 'closed' ? 'closed' : 'open',
+        closedAtMs: (_ref1 = request == null ? void 0 : request.closedAtMs) != null ? _ref1 : null,
+        minutesLogged: (_ref2 = request == null ? void 0 : request.minutesLogged) != null ? _ref2 : null,
+        countedMinutes: Number(request == null ? void 0 : request.countedMinutes) || 0,
+        includedMinutesUsed: Number(request == null ? void 0 : request.includedMinutesUsed) || 0,
+        overMinutes: Number(request == null ? void 0 : request.overMinutes) || 0,
+        billedHours: Number(request == null ? void 0 : request.billedHours) || 0,
+        absorbed: (request == null ? void 0 : request.absorbed) === true,
+        chargeStatus: (_ref3 = charge == null ? void 0 : charge.status) != null ? _ref3 : null,
+        chargeCents: Number(charge == null ? void 0 : charge.amountCents) || 0
+    };
+}
+/** The month, summed. */ export function siteCareMonthStatement(input) {
+    const closed = input.requests.filter((request)=>request.state === 'closed');
+    const goodwillMinutes = Math.max(0, Math.floor(Number(input.goodwillMinutes) || 0));
+    const poolMinutes = siteCareIncludedPool(goodwillMinutes);
+    const includedMinutesUsed = closed.reduce((sum, r)=>sum + r.includedMinutesUsed, 0);
+    const live = closed.filter((r)=>r.chargeStatus !== null && SITE_CARE_LIVE_CHARGE_STATUSES.includes(r.chargeStatus));
+    const reversed = closed.filter((r)=>r.chargeStatus === 'voided' || r.chargeStatus === 'credited' || r.chargeStatus === 'refunded');
+    return {
+        month: input.month,
+        monthLabel: siteCareMonthLabel(input.month),
+        includedMinutes: SITE_CARE_INCLUDED_MINUTES,
+        goodwillMinutes,
+        poolMinutes,
+        requests: input.requests.length,
+        openRequests: input.requests.length - closed.length,
+        minutesLogged: closed.reduce((sum, r)=>{
+            var _r_minutesLogged;
+            return sum + ((_r_minutesLogged = r.minutesLogged) != null ? _r_minutesLogged : 0);
+        }, 0),
+        countedMinutes: closed.reduce((sum, r)=>sum + r.countedMinutes, 0),
+        includedMinutesUsed,
+        minutesLeft: Math.max(0, poolMinutes - includedMinutesUsed),
+        extraHoursBilled: live.reduce((sum, r)=>sum + r.billedHours, 0),
+        extraBilledCents: live.reduce((sum, r)=>sum + r.chargeCents, 0),
+        extraReversedCents: reversed.reduce((sum, r)=>sum + r.chargeCents, 0)
+    };
+}
+/** The month's totals in one line, as the statement and the invoice line say them. */ export function siteCareMonthSentence(statement) {
+    const requests = `${statement.requests} ${statement.requests === 1 ? 'request' : 'requests'}`;
+    return `${statement.monthLabel}: ${requests}, ${formatSiteCareMinutes(statement.minutesLogged)} of work, ` + `${statement.includedMinutesUsed} of ${statement.poolMinutes} included minutes used` + (statement.extraHoursBilled > 0 ? `, ${describeHours(statement.extraHoursBilled)} of extra time billed` : '') + '.';
+}
+/**
+ * The extra-time invoice line's description: the request, its minutes, the
+ * hours billed and why, and the month's statement — what the owner reads on
+ * the invoice, and what the reconciliation compares Stripe's copy against.
+ */ export function siteCareExtraTimeDescription(input) {
+    const title = input.title.length > 80 ? `${input.title.slice(0, 79)}…` : input.title;
+    const approved = input.approvedHours && input.approvedHours > Math.ceil(input.overMinutes / 60) ? ` (the ${describeHours(input.approvedHours)} you approved)` : '';
+    const line = `Site Care extra time — “${title}”: ${formatSiteCareMinutes(input.minutesLogged)} of work, ` + `${formatSiteCareMinutes(input.overMinutes)} past the included hour, billed as ` + `${describeHours(input.billedHours)}${approved} at $${SITE_CARE_EXTRA_HOUR_USD}/hour. ` + siteCareMonthSentence(input.statement);
+    return line.length > SITE_CARE_LINE_DESCRIPTION_MAX ? `${line.slice(0, SITE_CARE_LINE_DESCRIPTION_MAX - 1)}…` : line;
+}
+/** A charge's standing in the owner's words. */ export function siteCareChargeWords(status) {
+    switch(status){
+        case 'creating':
+        case 'pending':
+            return 'On your next invoice';
+        case 'failed':
+            return 'Not billed';
+        case 'voided':
+            return 'Removed, not billed';
+        case 'credited':
+            return 'Credited back';
+        case 'refunded':
+            return 'Refunded';
+        default:
+            return 'Included';
+    }
+}
+/** Whether a site activity row is a publish a request can be linked to. */ export function isSiteCarePublishAction(action) {
+    return typeof action === 'string' && /^published\b/i.test(action.trim());
+}
+/** A publish link as a sentence: "Published “Home” on Oct 19, 2026, 3:04 PM". */ export function siteCarePublishSentence(publish, formatDate) {
+    if (!publish) return null;
+    const what = publish.targetName ? ` “${publish.targetName}”` : '';
+    return `${publish.action}${what} on ${formatDate(publish.atMs)}`;
+}
+/** A date as the owner's emails and statement write it, in Site Care's zone. */ export function formatSiteCareDate(ms) {
+    return new Date(ms).toLocaleString('en-US', {
+        timeZone: SITE_CARE_TIME_ZONE,
+        month: 'short',
+        day: 'numeric',
+        year: 'numeric',
+        hour: 'numeric',
+        minute: '2-digit',
+        timeZoneName: 'short'
+    });
+}
+
+//# sourceMappingURL=site-care.js.map

package/src/lib/app-utils/site-care.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../libs/aglyn/src/lib/app-utils/site-care.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 {\n  SITE_CARE_EXTRA_HOUR_USD,\n  SITE_CARE_INCLUDED_BLOCK_MINUTES,\n  SITE_CARE_INCLUDED_MINUTES,\n} from './plan-entitlements'\nimport { describeHours, type OwnerApprovalRecord } from './owner-approval-record'\n\n/**\n * SITE CARE REQUESTS: THE ARITHMETIC (AGL-3959).\n *\n * A Site Care owner asks for a change by email or from the console, and the\n * request is a support ticket tagged `siteCare`. Staff open it (a timer\n * starts), make the change, and close it with one number: the minutes. This\n * module is everything about that which needs no Firestore and no Stripe —\n * the month a request counts in, how its minutes are counted against the\n * included hour, what the close allows, what extra time bills, and the\n * statement the month adds up to. The routes, the staff panel, the owner's\n * Billing card and the reconciliation all read it, so they cannot disagree.\n *\n * ## The rules, from the Decision Log of 2026-10-19\n *\n * - The included hour is `SITE_CARE_INCLUDED_MINUTES` a month, no rollover,\n *   plus any goodwill minutes staff add to that month. Each request counts\n *   against it in `SITE_CARE_INCLUDED_BLOCK_MINUTES` blocks, rounded UP.\n * - A request's share of the hour is fixed when it closes, against what the\n *   month's earlier requests left. Correcting one request's minutes later\n *   recomputes that request alone, against the same remainder, so a fix\n *   never moves a charge on a request nobody touched.\n * - Past the hour, extra time bills at `SITE_CARE_EXTRA_HOUR_USD` per\n *   STARTED hour — whole hours, rounded up — and never less than the hours\n *   the owner approved. With no approval on file, or more time than was\n *   approved, the close is blocked: ask the owner first, or absorb it (no\n *   charge, the minutes still count).\n */\n\n/** The `kind` a Site Care support ticket carries. */\nexport const SITE_CARE_TICKET_KIND = 'siteCare'\n\n/** Site Care's promise: done within two business days. */\nexport const SITE_CARE_RESPONSE_BUSINESS_DAYS = 2\n\n/** The zone a Site Care month is drawn in: where the work is done. */\nexport const SITE_CARE_TIME_ZONE = 'America/Chicago'\n\n/** The close's minutes are rounded up to this step. */\nexport const SITE_CARE_CLOSE_STEP_MINUTES = 5\n\n/** The most minutes one request may log. */\nexport const SITE_CARE_MAX_REQUEST_MINUTES = 60 * 40\n\n/**\n * The tax code the extra-time item is billed under: the code every Aglyn\n * product carries (the Decision Log of 2026-10-18), read off the Site Care\n * product, which is checked to carry it before anything is charged.\n */\nexport const SITE_CARE_EXTRA_TIME_TAX_CODE = 'txcd_10103001'\n\n/** The local part of the inbound address: `care@<inbound mail domain>`. */\nexport const SITE_CARE_INBOUND_LOCAL_PART = 'care'\n\n/** The longest title and message a request keeps. */\nexport const SITE_CARE_SUBJECT_MAX = 150\nexport const SITE_CARE_BODY_MAX = 5000\n\n/** Stripe's limit on an invoice item's description is generous; ours is not. */\nexport const SITE_CARE_LINE_DESCRIPTION_MAX = 480\n\n/** Where a request came from. */\nexport type SiteCareSource = 'email' | 'console'\n\n/**\n * Where an extra-time charge stands, as the platform recorded it.\n *\n * `creating` is written BEFORE the Stripe call and `pending` after it, so a\n * call that succeeded with no row behind it shows as `creating` with no item\n * id — which the reconciliation reports. Whether a `pending` item has been\n * invoiced yet is read from Stripe when it matters, never assumed.\n */\nexport type SiteCareChargeStatus =\n  | 'creating'\n  | 'pending'\n  | 'failed'\n  | 'voided'\n  | 'credited'\n  | 'refunded'\n\n/** Charges that still bill, or are about to. */\nexport const SITE_CARE_LIVE_CHARGE_STATUSES: readonly SiteCareChargeStatus[] = [\n  'creating',\n  'pending',\n]\n\nexport interface SiteCareCharge {\n  status: SiteCareChargeStatus\n  /** Whole hours billed. */\n  hours: number\n  /** `hours × rate`, in cents, before tax. */\n  amountCents: number\n  /** The invoice line description, exactly as it was sent. */\n  description: string\n  /** The key the create was sent under, so a retry makes nothing twice. */\n  idempotencyKey: string\n  invoiceItemId: string | null\n  /** The invoice the item landed on, once read. */\n  invoiceId: string | null\n  creditNoteId: string | null\n  refundId: string | null\n  /** What Stripe said, when a call failed. */\n  error: string | null\n  updatedAtMs: number\n}\n\n/** The site publish that shipped the change, from the site's activity log. */\nexport interface SiteCarePublishLink {\n  hostId: string\n  activityId: string\n  action: string\n  targetName: string | null\n  targetId: string | null\n  atMs: number\n}\n\n/** The `siteCare` map on a Site Care ticket. */\nexport interface SiteCareRequest {\n  source: SiteCareSource\n  hostId: string | null\n  requesterEmail: string | null\n  state: 'open' | 'closed'\n  /** The month the request counts in: opened, until it closes; then closed. */\n  month: string\n  timerStartedAtMs: number | null\n  timerStartedByUid: string | null\n  closedAtMs: number | null\n  /** The one number staff entered at close, or the latest correction of it. */\n  minutesLogged: number | null\n  /** The timer's own minutes at close, unrounded, for the record. */\n  timerMinutes: number | null\n  countedMinutes: number\n  includedMinutesUsed: number\n  overMinutes: number\n  billedHours: number\n  absorbed: boolean\n  approval: OwnerApprovalRecord | null\n  charge: SiteCareCharge | null\n  /** How many charges this request has ever started; keys each one. */\n  chargeSeq: number\n  publish: SiteCarePublishLink | null\n}\n\n/** Whether a value is a `YYYY-MM` month key. */\nexport function isSiteCareMonthKey(value: unknown): value is string {\n  return typeof value === 'string' && /^\\d{4}-(0[1-9]|1[0-2])$/.test(value)\n}\n\n/** The month an instant falls in, in Site Care's zone: `2026-10`. */\nexport function siteCareMonthKey(ms: number): string {\n  const parts = new Intl.DateTimeFormat('en-US', {\n    timeZone: SITE_CARE_TIME_ZONE,\n    year: 'numeric',\n    month: '2-digit',\n  }).formatToParts(new Date(ms))\n  const year = parts.find((part) => part.type === 'year')?.value ?? '1970'\n  const month = parts.find((part) => part.type === 'month')?.value ?? '01'\n  return `${year}-${month}`\n}\n\n/** The month before a month key. */\nexport function previousSiteCareMonthKey(key: string): string {\n  const [year, month] = key.split('-').map(Number)\n  return month === 1 ? `${year - 1}-12` : `${year}-${String(month - 1).padStart(2, '0')}`\n}\n\n/** \"October 2026\". */\nexport function siteCareMonthLabel(key: string): string {\n  if (!isSiteCareMonthKey(key)) return key\n  const [year, month] = key.split('-').map(Number)\n  return new Date(Date.UTC(year, month - 1, 15)).toLocaleString('en-US', {\n    month: 'long',\n    year: 'numeric',\n    timeZone: 'UTC',\n  })\n}\n\n/** The document id of an org's month: `{orgId}_{YYYY-MM}`, and the ticket field. */\nexport function siteCareOrgMonth(orgId: string, month: string): string {\n  return `${orgId}_${month}`\n}\n\n/** \"45 min\", \"1 h\", \"1 h 15 min\". */\nexport function formatSiteCareMinutes(minutes: number): string {\n  const total = Math.max(0, Math.round(Number(minutes) || 0))\n  if (total < 60) return `${total} min`\n  const hours = Math.floor(total / 60)\n  const rest = total % 60\n  return rest ? `${hours} h ${rest} min` : `${hours} h`\n}\n\n/** \"$79\", \"$158.00\" → always whole-dollar style when whole. */\nexport function formatSiteCareUsd(cents: number): string {\n  const dollars = (Math.round(Number(cents) || 0) / 100)\n  return Number.isInteger(dollars) ? `$${dollars}` : `$${dollars.toFixed(2)}`\n}\n\n/**\n * The close's number from the timer: elapsed minutes rounded UP to the next\n * five, and never less than five — a request somebody opened and closed was\n * still a request worked.\n */\nexport function closeMinutesFromTimer(startedAtMs: number | null, nowMs: number): number {\n  if (!startedAtMs || nowMs <= startedAtMs) return SITE_CARE_CLOSE_STEP_MINUTES\n  const elapsed = (nowMs - startedAtMs) / 60_000\n  const rounded = Math.ceil(elapsed / SITE_CARE_CLOSE_STEP_MINUTES) * SITE_CARE_CLOSE_STEP_MINUTES\n  return Math.min(SITE_CARE_MAX_REQUEST_MINUTES, Math.max(SITE_CARE_CLOSE_STEP_MINUTES, rounded))\n}\n\n/** Staff's number read back, or null when it is not a usable count of minutes. */\nexport function readSiteCareMinutes(value: unknown): number | null {\n  const minutes = Number(value)\n  if (!Number.isInteger(minutes) || minutes < 1 || minutes > SITE_CARE_MAX_REQUEST_MINUTES) {\n    return null\n  }\n  return minutes\n}\n\n/** Minutes as they count against the included hour: whole blocks, rounded up. */\nexport function countedSiteCareMinutes(minutes: number): number {\n  const value = Math.max(0, Number(minutes) || 0)\n  return Math.ceil(value / SITE_CARE_INCLUDED_BLOCK_MINUTES) * SITE_CARE_INCLUDED_BLOCK_MINUTES\n}\n\n/** The month's included minutes: the hour plus goodwill. */\nexport function siteCareIncludedPool(goodwillMinutes: number): number {\n  return SITE_CARE_INCLUDED_MINUTES + Math.max(0, Math.floor(Number(goodwillMinutes) || 0))\n}\n\nexport interface SiteCareAllocation {\n  countedMinutes: number\n  includedMinutesUsed: number\n  overMinutes: number\n  /** Whole hours the over-time needs, rounded up; 0 when within the hour. */\n  requiredHours: number\n  /** Included minutes the month had left before this request. */\n  remainingBefore: number\n}\n\n/**\n * One request's minutes against what the month's OTHER closed requests left\n * of the included pool.\n */\nexport function allocateSiteCareMinutes(input: {\n  minutes: number\n  otherIncludedUsed: number\n  goodwillMinutes: number\n}): SiteCareAllocation {\n  const countedMinutes = countedSiteCareMinutes(input.minutes)\n  const remainingBefore = Math.max(\n    0,\n    siteCareIncludedPool(input.goodwillMinutes) - Math.max(0, input.otherIncludedUsed),\n  )\n  const includedMinutesUsed = Math.min(countedMinutes, remainingBefore)\n  const overMinutes = countedMinutes - includedMinutesUsed\n  return {\n    countedMinutes,\n    includedMinutesUsed,\n    overMinutes,\n    requiredHours: overMinutes > 0 ? Math.ceil(overMinutes / 60) : 0,\n    remainingBefore,\n  }\n}\n\nexport type SiteCareCloseVerdict =\n  | { ok: true; billedHours: number; absorbed: boolean }\n  | {\n      ok: false\n      /** No approval on file, or one for fewer hours than the work took. */\n      reason: 'no-approval' | 'approval-exceeded'\n      requiredHours: number\n      approvedHours: number | null\n    }\n\n/**\n * What a close (or a correction) may do with a request's extra time.\n *\n * Within the hour nothing bills. Past it, `absorb` closes with no charge;\n * otherwise an approval must cover the whole hours needed, and the bill is\n * the larger of those and the approved hours — the approved amount is the\n * floor. Nothing bills without the owner's recorded yes.\n */\nexport function siteCareCloseVerdict(input: {\n  requiredHours: number\n  approval: Pick<OwnerApprovalRecord, 'hours'> | null\n  absorb: boolean\n}): SiteCareCloseVerdict {\n  if (input.requiredHours <= 0) return { ok: true, billedHours: 0, absorbed: false }\n  if (input.absorb) return { ok: true, billedHours: 0, absorbed: true }\n  if (!input.approval) {\n    return {\n      ok: false,\n      reason: 'no-approval',\n      requiredHours: input.requiredHours,\n      approvedHours: null,\n    }\n  }\n  if (input.approval.hours < input.requiredHours) {\n    return {\n      ok: false,\n      reason: 'approval-exceeded',\n      requiredHours: input.requiredHours,\n      approvedHours: input.approval.hours,\n    }\n  }\n  return {\n    ok: true,\n    billedHours: Math.max(input.requiredHours, input.approval.hours),\n    absorbed: false,\n  }\n}\n\n/** Extra time in cents, before tax. */\nexport function siteCareExtraTimeCents(hours: number): number {\n  return Math.max(0, Math.floor(hours)) * SITE_CARE_EXTRA_HOUR_USD * 100\n}\n\n/** One request as the month's statement counts it. */\nexport interface SiteCareStatementRequest {\n  requestId: string\n  title: string\n  state: 'open' | 'closed'\n  closedAtMs: number | null\n  minutesLogged: number | null\n  countedMinutes: number\n  includedMinutesUsed: number\n  overMinutes: number\n  billedHours: number\n  absorbed: boolean\n  chargeStatus: SiteCareChargeStatus | null\n  chargeCents: number\n}\n\nexport interface SiteCareMonthStatement {\n  month: string\n  monthLabel: string\n  includedMinutes: number\n  goodwillMinutes: number\n  poolMinutes: number\n  requests: number\n  openRequests: number\n  minutesLogged: number\n  countedMinutes: number\n  includedMinutesUsed: number\n  minutesLeft: number\n  /** Hours on charges that still bill. */\n  extraHoursBilled: number\n  extraBilledCents: number\n  /** Cents voided, credited or refunded. */\n  extraReversedCents: number\n}\n\n/** A request's facts as the statement reads them, from the stored map. */\nexport function siteCareStatementRequest(\n  requestId: string,\n  title: string,\n  request: Partial<SiteCareRequest> | null | undefined,\n): SiteCareStatementRequest {\n  const charge = request?.charge ?? null\n  return {\n    requestId,\n    title,\n    state: request?.state === 'closed' ? 'closed' : 'open',\n    closedAtMs: request?.closedAtMs ?? null,\n    minutesLogged: request?.minutesLogged ?? null,\n    countedMinutes: Number(request?.countedMinutes) || 0,\n    includedMinutesUsed: Number(request?.includedMinutesUsed) || 0,\n    overMinutes: Number(request?.overMinutes) || 0,\n    billedHours: Number(request?.billedHours) || 0,\n    absorbed: request?.absorbed === true,\n    chargeStatus: charge?.status ?? null,\n    chargeCents: Number(charge?.amountCents) || 0,\n  }\n}\n\n/** The month, summed. */\nexport function siteCareMonthStatement(input: {\n  month: string\n  requests: readonly SiteCareStatementRequest[]\n  goodwillMinutes: number\n}): SiteCareMonthStatement {\n  const closed = input.requests.filter((request) => request.state === 'closed')\n  const goodwillMinutes = Math.max(0, Math.floor(Number(input.goodwillMinutes) || 0))\n  const poolMinutes = siteCareIncludedPool(goodwillMinutes)\n  const includedMinutesUsed = closed.reduce((sum, r) => sum + r.includedMinutesUsed, 0)\n  const live = closed.filter(\n    (r) => r.chargeStatus !== null && SITE_CARE_LIVE_CHARGE_STATUSES.includes(r.chargeStatus),\n  )\n  const reversed = closed.filter(\n    (r) => r.chargeStatus === 'voided' || r.chargeStatus === 'credited' || r.chargeStatus === 'refunded',\n  )\n  return {\n    month: input.month,\n    monthLabel: siteCareMonthLabel(input.month),\n    includedMinutes: SITE_CARE_INCLUDED_MINUTES,\n    goodwillMinutes,\n    poolMinutes,\n    requests: input.requests.length,\n    openRequests: input.requests.length - closed.length,\n    minutesLogged: closed.reduce((sum, r) => sum + (r.minutesLogged ?? 0), 0),\n    countedMinutes: closed.reduce((sum, r) => sum + r.countedMinutes, 0),\n    includedMinutesUsed,\n    minutesLeft: Math.max(0, poolMinutes - includedMinutesUsed),\n    extraHoursBilled: live.reduce((sum, r) => sum + r.billedHours, 0),\n    extraBilledCents: live.reduce((sum, r) => sum + r.chargeCents, 0),\n    extraReversedCents: reversed.reduce((sum, r) => sum + r.chargeCents, 0),\n  }\n}\n\n/** The month's totals in one line, as the statement and the invoice line say them. */\nexport function siteCareMonthSentence(statement: SiteCareMonthStatement): string {\n  const requests = `${statement.requests} ${statement.requests === 1 ? 'request' : 'requests'}`\n  return (\n    `${statement.monthLabel}: ${requests}, ${formatSiteCareMinutes(statement.minutesLogged)} of work, ` +\n    `${statement.includedMinutesUsed} of ${statement.poolMinutes} included minutes used` +\n    (statement.extraHoursBilled > 0\n      ? `, ${describeHours(statement.extraHoursBilled)} of extra time billed`\n      : '') +\n    '.'\n  )\n}\n\n/**\n * The extra-time invoice line's description: the request, its minutes, the\n * hours billed and why, and the month's statement — what the owner reads on\n * the invoice, and what the reconciliation compares Stripe's copy against.\n */\nexport function siteCareExtraTimeDescription(input: {\n  title: string\n  minutesLogged: number\n  overMinutes: number\n  billedHours: number\n  approvedHours: number | null\n  statement: SiteCareMonthStatement\n}): string {\n  const title = input.title.length > 80 ? `${input.title.slice(0, 79)}…` : input.title\n  const approved =\n    input.approvedHours && input.approvedHours > Math.ceil(input.overMinutes / 60)\n      ? ` (the ${describeHours(input.approvedHours)} you approved)`\n      : ''\n  const line =\n    `Site Care extra time — “${title}”: ${formatSiteCareMinutes(input.minutesLogged)} of work, ` +\n    `${formatSiteCareMinutes(input.overMinutes)} past the included hour, billed as ` +\n    `${describeHours(input.billedHours)}${approved} at $${SITE_CARE_EXTRA_HOUR_USD}/hour. ` +\n    siteCareMonthSentence(input.statement)\n  return line.length > SITE_CARE_LINE_DESCRIPTION_MAX\n    ? `${line.slice(0, SITE_CARE_LINE_DESCRIPTION_MAX - 1)}…`\n    : line\n}\n\n/** A charge's standing in the owner's words. */\nexport function siteCareChargeWords(status: SiteCareChargeStatus | null): string {\n  switch (status) {\n    case 'creating':\n    case 'pending':\n      return 'On your next invoice'\n    case 'failed':\n      return 'Not billed'\n    case 'voided':\n      return 'Removed, not billed'\n    case 'credited':\n      return 'Credited back'\n    case 'refunded':\n      return 'Refunded'\n    default:\n      return 'Included'\n  }\n}\n\n/** Whether a site activity row is a publish a request can be linked to. */\nexport function isSiteCarePublishAction(action: unknown): boolean {\n  return typeof action === 'string' && /^published\\b/i.test(action.trim())\n}\n\n/** A publish link as a sentence: \"Published “Home” on Oct 19, 2026, 3:04 PM\". */\nexport function siteCarePublishSentence(\n  publish: SiteCarePublishLink | null,\n  formatDate: (ms: number) => string,\n): string | null {\n  if (!publish) return null\n  const what = publish.targetName ? ` “${publish.targetName}”` : ''\n  return `${publish.action}${what} on ${formatDate(publish.atMs)}`\n}\n\n/** A date as the owner's emails and statement write it, in Site Care's zone. */\nexport function formatSiteCareDate(ms: number): string {\n  return new Date(ms).toLocaleString('en-US', {\n    timeZone: SITE_CARE_TIME_ZONE,\n    month: 'short',\n    day: 'numeric',\n    year: 'numeric',\n    hour: 'numeric',\n    minute: '2-digit',\n    timeZoneName: 'short',\n  })\n}\n"],"names":["SITE_CARE_EXTRA_HOUR_USD","SITE_CARE_INCLUDED_BLOCK_MINUTES","SITE_CARE_INCLUDED_MINUTES","describeHours","SITE_CARE_TICKET_KIND","SITE_CARE_RESPONSE_BUSINESS_DAYS","SITE_CARE_TIME_ZONE","SITE_CARE_CLOSE_STEP_MINUTES","SITE_CARE_MAX_REQUEST_MINUTES","SITE_CARE_EXTRA_TIME_TAX_CODE","SITE_CARE_INBOUND_LOCAL_PART","SITE_CARE_SUBJECT_MAX","SITE_CARE_BODY_MAX","SITE_CARE_LINE_DESCRIPTION_MAX","SITE_CARE_LIVE_CHARGE_STATUSES","isSiteCareMonthKey","value","test","siteCareMonthKey","ms","parts","Intl","DateTimeFormat","timeZone","year","month","formatToParts","Date","find","part","type","previousSiteCareMonthKey","key","split","map","Number","String","padStart","siteCareMonthLabel","UTC","toLocaleString","siteCareOrgMonth","orgId","formatSiteCareMinutes","minutes","total","Math","max","round","hours","floor","rest","formatSiteCareUsd","cents","dollars","isInteger","toFixed","closeMinutesFromTimer","startedAtMs","nowMs","elapsed","rounded","ceil","min","readSiteCareMinutes","countedSiteCareMinutes","siteCareIncludedPool","goodwillMinutes","allocateSiteCareMinutes","input","countedMinutes","remainingBefore","otherIncludedUsed","includedMinutesUsed","overMinutes","requiredHours","siteCareCloseVerdict","ok","billedHours","absorbed","absorb","approval","reason","approvedHours","siteCareExtraTimeCents","siteCareStatementRequest","requestId","title","request","charge","state","closedAtMs","minutesLogged","chargeStatus","status","chargeCents","amountCents","siteCareMonthStatement","closed","requests","filter","poolMinutes","reduce","sum","r","live","includes","reversed","monthLabel","includedMinutes","length","openRequests","minutesLeft","extraHoursBilled","extraBilledCents","extraReversedCents","siteCareMonthSentence","statement","siteCareExtraTimeDescription","slice","approved","line","siteCareChargeWords","isSiteCarePublishAction","action","trim","siteCarePublishSentence","publish","formatDate","what","targetName","atMs","formatSiteCareDate","day","hour","minute","timeZoneName"],"mappings":"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"}