@ketvietlab/ketsuite 0.1.2 → 0.1.5

package/dist/modules/hospitality_core/screens/tape-chart.js

@@ -0,0 +1,99 @@
+import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "@ketvietlab/ketjs-view/jsx-runtime";
+import { addCalendarDays, badge, dateKeyIn, emptyState, formatDateTime, inline, linkButton, providerName, ScheduleBoard, Section, setupAction, workflowTone, zonedMidnight, } from './shared.js';
+import { BoardPage, shell } from '../../../ui/index.js';
+const WORKFLOW_ORDER = ['draft', 'confirmed', 'checked_in', 'checked_out', 'no_show', 'cancelled'];
+export const tapeChartScreen = (_, chart, may, locale, frame) => {
+    const timezone = chart.timezone || 'UTC';
+    const startKey = dateKeyIn(new Date(chart.from), timezone);
+    const endKey = dateKeyIn(new Date(chart.to), timezone);
+    const dayCount = Math.max(1, Math.round((Date.parse(`${endKey}T00:00:00Z`) - Date.parse(`${startKey}T00:00:00Z`)) / 86_400_000));
+    const nowKey = dateKeyIn(new Date(), timezone);
+    const boundaries = Array.from({ length: dayCount + 1 }, (_, index) => zonedMidnight(addCalendarDays(startKey, index), timezone).getTime());
+    const days = Array.from({ length: dayCount }, (_, index) => {
+        const key = addCalendarDays(startKey, index);
+        const value = new Date(`${key}T12:00:00Z`);
+        return {
+            key,
+            label: formatDateTime(locale, value, { timeZone: 'UTC', weekday: 'short' }),
+            detail: formatDateTime(locale, value, {
+                timeZone: 'UTC',
+                day: '2-digit',
+                month: '2-digit',
+            }),
+            today: key === nowKey,
+        };
+    });
+    const unassigned = chart.events.filter((event) => !event.roomId);
+    const rows = [
+        ...chart.rooms.map((room) => ({
+            id: room.id,
+            label: room.name,
+            detail: room.roomType?.name ?? room.code,
+            state: room.status,
+        })),
+        ...unassigned.map((event) => ({
+            id: `__unassigned:${event.id}`,
+            label: _('hospitality_core.screen.tapeChart.unassigned'),
+            detail: event.guest,
+            state: 'unassigned',
+        })),
+    ];
+    const events = chart.events.map((event) => {
+        const startsAt = new Date(event.start).getTime();
+        const endsAt = new Date(event.end).getTime();
+        const matchingStart = boundaries.findIndex((_boundary, index) => index < dayCount && startsAt < boundaries[index + 1]);
+        const eventStart = matchingStart < 0 ? dayCount - 1 : Math.max(0, matchingStart);
+        const boundaryAfterEnd = boundaries.findIndex((boundary, index) => index > 0 && endsAt <= boundary);
+        const eventEnd = boundaryAfterEnd < 0 ? dayCount : boundaryAfterEnd;
+        return {
+            id: event.id,
+            rowId: event.roomId ?? `__unassigned:${event.id}`,
+            start: Math.min(dayCount - 1, eventStart),
+            span: Math.max(1, eventEnd - eventStart),
+            label: event.guest,
+            detail: providerName(_, event.provider),
+            state: event.state,
+            tone: workflowTone(event.state),
+        };
+    });
+    const title = _('hospitality_core.screen.tapeChart.title');
+    const day = (key) => formatDateTime(locale, new Date(`${key}T12:00:00Z`), {
+        timeZone: 'UTC',
+        day: '2-digit',
+        month: '2-digit',
+        year: 'numeric',
+    });
+    // The route has always taken a `?from=`, so the seven columns can be any week.
+    // Nothing on the page said which, and there was no way to reach another one.
+    const week = (offset) => `/admin/hospitality/tape-chart?from=${encodeURIComponent(addCalendarDays(startKey, offset))}&lang=${encodeURIComponent(locale)}`;
+    const lastKey = addCalendarDays(startKey, dayCount - 1);
+    // Only the states actually on this week's board. A key to a colour nobody can
+    // see is a key to nothing.
+    const shown = new Set(events.map((event) => String(event.state)));
+    const legend = WORKFLOW_ORDER.filter((state) => shown.has(state));
+    return shell(_, title, _jsx(BoardPage, { variant: "operational", frame: frame, title: title, description: `${day(startKey)} – ${day(lastKey)}`, actions: may.book
+            ? linkButton({
+                label: _('hospitality_core.reservation.action.new'),
+                href: `/admin/hospitality/reservations?create=1&lang=${encodeURIComponent(locale)}`,
+                variant: 'primary',
+            })
+            : undefined, controls: _jsxs(_Fragment, { children: [linkButton({
+                    label: _('hospitality_core.screen.tapeChart.previous'),
+                    href: week(-dayCount),
+                    variant: 'tertiary',
+                    size: 'compact',
+                }), linkButton({
+                    label: _('hospitality_core.screen.tapeChart.next'),
+                    href: week(dayCount),
+                    variant: 'tertiary',
+                    size: 'compact',
+                }), linkButton({
+                    label: _('hospitality_core.screen.tapeChart.availability'),
+                    href: `/admin/hospitality/inventory?lang=${encodeURIComponent(locale)}`,
+                    variant: 'secondary',
+                    size: 'compact',
+                })] }), body: _jsxs(_Fragment, { children: [_jsx(ScheduleBoard, { corner: _('hospitality_core.screen.tapeChart.corner'), days: days, rows: rows, events: events, empty: emptyState(_('hospitality_core.screen.tapeChart.empty'), _('hospitality_core.screen.tapeChart.emptyHint'), {
+                        actions: setupAction(_('hospitality_core.room.action.create'), '/admin/hospitality/rooms/new'),
+                    }) }), legend.length ? (_jsx(Section, { title: _('hospitality_core.screen.tapeChart.legend'), description: _('hospitality_core.screen.tapeChart.legendHint'), body: inline(legend.map((state) => badge(_(`hospitality_core.stayState.${state}`), workflowTone(state), state))) })) : null] }) }), { ...frame, topbar: false });
+};
+//# sourceMappingURL=tape-chart.js.map

package/dist/modules/hospitality_core/screens/tape-chart.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tape-chart.js","sourceRoot":"","sources":["../../../../../../../../packages/ketsuite/src/modules/hospitality_core/screens/tape-chart.tsx"],"names":[],"mappings":"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"}

package/dist/modules/hospitality_core/services.d.ts

@@ -1,9 +1,57 @@
 import type { Ctx, FnSpec } from '@ketvietlab/ketjs';
+type Issue = {
+    field: string;
+    code: string;
+    messageKey: string;
+    params?: Record<string, unknown>;
+};
 /**
  * Atomically post one operational charge and advance the folio total. The
  * source key is the idempotency boundary shared by manual and recurring service
  * materialisation.
  */
 export declare const postCharge: (ctx: Ctx, args: Record<string, unknown>) => Promise<Record<string, unknown>>;
+/** The folio moved while a cancellation was being settled against it. */
+export declare class FolioConflict extends Error {
+    readonly problem: Issue;
+    constructor(problem: Issue);
+}
+/** What a cancelled booking still owes, and where the penalty came from. */
+export type CancellationSettlement = {
+    folioId: unknown;
+    /** The stay the penalty belongs to, when there is exactly one. */
+    stayId?: unknown;
+    /** The penalty in the folio's currency. `'0'` for a free cancellation. */
+    fee: string;
+    /** Stable, so a replayed cancellation rewrites the penalty instead of adding one. */
+    chargeId: string;
+    sourceKey: string;
+    /**
+     * Why this amount: a policy type for a cancellation we priced ourselves,
+     * `provider` for an amount the channel decided. Rendered on the folio.
+     */
+    reason: string;
+    /**
+     * Which event this was. A no-show is priced by the cancellation policy but
+     * is not a cancellation, and the folio should not tell the guest it was.
+     */
+    kind?: 'cancellation' | 'no_show';
+    at: string;
+};
+/**
+ * Settle the folio of a booking that will not happen.
+ *
+ * Both the front desk and a channel revision end here, and they used to end
+ * differently. The desk wrote a `cancellation` charge and closed the folio;
+ * the channel wrote a `service` charge and left the folio `open` — and
+ * `invoiceClosedFolios` only ever looks at closed folios, so every cancellation
+ * fee an OTA ever charged sat in a folio nobody could invoice. Same event, same
+ * settlement, one place to read it.
+ *
+ * A folio owing a penalty is `closed`: the stay is off but the money is not.
+ * Only a folio owing nothing is `cancelled`.
+ */
+export declare const settleCancelledFolio: (ctx: Ctx, spec: CancellationSettlement) => Promise<void>;
 export declare const services: Record<string, FnSpec>;
+export {};
 //# sourceMappingURL=services.d.ts.map

package/dist/modules/hospitality_core/services.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"services.d.ts","sourceRoot":"","sources":["../../../../../../packages/ketsuite/src/modules/hospitality_core/services.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,EAAO,MAAM,mBAAmB,CAAA;AAmDzD;;;;GAIG;AACH,eAAO,MAAM,UAAU,QAChB,GAAG,QACF,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC5B,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAsFjC,CAAA;AAuDD,eAAO,MAAM,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CA6X3C,CAAA"}
+{"version":3,"file":"services.d.ts","sourceRoot":"","sources":["../../../../../../packages/ketsuite/src/modules/hospitality_core/services.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,EAAO,MAAM,mBAAmB,CAAA;AAazD,KAAK,KAAK,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,CAAA;AA2ElG;;;;GAIG;AACH,eAAO,MAAM,UAAU,QAChB,GAAG,QACF,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC5B,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAoIjC,CAAA;AAED,yEAAyE;AACzE,qBAAa,aAAc,SAAQ,KAAK;IACtC,QAAQ,CAAC,OAAO,EAAE,KAAK,CAAA;IAEvB,YAAY,OAAO,EAAE,KAAK,EAGzB;CACF;AAED,4EAA4E;AAC5E,MAAM,MAAM,sBAAsB,GAAG;IACnC,OAAO,EAAE,OAAO,CAAA;IAChB,kEAAkE;IAClE,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,0EAA0E;IAC1E,GAAG,EAAE,MAAM,CAAA;IACX,qFAAqF;IACrF,QAAQ,EAAE,MAAM,CAAA;IAChB,SAAS,EAAE,MAAM,CAAA;IACjB;;;OAGG;IACH,MAAM,EAAE,MAAM,CAAA;IACd;;;OAGG;IACH,IAAI,CAAC,EAAE,cAAc,GAAG,SAAS,CAAA;IACjC,EAAE,EAAE,MAAM,CAAA;CACX,CAAA;AAED;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,oBAAoB,QAAe,GAAG,QAAQ,sBAAsB,KAAG,OAAO,CAAC,IAAI,CAkD/F,CAAA;AAyDD,eAAO,MAAM,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAqZ3C,CAAA"}

package/dist/modules/hospitality_core/services.js

@@ -1,7 +1,8 @@
 import { asc, defineFn, desc, eq, from } from '@ketvietlab/ketjs';
+import { addDecimals, canonicalDecimalText, compareDecimals, decimalSign, multiplyDecimals, negateDecimalText, } from '../account/money.js';
 import { appendContentChange } from './content.js';
 import { occupancyDates } from './inventory.js';
-import { CHARGE_TYPES, EXTRA_RECURRENCES, PROPERTY_CHARGE_TYPES } from './types.js';
+import { CHARGE_FULFILLMENT_KINDS, CHARGE_TYPES, EXTRA_RECURRENCES, PROPERTY_CHARGE_TYPES } from './types.js';
 const issue = (field, code, params) => ({
     field,
     code,
@@ -21,10 +22,36 @@ const date = (value) => {
     const parsed = new Date(String(value ?? ''));
     return Number.isFinite(parsed.getTime()) ? parsed : null;
 };
-const decimal = (value) => Number(String(value ?? ''));
 const includes = (values, value) => values.includes(String(value));
 class ChargePostingConflict extends Error {
 }
+const chargeReplayMatches = (charge, args) => {
+    try {
+        const type = String(args.type ?? 'service');
+        const quantity = canonicalDecimalText(String(args.quantity ?? '1'));
+        const unitPrice = canonicalDecimalText(String(args.unitPrice));
+        const rawAmount = multiplyDecimals(quantity, unitPrice);
+        const amount = type === 'discount' && decimalSign(rawAmount) > 0 ? negateDecimalText(rawAmount) : rawAmount;
+        const occurredAt = args.occurredAt == null ? null : date(args.occurredAt)?.toISOString();
+        return (String(charge.folioId) === String(args.folioId) &&
+            String(charge.stayId ?? '') === String(args.stayId ?? '') &&
+            String(charge.extraLineId ?? '') === String(args.extraLineId ?? '') &&
+            String(charge.productId ?? '') === String(args.productId ?? '') &&
+            String(charge.uomId ?? '') === String(args.uomId ?? '') &&
+            String(charge.description) === text(args.description) &&
+            String(charge.type) === type &&
+            String(charge.fulfillmentKind ?? 'none') === String(args.fulfillmentKind ?? 'none') &&
+            compareDecimals(String(charge.quantity), quantity) === 0 &&
+            compareDecimals(String(charge.unitPrice), unitPrice) === 0 &&
+            compareDecimals(String(charge.amount), amount) === 0 &&
+            String(charge.serviceDate ?? '') === String(args.serviceDate ?? '') &&
+            String(charge.sourceKey ?? '') === String(text(args.sourceKey) || '') &&
+            (!occurredAt || String(charge.occurredAt) === occurredAt));
+    }
+    catch {
+        return false;
+    }
+};
 const productDetails = async (ctx, productId, uomId) => {
     const product = await one(ctx, 'product.Product', productId);
     const template = product ? await one(ctx, 'product.Template', product.templateId) : null;
@@ -47,24 +74,48 @@ const productDetails = async (ctx, productId, uomId) => {
 export const postCharge = async (ctx, args) => {
     const existing = await one(ctx, 'hospitality_core.Charge', args.id);
     if (existing)
-        return success(existing.id, { amount: existing.amount, existing: true });
+        return chargeReplayMatches(existing, args)
+            ? success(existing.id, { amount: existing.amount, existing: true })
+            : failure(issue('id', 'charge_id_reused'));
     const sourceKey = text(args.sourceKey) || null;
     if (sourceKey) {
         const C = ctx.table('hospitality_core.Charge');
         const duplicate = await ctx.db.one(from(C).where(eq(C.sourceKey, sourceKey)));
         if (duplicate)
-            return success(duplicate.id, { amount: duplicate.amount, existing: true });
+            return chargeReplayMatches(duplicate, args)
+                ? success(duplicate.id, { amount: duplicate.amount, existing: true })
+                : failure(issue('sourceKey', 'charge_source_reused'));
     }
     const folio = await one(ctx, 'hospitality_core.Folio', args.folioId);
     const stay = args.stayId ? await one(ctx, 'hospitality_core.Stay', args.stayId) : null;
     const extraLine = args.extraLineId ? await one(ctx, 'hospitality_core.ExtraLine', args.extraLineId) : null;
     const product = args.productId ? await productDetails(ctx, args.productId, args.uomId) : null;
     const type = String(args.type ?? 'service');
-    const quantity = decimal(args.quantity ?? 1);
-    const unitPrice = decimal(args.unitPrice);
-    const rawAmount = quantity * unitPrice;
-    const amount = String(type === 'discount' ? -Math.abs(rawAmount) : rawAmount);
+    const fulfillmentKind = String(args.fulfillmentKind ?? 'none');
+    let quantity = '';
+    let unitPrice = '';
+    let amount = '';
     const errors = [];
+    try {
+        quantity = canonicalDecimalText(String(args.quantity ?? '1'));
+    }
+    catch {
+        errors.push(issue('quantity', 'decimal'));
+    }
+    try {
+        unitPrice = canonicalDecimalText(String(args.unitPrice));
+    }
+    catch {
+        errors.push(issue('unitPrice', 'decimal'));
+    }
+    try {
+        const rawAmount = multiplyDecimals(quantity, unitPrice);
+        amount = type === 'discount' && decimalSign(rawAmount) > 0 ? negateDecimalText(rawAmount) : rawAmount;
+    }
+    catch {
+        if (quantity && unitPrice)
+            errors.push(issue('unitPrice', 'decimal'));
+    }
     if (!folio)
         errors.push(issue('folioId', 'folio_missing'));
     else if (folio.state !== 'open')
@@ -81,15 +132,34 @@ export const postCharge = async (ctx, args) => {
         errors.push(issue('productId', 'product_missing'));
     else if (product && !product.template)
         errors.push(issue('productId', 'product_template_missing'));
+    else if (product &&
+        (product.product?.active !== true ||
+            product.template?.active !== true ||
+            product.template?.saleOk !== true))
+        errors.push(issue('productId', 'product_not_saleable'));
     if (args.uomId && !product?.validUom)
         errors.push(issue('uomId', 'product_uom_mismatch'));
+    if (args.uomId && !args.productId)
+        errors.push(issue('uomId', 'product_required'));
     if (!text(args.description))
         errors.push(issue('description', 'required'));
     if (!includes(CHARGE_TYPES, type))
         errors.push(issue('type', 'charge_type'));
-    if (!Number.isFinite(quantity) || quantity < 0)
+    if (!includes(CHARGE_FULFILLMENT_KINDS, fulfillmentKind))
+        errors.push(issue('fulfillmentKind', 'charge_fulfillment_kind'));
+    if (fulfillmentKind === 'external_stock' && !args.productId)
+        errors.push(issue('productId', 'product_required'));
+    if (type === 'minibar') {
+        if (!args.productId)
+            errors.push(issue('productId', 'minibar_product_required'));
+        if (product?.template && product.template.type !== 'goods')
+            errors.push(issue('productId', 'minibar_goods_required'));
+        if (fulfillmentKind !== 'external_stock')
+            errors.push(issue('fulfillmentKind', 'minibar_fulfillment_required'));
+    }
+    if (quantity && compareDecimals(quantity, '0') < 0)
         errors.push(issue('quantity', 'non_negative'));
-    if (!Number.isFinite(unitPrice) || unitPrice < 0)
+    if (unitPrice && compareDecimals(unitPrice, '0') < 0)
         errors.push(issue('unitPrice', 'non_negative'));
     const occurredAt = date(args.occurredAt)?.toISOString() ?? new Date().toISOString();
     const serviceDate = args.serviceDate == null ? null : text(args.serviceDate);
@@ -109,8 +179,9 @@ export const postCharge = async (ctx, args) => {
                 uomId: args.uomId,
                 description: text(args.description),
                 type,
-                quantity: String(quantity),
-                unitPrice: String(unitPrice),
+                fulfillmentKind,
+                quantity,
+                unitPrice,
                 amount,
                 occurredAt,
                 serviceDate,
@@ -124,13 +195,15 @@ export const postCharge = async (ctx, args) => {
                     : await one(tx, 'hospitality_core.Charge', args.id);
                 if (!duplicate)
                     throw new ChargePostingConflict();
+                if (!chargeReplayMatches(duplicate, args))
+                    return failure(issue(sourceKey ? 'sourceKey' : 'id', sourceKey ? 'charge_source_reused' : 'charge_id_reused'));
                 return success(duplicate.id, { amount: duplicate.amount, existing: true });
             }
             for (let attempt = 0; attempt < 5; attempt++) {
                 const current = await one(tx, 'hospitality_core.Folio', folio.id);
                 if (current?.state !== 'open')
                     throw new ChargePostingConflict();
-                const next = String(Number(current.amountTotal) + Number(amount));
+                const next = addDecimals(String(current.amountTotal), amount);
                 const changed = await tx.db.compareAndSet('hospitality_core.Folio', { id: folio.id }, { state: 'open', version: current.version }, { amountTotal: next, version: Number(current.version) + 1 });
                 if ('dryRun' in changed || changed.matched)
                     return success(args.id, { amount, existing: false });
@@ -144,6 +217,76 @@ export const postCharge = async (ctx, args) => {
         throw error;
     }
 };
+/** The folio moved while a cancellation was being settled against it. */
+export class FolioConflict extends Error {
+    problem;
+    constructor(problem) {
+        super(problem.code);
+        this.problem = problem;
+    }
+}
+/**
+ * Settle the folio of a booking that will not happen.
+ *
+ * Both the front desk and a channel revision end here, and they used to end
+ * differently. The desk wrote a `cancellation` charge and closed the folio;
+ * the channel wrote a `service` charge and left the folio `open` — and
+ * `invoiceClosedFolios` only ever looks at closed folios, so every cancellation
+ * fee an OTA ever charged sat in a folio nobody could invoice. Same event, same
+ * settlement, one place to read it.
+ *
+ * A folio owing a penalty is `closed`: the stay is off but the money is not.
+ * Only a folio owing nothing is `cancelled`.
+ */
+export const settleCancelledFolio = async (ctx, spec) => {
+    const owed = compareDecimals(spec.fee, '0') > 0;
+    const C = ctx.table('hospitality_core.Charge');
+    const active = await ctx.db.all(from(C).where(eq(C.folioId, spec.folioId), eq(C.state, 'active')));
+    // Nothing on this folio was consumed — a cancellation is refused once anyone
+    // has checked in — so the room nights and extras booked against it are void
+    // and the penalty is all that stands.
+    for (const charge of active) {
+        if (String(charge.id) === spec.chargeId)
+            continue;
+        await ctx.db.update('hospitality_core.Charge', { id: charge.id }, { state: 'void' });
+    }
+    const existing = await one(ctx, 'hospitality_core.Charge', spec.chargeId);
+    if (!owed && existing)
+        await ctx.db.update('hospitality_core.Charge', { id: spec.chargeId }, { state: 'void' });
+    if (owed) {
+        const values = {
+            folioId: spec.folioId,
+            stayId: spec.stayId ?? null,
+            description: `${spec.kind ?? 'cancellation'}:${spec.reason}`,
+            type: 'cancellation',
+            quantity: '1',
+            unitPrice: spec.fee,
+            amount: spec.fee,
+            occurredAt: spec.at,
+            sourceKey: spec.sourceKey,
+            state: 'active',
+        };
+        if (existing)
+            await ctx.db.update('hospitality_core.Charge', { id: spec.chargeId }, values);
+        else
+            await ctx.db.insert('hospitality_core.Charge', { id: spec.chargeId, ...values });
+    }
+    const folio = await one(ctx, 'hospitality_core.Folio', spec.folioId);
+    const claim = await ctx.db.compareAndSet('hospitality_core.Folio', { id: spec.folioId }, { state: folio?.state, version: folio?.version }, {
+        state: owed ? 'closed' : 'cancelled',
+        amountTotal: spec.fee,
+        closedAt: spec.at,
+        version: Number(folio?.version ?? 0) + 1,
+    });
+    // A charge posted between the void above and this write would otherwise sit
+    // active on a closed folio, outside a total that no longer counts it.
+    if (!('dryRun' in claim) && !claim.matched)
+        throw new FolioConflict({
+            field: 'folioId',
+            code: 'transition_conflict',
+            messageKey: 'hospitality_core.validation.transition_conflict',
+        });
+};
 const extraOutput = {
     id: 'id',
     reservationId: 'id?',
@@ -153,6 +296,8 @@ const extraOutput = {
     productId: 'id',
     uomId: 'id?',
     description: 'text',
+    chargeType: 'text',
+    fulfillmentKind: 'text',
     quantity: 'decimal',
     unitPrice: 'decimal',
     recurrence: 'text',
@@ -185,12 +330,14 @@ const withProductNames = async (ctx, rows) => {
         const charges = Array.isArray(row.charges) ? row.charges : [];
         return {
             ...row,
+            chargeType: String(row.chargeType ?? 'service'),
+            fulfillmentKind: String(row.fulfillmentKind ?? 'none'),
             productName: String(template?.name ?? row.productId),
             productCode: product?.defaultCode ?? null,
             materializedCount: charges.filter((charge) => charge.state === 'active').length,
-            materializedAmount: String(charges
+            materializedAmount: charges
                 .filter((charge) => charge.state === 'active')
-                .reduce((total, charge) => total + Number(charge.amount ?? 0), 0)),
+                .reduce((total, charge) => addDecimals(total, String(charge.amount ?? '0')), '0'),
         };
     });
 };
@@ -257,7 +404,7 @@ export const services = {
         handler: async (ctx, args) => {
             const property = await one(ctx, 'hospitality_core.Property', args.propertyId);
             const existing = await one(ctx, 'hospitality_core.PropertyCharge', args.id);
-            const amount = decimal(args.amount);
+            const amount = canonicalDecimalText(String(args.amount));
             const errors = [];
             if (!property)
                 errors.push(issue('propertyId', 'property_missing'));
@@ -265,7 +412,7 @@ export const services = {
                 errors.push(issue('chargeType', 'property_charge_type'));
             if (!text(args.name))
                 errors.push(issue('name', 'required'));
-            if (!Number.isFinite(amount) || amount < 0)
+            if (compareDecimals(amount, '0') < 0)
                 errors.push(issue('amount', 'non_negative'));
             const C = ctx.table('hospitality_core.PropertyCharge');
             const duplicate = (await ctx.db.all(from(C).where(eq(C.propertyId, args.propertyId), eq(C.chargeType, args.chargeType)))).find((row) => row.id !== args.id && text(row.name) === text(args.name));
@@ -279,7 +426,7 @@ export const services = {
                     propertyId: args.propertyId,
                     chargeType: args.chargeType,
                     name: text(args.name),
-                    amount: String(amount),
+                    amount,
                     description: text(args.description) || null,
                     active: args.active ?? true,
                 };
@@ -336,6 +483,8 @@ export const services = {
             productId: 'id',
             uomId: 'id?',
             description: 'text?',
+            chargeType: 'text?',
+            fulfillmentKind: 'text?',
             quantity: 'decimal?',
             unitPrice: 'decimal?',
             recurrence: 'text?',
@@ -366,8 +515,12 @@ export const services = {
                         (args.productId != null && args.productId !== existing.productId) ||
                         (args.uomId != null && args.uomId !== existing.uomId) ||
                         (args.description != null && text(args.description) !== existing.description) ||
-                        (args.quantity != null && decimal(args.quantity) !== Number(existing.quantity)) ||
-                        (args.unitPrice != null && decimal(args.unitPrice) !== Number(existing.unitPrice)) ||
+                        (args.chargeType != null && args.chargeType !== existing.chargeType) ||
+                        (args.fulfillmentKind != null && args.fulfillmentKind !== existing.fulfillmentKind) ||
+                        (args.quantity != null &&
+                            compareDecimals(String(args.quantity), String(existing.quantity)) !== 0) ||
+                        (args.unitPrice != null &&
+                            compareDecimals(String(args.unitPrice), String(existing.unitPrice)) !== 0) ||
                         (args.recurrence != null && args.recurrence !== existing.recurrence) ||
                         (args.active != null && args.active !== existing.active);
                     return changed
@@ -384,8 +537,10 @@ export const services = {
             const folio = target ? await one(ctx, 'hospitality_core.Folio', target.folioId) : null;
             const product = await productDetails(ctx, args.productId, args.uomId);
             const recurrence = String(args.recurrence ?? 'once');
-            const quantity = decimal(args.quantity ?? 1);
-            const unitPrice = decimal(args.unitPrice ?? product.template?.listPrice);
+            const chargeType = String(args.chargeType ?? 'service');
+            const fulfillmentKind = String(args.fulfillmentKind ?? 'none');
+            const quantity = canonicalDecimalText(String(args.quantity ?? '1'));
+            const unitPrice = canonicalDecimalText(String(args.unitPrice ?? product.template?.listPrice));
             const errors = [];
             if (targetCount !== 1)
                 errors.push(issue('reservationId', 'extra_line_target'));
@@ -409,11 +564,21 @@ export const services = {
                 errors.push(issue('productId', 'product_not_saleable'));
             if (args.uomId && !product.validUom)
                 errors.push(issue('uomId', 'product_uom_mismatch'));
+            if (!includes(CHARGE_TYPES, chargeType))
+                errors.push(issue('chargeType', 'charge_type'));
+            if (!includes(CHARGE_FULFILLMENT_KINDS, fulfillmentKind))
+                errors.push(issue('fulfillmentKind', 'charge_fulfillment_kind'));
+            if (chargeType === 'minibar') {
+                if (product.template?.type !== 'goods')
+                    errors.push(issue('productId', 'minibar_goods_required'));
+                if (fulfillmentKind !== 'external_stock')
+                    errors.push(issue('fulfillmentKind', 'minibar_fulfillment_required'));
+            }
             if (!includes(EXTRA_RECURRENCES, recurrence))
                 errors.push(issue('recurrence', 'extra_recurrence'));
-            if (!Number.isFinite(quantity) || quantity <= 0)
+            if (compareDecimals(quantity, '0') <= 0)
                 errors.push(issue('quantity', 'positive'));
-            if (!Number.isFinite(unitPrice) || unitPrice < 0)
+            if (compareDecimals(unitPrice, '0') < 0)
                 errors.push(issue('unitPrice', 'non_negative'));
             if (errors.length || !target || !folio || !product.template)
                 return failure(...errors);
@@ -427,8 +592,10 @@ export const services = {
                 productId: args.productId,
                 uomId: args.uomId ?? product.template.uomId ?? null,
                 description: text(args.description) || String(product.template.name),
-                quantity: String(quantity),
-                unitPrice: String(unitPrice),
+                chargeType,
+                fulfillmentKind,
+                quantity,
+                unitPrice,
                 recurrence,
                 active: args.active ?? true,
                 createdAt: existing?.createdAt ?? timestamp,
@@ -481,6 +648,9 @@ export const services = {
                 return failure(issue('id', 'extra_line_missing'));
             if (line.active !== true)
                 return failure(issue('id', 'extra_line_inactive'));
+            const fulfillmentKind = String(line.fulfillmentKind ?? 'none');
+            if (fulfillmentKind === 'external_stock')
+                return failure(issue('fulfillmentKind', 'external_fulfillment_required'));
             const reservation = line.reservationId
                 ? await one(ctx, 'hospitality_core.Reservation', line.reservationId)
                 : null;
@@ -498,7 +668,7 @@ export const services = {
             const serviceDate = text(args.serviceDate);
             const errors = [];
             let suffix = 'once';
-            let quantity = decimal(line.quantity);
+            let quantity = canonicalDecimalText(String(line.quantity));
             if (line.recurrence === 'per_night') {
                 if (!/^\d{4}-\d{2}-\d{2}$/u.test(serviceDate))
                     errors.push(issue('serviceDate', 'date'));
@@ -512,8 +682,8 @@ export const services = {
             else if (line.recurrence === 'per_unit') {
                 if (!args.requestKey)
                     errors.push(issue('requestKey', 'required'));
-                quantity = decimal(args.quantity);
-                if (!Number.isFinite(quantity) || quantity <= 0)
+                quantity = canonicalDecimalText(String(args.quantity));
+                if (compareDecimals(quantity, '0') <= 0)
                     errors.push(issue('quantity', 'positive'));
                 suffix = `unit:${String(args.requestKey ?? '')}`;
             }
@@ -530,7 +700,8 @@ export const services = {
                 productId: line.productId,
                 uomId: line.uomId,
                 description: line.description,
-                type: 'service',
+                type: line.chargeType ?? 'service',
+                fulfillmentKind,
                 quantity,
                 unitPrice: line.unitPrice,
                 occurredAt: args.occurredAt ?? (line.recurrence === 'per_night' ? `${serviceDate}T12:00:00.000Z` : undefined),
@@ -553,6 +724,8 @@ export const services = {
             productId: 'id?',
             uomId: 'id?',
             description: 'text',
+            type: 'text',
+            fulfillmentKind: 'text',
             quantity: 'decimal',
             unitPrice: 'decimal',
             amount: 'decimal',