@7365admin1/layer-common 3.2.8-staging.210 → 3.3.0

package/utils/promo-code-form.ts

@@ -1,246 +0,0 @@
-/**
- * THE STAFF CONSOLE'S PROMO CODE EDITOR, DECIDED IN ONE PLACE.
- *
- * A Seven365 staff member opens a code, changes what it prices or when it
- * stops, turns it off, turns it back on, or removes it. Everything the screen
- * has to be sure of before it sends the request is worked out here, so the
- * form and the API can never disagree about what is wrong.
- *
- * WHAT THE SERVER ACTUALLY ENFORCES, read from the merged backend rather than
- * assumed (`@7365admin1/core` `models/promo-code.model.ts` `promoCodeUpdate` /
- * `promoCodeUpdateSchema`, mounted by `API-core` as `PUT /api/promo-codes/:id`,
- * `PATCH /api/promo-codes/:id/status`, `DELETE /api/promo-codes/:id`):
- *
- *   - `code` is IMMUTABLE. The update schema accepts the key and drops it,
- *     because a subscription records the promo code it was bought with as
- *     text. The form must not offer to change it, or a person would watch a
- *     save succeed and the code stay as it was.
- *   - `type` is required and is "fixed" or "tiered".
- *   - a tiered code needs at least one band; every band starts at 1 or more,
- *     ends at or after where it starts (0 means "and above"), and is priced at
- *     MORE than 0 - Joi's `positive()`, so a free band is refused.
- *   - a fixed code needs a price of 0 or more; 0 is legal and means free.
- *   - `expiresAt` is free text to the server. It refuses nothing, which is
- *     exactly why a date already in the past is caught HERE: saving one is not
- *     an error, it is a code that silently stops working. Since core #1885 the
- *     shared lookup DOES refuse an expired or disabled code at checkout, so a
- *     past date is now a real off-switch rather than a decoration.
- *
- * Refusals are returned one at a time and in the API's order. A list of five
- * complaints about one form is harder to act on than the first thing to fix.
- *
- * Nothing here takes a card, quotes a total, or moves money. Red Dot is the
- * payment provider (owner decision 1); a promo code sets a price per seat.
- */
-
-// Imported rather than left to Nuxt's auto-import so this file also loads
-// under plain `node --test`, the same way `theme-aa-ledger.ts` imports
-// `theme.ts`. One reader of a failed request for the whole console.
-import { readApiError } from "./subscription-form.ts";
-
-/**
- * `expiresAt` is stored as free text and this console writes MM/DD/YYYY, but
- * nothing has ever stopped another caller storing ISO - so both are read.
- * Returns the END of the expiry day: a code dated today is good all of today.
- *
- * Deliberately the same rule as the org app's `utils/promo-code.js` and core's
- * `promo-code-currency.util.ts`. The three are separate copies on purpose -
- * the org app's is plain JS so `node --test` loads it directly, and core's
- * runs on the server - but they must never disagree in front of a customer,
- * so any change to one belongs in all three.
- */
-export function promoExpiryDate(value: any): Date | null {
-  if (!value) return null;
-  const raw = String(value).trim();
-  if (!raw) return null;
-
-  const parts = raw.match(/^(\d{1,2})\/(\d{1,2})\/(\d{4})$/);
-  if (parts) {
-    const [, m, d, y] = parts;
-    const date = new Date(Number(y), Number(m) - 1, Number(d), 23, 59, 59, 999);
-    // `new Date(2026, 12, ...)` rolls into the next year rather than failing.
-    return date.getMonth() === Number(m) - 1 ? date : null;
-  }
-
-  const iso = raw.match(/^(\d{4})-(\d{2})-(\d{2})$/);
-  if (iso) {
-    const [, y, m, d] = iso;
-    const date = new Date(Number(y), Number(m) - 1, Number(d), 23, 59, 59, 999);
-    return date.getMonth() === Number(m) - 1 ? date : null;
-  }
-
-  const parsed = new Date(raw);
-  return isNaN(parsed.getTime()) ? null : parsed;
-}
-
-/** Nothing typed yet. Not the same thing as a zero, which is a real price. */
-function isBlank(value: any): boolean {
-  return value === "" || value === null || value === undefined;
-}
-
-/** What the edit form holds while a person is filling it in. */
-export interface TPromoCodeFormValues {
-  description: string;
-  type: "fixed" | "tiered";
-  fixed_rate: number;
-  expiresAt: string;
-  tiers: Array<{ min: number; max: number; price: number }>;
-}
-
-/**
- * Pre-fill the form from the record the API sent back.
- *
- * `code` is not a form value - it is not editable, so it is displayed from the
- * record and never carried through the form where a change could reach it.
- */
-export function promoCodeFormValues(
-  record: Record<string, any> | null | undefined
-): TPromoCodeFormValues {
-  const promo = record ?? {};
-  const type = promo.type === "tiered" ? "tiered" : "fixed";
-
-  return {
-    description: String(promo.description ?? ""),
-    type,
-    fixed_rate: Number(promo.fixed_rate ?? 0),
-    expiresAt: String(promo.expiresAt ?? ""),
-    tiers:
-      type === "tiered" && Array.isArray(promo.tiers)
-        ? promo.tiers.map((tier: any) => ({
-            min: Number(tier?.min ?? 1),
-            max: Number(tier?.max ?? 0),
-            price: Number(tier?.price ?? 0),
-          }))
-        : [],
-  };
-}
-
-/**
- * The body `PUT /api/promo-codes/:id` takes, and nothing more.
- *
- * No `code`, no `_id`, no `status`. The API would accept and ignore all three;
- * not sending them means this screen cannot appear to change something it
- * cannot. `status` in particular has its own endpoint - folding it in here
- * would give two answers to "is this code on".
- */
-export function promoCodeUpdatePayload(
-  values: TPromoCodeFormValues
-): Record<string, any> {
-  const payload: Record<string, any> = {
-    description: values.description ?? "",
-    type: values.type,
-    expiresAt: values.expiresAt ?? "",
-  };
-
-  // The schema FORBIDS `tiers` on a fixed code, so each shape sends only the
-  // half that applies to it. `fixed_rate` is allowed either way but means
-  // nothing on a tiered code, and the server zeroes it there regardless.
-  if (values.type === "tiered") {
-    payload.tiers = (values.tiers ?? []).map((tier) => ({
-      min: Number(tier.min),
-      max: Number(tier.max),
-      price: Number(tier.price),
-    }));
-  } else {
-    // A blank price is passed through blank rather than quietly becoming 0.
-    // `Number("")` is 0, so coercing here would turn "they have not typed a
-    // price yet" into "every seat is free" - a real price, silently saved.
-    // The API refuses a blank `fixed_rate` too, so the two agree.
-    payload.fixed_rate = isBlank(values.fixed_rate)
-      ? ""
-      : Number(values.fixed_rate);
-  }
-
-  return payload;
-}
-
-/**
- * Everything that must be true before the request goes out. Returns the ONE
- * thing to tell the person, or `null` when there is nothing to tell them.
- */
-export function validatePromoCodeEdit(
-  payload: Record<string, any>,
-  now: Date = new Date()
-): string | null {
-  if (payload?.type !== "fixed" && payload?.type !== "tiered") {
-    return "Choose how this code prices seats.";
-  }
-
-  if (payload.type === "fixed") {
-    const rate = Number(payload.fixed_rate);
-    if (isBlank(payload.fixed_rate) || !Number.isFinite(rate)) {
-      return "Enter a price per seat. Use 0 to make every seat free.";
-    }
-    if (rate < 0) {
-      return "The price per seat cannot be less than 0.";
-    }
-  }
-
-  if (payload.type === "tiered") {
-    const tiers = Array.isArray(payload.tiers) ? payload.tiers : [];
-    if (!tiers.length) {
-      return "Add at least one quantity band, or switch this code to one price for every seat.";
-    }
-
-    for (let i = 0; i < tiers.length; i++) {
-      const band = tiers[i] ?? {};
-      const where = "Band " + (i + 1) + ": ";
-      const min = Number(band.min);
-      const max = Number(band.max);
-      const price = Number(band.price);
-
-      if (!Number.isInteger(min) || min < 1) {
-        return where + "a band has to start at 1 seat or more.";
-      }
-      if (!Number.isInteger(max) || max < 0) {
-        return (
-          where +
-          "the upper limit has to be a whole number of seats, or no limit."
-        );
-      }
-      // `max: 0` is how the band editor stores "and above" - not a band that
-      // ends at zero seats, which is why the API allows it.
-      if (max !== 0 && max < min) {
-        return (
-          where + "the upper limit cannot be lower than where the band starts."
-        );
-      }
-      if (!Number.isFinite(price) || price <= 0) {
-        return (
-          where +
-          "every band needs a price above 0. To make seats free, use one price for every seat and set it to 0."
-        );
-      }
-    }
-  }
-
-  if (payload.expiresAt) {
-    const expiry = promoExpiryDate(payload.expiresAt);
-    if (!expiry) {
-      return "The expiry date is not a date we can read. Use MM/DD/YYYY.";
-    }
-    if (expiry.getTime() < now.getTime()) {
-      return "That expiry date has already passed, so the code would stop working the moment it is saved. Pick a date in the future, or clear the date to remove the expiry.";
-    }
-  }
-
-  return null;
-}
-
-/**
- * Turn a refused request into something a person can act on.
- *
- * `readApiError` is what every other console screen uses, and the API's promo
- * messages are already written to be read - "Promo code not found.", "This
- * promo code has expired." Only one answer needs rewording: the staff guard
- * says "Not authorized.", which is true and tells nobody what to do next.
- */
-export function promoCodeApiError(error: any, fallback: string): string {
-  const message = readApiError(error, fallback);
-
-  if (/^not authorized\.?$/i.test(String(message).trim())) {
-    return "Your account is not a Seven365 staff account, so it cannot change promo codes. Ask a Seven365 administrator to make the change.";
-  }
-
-  return message;
-}