@financedistrict/saleor-agentic-commerce-nextjs 0.1.0

package/dist/config.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Agentic Commerce Configuration
+ *
+ * Creates and configures the agentic commerce instance that route handlers
+ * and middleware use. Merchants call createAgenticCommerce() once in their
+ * storefront code and export the instance.
+ */
+import { SaleorClient, PaymentHandlerRegistry, type PaymentHandlerAdapter, type FormatterContext } from "@financedistrict/saleor-agentic-commerce-core";
+export type AgenticCommerceConfig = {
+    /** Saleor GraphQL API URL (e.g., "https://api.store.com/graphql/") */
+    saleorApiUrl: string;
+    /** Saleor App Token with MANAGE_CHECKOUTS, MANAGE_ORDERS permissions */
+    saleorAuthToken: string;
+    /** Default Saleor channel slug */
+    channel?: string;
+    /** Storefront public URL (e.g., "https://store.com") */
+    storefrontUrl: string;
+    /** Store display name */
+    storeName: string;
+    /** Store description */
+    storeDescription?: string;
+    /** UCP protocol version (default: "2026-04-08") */
+    ucpVersion?: string;
+    /** ACP protocol version (default: "2026-01-30") */
+    acpVersion?: string;
+    /** API key for ACP Bearer token authentication */
+    acpApiKey?: string;
+    /** Payment handler adapters to register */
+    paymentHandlers?: PaymentHandlerAdapter[];
+};
+export type AgenticCommerceInstance = {
+    saleorClient: SaleorClient;
+    paymentHandlers: PaymentHandlerRegistry;
+    formatterContext: FormatterContext;
+    config: Required<Pick<AgenticCommerceConfig, "storefrontUrl" | "storeName" | "ucpVersion" | "acpVersion">> & Pick<AgenticCommerceConfig, "storeDescription" | "acpApiKey">;
+};
+export declare function createAgenticCommerce(config: AgenticCommerceConfig): AgenticCommerceInstance;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EACL,YAAY,EACZ,sBAAsB,EACtB,KAAK,qBAAqB,EAC1B,KAAK,gBAAgB,EAEtB,MAAM,+CAA+C,CAAA;AAMtD,MAAM,MAAM,qBAAqB,GAAG;IAClC,sEAAsE;IACtE,YAAY,EAAE,MAAM,CAAA;IACpB,wEAAwE;IACxE,eAAe,EAAE,MAAM,CAAA;IACvB,kCAAkC;IAClC,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,wDAAwD;IACxD,aAAa,EAAE,MAAM,CAAA;IACrB,yBAAyB;IACzB,SAAS,EAAE,MAAM,CAAA;IACjB,wBAAwB;IACxB,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,mDAAmD;IACnD,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,mDAAmD;IACnD,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,kDAAkD;IAClD,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,2CAA2C;IAC3C,eAAe,CAAC,EAAE,qBAAqB,EAAE,CAAA;CAC1C,CAAA;AAMD,MAAM,MAAM,uBAAuB,GAAG;IACpC,YAAY,EAAE,YAAY,CAAA;IAC1B,eAAe,EAAE,sBAAsB,CAAA;IACvC,gBAAgB,EAAE,gBAAgB,CAAA;IAClC,MAAM,EAAE,QAAQ,CAAC,IAAI,CAAC,qBAAqB,EAAE,eAAe,GAAG,WAAW,GAAG,YAAY,GAAG,YAAY,CAAC,CAAC,GACxG,IAAI,CAAC,qBAAqB,EAAE,kBAAkB,GAAG,WAAW,CAAC,CAAA;CAChE,CAAA;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,qBAAqB,GAAG,uBAAuB,CA6C5F"}

package/dist/config.js

@@ -0,0 +1,54 @@
+/**
+ * Agentic Commerce Configuration
+ *
+ * Creates and configures the agentic commerce instance that route handlers
+ * and middleware use. Merchants call createAgenticCommerce() once in their
+ * storefront code and export the instance.
+ */
+import { SaleorClient, PaymentHandlerRegistry, } from "@financedistrict/saleor-agentic-commerce-core";
+export function createAgenticCommerce(config) {
+    // Validate required config
+    if (!config.saleorApiUrl)
+        throw new Error("saleorApiUrl is required");
+    if (!config.saleorAuthToken)
+        throw new Error("saleorAuthToken is required");
+    if (!config.storefrontUrl)
+        throw new Error("storefrontUrl is required");
+    if (!config.storeName)
+        throw new Error("storeName is required");
+    const ucpVersion = config.ucpVersion || "2026-04-08";
+    const acpVersion = config.acpVersion || "2026-01-30";
+    // Create Saleor client
+    const saleorClient = new SaleorClient({
+        apiUrl: config.saleorApiUrl,
+        authToken: config.saleorAuthToken,
+        channel: config.channel,
+    });
+    // Create and populate payment handler registry
+    const paymentHandlers = new PaymentHandlerRegistry();
+    for (const handler of config.paymentHandlers || []) {
+        paymentHandlers.registerAdapter(handler);
+    }
+    // Create formatter context
+    const formatterContext = {
+        storeName: config.storeName,
+        storefrontUrl: config.storefrontUrl,
+        ucpVersion,
+        acpVersion,
+        paymentHandlers,
+    };
+    return {
+        saleorClient,
+        paymentHandlers,
+        formatterContext,
+        config: {
+            storefrontUrl: config.storefrontUrl,
+            storeName: config.storeName,
+            storeDescription: config.storeDescription,
+            ucpVersion,
+            acpVersion,
+            acpApiKey: config.acpApiKey,
+        },
+    };
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EACL,YAAY,EACZ,sBAAsB,GAIvB,MAAM,+CAA+C,CAAA;AAyCtD,MAAM,UAAU,qBAAqB,CAAC,MAA6B;IACjE,2BAA2B;IAC3B,IAAI,CAAC,MAAM,CAAC,YAAY;QAAE,MAAM,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAA;IACrE,IAAI,CAAC,MAAM,CAAC,eAAe;QAAE,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAA;IAC3E,IAAI,CAAC,MAAM,CAAC,aAAa;QAAE,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAA;IACvE,IAAI,CAAC,MAAM,CAAC,SAAS;QAAE,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAA;IAE/D,MAAM,UAAU,GAAG,MAAM,CAAC,UAAU,IAAI,YAAY,CAAA;IACpD,MAAM,UAAU,GAAG,MAAM,CAAC,UAAU,IAAI,YAAY,CAAA;IAEpD,uBAAuB;IACvB,MAAM,YAAY,GAAG,IAAI,YAAY,CAAC;QACpC,MAAM,EAAE,MAAM,CAAC,YAAY;QAC3B,SAAS,EAAE,MAAM,CAAC,eAAe;QACjC,OAAO,EAAE,MAAM,CAAC,OAAO;KACxB,CAAC,CAAA;IAEF,+CAA+C;IAC/C,MAAM,eAAe,GAAG,IAAI,sBAAsB,EAAE,CAAA;IACpD,KAAK,MAAM,OAAO,IAAI,MAAM,CAAC,eAAe,IAAI,EAAE,EAAE,CAAC;QACnD,eAAe,CAAC,eAAe,CAAC,OAAO,CAAC,CAAA;IAC1C,CAAC;IAED,2BAA2B;IAC3B,MAAM,gBAAgB,GAAqB;QACzC,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,aAAa,EAAE,MAAM,CAAC,aAAa;QACnC,UAAU;QACV,UAAU;QACV,eAAe;KAChB,CAAA;IAED,OAAO;QACL,YAAY;QACZ,eAAe;QACf,gBAAgB;QAChB,MAAM,EAAE;YACN,aAAa,EAAE,MAAM,CAAC,aAAa;YACnC,SAAS,EAAE,MAAM,CAAC,SAAS;YAC3B,gBAAgB,EAAE,MAAM,CAAC,gBAAgB;YACzC,UAAU;YACV,UAAU;YACV,SAAS,EAAE,MAAM,CAAC,SAAS;SAC5B;KACF,CAAA;AACH,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * @financedistrict/saleor-agentic-commerce-nextjs
+ *
+ * Drop-in Next.js integration for Saleor agentic commerce.
+ * Provides route handlers, middleware, and configuration.
+ */
+export { createAgenticCommerce } from "./config.js";
+export type { AgenticCommerceConfig, AgenticCommerceInstance } from "./config.js";
+export { createUcpRoutes } from "./routes/ucp-routes.js";
+export { createAcpRoutes } from "./routes/acp-routes.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAA;AACnD,YAAY,EAAE,qBAAqB,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAA;AAEjF,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAA;AACxD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAA"}

package/dist/index.js

@@ -0,0 +1,10 @@
+/**
+ * @financedistrict/saleor-agentic-commerce-nextjs
+ *
+ * Drop-in Next.js integration for Saleor agentic commerce.
+ * Provides route handlers, middleware, and configuration.
+ */
+export { createAgenticCommerce } from "./config.js";
+export { createUcpRoutes } from "./routes/ucp-routes.js";
+export { createAcpRoutes } from "./routes/acp-routes.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAA;AAGnD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAA;AACxD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAA"}

package/dist/middleware/ucp-headers.d.ts

@@ -0,0 +1,39 @@
+/**
+ * UCP Header Middleware
+ *
+ * Parses and validates UCP-specific headers from incoming requests.
+ * Used by route handlers to extract agent profile, request IDs,
+ * and idempotency keys.
+ */
+/**
+ * Parsed UCP request headers.
+ */
+export type UcpRequestHeaders = {
+    /** Agent profile URL from UCP-Agent header */
+    agentProfile: string | null;
+    /** Request ID for tracing */
+    requestId: string | null;
+    /** Idempotency key for state-modifying operations */
+    idempotencyKey: string | null;
+    /** Content digest for body verification */
+    contentDigest: string | null;
+};
+/**
+ * Extract UCP-specific headers from a request.
+ *
+ * UCP-Agent header format: profile="https://agent.example/.well-known/ucp"
+ */
+export declare function parseUcpHeaders(request: Request): UcpRequestHeaders;
+/**
+ * Validate that required UCP headers are present for state-modifying operations.
+ * Returns an error message if validation fails, null if OK.
+ */
+export declare function validateUcpHeaders(headers: UcpRequestHeaders, options?: {
+    requireAgent?: boolean;
+    requireIdempotency?: boolean;
+}): string | null;
+/**
+ * Create standard UCP response headers.
+ */
+export declare function ucpResponseHeaders(requestId?: string | null): Record<string, string>;
+//# sourceMappingURL=ucp-headers.d.ts.map

package/dist/middleware/ucp-headers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ucp-headers.d.ts","sourceRoot":"","sources":["../../src/middleware/ucp-headers.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC9B,8CAA8C;IAC9C,YAAY,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,6BAA6B;IAC7B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,qDAAqD;IACrD,cAAc,EAAE,MAAM,GAAG,IAAI,CAAA;IAC7B,2CAA2C;IAC3C,aAAa,EAAE,MAAM,GAAG,IAAI,CAAA;CAC7B,CAAA;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,iBAAiB,CAgBnE;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,iBAAiB,EAC1B,OAAO,GAAE;IAAE,YAAY,CAAC,EAAE,OAAO,CAAC;IAAC,kBAAkB,CAAC,EAAE,OAAO,CAAA;CAAO,GACrE,MAAM,GAAG,IAAI,CAQf;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAQpF"}

package/dist/middleware/ucp-headers.js

@@ -0,0 +1,53 @@
+/**
+ * UCP Header Middleware
+ *
+ * Parses and validates UCP-specific headers from incoming requests.
+ * Used by route handlers to extract agent profile, request IDs,
+ * and idempotency keys.
+ */
+/**
+ * Extract UCP-specific headers from a request.
+ *
+ * UCP-Agent header format: profile="https://agent.example/.well-known/ucp"
+ */
+export function parseUcpHeaders(request) {
+    const agentHeader = request.headers.get("UCP-Agent");
+    let agentProfile = null;
+    if (agentHeader) {
+        // Parse RFC 8941 Dictionary format: profile="url"
+        const match = agentHeader.match(/profile="([^"]+)"/);
+        agentProfile = match ? match[1] : agentHeader;
+    }
+    return {
+        agentProfile,
+        requestId: request.headers.get("Request-Id") || request.headers.get("X-Request-Id"),
+        idempotencyKey: request.headers.get("Idempotency-Key"),
+        contentDigest: request.headers.get("Content-Digest"),
+    };
+}
+/**
+ * Validate that required UCP headers are present for state-modifying operations.
+ * Returns an error message if validation fails, null if OK.
+ */
+export function validateUcpHeaders(headers, options = {}) {
+    if (options.requireAgent && !headers.agentProfile) {
+        return "UCP-Agent header is required";
+    }
+    if (options.requireIdempotency && !headers.idempotencyKey) {
+        return "Idempotency-Key header is required";
+    }
+    return null;
+}
+/**
+ * Create standard UCP response headers.
+ */
+export function ucpResponseHeaders(requestId) {
+    const headers = {
+        "Content-Type": "application/json",
+    };
+    if (requestId) {
+        headers["Request-Id"] = requestId;
+    }
+    return headers;
+}
+//# sourceMappingURL=ucp-headers.js.map

package/dist/middleware/ucp-headers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ucp-headers.js","sourceRoot":"","sources":["../../src/middleware/ucp-headers.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAgBH;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,OAAgB;IAC9C,MAAM,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,CAAA;IACpD,IAAI,YAAY,GAAkB,IAAI,CAAA;IAEtC,IAAI,WAAW,EAAE,CAAC;QAChB,kDAAkD;QAClD,MAAM,KAAK,GAAG,WAAW,CAAC,KAAK,CAAC,mBAAmB,CAAC,CAAA;QACpD,YAAY,GAAG,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,CAAA;IAC/C,CAAC;IAED,OAAO;QACL,YAAY;QACZ,SAAS,EAAE,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,IAAI,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC;QACnF,cAAc,EAAE,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC;QACtD,aAAa,EAAE,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC;KACrD,CAAA;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAChC,OAA0B,EAC1B,UAAoE,EAAE;IAEtE,IAAI,OAAO,CAAC,YAAY,IAAI,CAAC,OAAO,CAAC,YAAY,EAAE,CAAC;QAClD,OAAO,8BAA8B,CAAA;IACvC,CAAC;IACD,IAAI,OAAO,CAAC,kBAAkB,IAAI,CAAC,OAAO,CAAC,cAAc,EAAE,CAAC;QAC1D,OAAO,oCAAoC,CAAA;IAC7C,CAAC;IACD,OAAO,IAAI,CAAA;AACb,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,SAAyB;IAC1D,MAAM,OAAO,GAA2B;QACtC,cAAc,EAAE,kBAAkB;KACnC,CAAA;IACD,IAAI,SAAS,EAAE,CAAC;QACd,OAAO,CAAC,YAAY,CAAC,GAAG,SAAS,CAAA;IACnC,CAAC;IACD,OAAO,OAAO,CAAA;AAChB,CAAC"}

package/dist/routes/acp-routes.d.ts

@@ -0,0 +1,62 @@
+/**
+ * ACP Route Handlers
+ *
+ * Creates Next.js App Router route handlers for all ACP endpoints.
+ * Based on ACP spec version 2026-01-30.
+ * https://github.com/agentic-commerce-protocol/agentic-commerce-protocol/tree/main/spec/2026-01-30
+ *
+ * Endpoints:
+ * - POST /api/acp/checkout_sessions                     — Create checkout session
+ * - POST /api/acp/checkout_sessions/[id]                — Update checkout session
+ * - GET  /api/acp/checkout_sessions/[id]                — Get checkout session
+ * - POST /api/acp/checkout_sessions/[id]/complete       — Complete checkout session
+ * - POST /api/acp/checkout_sessions/[id]/cancel         — Cancel checkout session
+ *
+ * Usage:
+ * ```ts
+ * // src/lib/agentic-commerce.ts
+ * export const agenticCommerce = createAgenticCommerce({ ... })
+ * export const acpRoutes = createAcpRoutes(agenticCommerce)
+ *
+ * // src/app/api/acp/checkout_sessions/route.ts
+ * export { POST } from '@/lib/agentic-commerce'
+ * ```
+ */
+import type { AgenticCommerceInstance } from "../config.js";
+export type AcpRouteHandlers = {
+    /** POST /api/acp/checkout_sessions */
+    checkoutSessions: {
+        POST: (request: Request) => Promise<Response>;
+    };
+    /** GET, POST /api/acp/checkout_sessions/[id] */
+    checkoutSession: {
+        GET: (request: Request, context: {
+            params: Promise<{
+                id: string;
+            }>;
+        }) => Promise<Response>;
+        POST: (request: Request, context: {
+            params: Promise<{
+                id: string;
+            }>;
+        }) => Promise<Response>;
+    };
+    /** POST /api/acp/checkout_sessions/[id]/complete */
+    checkoutSessionComplete: {
+        POST: (request: Request, context: {
+            params: Promise<{
+                id: string;
+            }>;
+        }) => Promise<Response>;
+    };
+    /** POST /api/acp/checkout_sessions/[id]/cancel */
+    checkoutSessionCancel: {
+        POST: (request: Request, context: {
+            params: Promise<{
+                id: string;
+            }>;
+        }) => Promise<Response>;
+    };
+};
+export declare function createAcpRoutes(instance: AgenticCommerceInstance): AcpRouteHandlers;
+//# sourceMappingURL=acp-routes.d.ts.map

package/dist/routes/acp-routes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"acp-routes.d.ts","sourceRoot":"","sources":["../../src/routes/acp-routes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAUH,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAA;AAE3D,MAAM,MAAM,gBAAgB,GAAG;IAC7B,sCAAsC;IACtC,gBAAgB,EAAE;QAChB,IAAI,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAA;KAC9C,CAAA;IACD,gDAAgD;IAChD,eAAe,EAAE;QACf,GAAG,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE;YAAE,MAAM,EAAE,OAAO,CAAC;gBAAE,EAAE,EAAE,MAAM,CAAA;aAAE,CAAC,CAAA;SAAE,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAA;QAC1F,IAAI,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE;YAAE,MAAM,EAAE,OAAO,CAAC;gBAAE,EAAE,EAAE,MAAM,CAAA;aAAE,CAAC,CAAA;SAAE,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAA;KAC5F,CAAA;IACD,oDAAoD;IACpD,uBAAuB,EAAE;QACvB,IAAI,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE;YAAE,MAAM,EAAE,OAAO,CAAC;gBAAE,EAAE,EAAE,MAAM,CAAA;aAAE,CAAC,CAAA;SAAE,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAA;KAC5F,CAAA;IACD,kDAAkD;IAClD,qBAAqB,EAAE;QACrB,IAAI,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE;YAAE,MAAM,EAAE,OAAO,CAAC;gBAAE,EAAE,EAAE,MAAM,CAAA;aAAE,CAAC,CAAA;SAAE,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAA;KAC5F,CAAA;CACF,CAAA;AAED,wBAAgB,eAAe,CAAC,QAAQ,EAAE,uBAAuB,GAAG,gBAAgB,CA6RnF"}

package/dist/routes/acp-routes.js

@@ -0,0 +1,274 @@
+/**
+ * ACP Route Handlers
+ *
+ * Creates Next.js App Router route handlers for all ACP endpoints.
+ * Based on ACP spec version 2026-01-30.
+ * https://github.com/agentic-commerce-protocol/agentic-commerce-protocol/tree/main/spec/2026-01-30
+ *
+ * Endpoints:
+ * - POST /api/acp/checkout_sessions                     — Create checkout session
+ * - POST /api/acp/checkout_sessions/[id]                — Update checkout session
+ * - GET  /api/acp/checkout_sessions/[id]                — Get checkout session
+ * - POST /api/acp/checkout_sessions/[id]/complete       — Complete checkout session
+ * - POST /api/acp/checkout_sessions/[id]/cancel         — Cancel checkout session
+ *
+ * Usage:
+ * ```ts
+ * // src/lib/agentic-commerce.ts
+ * export const agenticCommerce = createAgenticCommerce({ ... })
+ * export const acpRoutes = createAcpRoutes(agenticCommerce)
+ *
+ * // src/app/api/acp/checkout_sessions/route.ts
+ * export { POST } from '@/lib/agentic-commerce'
+ * ```
+ */
+import { formatAcpCheckoutSession, formatAcpCompleteResponse, formatAcpError, acpToSaleorAddress, metadataToRecord, recordToMetadataInput, } from "@financedistrict/saleor-agentic-commerce-core";
+export function createAcpRoutes(instance) {
+    const { saleorClient, paymentHandlers, formatterContext, config } = instance;
+    function acpError(code, message, status) {
+        return Response.json(formatAcpError({ code, message, httpStatus: status }), { status });
+    }
+    function validateApiKey(request) {
+        if (!config.acpApiKey)
+            return true; // No key configured = open access
+        const auth = request.headers.get("Authorization");
+        return auth === `Bearer ${config.acpApiKey}`;
+    }
+    function endpointBaseUrl(request) {
+        const url = new URL(request.url);
+        return `${url.origin}/api/acp`;
+    }
+    /**
+     * Shared helper: prepare payment handlers and store metadata on checkout.
+     * Returns the final checkout with updated metadata.
+     */
+    async function preparePaymentAndRefetch(checkoutId, checkout, baseUrl) {
+        const totalAmount = Math.round(checkout.totalPrice.gross.amount * 100);
+        const metadata = metadataToRecord(checkout.privateMetadata);
+        const prepareResults = await paymentHandlers.prepareCheckoutPayment({
+            checkoutId,
+            total: totalAmount,
+            currencyCode: checkout.totalPrice.gross.currency,
+            checkoutBaseUrl: `${baseUrl}/checkout_sessions`,
+            storeName: config.storeName,
+            checkoutMetadata: metadata,
+        });
+        const metadataUpdates = recordToMetadataInput(prepareResults);
+        if (metadataUpdates.length > 0) {
+            await saleorClient.updatePrivateMetadata(checkoutId, metadataUpdates);
+        }
+        const updatedCheckout = await saleorClient.getCheckout(checkoutId);
+        return updatedCheckout.ok ? updatedCheckout.data : checkout;
+    }
+    return {
+        // =====================================================
+        // Create Checkout — POST /api/acp/checkout_sessions
+        // =====================================================
+        checkoutSessions: {
+            async POST(request) {
+                if (!validateApiKey(request)) {
+                    return acpError("unauthorized", "Invalid or missing API key", 401);
+                }
+                let body;
+                try {
+                    body = await request.json();
+                }
+                catch {
+                    return acpError("invalid_body", "Request body must be valid JSON", 400);
+                }
+                const lineItems = body.line_items;
+                if (!Array.isArray(lineItems) || lineItems.length === 0) {
+                    return acpError("missing", "line_items array is required", 400);
+                }
+                // Map ACP line items to Saleor checkout lines
+                // ACP spec: line_items[].item.id, line_items[].quantity
+                const lines = lineItems.map((li) => ({
+                    variantId: li.item?.id || li.id,
+                    quantity: li.quantity || 1,
+                }));
+                // Extract buyer info
+                const email = body.buyer?.email;
+                // Extract fulfillment address from fulfillment_details
+                const shippingAddress = body.fulfillment_details?.address
+                    ? acpToSaleorAddress(body.fulfillment_details.address)
+                    : undefined;
+                const billingAddress = body.billing_address
+                    ? acpToSaleorAddress(body.billing_address)
+                    : undefined;
+                // Create Saleor checkout
+                const checkoutResult = await saleorClient.createCheckout({
+                    lines,
+                    email,
+                    shippingAddress,
+                    billingAddress,
+                });
+                if (!checkoutResult.ok) {
+                    return acpError("checkout_create_failed", checkoutResult.error, 422);
+                }
+                const baseUrl = endpointBaseUrl(request);
+                const finalCheckout = await preparePaymentAndRefetch(checkoutResult.data.id, checkoutResult.data, baseUrl);
+                const session = formatAcpCheckoutSession(formatterContext, finalCheckout);
+                return Response.json(session, { status: 201 });
+            },
+        },
+        // =====================================================
+        // Get/Update Checkout Session
+        // =====================================================
+        checkoutSession: {
+            async GET(request, context) {
+                if (!validateApiKey(request)) {
+                    return acpError("unauthorized", "Invalid or missing API key", 401);
+                }
+                const { id } = await context.params;
+                const result = await saleorClient.getCheckout(id);
+                if (!result.ok)
+                    return acpError("not_found", result.error, 404);
+                const session = formatAcpCheckoutSession(formatterContext, result.data);
+                return Response.json(session);
+            },
+            // ACP spec: Update uses POST (not PUT)
+            async POST(request, context) {
+                if (!validateApiKey(request)) {
+                    return acpError("unauthorized", "Invalid or missing API key", 401);
+                }
+                const { id } = await context.params;
+                let body;
+                try {
+                    body = await request.json();
+                }
+                catch {
+                    return acpError("invalid_body", "Request body must be valid JSON", 400);
+                }
+                // Update buyer email
+                if (body.buyer?.email) {
+                    const result = await saleorClient.updateCheckoutEmail(id, body.buyer.email);
+                    if (!result.ok)
+                        return acpError("invalid", result.error, 422);
+                }
+                // Update fulfillment details (address)
+                if (body.fulfillment_details?.address) {
+                    const addr = acpToSaleorAddress(body.fulfillment_details.address);
+                    const result = await saleorClient.updateCheckoutShippingAddress(id, addr);
+                    if (!result.ok)
+                        return acpError("invalid", result.error, 422);
+                }
+                // Update billing address
+                if (body.billing_address) {
+                    const addr = acpToSaleorAddress(body.billing_address);
+                    const result = await saleorClient.updateCheckoutBillingAddress(id, addr);
+                    if (!result.ok)
+                        return acpError("invalid", result.error, 422);
+                }
+                // Update selected fulfillment option
+                if (body.selected_fulfillment_options && Array.isArray(body.selected_fulfillment_options)) {
+                    const selected = body.selected_fulfillment_options[0];
+                    if (selected?.option_id) {
+                        const result = await saleorClient.updateCheckoutDeliveryMethod(id, selected.option_id);
+                        if (!result.ok)
+                            return acpError("invalid", result.error, 422);
+                    }
+                }
+                // Update line items if provided
+                if (body.line_items && Array.isArray(body.line_items)) {
+                    const lines = body.line_items.map((li) => ({
+                        variantId: li.item?.id || li.id,
+                        quantity: li.quantity || 1,
+                    }));
+                    const result = await saleorClient.updateCheckoutLines(id, lines);
+                    if (!result.ok)
+                        return acpError("invalid", result.error, 422);
+                }
+                // Re-fetch and prepare payment
+                const checkoutResult = await saleorClient.getCheckout(id);
+                if (!checkoutResult.ok)
+                    return acpError("not_found", checkoutResult.error, 404);
+                const baseUrl = endpointBaseUrl(request);
+                const finalCheckout = await preparePaymentAndRefetch(id, checkoutResult.data, baseUrl);
+                const session = formatAcpCheckoutSession(formatterContext, finalCheckout);
+                return Response.json(session);
+            },
+        },
+        // =====================================================
+        // Complete Checkout — returns full session + order
+        // =====================================================
+        checkoutSessionComplete: {
+            async POST(request, context) {
+                if (!validateApiKey(request)) {
+                    return acpError("unauthorized", "Invalid or missing API key", 401);
+                }
+                const { id } = await context.params;
+                let body;
+                try {
+                    body = await request.json();
+                }
+                catch {
+                    return acpError("invalid_body", "Request body must be valid JSON", 400);
+                }
+                // ACP spec payment_data: { handler_id, instrument: { type, credential: { type, token } }, billing_address? }
+                const paymentData = body.payment_data;
+                if (!paymentData) {
+                    return acpError("missing", "payment_data is required", 400);
+                }
+                // Update billing address if provided
+                if (paymentData.billing_address) {
+                    const addr = acpToSaleorAddress(paymentData.billing_address);
+                    await saleorClient.updateCheckoutBillingAddress(id, addr);
+                }
+                // Fetch checkout for metadata
+                const checkoutResult = await saleorClient.getCheckout(id);
+                if (!checkoutResult.ok)
+                    return acpError("not_found", checkoutResult.error, 404);
+                const checkout = checkoutResult.data;
+                const metadata = metadataToRecord(checkout.privateMetadata);
+                // Determine the payment handler to use
+                const handlerId = paymentData.handler_id || "xyz.fd.prism_payment";
+                // Extract credential from instrument
+                const credential = paymentData.instrument?.credential || paymentData.credential;
+                // Settle payment via the appropriate handler
+                const settleResult = await paymentHandlers.settlePayment({
+                    checkoutId: id,
+                    handlerId,
+                    credential,
+                    checkoutMetadata: metadata,
+                });
+                if (!settleResult.success) {
+                    return acpError("payment_declined", settleResult.error || "Payment settlement failed", 422);
+                }
+                // Complete checkout in Saleor
+                const orderResult = await saleorClient.completeCheckout(id);
+                if (!orderResult.ok)
+                    return acpError("processing_error", orderResult.error, 422);
+                // Return full session with completed status + order
+                const response = formatAcpCompleteResponse(formatterContext, checkout, orderResult.data);
+                return Response.json(response);
+            },
+        },
+        // =====================================================
+        // Cancel Checkout — returns full session with canceled status
+        // =====================================================
+        checkoutSessionCancel: {
+            async POST(request, context) {
+                if (!validateApiKey(request)) {
+                    return acpError("unauthorized", "Invalid or missing API key", 401);
+                }
+                const { id } = await context.params;
+                // Verify checkout exists
+                const result = await saleorClient.getCheckout(id);
+                if (!result.ok)
+                    return acpError("not_found", result.error, 404);
+                // Mark as canceled via metadata
+                await saleorClient.updatePrivateMetadata(id, [
+                    { key: "acp_canceled", value: "true" },
+                    { key: "acp_canceled_at", value: new Date().toISOString() },
+                ]);
+                // Return full session with canceled status
+                const session = formatAcpCheckoutSession(formatterContext, result.data);
+                return Response.json({
+                    ...session,
+                    status: "canceled",
+                });
+            },
+        },
+    };
+}
+//# sourceMappingURL=acp-routes.js.map

package/dist/routes/acp-routes.js.map

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

package/dist/routes/ucp-routes.d.ts

@@ -0,0 +1,76 @@
+/**
+ * UCP Route Handlers
+ *
+ * Creates Next.js App Router route handlers for all UCP endpoints.
+ * Based on UCP spec version 2026-04-08.
+ * https://ucp.dev/2026-04-08/specification/overview
+ *
+ * Endpoints:
+ * - GET  /.well-known/ucp                             — Discovery profile
+ * - POST /api/ucp/checkout-sessions                   — Create checkout
+ * - GET  /api/ucp/checkout-sessions/[id]              — Get checkout
+ * - PUT  /api/ucp/checkout-sessions/[id]              — Update checkout
+ * - POST /api/ucp/checkout-sessions/[id]/complete     — Complete checkout
+ * - POST /api/ucp/checkout-sessions/[id]/cancel       — Cancel checkout
+ * - GET  /api/ucp/orders/[id]                         — Get order
+ *
+ * Usage:
+ * ```ts
+ * // src/lib/agentic-commerce.ts
+ * export const agenticCommerce = createAgenticCommerce({ ... })
+ * export const ucpRoutes = createUcpRoutes(agenticCommerce)
+ *
+ * // src/app/.well-known/ucp/route.ts
+ * export { GET } from '@/lib/agentic-commerce'
+ * ```
+ */
+import type { AgenticCommerceInstance } from "../config.js";
+export type UcpRouteHandlers = {
+    /** GET /.well-known/ucp */
+    discovery: {
+        GET: (request: Request) => Promise<Response>;
+    };
+    /** POST /api/ucp/checkout-sessions */
+    checkoutSessions: {
+        POST: (request: Request) => Promise<Response>;
+    };
+    /** GET, PUT /api/ucp/checkout-sessions/[id] */
+    checkoutSession: {
+        GET: (request: Request, context: {
+            params: Promise<{
+                id: string;
+            }>;
+        }) => Promise<Response>;
+        PUT: (request: Request, context: {
+            params: Promise<{
+                id: string;
+            }>;
+        }) => Promise<Response>;
+    };
+    /** POST /api/ucp/checkout-sessions/[id]/complete */
+    checkoutSessionComplete: {
+        POST: (request: Request, context: {
+            params: Promise<{
+                id: string;
+            }>;
+        }) => Promise<Response>;
+    };
+    /** POST /api/ucp/checkout-sessions/[id]/cancel */
+    checkoutSessionCancel: {
+        POST: (request: Request, context: {
+            params: Promise<{
+                id: string;
+            }>;
+        }) => Promise<Response>;
+    };
+    /** GET /api/ucp/orders/[id] */
+    order: {
+        GET: (request: Request, context: {
+            params: Promise<{
+                id: string;
+            }>;
+        }) => Promise<Response>;
+    };
+};
+export declare function createUcpRoutes(instance: AgenticCommerceInstance): UcpRouteHandlers;
+//# sourceMappingURL=ucp-routes.d.ts.map

package/dist/routes/ucp-routes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ucp-routes.d.ts","sourceRoot":"","sources":["../../src/routes/ucp-routes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAYH,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAA;AAE3D,MAAM,MAAM,gBAAgB,GAAG;IAC7B,2BAA2B;IAC3B,SAAS,EAAE;QACT,GAAG,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAA;KAC7C,CAAA;IACD,sCAAsC;IACtC,gBAAgB,EAAE;QAChB,IAAI,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAA;KAC9C,CAAA;IACD,+CAA+C;IAC/C,eAAe,EAAE;QACf,GAAG,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE;YAAE,MAAM,EAAE,OAAO,CAAC;gBAAE,EAAE,EAAE,MAAM,CAAA;aAAE,CAAC,CAAA;SAAE,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAA;QAC1F,GAAG,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE;YAAE,MAAM,EAAE,OAAO,CAAC;gBAAE,EAAE,EAAE,MAAM,CAAA;aAAE,CAAC,CAAA;SAAE,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAA;KAC3F,CAAA;IACD,oDAAoD;IACpD,uBAAuB,EAAE;QACvB,IAAI,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE;YAAE,MAAM,EAAE,OAAO,CAAC;gBAAE,EAAE,EAAE,MAAM,CAAA;aAAE,CAAC,CAAA;SAAE,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAA;KAC5F,CAAA;IACD,kDAAkD;IAClD,qBAAqB,EAAE;QACrB,IAAI,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE;YAAE,MAAM,EAAE,OAAO,CAAC;gBAAE,EAAE,EAAE,MAAM,CAAA;aAAE,CAAC,CAAA;SAAE,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAA;KAC5F,CAAA;IACD,+BAA+B;IAC/B,KAAK,EAAE;QACL,GAAG,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE;YAAE,MAAM,EAAE,OAAO,CAAC;gBAAE,EAAE,EAAE,MAAM,CAAA;aAAE,CAAC,CAAA;SAAE,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAA;KAC3F,CAAA;CACF,CAAA;AAED,wBAAgB,eAAe,CAAC,QAAQ,EAAE,uBAAuB,GAAG,gBAAgB,CA6RnF"}

package/dist/routes/ucp-routes.js

@@ -0,0 +1,281 @@
+/**
+ * UCP Route Handlers
+ *
+ * Creates Next.js App Router route handlers for all UCP endpoints.
+ * Based on UCP spec version 2026-04-08.
+ * https://ucp.dev/2026-04-08/specification/overview
+ *
+ * Endpoints:
+ * - GET  /.well-known/ucp                             — Discovery profile
+ * - POST /api/ucp/checkout-sessions                   — Create checkout
+ * - GET  /api/ucp/checkout-sessions/[id]              — Get checkout
+ * - PUT  /api/ucp/checkout-sessions/[id]              — Update checkout
+ * - POST /api/ucp/checkout-sessions/[id]/complete     — Complete checkout
+ * - POST /api/ucp/checkout-sessions/[id]/cancel       — Cancel checkout
+ * - GET  /api/ucp/orders/[id]                         — Get order
+ *
+ * Usage:
+ * ```ts
+ * // src/lib/agentic-commerce.ts
+ * export const agenticCommerce = createAgenticCommerce({ ... })
+ * export const ucpRoutes = createUcpRoutes(agenticCommerce)
+ *
+ * // src/app/.well-known/ucp/route.ts
+ * export { GET } from '@/lib/agentic-commerce'
+ * ```
+ */
+import { formatUcpProfile, formatUcpCheckoutSession, formatUcpCompleteResponse, formatUcpOrder, formatUcpError, ucpToSaleorAddress, metadataToRecord, recordToMetadataInput, } from "@financedistrict/saleor-agentic-commerce-core";
+export function createUcpRoutes(instance) {
+    const { saleorClient, paymentHandlers, formatterContext, config } = instance;
+    function ucpError(code, content, status) {
+        return Response.json(formatUcpError({ ucpVersion: config.ucpVersion, code, content }), { status });
+    }
+    function endpointBaseUrl(request) {
+        const url = new URL(request.url);
+        return `${url.origin}/api/ucp`;
+    }
+    /**
+     * Shared helper: prepare payment handlers and store metadata on checkout.
+     * Returns the final checkout with updated metadata.
+     */
+    async function preparePaymentAndRefetch(checkoutId, checkout, baseUrl) {
+        const totalAmount = Math.round(checkout.totalPrice.gross.amount * 100);
+        const metadata = metadataToRecord(checkout.privateMetadata);
+        const prepareResults = await paymentHandlers.prepareCheckoutPayment({
+            checkoutId,
+            total: totalAmount,
+            currencyCode: checkout.totalPrice.gross.currency,
+            checkoutBaseUrl: `${baseUrl}/checkout-sessions`,
+            storeName: config.storeName,
+            checkoutMetadata: metadata,
+        });
+        const metadataUpdates = recordToMetadataInput(prepareResults);
+        if (metadataUpdates.length > 0) {
+            await saleorClient.updatePrivateMetadata(checkoutId, metadataUpdates);
+        }
+        const updatedCheckout = await saleorClient.getCheckout(checkoutId);
+        return updatedCheckout.ok ? updatedCheckout.data : checkout;
+    }
+    return {
+        // =====================================================
+        // Discovery — GET /.well-known/ucp
+        // =====================================================
+        discovery: {
+            async GET(request) {
+                const baseUrl = endpointBaseUrl(request);
+                const profile = await formatUcpProfile(formatterContext, baseUrl);
+                return Response.json(profile, {
+                    headers: {
+                        "Cache-Control": "public, max-age=300",
+                        "Content-Type": "application/json",
+                    },
+                });
+            },
+        },
+        // =====================================================
+        // Create Checkout Session — POST /api/ucp/checkout-sessions
+        // =====================================================
+        checkoutSessions: {
+            async POST(request) {
+                let body;
+                try {
+                    body = await request.json();
+                }
+                catch {
+                    return ucpError("invalid_body", "Request body must be valid JSON", 400);
+                }
+                const lineItems = body.line_items;
+                if (!Array.isArray(lineItems) || lineItems.length === 0) {
+                    return ucpError("missing_line_items", "line_items array is required", 400);
+                }
+                // Map UCP line items to Saleor checkout lines
+                const lines = lineItems.map((item) => ({
+                    variantId: item.item?.id || item.id,
+                    quantity: item.quantity || 1,
+                }));
+                // Extract buyer email
+                const email = body.buyer?.email;
+                // Extract fulfillment address from fulfillment.methods[0].destinations[0]
+                const fulfillmentDest = body.fulfillment?.methods?.[0]?.destinations?.[0];
+                const shippingAddress = fulfillmentDest
+                    ? ucpToSaleorAddress(fulfillmentDest)
+                    : undefined;
+                // Create Saleor checkout
+                const checkoutResult = await saleorClient.createCheckout({
+                    lines,
+                    email,
+                    shippingAddress,
+                });
+                if (!checkoutResult.ok) {
+                    return ucpError("checkout_create_failed", checkoutResult.error, 422);
+                }
+                const baseUrl = endpointBaseUrl(request);
+                const finalCheckout = await preparePaymentAndRefetch(checkoutResult.data.id, checkoutResult.data, baseUrl);
+                const session = formatUcpCheckoutSession(formatterContext, finalCheckout);
+                return Response.json(session, { status: 201 });
+            },
+        },
+        // =====================================================
+        // Get/Update Checkout Session
+        // =====================================================
+        checkoutSession: {
+            async GET(request, context) {
+                const { id } = await context.params;
+                const result = await saleorClient.getCheckout(id);
+                if (!result.ok)
+                    return ucpError("checkout_not_found", result.error, 404);
+                const session = formatUcpCheckoutSession(formatterContext, result.data);
+                return Response.json(session);
+            },
+            async PUT(request, context) {
+                const { id } = await context.params;
+                let body;
+                try {
+                    body = await request.json();
+                }
+                catch {
+                    return ucpError("invalid_body", "Request body must be valid JSON", 400);
+                }
+                // Update buyer email
+                if (body.buyer?.email) {
+                    const result = await saleorClient.updateCheckoutEmail(id, body.buyer.email);
+                    if (!result.ok)
+                        return ucpError("email_update_failed", result.error, 422);
+                }
+                // Update fulfillment: extract destination address and selected option
+                if (body.fulfillment?.methods) {
+                    const method = body.fulfillment.methods[0];
+                    if (method) {
+                        // Update shipping address from destination
+                        const dest = method.destinations?.[0];
+                        if (dest) {
+                            const addr = ucpToSaleorAddress(dest);
+                            const result = await saleorClient.updateCheckoutShippingAddress(id, addr);
+                            if (!result.ok)
+                                return ucpError("shipping_address_update_failed", result.error, 422);
+                        }
+                        // Update delivery method from selected option
+                        const selectedOptionId = method.groups?.[0]?.selected_option_id;
+                        if (selectedOptionId) {
+                            const result = await saleorClient.updateCheckoutDeliveryMethod(id, selectedOptionId);
+                            if (!result.ok)
+                                return ucpError("delivery_method_update_failed", result.error, 422);
+                        }
+                    }
+                }
+                // Update line items if provided
+                if (body.line_items && Array.isArray(body.line_items)) {
+                    const lines = body.line_items.map((item) => ({
+                        variantId: item.item?.id || item.id,
+                        quantity: item.quantity || 1,
+                    }));
+                    const result = await saleorClient.updateCheckoutLines(id, lines);
+                    if (!result.ok)
+                        return ucpError("items_update_failed", result.error, 422);
+                }
+                // Re-fetch and prepare payment
+                const checkoutResult = await saleorClient.getCheckout(id);
+                if (!checkoutResult.ok)
+                    return ucpError("checkout_not_found", checkoutResult.error, 404);
+                const baseUrl = endpointBaseUrl(request);
+                const finalCheckout = await preparePaymentAndRefetch(id, checkoutResult.data, baseUrl);
+                const session = formatUcpCheckoutSession(formatterContext, finalCheckout);
+                return Response.json(session);
+            },
+        },
+        // =====================================================
+        // Complete Checkout Session
+        // =====================================================
+        checkoutSessionComplete: {
+            async POST(request, context) {
+                const { id } = await context.params;
+                let body;
+                try {
+                    body = await request.json();
+                }
+                catch {
+                    return ucpError("invalid_body", "Request body must be valid JSON", 400);
+                }
+                // Extract payment instrument
+                const payment = body.payment;
+                if (!payment?.instruments || !Array.isArray(payment.instruments)) {
+                    return ucpError("missing_payment", "payment.instruments array is required", 400);
+                }
+                const selectedInstrument = payment.instruments.find((i) => i.selected) || payment.instruments[0];
+                if (!selectedInstrument) {
+                    return ucpError("no_instrument_selected", "At least one payment instrument must be provided", 400);
+                }
+                // Fetch checkout for metadata
+                const checkoutResult = await saleorClient.getCheckout(id);
+                if (!checkoutResult.ok)
+                    return ucpError("checkout_not_found", checkoutResult.error, 404);
+                const checkout = checkoutResult.data;
+                const metadata = metadataToRecord(checkout.privateMetadata);
+                // Update billing address if provided on instrument
+                if (selectedInstrument.billing_address) {
+                    const addr = ucpToSaleorAddress(selectedInstrument.billing_address);
+                    await saleorClient.updateCheckoutBillingAddress(id, addr);
+                }
+                // Settle payment via the appropriate handler
+                const settleResult = await paymentHandlers.settlePayment({
+                    checkoutId: id,
+                    handlerId: selectedInstrument.handler_id,
+                    credential: selectedInstrument.credential,
+                    checkoutMetadata: metadata,
+                });
+                if (!settleResult.success) {
+                    return ucpError("payment_failed", settleResult.error || "Payment settlement failed", 422);
+                }
+                // Complete checkout in Saleor
+                const orderResult = await saleorClient.completeCheckout(id);
+                if (!orderResult.ok)
+                    return ucpError("checkout_complete_failed", orderResult.error, 422);
+                // Return checkout session with completed status and order confirmation
+                const orderConfirmation = {
+                    id: orderResult.data.id,
+                    label: orderResult.data.number ?? undefined,
+                    permalink_url: `${config.storefrontUrl}/orders/${orderResult.data.id}`,
+                };
+                const response = formatUcpCompleteResponse(formatterContext, checkout, orderConfirmation);
+                return Response.json(response);
+            },
+        },
+        // =====================================================
+        // Cancel Checkout Session
+        // =====================================================
+        checkoutSessionCancel: {
+            async POST(_request, context) {
+                const { id } = await context.params;
+                // Verify checkout exists
+                const result = await saleorClient.getCheckout(id);
+                if (!result.ok)
+                    return ucpError("checkout_not_found", result.error, 404);
+                // Mark as canceled via metadata
+                await saleorClient.updatePrivateMetadata(id, [
+                    { key: "ucp_canceled", value: "true" },
+                    { key: "ucp_canceled_at", value: new Date().toISOString() },
+                ]);
+                // Return full checkout session with canceled status
+                const session = formatUcpCheckoutSession(formatterContext, result.data);
+                return Response.json({
+                    ...session,
+                    status: "canceled",
+                });
+            },
+        },
+        // =====================================================
+        // Get Order
+        // =====================================================
+        order: {
+            async GET(request, context) {
+                const { id } = await context.params;
+                const result = await saleorClient.getOrder(id);
+                if (!result.ok)
+                    return ucpError("order_not_found", result.error, 404);
+                const order = formatUcpOrder(formatterContext, result.data);
+                return Response.json(order);
+            },
+        },
+    };
+}
+//# sourceMappingURL=ucp-routes.js.map

package/dist/routes/ucp-routes.js.map

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

package/package.json

@@ -0,0 +1,74 @@
+{
+  "name": "@financedistrict/saleor-agentic-commerce-nextjs",
+  "version": "0.1.0",
+  "description": "Drop-in Next.js route handlers that expose your Saleor storefront to AI shopping agents via UCP and ACP protocols.",
+  "author": "Finance District <dev@fd.xyz>",
+  "license": "MIT",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./routes/*": {
+      "types": "./dist/routes/*.d.ts",
+      "default": "./dist/routes/*.js"
+    },
+    "./middleware/*": {
+      "types": "./dist/middleware/*.d.ts",
+      "default": "./dist/middleware/*.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "package.json",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "clean": "rm -rf dist"
+  },
+  "keywords": [
+    "saleor",
+    "saleor-sdk",
+    "saleor-app",
+    "nextjs",
+    "next-js",
+    "app-router",
+    "route-handler",
+    "agentic-commerce",
+    "ai-commerce",
+    "ai-agent",
+    "ai-shopping",
+    "ucp",
+    "acp",
+    "universal-commerce-protocol",
+    "agentic-commerce-protocol",
+    "headless-commerce",
+    "storefront",
+    "commerce-api",
+    "checkout",
+    "shopping-agent",
+    "autonomous-agent"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/financedistrict-platform/saleor-agentic-commerce.git",
+    "directory": "packages/nextjs"
+  },
+  "homepage": "https://github.com/financedistrict-platform/saleor-agentic-commerce#readme",
+  "bugs": {
+    "url": "https://github.com/financedistrict-platform/saleor-agentic-commerce/issues"
+  },
+  "dependencies": {
+    "@financedistrict/saleor-agentic-commerce-core": "workspace:*"
+  },
+  "devDependencies": {
+    "typescript": "^5.3.0"
+  }
+}