@kohost/api-client 7.7.1 → 7.8.0

package/dist/lib/bills.d.ts

@@ -0,0 +1,74 @@
+/**
+ * The bill rules the API and the app must apply identically: the rate a bill
+ * taxes at, its grand total, and the date it reads as effective. The API's send
+ * gate, its PDF render and its cross-org sort key all derive from these, and so
+ * does every total the browser prints — the ledger row, the org bill list, the
+ * detail view. Written once here so a total shown next to a sort order the
+ * server produced cannot disagree with it.
+ *
+ * Structural types carry just the fields a rule reads, so schema-derived
+ * documents assign without adapters.
+ */
+export type BillTaxFields = {
+    taxRate?: number | null;
+    shippingAmount?: number | null;
+};
+/**
+ * The rate a bill actually taxes at: its own explicit rate, else the platform
+ * default while drafting. An exempt org always resolves to zero.
+ */
+export declare function effectiveTaxRate(bill: BillTaxFields, taxExempt: boolean): number;
+export type TaxableLine = {
+    amount?: number | null;
+    taxable?: boolean;
+};
+/** The sum of the taxable lines' amounts — credits included — in integer cents. */
+export declare function taxableSubtotal(lines: readonly TaxableLine[]): number;
+/**
+ * Subtotal, tax, shipping, and grand total for one bill, from already-resolved
+ * line amounts — the single derivation the document, the send gate, and the org
+ * projection all share.
+ */
+export declare function billTotals(lines: readonly TaxableLine[], bill: BillTaxFields, taxExempt: boolean): {
+    subtotal: number;
+    taxRate: number;
+    taxAmount: number;
+    shippingAmount: number;
+    total: number;
+};
+/**
+ * The exemption a bill's totals resolve with: while drafting it live-reads
+ * from the org; once sent the bill carries its own snapshot, frozen at
+ * mark-sent. The one resolution the document render, the detail read, and the
+ * ledger all share, so their totals cannot drift.
+ */
+export declare function resolveBillTaxExempt(bill: {
+    status: string;
+    taxExempt?: boolean | null;
+}, orgTaxExempt: boolean): boolean;
+export type SettledBillTotalSource = BillTaxFields & {
+    status: string;
+    taxExempt?: boolean | null;
+    lines?: readonly TaxableLine[] | null;
+};
+/**
+ * A bill's grand total as a summary row shows it, from the snapshot the bill
+ * itself carries. Null for a draft — draft cost lines hold no amount until
+ * mark-sent resolves and freezes them, so a draft has no honest total to show
+ * and no org read is reached for. A settled (sent/paid/void) bill's frozen
+ * lines, rate, and exemption yield exactly the total the detail document
+ * prints.
+ */
+export declare function settledBillTotal(bill: SettledBillTotalSource): number | null;
+export type BillEffectiveDateSource = {
+    sentAt?: Date | string | null;
+    createdAt?: Date | string | null;
+};
+/**
+ * The date a bill reads as: when it was sent once it has been, else when it was
+ * started. This is the key the cross-org ledger sorts, filters and pages on, so
+ * the server evaluates the same rule in Mongo (`$ifNull: ["$sentAt",
+ * "$createdAt"]`) to order a page. Returned as an ISO string; a bill with
+ * neither date falls to the epoch rather than to an unsortable null.
+ */
+export declare function billEffectiveDate(bill: BillEffectiveDateSource): string;

package/dist/lib/bills.js

@@ -0,0 +1,83 @@
+import { billGrandTotal, billTaxAmount, billTotal } from "./money.js";
+//#region .generated/lib/bills.ts
+/**
+* The bill rules the API and the app must apply identically: the rate a bill
+* taxes at, its grand total, and the date it reads as effective. The API's send
+* gate, its PDF render and its cross-org sort key all derive from these, and so
+* does every total the browser prints — the ledger row, the org bill list, the
+* detail view. Written once here so a total shown next to a sort order the
+* server produced cannot disagree with it.
+*
+* Structural types carry just the fields a rule reads, so schema-derived
+* documents assign without adapters.
+*/
+/**
+* The rate a bill actually taxes at: its own explicit rate, else the platform
+* default while drafting. An exempt org always resolves to zero.
+*/
+function effectiveTaxRate(bill, taxExempt) {
+	if (taxExempt) return 0;
+	return bill.taxRate ?? 8.375;
+}
+/** The sum of the taxable lines' amounts — credits included — in integer cents. */
+function taxableSubtotal(lines) {
+	return billTotal(lines.filter((line) => line.taxable).map((line) => line.amount ?? 0));
+}
+/**
+* Subtotal, tax, shipping, and grand total for one bill, from already-resolved
+* line amounts — the single derivation the document, the send gate, and the org
+* projection all share.
+*/
+function billTotals(lines, bill, taxExempt) {
+	const subtotal = billTotal(lines.map((line) => line.amount ?? 0));
+	const taxRate = effectiveTaxRate(bill, taxExempt);
+	const taxAmount = billTaxAmount(taxableSubtotal(lines), taxRate);
+	const shippingAmount = bill.shippingAmount ?? 0;
+	return {
+		subtotal,
+		taxRate,
+		taxAmount,
+		shippingAmount,
+		total: billGrandTotal({
+			subtotal,
+			tax: taxAmount,
+			shipping: shippingAmount
+		})
+	};
+}
+/**
+* The exemption a bill's totals resolve with: while drafting it live-reads
+* from the org; once sent the bill carries its own snapshot, frozen at
+* mark-sent. The one resolution the document render, the detail read, and the
+* ledger all share, so their totals cannot drift.
+*/
+function resolveBillTaxExempt(bill, orgTaxExempt) {
+	return bill.status === "draft" ? orgTaxExempt : bill.taxExempt ?? false;
+}
+/**
+* A bill's grand total as a summary row shows it, from the snapshot the bill
+* itself carries. Null for a draft — draft cost lines hold no amount until
+* mark-sent resolves and freezes them, so a draft has no honest total to show
+* and no org read is reached for. A settled (sent/paid/void) bill's frozen
+* lines, rate, and exemption yield exactly the total the detail document
+* prints.
+*/
+function settledBillTotal(bill) {
+	if (bill.status === "draft") return null;
+	return billTotals(bill.lines ?? [], bill, resolveBillTaxExempt(bill, false)).total;
+}
+/**
+* The date a bill reads as: when it was sent once it has been, else when it was
+* started. This is the key the cross-org ledger sorts, filters and pages on, so
+* the server evaluates the same rule in Mongo (`$ifNull: ["$sentAt",
+* "$createdAt"]`) to order a page. Returned as an ISO string; a bill with
+* neither date falls to the epoch rather than to an unsortable null.
+*/
+function billEffectiveDate(bill) {
+	const value = bill.sentAt ?? bill.createdAt ?? 0;
+	return new Date(value).toISOString();
+}
+//#endregion
+export { billEffectiveDate, billTotals, effectiveTaxRate, resolveBillTaxExempt, settledBillTotal, taxableSubtotal };
+
+//# sourceMappingURL=bills.js.map

package/dist/lib/bills.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bills.js","names":[],"sources":["../../.generated/lib/bills.ts"],"sourcesContent":["/**\n * The bill rules the API and the app must apply identically: the rate a bill\n * taxes at, its grand total, and the date it reads as effective. The API's send\n * gate, its PDF render and its cross-org sort key all derive from these, and so\n * does every total the browser prints — the ledger row, the org bill list, the\n * detail view. Written once here so a total shown next to a sort order the\n * server produced cannot disagree with it.\n *\n * Structural types carry just the fields a rule reads, so schema-derived\n * documents assign without adapters.\n */\n\nimport {\n  DEFAULT_TAX_RATE,\n  billGrandTotal,\n  billTaxAmount,\n  billTotal,\n} from \"./money.js\";\n\nexport type BillTaxFields = {\n  taxRate?: number | null;\n  shippingAmount?: number | null;\n};\n\n/**\n * The rate a bill actually taxes at: its own explicit rate, else the platform\n * default while drafting. An exempt org always resolves to zero.\n */\nexport function effectiveTaxRate(\n  bill: BillTaxFields,\n  taxExempt: boolean,\n): number {\n  if (taxExempt) return 0;\n  return bill.taxRate ?? DEFAULT_TAX_RATE;\n}\n\nexport type TaxableLine = { amount?: number | null; taxable?: boolean };\n\n/** The sum of the taxable lines' amounts — credits included — in integer cents. */\nexport function taxableSubtotal(lines: readonly TaxableLine[]): number {\n  return billTotal(\n    lines.filter((line) => line.taxable).map((line) => line.amount ?? 0),\n  );\n}\n\n/**\n * Subtotal, tax, shipping, and grand total for one bill, from already-resolved\n * line amounts — the single derivation the document, the send gate, and the org\n * projection all share.\n */\nexport function billTotals(\n  lines: readonly TaxableLine[],\n  bill: BillTaxFields,\n  taxExempt: boolean,\n): {\n  subtotal: number;\n  taxRate: number;\n  taxAmount: number;\n  shippingAmount: number;\n  total: number;\n} {\n  const subtotal = billTotal(lines.map((line) => line.amount ?? 0));\n  const taxRate = effectiveTaxRate(bill, taxExempt);\n  const taxAmount = billTaxAmount(taxableSubtotal(lines), taxRate);\n  const shippingAmount = bill.shippingAmount ?? 0;\n  return {\n    subtotal,\n    taxRate,\n    taxAmount,\n    shippingAmount,\n    total: billGrandTotal({\n      subtotal,\n      tax: taxAmount,\n      shipping: shippingAmount,\n    }),\n  };\n}\n\n/**\n * The exemption a bill's totals resolve with: while drafting it live-reads\n * from the org; once sent the bill carries its own snapshot, frozen at\n * mark-sent. The one resolution the document render, the detail read, and the\n * ledger all share, so their totals cannot drift.\n */\nexport function resolveBillTaxExempt(\n  bill: { status: string; taxExempt?: boolean | null },\n  orgTaxExempt: boolean,\n): boolean {\n  return bill.status === \"draft\" ? orgTaxExempt : (bill.taxExempt ?? false);\n}\n\nexport type SettledBillTotalSource = BillTaxFields & {\n  status: string;\n  taxExempt?: boolean | null;\n  lines?: readonly TaxableLine[] | null;\n};\n\n/**\n * A bill's grand total as a summary row shows it, from the snapshot the bill\n * itself carries. Null for a draft — draft cost lines hold no amount until\n * mark-sent resolves and freezes them, so a draft has no honest total to show\n * and no org read is reached for. A settled (sent/paid/void) bill's frozen\n * lines, rate, and exemption yield exactly the total the detail document\n * prints.\n */\nexport function settledBillTotal(bill: SettledBillTotalSource): number | null {\n  if (bill.status === \"draft\") return null;\n  return billTotals(bill.lines ?? [], bill, resolveBillTaxExempt(bill, false))\n    .total;\n}\n\nexport type BillEffectiveDateSource = {\n  sentAt?: Date | string | null;\n  createdAt?: Date | string | null;\n};\n\n/**\n * The date a bill reads as: when it was sent once it has been, else when it was\n * started. This is the key the cross-org ledger sorts, filters and pages on, so\n * the server evaluates the same rule in Mongo (`$ifNull: [\"$sentAt\",\n * \"$createdAt\"]`) to order a page. Returned as an ISO string; a bill with\n * neither date falls to the epoch rather than to an unsortable null.\n */\nexport function billEffectiveDate(bill: BillEffectiveDateSource): string {\n  const value = bill.sentAt ?? bill.createdAt ?? 0;\n  return new Date(value).toISOString();\n}\n"],"mappings":";;;;;;;;;;;;;;;;;AA4BA,SAAgB,iBACd,MACA,WACQ;CACR,IAAI,WAAW,OAAO;CACtB,OAAO,KAAK,WAAA;AACd;;AAKA,SAAgB,gBAAgB,OAAuC;CACrE,OAAO,UACL,MAAM,QAAQ,SAAS,KAAK,OAAO,CAAC,CAAC,KAAK,SAAS,KAAK,UAAU,CAAC,CACrE;AACF;;;;;;AAOA,SAAgB,WACd,OACA,MACA,WAOA;CACA,MAAM,WAAW,UAAU,MAAM,KAAK,SAAS,KAAK,UAAU,CAAC,CAAC;CAChE,MAAM,UAAU,iBAAiB,MAAM,SAAS;CAChD,MAAM,YAAY,cAAc,gBAAgB,KAAK,GAAG,OAAO;CAC/D,MAAM,iBAAiB,KAAK,kBAAkB;CAC9C,OAAO;EACL;EACA;EACA;EACA;EACA,OAAO,eAAe;GACpB;GACA,KAAK;GACL,UAAU;EACZ,CAAC;CACH;AACF;;;;;;;AAQA,SAAgB,qBACd,MACA,cACS;CACT,OAAO,KAAK,WAAW,UAAU,eAAgB,KAAK,aAAa;AACrE;;;;;;;;;AAgBA,SAAgB,iBAAiB,MAA6C;CAC5E,IAAI,KAAK,WAAW,SAAS,OAAO;CACpC,OAAO,WAAW,KAAK,SAAS,CAAC,GAAG,MAAM,qBAAqB,MAAM,KAAK,CAAC,CAAC,CACzE;AACL;;;;;;;;AAcA,SAAgB,kBAAkB,MAAuC;CACvE,MAAM,QAAQ,KAAK,UAAU,KAAK,aAAa;CAC/C,OAAO,IAAI,KAAK,KAAK,CAAC,CAAC,YAAY;AACrC"}

package/dist/lib/deviceNotifications.js

@@ -22,10 +22,7 @@ function inferDeviceNotifications(device) {
 	if ("powerLevel" in device) set.add("powerTrouble");
 	if ("equipment" in device) set.add("hardwareFailure");
 	switch (device.type) {
-		case "thermostat":
-			for (const n of THERMOSTAT_INFERRED) set.add(n);
-			break;
-		default: break;
+		case "thermostat": for (const n of THERMOSTAT_INFERRED) set.add(n);
 	}
 	return Array.from(set);
 }

package/dist/lib/deviceNotifications.js.map

@@ -1 +1 @@
-{"version":3,"file":"deviceNotifications.js","names":[],"sources":["../../.generated/lib/deviceNotifications.ts"],"sourcesContent":["export type DeviceNotificationName =\n  | \"communicationFailure\"\n  | \"replaceBattery\"\n  | \"hardwareFailure\"\n  | \"airFilterNeedsCleaned\"\n  | \"airFilterNeedsReplaced\"\n  | \"scheduleMaintenance\"\n  | \"outsideSafeTemperatureRange\"\n  | \"outsideSafeHumidityRange\"\n  | \"bellTrouble\"\n  | \"monitoringTrouble\"\n  | \"powerTrouble\"\n  | \"burglarAlarm\"\n  | \"fireAlarm\"\n  | \"smokeDetected\"\n  | \"doorAjar\"\n  | \"configIssue\"\n  | \"acMainsDisconnected\";\n\nexport interface InferDeviceNotificationsInput {\n  type?: string;\n  discriminator?: string;\n  offline?: unknown;\n  batteryLevel?: unknown;\n  bellTrouble?: unknown;\n  monitoringTrouble?: unknown;\n  powerLevel?: unknown;\n  equipment?: unknown;\n}\n\nconst THERMOSTAT_INFERRED: DeviceNotificationName[] = [\n  \"airFilterNeedsCleaned\",\n  \"airFilterNeedsReplaced\",\n  \"scheduleMaintenance\",\n  \"outsideSafeTemperatureRange\",\n  \"outsideSafeHumidityRange\",\n  \"hardwareFailure\",\n];\n\n/**\n * Returns the canonical notifications a device can emit, derived from its\n * shape. Replaces the legacy `device.supportedNotifications[]` reads — driver\n * implementations no longer need to declare this list.\n */\nexport function inferDeviceNotifications(\n  device: InferDeviceNotificationsInput | null | undefined,\n): DeviceNotificationName[] {\n  if (!device || !device.type) return [];\n  const set = new Set<DeviceNotificationName>();\n\n  if (\"offline\" in device) set.add(\"communicationFailure\");\n\n  if (\"batteryLevel\" in device && device.batteryLevel != null) {\n    set.add(\"replaceBattery\");\n  }\n\n  if (\"bellTrouble\" in device) set.add(\"bellTrouble\");\n  if (\"monitoringTrouble\" in device) set.add(\"monitoringTrouble\");\n  if (\"powerLevel\" in device) set.add(\"powerTrouble\");\n\n  if (\"equipment\" in device) set.add(\"hardwareFailure\");\n\n  switch (device.type) {\n    case \"thermostat\":\n      for (const n of THERMOSTAT_INFERRED) set.add(n);\n      break;\n    default:\n      break;\n  }\n\n  return Array.from(set);\n}\n"],"mappings":";AA8BA,MAAM,sBAAgD;CACpD;CACA;CACA;CACA;CACA;CACA;AACF;;;;;;AAOA,SAAgB,yBACd,QAC0B;CAC1B,IAAI,CAAC,UAAU,CAAC,OAAO,MAAM,OAAO,CAAC;CACrC,MAAM,sBAAM,IAAI,IAA4B;CAE5C,IAAI,aAAa,QAAQ,IAAI,IAAI,sBAAsB;CAEvD,IAAI,kBAAkB,UAAU,OAAO,gBAAgB,MACrD,IAAI,IAAI,gBAAgB;CAG1B,IAAI,iBAAiB,QAAQ,IAAI,IAAI,aAAa;CAClD,IAAI,uBAAuB,QAAQ,IAAI,IAAI,mBAAmB;CAC9D,IAAI,gBAAgB,QAAQ,IAAI,IAAI,cAAc;CAElD,IAAI,eAAe,QAAQ,IAAI,IAAI,iBAAiB;CAEpD,QAAQ,OAAO,MAAf;EACE,KAAK;GACH,KAAK,MAAM,KAAK,qBAAqB,IAAI,IAAI,CAAC;GAC9C;EACF,SACE;CACJ;CAEA,OAAO,MAAM,KAAK,GAAG;AACvB"}
+{"version":3,"file":"deviceNotifications.js","names":[],"sources":["../../.generated/lib/deviceNotifications.ts"],"sourcesContent":["export type DeviceNotificationName =\n  | \"communicationFailure\"\n  | \"replaceBattery\"\n  | \"hardwareFailure\"\n  | \"airFilterNeedsCleaned\"\n  | \"airFilterNeedsReplaced\"\n  | \"scheduleMaintenance\"\n  | \"outsideSafeTemperatureRange\"\n  | \"outsideSafeHumidityRange\"\n  | \"bellTrouble\"\n  | \"monitoringTrouble\"\n  | \"powerTrouble\"\n  | \"burglarAlarm\"\n  | \"fireAlarm\"\n  | \"smokeDetected\"\n  | \"doorAjar\"\n  | \"configIssue\"\n  | \"acMainsDisconnected\";\n\nexport interface InferDeviceNotificationsInput {\n  type?: string;\n  discriminator?: string;\n  offline?: unknown;\n  batteryLevel?: unknown;\n  bellTrouble?: unknown;\n  monitoringTrouble?: unknown;\n  powerLevel?: unknown;\n  equipment?: unknown;\n}\n\nconst THERMOSTAT_INFERRED: DeviceNotificationName[] = [\n  \"airFilterNeedsCleaned\",\n  \"airFilterNeedsReplaced\",\n  \"scheduleMaintenance\",\n  \"outsideSafeTemperatureRange\",\n  \"outsideSafeHumidityRange\",\n  \"hardwareFailure\",\n];\n\n/**\n * Returns the canonical notifications a device can emit, derived from its\n * shape. Replaces the legacy `device.supportedNotifications[]` reads — driver\n * implementations no longer need to declare this list.\n */\nexport function inferDeviceNotifications(\n  device: InferDeviceNotificationsInput | null | undefined,\n): DeviceNotificationName[] {\n  if (!device || !device.type) return [];\n  const set = new Set<DeviceNotificationName>();\n\n  if (\"offline\" in device) set.add(\"communicationFailure\");\n\n  if (\"batteryLevel\" in device && device.batteryLevel != null) {\n    set.add(\"replaceBattery\");\n  }\n\n  if (\"bellTrouble\" in device) set.add(\"bellTrouble\");\n  if (\"monitoringTrouble\" in device) set.add(\"monitoringTrouble\");\n  if (\"powerLevel\" in device) set.add(\"powerTrouble\");\n\n  if (\"equipment\" in device) set.add(\"hardwareFailure\");\n\n  switch (device.type) {\n    case \"thermostat\":\n      for (const n of THERMOSTAT_INFERRED) set.add(n);\n      break;\n    default:\n      break;\n  }\n\n  return Array.from(set);\n}\n"],"mappings":";AA8BA,MAAM,sBAAgD;CACpD;CACA;CACA;CACA;CACA;CACA;AACF;;;;;;AAOA,SAAgB,yBACd,QAC0B;CAC1B,IAAI,CAAC,UAAU,CAAC,OAAO,MAAM,OAAO,CAAC;CACrC,MAAM,sBAAM,IAAI,IAA4B;CAE5C,IAAI,aAAa,QAAQ,IAAI,IAAI,sBAAsB;CAEvD,IAAI,kBAAkB,UAAU,OAAO,gBAAgB,MACrD,IAAI,IAAI,gBAAgB;CAG1B,IAAI,iBAAiB,QAAQ,IAAI,IAAI,aAAa;CAClD,IAAI,uBAAuB,QAAQ,IAAI,IAAI,mBAAmB;CAC9D,IAAI,gBAAgB,QAAQ,IAAI,IAAI,cAAc;CAElD,IAAI,eAAe,QAAQ,IAAI,IAAI,iBAAiB;CAEpD,QAAQ,OAAO,MAAf;EACE,KAAK,cACH,KAAK,MAAM,KAAK,qBAAqB,IAAI,IAAI,CAAC;CAIlD;CAEA,OAAO,MAAM,KAAK,GAAG;AACvB"}

package/dist/lib/index.d.ts

@@ -2,3 +2,7 @@ export { inferDeviceNotifications, type DeviceNotificationName, type InferDevice
 export { categoryForDevice, SYSTEM_CATEGORIES, SYSTEM_CATEGORY_LABELS, type SystemCategory, type CategoryForDeviceInput, } from "./systemCategories.js";
 export { getAllowedResourceIds, getAllowedDeviceTypes, getAllowedFeatures, type PolicyLike, type PolicyPermissionLike, } from "./policy-resolvers.js";
 export { MAX_MESSAGE_ATTACHMENTS } from "./messageAttachments.js";
+export { DEFAULT_MARKUP_TIERS, resolveMarkupTierTable, keyedMarkupPercent, DEFAULT_TAX_RATE, derivePrice, billTotal, billTaxAmount, billGrandTotal, formatMoney, } from "./money.js";
+export { effectiveTaxRate, taxableSubtotal, billTotals, resolveBillTaxExempt, settledBillTotal, billEffectiveDate, type BillTaxFields, type TaxableLine, type SettledBillTotalSource, type BillEffectiveDateSource, } from "./bills.js";
+export { KFC_STATS_TIMEZONE, KFC_STATS_DEFAULT_WINDOW_DAYS, KFC_STATS_MAX_RANGE_DAYS, resolveKfcStatsWindowBounds, type KfcStatsWindowBounds, } from "./kfcStatsWindow.js";
+export { serializeRichTextBody, isWellFormedRichText, type RichTextContent, type RichTextBlockNode, type RichTextInlineNode, type RichTextListItemNode, type RichTextMentionNode, } from "./ticketRichText.js";

package/dist/lib/index.js

@@ -3,18 +3,43 @@ import { inferDeviceNotifications } from "./deviceNotifications.js";
 import { SYSTEM_CATEGORIES, SYSTEM_CATEGORY_LABELS, categoryForDevice } from "./systemCategories.js";
 import { getAllowedDeviceTypes, getAllowedFeatures, getAllowedResourceIds } from "./policy-resolvers.js";
 import { MAX_MESSAGE_ATTACHMENTS } from "./messageAttachments.js";
+import { DEFAULT_MARKUP_TIERS, DEFAULT_TAX_RATE, billGrandTotal, billTaxAmount, billTotal, derivePrice, formatMoney, keyedMarkupPercent, resolveMarkupTierTable } from "./money.js";
+import { billEffectiveDate, billTotals, effectiveTaxRate, resolveBillTaxExempt, settledBillTotal, taxableSubtotal } from "./bills.js";
+import { KFC_STATS_DEFAULT_WINDOW_DAYS, KFC_STATS_MAX_RANGE_DAYS, KFC_STATS_TIMEZONE, resolveKfcStatsWindowBounds } from "./kfcStatsWindow.js";
+import { isWellFormedRichText, serializeRichTextBody } from "./ticketRichText.js";
 //#region .generated/lib/index.ts
 var lib_exports = /* @__PURE__ */ __exportAll({
+	DEFAULT_MARKUP_TIERS: () => DEFAULT_MARKUP_TIERS,
+	DEFAULT_TAX_RATE: () => DEFAULT_TAX_RATE,
+	KFC_STATS_DEFAULT_WINDOW_DAYS: () => 30,
+	KFC_STATS_MAX_RANGE_DAYS: () => 366,
+	KFC_STATS_TIMEZONE: () => KFC_STATS_TIMEZONE,
 	MAX_MESSAGE_ATTACHMENTS: () => 15,
 	SYSTEM_CATEGORIES: () => SYSTEM_CATEGORIES,
 	SYSTEM_CATEGORY_LABELS: () => SYSTEM_CATEGORY_LABELS,
+	billEffectiveDate: () => billEffectiveDate,
+	billGrandTotal: () => billGrandTotal,
+	billTaxAmount: () => billTaxAmount,
+	billTotal: () => billTotal,
+	billTotals: () => billTotals,
 	categoryForDevice: () => categoryForDevice,
+	derivePrice: () => derivePrice,
+	effectiveTaxRate: () => effectiveTaxRate,
+	formatMoney: () => formatMoney,
 	getAllowedDeviceTypes: () => getAllowedDeviceTypes,
 	getAllowedFeatures: () => getAllowedFeatures,
 	getAllowedResourceIds: () => getAllowedResourceIds,
-	inferDeviceNotifications: () => inferDeviceNotifications
+	inferDeviceNotifications: () => inferDeviceNotifications,
+	isWellFormedRichText: () => isWellFormedRichText,
+	keyedMarkupPercent: () => keyedMarkupPercent,
+	resolveBillTaxExempt: () => resolveBillTaxExempt,
+	resolveKfcStatsWindowBounds: () => resolveKfcStatsWindowBounds,
+	resolveMarkupTierTable: () => resolveMarkupTierTable,
+	serializeRichTextBody: () => serializeRichTextBody,
+	settledBillTotal: () => settledBillTotal,
+	taxableSubtotal: () => taxableSubtotal
 });
 //#endregion
-export { MAX_MESSAGE_ATTACHMENTS, SYSTEM_CATEGORIES, SYSTEM_CATEGORY_LABELS, categoryForDevice, getAllowedDeviceTypes, getAllowedFeatures, getAllowedResourceIds, inferDeviceNotifications, lib_exports };
+export { DEFAULT_MARKUP_TIERS, DEFAULT_TAX_RATE, KFC_STATS_DEFAULT_WINDOW_DAYS, KFC_STATS_MAX_RANGE_DAYS, KFC_STATS_TIMEZONE, MAX_MESSAGE_ATTACHMENTS, SYSTEM_CATEGORIES, SYSTEM_CATEGORY_LABELS, billEffectiveDate, billGrandTotal, billTaxAmount, billTotal, billTotals, categoryForDevice, derivePrice, effectiveTaxRate, formatMoney, getAllowedDeviceTypes, getAllowedFeatures, getAllowedResourceIds, inferDeviceNotifications, isWellFormedRichText, keyedMarkupPercent, lib_exports, resolveBillTaxExempt, resolveKfcStatsWindowBounds, resolveMarkupTierTable, serializeRichTextBody, settledBillTotal, taxableSubtotal };
 
 //# sourceMappingURL=index.js.map

package/dist/lib/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../.generated/lib/index.ts"],"sourcesContent":["export {\n  inferDeviceNotifications,\n  type DeviceNotificationName,\n  type InferDeviceNotificationsInput,\n} from \"./deviceNotifications.js\";\nexport {\n  categoryForDevice,\n  SYSTEM_CATEGORIES,\n  SYSTEM_CATEGORY_LABELS,\n  type SystemCategory,\n  type CategoryForDeviceInput,\n} from \"./systemCategories.js\";\nexport {\n  getAllowedResourceIds,\n  getAllowedDeviceTypes,\n  getAllowedFeatures,\n  type PolicyLike,\n  type PolicyPermissionLike,\n} from \"./policy-resolvers.js\";\nexport { MAX_MESSAGE_ATTACHMENTS } from \"./messageAttachments.js\";\n"],"mappings":""}
+{"version":3,"file":"index.js","names":[],"sources":["../../.generated/lib/index.ts"],"sourcesContent":["export {\n  inferDeviceNotifications,\n  type DeviceNotificationName,\n  type InferDeviceNotificationsInput,\n} from \"./deviceNotifications.js\";\nexport {\n  categoryForDevice,\n  SYSTEM_CATEGORIES,\n  SYSTEM_CATEGORY_LABELS,\n  type SystemCategory,\n  type CategoryForDeviceInput,\n} from \"./systemCategories.js\";\nexport {\n  getAllowedResourceIds,\n  getAllowedDeviceTypes,\n  getAllowedFeatures,\n  type PolicyLike,\n  type PolicyPermissionLike,\n} from \"./policy-resolvers.js\";\nexport { MAX_MESSAGE_ATTACHMENTS } from \"./messageAttachments.js\";\nexport {\n  DEFAULT_MARKUP_TIERS,\n  resolveMarkupTierTable,\n  keyedMarkupPercent,\n  DEFAULT_TAX_RATE,\n  derivePrice,\n  billTotal,\n  billTaxAmount,\n  billGrandTotal,\n  formatMoney,\n} from \"./money.js\";\nexport {\n  effectiveTaxRate,\n  taxableSubtotal,\n  billTotals,\n  resolveBillTaxExempt,\n  settledBillTotal,\n  billEffectiveDate,\n  type BillTaxFields,\n  type TaxableLine,\n  type SettledBillTotalSource,\n  type BillEffectiveDateSource,\n} from \"./bills.js\";\nexport {\n  KFC_STATS_TIMEZONE,\n  KFC_STATS_DEFAULT_WINDOW_DAYS,\n  KFC_STATS_MAX_RANGE_DAYS,\n  resolveKfcStatsWindowBounds,\n  type KfcStatsWindowBounds,\n} from \"./kfcStatsWindow.js\";\nexport {\n  serializeRichTextBody,\n  isWellFormedRichText,\n  type RichTextContent,\n  type RichTextBlockNode,\n  type RichTextInlineNode,\n  type RichTextListItemNode,\n  type RichTextMentionNode,\n} from \"./ticketRichText.js\";\n"],"mappings":""}

package/dist/lib/kfcStatsWindow.d.ts

@@ -0,0 +1,37 @@
+/**
+ * The KFC stats date-window contract, shared verbatim by the API endpoint and
+ * the admin console so a `from`/`to` pair means the same window on both sides.
+ * The server owns the authoritative resolution — it layers range validation and
+ * instant conversion on top — while the client owns the preset and comparison
+ * math the server has no notion of. Both must agree on the *constants and the
+ * fallback*, though: the default view carries no dates in the URL, so the client
+ * has to reconstruct the exact window the server would have chosen. Publishing
+ * them once here is what keeps the two from silently disagreeing when the window
+ * default or the anchor zone changes.
+ */
+/** Calendar-day windows are anchored to this fixed zone (#360). */
+export declare const KFC_STATS_TIMEZONE = "America/Los_Angeles";
+/** Inclusive span of the default window when no `from` is given. */
+export declare const KFC_STATS_DEFAULT_WINDOW_DAYS = 30;
+/**
+ * Widest inclusive span a caller may request — a full leap year. Cross-org
+ * federated aggregation cost scales with the window, so this caps the work an
+ * arbitrary caller can ask for.
+ */
+export declare const KFC_STATS_MAX_RANGE_DAYS = 366;
+/** A resolved inclusive day window as `YYYY-MM-DD` civil-date labels. */
+export interface KfcStatsWindowBounds {
+    from: string;
+    to: string;
+}
+/**
+ * The fallback both sides apply to a partial window: a missing `to` is `today`
+ * (already resolved to the anchor zone by the caller), and a missing `from` is
+ * the day `KFC_STATS_DEFAULT_WINDOW_DAYS - 1` before `to`, so the default view
+ * spans that many days inclusive of today. Explicit bounds pass through
+ * untouched; parsing, ordering, and span limits are the caller's to enforce.
+ */
+export declare function resolveKfcStatsWindowBounds(window: {
+    from?: string | null;
+    to?: string | null;
+}, today: string): KfcStatsWindowBounds;

package/dist/lib/kfcStatsWindow.js

@@ -0,0 +1,46 @@
+//#region .generated/lib/kfcStatsWindow.ts
+/**
+* The KFC stats date-window contract, shared verbatim by the API endpoint and
+* the admin console so a `from`/`to` pair means the same window on both sides.
+* The server owns the authoritative resolution — it layers range validation and
+* instant conversion on top — while the client owns the preset and comparison
+* math the server has no notion of. Both must agree on the *constants and the
+* fallback*, though: the default view carries no dates in the URL, so the client
+* has to reconstruct the exact window the server would have chosen. Publishing
+* them once here is what keeps the two from silently disagreeing when the window
+* default or the anchor zone changes.
+*/
+/** Calendar-day windows are anchored to this fixed zone (#360). */
+const KFC_STATS_TIMEZONE = "America/Los_Angeles";
+/** Inclusive span of the default window when no `from` is given. */
+const KFC_STATS_DEFAULT_WINDOW_DAYS = 30;
+/**
+* Widest inclusive span a caller may request — a full leap year. Cross-org
+* federated aggregation cost scales with the window, so this caps the work an
+* arbitrary caller can ask for.
+*/
+const KFC_STATS_MAX_RANGE_DAYS = 366;
+const DAY_MS = 864e5;
+function shiftDateLabel(label, days) {
+	const [year, month, day] = label.split("-").map(Number);
+	const shifted = new Date(Date.UTC(year, month - 1, day) + days * DAY_MS);
+	return `${String(shifted.getUTCFullYear()).padStart(4, "0")}-${String(shifted.getUTCMonth() + 1).padStart(2, "0")}-${String(shifted.getUTCDate()).padStart(2, "0")}`;
+}
+/**
+* The fallback both sides apply to a partial window: a missing `to` is `today`
+* (already resolved to the anchor zone by the caller), and a missing `from` is
+* the day `KFC_STATS_DEFAULT_WINDOW_DAYS - 1` before `to`, so the default view
+* spans that many days inclusive of today. Explicit bounds pass through
+* untouched; parsing, ordering, and span limits are the caller's to enforce.
+*/
+function resolveKfcStatsWindowBounds(window, today) {
+	const to = window.to ?? today;
+	return {
+		from: window.from ?? shiftDateLabel(to, -29),
+		to
+	};
+}
+//#endregion
+export { KFC_STATS_DEFAULT_WINDOW_DAYS, KFC_STATS_MAX_RANGE_DAYS, KFC_STATS_TIMEZONE, resolveKfcStatsWindowBounds };
+
+//# sourceMappingURL=kfcStatsWindow.js.map

package/dist/lib/kfcStatsWindow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"kfcStatsWindow.js","names":[],"sources":["../../.generated/lib/kfcStatsWindow.ts"],"sourcesContent":["/**\n * The KFC stats date-window contract, shared verbatim by the API endpoint and\n * the admin console so a `from`/`to` pair means the same window on both sides.\n * The server owns the authoritative resolution — it layers range validation and\n * instant conversion on top — while the client owns the preset and comparison\n * math the server has no notion of. Both must agree on the *constants and the\n * fallback*, though: the default view carries no dates in the URL, so the client\n * has to reconstruct the exact window the server would have chosen. Publishing\n * them once here is what keeps the two from silently disagreeing when the window\n * default or the anchor zone changes.\n */\n\n/** Calendar-day windows are anchored to this fixed zone (#360). */\nexport const KFC_STATS_TIMEZONE = \"America/Los_Angeles\";\n\n/** Inclusive span of the default window when no `from` is given. */\nexport const KFC_STATS_DEFAULT_WINDOW_DAYS = 30;\n\n/**\n * Widest inclusive span a caller may request — a full leap year. Cross-org\n * federated aggregation cost scales with the window, so this caps the work an\n * arbitrary caller can ask for.\n */\nexport const KFC_STATS_MAX_RANGE_DAYS = 366;\n\n/** A resolved inclusive day window as `YYYY-MM-DD` civil-date labels. */\nexport interface KfcStatsWindowBounds {\n  from: string;\n  to: string;\n}\n\nconst DAY_MS = 86_400_000;\n\n// Civil-date arithmetic on UTC-anchored instants so a day shift never drifts\n// across a DST boundary; only the calendar fields are ever read back out.\nfunction shiftDateLabel(label: string, days: number): string {\n  const [year, month, day] = label.split(\"-\").map(Number);\n  const shifted = new Date(Date.UTC(year, month - 1, day) + days * DAY_MS);\n  const y = String(shifted.getUTCFullYear()).padStart(4, \"0\");\n  const m = String(shifted.getUTCMonth() + 1).padStart(2, \"0\");\n  const d = String(shifted.getUTCDate()).padStart(2, \"0\");\n  return `${y}-${m}-${d}`;\n}\n\n/**\n * The fallback both sides apply to a partial window: a missing `to` is `today`\n * (already resolved to the anchor zone by the caller), and a missing `from` is\n * the day `KFC_STATS_DEFAULT_WINDOW_DAYS - 1` before `to`, so the default view\n * spans that many days inclusive of today. Explicit bounds pass through\n * untouched; parsing, ordering, and span limits are the caller's to enforce.\n */\nexport function resolveKfcStatsWindowBounds(\n  window: { from?: string | null; to?: string | null },\n  today: string,\n): KfcStatsWindowBounds {\n  const to = window.to ?? today;\n  const from =\n    window.from ?? shiftDateLabel(to, -(KFC_STATS_DEFAULT_WINDOW_DAYS - 1));\n  return { from, to };\n}\n"],"mappings":";;;;;;;;;;;;;AAaA,MAAa,qBAAqB;;AAGlC,MAAa,gCAAgC;;;;;;AAO7C,MAAa,2BAA2B;AAQxC,MAAM,SAAS;AAIf,SAAS,eAAe,OAAe,MAAsB;CAC3D,MAAM,CAAC,MAAM,OAAO,OAAO,MAAM,MAAM,GAAG,CAAC,CAAC,IAAI,MAAM;CACtD,MAAM,UAAU,IAAI,KAAK,KAAK,IAAI,MAAM,QAAQ,GAAG,GAAG,IAAI,OAAO,MAAM;CAIvE,OAAO,GAHG,OAAO,QAAQ,eAAe,CAAC,CAAC,CAAC,SAAS,GAAG,GAG7C,EAAE,GAFF,OAAO,QAAQ,YAAY,IAAI,CAAC,CAAC,CAAC,SAAS,GAAG,GAEzC,EAAE,GADP,OAAO,QAAQ,WAAW,CAAC,CAAC,CAAC,SAAS,GAAG,GAC/B;AACtB;;;;;;;;AASA,SAAgB,4BACd,QACA,OACsB;CACtB,MAAM,KAAK,OAAO,MAAM;CAGxB,OAAO;EAAE,MADP,OAAO,QAAQ,eAAe,IAAI,GAAoC;EACzD;CAAG;AACpB"}

package/dist/lib/lowerBoundTable.d.ts

@@ -0,0 +1,11 @@
+import type { Ajv } from "ajv";
+export interface LowerBoundTableParams {
+    key: string;
+}
+/**
+ * Registers the `lowerBoundTable` keyword: on an array of objects,
+ * `lowerBoundTable: { key: "minAmount" }` enforces that the first row's key is
+ * 0 and keys strictly ascend, so a table of lower-bound rows can have no gaps
+ * or overlaps by construction. An empty array is valid (no table configured).
+ */
+export declare function addLowerBoundTableKeyword(ajv: Ajv): Ajv;

package/dist/lib/lowerBoundTable.js

@@ -0,0 +1,28 @@
+//#region .generated/lib/lowerBoundTable.ts
+/**
+* Registers the `lowerBoundTable` keyword: on an array of objects,
+* `lowerBoundTable: { key: "minAmount" }` enforces that the first row's key is
+* 0 and keys strictly ascend, so a table of lower-bound rows can have no gaps
+* or overlaps by construction. An empty array is valid (no table configured).
+*/
+function addLowerBoundTableKeyword(ajv) {
+	return ajv.addKeyword({
+		keyword: "lowerBoundTable",
+		type: "array",
+		schemaType: "object",
+		validate(params, rows) {
+			let previous;
+			for (const row of rows) {
+				const value = typeof row === "object" && row !== null ? row[params.key] : void 0;
+				if (typeof value !== "number") return false;
+				if (previous === void 0 ? value !== 0 : value <= previous) return false;
+				previous = value;
+			}
+			return true;
+		}
+	});
+}
+//#endregion
+export { addLowerBoundTableKeyword };
+
+//# sourceMappingURL=lowerBoundTable.js.map

package/dist/lib/lowerBoundTable.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lowerBoundTable.js","names":[],"sources":["../../.generated/lib/lowerBoundTable.ts"],"sourcesContent":["import type { Ajv } from \"ajv\";\n\nexport interface LowerBoundTableParams {\n  key: string;\n}\n\n/**\n * Registers the `lowerBoundTable` keyword: on an array of objects,\n * `lowerBoundTable: { key: \"minAmount\" }` enforces that the first row's key is\n * 0 and keys strictly ascend, so a table of lower-bound rows can have no gaps\n * or overlaps by construction. An empty array is valid (no table configured).\n */\nexport function addLowerBoundTableKeyword(ajv: Ajv): Ajv {\n  return ajv.addKeyword({\n    keyword: \"lowerBoundTable\",\n    type: \"array\",\n    schemaType: \"object\",\n    validate(params: LowerBoundTableParams, rows: unknown[]) {\n      let previous: number | undefined;\n      for (const row of rows) {\n        const value =\n          typeof row === \"object\" && row !== null\n            ? (row as Record<string, unknown>)[params.key]\n            : undefined;\n        if (typeof value !== \"number\") return false;\n        if (previous === undefined ? value !== 0 : value <= previous) {\n          return false;\n        }\n        previous = value;\n      }\n      return true;\n    },\n  });\n}\n"],"mappings":";;;;;;;AAYA,SAAgB,0BAA0B,KAAe;CACvD,OAAO,IAAI,WAAW;EACpB,SAAS;EACT,MAAM;EACN,YAAY;EACZ,SAAS,QAA+B,MAAiB;GACvD,IAAI;GACJ,KAAK,MAAM,OAAO,MAAM;IACtB,MAAM,QACJ,OAAO,QAAQ,YAAY,QAAQ,OAC9B,IAAgC,OAAO,OACxC,KAAA;IACN,IAAI,OAAO,UAAU,UAAU,OAAO;IACtC,IAAI,aAAa,KAAA,IAAY,UAAU,IAAI,SAAS,UAClD,OAAO;IAET,WAAW;GACb;GACA,OAAO;EACT;CACF,CAAC;AACH"}

package/dist/lib/money.d.ts

@@ -0,0 +1,61 @@
+/**
+ * The money rules the API and the app must apply identically, so a price shown
+ * in the browser can never disagree with the price the server persists or the
+ * approval gate compares to the DNE. Before this module each rule was written
+ * once per side, and the duplication had already shipped a divergence between
+ * persisted copy and the live UI.
+ */
+import type { MarkupTier } from "../schemas/organization.js";
+/**
+ * The tier table an organization keys against before anyone configures one.
+ * KFC work is never billed at vendor cost, so an unconfigured organization
+ * keys to a single flat tier rather than to zero. A saved table replaces this
+ * outright — it is a fallback, not a floor, so an organization that should
+ * carry no markup writes an explicit `0` tier.
+ */
+export declare const DEFAULT_MARKUP_TIERS: readonly MarkupTier[];
+/** An organization's markup tiers, or the default when it has none of its own. */
+export declare function resolveMarkupTierTable(tiers: readonly MarkupTier[] | undefined | null): MarkupTier[];
+/**
+ * Keys a cost entry's markup percent from the org's lower-bound tier table by
+ * the entry's vendor-cost estimate (never the ticket total): the highest row
+ * whose `minAmount` the estimate meets. Null when no tiers are configured.
+ */
+export declare function keyedMarkupPercent(tiers: readonly MarkupTier[], estimateAmount: number): number | null;
+/**
+ * The marked-up price of a vendor cost, in integer cents. Price is never stored
+ * anywhere — it is always derived from vendor cost and markup on integer cents,
+ * so the two sides can never let the vendor cost, markup, and price disagree.
+ */
+export declare function derivePrice(amount: number, percent: number): number;
+/** The sum of already-derived line amounts, in integer cents. */
+export declare function billTotal(lineAmounts: readonly number[]): number;
+/**
+ * The tax rate (a plain float percent) a draft bill uses until a biller writes
+ * its own onto the bill.
+ */
+export declare const DEFAULT_TAX_RATE = 8.375;
+/**
+ * Tax in integer cents on a bill's taxable subtotal. Taxable credits reduce the
+ * base; when they push it negative the tax clamps at zero rather than going
+ * negative — a bill never emits a tax refund.
+ */
+export declare function billTaxAmount(taxableSubtotalCents: number, ratePercent: number): number;
+/** The bill's grand total in integer cents: line sum plus tax and shipping. */
+export declare function billGrandTotal({ subtotal, tax, shipping, }: {
+    subtotal: number;
+    tax: number;
+    shipping: number;
+}): number;
+/**
+ * Render integer cents as a currency string, e.g.
+ * `formatMoney(123456, "USD")` → `"$1,234.56"`.
+ *
+ * Locale policy: `locale` defaults to `"en-US"` — the pin for any copy that is
+ * persisted or shipped to a fixed audience (bill PDFs, emails, and the stored
+ * approval/notification messages a customer reads back later). Live UI that
+ * should follow the viewer passes `locale = null`, which falls back to the
+ * runtime's default locale. Persisted-en-US / live-locale-aware is the
+ * deliberate split; a persisted caller must never inherit the browser locale.
+ */
+export declare function formatMoney(cents: number, currency?: string, locale?: string | null): string;

package/dist/lib/money.js

@@ -0,0 +1,80 @@
+//#region .generated/lib/money.ts
+/**
+* The tier table an organization keys against before anyone configures one.
+* KFC work is never billed at vendor cost, so an unconfigured organization
+* keys to a single flat tier rather than to zero. A saved table replaces this
+* outright — it is a fallback, not a floor, so an organization that should
+* carry no markup writes an explicit `0` tier.
+*/
+const DEFAULT_MARKUP_TIERS = [{
+	minAmount: 0,
+	percent: 10
+}];
+/** An organization's markup tiers, or the default when it has none of its own. */
+function resolveMarkupTierTable(tiers) {
+	if (tiers && tiers.length > 0) return [...tiers];
+	return DEFAULT_MARKUP_TIERS.map((tier) => ({ ...tier }));
+}
+/**
+* Keys a cost entry's markup percent from the org's lower-bound tier table by
+* the entry's vendor-cost estimate (never the ticket total): the highest row
+* whose `minAmount` the estimate meets. Null when no tiers are configured.
+*/
+function keyedMarkupPercent(tiers, estimateAmount) {
+	let match = null;
+	for (const tier of tiers) {
+		if (tier.minAmount > estimateAmount) continue;
+		if (match === null || tier.minAmount > match.minAmount) match = tier;
+	}
+	return match === null ? null : match.percent;
+}
+/**
+* The marked-up price of a vendor cost, in integer cents. Price is never stored
+* anywhere — it is always derived from vendor cost and markup on integer cents,
+* so the two sides can never let the vendor cost, markup, and price disagree.
+*/
+function derivePrice(amount, percent) {
+	return Math.round(amount * (1 + percent / 100));
+}
+/** The sum of already-derived line amounts, in integer cents. */
+function billTotal(lineAmounts) {
+	return lineAmounts.reduce((sum, amount) => sum + amount, 0);
+}
+/**
+* The tax rate (a plain float percent) a draft bill uses until a biller writes
+* its own onto the bill.
+*/
+const DEFAULT_TAX_RATE = 8.375;
+/**
+* Tax in integer cents on a bill's taxable subtotal. Taxable credits reduce the
+* base; when they push it negative the tax clamps at zero rather than going
+* negative — a bill never emits a tax refund.
+*/
+function billTaxAmount(taxableSubtotalCents, ratePercent) {
+	return Math.max(0, Math.round(taxableSubtotalCents * ratePercent / 100));
+}
+/** The bill's grand total in integer cents: line sum plus tax and shipping. */
+function billGrandTotal({ subtotal, tax, shipping }) {
+	return subtotal + tax + shipping;
+}
+/**
+* Render integer cents as a currency string, e.g.
+* `formatMoney(123456, "USD")` → `"$1,234.56"`.
+*
+* Locale policy: `locale` defaults to `"en-US"` — the pin for any copy that is
+* persisted or shipped to a fixed audience (bill PDFs, emails, and the stored
+* approval/notification messages a customer reads back later). Live UI that
+* should follow the viewer passes `locale = null`, which falls back to the
+* runtime's default locale. Persisted-en-US / live-locale-aware is the
+* deliberate split; a persisted caller must never inherit the browser locale.
+*/
+function formatMoney(cents, currency = "USD", locale = "en-US") {
+	return new Intl.NumberFormat(locale ?? void 0, {
+		style: "currency",
+		currency
+	}).format(cents / 100);
+}
+//#endregion
+export { DEFAULT_MARKUP_TIERS, DEFAULT_TAX_RATE, billGrandTotal, billTaxAmount, billTotal, derivePrice, formatMoney, keyedMarkupPercent, resolveMarkupTierTable };
+
+//# sourceMappingURL=money.js.map

package/dist/lib/money.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"money.js","names":[],"sources":["../../.generated/lib/money.ts"],"sourcesContent":["/**\n * The money rules the API and the app must apply identically, so a price shown\n * in the browser can never disagree with the price the server persists or the\n * approval gate compares to the DNE. Before this module each rule was written\n * once per side, and the duplication had already shipped a divergence between\n * persisted copy and the live UI.\n */\n\nimport type { MarkupTier } from \"../schemas/organization.js\";\n\n/**\n * The tier table an organization keys against before anyone configures one.\n * KFC work is never billed at vendor cost, so an unconfigured organization\n * keys to a single flat tier rather than to zero. A saved table replaces this\n * outright — it is a fallback, not a floor, so an organization that should\n * carry no markup writes an explicit `0` tier.\n */\nexport const DEFAULT_MARKUP_TIERS: readonly MarkupTier[] = [\n  { minAmount: 0, percent: 10 },\n];\n\n/** An organization's markup tiers, or the default when it has none of its own. */\nexport function resolveMarkupTierTable(\n  tiers: readonly MarkupTier[] | undefined | null,\n): MarkupTier[] {\n  if (tiers && tiers.length > 0) return [...tiers];\n  return DEFAULT_MARKUP_TIERS.map((tier) => ({ ...tier }));\n}\n\n/**\n * Keys a cost entry's markup percent from the org's lower-bound tier table by\n * the entry's vendor-cost estimate (never the ticket total): the highest row\n * whose `minAmount` the estimate meets. Null when no tiers are configured.\n */\nexport function keyedMarkupPercent(\n  tiers: readonly MarkupTier[],\n  estimateAmount: number,\n): number | null {\n  let match: MarkupTier | null = null;\n  for (const tier of tiers) {\n    if (tier.minAmount > estimateAmount) continue;\n    if (match === null || tier.minAmount > match.minAmount) match = tier;\n  }\n  return match === null ? null : match.percent;\n}\n\n/**\n * The marked-up price of a vendor cost, in integer cents. Price is never stored\n * anywhere — it is always derived from vendor cost and markup on integer cents,\n * so the two sides can never let the vendor cost, markup, and price disagree.\n */\nexport function derivePrice(amount: number, percent: number): number {\n  return Math.round(amount * (1 + percent / 100));\n}\n\n/** The sum of already-derived line amounts, in integer cents. */\nexport function billTotal(lineAmounts: readonly number[]): number {\n  return lineAmounts.reduce((sum, amount) => sum + amount, 0);\n}\n\n/**\n * The tax rate (a plain float percent) a draft bill uses until a biller writes\n * its own onto the bill.\n */\nexport const DEFAULT_TAX_RATE = 8.375;\n\n/**\n * Tax in integer cents on a bill's taxable subtotal. Taxable credits reduce the\n * base; when they push it negative the tax clamps at zero rather than going\n * negative — a bill never emits a tax refund.\n */\nexport function billTaxAmount(\n  taxableSubtotalCents: number,\n  ratePercent: number,\n): number {\n  return Math.max(0, Math.round((taxableSubtotalCents * ratePercent) / 100));\n}\n\n/** The bill's grand total in integer cents: line sum plus tax and shipping. */\nexport function billGrandTotal({\n  subtotal,\n  tax,\n  shipping,\n}: {\n  subtotal: number;\n  tax: number;\n  shipping: number;\n}): number {\n  return subtotal + tax + shipping;\n}\n\n/**\n * Render integer cents as a currency string, e.g.\n * `formatMoney(123456, \"USD\")` → `\"$1,234.56\"`.\n *\n * Locale policy: `locale` defaults to `\"en-US\"` — the pin for any copy that is\n * persisted or shipped to a fixed audience (bill PDFs, emails, and the stored\n * approval/notification messages a customer reads back later). Live UI that\n * should follow the viewer passes `locale = null`, which falls back to the\n * runtime's default locale. Persisted-en-US / live-locale-aware is the\n * deliberate split; a persisted caller must never inherit the browser locale.\n */\nexport function formatMoney(\n  cents: number,\n  currency = \"USD\",\n  locale: string | null = \"en-US\",\n): string {\n  return new Intl.NumberFormat(locale ?? undefined, {\n    style: \"currency\",\n    currency,\n  }).format(cents / 100);\n}\n"],"mappings":";;;;;;;;AAiBA,MAAa,uBAA8C,CACzD;CAAE,WAAW;CAAG,SAAS;AAAG,CAC9B;;AAGA,SAAgB,uBACd,OACc;CACd,IAAI,SAAS,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,KAAK;CAC/C,OAAO,qBAAqB,KAAK,UAAU,EAAE,GAAG,KAAK,EAAE;AACzD;;;;;;AAOA,SAAgB,mBACd,OACA,gBACe;CACf,IAAI,QAA2B;CAC/B,KAAK,MAAM,QAAQ,OAAO;EACxB,IAAI,KAAK,YAAY,gBAAgB;EACrC,IAAI,UAAU,QAAQ,KAAK,YAAY,MAAM,WAAW,QAAQ;CAClE;CACA,OAAO,UAAU,OAAO,OAAO,MAAM;AACvC;;;;;;AAOA,SAAgB,YAAY,QAAgB,SAAyB;CACnE,OAAO,KAAK,MAAM,UAAU,IAAI,UAAU,IAAI;AAChD;;AAGA,SAAgB,UAAU,aAAwC;CAChE,OAAO,YAAY,QAAQ,KAAK,WAAW,MAAM,QAAQ,CAAC;AAC5D;;;;;AAMA,MAAa,mBAAmB;;;;;;AAOhC,SAAgB,cACd,sBACA,aACQ;CACR,OAAO,KAAK,IAAI,GAAG,KAAK,MAAO,uBAAuB,cAAe,GAAG,CAAC;AAC3E;;AAGA,SAAgB,eAAe,EAC7B,UACA,KACA,YAKS;CACT,OAAO,WAAW,MAAM;AAC1B;;;;;;;;;;;;AAaA,SAAgB,YACd,OACA,WAAW,OACX,SAAwB,SAChB;CACR,OAAO,IAAI,KAAK,aAAa,UAAU,KAAA,GAAW;EAChD,OAAO;EACP;CACF,CAAC,CAAC,CAAC,OAAO,QAAQ,GAAG;AACvB"}

package/dist/lib/policy-resolvers.js

@@ -21,10 +21,11 @@ function getAllowedDeviceTypes(policies, spaceId) {
 	for (const policy of policies) for (const permission of policy.permissions) for (const entity of permission.entities) {
 		if (!matchesSpace(entity)) continue;
 		const [, , deviceType] = entity.split(":");
-		if (permission.effect === "Allow") if (!deviceType) {
-			if (!allowed.includes("*")) allowed.push("*");
-		} else allowed.push(deviceType);
-		else denied.push(deviceType);
+		if (permission.effect === "Allow") {
+			if (!deviceType) {
+				if (!allowed.includes("*")) allowed.push("*");
+			} else allowed.push(deviceType);
+		} else denied.push(deviceType);
 	}
 	return allowed.filter((id) => !denied.includes(id));
 }

package/dist/lib/policy-resolvers.js.map

@@ -1 +1 @@
-{"version":3,"file":"policy-resolvers.js","names":[],"sources":["../../.generated/lib/policy-resolvers.ts"],"sourcesContent":["export interface PolicyPermissionLike {\n  entities: string[];\n  effect: \"Allow\" | \"Deny\";\n}\n\nexport interface PolicyLike {\n  permissions: PolicyPermissionLike[];\n}\n\nconst FEATURE_PREFIX = \"feature:\";\n\nexport function getAllowedResourceIds(\n  policies: PolicyLike[],\n  resource: string,\n): string[] {\n  const allowed: string[] = [];\n  const denied: string[] = [];\n\n  for (const policy of policies) {\n    for (const permission of policy.permissions) {\n      for (const entity of permission.entities) {\n        if (!entity.startsWith(resource)) continue;\n\n        const [, id, subsystem, deviceId] = entity.split(\":\");\n        const hasFinerSegment = Boolean(subsystem) || Boolean(deviceId);\n\n        if (permission.effect === \"Allow\") {\n          allowed.push(id);\n        } else if (!hasFinerSegment) {\n          denied.push(id);\n        }\n      }\n    }\n  }\n\n  return denied.length > 0\n    ? allowed.filter((id) => !denied.includes(id))\n    : allowed;\n}\n\nexport function getAllowedDeviceTypes(\n  policies: PolicyLike[],\n  spaceId: string,\n): string[] {\n  const prefix = `space:${spaceId}:`;\n  const exactMatch = `space:${spaceId}`;\n  const matchesSpace = (res: string) =>\n    res === exactMatch || res.startsWith(prefix) || res.startsWith(\"space:*\");\n\n  const allowed: string[] = [];\n  const denied: string[] = [];\n\n  for (const policy of policies) {\n    for (const permission of policy.permissions) {\n      for (const entity of permission.entities) {\n        if (!matchesSpace(entity)) continue;\n\n        const [, , deviceType] = entity.split(\":\");\n        if (permission.effect === \"Allow\") {\n          if (!deviceType) {\n            if (!allowed.includes(\"*\")) allowed.push(\"*\");\n          } else {\n            allowed.push(deviceType);\n          }\n        } else {\n          denied.push(deviceType);\n        }\n      }\n    }\n  }\n\n  return allowed.filter((id) => !denied.includes(id));\n}\n\nexport function getAllowedFeatures(policies: PolicyLike[]): string[] {\n  const allowed: string[] = [];\n  const denied: string[] = [];\n\n  for (const policy of policies) {\n    for (const permission of policy.permissions) {\n      for (const entity of permission.entities) {\n        if (!entity.startsWith(FEATURE_PREFIX)) continue;\n\n        const key = entity.slice(FEATURE_PREFIX.length);\n        if (!key) continue;\n\n        if (permission.effect === \"Allow\") {\n          if (!allowed.includes(key)) allowed.push(key);\n        } else if (!denied.includes(key)) {\n          denied.push(key);\n        }\n      }\n    }\n  }\n\n  return allowed.filter((key) => !denied.includes(key));\n}\n"],"mappings":";AASA,MAAM,iBAAiB;AAEvB,SAAgB,sBACd,UACA,UACU;CACV,MAAM,UAAoB,CAAC;CAC3B,MAAM,SAAmB,CAAC;CAE1B,KAAK,MAAM,UAAU,UACnB,KAAK,MAAM,cAAc,OAAO,aAC9B,KAAK,MAAM,UAAU,WAAW,UAAU;EACxC,IAAI,CAAC,OAAO,WAAW,QAAQ,GAAG;EAElC,MAAM,GAAG,IAAI,WAAW,YAAY,OAAO,MAAM,GAAG;EACpD,MAAM,kBAAkB,QAAQ,SAAS,KAAK,QAAQ,QAAQ;EAE9D,IAAI,WAAW,WAAW,SACxB,QAAQ,KAAK,EAAE;OACV,IAAI,CAAC,iBACV,OAAO,KAAK,EAAE;CAElB;CAIJ,OAAO,OAAO,SAAS,IACnB,QAAQ,QAAQ,OAAO,CAAC,OAAO,SAAS,EAAE,CAAC,IAC3C;AACN;AAEA,SAAgB,sBACd,UACA,SACU;CACV,MAAM,SAAS,SAAS,QAAQ;CAChC,MAAM,aAAa,SAAS;CAC5B,MAAM,gBAAgB,QACpB,QAAQ,cAAc,IAAI,WAAW,MAAM,KAAK,IAAI,WAAW,SAAS;CAE1E,MAAM,UAAoB,CAAC;CAC3B,MAAM,SAAmB,CAAC;CAE1B,KAAK,MAAM,UAAU,UACnB,KAAK,MAAM,cAAc,OAAO,aAC9B,KAAK,MAAM,UAAU,WAAW,UAAU;EACxC,IAAI,CAAC,aAAa,MAAM,GAAG;EAE3B,MAAM,KAAK,cAAc,OAAO,MAAM,GAAG;EACzC,IAAI,WAAW,WAAW,SACxB,IAAI,CAAC,YACC;OAAA,CAAC,QAAQ,SAAS,GAAG,GAAG,QAAQ,KAAK,GAAG;EAAA,OAE5C,QAAQ,KAAK,UAAU;OAGzB,OAAO,KAAK,UAAU;CAE1B;CAIJ,OAAO,QAAQ,QAAQ,OAAO,CAAC,OAAO,SAAS,EAAE,CAAC;AACpD;AAEA,SAAgB,mBAAmB,UAAkC;CACnE,MAAM,UAAoB,CAAC;CAC3B,MAAM,SAAmB,CAAC;CAE1B,KAAK,MAAM,UAAU,UACnB,KAAK,MAAM,cAAc,OAAO,aAC9B,KAAK,MAAM,UAAU,WAAW,UAAU;EACxC,IAAI,CAAC,OAAO,WAAW,cAAc,GAAG;EAExC,MAAM,MAAM,OAAO,MAAM,CAAqB;EAC9C,IAAI,CAAC,KAAK;EAEV,IAAI,WAAW,WAAW,SACpB;OAAA,CAAC,QAAQ,SAAS,GAAG,GAAG,QAAQ,KAAK,GAAG;EAAA,OACvC,IAAI,CAAC,OAAO,SAAS,GAAG,GAC7B,OAAO,KAAK,GAAG;CAEnB;CAIJ,OAAO,QAAQ,QAAQ,QAAQ,CAAC,OAAO,SAAS,GAAG,CAAC;AACtD"}
+{"version":3,"file":"policy-resolvers.js","names":[],"sources":["../../.generated/lib/policy-resolvers.ts"],"sourcesContent":["export interface PolicyPermissionLike {\n  entities: string[];\n  effect: \"Allow\" | \"Deny\";\n}\n\nexport interface PolicyLike {\n  permissions: PolicyPermissionLike[];\n}\n\nconst FEATURE_PREFIX = \"feature:\";\n\nexport function getAllowedResourceIds(\n  policies: PolicyLike[],\n  resource: string,\n): string[] {\n  const allowed: string[] = [];\n  const denied: string[] = [];\n\n  for (const policy of policies) {\n    for (const permission of policy.permissions) {\n      for (const entity of permission.entities) {\n        if (!entity.startsWith(resource)) continue;\n\n        const [, id, subsystem, deviceId] = entity.split(\":\");\n        const hasFinerSegment = Boolean(subsystem) || Boolean(deviceId);\n\n        if (permission.effect === \"Allow\") {\n          allowed.push(id);\n        } else if (!hasFinerSegment) {\n          denied.push(id);\n        }\n      }\n    }\n  }\n\n  return denied.length > 0\n    ? allowed.filter((id) => !denied.includes(id))\n    : allowed;\n}\n\nexport function getAllowedDeviceTypes(\n  policies: PolicyLike[],\n  spaceId: string,\n): string[] {\n  const prefix = `space:${spaceId}:`;\n  const exactMatch = `space:${spaceId}`;\n  const matchesSpace = (res: string) =>\n    res === exactMatch || res.startsWith(prefix) || res.startsWith(\"space:*\");\n\n  const allowed: string[] = [];\n  const denied: string[] = [];\n\n  for (const policy of policies) {\n    for (const permission of policy.permissions) {\n      for (const entity of permission.entities) {\n        if (!matchesSpace(entity)) continue;\n\n        const [, , deviceType] = entity.split(\":\");\n        if (permission.effect === \"Allow\") {\n          if (!deviceType) {\n            if (!allowed.includes(\"*\")) allowed.push(\"*\");\n          } else {\n            allowed.push(deviceType);\n          }\n        } else {\n          denied.push(deviceType);\n        }\n      }\n    }\n  }\n\n  return allowed.filter((id) => !denied.includes(id));\n}\n\nexport function getAllowedFeatures(policies: PolicyLike[]): string[] {\n  const allowed: string[] = [];\n  const denied: string[] = [];\n\n  for (const policy of policies) {\n    for (const permission of policy.permissions) {\n      for (const entity of permission.entities) {\n        if (!entity.startsWith(FEATURE_PREFIX)) continue;\n\n        const key = entity.slice(FEATURE_PREFIX.length);\n        if (!key) continue;\n\n        if (permission.effect === \"Allow\") {\n          if (!allowed.includes(key)) allowed.push(key);\n        } else if (!denied.includes(key)) {\n          denied.push(key);\n        }\n      }\n    }\n  }\n\n  return allowed.filter((key) => !denied.includes(key));\n}\n"],"mappings":";AASA,MAAM,iBAAiB;AAEvB,SAAgB,sBACd,UACA,UACU;CACV,MAAM,UAAoB,CAAC;CAC3B,MAAM,SAAmB,CAAC;CAE1B,KAAK,MAAM,UAAU,UACnB,KAAK,MAAM,cAAc,OAAO,aAC9B,KAAK,MAAM,UAAU,WAAW,UAAU;EACxC,IAAI,CAAC,OAAO,WAAW,QAAQ,GAAG;EAElC,MAAM,GAAG,IAAI,WAAW,YAAY,OAAO,MAAM,GAAG;EACpD,MAAM,kBAAkB,QAAQ,SAAS,KAAK,QAAQ,QAAQ;EAE9D,IAAI,WAAW,WAAW,SACxB,QAAQ,KAAK,EAAE;OACV,IAAI,CAAC,iBACV,OAAO,KAAK,EAAE;CAElB;CAIJ,OAAO,OAAO,SAAS,IACnB,QAAQ,QAAQ,OAAO,CAAC,OAAO,SAAS,EAAE,CAAC,IAC3C;AACN;AAEA,SAAgB,sBACd,UACA,SACU;CACV,MAAM,SAAS,SAAS,QAAQ;CAChC,MAAM,aAAa,SAAS;CAC5B,MAAM,gBAAgB,QACpB,QAAQ,cAAc,IAAI,WAAW,MAAM,KAAK,IAAI,WAAW,SAAS;CAE1E,MAAM,UAAoB,CAAC;CAC3B,MAAM,SAAmB,CAAC;CAE1B,KAAK,MAAM,UAAU,UACnB,KAAK,MAAM,cAAc,OAAO,aAC9B,KAAK,MAAM,UAAU,WAAW,UAAU;EACxC,IAAI,CAAC,aAAa,MAAM,GAAG;EAE3B,MAAM,KAAK,cAAc,OAAO,MAAM,GAAG;EACzC,IAAI,WAAW,WAAW,SAAS;GACjC,IAAI,CAAC,YACC;QAAA,CAAC,QAAQ,SAAS,GAAG,GAAG,QAAQ,KAAK,GAAG;GAAA,OAE5C,QAAQ,KAAK,UAAU;EAE3B,OACE,OAAO,KAAK,UAAU;CAE1B;CAIJ,OAAO,QAAQ,QAAQ,OAAO,CAAC,OAAO,SAAS,EAAE,CAAC;AACpD;AAEA,SAAgB,mBAAmB,UAAkC;CACnE,MAAM,UAAoB,CAAC;CAC3B,MAAM,SAAmB,CAAC;CAE1B,KAAK,MAAM,UAAU,UACnB,KAAK,MAAM,cAAc,OAAO,aAC9B,KAAK,MAAM,UAAU,WAAW,UAAU;EACxC,IAAI,CAAC,OAAO,WAAW,cAAc,GAAG;EAExC,MAAM,MAAM,OAAO,MAAM,CAAqB;EAC9C,IAAI,CAAC,KAAK;EAEV,IAAI,WAAW,WAAW,SACpB;OAAA,CAAC,QAAQ,SAAS,GAAG,GAAG,QAAQ,KAAK,GAAG;EAAA,OACvC,IAAI,CAAC,OAAO,SAAS,GAAG,GAC7B,OAAO,KAAK,GAAG;CAEnB;CAIJ,OAAO,QAAQ,QAAQ,QAAQ,CAAC,OAAO,SAAS,GAAG,CAAC;AACtD"}