store($key, ($this->quantities()[$key] ?? 0) + $quantity, $variant !== null ? $variant->stock : $product->stock); } /** * Set exactly how many of one cart line there are. Zero removes it. * Returns null when the line does not point at something this store sells. */ public function setLine(string $key, int $quantity): ?int { $item = $this->find($key); if ($item === null) { return null; } [$product, $variant] = $item; return $this->store(self::lineKey($product, $variant), $quantity, $variant !== null ? $variant->stock : $product->stock); } public function removeLine(string $key): void { $quantities = $this->quantities(); unset($quantities[$key]); $this->save($quantities); } /** * The name of a cart line: the product id, or "product-variant" for a product with options. */ public static function lineKey(Product $product, ?ProductVariant $variant): string { return $variant !== null ? $product->id.'-'.$variant->id : (string) $product->id; } /** * The quantity is capped by the stock and by MAX_QUANTITY. */ private function store(string $key, int $wanted, int $stock): int { $quantities = $this->quantities(); $allowed = max(0, min($wanted, $stock, self::MAX_QUANTITY)); if ($allowed === 0) { unset($quantities[$key]); } else { $quantities[$key] = $allowed; } $this->save($quantities); return $allowed; } /** * The product and variant a cart line points at, if this store sells them. * * @return array{0: Product, 1: ProductVariant|null}|null */ private function find(string $key): ?array { $parsed = self::parseKey($key); if ($parsed === null) { return null; } [$productId, $variantId] = $parsed; $product = $this->store->products()->active()->with('variants')->whereKey($productId)->first(); if ($product === null) { return null; } $variant = $variantId !== null ? $product->variants->firstWhere('id', $variantId) : null; // A product with options must name one of its variants; a simple product must not name any. if ($product->hasVariants() !== ($variant !== null)) { return null; } return [$product, $variant]; } /** * @return array{0: int, 1: int|null}|null */ private static function parseKey(string $key): ?array { if (preg_match('/^(\d+)(?:-(\d+))?$/', $key, $match) !== 1) { return null; } return [(int) $match[1], isset($match[2]) ? (int) $match[2] : null]; } public function clear(): void { $this->session->forget($this->key()); $this->session->forget($this->discountKey()); } /** * Put a discount code in the cart. Returns the problem (a StorefrontText key) when the code * does not exist or cannot be used at all; a code that only needs a bigger cart is kept. */ public function applyCode(string $code): ?string { $discount = $this->store->discountCodes()->where('code', DiscountCode::normalize($code))->first(); if ($discount === null) { return 'discount_invalid'; } $problem = $discount->problemFor((int) $this->lines()->sum('line_total')); if ($problem !== null && $problem !== 'discount_minimum') { return $problem; } $this->session->put($this->discountKey(), $discount->code); return null; } /** * True when the last discount() call took the code out because it can no longer be used. */ public function discountWasRemoved(): bool { return $this->discountRemoved; } public function removeCode(): void { $this->session->forget($this->discountKey()); } /** * The code in the cart and what it is worth for these products. * A code that was deleted, switched off, expired or used up is taken out, and the cart says so once. */ public function discount(int $subtotal): ?AppliedDiscount { $code = $this->session->get($this->discountKey()); if (! is_string($code)) { return null; } $discount = $this->store->discountCodes()->where('code', $code)->first(); $problem = $discount?->problemFor($subtotal); if ($discount === null || ($problem !== null && $problem !== 'discount_minimum')) { $this->removeCode(); $this->discountRemoved = true; return null; } return new AppliedDiscount($discount, $problem === null ? $discount->amountFor($subtotal) : 0, $problem); } /** * The cart lines, with fresh product details. * Products that are no longer for sale are dropped, and quantities above the stock are lowered. * A line whose variant was removed, or whose product gained or lost its options, is dropped too. * * @return Collection */ public function lines(): Collection { $quantities = $this->quantities(); if ($quantities === []) { return collect(); } $productIds = array_filter(array_map(fn (string $key) => self::parseKey($key)[0] ?? null, array_keys($quantities))); $products = $this->store->products() ->active() ->with(['images', 'variants']) ->whereKey($productIds) ->get() ->keyBy('id'); $kept = []; $lines = collect(); foreach ($quantities as $key => $quantity) { [$productId, $variantId] = self::parseKey($key) ?? [0, null]; $product = $products->get($productId); $variant = $product !== null && $variantId !== null ? $product->variants->firstWhere('id', $variantId) : null; $valid = $product !== null && $product->hasVariants() === ($variant !== null); $stock = $variant !== null ? $variant->stock : ($product !== null ? $product->stock : 0); $allowed = $valid ? min($quantity, $stock, self::MAX_QUANTITY) : 0; if ($allowed !== $quantity) { $this->adjusted = true; } if (! $valid || $allowed < 1) { continue; } $unitPrice = $variant !== null ? $variant->price : $product->price; $kept[$key] = $allowed; $lines->push([ // PHP turns a session key such as "12" into the number 12; the frontend always gets text. 'key' => (string) $key, 'product' => $product, 'variant' => $variant, 'unit_price' => $unitPrice, 'quantity' => $allowed, 'line_total' => $unitPrice * $allowed, ]); } if ($kept !== $quantities) { $this->save($kept); } return $lines; } /** * What the storefront is allowed to see. Money is in ringgit here. * * @return array{count: int, subtotal: float|int, discount: array|null, total: float|int, adjusted: bool, lines: array>} */ public function toStorefront(): array { $lines = $this->lines(); $subtotal = (int) $lines->sum('line_total'); $discount = $lines->isEmpty() ? null : $this->discount($subtotal); $language = $this->store->language->value; return [ 'count' => (int) $lines->sum('quantity'), 'subtotal' => $subtotal / 100, 'discount' => $discount === null ? null : [ 'code' => $discount->code->code, 'label' => $discount->code->label($language), 'amount' => $discount->amount / 100, // Why it does not count yet, for example "Spend at least RM 50.00 ...". 'message' => $discount->problem === null ? null : StorefrontText::line($language, $discount->problem, [ ':amount' => 'RM '.number_format((int) $discount->code->minimum_subtotal / 100, 2), ]), ], // Products after the discount, before shipping. 'total' => ($subtotal - ($discount !== null ? $discount->amount : 0)) / 100, 'adjusted' => $this->adjusted || $this->discountRemoved, 'lines' => $lines->map(fn (array $line) => [ 'key' => $line['key'], 'product' => $line['product']->toStorefront(), 'variant' => $line['variant'] !== null ? ['id' => $line['variant']->id, 'name' => $line['variant']->name()] : null, 'unit_price' => $line['unit_price'] / 100, 'quantity' => $line['quantity'], 'max' => min($line['variant'] !== null ? $line['variant']->stock : $line['product']->stock, self::MAX_QUANTITY), 'line_total' => $line['line_total'] / 100, ])->values()->all(), ]; } /** * @return array Cart line name ("12" or "12-34") to quantity. */ private function quantities(): array { $saved = $this->session->get($this->key(), []); if (! is_array($saved)) { return []; } $clean = []; foreach ($saved as $key => $quantity) { if (self::parseKey((string) $key) !== null && is_int($quantity) && $quantity > 0) { $clean[(string) $key] = $quantity; } } return $clean; } /** * @param array $quantities */ private function save(array $quantities): void { $this->session->put($this->key(), $quantities); } private function key(): string { return 'cart.'.$this->store->id; } private function discountKey(): string { return 'cart_discount.'.$this->store->id; } }