@reactionary/acp 0.0.1 → 0.10.32

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Solteq
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

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.0.1",
+  "version": "0.10.32",
   "type": "module",
   "main": "./index.js",
   "types": "./src/index.d.ts",
@@ -9,12 +9,12 @@
     "url": "git+https://github.com/Solteq/reactionary.git"
   },
   "dependencies": {
-    "@reactionary/core": "0.0.1",
-    "@reactionary/feeds": "0.0.1",
+    "@reactionary/core": "0.10.32",
+    "@reactionary/feeds": "0.10.32",
     "zod": "4.1.9"
   },
   "devDependencies": {
     "vitest": "^4.0.9"
   },
   "sideEffects": false
-}
+}

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;