@reactionary/acp 0.10.31 → 0.10.32

package/README.md

@@ -19,6 +19,10 @@ It also serves a readiness document from `GET` / `HEAD`.
 
 If the adapter is mounted under `/acp`, both `/checkout_sessions/...` and `/acp/checkout_sessions/...` paths are understood. Set `basePath` when mounting somewhere else.
 
+## Discovery
+
+`GET /.well-known/acp.json` (alias `/.well-known/acp`) serves the ACP discovery document with `Cache-Control: public, max-age=3600`. It advertises the `checkout` service, plus `feeds` when `productFeed` is configured. `api_base_url` defaults to the request origin plus `basePath` (default `/acp`); override it and other fields with the `discovery` option. The host application must route the well-known path to this handler. Payment handlers are not part of ACP discovery; they are negotiated per checkout session.
+
 ## Product feed generation
 
 `GET /product_feeds/{id}/products` generates an ACP-compatible product feed from the configured feed definition whose key matches `{id}`.

package/lib/reactionary-acp-server.js

@@ -16,6 +16,8 @@ import {
 const ACP_SESSION_ID_HEADER = "acp-session-id";
 const SESSION_CACHE_KEY_PREFIX = "reactionary:acp:session";
 const CHECKOUT_SESSION_CACHE_KEY_PREFIX = "reactionary:acp:checkout-session";
+const ACP_DISCOVERY_PATHS = ["/.well-known/acp.json", "/.well-known/acp"];
+const ACP_DEFAULT_API_VERSION = "2026-01-30";
 class ReactionaryACPServer {
   constructor(clientFactory, options = {}) {
     this.clientFactory = clientFactory;
@@ -80,6 +82,12 @@ class ReactionaryACPServer {
         }
       });
     }
+    if ((request.method === "GET" || request.method === "HEAD") && ACP_DISCOVERY_PATHS.includes(new URL(request.url).pathname)) {
+      return jsonResponse(this.getDiscoveryDocument(request), {
+        headers: { "cache-control": "public, max-age=3600" },
+        omitBody: request.method === "HEAD"
+      });
+    }
     if (request.method === "GET" || request.method === "HEAD") {
       const productFeedId = getProductFeedId(request, this.options.basePath);
       if (productFeedId) {
@@ -130,6 +138,28 @@ class ReactionaryACPServer {
       }
     });
   }
+  getDiscoveryDocument(request) {
+    const discovery = this.options.discovery ?? {};
+    const version = discovery.apiVersion ?? ACP_DEFAULT_API_VERSION;
+    const supportedVersions = discovery.supportedVersions ?? [version];
+    const basePath = (this.options.basePath ?? "/acp").replace(/\/$/, "");
+    const apiBaseUrl = discovery.apiBaseUrl ?? `${new URL(request.url).origin}${basePath}`;
+    return {
+      protocol: {
+        name: "acp",
+        version,
+        supported_versions: supportedVersions,
+        ...discovery.documentationUrl ? { documentation_url: discovery.documentationUrl } : {}
+      },
+      api_base_url: apiBaseUrl,
+      transports: ["rest"],
+      capabilities: {
+        services: this.options.productFeed ? ["checkout", "feeds"] : ["checkout"],
+        ...discovery.supportedCurrencies ? { supported_currencies: discovery.supportedCurrencies } : {},
+        ...discovery.supportedLocales ? { supported_locales: discovery.supportedLocales } : {}
+      }
+    };
+  }
   getReadinessDocument() {
     return {
       name: this.options.name ?? "@reactionary/acp",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@reactionary/acp",
-  "version": "0.10.31",
+  "version": "0.10.32",
   "type": "module",
   "main": "./index.js",
   "types": "./src/index.d.ts",
@@ -9,8 +9,8 @@
     "url": "git+https://github.com/Solteq/reactionary.git"
   },
   "dependencies": {
-    "@reactionary/core": "0.10.31",
-    "@reactionary/feeds": "0.10.31",
+    "@reactionary/core": "0.10.32",
+    "@reactionary/feeds": "0.10.32",
     "zod": "4.1.9"
   },
   "devDependencies": {

package/src/lib/reactionary-acp-server.d.ts

@@ -42,6 +42,30 @@ export interface ReactionaryACPServerOptions {
     paymentProvider?: ACPPaymentProvider;
     links?: ACPLink[];
     productFeed?: ACPProductFeedOptions;
+    discovery?: ACPDiscoveryOptions;
+}
+export interface ACPDiscoveryOptions {
+    apiVersion?: string;
+    supportedVersions?: string[];
+    apiBaseUrl?: string;
+    documentationUrl?: string;
+    supportedCurrencies?: string[];
+    supportedLocales?: string[];
+}
+export interface ACPDiscoveryResponse {
+    protocol: {
+        name: 'acp';
+        version: string;
+        supported_versions: string[];
+        documentation_url?: string;
+    };
+    api_base_url: string;
+    transports: ['rest'];
+    capabilities: {
+        services: Array<'checkout' | 'feeds'>;
+        supported_currencies?: string[];
+        supported_locales?: string[];
+    };
 }
 export type ACPPaymentProcessor = 'stripe' | 'adyen' | 'braintree';
 export interface ACPPaymentProvider {
@@ -81,6 +105,7 @@ export declare class ReactionaryACPServer<TClient extends ReactionaryACPClient =
     close(): Promise<void>;
     private createRequestContext;
     private handleRequest;
+    private getDiscoveryDocument;
     private getReadinessDocument;
     private getProductFeed;
     private getRequestedProductFeed;