mcp and ucp

internal/ucp/handler.go

@@ -0,0 +1,117 @@
+package ucp
+
+import "net/http"
+
+// ---------------------------------------------------------------------------
+// Order HTTP handler mounting
+// ---------------------------------------------------------------------------
+
+// OrderHandler returns an http.Handler that routes UCP order REST endpoints.
+// Mount it under any prefix (e.g. /ucp/v1) in a ServeMux:
+//
+//	mux.Handle("/ucp/v1/orders", ucp.OrderHandler(pool))
+//	mux.Handle("/ucp/v1/orders/", ucp.OrderHandler(pool))
+//
+// To sign responses with RFC 9421 HTTP Message Signatures, wrap with WithSigning:
+//
+//	mux.Handle("/ucp/v1/orders", ucp.WithSigning(ucp.OrderHandler(pool), signer))
+func OrderHandler(applier OrderReadApplier) http.Handler {
+	s := NewOrderServer(applier)
+	mux := http.NewServeMux()
+	mux.HandleFunc("GET /{id}", s.handleGetOrder)
+	mux.HandleFunc("POST /{id}/cancel", s.handleCancelOrder)
+	mux.HandleFunc("POST /{id}/fulfillments", s.handleCreateFulfillment)
+	mux.HandleFunc("POST /{id}/returns", s.handleRequestReturn)
+	mux.HandleFunc("POST /{id}/refunds", s.handleIssueRefund)
+	return mux
+}
+
+// ---------------------------------------------------------------------------
+// Cart HTTP handler mounting
+// ---------------------------------------------------------------------------
+
+// CartHandler returns an http.Handler that routes UCP cart REST endpoints.
+// Mount it under any prefix (e.g. /ucp/v1) in a ServeMux:
+//
+//	mux.Handle("/ucp/v1/carts", ucp.CartHandler(pool))
+//	mux.Handle("/ucp/v1/carts/", ucp.CartHandler(pool))
+//
+// To sign responses with RFC 9421 HTTP Message Signatures, wrap with WithSigning:
+//
+//	mux.Handle("/ucp/v1/carts", ucp.WithSigning(ucp.CartHandler(pool), signer))
+func CartHandler(applier CartApplier) http.Handler {
+	s := NewCartServer(applier)
+	mux := http.NewServeMux()
+	mux.HandleFunc("POST /", s.handleCreateCart)
+	mux.HandleFunc("GET /{id}", s.handleGetCart)
+	mux.HandleFunc("PUT /{id}", s.handleUpdateCart)
+	mux.HandleFunc("POST /{id}/cancel", s.handleCancelCart)
+	return mux
+}
+
+// ---------------------------------------------------------------------------
+// Checkout HTTP handler mounting
+// ---------------------------------------------------------------------------
+
+// CheckoutHandler returns an http.Handler that routes UCP checkout endpoints.
+// An optional OrderApplier can be provided for real order creation on complete.
+//
+//	mux.Handle("/ucp/v1/checkout-sessions", ucp.CheckoutHandler(pool))
+//	mux.Handle("/ucp/v1/checkout-sessions/", ucp.CheckoutHandler(pool, orderSvc))
+//
+// To sign responses with RFC 9421 HTTP Message Signatures, wrap with WithSigning:
+//
+//	mux.Handle("/ucp/v1/checkout-sessions", ucp.WithSigning(ucp.CheckoutHandler(pool), signer))
+func CheckoutHandler(applier CheckoutApplier, orderSvc ...OrderApplier) http.Handler {
+	s := NewCheckoutServer(applier, orderSvc...)
+	mux := http.NewServeMux()
+	mux.HandleFunc("POST /", s.handleCreateCheckout)
+	mux.HandleFunc("GET /{id}", s.handleGetCheckout)
+	mux.HandleFunc("PUT /{id}", s.handleUpdateCheckout)
+	mux.HandleFunc("POST /{id}/complete", s.handleCompleteCheckout)
+	mux.HandleFunc("POST /{id}/cancel", s.handleCancelCheckout)
+	return mux
+}
+
+// ---------------------------------------------------------------------------
+// Combined handler for mounting all UCP endpoints under one prefix
+// ---------------------------------------------------------------------------
+
+// Options controls optional features of the combined handler.
+type Options struct {
+	CheckoutApplier CheckoutApplier // when set, mounts /checkout-sessions
+	OrderApplier    OrderApplier    // optional order creation for complete endpoint
+}
+
+// Handler returns an http.Handler that serves all mounted UCP endpoints under
+// a single prefix. Usage:
+//
+//	mux.Handle("/ucp/v1/", ucp.Handler(pool, ucp.Options{
+//	    CheckoutApplier: checkoutPool,
+//	}))
+func Handler(cartApplier CartApplier, opts Options) http.Handler {
+	mux := http.NewServeMux()
+
+	// Cart endpoints
+	cartSrv := NewCartServer(cartApplier)
+	mux.HandleFunc("POST /carts", cartSrv.handleCreateCart)
+	mux.HandleFunc("GET /carts/{id}", cartSrv.handleGetCart)
+	mux.HandleFunc("PUT /carts/{id}", cartSrv.handleUpdateCart)
+	mux.HandleFunc("POST /carts/{id}/cancel", cartSrv.handleCancelCart)
+
+	// Checkout endpoints (optional)
+	if opts.CheckoutApplier != nil {
+		var orderOpts []OrderApplier
+		if opts.OrderApplier != nil {
+			orderOpts = []OrderApplier{opts.OrderApplier}
+		}
+		checkoutSrv := NewCheckoutServer(opts.CheckoutApplier, orderOpts...)
+		mux.HandleFunc("POST /checkout-sessions", checkoutSrv.handleCreateCheckout)
+		mux.HandleFunc("GET /checkout-sessions/{id}", checkoutSrv.handleGetCheckout)
+		mux.HandleFunc("PUT /checkout-sessions/{id}", checkoutSrv.handleUpdateCheckout)
+		mux.HandleFunc("POST /checkout-sessions/{id}/complete", checkoutSrv.handleCompleteCheckout)
+		mux.HandleFunc("POST /checkout-sessions/{id}/cancel", checkoutSrv.handleCancelCheckout)
+	}
+
+	return mux
+}