@classytic/pos-ui 0.2.0 → 1.2.0

package/dist/dashboard/components/VariantSelectorDialog.js

@@ -1,6 +1,6 @@
 "use client";
 
-import { formatBdt } from "../../lib/money.js";
+import { formatMajor, minorToMajor } from "../../lib/money.js";
 import { cn } from "../../lib/cn.js";
 import { useMemo, useState } from "react";
 import { DialogWrapper } from "@classytic/fluid/client/core";
@@ -11,18 +11,60 @@ import { Button } from "@/components/ui/button";
 import { Badge } from "@/components/ui/badge";
 
 //#region src/dashboard/components/VariantSelectorDialog.tsx
+/** Case- and space-insensitive: "Monthly" and " monthly " are the same string to a reader. */
+const sameText = (a, b) => a.trim().toLowerCase() === b.trim().toLowerCase();
+/**
+* Should this row show `SKU: …`?
+*
+* Two conditions, both about whether the code carries INFORMATION for a cashier:
+*
+* 1. the product is stock-tracked (a SKU is an inventory identifier — a gym month
+*    and a haircut have none worth showing, same axis as the stock badge); and
+* 2. the sku is not just a case/spacing variant of the label already displayed.
+*/
+function showVariantSku(product, variant) {
+	if (product?.inventory?.stockTracked === false) return false;
+	return !sameText(variant.label, variant.sku);
+}
 function VariantSelectorDialog({ product, open, onOpenChange, onSelect }) {
 	const [selectedSku, setSelectedSku] = useState(null);
 	const variantOptions = useMemo(() => {
 		if (!product?.variants) return [];
+		/**
+		* Is the PRODUCT counted at all? Per-product, absent ⇒ tracked.
+		*
+		* A subscription membership's "variants" are its PLANS (monthly / yearly), which hold
+		* no stock — so `getVariantStock` finds nothing, `stock > 0` is false, and every plan
+		* rendered "Out of Stock" on a product that cannot be out of stock. Same inversion the
+		* card had: absence of a quantity became a negative answer.
+		*/
+		const tracked = product.inventory?.stockTracked !== false;
 		return product.variants.filter((v) => v.isActive).map((variant) => {
 			const stock = getVariantStock(product, variant.sku);
-			const inStock = stock > 0;
+			const inStock = tracked ? stock > 0 : true;
+			/**
+			* An ABSOLUTE variant price wins over base-plus-modifier.
+			*
+			* `priceModifier` models a variant as an uplift on the product's base price, which
+			* is right for "Large: +৳50". A subscription PLAN is not an uplift — it carries its
+			* own price, and `getPosPrice` resolves the product to `plans[0]`. So the modifier
+			* form showed monthly's ৳3,000 for BOTH terms, quoting a ৳30,000 annual plan at a
+			* tenth of its price. Reading `variant.price` when present fixes the quote at the
+			* only place the cashier sees it.
+			*/
+			const absolute = variant.price;
+			const price = typeof absolute === "number" && absolute > 0 ? minorToMajor(absolute) : calculateVariantPrice(getPosPrice(product), variant.priceModifier);
 			return {
 				sku: variant.sku,
 				attributes: variant.attributes,
-				label: formatVariantLabel(variant.attributes),
-				price: calculateVariantPrice(getPosPrice(product), variant.priceModifier),
+				/**
+				* A NAME when the producer gave one, else the attribute-derived label, else the
+				* sku. Plans have a human label ("Monthly") and no attributes, so the
+				* attributes-only form produced an empty heading with `SKU: monthly` beneath it
+				* as the only visible text — a cashier picking a term from a raw slug.
+				*/
+				label: variant.name ?? variant.label ?? formatVariantLabel(variant.attributes) ?? variant.sku,
+				price,
 				priceModifier: variant.priceModifier || 0,
 				stock,
 				inStock,
@@ -84,7 +126,7 @@ function VariantSelectorDialog({ product, open, onOpenChange, onSelect }) {
 						}),
 						/* @__PURE__ */ jsxs("p", {
 							className: "text-sm text-muted-foreground",
-							children: ["Base Price: ", formatBdt(getPosPrice(product))]
+							children: ["Base Price: ", formatMajor(getPosPrice(product))]
 						}),
 						/* @__PURE__ */ jsx("div", {
 							className: "flex flex-wrap gap-1 mt-1",
@@ -114,29 +156,29 @@ function VariantSelectorDialog({ product, open, onOpenChange, onSelect }) {
 							className: cn("w-5 h-5 rounded-full border-2 flex items-center justify-center", selectedSku === variant.sku ? "border-primary bg-primary" : "border-muted-foreground/30"),
 							children: selectedSku === variant.sku && /* @__PURE__ */ jsx(Check, { className: "h-3 w-3 text-primary-foreground" })
 						}), /* @__PURE__ */ jsxs("div", {
-							className: "text-left",
+							className: "text-start",
 							children: [/* @__PURE__ */ jsx("p", {
 								className: "font-medium",
 								children: variant.label
-							}), /* @__PURE__ */ jsxs("p", {
+							}), showVariantSku(product, variant) && /* @__PURE__ */ jsxs("p", {
 								className: "text-xs text-muted-foreground font-mono",
 								children: ["SKU: ", variant.sku]
 							})]
 						})]
 					}), /* @__PURE__ */ jsxs("div", {
 						className: "flex items-center gap-4",
-						children: [/* @__PURE__ */ jsx(Badge, {
+						children: [product.inventory?.stockTracked !== false && /* @__PURE__ */ jsx(Badge, {
 							variant: variant.inStock ? "secondary" : "destructive",
 							className: "text-xs",
 							children: variant.inStock ? `Stock: ${variant.stock}` : "Out of Stock"
 						}), /* @__PURE__ */ jsxs("div", {
-							className: "text-right",
+							className: "text-end",
 							children: [/* @__PURE__ */ jsx("p", {
 								className: "font-bold",
-								children: formatBdt(variant.price)
+								children: formatMajor(variant.price)
 							}), variant.priceModifier !== 0 && /* @__PURE__ */ jsxs("p", {
 								className: "text-xs text-muted-foreground",
-								children: [variant.priceModifier > 0 ? "+" : "", formatBdt(variant.priceModifier)]
+								children: [variant.priceModifier > 0 ? "+" : "", formatMajor(variant.priceModifier)]
 							})]
 						})]
 					})]

package/dist/dashboard/components/cart/AddChargeDialog.js

@@ -1,5 +1,6 @@
 "use client";
 
+import { TENANT_CURRENCY_SYMBOL } from "../../../lib/money.js";
 import { useState } from "react";
 import { FormDialog } from "@classytic/fluid/client/core";
 import { Fragment, jsx, jsxs } from "react/jsx-runtime";
@@ -33,7 +34,7 @@ function AddChargeDialog({ disabled, onAddCharge }) {
 		className: "w-full",
 		disabled,
 		onClick: () => setOpen(true),
-		children: [/* @__PURE__ */ jsx(Plus, { className: "h-4 w-4 mr-1.5" }), "Add Charge"]
+		children: [/* @__PURE__ */ jsx(Plus, { className: "h-4 w-4 me-1.5" }), "Add Charge"]
 	}), /* @__PURE__ */ jsx(FormDialog, {
 		open,
 		onOpenChange: (o) => {
@@ -79,7 +80,7 @@ function AddChargeDialog({ disabled, onAddCharge }) {
 				className: "space-y-1.5",
 				children: [/* @__PURE__ */ jsx(Label, {
 					htmlFor: "add-charge-amount",
-					children: "Amount (BDT)"
+					children: `Amount (${TENANT_CURRENCY_SYMBOL})`
 				}), /* @__PURE__ */ jsx(Input, {
 					id: "add-charge-amount",
 					type: "number",

package/dist/dashboard/components/cart/CartItems.js

@@ -1,6 +1,6 @@
 "use client";
 
-import { formatBdt } from "../../../lib/money.js";
+import { formatMajor } from "../../../lib/money.js";
 import { jsx, jsxs } from "react/jsx-runtime";
 import { ShoppingCart, Sparkles } from "lucide-react";
 import { Button } from "@/components/ui/button";
@@ -77,7 +77,7 @@ function CartItemRow({ item, onQuantityChange, onRemove }) {
 							/* @__PURE__ */ jsx(Button, {
 								variant: "ghost",
 								size: "sm",
-								className: "h-6 ml-auto text-xs",
+								className: "h-6 ms-auto text-xs",
 								onClick: onRemove,
 								children: "Remove"
 							})
@@ -86,13 +86,13 @@ function CartItemRow({ item, onQuantityChange, onRemove }) {
 				]
 			}),
 			/* @__PURE__ */ jsxs("div", {
-				className: "text-right",
+				className: "text-end",
 				children: [/* @__PURE__ */ jsx("p", {
 					className: "font-bold",
-					children: formatBdt(item.lineTotal)
+					children: formatMajor(item.lineTotal)
 				}), /* @__PURE__ */ jsxs("p", {
 					className: "text-xs text-muted-foreground",
-					children: [formatBdt(item.unitPrice), " each"]
+					children: [formatMajor(item.unitPrice), " each"]
 				})]
 			})
 		]

package/dist/dashboard/components/cart/CartSummary.js

@@ -1,6 +1,6 @@
 "use client";
 
-import { formatBdt } from "../../../lib/money.js";
+import { formatMajor } from "../../../lib/money.js";
 import { jsx, jsxs } from "react/jsx-runtime";
 
 //#region src/dashboard/components/cart/CartSummary.tsx
@@ -15,7 +15,7 @@ function CartSummary({ subtotal, discount, redemptionDiscount = 0, tierDiscount
 					children: "Subtotal"
 				}), /* @__PURE__ */ jsx("span", {
 					className: "font-medium",
-					children: formatBdt(subtotal)
+					children: formatMajor(subtotal)
 				})]
 			}),
 			discount > 0 && /* @__PURE__ */ jsxs("div", {
@@ -25,7 +25,7 @@ function CartSummary({ subtotal, discount, redemptionDiscount = 0, tierDiscount
 					children: "Discount"
 				}), /* @__PURE__ */ jsxs("span", {
 					className: "font-medium",
-					children: ["-", formatBdt(discount)]
+					children: ["-", formatMajor(discount)]
 				})]
 			}),
 			tierDiscount > 0 && /* @__PURE__ */ jsxs("div", {
@@ -36,7 +36,7 @@ function CartSummary({ subtotal, discount, redemptionDiscount = 0, tierDiscount
 				}), /* @__PURE__ */ jsxs("span", {
 					className: "font-medium",
 					style: tierColor ? { color: tierColor } : void 0,
-					children: ["-", formatBdt(tierDiscount)]
+					children: ["-", formatMajor(tierDiscount)]
 				})]
 			}),
 			redemptionDiscount > 0 && /* @__PURE__ */ jsxs("div", {
@@ -46,12 +46,12 @@ function CartSummary({ subtotal, discount, redemptionDiscount = 0, tierDiscount
 					children: "Points Redeemed"
 				}), /* @__PURE__ */ jsxs("span", {
 					className: "font-medium",
-					children: ["-", formatBdt(redemptionDiscount)]
+					children: ["-", formatMajor(redemptionDiscount)]
 				})]
 			}),
 			/* @__PURE__ */ jsxs("div", {
 				className: "flex justify-between text-lg font-bold",
-				children: [/* @__PURE__ */ jsx("span", { children: "Total" }), /* @__PURE__ */ jsx("span", { children: formatBdt(total) })]
+				children: [/* @__PURE__ */ jsx("span", { children: "Total" }), /* @__PURE__ */ jsx("span", { children: formatMajor(total) })]
 			}),
 			pointsToEarn > 0 && /* @__PURE__ */ jsxs("div", {
 				className: "flex justify-between text-xs text-muted-foreground",

package/dist/dashboard/components/cart/CustomerSection.js

@@ -22,7 +22,7 @@ function CustomerSection({ selected, name, phone, membershipCardId, membershipSt
 				size: "sm",
 				className: "h-7 px-2",
 				onClick: onClear,
-				children: [/* @__PURE__ */ jsx(X, { className: "h-3.5 w-3.5 mr-1" }), "Clear"]
+				children: [/* @__PURE__ */ jsx(X, { className: "h-3.5 w-3.5 me-1" }), "Clear"]
 			})]
 		}), selected ? /* @__PURE__ */ jsxs("div", {
 			className: "rounded-lg border bg-muted/30 p-3",
@@ -77,12 +77,12 @@ function CustomerSection({ selected, name, phone, membershipCardId, membershipSt
 					children: [/* @__PURE__ */ jsxs("div", {
 						className: "relative flex-1",
 						children: [/* @__PURE__ */ jsx(ScanLine, {
-							className: "pointer-events-none absolute left-2.5 top-1/2 h-4 w-4 -translate-y-1/2 text-muted-foreground",
+							className: "pointer-events-none absolute start-2.5 top-1/2 h-4 w-4 -translate-y-1/2 text-muted-foreground",
 							"aria-hidden": true
 						}), /* @__PURE__ */ jsx(Input, {
 							"aria-label": "Scan loyalty card",
 							placeholder: "Scan card or type ID",
-							className: "pl-8",
+							className: "ps-8",
 							value: membershipCardId,
 							disabled: membershipStatus === "searching",
 							onChange: (e) => onMembershipChange(e.target.value),

package/dist/dashboard/components/cart/DiscountSection.js

@@ -1,5 +1,6 @@
 "use client";
 
+import { TENANT_CURRENCY_SYMBOL } from "../../../lib/money.js";
 import { cn } from "../../../lib/cn.js";
 import { jsx, jsxs } from "react/jsx-runtime";
 import { Lock, ShieldCheck, X } from "lucide-react";
@@ -25,14 +26,14 @@ function DiscountSection({ value, onChange, isAuthorized, authorizedByName, onRe
 					onClearAuth && /* @__PURE__ */ jsx("button", {
 						type: "button",
 						onClick: onClearAuth,
-						className: "ml-1 hover:text-red-500 transition-colors",
+						className: "ms-1 hover:text-red-500 transition-colors",
 						"aria-label": "Clear authorization",
 						children: /* @__PURE__ */ jsx(X, { className: "h-3 w-3" })
 					})
 				]
 			})]
 		}), isAuthorized ? /* @__PURE__ */ jsx(Input, {
-			placeholder: "Discount (BDT)",
+			placeholder: `Discount (${TENANT_CURRENCY_SYMBOL})`,
 			inputMode: "numeric",
 			value,
 			onChange: (e) => onChange(e.target.value)
@@ -41,7 +42,7 @@ function DiscountSection({ value, onChange, isAuthorized, authorizedByName, onRe
 			variant: "outline",
 			className: cn("w-full justify-start text-muted-foreground font-normal h-10", "hover:border-amber-300 hover:bg-amber-50/50"),
 			onClick: onRequestAuth,
-			children: [/* @__PURE__ */ jsx(Lock, { className: "h-4 w-4 mr-2 text-amber-500" }), "Manager authorization required"]
+			children: [/* @__PURE__ */ jsx(Lock, { className: "h-4 w-4 me-2 text-amber-500" }), "Manager authorization required"]
 		})]
 	});
 }

package/dist/dashboard/components/cart/PointsRedemptionSection.js

@@ -1,14 +1,15 @@
 "use client";
 
-import { formatBdt } from "../../../lib/money.js";
+import { formatMajor, formatMinor } from "../../../lib/money.js";
 import { jsx, jsxs } from "react/jsx-runtime";
 import { Button } from "@/components/ui/button";
 import { Input } from "@/components/ui/input";
 
 //#region src/dashboard/components/cart/PointsRedemptionSection.tsx
-function PointsRedemptionSection({ enabled, pointsBalance, minRedeemPoints, maxRedeemPoints, pointsPerBdt, estimatedDiscount, error, value, onChange, onUseMax }) {
+function PointsRedemptionSection({ enabled, pointsBalance, minRedeemPoints, maxRedeemPoints, pointValueMinor, estimatedDiscount, error, value, onChange, onUseMax }) {
 	if (!enabled) return null;
-	const helperText = maxRedeemPoints > 0 ? `Up to ${maxRedeemPoints} pts (${formatBdt(maxRedeemPoints / pointsPerBdt)})` : "Not eligible for redemption";
+	const redeemableMinor = typeof pointValueMinor === "number" && Number.isFinite(pointValueMinor) && pointValueMinor > 0 ? maxRedeemPoints * pointValueMinor : null;
+	const helperText = maxRedeemPoints > 0 ? redeemableMinor !== null ? `Up to ${maxRedeemPoints} pts (${formatMinor(redeemableMinor)})` : `Up to ${maxRedeemPoints} pts` : "Not eligible for redemption";
 	return /* @__PURE__ */ jsxs("div", {
 		className: "space-y-2",
 		children: [
@@ -44,7 +45,7 @@ function PointsRedemptionSection({ enabled, pointsBalance, minRedeemPoints, maxR
 			}),
 			/* @__PURE__ */ jsxs("div", {
 				className: "flex items-center justify-between text-xs text-muted-foreground",
-				children: [/* @__PURE__ */ jsx("span", { children: helperText }), estimatedDiscount > 0 && /* @__PURE__ */ jsxs("span", { children: ["-", formatBdt(estimatedDiscount)] })]
+				children: [/* @__PURE__ */ jsx("span", { children: helperText }), estimatedDiscount > 0 && /* @__PURE__ */ jsxs("span", { children: ["-", formatMajor(estimatedDiscount)] })]
 			}),
 			error && /* @__PURE__ */ jsx("p", {
 				className: "text-xs text-destructive",

package/dist/dashboard/pos.types.d.ts

@@ -0,0 +1,32 @@
+import { PosCartItem } from "@classytic/commerce-sdk/sales";
+import "@classytic/commerce-sdk/platform";
+//#region src/dashboard/pos.types.d.ts
+/**
+ * Local POS cart item — extends the SDK's `PosCartItem` with the
+ * discriminated `kind` field used to distinguish scanned products from
+ * ad-hoc service fees (gift wrap, damaged-product reimbursement, custom
+ * handling). Survives end-to-end into the order create payload (be-prod's
+ * `PosOrderItem` schema accepts the same shape) so reports can later
+ * aggregate by `lines.kind === 'service-fee'` regardless of how the line
+ * entered the system.
+ *
+ *   - `kind: 'sku'` (default, omittable) — scanned product line; uses the
+ *     SDK shape verbatim (`productId`, `variantSku`, `image`, etc.).
+ *   - `kind: 'service-fee'` — cashier-authored line; `productId` carries
+ *     the synthetic `service:<slug>` code derived from the typed label,
+ *     `productName` carries the verbatim label, `serviceCode` is the
+ *     slugified discriminator the receipt + reports key on.
+ *
+ * The base type's `productId: string` stays required for both flavors so
+ * existing render paths (CartItems, receipt, parked-order resume) keep
+ * a stable identifier per row. For service fees we synthesize
+ * `service:<slug>` client-side; the backend re-derives the slug from the
+ * `label` in `pos.controller.ts`'s line builder so the persisted order
+ * line is authoritative.
+ */
+interface PosCartItem$1 extends PosCartItem {
+  kind?: "sku" | "service-fee";
+  serviceCode?: string;
+}
+//#endregion
+export { PosCartItem$1 as PosCartItem };

package/dist/hardware/agent-adapter.js

@@ -0,0 +1,127 @@
+import { majorToMinor } from "../lib/money.js";
+
+//#region src/hardware/agent-adapter.ts
+function toMinor(amount) {
+	return majorToMinor(amount ?? 0);
+}
+/** `ReceiptPayload` (pos-ui's major-unit UI port) → pos-agent's minor-unit wire contract. */
+function toWireReceipt(payload) {
+	return {
+		branch: {
+			name: payload.branch.name,
+			...payload.branch.address !== void 0 ? { address: payload.branch.address } : {},
+			...payload.branch.bin !== void 0 ? { bin: payload.branch.bin } : {},
+			...payload.branch.phone !== void 0 ? { phone: payload.branch.phone } : {}
+		},
+		shift: payload.shift,
+		order: {
+			number: payload.order.number,
+			placedAt: payload.order.placedAt.toISOString(),
+			lines: payload.order.lines.map((line) => ({
+				name: line.name,
+				...line.variant !== void 0 ? { variant: line.variant } : {},
+				qty: line.qty,
+				unitPriceMinor: toMinor(line.unitPrice),
+				totalMinor: toMinor(line.total),
+				...line.taxAmount !== void 0 ? { taxAmountMinor: toMinor(line.taxAmount) } : {}
+			})),
+			subtotalMinor: toMinor(payload.order.subtotal),
+			taxMinor: toMinor(payload.order.tax),
+			...payload.order.discount !== void 0 ? { discountMinor: toMinor(payload.order.discount) } : {},
+			...payload.order.deliveryFee !== void 0 ? { deliveryFeeMinor: toMinor(payload.order.deliveryFee) } : {},
+			grandTotalMinor: toMinor(payload.order.grandTotal),
+			currency: payload.order.currency
+		},
+		payments: payload.payments.map((p) => ({
+			method: p.method,
+			amountMinor: toMinor(p.amount),
+			...p.reference !== void 0 ? { reference: p.reference } : {}
+		})),
+		...payload.changeDue !== void 0 ? { changeDueMinor: toMinor(payload.changeDue) } : {},
+		...payload.notes !== void 0 ? { notes: payload.notes } : {}
+	};
+}
+function toPortOutcome(result) {
+	return result?.outcome ?? "unknown";
+}
+let jobCounter = 0;
+function generateJobId(prefix) {
+	jobCounter += 1;
+	return `${prefix}_${Date.now()}_${jobCounter}`;
+}
+var PosAgentReceiptPrinter = class {
+	constructor(getPairing, deviceId, paperWidthMm) {
+		this.getPairing = getPairing;
+		this.deviceId = deviceId;
+		this.paperWidthMm = paperWidthMm;
+	}
+	async print(payload, copyType = "original") {
+		const pairing = this.getPairing();
+		if (!pairing) return "failed";
+		const { submitPrintJob } = await import("@classytic/pos-agent/client");
+		const request = {
+			schemaVersion: 1,
+			jobId: generateJobId(copyType === "reprint" ? "reprint" : "print"),
+			orderId: payload.order.number,
+			deviceId: this.deviceId,
+			copyType,
+			...this.paperWidthMm !== void 0 ? { paperWidthMm: this.paperWidthMm } : {},
+			codePage: "cp437",
+			receipt: toWireReceipt(payload)
+		};
+		const res = await submitPrintJob({
+			baseUrl: pairing.agentUrl,
+			localToken: pairing.localToken
+		}, request);
+		if (!res.ok) return res.timedOut ? "unknown" : "failed";
+		return toPortOutcome(res.data);
+	}
+	async isAvailable() {
+		const pairing = this.getPairing();
+		if (!pairing) return false;
+		const { getCapabilities } = await import("@classytic/pos-agent/client");
+		const res = await getCapabilities({
+			baseUrl: pairing.agentUrl,
+			localToken: pairing.localToken
+		});
+		if (!res.ok) return false;
+		return res.data.devices.find((d) => d.deviceId === this.deviceId)?.status.state === "ready";
+	}
+};
+var PosAgentCashDrawer = class {
+	constructor(getPairing, deviceId) {
+		this.getPairing = getPairing;
+		this.deviceId = deviceId;
+	}
+	async open() {
+		const pairing = this.getPairing();
+		if (!pairing) return "failed";
+		const { submitDrawerJob } = await import("@classytic/pos-agent/client");
+		const request = {
+			schemaVersion: 1,
+			jobId: generateJobId("drawer"),
+			deviceId: this.deviceId,
+			reason: "no-sale"
+		};
+		const res = await submitDrawerJob({
+			baseUrl: pairing.agentUrl,
+			localToken: pairing.localToken
+		}, request);
+		if (!res.ok) return res.timedOut ? "unknown" : "failed";
+		return toPortOutcome(res.data);
+	}
+	async isAvailable() {
+		const pairing = this.getPairing();
+		if (!pairing) return false;
+		const { getCapabilities } = await import("@classytic/pos-agent/client");
+		const res = await getCapabilities({
+			baseUrl: pairing.agentUrl,
+			localToken: pairing.localToken
+		});
+		if (!res.ok) return false;
+		return res.data.devices.find((d) => d.deviceId === this.deviceId)?.status.state === "ready";
+	}
+};
+
+//#endregion
+export { PosAgentCashDrawer, PosAgentReceiptPrinter };

package/dist/hardware/agent-pairing.d.ts

@@ -0,0 +1,18 @@
+//#region src/hardware/agent-pairing.d.ts
+interface AgentPairing {
+  /** e.g. `http://127.0.0.1:9191` — resolved from pairing, never user-typed per print request. */
+  agentUrl: string;
+  deviceId: string;
+  sn: string;
+  /** The LOCAL browser↔agent token (see `@classytic/pos-agent/protocol`'s pairing module) — NOT the device-registry bearer token, which pos-agent holds and this browser never sees again after pairing. */
+  localToken: string;
+  pairedAt: string;
+}
+/** Synchronous read — used by `createWebHardware()` and the agent adapter on each call. */
+declare function readAgentPairing(): AgentPairing | null;
+declare function useAgentPairing(): {
+  pairing: AgentPairing | null;
+  setPairing: (next: AgentPairing | null) => void;
+};
+//#endregion
+export { AgentPairing, readAgentPairing, useAgentPairing };

package/dist/hardware/agent-pairing.js

@@ -0,0 +1,63 @@
+"use client";
+
+import { useCallback, useEffect, useState } from "react";
+
+//#region src/hardware/agent-pairing.ts
+/**
+* useAgentPairing — localStorage-backed pairing record for `@classytic/pos-agent`.
+*
+* Replaces `pos:printer:config` (raw host/port) for the agent path — per the POS
+* hardware-bridge plan's Stream 1.2, the browser stores only the agent URL, the
+* paired device id, and the LOCAL token; it never stores or sends a printer
+* host/port again (device identity now lives in `@classytic/device-registry`,
+* resolved by `pos-agent` itself at pairing time).
+*
+* A synchronous reader (`readAgentPairing`) exists for the same reason
+* `readPrinterConfig` does: `createWebHardware()` in `web-adapter.ts` must decide
+* synchronously (inside `useMemo`) whether to construct the agent adapter or the
+* plain browser one — an async read would break that contract.
+*/
+const STORAGE_KEY = "pos:agent:pairing";
+/** Synchronous read — used by `createWebHardware()` and the agent adapter on each call. */
+function readAgentPairing() {
+	if (typeof window === "undefined") return null;
+	try {
+		const raw = window.localStorage.getItem(STORAGE_KEY);
+		if (!raw) return null;
+		const parsed = JSON.parse(raw);
+		if (typeof parsed.agentUrl !== "string" || typeof parsed.deviceId !== "string" || typeof parsed.localToken !== "string" || parsed.agentUrl.trim().length === 0) return null;
+		return parsed;
+	} catch {
+		return null;
+	}
+}
+function writeAgentPairing(pairing) {
+	if (typeof window === "undefined") return;
+	if (!pairing) {
+		window.localStorage.removeItem(STORAGE_KEY);
+		return;
+	}
+	window.localStorage.setItem(STORAGE_KEY, JSON.stringify(pairing));
+}
+function useAgentPairing() {
+	const [pairing, setPairingState] = useState(null);
+	useEffect(() => {
+		setPairingState(readAgentPairing());
+		const onStorage = (e) => {
+			if (e.key !== STORAGE_KEY) return;
+			setPairingState(readAgentPairing());
+		};
+		window.addEventListener("storage", onStorage);
+		return () => window.removeEventListener("storage", onStorage);
+	}, []);
+	return {
+		pairing,
+		setPairing: useCallback((next) => {
+			setPairingState(next);
+			writeAgentPairing(next);
+		}, [])
+	};
+}
+
+//#endregion
+export { readAgentPairing, useAgentPairing };

package/dist/hardware/context.d.ts

@@ -1,15 +1,11 @@
 import { PosHardware } from "./ports.js";
 import { useBarcodeScan } from "@classytic/fluid/client/hooks";
-
 //#region src/hardware/context.d.ts
 interface HardwareProviderProps {
   hardware: PosHardware;
   children: React.ReactNode;
 }
-declare function HardwareProvider({
-  hardware,
-  children
-}: HardwareProviderProps): import("react").JSX.Element;
+declare function HardwareProvider({ hardware, children }: HardwareProviderProps): import("react").JSX.Element;
 declare function useHardware(): PosHardware;
 //#endregion
 export { HardwareProvider, HardwareProviderProps, useBarcodeScan, useHardware };

package/dist/hardware/index.d.ts

@@ -1,7 +1,8 @@
-import { BarcodeScanner, CashDrawer, PaymentTerminal, PosHardware, ReceiptLine, ReceiptPayload, ReceiptPayment, ReceiptPrinter, ScanEvent, TerminalChargeInput, TerminalChargeResult } from "./ports.js";
-import { RECEIPT_DOM_ID, createWebHardware } from "./web-adapter.js";
+import { BarcodeScanner, CashDrawer, PaymentTerminal, PosHardware, PrintOutcome, ReceiptLine, ReceiptPayload, ReceiptPayment, ReceiptPrinter, ScanEvent, TerminalChargeInput, TerminalChargeResult } from "./ports.js";
+import { RECEIPT_DOM_ID, createWebHardware, printViaBrowserWindow } from "./web-adapter.js";
 import { createTauriHardware, isTauri } from "./tauri-adapter.js";
 import { HardwareProvider, useBarcodeScan, useHardware } from "./context.js";
 import { PrinterAvailability, usePrinterAvailability } from "./use-printer-availability.js";
 import { PrinterConfig, readPrinterConfig, usePrinterConfig } from "./use-printer-config.js";
-export { type BarcodeScanner, type CashDrawer, HardwareProvider, type PaymentTerminal, type PosHardware, type PrinterAvailability, type PrinterConfig, RECEIPT_DOM_ID, type ReceiptLine, type ReceiptPayload, type ReceiptPayment, type ReceiptPrinter, type ScanEvent, type TerminalChargeInput, type TerminalChargeResult, createTauriHardware, createWebHardware, isTauri, readPrinterConfig, useBarcodeScan, useHardware, usePrinterAvailability, usePrinterConfig };
+import { AgentPairing, readAgentPairing, useAgentPairing } from "./agent-pairing.js";
+export { type AgentPairing, type BarcodeScanner, type CashDrawer, HardwareProvider, type PaymentTerminal, type PosHardware, type PrintOutcome, type PrinterAvailability, type PrinterConfig, RECEIPT_DOM_ID, type ReceiptLine, type ReceiptPayload, type ReceiptPayment, type ReceiptPrinter, type ScanEvent, type TerminalChargeInput, type TerminalChargeResult, createTauriHardware, createWebHardware, isTauri, printViaBrowserWindow, readAgentPairing, readPrinterConfig, useAgentPairing, useBarcodeScan, useHardware, usePrinterAvailability, usePrinterConfig };

package/dist/hardware/index.js

@@ -1,7 +1,8 @@
 import { readPrinterConfig, usePrinterConfig } from "./use-printer-config.js";
 import { createTauriHardware, isTauri } from "./tauri-adapter.js";
-import { RECEIPT_DOM_ID, createWebHardware } from "./web-adapter.js";
+import { readAgentPairing, useAgentPairing } from "./agent-pairing.js";
+import { RECEIPT_DOM_ID, createWebHardware, printViaBrowserWindow } from "./web-adapter.js";
 import { HardwareProvider, useBarcodeScan, useHardware } from "./context.js";
 import { usePrinterAvailability } from "./use-printer-availability.js";
 
-export { HardwareProvider, RECEIPT_DOM_ID, createTauriHardware, createWebHardware, isTauri, readPrinterConfig, useBarcodeScan, useHardware, usePrinterAvailability, usePrinterConfig };
+export { HardwareProvider, RECEIPT_DOM_ID, createTauriHardware, createWebHardware, isTauri, printViaBrowserWindow, readAgentPairing, readPrinterConfig, useAgentPairing, useBarcodeScan, useHardware, usePrinterAvailability, usePrinterConfig };

package/dist/hardware/ports.d.ts

@@ -56,15 +56,32 @@ interface ReceiptPayload {
   qrCodeUrl?: string;
   notes?: string;
 }
+/**
+ * `confirmed` = the adapter's part of the job completed (browser dialog opened,
+ * bytes handed to the transport). `failed` = a clear, non-ambiguous refusal
+ * (unconfigured, disallowed). `unknown` = the outcome genuinely cannot be
+ * determined (a timeout, a dropped connection after bytes were already sent) —
+ * the job may have already printed. A caller MUST NOT auto-retry `unknown`;
+ * that risks a duplicate receipt. Mirrors `@classytic/pos-agent/protocol`'s
+ * `JobOutcome` deliberately — one vocabulary for this tri-state across the
+ * whole print path, not two that could drift.
+ */
+type PrintOutcome = "confirmed" | "failed" | "unknown";
 interface ReceiptPrinter {
-  /** Print a structured receipt. Adapter handles ESC/POS encoding or browser print. */
-  print(payload: ReceiptPayload): Promise<void>;
+  /**
+   * Print a structured receipt. Adapter handles ESC/POS encoding or browser
+   * print. `copyType` defaults to `'original'`; pass `'reprint'` so an
+   * agent-backed adapter mints a NEW job id rather than deduping against the
+   * original print (see `@classytic/pos-agent`'s per-device job spool). Web
+   * and Tauri adapters ignore it — they have no job-dedupe concept.
+   */
+  print(payload: ReceiptPayload, copyType?: "original" | "reprint"): Promise<PrintOutcome>;
   /** Whether this adapter can talk to a printer right now (false for browser without agent). */
   isAvailable(): Promise<boolean>;
 }
 interface CashDrawer {
   /** Pulse the kick signal. Most adapters drive this through the printer's RJ11. */
-  open(): Promise<void>;
+  open(): Promise<PrintOutcome>;
   isAvailable(): Promise<boolean>;
 }
 interface ScanEvent {
@@ -113,4 +130,4 @@ interface PosHardware {
   terminal: PaymentTerminal;
 }
 //#endregion
-export { BarcodeScanner, CashDrawer, PaymentTerminal, PosHardware, ReceiptLine, ReceiptPayload, ReceiptPayment, ReceiptPrinter, ScanEvent, TerminalChargeInput, TerminalChargeResult };
+export { BarcodeScanner, CashDrawer, PaymentTerminal, PosHardware, PrintOutcome, ReceiptLine, ReceiptPayload, ReceiptPayment, ReceiptPrinter, ScanEvent, TerminalChargeInput, TerminalChargeResult };

package/dist/hardware/tauri-adapter.d.ts

@@ -1,5 +1,4 @@
 import { PosHardware } from "./ports.js";
-
 //#region src/hardware/tauri-adapter.d.ts
 declare function isTauri(): boolean;
 declare function createTauriHardware(): PosHardware;