metatrondelivery/app/lib/cart-rule-params.ts
metatroncubeswdev a2c78d703f
Some checks failed
CI / Lint, Unit & Integration Tests (push) Has been cancelled
feat: close DS study coverage gaps (inventory exclusion, live checkout re-validation, per-day cap, payment fn, checkout ext)
Audited the implementation against DS_Delivery_Date_Time_App_Study.docx and
closed the actionable gaps (see IMPLEMENTATION_REVIEW_2026-09-04.md).

Core (code + unit tests, 156 green):
- Wire excludeLocationsWithoutStock into resolveAvailabilityRequest; widget
  now sends variantIds so inventory-based location exclusion actually runs.
- Live slot re-validation at checkout: new checkout-snapshot.server.ts writes
  a shop-metafield capacity snapshot; validation-slot's evaluateCheckout
  rejects a complete selection that has since filled / blacked out / closed /
  hit the daily cap / left the schedule. Refreshed on order webhooks and
  slot/blackout/location/enforcement edits.
- Scopable checkout enforcement: Shop.enforcementMode (all|tagged|off) +
  enforcementTag, new app.settings.tsx admin page, honoured via the snapshot.
- Per-day order cap: Location.dailyOrderCap threaded through getAvailability
  (dailyCap + consumedPerDate); admin field on the location screen.
- Product-rule slot blocking: ProductRule.blockedStartMins, unioned in
  resolveProductRuleConstraints, enforced in the engine and resolveHoldRequest;
  admin field on the product rules screen.
- Product-page placement: product-availability.liquid block + widget
  data-mode="preview" (read-only earliest-date line).
- Second locale: datetime-widget fr.json / fr.schema.json.
- Migration 20260904120000_review_gaps (apply with prisma migrate deploy).

New Functions (source + unit tests; need `shopify app deploy` to ship):
- extensions/payment-customization: cart.payment-methods.transform.run — hides
  cash-on-delivery / pay-in-store gateways on SHIPPING orders.
- extensions/checkout-datetime/src: restored from a gitignored dist-only state
  — Plus native picker + Thank you / Order status confirmation blocks, all
  calling the existing checkout.scheduling.* routes (one capacity pool).
  tsconfig ships checkJs:false pending reconciliation with live checkout types.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
2026-09-04 01:31:02 -04:00

40 lines
1.4 KiB
TypeScript

// Shared parsing for the ProductRule-scoping params every scheduling route
// (storefront + POS, availability + hold) accepts identically — kept here so
// the four call sites don't each re-implement the same defensive JSON parsing.
export interface CartLineParam {
vendor?: string;
productType?: string;
}
/** `cartLines` is a JSON-encoded array; malformed/missing input degrades to "no cart info" rather than erroring the request. */
export function parseCartLinesParam(raw: string | null | undefined): CartLineParam[] {
if (!raw) return [];
try {
const parsed = JSON.parse(raw);
if (!Array.isArray(parsed)) return [];
return parsed
.filter((entry): entry is Record<string, unknown> => typeof entry === "object" && entry !== null)
.map((entry) => ({
vendor: typeof entry.vendor === "string" ? entry.vendor : undefined,
productType: typeof entry.productType === "string" ? entry.productType : undefined,
}));
} catch {
return [];
}
}
/** `productIds` is a comma-separated list of Shopify Product GIDs. */
export function parseProductIdsParam(raw: string | null | undefined): string[] {
return parseGidListParam(raw);
}
/** Generic comma-separated Shopify GID list (products, variants, …). */
export function parseGidListParam(raw: string | null | undefined): string[] {
if (!raw) return [];
return raw
.split(",")
.map((id) => id.trim())
.filter(Boolean);
}