@financedistrict/medusa-plugin-agentic-commerce 0.1.0

package/.medusa/server/src/lib/address-translator.js

@@ -0,0 +1,79 @@
+"use strict";
+/**
+ * Bidirectional address translation between Medusa internal format
+ * and protocol-specific formats (ACP, UCP).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.medusaToAcpAddress = medusaToAcpAddress;
+exports.acpAddressToMedusa = acpAddressToMedusa;
+exports.medusaToUcpAddress = medusaToUcpAddress;
+exports.ucpAddressToMedusa = ucpAddressToMedusa;
+// --- Medusa <-> ACP ---
+function medusaToAcpAddress(addr) {
+    const nameParts = [addr.first_name, addr.last_name].filter(Boolean);
+    return {
+        name: nameParts.length > 0 ? nameParts.join(" ") : undefined,
+        line_one: addr.address_1 || undefined,
+        line_two: addr.address_2 || undefined,
+        city: addr.city || undefined,
+        state: addr.province || undefined,
+        postal_code: addr.postal_code || undefined,
+        country: addr.country_code || undefined,
+        phone_number: addr.phone || undefined,
+    };
+}
+function acpAddressToMedusa(addr) {
+    let firstName;
+    let lastName;
+    if (addr.name) {
+        const parts = addr.name.trim().split(/\s+/);
+        firstName = parts[0];
+        lastName = parts.length > 1 ? parts.slice(1).join(" ") : undefined;
+    }
+    return {
+        first_name: firstName,
+        last_name: lastName,
+        address_1: addr.line_one || undefined,
+        address_2: addr.line_two || undefined,
+        city: addr.city || undefined,
+        province: addr.state || undefined,
+        postal_code: addr.postal_code || undefined,
+        country_code: addr.country || undefined,
+        phone: addr.phone_number || undefined,
+    };
+}
+// --- Medusa <-> UCP ---
+function medusaToUcpAddress(addr) {
+    const nameParts = [addr.first_name, addr.last_name].filter(Boolean);
+    return {
+        name: nameParts.length > 0 ? nameParts.join(" ") : undefined,
+        line1: addr.address_1 || undefined,
+        line2: addr.address_2 || undefined,
+        city: addr.city || undefined,
+        state: addr.province || undefined,
+        postal_code: addr.postal_code || undefined,
+        country: addr.country_code || undefined,
+        phone: addr.phone || undefined,
+    };
+}
+function ucpAddressToMedusa(addr) {
+    let firstName;
+    let lastName;
+    if (addr.name) {
+        const parts = addr.name.trim().split(/\s+/);
+        firstName = parts[0];
+        lastName = parts.length > 1 ? parts.slice(1).join(" ") : undefined;
+    }
+    return {
+        first_name: firstName,
+        last_name: lastName,
+        address_1: addr.line1 || undefined,
+        address_2: addr.line2 || undefined,
+        city: addr.city || undefined,
+        province: addr.state || undefined,
+        postal_code: addr.postal_code || undefined,
+        country_code: addr.country || undefined,
+        phone: addr.phone || undefined,
+    };
+}
+//# sourceMappingURL=address-translator.js.map

package/.medusa/server/src/lib/address-translator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"address-translator.js","sourceRoot":"","sources":["../../../../src/lib/address-translator.ts"],"names":[],"mappings":"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"}

package/.medusa/server/src/lib/cart-fields.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Shared cart field constants for query.graph calls.
+ * Used by all checkout session workflows to ensure consistent data loading.
+ */
+export declare const CHECKOUT_SESSION_CART_FIELDS: string[];
+/**
+ * Minimal cart fields for status checks and validation.
+ */
+export declare const CART_VALIDATION_FIELDS: string[];
+//# sourceMappingURL=cart-fields.d.ts.map

package/.medusa/server/src/lib/cart-fields.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cart-fields.d.ts","sourceRoot":"","sources":["../../../../src/lib/cart-fields.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,4BAA4B,UAmBxC,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,sBAAsB,UAUlC,CAAA"}

package/.medusa/server/src/lib/cart-fields.js

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CART_VALIDATION_FIELDS = exports.CHECKOUT_SESSION_CART_FIELDS = void 0;
+/**
+ * Shared cart field constants for query.graph calls.
+ * Used by all checkout session workflows to ensure consistent data loading.
+ */
+exports.CHECKOUT_SESSION_CART_FIELDS = [
+    "id",
+    "region_id",
+    "currency_code",
+    "email",
+    "completed_at",
+    "metadata",
+    "subtotal",
+    "total",
+    "tax_total",
+    "shipping_total",
+    "discount_total",
+    "items.*",
+    "items.variant.*",
+    "items.variant.product.*",
+    "shipping_address.*",
+    "shipping_methods.*",
+    "payment_collection.*",
+    "payment_collection.payment_sessions.*",
+];
+/**
+ * Minimal cart fields for status checks and validation.
+ */
+exports.CART_VALIDATION_FIELDS = [
+    "id",
+    "email",
+    "completed_at",
+    "metadata",
+    "items.id",
+    "shipping_address.id",
+    "shipping_methods.id",
+    "payment_collection.id",
+    "payment_collection.payment_sessions.*",
+];
+//# sourceMappingURL=cart-fields.js.map

package/.medusa/server/src/lib/cart-fields.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cart-fields.js","sourceRoot":"","sources":["../../../../src/lib/cart-fields.ts"],"names":[],"mappings":";;;AAAA;;;GAGG;AACU,QAAA,4BAA4B,GAAG;IAC1C,IAAI;IACJ,WAAW;IACX,eAAe;IACf,OAAO;IACP,cAAc;IACd,UAAU;IACV,UAAU;IACV,OAAO;IACP,WAAW;IACX,gBAAgB;IAChB,gBAAgB;IAChB,SAAS;IACT,iBAAiB;IACjB,yBAAyB;IACzB,oBAAoB;IACpB,oBAAoB;IACpB,sBAAsB;IACtB,uCAAuC;CACxC,CAAA;AAED;;GAEG;AACU,QAAA,sBAAsB,GAAG;IACpC,IAAI;IACJ,OAAO;IACP,cAAc;IACd,UAAU;IACV,UAAU;IACV,qBAAqB;IACrB,qBAAqB;IACrB,uBAAuB;IACvB,uCAAuC;CACxC,CAAA"}

package/.medusa/server/src/lib/error-formatters.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Protocol-specific error response formatters.
+ * Each protocol has a different error response schema.
+ */
+export type AcpErrorType = "invalid_request" | "processing_error" | "service_unavailable";
+export type AcpErrorResponse = {
+    type: AcpErrorType;
+    code: string;
+    message: string;
+    param?: string;
+};
+export declare function formatAcpError(params: {
+    type?: AcpErrorType;
+    code: string;
+    message: string;
+    param?: string;
+    httpStatus?: number;
+}): AcpErrorResponse;
+export declare function httpStatusToAcpType(status: number): AcpErrorType;
+export type UcpErrorResponse = {
+    ucp: {
+        version: string;
+        status: "error";
+    };
+    messages: {
+        type: "error";
+        code: string;
+        content: string;
+        severity: string;
+    }[];
+};
+export declare function formatUcpError(params: {
+    ucpVersion: string;
+    code: string;
+    content: string;
+    severity?: string;
+}): UcpErrorResponse;
+//# sourceMappingURL=error-formatters.d.ts.map

package/.medusa/server/src/lib/error-formatters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-formatters.d.ts","sourceRoot":"","sources":["../../../../src/lib/error-formatters.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,MAAM,MAAM,YAAY,GAAG,iBAAiB,GAAG,kBAAkB,GAAG,qBAAqB,CAAA;AAEzF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,IAAI,EAAE,YAAY,CAAA;IAClB,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,CAAC,EAAE,MAAM,CAAA;CACf,CAAA;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE;IACrC,IAAI,CAAC,EAAE,YAAY,CAAA;IACnB,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB,GAAG,gBAAgB,CAQnB;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY,CAIhE;AAKD,MAAM,MAAM,gBAAgB,GAAG;IAC7B,GAAG,EAAE;QACH,OAAO,EAAE,MAAM,CAAA;QACf,MAAM,EAAE,OAAO,CAAA;KAChB,CAAA;IACD,QAAQ,EAAE;QACR,IAAI,EAAE,OAAO,CAAA;QACb,IAAI,EAAE,MAAM,CAAA;QACZ,OAAO,EAAE,MAAM,CAAA;QACf,QAAQ,EAAE,MAAM,CAAA;KACjB,EAAE,CAAA;CACJ,CAAA;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE;IACrC,UAAU,EAAE,MAAM,CAAA;IAClB,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB,GAAG,gBAAgB,CAenB"}

package/.medusa/server/src/lib/error-formatters.js

@@ -0,0 +1,42 @@
+"use strict";
+/**
+ * Protocol-specific error response formatters.
+ * Each protocol has a different error response schema.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatAcpError = formatAcpError;
+exports.httpStatusToAcpType = httpStatusToAcpType;
+exports.formatUcpError = formatUcpError;
+function formatAcpError(params) {
+    const type = params.type || httpStatusToAcpType(params.httpStatus || 500);
+    return {
+        type,
+        code: params.code,
+        message: params.message,
+        ...(params.param ? { param: params.param } : {}),
+    };
+}
+function httpStatusToAcpType(status) {
+    if (status >= 400 && status < 500)
+        return "invalid_request";
+    if (status === 503)
+        return "service_unavailable";
+    return "processing_error";
+}
+function formatUcpError(params) {
+    return {
+        ucp: {
+            version: params.ucpVersion,
+            status: "error",
+        },
+        messages: [
+            {
+                type: "error",
+                code: params.code,
+                content: params.content,
+                severity: params.severity || "error",
+            },
+        ],
+    };
+}
+//# sourceMappingURL=error-formatters.js.map

package/.medusa/server/src/lib/error-formatters.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-formatters.js","sourceRoot":"","sources":["../../../../src/lib/error-formatters.ts"],"names":[],"mappings":";AAAA;;;GAGG;;AAcH,wCAcC;AAED,kDAIC;AAkBD,wCAoBC;AA1DD,SAAgB,cAAc,CAAC,MAM9B;IACC,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,IAAI,mBAAmB,CAAC,MAAM,CAAC,UAAU,IAAI,GAAG,CAAC,CAAA;IACzE,OAAO;QACL,IAAI;QACJ,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACjD,CAAA;AACH,CAAC;AAED,SAAgB,mBAAmB,CAAC,MAAc;IAChD,IAAI,MAAM,IAAI,GAAG,IAAI,MAAM,GAAG,GAAG;QAAE,OAAO,iBAAiB,CAAA;IAC3D,IAAI,MAAM,KAAK,GAAG;QAAE,OAAO,qBAAqB,CAAA;IAChD,OAAO,kBAAkB,CAAA;AAC3B,CAAC;AAkBD,SAAgB,cAAc,CAAC,MAK9B;IACC,OAAO;QACL,GAAG,EAAE;YACH,OAAO,EAAE,MAAM,CAAC,UAAU;YAC1B,MAAM,EAAE,OAAO;SAChB;QACD,QAAQ,EAAE;YACR;gBACE,IAAI,EAAE,OAAO;gBACb,IAAI,EAAE,MAAM,CAAC,IAAI;gBACjB,OAAO,EAAE,MAAM,CAAC,OAAO;gBACvB,QAAQ,EAAE,MAAM,CAAC,QAAQ,IAAI,OAAO;aACrC;SACF;KACF,CAAA;AACH,CAAC"}

package/.medusa/server/src/lib/formatters/acp.d.ts

@@ -0,0 +1,108 @@
+/**
+ * ACP Protocol Formatter
+ *
+ * Transforms Medusa internal objects into ACP-compliant response shapes.
+ * Spec: https://developers.fd.xyz/acp
+ */
+import type { FormatterContext } from "./types";
+export declare function formatAcpCheckoutSession(ctx: FormatterContext, cart: any, baseUrl: string): {
+    id: any;
+    status: string;
+    currency: any;
+    capabilities: {
+        payment: {
+            handlers: unknown[];
+        };
+    };
+    line_items: any;
+    totals: {
+        type: string;
+        display_text: string;
+        amount: number;
+    }[];
+    fulfillment_details: {
+        name: string | undefined;
+        email: any;
+        phone_number: any;
+        address: import("../address-translator").AcpAddress;
+    } | null;
+    fulfillment_options: any;
+    messages: {
+        type: "info";
+        content_type: string;
+        content: string;
+    }[];
+    links: {
+        type: string;
+        url: string;
+    }[];
+};
+export declare function formatAcpCompleteResponse(ctx: FormatterContext, cart: any, baseUrl: string, orderId: string | null, cartId: string): {
+    status: string;
+    order: {
+        id: string;
+        checkout_session_id: string;
+        permalink_url: string;
+    } | null;
+    id: any;
+    currency: any;
+    capabilities: {
+        payment: {
+            handlers: unknown[];
+        };
+    };
+    line_items: any;
+    totals: {
+        type: string;
+        display_text: string;
+        amount: number;
+    }[];
+    fulfillment_details: {
+        name: string | undefined;
+        email: any;
+        phone_number: any;
+        address: import("../address-translator").AcpAddress;
+    } | null;
+    fulfillment_options: any;
+    messages: {
+        type: "info";
+        content_type: string;
+        content: string;
+    }[];
+    links: {
+        type: string;
+        url: string;
+    }[];
+};
+export declare function formatAcpOrder(ctx: FormatterContext, order: any, baseUrl: string): {
+    id: any;
+    display_id: any;
+    checkout_session_id: any;
+    permalink_url: string;
+    status: any;
+    currency: any;
+    email: any;
+    line_items: any;
+    fulfillment_details: {
+        name: string | undefined;
+        email: any;
+        address: import("../address-translator").AcpAddress;
+    } | null;
+    totals: {
+        type: string;
+        display_text: string;
+        amount: number;
+    }[];
+    created_at: any;
+    updated_at: any;
+    messages: {
+        type: string;
+        content_type: string;
+        content: string;
+    }[];
+    links: {
+        type: string;
+        url: string;
+    }[];
+};
+//# sourceMappingURL=acp.d.ts.map

package/.medusa/server/src/lib/formatters/acp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"acp.d.ts","sourceRoot":"","sources":["../../../../../src/lib/formatters/acp.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAA;AAO/C,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,gBAAgB,EAAE,IAAI,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAsEzF;AAMD,wBAAgB,yBAAyB,CACvC,GAAG,EAAE,gBAAgB,EAAE,IAAI,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,EAAE,MAAM,EAAE,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAc1F;AAMD,wBAAgB,cAAc,CAAC,GAAG,EAAE,gBAAgB,EAAE,KAAK,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAyDhF"}

package/.medusa/server/src/lib/formatters/acp.js

@@ -0,0 +1,158 @@
+"use strict";
+/**
+ * ACP Protocol Formatter
+ *
+ * Transforms Medusa internal objects into ACP-compliant response shapes.
+ * Spec: https://developers.fd.xyz/acp
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatAcpCheckoutSession = formatAcpCheckoutSession;
+exports.formatAcpCompleteResponse = formatAcpCompleteResponse;
+exports.formatAcpOrder = formatAcpOrder;
+const address_translator_1 = require("../address-translator");
+const status_maps_1 = require("../status-maps");
+const types_1 = require("./types");
+// =====================================================
+// Checkout Session
+// =====================================================
+function formatAcpCheckoutSession(ctx, cart, baseUrl) {
+    const currency = cart.currency_code || "eur";
+    const status = (0, status_maps_1.resolveAcpStatus)(cart);
+    const lineItems = (cart.items || []).map((item) => {
+        const unitAmount = (0, types_1.toMinor)(item.unit_price ?? item.raw_unit_price?.value ?? 0);
+        return {
+            id: item.id,
+            item: {
+                id: item.variant_id || item.id,
+                title: item.title || item.product_title || "",
+                price: { amount: unitAmount, currency },
+            },
+            quantity: item.quantity,
+            name: item.title || item.product_title || "",
+            unit_amount: unitAmount,
+            availability_status: "available",
+            totals: [
+                { type: "line_total", amount: unitAmount * item.quantity },
+            ],
+        };
+    });
+    const totals = [
+        { type: "subtotal", display_text: "Subtotal", amount: (0, types_1.toMinor)(cart.subtotal ?? cart.raw_subtotal?.value ?? 0) },
+        { type: "fulfillment", display_text: "Shipping", amount: (0, types_1.toMinor)(cart.shipping_total ?? cart.raw_shipping_total?.value ?? 0) },
+        { type: "tax", display_text: "Tax", amount: (0, types_1.toMinor)(cart.tax_total ?? cart.raw_tax_total?.value ?? 0) },
+        { type: "discount", display_text: "Discount", amount: (0, types_1.toMinor)(cart.discount_total ?? cart.raw_discount_total?.value ?? 0) },
+        { type: "total", display_text: "Total", amount: (0, types_1.toMinor)(cart.total ?? cart.raw_total?.value ?? 0) },
+    ];
+    const fulfillmentDetails = cart.shipping_address
+        ? {
+            name: [cart.shipping_address.first_name, cart.shipping_address.last_name].filter(Boolean).join(" ") || undefined,
+            email: cart.email || undefined,
+            phone_number: cart.shipping_address.phone || undefined,
+            address: (0, address_translator_1.medusaToAcpAddress)(cart.shipping_address),
+        }
+        : null;
+    const fulfillmentOptions = (cart.shipping_methods || []).map((sm) => ({
+        id: sm.id,
+        type: "shipping",
+        title: sm.name || sm.shipping_option?.name || "Standard Shipping",
+        totals: [
+            { type: "fulfillment", amount: (0, types_1.toMinor)(sm.amount ?? sm.raw_amount?.value ?? 0) },
+        ],
+    }));
+    return {
+        id: cart.id,
+        status,
+        currency,
+        capabilities: {
+            payment: {
+                handlers: ctx.paymentHandlers.getAcpCheckoutHandlers(cart.metadata),
+            },
+        },
+        line_items: lineItems,
+        totals,
+        fulfillment_details: fulfillmentDetails,
+        fulfillment_options: fulfillmentOptions,
+        messages: [
+            { type: "info", content_type: "text/plain", content: `Checkout session for ${ctx.storeName}` },
+        ],
+        links: [
+            { type: "terms_of_use", url: `${ctx.storefrontUrl}/terms` },
+            { type: "privacy_policy", url: `${ctx.storefrontUrl}/privacy` },
+        ],
+    };
+}
+// =====================================================
+// Checkout Complete Response
+// =====================================================
+function formatAcpCompleteResponse(ctx, cart, baseUrl, orderId, cartId) {
+    const session = formatAcpCheckoutSession(ctx, cart, baseUrl);
+    return {
+        ...session,
+        status: "completed",
+        order: orderId
+            ? {
+                id: orderId,
+                checkout_session_id: cartId,
+                permalink_url: `${ctx.storefrontUrl}/orders/${orderId}`,
+            }
+            : null,
+    };
+}
+// =====================================================
+// Order
+// =====================================================
+function formatAcpOrder(ctx, order, baseUrl) {
+    const currency = order.currency_code || "eur";
+    const lineItems = (order.items || []).map((item) => {
+        const unitAmount = (0, types_1.toMinor)(item.unit_price ?? item.raw_unit_price?.value ?? 0);
+        return {
+            id: item.id,
+            item: {
+                id: item.variant_id || item.variant?.id || item.id,
+                title: item.title || item.product_title || "",
+                price: { amount: unitAmount, currency },
+            },
+            quantity: item.quantity,
+            name: item.title || item.product_title || "",
+            unit_amount: unitAmount,
+            totals: [
+                { type: "line_total", amount: unitAmount * item.quantity },
+            ],
+        };
+    });
+    const totals = [
+        { type: "subtotal", display_text: "Subtotal", amount: (0, types_1.toMinor)(order.subtotal ?? order.raw_subtotal?.value ?? 0) },
+        { type: "fulfillment", display_text: "Shipping", amount: (0, types_1.toMinor)(order.shipping_total ?? order.raw_shipping_total?.value ?? 0) },
+        { type: "tax", display_text: "Tax", amount: (0, types_1.toMinor)(order.tax_total ?? order.raw_tax_total?.value ?? 0) },
+        { type: "discount", display_text: "Discount", amount: (0, types_1.toMinor)(order.discount_total ?? order.raw_discount_total?.value ?? 0) },
+        { type: "total", display_text: "Total", amount: (0, types_1.toMinor)(order.total ?? order.raw_total?.value ?? 0) },
+    ];
+    const fulfillmentDetails = order.shipping_address
+        ? {
+            name: [order.shipping_address.first_name, order.shipping_address.last_name].filter(Boolean).join(" ") || undefined,
+            email: order.email || undefined,
+            address: (0, address_translator_1.medusaToAcpAddress)(order.shipping_address),
+        }
+        : null;
+    return {
+        id: order.id,
+        display_id: order.display_id || null,
+        checkout_session_id: order.cart_id || null,
+        permalink_url: `${ctx.storefrontUrl}/orders/${order.id}`,
+        status: order.status || "pending",
+        currency,
+        email: order.email || null,
+        line_items: lineItems,
+        fulfillment_details: fulfillmentDetails,
+        totals,
+        created_at: order.created_at,
+        updated_at: order.updated_at,
+        messages: [
+            { type: "info", content_type: "text/plain", content: `Order ${order.display_id || order.id} from ${ctx.storeName}` },
+        ],
+        links: [
+            { type: "self", url: `${baseUrl}/${order.id}` },
+        ],
+    };
+}
+//# sourceMappingURL=acp.js.map

package/.medusa/server/src/lib/formatters/acp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"acp.js","sourceRoot":"","sources":["../../../../../src/lib/formatters/acp.ts"],"names":[],"mappings":"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"}

package/.medusa/server/src/lib/formatters/types.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Shared types for protocol formatters.
+ *
+ * Formatters transform Medusa internal objects (carts, orders, products)
+ * into ACP or UCP protocol-compliant response shapes. They need store
+ * config and the payment handler service to do this.
+ */
+import type { PaymentHandlerRegistry } from "../payment-handler-registry";
+/** Configuration context passed to all formatters */
+export type FormatterContext = {
+    storeName: string;
+    storefrontUrl: string;
+    ucpVersion: string;
+    acpVersion: string;
+    paymentHandlers: PaymentHandlerRegistry;
+};
+/** Convert Medusa amount (fractional units) to minor units (cents) */
+export declare function toMinor(amount: number): number;
+//# sourceMappingURL=types.d.ts.map

package/.medusa/server/src/lib/formatters/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../src/lib/formatters/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAA;AAEzE,qDAAqD;AACrD,MAAM,MAAM,gBAAgB,GAAG;IAC7B,SAAS,EAAE,MAAM,CAAA;IACjB,aAAa,EAAE,MAAM,CAAA;IACrB,UAAU,EAAE,MAAM,CAAA;IAClB,UAAU,EAAE,MAAM,CAAA;IAClB,eAAe,EAAE,sBAAsB,CAAA;CACxC,CAAA;AAED,sEAAsE;AACtE,wBAAgB,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAE9C"}

package/.medusa/server/src/lib/formatters/types.js

@@ -0,0 +1,15 @@
+"use strict";
+/**
+ * Shared types for protocol formatters.
+ *
+ * Formatters transform Medusa internal objects (carts, orders, products)
+ * into ACP or UCP protocol-compliant response shapes. They need store
+ * config and the payment handler service to do this.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toMinor = toMinor;
+/** Convert Medusa amount (fractional units) to minor units (cents) */
+function toMinor(amount) {
+    return Math.round(amount * 100);
+}
+//# sourceMappingURL=types.js.map

package/.medusa/server/src/lib/formatters/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../../src/lib/formatters/types.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;AAcH,0BAEC;AAHD,sEAAsE;AACtE,SAAgB,OAAO,CAAC,MAAc;IACpC,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,GAAG,CAAC,CAAA;AACjC,CAAC"}