medusa-plugin-ordinant 0.1.0 → 0.1.2

package/.medusa/server/src/admin/index.js

@@ -34,6 +34,7 @@ const CATEGORY_FIELDS = {
     "aow",
     "destructive_device",
     "suppressor",
+    "suppressor_part",
     "firearm_part"
   ],
   mag_capacity: [
@@ -53,7 +54,8 @@ const CATEGORY_FIELDS = {
     "short_barreled_shotgun",
     "machine_gun",
     "aow",
-    "suppressor"
+    "suppressor",
+    "suppressor_part"
   ],
   action_type: [
     "handgun",
@@ -139,6 +141,57 @@ function formatValue(value) {
   }
   return labelValue(String(value));
 }
+function CoveragePreview({ attributes }) {
+  const category = typeof attributes["category"] === "string" ? attributes["category"] : void 0;
+  const { data, isFetching, error } = reactQuery.useQuery({
+    queryKey: ["ordinant-coverage", JSON.stringify(attributes)],
+    queryFn: () => sdk.client.fetch("/admin/ordinant/coverage", {
+      method: "POST",
+      body: { attributes }
+    }),
+    enabled: category !== void 0,
+    staleTime: 5 * 60 * 1e3
+  });
+  if (category === void 0) {
+    return null;
+  }
+  if (isFetching && !data) {
+    return /* @__PURE__ */ jsxRuntime.jsx(ui.Text, { size: "xsmall", leading: "compact", className: "text-ui-fg-muted", children: "Checking where this configuration can ship…" });
+  }
+  if (error || !data) {
+    return null;
+  }
+  const blocked = data.blocked ?? [];
+  const conditional = data.conditional ?? [];
+  if (blocked.length === 0 && conditional.length === 0) {
+    return /* @__PURE__ */ jsxRuntime.jsxs(ui.Text, { size: "xsmall", leading: "compact", className: "text-ui-fg-subtle", children: [
+      "Checkout is allowed in all ",
+      data.total_states,
+      " modeled states with this configuration."
+    ] });
+  }
+  return /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "flex flex-col gap-2 rounded-lg border p-3 bg-ui-bg-subtle", children: [
+    blocked.length > 0 && /* @__PURE__ */ jsxRuntime.jsxs("div", { children: [
+      /* @__PURE__ */ jsxRuntime.jsxs(ui.Text, { size: "xsmall", leading: "compact", weight: "plus", className: "text-ui-fg-error", children: [
+        "With this configuration, shipping/checkout will be denied to",
+        " ",
+        blocked.length,
+        " ",
+        blocked.length === 1 ? "state" : "states",
+        ":"
+      ] }),
+      /* @__PURE__ */ jsxRuntime.jsx("div", { className: "flex flex-wrap gap-1 mt-1.5", children: blocked.map((s) => /* @__PURE__ */ jsxRuntime.jsx(ui.Badge, { size: "2xsmall", color: "red", title: s.name, children: s.state }, s.state)) })
+    ] }),
+    conditional.length > 0 && /* @__PURE__ */ jsxRuntime.jsxs("div", { children: [
+      /* @__PURE__ */ jsxRuntime.jsxs(ui.Text, { size: "xsmall", leading: "compact", weight: "plus", className: "text-ui-fg-subtle", children: [
+        "Requires buyer verification (FFL / permit / age) in ",
+        conditional.length,
+        ":"
+      ] }),
+      /* @__PURE__ */ jsxRuntime.jsx("div", { className: "flex flex-wrap gap-1 mt-1.5", children: conditional.map((s) => /* @__PURE__ */ jsxRuntime.jsx(ui.Badge, { size: "2xsmall", color: "orange", title: s.name, children: s.state }, s.state)) })
+    ] })
+  ] });
+}
 function AttributeEditor({
   value,
   onChange
@@ -182,17 +235,20 @@ function AttributeEditor({
       {
         def,
         value: value[def.key],
-        onChange: (v) => set(def.key, v)
+        onChange: (v) => set(def.key, v),
+        extraHint: def.key === "nfa_class" && category === "suppressor_part" ? "For a suppressor component, this is what decides whether it can ship: choose “Suppressor” for the sound-reducing core (baffle, monocore, expansion chamber, outer tube). Choose “None” for external accessories that don't reduce sound (end cap, cover, mount, thread adapter)." : void 0
       },
       def.key
-    ))
+    )),
+    category !== void 0 && /* @__PURE__ */ jsxRuntime.jsx(CoveragePreview, { attributes: value })
   ] });
 }
 const NONE = "__none__";
 function AttributeField({
   def,
   value,
-  onChange
+  onChange,
+  extraHint
 }) {
   return /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "flex flex-col gap-1", children: [
     /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "flex items-center gap-2", children: [
@@ -200,6 +256,7 @@ function AttributeField({
       def.hard_gate && /* @__PURE__ */ jsxRuntime.jsx(ui.Badge, { size: "2xsmall", color: "orange", children: "required" })
     ] }),
     def.description && /* @__PURE__ */ jsxRuntime.jsx(ui.Text, { size: "xsmall", leading: "compact", className: "text-ui-fg-muted", children: def.description }),
+    extraHint && /* @__PURE__ */ jsxRuntime.jsx(ui.Text, { size: "xsmall", leading: "compact", className: "text-ui-fg-subtle", children: extraHint }),
     /* @__PURE__ */ jsxRuntime.jsx(Control, { def, value, onChange })
   ] });
 }

package/.medusa/server/src/admin/index.mjs

@@ -31,6 +31,7 @@ const CATEGORY_FIELDS = {
     "aow",
     "destructive_device",
     "suppressor",
+    "suppressor_part",
     "firearm_part"
   ],
   mag_capacity: [
@@ -50,7 +51,8 @@ const CATEGORY_FIELDS = {
     "short_barreled_shotgun",
     "machine_gun",
     "aow",
-    "suppressor"
+    "suppressor",
+    "suppressor_part"
   ],
   action_type: [
     "handgun",
@@ -136,6 +138,57 @@ function formatValue(value) {
   }
   return labelValue(String(value));
 }
+function CoveragePreview({ attributes }) {
+  const category = typeof attributes["category"] === "string" ? attributes["category"] : void 0;
+  const { data, isFetching, error } = useQuery({
+    queryKey: ["ordinant-coverage", JSON.stringify(attributes)],
+    queryFn: () => sdk.client.fetch("/admin/ordinant/coverage", {
+      method: "POST",
+      body: { attributes }
+    }),
+    enabled: category !== void 0,
+    staleTime: 5 * 60 * 1e3
+  });
+  if (category === void 0) {
+    return null;
+  }
+  if (isFetching && !data) {
+    return /* @__PURE__ */ jsx(Text, { size: "xsmall", leading: "compact", className: "text-ui-fg-muted", children: "Checking where this configuration can ship…" });
+  }
+  if (error || !data) {
+    return null;
+  }
+  const blocked = data.blocked ?? [];
+  const conditional = data.conditional ?? [];
+  if (blocked.length === 0 && conditional.length === 0) {
+    return /* @__PURE__ */ jsxs(Text, { size: "xsmall", leading: "compact", className: "text-ui-fg-subtle", children: [
+      "Checkout is allowed in all ",
+      data.total_states,
+      " modeled states with this configuration."
+    ] });
+  }
+  return /* @__PURE__ */ jsxs("div", { className: "flex flex-col gap-2 rounded-lg border p-3 bg-ui-bg-subtle", children: [
+    blocked.length > 0 && /* @__PURE__ */ jsxs("div", { children: [
+      /* @__PURE__ */ jsxs(Text, { size: "xsmall", leading: "compact", weight: "plus", className: "text-ui-fg-error", children: [
+        "With this configuration, shipping/checkout will be denied to",
+        " ",
+        blocked.length,
+        " ",
+        blocked.length === 1 ? "state" : "states",
+        ":"
+      ] }),
+      /* @__PURE__ */ jsx("div", { className: "flex flex-wrap gap-1 mt-1.5", children: blocked.map((s) => /* @__PURE__ */ jsx(Badge, { size: "2xsmall", color: "red", title: s.name, children: s.state }, s.state)) })
+    ] }),
+    conditional.length > 0 && /* @__PURE__ */ jsxs("div", { children: [
+      /* @__PURE__ */ jsxs(Text, { size: "xsmall", leading: "compact", weight: "plus", className: "text-ui-fg-subtle", children: [
+        "Requires buyer verification (FFL / permit / age) in ",
+        conditional.length,
+        ":"
+      ] }),
+      /* @__PURE__ */ jsx("div", { className: "flex flex-wrap gap-1 mt-1.5", children: conditional.map((s) => /* @__PURE__ */ jsx(Badge, { size: "2xsmall", color: "orange", title: s.name, children: s.state }, s.state)) })
+    ] })
+  ] });
+}
 function AttributeEditor({
   value,
   onChange
@@ -179,17 +232,20 @@ function AttributeEditor({
       {
         def,
         value: value[def.key],
-        onChange: (v) => set(def.key, v)
+        onChange: (v) => set(def.key, v),
+        extraHint: def.key === "nfa_class" && category === "suppressor_part" ? "For a suppressor component, this is what decides whether it can ship: choose “Suppressor” for the sound-reducing core (baffle, monocore, expansion chamber, outer tube). Choose “None” for external accessories that don't reduce sound (end cap, cover, mount, thread adapter)." : void 0
       },
       def.key
-    ))
+    )),
+    category !== void 0 && /* @__PURE__ */ jsx(CoveragePreview, { attributes: value })
   ] });
 }
 const NONE = "__none__";
 function AttributeField({
   def,
   value,
-  onChange
+  onChange,
+  extraHint
 }) {
   return /* @__PURE__ */ jsxs("div", { className: "flex flex-col gap-1", children: [
     /* @__PURE__ */ jsxs("div", { className: "flex items-center gap-2", children: [
@@ -197,6 +253,7 @@ function AttributeField({
       def.hard_gate && /* @__PURE__ */ jsx(Badge, { size: "2xsmall", color: "orange", children: "required" })
     ] }),
     def.description && /* @__PURE__ */ jsx(Text, { size: "xsmall", leading: "compact", className: "text-ui-fg-muted", children: def.description }),
+    extraHint && /* @__PURE__ */ jsx(Text, { size: "xsmall", leading: "compact", className: "text-ui-fg-subtle", children: extraHint }),
     /* @__PURE__ */ jsx(Control, { def, value, onChange })
   ] });
 }

package/.medusa/server/src/api/admin/ordinant/coverage/route.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.POST = POST;
+const ordinant_1 = require("../../../../modules/ordinant");
+/**
+ * POST /admin/ordinant/coverage
+ *
+ * Preview where a proposed classification would be denied. Given an attribute
+ * set, the engine sweeps every modeled jurisdiction and returns the states
+ * where checkout is BLOCKED vs. CONDITIONAL. Powers the editor's "with this
+ * configuration, shipping is denied to…" panel. Non-logging, advisory.
+ */
+async function POST(req, res) {
+    const attributes = req.body?.attributes;
+    if (!attributes || Object.keys(attributes).length === 0) {
+        res.status(400).json({ message: "attributes are required to preview coverage" });
+        return;
+    }
+    const ordinant = req.scope.resolve(ordinant_1.ORDINANT_MODULE);
+    const coverage = await ordinant.client.coverage(attributes);
+    res.json(coverage);
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicm91dGUuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi8uLi8uLi8uLi8uLi9zcmMvYXBpL2FkbWluL29yZGluYW50L2NvdmVyYWdlL3JvdXRlLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7O0FBY0Esb0JBWUM7QUF6QkQsMkRBQThEO0FBSzlEOzs7Ozs7O0dBT0c7QUFDSSxLQUFLLFVBQVUsSUFBSSxDQUN4QixHQUE2QyxFQUM3QyxHQUFtQjtJQUVuQixNQUFNLFVBQVUsR0FBRyxHQUFHLENBQUMsSUFBSSxFQUFFLFVBQVUsQ0FBQTtJQUN2QyxJQUFJLENBQUMsVUFBVSxJQUFJLE1BQU0sQ0FBQyxJQUFJLENBQUMsVUFBVSxDQUFDLENBQUMsTUFBTSxLQUFLLENBQUMsRUFBRSxDQUFDO1FBQ3hELEdBQUcsQ0FBQyxNQUFNLENBQUMsR0FBRyxDQUFDLENBQUMsSUFBSSxDQUFDLEVBQUUsT0FBTyxFQUFFLDZDQUE2QyxFQUFFLENBQUMsQ0FBQTtRQUNoRixPQUFNO0lBQ1IsQ0FBQztJQUNELE1BQU0sUUFBUSxHQUFHLEdBQUcsQ0FBQyxLQUFLLENBQUMsT0FBTyxDQUF3QiwwQkFBZSxDQUFDLENBQUE7SUFDMUUsTUFBTSxRQUFRLEdBQUcsTUFBTSxRQUFRLENBQUMsTUFBTSxDQUFDLFFBQVEsQ0FBQyxVQUFVLENBQUMsQ0FBQTtJQUMzRCxHQUFHLENBQUMsSUFBSSxDQUFDLFFBQVEsQ0FBQyxDQUFBO0FBQ3BCLENBQUMifQ==

package/.medusa/server/src/lib/client.js

@@ -51,6 +51,16 @@ class OrdinantClient {
         }
         return this.call("POST", "/v1/decisions/preview", request, headers);
     }
+    /** Sweep a proposed attribute set across every modeled jurisdiction and
+     * report where checkout would be denied vs. conditionally allowed. Non-
+     * logging — powers the classification editor's "denied to" preview so a
+     * merchant sees the shipping impact of a classification before confirming. */
+    async coverage(attributes, buyer) {
+        return this.call("POST", "/v1/decisions/coverage", {
+            attributes,
+            buyer,
+        });
+    }
     async classifyCatalog(items) {
         // Classification makes one LLM call per item (6-way concurrent
         // server-side); a batch legitimately outlasts the checkout timeout.
@@ -133,4 +143,4 @@ class OrdinantClient {
     }
 }
 exports.OrdinantClient = OrdinantClient;
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY2xpZW50LmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vLi4vc3JjL2xpYi9jbGllbnQudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IjtBQUFBOzs7O0dBSUc7OztBQWtLSCxNQUFhLGdCQUFpQixTQUFRLEtBQUs7SUFJekMsWUFBWSxPQUFlLEVBQUUsSUFBWSxFQUFFLE1BQWU7UUFDeEQsS0FBSyxDQUFDLE9BQU8sQ0FBQyxDQUFBO1FBQ2QsSUFBSSxDQUFDLElBQUksR0FBRyxrQkFBa0IsQ0FBQTtRQUM5QixJQUFJLENBQUMsSUFBSSxHQUFHLElBQUksQ0FBQTtRQUNoQixJQUFJLENBQUMsTUFBTSxHQUFHLE1BQU0sQ0FBQTtJQUN0QixDQUFDO0NBQ0Y7QUFWRCw0Q0FVQztBQWlCRCxNQUFhLGNBQWM7SUFVekIsWUFBWSxPQUE4QjtRQUN4QyxJQUFJLENBQUMsVUFBVSxHQUFHLE9BQU8sQ0FBQyxPQUFPLENBQUMsT0FBTyxJQUFJLE9BQU8sQ0FBQyxNQUFNLENBQUMsQ0FBQTtRQUM1RCxJQUFJLENBQUMsT0FBTyxHQUFHLENBQUMsT0FBTyxDQUFDLE9BQU8sSUFBSSxFQUFFLENBQUMsQ0FBQyxPQUFPLENBQUMsTUFBTSxFQUFFLEVBQUUsQ0FBQyxDQUFBO1FBQzFELElBQUksQ0FBQyxNQUFNLEdBQUcsT0FBTyxDQUFDLE1BQU0sSUFBSSxFQUFFLENBQUE7UUFDbEMsSUFBSSxDQUFDLFNBQVMsR0FBRyxPQUFPLENBQUMsU0FBUyxJQUFJLElBQUksQ0FBQTtRQUMxQyxJQUFJLENBQUMsZ0JBQWdCLEdBQUcsT0FBTyxDQUFDLGdCQUFnQixJQUFJLE9BQU8sQ0FBQTtJQUM3RCxDQUFDO0lBRUQsbUVBQW1FO0lBQ25FLEtBQUssQ0FBQyxVQUFVO1FBQ2QsT0FBTyxJQUFJLENBQUMsSUFBSSxDQUFhLEtBQUssRUFBRSxrQkFBa0IsQ0FBQyxDQUFBO0lBQ3pELENBQUM7SUFFRDtzQ0FDa0M7SUFDbEMsS0FBSyxDQUFDLGNBQWM7UUFDbEIs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
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY2xpZW50LmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vLi4vc3JjL2xpYi9jbGllbnQudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IjtBQUFBOzs7O0dBSUc7OztBQWtLSCxNQUFhLGdCQUFpQixTQUFRLEtBQUs7SUFJekMsWUFBWSxPQUFlLEVBQUUsSUFBWSxFQUFFLE1BQWU7UUFDeEQsS0FBSyxDQUFDLE9BQU8sQ0FBQyxDQUFBO1FBQ2QsSUFBSSxDQUFDLElBQUksR0FBRyxrQkFBa0IsQ0FBQTtRQUM5QixJQUFJLENBQUMsSUFBSSxHQUFHLElBQUksQ0FBQTtRQUNoQixJQUFJLENBQUMsTUFBTSxHQUFHLE1BQU0sQ0FBQTtJQUN0QixDQUFDO0NBQ0Y7QUFWRCw0Q0FVQztBQW9DRCxNQUFhLGNBQWM7SUFVekIsWUFBWSxPQUE4QjtRQUN4QyxJQUFJLENBQUMsVUFBVSxHQUFHLE9BQU8sQ0FBQyxPQUFPLENBQUMsT0FBTyxJQUFJLE9BQU8sQ0FBQyxNQUFNLENBQUMsQ0FBQTtRQUM1RCxJQUFJLENBQUMsT0FBTyxHQUFHLENBQUMsT0FBTyxDQUFDLE9BQU8sSUFBSSxFQUFFLENBQUMsQ0FBQyxPQUFPLENBQUMsTUFBTSxFQUFFLEVBQUUsQ0FBQyxDQUFBO1FBQzFELElBQUksQ0FBQyxNQUFNLEdBQUcsT0FBTyxDQUFDLE1BQU0sSUFBSSxFQUFFLENBQUE7UUFDbEMsSUFBSSxDQUFDLFNBQVMsR0FBRyxPQUFPLENBQUMsU0FBUyxJQUFJLElBQUksQ0FBQTtRQUMxQyxJQUFJLENBQUMsZ0JBQWdCLEdBQUcsT0FBTyxDQUFDLGdCQUFnQixJQUFJLE9BQU8sQ0FBQTtJQUM3RCxDQUFDO0lBRUQsbUVBQW1FO0lBQ25FLEtBQUssQ0FBQyxVQUFVO1FBQ2QsT0FBTyxJQUFJLENBQUMsSUFBSSxDQUFhLEtBQUssRUFBRSxrQkFBa0IsQ0FBQyxDQUFBO0lBQ3pELENBQUM7SUFFRDtzQ0FDa0M7SUFDbEMsS0FBSyxDQUFDLGNBQWM7UUFDbEIs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

package/README.md

@@ -3,6 +3,9 @@
 Ordinant compliance for Medusa v2: AI-proposed product classification with
 merchant attestation, and a deterministic, citation-bearing checkout gate.
 
+Published on npm — install with `npm install medusa-plugin-ordinant`
+([npmjs.com/package/medusa-plugin-ordinant](https://www.npmjs.com/package/medusa-plugin-ordinant)).
+
 > **Ordinant is a compliance information and automation service — not legal
 > advice.** No attorney–client relationship is created by its use. Merchants
 > attest to the final classification of their products.
@@ -245,6 +248,14 @@ dictionary change.
 Re-classifying a SKU (e.g. after a product edit) resets it to `proposed`: a
 stale attestation never survives changed product data.
 
+**Live shipping-impact preview.** While editing a classification, the widget
+shows *"With this configuration, shipping/checkout will be denied to: CA, NY, …"*
+(and a separate "requires FFL/permit/age in …" list), swept across every modeled
+jurisdiction — so you see exactly where a classification will and won't sell
+**before** you attest to it. Fields with subtle legal meaning carry inline
+guidance (e.g. for a suppressor part, `nfa_class` = *Suppressor* for the sound-
+reducing core, *None* for an external accessory like an end cap).
+
 ## The checkout gate
 
 Consumes `completeCartWorkflow.hooks.validate`, which runs before any order
@@ -415,6 +426,52 @@ self-contained function — copy it from `src/storefront.ts` into your codebase
 instead. Either way, anything you don't wire is still caught by the completeCart
 gate; the preview is pure upside.
 
+### Also re-check when the shopper *enters* checkout (defense in depth)
+
+The address-step check catches a bad address as it's entered. But a shopper can
+set a *compliant* address, then add an item that's illegal to their state, and
+walk up to the review step — where the block would otherwise only appear at
+"Place Order". Close that gap by re-checking the **whole cart** when they land on
+(or return to) the checkout page, and bouncing them back to the shipping step if
+it's blocked.
+
+The same preview does it — pass the `cartId` with **no `destination`** and it
+evaluates the cart's saved address against its *current* items server-side:
+
+```ts
+import { checkAddressCompliance } from "medusa-plugin-ordinant/storefront"
+
+// on entering checkout (any storefront):
+const block = await checkAddressCompliance(sdk, { cartId }) // no destination = full current cart
+if (block) {
+  // send them back to the shipping step and show `block`
+}
+```
+
+In the Medusa **Next.js starter**, do it in the checkout page (a server
+component) so the redirect happens before payment/review render:
+
+```tsx
+// src/app/[countryCode]/(checkout)/checkout/page.tsx
+import { getCartComplianceBlock } from "@lib/data/cart" // thin wrapper over the preview
+import { redirect } from "next/navigation"
+
+const complianceBlock = await getCartComplianceBlock(cart.id)
+if (complianceBlock && step !== "address" && step !== "delivery") {
+  redirect(`/${countryCode}/checkout?step=delivery`) // bounce back to shipping
+}
+// ...and render `complianceBlock` as a banner above <CheckoutForm />.
+```
+
+It only redirects when the shopper is *past* the shipping step, and it targets
+the shipping step — so there's no redirect loop, and they can fix the address or
+remove the item. Fail-open, same as the address check.
+
+**The three layers together:** (1) the address step vets the address as it's
+entered, (2) checkout entry re-checks the whole cart, (3) the completeCart gate
+is the non-bypassable backstop at "Place Order". Wire 1 and 2, or neither — 3
+always holds.
+
 ## Onboarding an existing catalog
 
 Products created **after** installation classify automatically. For the

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "medusa-plugin-ordinant",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "Ordinant compliance for Medusa v2: catalog classification with merchant attestation and a deterministic, citation-bearing checkout gate. Compliance information and automation - not legal advice.",
   "author": "Ordinant (https://ordinant.com)",
   "license": "MIT",