@7365admin1/layer-common 4.90.2-staging.490 → 4.90.2

package/utils/invite-sites.ts

@@ -1,25 +0,0 @@
-/**
- * Which sites an "Invite member" request names (owner request 2026-10-02:
- * invite one person to several sites). One site keeps the old `siteId` shape;
- * 2 or more send `siteIds` (the server writes one invitation per site and
- * names every site in one e-mail).
- */
-export function inviteSitePayload(
-  sites: string[],
-  siteName = "",
-): Record<string, unknown> {
-  if (!sites.length) return {};
-  if (sites.length === 1) {
-    return { siteId: sites[0], ...(siteName && { siteName }) };
-  }
-  return { siteIds: sites };
-}
-
-/**
- * The one site a role is looked up for: the single chosen site, or "" for 2+
- * (a site role is valid at its own site only, so several sites offer
- * organisation roles only).
- */
-export function roleSiteFor(sites: string[]): string {
-  return sites.length === 1 ? sites[0] : "";
-}

package/utils/occupancy-role.ts

@@ -1,109 +0,0 @@
-/**
- * OWNER / OCCUPANT / PERSON IN CHARGE - the three standings a business
- * tenancy has, and everything the product says about them.
- *
- * One list, because three screens read it: the form that asks the question
- * (`PeopleFormMgmt`), the list and preview that print the answer back, and
- * the row menu that reassigns it (`people-mgmt`). The values are the ones the
- * server stores and validates - `OccupancyRoles` in core's `person.model.ts`
- * - so a value added on one side has to be added on the other.
- */
-export const OCCUPANCY_ROLE_OPTIONS: TOccupancyRoleOption[] = [
-  {
-    value: "owner",
-    title: "Owner",
-    action: "Assign Owner",
-    prompt: "Assign Owner",
-    description:
-      "The legal titleholder or primary deed owner of the property.",
-  },
-  {
-    value: "occupant",
-    title: "Occupant",
-    action: "Assign Occupant",
-    prompt: "Assign Occupant",
-    description:
-      "The person currently living in, renting, or utilizing the physical unit.",
-  },
-  {
-    value: "person-in-charge",
-    title: "Person in Charge",
-    action: "Assign Person in Charge",
-    prompt: "Assign Person in Charge (PIC)",
-    description:
-      "The designated manager responsible for maintenance, emergencies, and daily operations.",
-  },
-];
-
-/**
- * The same three, in the order the ROW MENU draws them, which is not the
- * order the form's radio does. Derived rather than re-typed so the wording
- * cannot drift between the two.
- */
-export const OCCUPANCY_ROLE_ACTIONS: TOccupancyRoleOption[] = (
-  ["person-in-charge", "owner", "occupant"] as TOccupancyRole[]
-).map(
-  (value) =>
-    OCCUPANCY_ROLE_OPTIONS.find(
-      (option) => option.value === value,
-    ) as TOccupancyRoleOption,
-);
-
-/**
- * The label for a stored role, or "" for a person who was never asked - which
- * is everyone on a residential site and everyone saved before the question
- * existed. Callers decide what to print instead; nobody should print a raw
- * `person-in-charge` at a user.
- */
-export function occupancyRoleLabel(role?: string | null): string {
-  return (
-    OCCUPANCY_ROLE_OPTIONS.find((option) => option.value === role)?.title ?? ""
-  );
-}
-
-/**
- * Does this person hold OWNER at their unit?
- *
- * The role when there is one, `isOwner` when there is not - the same test the
- * server applies (`holdsUnitOwner` in core's `unit-owner.util.ts`). A person
- * recorded before the role existed carries only the flag, and the people list
- * already prints them as "Owner".
- */
-export function holdsUnitOwner(person?: {
-  occupancyRole?: string | null;
-  isOwner?: boolean;
-}): boolean {
-  if (!person) return false;
-
-  if (person.occupancyRole) return person.occupancyRole === "owner";
-
-  return person.isOwner === true;
-}
-
-/**
- * MUST THIS PERSON HAND THE UNIT OVER BEFORE THEY CAN BE DEACTIVATED?
- *
- * The owner of a unit does not leave while they still own it - the standing
- * moves to another tenant at the same block, level and unit first.
- *
- * Keyed to the ROLE and never to `isOwner`, exactly as the server keys it
- * (`mustHandOverBeforeDeactivating` in core): the flag is on every resident in
- * the estate, and no residential screen can change it, so a rule keyed to it
- * would trap records that can never satisfy it.
- */
-export function mustHandOverBeforeDeactivating(person?: {
-  occupancyRole?: string | null;
-}): boolean {
-  return person?.occupancyRole === "owner";
-}
-
-/**
- * Why a deactivation was held back. The SERVER carries the enforcing copy of
- * this rule and of these words (core `unit-owner.util.ts`); this one exists so
- * the console can say it before the round trip rather than after.
- */
-export function ownerHandoverRequiredMessage(name?: string): string {
-  const who = name?.trim() ? `"${name.trim()}"` : "This person";
-
-  return `${who} is the owner of this unit. Assign the owner role to another tenant at the same block, level and unit before deactivating them.`;
-}

package/utils/service-type.ts

@@ -1,30 +0,0 @@
-/**
- * A SERVICE PROVIDER'S LINE OF BUSINESS, AS PEOPLE NAME IT.
- *
- * `/api/service-providers` returns the service CODE (`mechanical_electrical_services`),
- * which is a database value, not something to show an operator. This is the same
- * mapping `API-core src/utils/converter.ts spmServiceNewToOld` applies — copied
- * rather than imported, because that is a server package this layer does not
- * depend on.
- *
- * NOT the same labels as `utils/module-applications.ts APPLICATIONS`. Those name
- * the seven role-permission applications ("Mechanical & electrical", "Pest
- * control") and are keyed `mechanical-electrical`, not `*_services`. These are
- * the shorter names the service-provider screens use ("M&E", "Pest Control").
- *
- * An unknown code is returned untouched: a new service type shows as its raw
- * code, which is visibly odd, rather than vanishing from the row.
- */
-const SERVICE_TYPE_LABELS: Readonly<Record<string, string>> = Object.freeze({
-  security_agency: "Security",
-  cleaning_services: "Cleaning",
-  pool_maintenance_services: "Pool Maintenance",
-  pest_control_services: "Pest Control",
-  landscaping_services: "Landscape",
-  mechanical_electrical_services: "Mechanical & Electrical",
-});
-
-export function serviceTypeLabel(service: string | null | undefined): string {
-  const code = String(service ?? "");
-  return SERVICE_TYPE_LABELS[code] ?? code;
-}

package/utils/vehicle-qr-sticker.ts

@@ -1,184 +0,0 @@
-/**
- * Vehicle QR stickers - the pure parts (labels, selection, paging, print page).
- *
- * Kept free of Vue and of the QR library so `node --test` can run it. The
- * sticker itself carries NO resident detail: just the QR, the plate and the
- * Seven365 line. Block / level / unit / owner appear ONLY on the installer
- * strip under the dashed cut line, which is cut off before the sticker is
- * pasted on the car.
- */
-
-/** The server's most vehicles per request (POST /api/vehicles/qr/stickers). */
-export const STICKER_MAX_PER_REQUEST = 500;
-
-/** A4 sheet: 4 columns x 4 rows of 47 mm cells. */
-export const STICKER_COLUMNS = 4;
-export const STICKER_ROWS = 4;
-export const STICKERS_PER_PAGE = STICKER_COLUMNS * STICKER_ROWS;
-
-export type StickerItem = {
-  vehicleId: string;
-  qr: string;
-  token?: string;
-  block?: string;
-  level?: string;
-  unit?: string;
-  plateNumber?: string;
-  ownerName?: string;
-  status?: string;
-};
-
-export type StickerPlateRow = {
-  id: string;
-  plateNumber: string;
-  status: string;
-  ownerName: string;
-  unitLabel: string;
-};
-
-const text = (v: unknown) => (v == null ? "" : String(v).trim());
-
-/** "Blk 4 #02-01". Tolerates a unit that already carries its level ("02-01"). */
-export function stickerUnitLabel(parts: { block?: unknown; level?: unknown; unit?: unknown }): string {
-  const block = text(parts.block).replace(/^(blk|block)\.?\s*/i, "");
-  const level = text(parts.level).replace(/^(level|lvl|floor)\.?\s*/i, "");
-  const unit = text(parts.unit).replace(/^(unit)\.?\s*/i, "").replace(/^#/, "");
-  const home = unit.includes("-") || !level ? unit : `${level}-${unit}`;
-  return [block ? `Blk ${block}` : "", home ? `#${home}` : ""].filter(Boolean).join(" ");
-}
-
-/** The installer strip under the cut line: where it goes and whose car. */
-export function installerLine(item: Pick<StickerItem, "block" | "level" | "unit" | "ownerName">): {
-  place: string;
-  owner: string;
-} {
-  return { place: stickerUnitLabel(item), owner: text(item.ownerName) };
-}
-
-export type StickerWarning = { level: "error" | "warning"; text: string };
-
-/** What the preview says about a status. Null = nothing to warn about. */
-export function stickerWarning(status: unknown): StickerWarning | null {
-  switch (text(status).toLowerCase()) {
-    case "expired":
-      return { level: "error", text: "Season pass expired" };
-    case "blocklisted":
-      return { level: "error", text: "On the blocklist" };
-    case "inactive":
-      return { level: "warning", text: "Vehicle is inactive" };
-    case "pending":
-      return { level: "warning", text: "Waiting for approval" };
-    default:
-      return null;
-  }
-}
-
-/** Stickers that should NOT be ticked for printing until someone chooses to. */
-export function stickerStartsUnticked(status: unknown): boolean {
-  return stickerWarning(status)?.level === "error" || text(status).toLowerCase() === "inactive";
-}
-
-/** The ids ticked by default in the preview. */
-export function defaultStickerIds(items: Pick<StickerItem, "vehicleId" | "status">[]): string[] {
-  return items.filter((i) => !stickerStartsUnticked(i.status)).map((i) => i.vehicleId);
-}
-
-/** One selectable row per plate, from the list's grouped rows. */
-export function stickerPlateRows(rows: Array<Record<string, any>>): StickerPlateRow[] {
-  const out: StickerPlateRow[] = [];
-  for (const row of rows ?? []) {
-    const plates: any[] = Array.isArray(row?.plates) && row.plates.length ? row.plates : [row];
-    for (const plate of plates) {
-      if (!plate?._id) continue;
-      out.push({
-        id: String(plate._id),
-        plateNumber: text(plate.plateNumber),
-        status: text(plate.status).toLowerCase(),
-        ownerName: text(row?.name ?? plate.name),
-        unitLabel: stickerUnitLabel({
-          block: row?.block?.name ?? row?.block,
-          level: row?.level?.name ?? row?.level,
-          unit: row?.unit?.name ?? row?.unit,
-        }),
-      });
-    }
-  }
-  return out;
-}
-
-/** Plates ticked on first open: live ones only (active / season pass). */
-export function defaultPlateIds(plates: StickerPlateRow[]): string[] {
-  return plates.filter((p) => p.status === "active" || p.status === "temporary").map((p) => p.id);
-}
-
-/** Tick or untick a group of ids (e.g. "select all on this page"). */
-export function setIds(selected: string[], ids: string[], on: boolean): string[] {
-  const rest = selected.filter((id) => !ids.includes(id));
-  return on ? [...rest, ...ids] : rest;
-}
-
-/** The ids to send: unique, in order, at most what the server accepts. */
-export function idsForRequest(ids: string[]): { ids: string[]; dropped: number } {
-  const unique = [...new Set(ids)];
-  return { ids: unique.slice(0, STICKER_MAX_PER_REQUEST), dropped: Math.max(0, unique.length - STICKER_MAX_PER_REQUEST) };
-}
-
-/** Split into sheets. */
-export function stickerPages<T>(items: T[], perPage: number = STICKERS_PER_PAGE): T[][] {
-  const pages: T[][] = [];
-  for (let i = 0; i < items.length; i += perPage) pages.push(items.slice(i, i + perPage));
-  return pages;
-}
-
-export function escapeHtml(value: unknown): string {
-  return text(value)
-    .replace(/&/g, "&amp;")
-    .replace(/</g, "&lt;")
-    .replace(/>/g, "&gt;")
-    .replace(/"/g, "&quot;")
-    .replace(/'/g, "&#39;");
-}
-
-const PRINT_CSS = `
-@page { size: A4; margin: 6mm; }
-* { box-sizing: border-box; }
-html, body { margin: 0; padding: 0; background: #fff; color: #111; font-family: Arial, Helvetica, sans-serif; -webkit-print-color-adjust: exact; print-color-adjust: exact; }
-.page { display: grid; grid-template-columns: repeat(${STICKER_COLUMNS}, 47mm); gap: 2mm; justify-content: center; align-content: start; width: 198mm; height: 285mm; margin: 0 auto; break-after: page; }
-.page:last-child { break-after: auto; }
-.cell { width: 47mm; break-inside: avoid; }
-.card { width: 47mm; height: 58mm; border: 0.3mm solid #1a1a1a; border-radius: 3mm; padding: 2mm 2mm 1.6mm; display: flex; flex-direction: column; align-items: center; justify-content: space-between; text-align: center; }
-.qr { width: 32mm; height: 32mm; display: block; }
-.qr svg { width: 100%; height: 100%; display: block; }
-.plate { font-size: 13pt; font-weight: 800; letter-spacing: 0.3mm; line-height: 1.1; }
-.hint { font-size: 5.8pt; color: #333; line-height: 1.2; }
-.brand { display: flex; align-items: center; justify-content: center; gap: 1mm; font-size: 6pt; color: #222; border-top: 0.2mm solid #ccc; width: 100%; padding-top: 1mm; }
-.mark { width: 3.2mm; height: 3.2mm; border-radius: 0.8mm; background: #111; color: #fff; font-weight: 800; font-size: 5pt; line-height: 3.2mm; text-align: center; }
-.cut { margin-top: 1.2mm; border-top: 0.3mm dashed #666; padding-top: 1mm; font-size: 6.5pt; line-height: 1.25; color: #111; min-height: 8mm; }
-.cut .owner { overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
-.cut .note { color: #666; font-size: 5.5pt; }
-@media screen { body { background: #e9e9e9; zoom: 0.75; padding: 4mm 0; } .page { background: #fff; margin-bottom: 4mm; height: auto; min-height: 285mm; box-shadow: 0 0 2mm rgba(0,0,0,.25); } }
-`;
-
-/**
- * One full HTML document: A4 sheets of stickers. `qrSvgs` is parallel to
- * `items` (the QR for each, already drawn). Every value is HTML-escaped - an
- * owner name is typed by a person.
- */
-export function buildStickerDocument(items: StickerItem[], qrSvgs: string[]): string {
-  const cells = items.map((item, i) => {
-    const { place, owner } = installerLine(item);
-    return (
-      `<div class="cell"><div class="card">` +
-      `<div class="qr">${qrSvgs[i] ?? ""}</div>` +
-      `<div class="plate">${escapeHtml(item.plateNumber)}</div>` +
-      `<div class="hint">Scan with iSecure365 / iMA365</div>` +
-      `<div class="brand"><span class="mark">7</span>Powered by Seven365</div>` +
-      `</div>` +
-      `<div class="cut"><div><b>${escapeHtml(place || "-")}</b></div>` +
-      `<div class="owner">Owner: ${escapeHtml(owner || "-")}</div>` +
-      `<div class="note">Installer: cut here, then paste on this car</div></div></div>`
-    );
-  });
-  const pages = stickerPages(cells).map((p) => `<div class="page">${p.join("")}</div>`);
-  return `<!doctype html><html><head><meta charset="utf-8"><title>Vehicle QR stickers</title><style>${PRINT_CSS}</style></head><body>${pages.join("")}</body></html>`;
-}