@ticketlayer/elements-core 0.1.0 → 0.2.0

package/dist/esm/orders.js

@@ -0,0 +1,154 @@
+/**
+ * The order shape, and what every harness has to work out from it.
+ *
+ * The sales order view carries line items, totals and tickets but no event
+ * name, no occurrence date and often no customer email, so these derive what
+ * they can from the order and resolve the rest through the client. They lived
+ * in `packages/elements/src/utils/order-summary.ts`, where only the web could
+ * reach them; they moved here with the split of `tl-my-orders` and
+ * `tl-order-confirmation` (TKT-69) so the same rules answer on every runtime.
+ * That module re-exports them, so every existing import still resolves and
+ * `tl-order-tickets` and `tl-ticket`, which are not split yet, read the same
+ * helpers they always did.
+ *
+ * `en-GB` is written out in the date and money helpers rather than taken from
+ * the instance's locale. That is what the components did and this is a
+ * behaviour-identical move; `ctx.formatMoney` is the locale-aware formatter and
+ * these are deliberately not it, because an order's money arrives as a minor
+ * unit integer OR a decimal string and `formatMoney` takes only the first.
+ */
+import { expressesFee, minorUnits, FEE_LABEL_FALLBACK } from './money.js';
+/** Money arrives as minor-unit integers or decimal strings ("50.00"). */
+export function formatPrice(value, currency = 'GBP') {
+    if (value === null || value === undefined || value === '')
+        return '';
+    const fmt = new Intl.NumberFormat('en-GB', { style: 'currency', currency });
+    if (typeof value === 'number')
+        return fmt.format(value / 100);
+    const n = Number(value);
+    return Number.isNaN(n) ? String(value) : fmt.format(n);
+}
+export function formatDateTime(iso) {
+    return new Date(iso).toLocaleDateString('en-GB', {
+        weekday: 'short',
+        day: 'numeric',
+        month: 'short',
+        year: 'numeric',
+        hour: '2-digit',
+        minute: '2-digit',
+    });
+}
+export function formatDate(iso) {
+    return new Date(iso).toLocaleDateString('en-GB', {
+        day: 'numeric',
+        month: 'short',
+        year: 'numeric',
+    });
+}
+/** Line items that are tickets (fees, taxes and discounts have their own type). */
+export function ticketItems(order) {
+    return (order.items ?? []).filter((i) => !i.type || i.type === 'ticket');
+}
+export function ticketCount(order) {
+    const fromItems = ticketItems(order).reduce((sum, i) => sum + (Number(i.quantity) || 0), 0);
+    return fromItems || order.tickets?.length || 0;
+}
+/** Event name as the order view exposes it: the first ticket line's name. */
+export function orderEventName(order) {
+    return order.eventName || ticketItems(order)[0]?.name || order.items?.[0]?.name || null;
+}
+export function orderCustomerEmail(order, customer) {
+    const fromOrder = order?.customerEmail || order?.customer?.email;
+    if (fromOrder)
+        return fromOrder;
+    const c = customer;
+    return c?.email || null;
+}
+export function statusLabel(status) {
+    if (!status)
+        return '';
+    return status.replace(/_/g, ' ').replace(/^\w/, (m) => m.toUpperCase());
+}
+export function statusTone(status) {
+    switch (status) {
+        case 'confirmed':
+            return 'success';
+        case 'completed':
+        case 'fulfilled':
+            return 'info';
+        case 'pending':
+        case 'processing':
+            return 'warning';
+        case 'cancelled':
+        case 'expired':
+        case 'failed':
+            return 'error';
+        default:
+            return 'muted';
+    }
+}
+export function errorMessage(err, fallback) {
+    return err instanceof Error && err.message ? err.message : fallback;
+}
+/**
+ * Find the event and start time for an occurrence id. The order view only
+ * carries the occurrence id, so this walks the channel's listings (cached by
+ * live-api) until one owns the occurrence. Best effort: null when not found,
+ * and null on a client whose events manager cannot list or fetch, which is an
+ * older connector rather than a failure.
+ */
+export async function resolveOccurrence(client, occurrenceId, maxEvents = 12) {
+    const events = client.getEventsManager();
+    if (!events?.list || !events.get)
+        return null;
+    const listing = await events.list({ limit: maxEvents });
+    const items = (listing?.items ?? []);
+    const candidates = items.slice(0, maxEvents);
+    for (const candidate of candidates) {
+        const detail = (await events.get(candidate.id).catch(() => null));
+        const occ = detail?.occurrences?.find((o) => o.id === occurrenceId);
+        if (occ) {
+            return {
+                eventId: detail?.id ?? candidate.id,
+                eventName: detail?.name ?? candidate.name ?? '',
+                startsAt: occ.startsAt ?? null,
+            };
+        }
+    }
+    return null;
+}
+export function orderTotals(order) {
+    const o = order || {};
+    const items = Array.isArray(o.items) ? o.items : [];
+    const feeLines = items.filter((i) => i.type === 'fee');
+    const discountLines = items.filter((i) => i.type === 'discount');
+    const tickets = ticketItems(o);
+    const feeFromLines = feeLines.length
+        ? feeLines.reduce((sum, i) => sum + (minorUnits(i.subtotal) ?? 0), 0)
+        : null;
+    const fees = feeFromLines ?? minorUnits(o.totalFees) ?? 0;
+    const declaredSubtotal = minorUnits(o.subtotal);
+    const subtotal = tickets.length
+        ? tickets.reduce((sum, i) => sum + (minorUnits(i.subtotal) ?? 0), 0)
+        : (declaredSubtotal ?? 0) - fees;
+    const discountFromLines = discountLines.length
+        ? discountLines.reduce((sum, i) => sum + Math.abs(minorUnits(i.subtotal) ?? 0), 0)
+        : null;
+    const discount = minorUnits(o.totalDiscounts) ?? discountFromLines ?? 0;
+    const tax = minorUnits(o.totalTax) ?? 0;
+    const named = feeLines.some((i) => typeof i.name === 'string' && !!i.name);
+    return {
+        currency: o.currency || 'GBP',
+        subtotal,
+        fees,
+        feeLabel: feeLines.map((i) => i.name).find((n) => !!n) || FEE_LABEL_FALLBACK,
+        showFee: expressesFee(feeFromLines ?? minorUnits(o.totalFees), named),
+        tax,
+        discount,
+        total: minorUnits(o.total) ?? subtotal + fees + tax - discount,
+    };
+}
+/** The rows add up to the total the order reports. Asserted in the specs. */
+export function totalsAgree(totals) {
+    return totals.subtotal + totals.fees + totals.tax - totals.discount === totals.total;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ticketlayer/elements-core",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "The headless cores the Ticketlayer Elements render: state, actions, derived values, status, strings, tokens and events, with no runtime in them",
   "main": "./dist/cjs/index.js",
   "module": "./dist/esm/index.js",
@@ -44,7 +44,7 @@
     "registry": "https://registry.npmjs.org/"
   },
   "dependencies": {
-    "@ticketlayer/theme": "^0.1.0"
+    "@ticketlayer/theme": "^0.2.0"
   },
   "devDependencies": {
     "typescript": "^5.3.3"