medusa-plugin-ordinant 0.1.0

package/.medusa/server/src/workflows/classify-product.js

@@ -0,0 +1,80 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.classifyProductWorkflow = exports.classifyItemsStep = exports.prepareClassifyItemsStep = void 0;
+const workflows_sdk_1 = require("@medusajs/framework/workflows-sdk");
+const utils_1 = require("@medusajs/framework/utils");
+const ordinant_1 = require("../modules/ordinant");
+/**
+ * prepareClassifyItemsStep maps a Medusa product and its variants into
+ * Ordinant classification inputs. The unit of classification is the variant
+ * SKU — variants without a SKU cannot be gated and are skipped.
+ */
+exports.prepareClassifyItemsStep = (0, workflows_sdk_1.createStep)("ordinant-prepare-classify-items", async (input, { container }) => {
+    const query = container.resolve(utils_1.ContainerRegistrationKeys.QUERY);
+    const { data: products } = await query.graph({
+        entity: "product",
+        fields: [
+            "id",
+            "title",
+            "description",
+            "type.value",
+            "collection.title",
+            "variants.id",
+            "variants.sku",
+            "variants.title",
+            "variants.options.value",
+            "variants.options.option.title",
+        ],
+        filters: { id: input.product_id },
+    });
+    const product = products[0];
+    if (!product) {
+        return new workflows_sdk_1.StepResponse([]);
+    }
+    const items = [];
+    for (const variant of product.variants ?? []) {
+        if (!variant?.sku) {
+            continue;
+        }
+        const specs = {};
+        for (const option of variant.options ?? []) {
+            if (option?.option?.title && option.value) {
+                specs[option.option.title] = option.value;
+            }
+        }
+        items.push({
+            sku: variant.sku,
+            title: variant.title && variant.title !== "Default variant"
+                ? `${product.title} — ${variant.title}`
+                : product.title,
+            description: product.description ?? undefined,
+            product_type: product.type?.value ?? product.collection?.title ?? undefined,
+            specs: Object.keys(specs).length > 0 ? specs : undefined,
+        });
+    }
+    return new workflows_sdk_1.StepResponse(items);
+});
+/**
+ * classifyItemsStep submits the inputs to Ordinant. The result is a set of
+ * PROPOSALS with confidence scores — nothing participates in checkout
+ * decisions until the merchant confirms in the product's Ordinant widget.
+ */
+exports.classifyItemsStep = (0, workflows_sdk_1.createStep)("ordinant-classify-items", async (items, { container }) => {
+    if (items.length === 0) {
+        return new workflows_sdk_1.StepResponse([]);
+    }
+    const ordinant = container.resolve(ordinant_1.ORDINANT_MODULE);
+    const response = await ordinant.client.classifyCatalog(items);
+    return new workflows_sdk_1.StepResponse(response.results);
+});
+/**
+ * classifyProductWorkflow sends a product's variants to Ordinant for
+ * attribute classification. Run from the product.created/updated
+ * subscribers and from the admin widget's "Classify" action.
+ */
+exports.classifyProductWorkflow = (0, workflows_sdk_1.createWorkflow)("ordinant-classify-product", function (input) {
+    const items = (0, exports.prepareClassifyItemsStep)(input);
+    const results = (0, exports.classifyItemsStep)(items);
+    return new workflows_sdk_1.WorkflowResponse(results);
+});
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY2xhc3NpZnktcHJvZHVjdC5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uLy4uL3NyYy93b3JrZmxvd3MvY2xhc3NpZnktcHJvZHVjdC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOzs7QUFBQSxxRUFLMEM7QUFDMUMscURBQXFFO0FBQ3JFLGtEQUFxRDtBQVFyRDs7OztHQUlHO0FBQ1UsUUFBQSx3QkFBd0IsR0FBRyxJQUFBLDBCQUFVLEVBQ2hELGlDQUFpQyxFQUNqQyxLQUFLLEVBQUUsS0FBMkIsRUFBRSxFQUFFLFNBQVMsRUFBRSxFQUFFLEVBQUU7SUFDbkQsTUFBTSxLQUFLLEdBQUcsU0FBUyxDQUFDLE9BQU8sQ0FBQyxpQ0FBeUIsQ0FBQyxLQUFLLENBQUMsQ0FBQTtJQUNoRSxNQUFNLEVBQUUsSUFBSSxFQUFFLFFBQVEsRUFBRSxHQUFHLE1BQU0sS0FBSyxDQUFDLEtBQUssQ0FBQztRQUMzQyxNQUFNLEVBQUUsU0FBUztRQUNqQixNQUFNLEVBQUU7WUFDTixJQUFJO1lBQ0osT0FBTztZQUNQLGFBQWE7WUFDYixZQUFZO1lBQ1osa0JBQWtCO1lBQ2xCLGFBQWE7WUFDYixjQUFjO1lBQ2QsZ0JBQWdCO1lBQ2hCLHdCQUF3QjtZQUN4QiwrQkFBK0I7U0FDaEM7UUFDRCxPQUFPLEVBQUUsRUFBRSxFQUFFLEVBQUUsS0FBSyxDQUFDLFVBQVUsRUFBRTtLQUNsQyxDQUFDLENBQUE7SUFDRixNQUFNLE9BQU8sR0FBRyxRQUFRLENBQUMsQ0FBQyxDQUFDLENBQUE7SUFDM0IsSUFBSSxDQUFDLE9BQU8sRUFBRSxDQUFDO1FBQ2IsT0FBTyxJQUFJLDRCQUFZLENBQWlCLEVBQUUsQ0FBQyxDQUFBO0lBQzdDLENBQUM7SUFFRCxNQUFNLEtBQUssR0FBbUIsRUFBRSxDQUFBO0lBQ2hDLEtBQUssTUFBTSxPQUFPLElBQUksT0FBTyxDQUFDLFFBQVEsSUFBSSxFQUFFLEVBQUUsQ0FBQztRQUM3QyxJQUFJLENBQUMsT0FBTyxFQUFFLEdBQUcsRUFBRSxDQUFDO1lBQ2xCLFNBQVE7UUFDVixDQUFDO1FBQ0QsTUFBTSxLQUFLLEdBQTJCLEVBQUUsQ0FBQTtRQUN4QyxLQUFLLE1BQU0sTUFBTSxJQUFJLE9BQU8sQ0FBQyxPQUFPLElBQUksRUFBRSxFQUFFLENBQUM7WUFDM0MsSUFBSSxNQUFNLEVBQUUsTUFBTSxFQUFFLEtBQUssSUFBSSxNQUFNLENBQUMsS0FBSyxFQUFFLENBQUM7Z0JBQzFDLEtBQUssQ0FBQyxNQUFNLENBQUMsTUFBTSxDQUFDLEtBQUssQ0FBQyxHQUFHLE1BQU0sQ0FBQyxLQUFLLENBQUE7WUFDM0MsQ0FBQztRQUNILENBQUM7UUFDRCxLQUFLLENBQUMsSUFBSSxDQUFDO1lBQ1QsR0FBRyxFQUFFLE9BQU8sQ0FBQyxHQUFHO1lBQ2hCLEtBQUssRUFDSCxPQUFPLENBQUMsS0FBSyxJQUFJLE9BQU8sQ0FBQyxLQUFLLEtBQUssaUJBQWlCO2dCQUNsRCxDQUFDLENBQUMsR0FBRyxPQUFPLENBQUMsS0FBSyxNQUFNLE9BQU8sQ0FBQyxLQUFLLEVBQUU7Z0JBQ3ZDLENBQUMsQ0FBQyxPQUFPLENBQUMsS0FBSztZQUNuQixXQUFXLEVBQUUsT0FBTyxDQUFDLFdBQVcsSUFBSSxTQUFTO1lBQzdDLFlBQVksRUFBRSxPQUFPLENBQUMsSUFBSSxFQUFFLEtBQUssSUFBSSxPQUFPLENBQUMsVUFBVSxFQUFFLEtBQUssSUFBSSxTQUFTO1lBQzNFLEtBQUssRUFBRSxNQUFNLENBQUMsSUFBSSxDQUFDLEtBQUssQ0FBQyxDQUFDLE1BQU0sR0FBRyxDQUFDLENBQUMsQ0FBQyxDQUFDLEtBQUssQ0FBQyxDQUFDLENBQUMsU0FBUztTQUN6RCxDQUFDLENBQUE7SUFDSixDQUFDO0lBQ0QsT0FBTyxJQUFJLDRCQUFZLENBQUMsS0FBSyxDQUFDLENBQUE7QUFDaEMsQ0FBQyxDQUNGLENBQUE7QUFFRDs7OztHQUlHO0FBQ1UsUUFBQSxpQkFBaUIsR0FBRyxJQUFBLDBCQUFVLEVBQ3pDLHlCQUF5QixFQUN6QixLQUFLLEVBQUUsS0FBcUIsRUFBRSxFQUFFLFNBQVMsRUFBRSxFQUFFLEVBQUU7SUFDN0MsSUFBSSxLQUFLLENBQUMsTUFBTSxLQUFLLENBQUMsRUFBRSxDQUFDO1FBQ3ZCLE9BQU8sSUFBSSw0QkFBWSxDQUFtQixFQUFFLENBQUMsQ0FBQTtJQUMvQyxDQUFDO0lBQ0QsTUFBTSxRQUFRLEdBQUcsU0FBUyxDQUFDLE9BQU8sQ0FBd0IsMEJBQWUsQ0FBQyxDQUFBO0lBQzFFLE1BQU0sUUFBUSxHQUFHLE1BQU0sUUFBUSxDQUFDLE1BQU0sQ0FBQyxlQUFlLENBQUMsS0FBSyxDQUFDLENBQUE7SUFDN0QsT0FBTyxJQUFJLDRCQUFZLENBQUMsUUFBUSxDQUFDLE9BQU8sQ0FBQyxDQUFBO0FBQzNDLENBQUMsQ0FDRixDQUFBO0FBRUQ7Ozs7R0FJRztBQUNVLFFBQUEsdUJBQXVCLEdBQUcsSUFBQSw4QkFBYyxFQUNuRCwyQkFBMkIsRUFDM0IsVUFBVSxLQUEyQjtJQUNuQyxNQUFNLEtBQUssR0FBRyxJQUFBLGdDQUF3QixFQUFDLEtBQUssQ0FBQyxDQUFBO0lBQzdDLE1BQU0sT0FBTyxHQUFHLElBQUEseUJBQWlCLEVBQUMsS0FBSyxDQUFDLENBQUE7SUFDeEMsT0FBTyxJQUFJLGdDQUFnQixDQUFDLE9BQU8sQ0FBQyxDQUFBO0FBQ3RDLENBQUMsQ0FDRixDQUFBIn0=

package/.medusa/server/src/workflows/confirm-classification.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.confirmClassificationWorkflow = exports.confirmClassificationStep = void 0;
+const workflows_sdk_1 = require("@medusajs/framework/workflows-sdk");
+const ordinant_1 = require("../modules/ordinant");
+exports.confirmClassificationStep = (0, workflows_sdk_1.createStep)("ordinant-confirm-classification", async (input, { container }) => {
+    const ordinant = container.resolve(ordinant_1.ORDINANT_MODULE);
+    const record = await ordinant.client.confirmClassification(input.sku, input.attributes);
+    return new workflows_sdk_1.StepResponse(record);
+});
+/**
+ * confirmClassificationWorkflow records the merchant's attestation with
+ * Ordinant. From then on, checkout decisions for this SKU resolve the
+ * confirmed attributes server-side.
+ */
+exports.confirmClassificationWorkflow = (0, workflows_sdk_1.createWorkflow)("ordinant-confirm-classification", function (input) {
+    const record = (0, exports.confirmClassificationStep)(input);
+    return new workflows_sdk_1.WorkflowResponse(record);
+});
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY29uZmlybS1jbGFzc2lmaWNhdGlvbi5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uLy4uL3NyYy93b3JrZmxvd3MvY29uZmlybS1jbGFzc2lmaWNhdGlvbi50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOzs7QUFBQSxxRUFLMEM7QUFDMUMsa0RBQXFEO0FBU3hDLFFBQUEseUJBQXlCLEdBQUcsSUFBQSwwQkFBVSxFQUNqRCxpQ0FBaUMsRUFDakMsS0FBSyxFQUFFLEtBQWlDLEVBQUUsRUFBRSxTQUFTLEVBQUUsRUFBRSxFQUFFO0lBQ3pELE1BQU0sUUFBUSxHQUFHLFNBQVMsQ0FBQyxPQUFPLENBQXdCLDBCQUFlLENBQUMsQ0FBQTtJQUMxRSxNQUFNLE1BQU0sR0FBRyxNQUFNLFFBQVEsQ0FBQyxNQUFNLENBQUMscUJBQXFCLENBQ3hELEtBQUssQ0FBQyxHQUFHLEVBQ1QsS0FBSyxDQUFDLFVBQVUsQ0FDakIsQ0FBQTtJQUNELE9BQU8sSUFBSSw0QkFBWSxDQUFDLE1BQU0sQ0FBQyxDQUFBO0FBQ2pDLENBQUMsQ0FDRixDQUFBO0FBRUQ7Ozs7R0FJRztBQUNVLFFBQUEsNkJBQTZCLEdBQUcsSUFBQSw4QkFBYyxFQUN6RCxpQ0FBaUMsRUFDakMsVUFBVSxLQUFpQztJQUN6QyxNQUFNLE1BQU0sR0FBRyxJQUFBLGlDQUF5QixFQUFDLEtBQUssQ0FBQyxDQUFBO0lBQy9DLE9BQU8sSUFBSSxnQ0FBZ0IsQ0FBQyxNQUFNLENBQUMsQ0FBQTtBQUNyQyxDQUFDLENBQ0YsQ0FBQSJ9

package/.medusa/server/src/workflows/generate-skus.js

@@ -0,0 +1,81 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateSkusWorkflow = exports.prepareGeneratedSkusStep = void 0;
+const workflows_sdk_1 = require("@medusajs/framework/workflows-sdk");
+const utils_1 = require("@medusajs/framework/utils");
+const core_flows_1 = require("@medusajs/medusa/core-flows");
+function slug(s) {
+    return s
+        .toUpperCase()
+        .replace(/[^A-Z0-9]+/g, "-")
+        .replace(/^-+|-+$/g, "");
+}
+/**
+ * generateUniqueSku derives a readable SKU from the product and variant
+ * titles (e.g. "Thermal Suppressors N3WTON" / "Quiet" → "THERMAL-SUPPRESSORS-
+ * N3WTON-QUIET"), avoiding collisions with SKUs already in use.
+ */
+function generateUniqueSku(productTitle, variantTitle, used) {
+    const p = slug(productTitle).split("-").filter(Boolean).slice(0, 3).join("-") || "PROD";
+    const v = variantTitle && variantTitle !== "Default variant" ? slug(variantTitle) : "";
+    const base = (v ? `${p}-${v}` : p).slice(0, 48) || "PROD";
+    let sku = base;
+    let i = 1;
+    while (used.has(sku)) {
+        sku = `${base}-${i}`;
+        i++;
+    }
+    return sku;
+}
+/**
+ * prepareGeneratedSkusStep gathers a product's SKU-less variants and assigns
+ * each a unique SKU, checking against every SKU already in the store so a
+ * generated value can never collide.
+ */
+exports.prepareGeneratedSkusStep = (0, workflows_sdk_1.createStep)("ordinant-prepare-generated-skus", async (input, { container }) => {
+    const query = container.resolve(utils_1.ContainerRegistrationKeys.QUERY);
+    const [{ data: products }, { data: allVariants }] = await Promise.all([
+        query.graph({
+            entity: "product",
+            fields: ["id", "title", "variants.id", "variants.sku", "variants.title"],
+            filters: { id: input.product_id },
+        }),
+        query.graph({
+            entity: "product_variant",
+            fields: ["sku"],
+            pagination: { take: 10000, skip: 0 },
+        }),
+    ]);
+    const used = new Set(allVariants.map((v) => v?.sku).filter((s) => Boolean(s)));
+    const product = products[0];
+    const generated = [];
+    for (const variant of product?.variants ?? []) {
+        if (!variant || variant.sku) {
+            continue;
+        }
+        const sku = generateUniqueSku(product.title, variant.title ?? null, used);
+        used.add(sku);
+        generated.push({
+            variant_id: variant.id,
+            variant_title: variant.title ?? null,
+            sku,
+        });
+    }
+    return new workflows_sdk_1.StepResponse(generated);
+});
+/**
+ * generateSkusWorkflow assigns SKUs to a product's SKU-less variants — the
+ * "Generate SKU" helper. It writes them back through the core variant-update
+ * workflow, so a SKU-less product becomes classifiable and sellable in one
+ * click. A product whose variants already all have SKUs is a no-op.
+ */
+exports.generateSkusWorkflow = (0, workflows_sdk_1.createWorkflow)("ordinant-generate-skus", function (input) {
+    const generated = (0, exports.prepareGeneratedSkusStep)(input);
+    // Core variant update keys on `id`; our step returns `variant_id`.
+    const updates = (0, workflows_sdk_1.transform)({ generated }, (data) => data.generated.map((g) => ({ id: g.variant_id, sku: g.sku })));
+    core_flows_1.updateProductVariantsWorkflow.runAsStep({
+        input: { product_variants: updates },
+    });
+    return new workflows_sdk_1.WorkflowResponse(generated);
+});
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZ2VuZXJhdGUtc2t1cy5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uLy4uL3NyYy93b3JrZmxvd3MvZ2VuZXJhdGUtc2t1cy50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOzs7QUFBQSxxRUFNMEM7QUFDMUMscURBQXFFO0FBQ3JFLDREQUEyRTtBQVkzRSxTQUFTLElBQUksQ0FBQyxDQUFTO0lBQ3JCLE9BQU8sQ0FBQztTQUNMLFdBQVcsRUFBRTtTQUNiLE9BQU8sQ0FBQyxhQUFhLEVBQUUsR0FBRyxDQUFDO1NBQzNCLE9BQU8sQ0FBQyxVQUFVLEVBQUUsRUFBRSxDQUFDLENBQUE7QUFDNUIsQ0FBQztBQUVEOzs7O0dBSUc7QUFDSCxTQUFTLGlCQUFpQixDQUN4QixZQUFvQixFQUNwQixZQUEyQixFQUMzQixJQUFpQjtJQUVqQixNQUFNLENBQUMsR0FDTCxJQUFJLENBQUMsWUFBWSxDQUFDLENBQUMsS0FBSyxDQUFDLEdBQUcsQ0FBQyxDQUFDLE1BQU0sQ0FBQyxPQUFPLENBQUMsQ0FBQyxLQUFLLENBQUMsQ0FBQyxFQUFFLENBQUMsQ0FBQyxDQUFDLElBQUksQ0FBQyxHQUFHLENBQUMsSUFBSSxNQUFNLENBQUE7SUFDL0UsTUFBTSxDQUFDLEdBQ0wsWUFBWSxJQUFJLFlBQVksS0FBSyxpQkFBaUIsQ0FBQyxDQUFDLENBQUMsSUFBSSxDQUFDLFlBQVksQ0FBQyxDQUFDLENBQUMsQ0FBQyxFQUFFLENBQUE7SUFDOUUsTUFBTSxJQUFJLEdBQUcsQ0FBQyxDQUFDLENBQUMsQ0FBQyxDQUFDLEdBQUcsQ0FBQyxJQUFJLENBQUMsRUFBRSxDQUFDLENBQUMsQ0FBQyxDQUFDLENBQUMsQ0FBQyxLQUFLLENBQUMsQ0FBQyxFQUFFLEVBQUUsQ0FBQyxJQUFJLE1BQU0sQ0FBQTtJQUN6RCxJQUFJLEdBQUcsR0FBRyxJQUFJLENBQUE7SUFDZCxJQUFJLENBQUMsR0FBRyxDQUFDLENBQUE7SUFDVCxPQUFPLElBQUksQ0FBQyxHQUFHLENBQUMsR0FB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

package/.medusa/server/src/workflows/hooks/validate-cart-completion.js

@@ -0,0 +1,127 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_flows_1 = require("@medusajs/medusa/core-flows");
+const utils_1 = require("@medusajs/framework/utils");
+const ordinant_1 = require("../../modules/ordinant");
+/**
+ * The checkout gate (Ordinant use case U1): before a cart becomes an order,
+ * every line item is checked against the destination's rules. BLOCK or
+ * unmet CONDITIONAL requirements stop completion with a citation-bearing
+ * message the storefront surfaces as an ordinary checkout error — no
+ * storefront changes required.
+ *
+ * Items are sent as bare SKUs: Ordinant resolves the merchant's CONFIRMED
+ * classifications server-side. Unclassified SKUs fail closed by design —
+ * classify the catalog (including non-regulated items as accessories)
+ * before selling through the gate.
+ *
+ * Buyer verification assertions (age verification, FFL routing) can be
+ * supplied by upstream integrations via cart.metadata.ordinant_buyer; the
+ * decision response's `requirement` strings say exactly what is missing.
+ */
+core_flows_1.completeCartWorkflow.hooks.validate(async ({ cart }, { container }) => {
+    const logger = container.resolve("logger");
+    const ordinant = container.resolve(ordinant_1.ORDINANT_MODULE);
+    const address = cart?.shipping_address;
+    const countryCode = (address?.country_code ?? "").toLowerCase();
+    if (countryCode && countryCode !== "us") {
+        // Ordinant coverage is US-only (PRD v1 scope); international carts are
+        // outside the gate's jurisdiction model.
+        logger.warn(`[ordinant] cart ${cart?.id}: non-US destination (${countryCode}) — gate skipped`);
+        return;
+    }
+    const items = [];
+    const skuless = [];
+    for (const item of cart?.items ?? []) {
+        if (!item?.variant_sku) {
+            // A cart line with no SKU cannot be identified, and therefore cannot
+            // be gated. Skipping it would be a silent fail-open on a compliance
+            // gate, so by default it fails closed (skuMode "block"). Merchants who
+            // knowingly sell unregulated SKU-less items opt into skuMode "allow".
+            skuless.push(item?.title ?? item?.id ?? "unknown item");
+            continue;
+        }
+        items.push({
+            sku: item.variant_sku,
+            quantity: item.quantity ?? 1,
+            // Empty attributes: the engine resolves the merchant's confirmed
+            // classification server-side; unclassified SKUs fail closed.
+            attributes: {},
+        });
+    }
+    if (skuless.length > 0 && ordinant.skuMode === "block") {
+        logger.warn(`[ordinant] cart ${cart?.id}: ${skuless.length} item(s) without a SKU — ` +
+            `blocking (skuMode=block): ${skuless.join(", ")}`);
+        throw new utils_1.MedusaError(utils_1.MedusaError.Types.NOT_ALLOWED, `This order cannot be completed: ${skuless.join(", ")} ` +
+            `${skuless.length === 1 ? "has" : "have"} no SKU and cannot be ` +
+            `checked for compliance. Assign a SKU to every product.`);
+    }
+    if (items.length === 0) {
+        return;
+    }
+    const state = (address?.province ?? "").toUpperCase();
+    if (!state) {
+        throw new utils_1.MedusaError(utils_1.MedusaError.Types.INVALID_DATA, "Compliance check requires a shipping address with a US state.");
+    }
+    const buyer = (cart?.metadata?.ordinant_buyer ?? {});
+    let decision;
+    try {
+        decision = await ordinant.client.decide({
+            destination: {
+                state,
+                zip: address?.postal_code ?? undefined,
+                city: address?.city ?? undefined,
+                line1: address?.address_1 ?? undefined,
+            },
+            buyer,
+            items,
+        }, `medusa-cart:${cart.id}`);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        if (ordinant.failMode === "open") {
+            logger.error(`[ordinant] cart ${cart.id}: decision engine unavailable (${message}) — ` +
+                `failMode=open, completing WITHOUT compliance check`);
+            return;
+        }
+        logger.error(`[ordinant] cart ${cart.id}: decision engine unavailable (${message}) — failing closed`);
+        throw new utils_1.MedusaError(utils_1.MedusaError.Types.NOT_ALLOWED, "Compliance check is temporarily unavailable. Please try again shortly.");
+    }
+    if (decision.disposition === "ALLOW") {
+        logger.info(`[ordinant] cart ${cart.id}: ALLOW (decision ${decision.decision_id}, ` +
+            `ruleset ${decision.ruleset_version})`);
+        return;
+    }
+    const problems = [];
+    for (const item of decision.items) {
+        problems.push(...describeItem(item));
+    }
+    logger.warn(`[ordinant] cart ${cart.id}: ${decision.disposition} ` +
+        `(decision ${decision.decision_id}): ${problems.join(" | ")}`);
+    throw new utils_1.MedusaError(utils_1.MedusaError.Types.NOT_ALLOWED, `This order cannot be completed: ${problems.join(" ")}`);
+});
+function describeItem(item) {
+    const out = [];
+    for (const effect of item.effects) {
+        if (effect.satisfied) {
+            continue;
+        }
+        if (effect.fail_closed) {
+            out.push(`${item.sku}: product is not yet classified for compliance ` +
+                `(missing ${effect.unknown_attributes?.join(", ") ?? "attributes"}).`);
+            continue;
+        }
+        const cites = effect.citations.map((c) => c.source).join("; ");
+        if (effect.effect.type === "BLOCK") {
+            out.push(`${item.sku}: ${effect.description} [${cites}].`);
+        }
+        else if (effect.requirement) {
+            out.push(`${item.sku}: ${effect.requirement} [${cites}].`);
+        }
+    }
+    if (out.length === 0 && item.disposition !== "ALLOW") {
+        out.push(`${item.sku}: not permitted for this destination.`);
+    }
+    return out;
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidmFsaWRhdGUtY2FydC1jb21wbGV0aW9uLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vLi4vLi4vc3JjL3dvcmtmbG93cy9ob29rcy92YWxpZGF0ZS1jYXJ0LWNvbXBsZXRpb24udHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6Ijs7QUFBQSw0REFBa0U7QUFDbEUscURBQXVEO0FBQ3ZELHFEQUF3RDtBQUl4RDs7Ozs7Ozs7Ozs7Ozs7O0dBZUc7QUFDSCxpQ0FBb0IsQ0FBQyxLQUFLLENBQUMsUUFBUSxDQUFDLEtBQUssRUFBRSxFQUFFLElBQUksRUFBRSxFQUFFLEVBQUUsU0FBUyxFQUFFLEVBQUUsRUFBRTtJQUNwRSxNQUFNLE1BQU0sR0FBRyxTQUFTLENBQUMsT0FBTyxDQUFDLFFBQVEsQ0FBQyxDQUFBO0lBQzFDLE1BQU0sUUFBUSxHQUFHLFNBQVMsQ0FBQyxPQUFPLENBQXdCLDBCQUFlLENBQUMsQ0FBQTtJQUUxRSxNQUFNLE9BQU8sR0FBRyxJQUFJLEVBQUUsZ0JBQWdCLENBQUE7SUFDdEMsTUFBTSxXQUFXLEdBQUcsQ0FBQyxPQUFPLEVBQUUsWUFBWSxJQUFJLEVBQUUsQ0FBQyxDQUFDLFdBQVcsRUFBRSxDQUFBO0lBQy9ELElBQUksV0FBVyxJQUFJLFdBQVcsS0FBSyxJQUFJLEVBQUUsQ0FBQztRQUN4Qyx1RUFBdUU7UUFDdkUseUNBQXlDO1FBQ3pDLE1BQU0sQ0FBQyxJQUFJLENBQ1QsbUJBQW1CLElBQUksRUFBRSxFQUFFLHlCQUF5QixXQUFXLGtCQUFrQixDQUNsRixDQUFBO1FBQ0QsT0FBTTtJQUNSLENBQUM7SUFFRCxNQUFNLEtBQUssR0FBbUIsRUFBRSxDQUFBO0lBQ2hDLE1BQU0sT0FBTyxHQUFhLEVBQUUsQ0FBQTtJQUM1QixLQUFLLE1BQU0sSUFBSSxJQUFJLElBQUksRUFBRSxLQUFLLElBQUksRUFBRSxFQUFFLENBQUM7UUFDckMsSUFBSSxDQUFDLElBQUksRUFBRSxXQUFXLEVBQUUsQ0FBQztZQUN2QixxRUFB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