@financedistrict/medusa-plugin-agentic-commerce 0.1.0

package/.medusa/server/src/lib/public-url.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"public-url.js","sourceRoot":"","sources":["../../../../src/lib/public-url.ts"],"names":[],"mappings":";;AAOA,4CAEC;AATD;;;;;;GAMG;AACH,SAAgB,gBAAgB,CAAC,GAAgE;IAC/F,OAAO,OAAO,CAAC,GAAG,CAAC,cAAc,IAAI,GAAG,GAAG,CAAC,QAAQ,MAAM,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAA;AAC7E,CAAC"}

package/.medusa/server/src/lib/status-maps.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Protocol-specific status enum mapping.
+ * Maps from Medusa cart state to each protocol's required status values.
+ */
+export declare function resolveAcpStatus(cart: any): string;
+export declare function resolveUcpStatus(cart: any): string;
+//# sourceMappingURL=status-maps.d.ts.map

package/.medusa/server/src/lib/status-maps.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status-maps.d.ts","sourceRoot":"","sources":["../../../../src/lib/status-maps.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,GAAG,GAAG,MAAM,CAalD;AAKD,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,GAAG,GAAG,MAAM,CAMlD"}

package/.medusa/server/src/lib/status-maps.js

@@ -0,0 +1,43 @@
+"use strict";
+/**
+ * Protocol-specific status enum mapping.
+ * Maps from Medusa cart state to each protocol's required status values.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveAcpStatus = resolveAcpStatus;
+exports.resolveUcpStatus = resolveUcpStatus;
+// --- ACP Status ---
+// Spec values: incomplete, not_ready_for_payment, ready_for_payment, completed, canceled
+function resolveAcpStatus(cart) {
+    // Canceled (via metadata flag)
+    if (cart.metadata?.checkout_session_canceled)
+        return "canceled";
+    // Completed
+    if (cart.completed_at)
+        return "completed";
+    // Payment authorized -> still ready_for_payment in ACP terms
+    if (cart.payment_collection?.status === "authorized")
+        return "ready_for_payment";
+    // Has shipping + address -> ready
+    if (cart.shipping_methods?.length > 0 && cart.shipping_address)
+        return "ready_for_payment";
+    // Has items but missing requirements
+    if (cart.items?.length > 0)
+        return "not_ready_for_payment";
+    // Empty cart
+    return "incomplete";
+}
+// --- UCP Status ---
+// Spec values: incomplete, ready_for_complete, completed, canceled
+function resolveUcpStatus(cart) {
+    if (cart.metadata?.checkout_session_canceled)
+        return "canceled";
+    if (cart.completed_at)
+        return "completed";
+    if (cart.payment_collection?.status === "authorized")
+        return "ready_for_complete";
+    if (cart.shipping_methods?.length > 0 && cart.shipping_address)
+        return "ready_for_complete";
+    return "incomplete";
+}
+//# sourceMappingURL=status-maps.js.map

package/.medusa/server/src/lib/status-maps.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"status-maps.js","sourceRoot":"","sources":["../../../../src/lib/status-maps.ts"],"names":[],"mappings":";AAAA;;;GAGG;;AAKH,4CAaC;AAKD,4CAMC;AA3BD,qBAAqB;AACrB,yFAAyF;AAEzF,SAAgB,gBAAgB,CAAC,IAAS;IACxC,+BAA+B;IAC/B,IAAI,IAAI,CAAC,QAAQ,EAAE,yBAAyB;QAAE,OAAO,UAAU,CAAA;IAC/D,YAAY;IACZ,IAAI,IAAI,CAAC,YAAY;QAAE,OAAO,WAAW,CAAA;IACzC,6DAA6D;IAC7D,IAAI,IAAI,CAAC,kBAAkB,EAAE,MAAM,KAAK,YAAY;QAAE,OAAO,mBAAmB,CAAA;IAChF,kCAAkC;IAClC,IAAI,IAAI,CAAC,gBAAgB,EAAE,MAAM,GAAG,CAAC,IAAI,IAAI,CAAC,gBAAgB;QAAE,OAAO,mBAAmB,CAAA;IAC1F,qCAAqC;IACrC,IAAI,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,CAAC;QAAE,OAAO,uBAAuB,CAAA;IAC1D,aAAa;IACb,OAAO,YAAY,CAAA;AACrB,CAAC;AAED,qBAAqB;AACrB,mEAAmE;AAEnE,SAAgB,gBAAgB,CAAC,IAAS;IACxC,IAAI,IAAI,CAAC,QAAQ,EAAE,yBAAyB;QAAE,OAAO,UAAU,CAAA;IAC/D,IAAI,IAAI,CAAC,YAAY;QAAE,OAAO,WAAW,CAAA;IACzC,IAAI,IAAI,CAAC,kBAAkB,EAAE,MAAM,KAAK,YAAY;QAAE,OAAO,oBAAoB,CAAA;IACjF,IAAI,IAAI,CAAC,gBAAgB,EAAE,MAAM,GAAG,CAAC,IAAI,IAAI,CAAC,gBAAgB;QAAE,OAAO,oBAAoB,CAAA;IAC3F,OAAO,YAAY,CAAA;AACrB,CAAC"}

package/.medusa/server/src/modules/agentic-commerce/index.d.ts

@@ -0,0 +1,7 @@
+import AgenticCommerceService from "./service";
+export declare const AGENTIC_COMMERCE_MODULE = "agenticCommerce";
+declare const _default: import("@medusajs/types").ModuleExports<typeof AgenticCommerceService> & {
+    linkable: Record<string, any>;
+};
+export default _default;
+//# sourceMappingURL=index.d.ts.map

package/.medusa/server/src/modules/agentic-commerce/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/modules/agentic-commerce/index.ts"],"names":[],"mappings":"AACA,OAAO,sBAAsB,MAAM,WAAW,CAAA;AAE9C,eAAO,MAAM,uBAAuB,oBAAoB,CAAA;;;;AAExD,wBAEE"}

package/.medusa/server/src/modules/agentic-commerce/index.js

@@ -0,0 +1,13 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AGENTIC_COMMERCE_MODULE = void 0;
+const utils_1 = require("@medusajs/framework/utils");
+const service_1 = __importDefault(require("./service"));
+exports.AGENTIC_COMMERCE_MODULE = "agenticCommerce";
+exports.default = (0, utils_1.Module)(exports.AGENTIC_COMMERCE_MODULE, {
+    service: service_1.default,
+});
+//# sourceMappingURL=index.js.map

package/.medusa/server/src/modules/agentic-commerce/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/modules/agentic-commerce/index.ts"],"names":[],"mappings":";;;;;;AAAA,qDAAkD;AAClD,wDAA8C;AAEjC,QAAA,uBAAuB,GAAG,iBAAiB,CAAA;AAExD,kBAAe,IAAA,cAAM,EAAC,+BAAuB,EAAE;IAC7C,OAAO,EAAE,iBAAsB;CAChC,CAAC,CAAA"}

package/.medusa/server/src/modules/agentic-commerce/service.d.ts

@@ -0,0 +1,294 @@
+/**
+ * Agentic Commerce Service
+ *
+ * Configuration holder and facade for the agentic commerce plugin.
+ * Resolved from the Medusa container as "agenticCommerce".
+ *
+ * Responsibilities:
+ * - Store configuration (name, URL, versions)
+ * - Auth: API key validation, HMAC signing/verification
+ * - Formatting: delegates to protocol-specific formatters (src/lib/formatters/)
+ * - Payment: delegates to PaymentHandlerRegistry with pluggable adapters
+ * - Webhooks: event dispatch to registered URLs
+ */
+import { PaymentHandlerRegistry } from "../../lib/payment-handler-registry";
+export type AgenticCommerceOptions = {
+    signatureKey?: string;
+    storefront_url?: string;
+    store_name?: string;
+    store_description?: string;
+    api_key?: string;
+    payment_provider_id?: string;
+    ucp_version?: string;
+    acp_version?: string;
+    /**
+     * Container service names of PaymentHandlerAdapter implementations.
+     * Each name must match a Medusa module registered by a payment handler plugin.
+     *
+     * Example: ["prismPaymentHandler"]
+     *
+     * The referenced modules must implement the PaymentHandlerAdapter interface from
+     * @financedistrict/medusa-plugin-agentic-commerce.
+     */
+    payment_handler_adapters?: string[];
+};
+export default class AgenticCommerceService {
+    private signatureKey;
+    private storefrontUrl;
+    private storeName;
+    private storeDescription;
+    private apiKey;
+    private paymentProviderId;
+    private ucpVersion;
+    private acpVersion;
+    private paymentHandlerRegistry;
+    private ctx;
+    private adapterNames;
+    private adaptersResolved;
+    constructor(_container: Record<string, unknown>, options?: AgenticCommerceOptions);
+    /**
+     * Resolve payment handler adapters from the request-scoped Medusa container.
+     *
+     * Module-scoped containers (passed to the constructor) cannot access other
+     * top-level modules. The request-scoped container (req.scope) has access to
+     * everything, so callers pass it in at request time.
+     *
+     * Idempotent: once adapters are successfully resolved, subsequent calls are
+     * no-ops. If the first attempt fails (zero adapters), retries on next call.
+     */
+    resolveAdapters(scope: {
+        resolve: (name: string) => unknown;
+    }): void;
+    signPayload(payload: string): string;
+    verifySignature(payload: string, signature: string): boolean;
+    validateApiKey(key: string): boolean;
+    formatAcpCheckoutSession(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("../../lib/address-translator").AcpAddress;
+        } | null;
+        fulfillment_options: any;
+        messages: {
+            type: "info";
+            content_type: string;
+            content: string;
+        }[];
+        links: {
+            type: string;
+            url: string;
+        }[];
+    };
+    formatAcpCompleteResponse(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("../../lib/address-translator").AcpAddress;
+        } | null;
+        fulfillment_options: any;
+        messages: {
+            type: "info";
+            content_type: string;
+            content: string;
+        }[];
+        links: {
+            type: string;
+            url: string;
+        }[];
+    };
+    formatAcpOrder(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("../../lib/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;
+        }[];
+    };
+    formatUcpCheckoutSession(cart: any, baseUrl: string): {
+        ucp: Record<string, unknown>;
+        id: any;
+        status: string;
+        currency: any;
+        email: any;
+        line_items: {
+            id: any;
+            item: {
+                id: any;
+                title: any;
+                price: {
+                    amount: number;
+                    currency: string;
+                };
+            };
+            quantity: any;
+            totals: {
+                type: string;
+                amount: number;
+            }[];
+        }[];
+        totals: {
+            type: string;
+            amount: number;
+        }[];
+        fulfillment: {
+            address: import("../../lib/address-translator").UcpAddress;
+            options: any;
+        } | null;
+        messages: {
+            type: "info";
+            code: string;
+            content: string;
+            severity: string;
+        }[];
+        links: {
+            type: string;
+            url: string;
+        }[];
+    };
+    formatUcpCart(cart: any, baseUrl: string): {
+        ucp: Record<string, unknown>;
+        id: any;
+        currency: any;
+        email: any;
+        line_items: {
+            id: any;
+            item: {
+                id: any;
+                title: any;
+                price: {
+                    amount: number;
+                    currency: string;
+                };
+            };
+            quantity: any;
+            totals: {
+                type: string;
+                amount: number;
+            }[];
+        }[];
+        totals: {
+            type: string;
+            amount: number;
+        }[];
+        shipping_address: import("../../lib/address-translator").UcpAddress | null;
+        links: {
+            self: string;
+            checkout: string;
+        };
+    };
+    formatUcpProduct(product: any): {
+        id: any;
+        title: any;
+        description: any;
+        handle: any;
+        categories: any;
+        price_range: {
+            min: {
+                amount: number;
+                currency: any;
+            };
+            max: {
+                amount: number;
+                currency: any;
+            };
+        } | null;
+        variants: any;
+        media: any;
+    };
+    formatUcpOrder(order: any, baseUrl: string): {
+        ucp: Record<string, unknown>;
+        id: any;
+        display_id: any;
+        checkout_id: any;
+        permalink_url: string;
+        status: any;
+        currency: any;
+        email: any;
+        line_items: any;
+        fulfillment: {
+            address: import("../../lib/address-translator").UcpAddress;
+        } | null;
+        totals: {
+            type: string;
+            amount: number;
+        }[];
+        created_at: any;
+        updated_at: any;
+        links: {
+            type: string;
+            url: string;
+        }[];
+    };
+    getStorefrontUrl(): string;
+    getStoreName(): string;
+    getStoreDescription(): string;
+    getPaymentProviderId(): string;
+    getUcpVersion(): string;
+    getAcpVersion(): string;
+    getPaymentHandlerService(): PaymentHandlerRegistry;
+    sendWebhookEvent(params: {
+        url: string;
+        event_type: string;
+        payload: Record<string, unknown>;
+    }): Promise<void>;
+    sendProductFeed(feedXml: string, regionId: string): Promise<void>;
+}
+//# sourceMappingURL=service.d.ts.map

package/.medusa/server/src/modules/agentic-commerce/service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../../../../src/modules/agentic-commerce/service.ts"],"names":[],"mappings":"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"}

package/.medusa/server/src/modules/agentic-commerce/service.js

@@ -0,0 +1,206 @@
+"use strict";
+/**
+ * Agentic Commerce Service
+ *
+ * Configuration holder and facade for the agentic commerce plugin.
+ * Resolved from the Medusa container as "agenticCommerce".
+ *
+ * Responsibilities:
+ * - Store configuration (name, URL, versions)
+ * - Auth: API key validation, HMAC signing/verification
+ * - Formatting: delegates to protocol-specific formatters (src/lib/formatters/)
+ * - Payment: delegates to PaymentHandlerRegistry with pluggable adapters
+ * - Webhooks: event dispatch to registered URLs
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const crypto_1 = __importDefault(require("crypto"));
+const payment_handler_registry_1 = require("../../lib/payment-handler-registry");
+const ucpFormatter = __importStar(require("../../lib/formatters/ucp"));
+const acpFormatter = __importStar(require("../../lib/formatters/acp"));
+class AgenticCommerceService {
+    constructor(_container, options = {}) {
+        this.adaptersResolved = false;
+        this.signatureKey = options.signatureKey || process.env.AGENTIC_COMMERCE_SIGNATURE_KEY || "";
+        this.storefrontUrl = options.storefront_url || process.env.STOREFRONT_URL || "http://localhost:8000";
+        this.storeName = options.store_name || process.env.AGENTIC_STORE_NAME || "My Store";
+        this.storeDescription = options.store_description || process.env.AGENTIC_STORE_DESCRIPTION || "";
+        this.apiKey = options.api_key || process.env.AGENTIC_COMMERCE_API_KEY || "";
+        this.paymentProviderId = options.payment_provider_id || process.env.AGENTIC_PAYMENT_PROVIDER || "pp_system_default";
+        this.ucpVersion = options.ucp_version || "2026-01-11";
+        this.acpVersion = options.acp_version || "2026-01-30";
+        this.paymentHandlerRegistry = new payment_handler_registry_1.PaymentHandlerRegistry();
+        this.adapterNames = options.payment_handler_adapters || [];
+        if (this.adapterNames.length === 0) {
+            console.info("[agentic-commerce] No payment handler adapters configured. Payment handler discovery will return empty results.");
+        }
+        // Shared context passed to all formatters
+        this.ctx = {
+            storeName: this.storeName,
+            storefrontUrl: this.storefrontUrl,
+            ucpVersion: this.ucpVersion,
+            acpVersion: this.acpVersion,
+            paymentHandlers: this.paymentHandlerRegistry,
+        };
+    }
+    /**
+     * Resolve payment handler adapters from the request-scoped Medusa container.
+     *
+     * Module-scoped containers (passed to the constructor) cannot access other
+     * top-level modules. The request-scoped container (req.scope) has access to
+     * everything, so callers pass it in at request time.
+     *
+     * Idempotent: once adapters are successfully resolved, subsequent calls are
+     * no-ops. If the first attempt fails (zero adapters), retries on next call.
+     */
+    resolveAdapters(scope) {
+        if (this.adaptersResolved && this.paymentHandlerRegistry.getAdapterCount() > 0)
+            return;
+        if (this.adapterNames.length === 0)
+            return;
+        this.adaptersResolved = true;
+        for (const name of this.adapterNames) {
+            try {
+                const adapter = scope.resolve(name);
+                if (adapter && typeof adapter.getUcpDiscoveryHandlers === "function") {
+                    this.paymentHandlerRegistry.registerAdapter(adapter);
+                }
+                else {
+                    console.warn(`[agentic-commerce] Service "${name}" does not implement PaymentHandlerAdapter interface`);
+                }
+            }
+            catch (err) {
+                const message = err instanceof Error ? err.message : String(err);
+                console.warn(`[agentic-commerce] Could not resolve payment handler adapter "${name}": ${message}`);
+            }
+        }
+        if (this.adapterNames.length > 0 && this.paymentHandlerRegistry.getAdapterCount() === 0) {
+            console.warn("[agentic-commerce] Configured payment handler adapters could not be resolved. Payment discovery will be empty.");
+        }
+    }
+    // =====================================================
+    // Auth
+    // =====================================================
+    signPayload(payload) {
+        return crypto_1.default
+            .createHmac("sha256", this.signatureKey)
+            .update(payload)
+            .digest("hex");
+    }
+    verifySignature(payload, signature) {
+        const expected = this.signPayload(payload);
+        try {
+            return crypto_1.default.timingSafeEqual(Buffer.from(expected, "hex"), Buffer.from(signature, "hex"));
+        }
+        catch {
+            return false;
+        }
+    }
+    validateApiKey(key) {
+        return key === this.apiKey;
+    }
+    // =====================================================
+    // Formatters — delegate to protocol-specific modules
+    // =====================================================
+    formatAcpCheckoutSession(cart, baseUrl) {
+        return acpFormatter.formatAcpCheckoutSession(this.ctx, cart, baseUrl);
+    }
+    formatAcpCompleteResponse(cart, baseUrl, orderId, cartId) {
+        return acpFormatter.formatAcpCompleteResponse(this.ctx, cart, baseUrl, orderId, cartId);
+    }
+    formatAcpOrder(order, baseUrl) {
+        return acpFormatter.formatAcpOrder(this.ctx, order, baseUrl);
+    }
+    formatUcpCheckoutSession(cart, baseUrl) {
+        return ucpFormatter.formatUcpCheckoutSession(this.ctx, cart, baseUrl);
+    }
+    formatUcpCart(cart, baseUrl) {
+        return ucpFormatter.formatUcpCart(this.ctx, cart, baseUrl);
+    }
+    formatUcpProduct(product) {
+        return ucpFormatter.formatUcpProduct(product);
+    }
+    formatUcpOrder(order, baseUrl) {
+        return ucpFormatter.formatUcpOrder(this.ctx, order, baseUrl);
+    }
+    // =====================================================
+    // Getters
+    // =====================================================
+    getStorefrontUrl() { return this.storefrontUrl; }
+    getStoreName() { return this.storeName; }
+    getStoreDescription() { return this.storeDescription; }
+    getPaymentProviderId() { return this.paymentProviderId; }
+    getUcpVersion() { return this.ucpVersion; }
+    getAcpVersion() { return this.acpVersion; }
+    getPaymentHandlerService() {
+        return this.paymentHandlerRegistry;
+    }
+    // =====================================================
+    // Webhooks
+    // =====================================================
+    async sendWebhookEvent(params) {
+        const body = JSON.stringify({
+            type: params.event_type,
+            data: params.payload,
+        });
+        const signature = this.signPayload(body);
+        const timestamp = new Date().toISOString();
+        try {
+            await fetch(params.url, {
+                method: "POST",
+                headers: {
+                    "Content-Type": "application/json",
+                    "Merchant-Signature": signature,
+                    "Timestamp": timestamp,
+                },
+                body,
+            });
+        }
+        catch {
+            // Best effort — don't throw on webhook failure
+        }
+    }
+    // =====================================================
+    // Product feed (scheduled job)
+    // =====================================================
+    async sendProductFeed(feedXml, regionId) {
+        console.log(`[agentic-commerce] Product feed generated for region ${regionId} (${feedXml.length} bytes)`);
+    }
+}
+exports.default = AgenticCommerceService;
+//# sourceMappingURL=service.js.map

package/.medusa/server/src/modules/agentic-commerce/service.js.map

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

package/.medusa/server/src/subscribers/order-placed-webhook.d.ts

@@ -0,0 +1,16 @@
+import type { SubscriberArgs, SubscriberConfig } from "@medusajs/framework";
+/**
+ * Subscriber that fires when an order is placed.
+ * If the originating cart had an `agent_webhook_url` in metadata
+ * (set during checkout session creation), we notify the agent.
+ *
+ * ACP webhook format:
+ * - Event type: order_create / order_update
+ * - Data: { checkout_session_id, permalink_url, status, refunds[] }
+ * - Timestamp in header, not body
+ */
+export default function orderPlacedWebhookHandler({ event, container, }: SubscriberArgs<{
+    id: string;
+}>): Promise<void>;
+export declare const config: SubscriberConfig;
+//# sourceMappingURL=order-placed-webhook.d.ts.map

package/.medusa/server/src/subscribers/order-placed-webhook.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"order-placed-webhook.d.ts","sourceRoot":"","sources":["../../../../src/subscribers/order-placed-webhook.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAA;AAE3E;;;;;;;;;GASG;AACH,wBAA8B,yBAAyB,CAAC,EACtD,KAAK,EACL,SAAS,GACV,EAAE,cAAc,CAAC;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,CAAC,iBAmEhC;AAED,eAAO,MAAM,MAAM,EAAE,gBAEpB,CAAA"}