@stateset/acp-client 1.0.0

package/dist/index.js

@@ -0,0 +1,63 @@
+"use strict";
+/**
+ * StateSet ACP Handler - Node.js Client
+ *
+ * Official Node.js bindings for the StateSet Agentic Commerce Protocol Handler.
+ * Supports both HTTP REST and gRPC transports.
+ *
+ * @example
+ * ```typescript
+ * import { AcpHttpClient, AcpGrpcClient } from '@stateset/acp-client';
+ *
+ * // HTTP Client
+ * const httpClient = new AcpHttpClient({
+ *   baseUrl: 'http://localhost:8080',
+ *   apiKey: 'api_key_demo_123',
+ * });
+ *
+ * const session = await httpClient.createCheckoutSession({
+ *   items: [{ id: 'prod_123', quantity: 1 }],
+ * });
+ *
+ * // gRPC Client
+ * const grpcClient = new AcpGrpcClient({
+ *   grpcAddress: 'localhost:50051',
+ *   apiKey: 'api_key_demo_123',
+ * });
+ * await grpcClient.connect();
+ *
+ * const session = await grpcClient.createCheckoutSession({
+ *   items: [{ id: 'prod_123', quantity: 1 }],
+ * });
+ * ```
+ */
+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 __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AcpGrpcError = exports.AcpGrpcClient = exports.AcpApiError = exports.AcpHttpClient = void 0;
+// Export HTTP client
+var http_client_1 = require("./http-client");
+Object.defineProperty(exports, "AcpHttpClient", { enumerable: true, get: function () { return http_client_1.AcpHttpClient; } });
+Object.defineProperty(exports, "AcpApiError", { enumerable: true, get: function () { return http_client_1.AcpApiError; } });
+// Export gRPC client
+var grpc_client_1 = require("./grpc-client");
+Object.defineProperty(exports, "AcpGrpcClient", { enumerable: true, get: function () { return grpc_client_1.AcpGrpcClient; } });
+Object.defineProperty(exports, "AcpGrpcError", { enumerable: true, get: function () { return grpc_client_1.AcpGrpcError; } });
+// Export all types
+__exportStar(require("./types"), exports);
+// Default export for convenience
+const http_client_2 = require("./http-client");
+exports.default = http_client_2.AcpHttpClient;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi9zcmMvaW5kZXgudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IjtBQUFBOzs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7O0dBK0JHOzs7Ozs7Ozs7Ozs7Ozs7OztBQUVILHFCQUFxQjtBQUNyQiw2Q0FBMkQ7QUFBbEQsNEdBQUEsYUFBYSxPQUFBO0FBQUUsMEdBQUEsV0FBVyxPQUFBO0FBRW5DLHFCQUFxQjtBQUNyQiw2Q0FBNEQ7QUFBbkQsNEdBQUEsYUFBYSxPQUFBO0FBQUUsMkdBQUEsWUFBWSxPQUFBO0FBRXBDLG1CQUFtQjtBQUNuQiwwQ0FBd0I7QUFFeEIsaUNBQWlDO0FBQ2pDLCtDQUE4QztBQUM5QyxrQkFBZSwyQkFBYSxDQUFDIiwic291cmNlc0NvbnRlbnQiOlsiLyoqXG4gKiBTdGF0ZVNldCBBQ1AgSGFuZGxlciAtIE5vZGUuanMgQ2xpZW50XG4gKlxuICogT2ZmaWNpYWwgTm9kZS5qcyBiaW5kaW5ncyBmb3IgdGhlIFN0YXRlU2V0IEFnZW50aWMgQ29tbWVyY2UgUHJvdG9jb2wgSGFuZGxlci5cbiAqIFN1cHBvcnRzIGJvdGggSFRUUCBSRVNUIGFuZCBnUlBDIHRyYW5zcG9ydHMuXG4gKlxuICogQGV4YW1wbGVcbiAqIGBgYHR5cGVzY3JpcHRcbiAqIGltcG9ydCB7IEFjcEh0dHBDbGllbnQsIEFjcEdycGNDbGllbnQgfSBmcm9tICdAc3RhdGVzZXQvYWNwLWNsaWVudCc7XG4gKlxuICogLy8gSFRUUCBDbGllbnRcbiAqIGNvbnN0IGh0dHBDbGllbnQgPSBuZXcgQWNwSHR0cENsaWVudCh7XG4gKiAgIGJhc2VVcmw6ICdodHRwOi8vbG9jYWxob3N0OjgwODAnLFxuICogICBhcGlLZXk6ICdhcGlfa2V5X2RlbW9fMTIzJyxcbiAqIH0pO1xuICpcbiAqIGNvbnN0IHNlc3Npb24gPSBhd2FpdCBodHRwQ2xpZW50LmNyZWF0ZUNoZWNrb3V0U2Vzc2lvbih7XG4gKiAgIGl0ZW1zOiBbeyBpZDogJ3Byb2RfMTIzJywgcXVhbnRpdHk6IDEgfV0sXG4gKiB9KTtcbiAqXG4gKiAvLyBnUlBDIENsaWVudFxuICogY29uc3QgZ3JwY0NsaWVudCA9IG5ldyBBY3BHcnBjQ2xpZW50KHtcbiAqICAgZ3JwY0FkZHJlc3M6ICdsb2NhbGhvc3Q6NTAwNTEnLFxuICogICBhcGlLZXk6ICdhcGlfa2V5X2RlbW9fMTIzJyxcbiAqIH0pO1xuICogYXdhaXQgZ3JwY0NsaWVudC5jb25uZWN0KCk7XG4gKlxuICogY29uc3Qgc2Vzc2lvbiA9IGF3YWl0IGdycGNDbGllbnQuY3JlYXRlQ2hlY2tvdXRTZXNzaW9uKHtcbiAqICAgaXRlbXM6IFt7IGlkOiAncHJvZF8xMjMnLCBxdWFudGl0eTogMSB9XSxcbiAqIH0pO1xuICogYGBgXG4gKi9cblxuLy8gRXhwb3J0IEhUVFAgY2xpZW50XG5leHBvcnQgeyBBY3BIdHRwQ2xpZW50LCBBY3BBcGlFcnJvciB9IGZyb20gJy4vaHR0cC1jbGllbnQnO1xuXG4vLyBFeHBvcnQgZ1JQQyBjbGllbnRcbmV4cG9ydCB7IEFjcEdycGNDbGllbnQsIEFjcEdycGNFcnJvciB9IGZyb20gJy4vZ3JwYy1jbGllbnQnO1xuXG4vLyBFeHBvcnQgYWxsIHR5cGVzXG5leHBvcnQgKiBmcm9tICcuL3R5cGVzJztcblxuLy8gRGVmYXVsdCBleHBvcnQgZm9yIGNvbnZlbmllbmNlXG5pbXBvcnQgeyBBY3BIdHRwQ2xpZW50IH0gZnJvbSAnLi9odHRwLWNsaWVudCc7XG5leHBvcnQgZGVmYXVsdCBBY3BIdHRwQ2xpZW50O1xuIl19

package/dist/types.d.ts

@@ -0,0 +1,197 @@
+/**
+ * StateSet ACP Handler - TypeScript Type Definitions
+ */
+export declare enum CheckoutSessionStatus {
+    UNSPECIFIED = 0,
+    NOT_READY_FOR_PAYMENT = 1,
+    READY_FOR_PAYMENT = 2,
+    COMPLETED = 3,
+    CANCELED = 4
+}
+export declare enum MessageType {
+    UNSPECIFIED = 0,
+    INFO = 1,
+    WARNING = 2,
+    ERROR = 3
+}
+export declare enum OrderStatus {
+    UNSPECIFIED = 0,
+    PLACED = 1,
+    FAILED = 2,
+    REFUNDED = 3
+}
+export interface Money {
+    amount: number;
+    currency: string;
+}
+export interface Totals {
+    subtotal?: Money;
+    tax?: Money;
+    shipping?: Money;
+    discount?: Money;
+    grand_total?: Money;
+}
+export interface Address {
+    name?: string;
+    line1?: string;
+    line2?: string;
+    city?: string;
+    region?: string;
+    postal_code?: string;
+    country?: string;
+    phone?: string;
+    email?: string;
+}
+export interface Customer {
+    billing_address?: Address;
+    shipping_address?: Address;
+}
+export interface EstimatedDelivery {
+    earliest?: string;
+    latest?: string;
+}
+export interface FulfillmentChoice {
+    id: string;
+    label: string;
+    price?: Money;
+    est_delivery?: EstimatedDelivery;
+}
+export interface FulfillmentState {
+    selected_id?: string;
+    options?: FulfillmentChoice[];
+}
+export interface LineItem {
+    id: string;
+    title: string;
+    quantity: number;
+    unit_price?: Money;
+    variant_id?: string;
+    sku?: string;
+    image_url?: string;
+}
+export interface RequestItem {
+    id: string;
+    quantity: number;
+}
+export interface Links {
+    terms?: string;
+    privacy?: string;
+    order_permalink?: string;
+}
+export interface Message {
+    type: MessageType;
+    code?: string;
+    message: string;
+    param?: string;
+}
+export interface Order {
+    id: string;
+    checkout_session_id: string;
+    status: OrderStatus;
+    permalink_url?: string;
+}
+export interface CheckoutSession {
+    id: string;
+    status: CheckoutSessionStatus;
+    items: LineItem[];
+    totals?: Totals;
+    fulfillment?: FulfillmentState;
+    customer?: Customer;
+    links?: Links;
+    messages?: Message[];
+    created_at?: string;
+    updated_at?: string;
+}
+export interface CheckoutSessionWithOrder {
+    session: CheckoutSession;
+    order: Order;
+}
+export interface CreateCheckoutSessionRequest {
+    items: RequestItem[];
+    customer?: Customer;
+    fulfillment?: FulfillmentState;
+}
+export interface UpdateCheckoutSessionRequest {
+    session_id: string;
+    items?: RequestItem[];
+    customer?: Customer;
+    fulfillment?: FulfillmentState;
+}
+export interface PaymentRequest {
+    delegated_token?: string;
+    method?: string;
+}
+export interface CompleteCheckoutSessionRequest {
+    session_id: string;
+    payment: PaymentRequest;
+    customer?: Customer;
+    fulfillment?: FulfillmentState;
+}
+export interface PaymentMethod {
+    type: string;
+    card_number_type?: string;
+    number?: string;
+    exp_month?: string;
+    exp_year?: string;
+    name?: string;
+    cvc?: string;
+    cryptogram?: string;
+    eci_value?: string;
+    checks_performed?: string[];
+    iin?: string;
+    display_card_funding_type?: string;
+    display_wallet_type?: string;
+    display_brand?: string;
+    display_last4?: string;
+    metadata?: Record<string, unknown>;
+}
+export interface BillingAddress {
+    name?: string;
+    line_one?: string;
+    line_two?: string;
+    city?: string;
+    state?: string;
+    country?: string;
+    postal_code?: string;
+}
+export interface Allowance {
+    reason: string;
+    max_amount: number;
+    currency: string;
+    checkout_session_id?: string;
+    merchant_id?: string;
+    expires_at?: string;
+}
+export interface RiskSignal {
+    type: string;
+    score: number;
+    action?: string;
+}
+export interface DelegatePaymentRequest {
+    payment_method: PaymentMethod;
+    allowance: Allowance;
+    billing_address?: BillingAddress;
+    risk_signals?: RiskSignal[];
+    metadata?: Record<string, unknown>;
+}
+export interface DelegatePaymentResponse {
+    id: string;
+    created: string;
+    metadata?: Record<string, unknown>;
+}
+export interface AcpClientConfig {
+    /** Base URL for HTTP client (e.g., http://localhost:8080) */
+    baseUrl?: string;
+    /** gRPC host address (e.g., localhost:50051) */
+    grpcAddress?: string;
+    /** API key for authentication */
+    apiKey?: string;
+    /** Request timeout in milliseconds */
+    timeout?: number;
+}
+export interface AcpError {
+    type: 'invalid_request' | 'payment_error' | 'processing_error';
+    code: string;
+    message: string;
+    param?: string;
+}

package/dist/types.js

@@ -0,0 +1,30 @@
+"use strict";
+/**
+ * StateSet ACP Handler - TypeScript Type Definitions
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OrderStatus = exports.MessageType = exports.CheckoutSessionStatus = void 0;
+// Enums
+var CheckoutSessionStatus;
+(function (CheckoutSessionStatus) {
+    CheckoutSessionStatus[CheckoutSessionStatus["UNSPECIFIED"] = 0] = "UNSPECIFIED";
+    CheckoutSessionStatus[CheckoutSessionStatus["NOT_READY_FOR_PAYMENT"] = 1] = "NOT_READY_FOR_PAYMENT";
+    CheckoutSessionStatus[CheckoutSessionStatus["READY_FOR_PAYMENT"] = 2] = "READY_FOR_PAYMENT";
+    CheckoutSessionStatus[CheckoutSessionStatus["COMPLETED"] = 3] = "COMPLETED";
+    CheckoutSessionStatus[CheckoutSessionStatus["CANCELED"] = 4] = "CANCELED";
+})(CheckoutSessionStatus || (exports.CheckoutSessionStatus = CheckoutSessionStatus = {}));
+var MessageType;
+(function (MessageType) {
+    MessageType[MessageType["UNSPECIFIED"] = 0] = "UNSPECIFIED";
+    MessageType[MessageType["INFO"] = 1] = "INFO";
+    MessageType[MessageType["WARNING"] = 2] = "WARNING";
+    MessageType[MessageType["ERROR"] = 3] = "ERROR";
+})(MessageType || (exports.MessageType = MessageType = {}));
+var OrderStatus;
+(function (OrderStatus) {
+    OrderStatus[OrderStatus["UNSPECIFIED"] = 0] = "UNSPECIFIED";
+    OrderStatus[OrderStatus["PLACED"] = 1] = "PLACED";
+    OrderStatus[OrderStatus["FAILED"] = 2] = "FAILED";
+    OrderStatus[OrderStatus["REFUNDED"] = 3] = "REFUNDED";
+})(OrderStatus || (exports.OrderStatus = OrderStatus = {}));
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidHlwZXMuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi9zcmMvdHlwZXMudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IjtBQUFBOztHQUVHOzs7QUFFSCxRQUFRO0FBQ1IsSUFBWSxxQkFNWDtBQU5ELFdBQVkscUJBQXFCO0lBQy9CLCtFQUFlLENBQUE7SUFDZixtR0FBeUIsQ0FBQTtJQUN6QiwyRkFBcUIsQ0FBQTtJQUNyQiwyRUFBYSxDQUFBO0lBQ2IseUVBQVksQ0FBQTtBQUNkLENBQUMsRUFOVyxxQkFBcUIscUNBQXJCLHFCQUFxQixRQU1oQztBQUVELElBQVksV0FLWDtBQUxELFdBQVksV0FBVztJQUNyQiwyREFBZSxDQUFBO0lBQ2YsNkNBQVEsQ0FBQTtJQUNSLG1EQUFXLENBQUE7SUFDWCwrQ0FBUyxDQUFBO0FBQ1gsQ0FBQyxFQUxXLFdBQVcsMkJBQVgsV0FBVyxRQUt0QjtBQUVELElBQVksV0FLWDtBQUxELFdBQVksV0FBVztJQUNyQiwyREFBZSxDQUFBO0lBQ2YsaURBQVUsQ0FBQTtJQUNWLGlEQUFVLENBQUE7SUFDVixxREFBWSxDQUFBO0FBQ2QsQ0FBQyxFQUxXLFdBQVcsMkJBQVgsV0FBVyxRQUt0QiIsInNvdXJjZXNDb250ZW50IjpbIi8qKlxuICogU3RhdGVTZXQgQUNQIEhhbmRsZXIgLSBUeXBlU2NyaXB0IFR5cGUgRGVmaW5pdGlvbnNcbiAqL1xuXG4vLyBFbnVtc1xuZXhwb3J0IGVudW0gQ2hlY2tvdXRTZXNzaW9uU3RhdHVzIHtcbiAgVU5TUEVDSUZJRUQgPSAwLFxuICBOT1RfUkVBRFlfRk9SX1BBWU1FTlQgPSAxLFxuICBSRUFEWV9GT1JfUEFZTUVOVCA9IDIsXG4gIENPTVBMRVRFRCA9IDMsXG4gIENBTkNFTEVEID0gNCxcbn1cblxuZXhwb3J0IGVudW0gTWVzc2FnZVR5cGUge1xuICBVTlNQRUNJRklFRCA9IDAsXG4gIElORk8gPSAxLFxuICBXQVJOSU5HID0gMixcbiAgRVJST1IgPSAzLFxufVxuXG5leHBvcnQgZW51bSBPcmRlclN0YXR1cyB7XG4gIFVOU1BFQ0lGSUVEID0gMCxcbiAgUExBQ0VEID0gMSxcbiAgRkFJTEVEID0gMixcbiAgUkVGVU5ERUQgPSAzLFxufVxuXG4vLyBNb25leSBhbmQgcHJpY2luZ1xuZXhwb3J0IGludGVyZmFjZSBNb25leSB7XG4gIGFtb3VudDogbnVtYmVyO1xuICBjdXJyZW5jeTogc3RyaW5nO1xufVxuXG5leHBvcnQgaW50ZXJmYWNlIFRvdGFscyB7XG4gIHN1YnRvdGFsPzogTW9uZXk7XG4gIHRheD86IE1vbmV5O1xuICBzaGlwcGluZz86IE1vbmV5O1xuICBkaXNjb3VudD86IE1vbmV5O1xuICBncmFuZF90b3RhbD86IE1vbmV5O1xufVxuXG4vLyBBZGRyZXNzIGFuZCBjdXN0b21lclxuZXhwb3J0IGludGVyZmFjZSBBZGRyZXNzIHtcbiAgbmFtZT86IHN0cmluZztcbiAgbGluZTE/OiBzdHJpbmc7XG4gIGxpbmUyPzogc3RyaW5nO1xuICBjaXR5Pzogc3RyaW5nO1xuICByZWdpb24/OiBzdHJpbmc7XG4gIHBvc3RhbF9jb2RlPzogc3RyaW5nO1xuICBjb3VudHJ5Pzogc3RyaW5nO1xuICBwaG9uZT86IHN0cmluZztcbiAgZW1haWw/OiBzdHJpbmc7XG59XG5cbmV4cG9ydCBpbnRlcmZhY2UgQ3VzdG9tZXIge1xuICBiaWxsaW5nX2FkZHJlc3M/OiBBZGRyZXNzO1xuICBzaGlwcGluZ19hZGRyZXNzPzogQWRkcmVzcztcbn1cblxuLy8gRnVsZmlsbG1lbnRcbmV4cG9ydCBpbnRlcmZhY2UgRXN0aW1hdGVkRGVsaXZlcnkge1xuICBlYXJsaWVzdD86IHN0cmluZztcbiAgbGF0ZXN0Pzogc3RyaW5nO1xufVxuXG5leHBvcnQgaW50ZXJmYWNlIEZ1bGZpbGxtZW50Q2hvaWNlIHtcbiAgaWQ6IHN0cmluZztcbiAgbGFiZWw6IHN0cmluZztcbiAgcHJpY2U/OiBNb25leTtcbiAgZXN0X2RlbGl2ZXJ5PzogRXN0aW1hdGVkRGVsaXZlcnk7XG59XG5cbmV4cG9ydCBpbnRlcmZhY2UgRnVsZmlsbG1lbnRTdGF0ZSB7XG4gIHNlbGVjdGVkX2lkPzogc3RyaW5nO1xuICBvcHRpb25zPzogRnVsZmlsbG1lbnRDaG9pY2VbXTtcbn1cblxuLy8gTGluZSBpdGVtc1xuZXhwb3J0IGludGVyZmFjZSBMaW5lSXRlbSB7XG4gIGlkOiBzdHJpbmc7XG4gIHRpdGxlOiBzdHJpbmc7XG4gIHF1YW50aXR5OiBudW1iZXI7XG4gIHVuaXRfcHJpY2U/OiBNb25leTtcbiAgdmFyaWFudF9pZD86IHN0cmluZztcbiAgc2t1Pzogc3RyaW5nO1xuICBpbWFnZV91cmw/OiBzdHJpbmc7XG59XG5cbmV4cG9ydCBpbnRlcmZhY2UgUmVxdWVzdEl0ZW0ge1xuICBpZDogc3RyaW5nO1xuICBxdWFudGl0eTogbnVtYmVyO1xufVxuXG4vLyBMaW5rcyBhbmQgbWVzc2FnZXNcbmV4cG9ydCBpbnRlcmZhY2UgTGlua3Mge1xuICB0ZXJtcz86IHN0cmluZztcbiAgcHJpdmFjeT86IHN0cmluZztcbiAgb3JkZXJfcGVybWFsaW5rPzogc3RyaW5nO1xufVxuXG5leHBvcnQgaW50ZXJmYWNlIE1lc3NhZ2Uge1xuICB0eXBlOiBNZXNzYWdlVHlwZTtcbiAgY29kZT86IHN0cmluZztcbiAgbWVzc2FnZTogc3RyaW5nO1xuICBwYXJhbT86IHN0cmluZztcbn1cblxuLy8gT3JkZXJzXG5leHBvcnQgaW50ZXJmYWNlIE9yZGVyIHtcbiAgaWQ6IHN0cmluZztcbiAgY2hlY2tvdXRfc2Vzc2lvbl9pZDogc3RyaW5nO1xuICBzdGF0dXM6IE9yZGVyU3RhdHVzO1xuICBwZXJtYWxpbmtfdXJsPzogc3RyaW5nO1xufVxuXG4vLyBDaGVja291dCBzZXNzaW9uXG5leHBvcnQgaW50ZXJmYWNlIENoZWNrb3V0U2Vzc2lvbiB7XG4gIGlkOiBzdHJpbmc7XG4gIHN0YXR1czogQ2hlY2tvdXRTZXNzaW9uU3RhdHVzO1xuICBpdGVtczogTGluZUl0ZW1bXTtcbiAgdG90YWxzPzogVG90YWxzO1xuICBmdWxmaWxsbWVudD86IEZ1bGZpbGxtZW50U3RhdGU7XG4gIGN1c3RvbWVyPzogQ3VzdG9tZXI7XG4gIGxpbmtzPzogTGlua3M7XG4gIG1lc3NhZ2VzPzogTWVzc2FnZVtdO1xuICBjcmVhdGVkX2F0Pzogc3RyaW5nO1xuICB1cGRhdGVkX2F0Pzogc3RyaW5nO1xufVxuXG5leHBvcnQgaW50ZXJmYWNlIENoZWNrb3V0U2Vzc2lvbldpdGhPcmRlciB7XG4gIHNlc3Npb246IENoZWNrb3V0U2Vzc2lvbjtcbiAgb3JkZXI6IE9yZGVyO1xufVxuXG4vLyBSZXF1ZXN0IHR5cGVzXG5leHBvcnQgaW50ZXJmYWNlIENyZWF0ZUNoZWNrb3V0U2Vzc2lvblJlcXVlc3Qge1xuICBpdGVtczogUmVxdWVzdEl0ZW1bXTtcbiAgY3VzdG9tZXI/OiBDdXN0b21lcjtcbiAgZnVsZmlsbG1lbnQ/OiBGdWxmaWxsbWVudFN0YXRlO1xufVxuXG5leHBvcnQgaW50ZXJmYWNlIFVwZGF0ZUNoZWNrb3V0U2Vzc2lvblJlcXVlc3Qge1xuICBzZXNzaW9uX2lkOiBzdHJpbmc7XG4gIGl0ZW1zPzogUmVxdWVzdEl0ZW1bXTtcbiAgY3VzdG9tZXI/OiBDdXN0b21lcjtcbiAgZnVsZmlsbG1lbnQ/OiBGdWxmaWxsbWVudFN0YXRlO1xufVxuXG5leHBvcnQgaW50ZXJmYWNlIFBheW1lbnRSZXF1ZXN0IHtcbiAgZGVsZWdhdGVkX3Rva2VuPzogc3RyaW5nO1xuICBtZXRob2Q/OiBzdHJpbmc7XG59XG5cbmV4cG9ydCBpbnRlcmZhY2UgQ29tcGxldGVDaGVja291dFNlc3Npb25SZXF1ZXN0IHtcbiAgc2Vzc2lvbl9pZDogc3RyaW5nO1xuICBwYXltZW50OiBQYXltZW50UmVxdWVzdDtcbiAgY3VzdG9tZXI/OiBDdXN0b21lcjtcbiAgZnVsZmlsbG1lbnQ/OiBGdWxmaWxsbWVudFN0YXRlO1xufVxuXG4vLyBEZWxlZ2F0ZWQgUGF5bWVudCB0eXBlc1xuZXhwb3J0IGludGVyZmFjZSBQYXltZW50TWV0aG9kIHtcbiAgdHlwZTogc3RyaW5nO1xuICBjYXJkX251bWJlcl90eXBlPzogc3RyaW5nO1xuICBudW1iZXI/OiBzdHJpbmc7XG4gIGV4cF9tb250aD86IHN0cmluZztcbiAgZXhwX3llYXI/OiBzdHJpbmc7XG4gIG5hbWU/OiBzdHJpbmc7XG4gIGN2Yz86IHN0cmluZztcbiAgY3J5cHRvZ3JhbT86IHN0cmluZztcbiAgZWNpX3ZhbHVlPzogc3RyaW5nO1xuICBjaGVja3NfcGVyZm9ybWVkPzogc3RyaW5nW107XG4gIGlpbj86IHN0cmluZztcbiAgZGlzcGxheV9jYXJkX2Z1bmRpbmdfdHlwZT86IHN0cmluZztcbiAgZGlzcGxheV93YWxsZXRfdHlwZT86IHN0cmluZztcbiAgZGlzcGxheV9icmFuZD86IHN0cmluZztcbiAgZGlzcGxheV9sYXN0ND86IHN0cmluZztcbiAgbWV0YWRhdGE/OiBSZWNvcmQ8c3RyaW5nLCB1bmtub3duPjtcbn1cblxuZXhwb3J0IGludGVyZmFjZSBCaWxsaW5nQWRkcmVzcyB7XG4gIG5hbWU/OiBzdHJpbmc7XG4gIGxpbmVfb25lPzogc3RyaW5nO1xuICBsaW5lX3R3bz86IHN0cmluZztcbiAgY2l0eT86IHN0cmluZztcbiAgc3RhdGU/OiBzdHJpbmc7XG4gIGNvdW50cnk/OiBzdHJpbmc7XG4gIHBvc3RhbF9jb2RlPzogc3RyaW5nO1xufVxuXG5leHBvcnQgaW50ZXJmYWNlIEFsbG93YW5jZSB7XG4gIHJlYXNvbjogc3RyaW5nO1xuICBtYXhfYW1vdW50OiBudW1iZXI7XG4gIGN1cnJlbmN5OiBzdHJpbmc7XG4gIGNoZWNrb3V0X3Nlc3Npb25faWQ/OiBzdHJpbmc7XG4gIG1lcmNoYW50X2lkPzogc3RyaW5nO1xuICBleHBpcmVzX2F0Pzogc3RyaW5nO1xufVxuXG5leHBvcnQgaW50ZXJmYWNlIFJpc2tTaWduYWwge1xuICB0eXBlOiBzdHJpbmc7XG4gIHNjb3JlOiBudW1iZXI7XG4gIGFjdGlvbj86IHN0cmluZztcbn1cblxuZXhwb3J0IGludGVyZmFjZSBEZWxlZ2F0ZVBheW1lbnRSZXF1ZXN0IHtcbiAgcGF5bWVudF9tZXRob2Q6IFBheW1lbnRNZXRob2Q7XG4gIGFsbG93YW5jZTogQWxsb3dhbmNlO1xuICBiaWxsaW5nX2FkZHJlc3M/OiBCaWxsaW5nQWRkcmVzcztcbiAgcmlza19zaWduYWxzPzogUmlza1NpZ25hbFtdO1xuICBtZXRhZGF0YT86IFJlY29yZDxzdHJpbmcsIHVua25vd24+O1xufVxuXG5leHBvcnQgaW50ZXJmYWNlIERlbGVnYXRlUGF5bWVudFJlc3BvbnNlIHtcbiAgaWQ6IHN0cmluZztcbiAgY3JlYXRlZDogc3RyaW5nO1xuICBtZXRhZGF0YT86IFJlY29yZDxzdHJpbmcsIHVua25vd24+O1xufVxuXG4vLyBDbGllbnQgY29uZmlndXJhdGlvblxuZXhwb3J0IGludGVyZmFjZSBBY3BDbGllbnRDb25maWcge1xuICAvKiogQmFzZSBVUkwgZm9yIEhUVFAgY2xpZW50IChlLmcuLCBodHRwOi8vbG9jYWxob3N0OjgwODApICovXG4gIGJhc2VVcmw/OiBzdHJpbmc7XG4gIC8qKiBnUlBDIGhvc3QgYWRkcmVzcyAoZS5nLiwgbG9jYWxob3N0OjUwMDUxKSAqL1xuICBncnBjQWRkcmVzcz86IHN0cmluZztcbiAgLyoqIEFQSSBrZXkgZm9yIGF1dGhlbnRpY2F0aW9uICovXG4gIGFwaUtleT86IHN0cmluZztcbiAgLyoqIFJlcXVlc3QgdGltZW91dCBpbiBtaWxsaXNlY29uZHMgKi9cbiAgdGltZW91dD86IG51bWJlcjtcbn1cblxuLy8gQVBJIEVycm9yXG5leHBvcnQgaW50ZXJmYWNlIEFjcEVycm9yIHtcbiAgdHlwZTogJ2ludmFsaWRfcmVxdWVzdCcgfCAncGF5bWVudF9lcnJvcicgfCAncHJvY2Vzc2luZ19lcnJvcic7XG4gIGNvZGU6IHN0cmluZztcbiAgbWVzc2FnZTogc3RyaW5nO1xuICBwYXJhbT86IHN0cmluZztcbn1cbiJdfQ==

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "@stateset/acp-client",
+  "version": "1.0.0",
+  "description": "Node.js client for StateSet Agentic Commerce Protocol Handler",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "build": "tsc",
+    "build:proto": "grpc_tools_node_protoc --js_out=import_style=commonjs,binary:./src/generated --grpc_out=grpc_js:./src/generated --plugin=protoc-gen-grpc=`which grpc_tools_node_protoc_plugin` -I ./proto ./proto/acp_handler/v1/acp_handler.proto && grpc_tools_node_protoc --plugin=protoc-gen-ts=./node_modules/.bin/protoc-gen-ts --ts_out=grpc_js:./src/generated -I ./proto ./proto/acp_handler/v1/acp_handler.proto",
+    "prepare": "npm run build",
+    "test": "jest",
+    "lint": "eslint src --ext .ts"
+  },
+  "keywords": [
+    "stateset",
+    "acp",
+    "agentic-commerce",
+    "checkout",
+    "grpc",
+    "openai"
+  ],
+  "author": "StateSet",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/stateset/stateset-acp-handler"
+  },
+  "dependencies": {
+    "@grpc/grpc-js": "^1.10.0",
+    "@grpc/proto-loader": "^0.7.10"
+  },
+  "devDependencies": {
+    "@types/node": "^20.11.0",
+    "grpc-tools": "^1.12.4",
+    "grpc_tools_node_protoc_ts": "^5.3.3",
+    "typescript": "^5.3.3"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "files": [
+    "dist",
+    "proto"
+  ]
+}

package/proto/acp_handler/v1/acp_handler.proto

@@ -0,0 +1,232 @@
+syntax = "proto3";
+
+package acp_handler.v1;
+
+service AcpHandler {
+  rpc CreateCheckoutSession(CreateCheckoutSessionRequest) returns (CheckoutSession);
+  rpc GetCheckoutSession(GetCheckoutSessionRequest) returns (CheckoutSession);
+  rpc UpdateCheckoutSession(UpdateCheckoutSessionRequest) returns (CheckoutSession);
+  rpc CompleteCheckoutSession(CompleteCheckoutSessionRequest) returns (CheckoutSessionWithOrder);
+  rpc CancelCheckoutSession(CancelCheckoutSessionRequest) returns (CheckoutSession);
+  rpc DelegatePayment(DelegatePaymentRequest) returns (DelegatePaymentResponse);
+}
+
+message GetCheckoutSessionRequest {
+  string session_id = 1;
+}
+
+message CancelCheckoutSessionRequest {
+  string session_id = 1;
+}
+
+message CreateCheckoutSessionRequest {
+  repeated RequestItem items = 1;
+  Customer customer = 2;
+  FulfillmentState fulfillment = 3;
+}
+
+message UpdateCheckoutSessionRequest {
+  string session_id = 1;
+  RequestItemList items = 2;
+  Customer customer = 3;
+  FulfillmentState fulfillment = 4;
+}
+
+message CompleteCheckoutSessionRequest {
+  string session_id = 1;
+  PaymentRequest payment = 2;
+  Customer customer = 3;
+  FulfillmentState fulfillment = 4;
+}
+
+message RequestItemList {
+  repeated RequestItem items = 1;
+}
+
+message RequestItem {
+  string id = 1;
+  int32 quantity = 2;
+}
+
+message PaymentRequest {
+  // If empty, delegated token is not provided.
+  string delegated_token = 1;
+  // If empty, payment method is not provided.
+  string method = 2;
+}
+
+enum CheckoutSessionStatus {
+  CHECKOUT_SESSION_STATUS_UNSPECIFIED = 0;
+  NOT_READY_FOR_PAYMENT = 1;
+  READY_FOR_PAYMENT = 2;
+  COMPLETED = 3;
+  CANCELED = 4;
+}
+
+message CheckoutSession {
+  string id = 1;
+  CheckoutSessionStatus status = 2;
+  repeated LineItem items = 3;
+  Totals totals = 4;
+  FulfillmentState fulfillment = 5;
+  Customer customer = 6;
+  Links links = 7;
+  repeated Message messages = 8;
+  string created_at = 9;
+  string updated_at = 10;
+}
+
+message CheckoutSessionWithOrder {
+  CheckoutSession session = 1;
+  Order order = 2;
+}
+
+message LineItem {
+  string id = 1;
+  string title = 2;
+  int32 quantity = 3;
+  Money unit_price = 4;
+  string variant_id = 5;
+  string sku = 6;
+  string image_url = 7;
+}
+
+message Money {
+  int64 amount = 1;
+  string currency = 2;
+}
+
+message Totals {
+  Money subtotal = 1;
+  Money tax = 2;
+  Money shipping = 3;
+  Money discount = 4;
+  Money grand_total = 5;
+}
+
+message FulfillmentState {
+  string selected_id = 1;
+  repeated FulfillmentChoice options = 2;
+}
+
+message FulfillmentChoice {
+  string id = 1;
+  string label = 2;
+  Money price = 3;
+  EstimatedDelivery est_delivery = 4;
+}
+
+message EstimatedDelivery {
+  string earliest = 1;
+  string latest = 2;
+}
+
+message Customer {
+  Address billing_address = 1;
+  Address shipping_address = 2;
+}
+
+message Address {
+  string name = 1;
+  string line1 = 2;
+  string line2 = 3;
+  string city = 4;
+  string region = 5;
+  string postal_code = 6;
+  string country = 7;
+  string phone = 8;
+  string email = 9;
+}
+
+message Links {
+  string terms = 1;
+  string privacy = 2;
+  string order_permalink = 3;
+}
+
+enum MessageType {
+  MESSAGE_TYPE_UNSPECIFIED = 0;
+  INFO = 1;
+  WARNING = 2;
+  ERROR = 3;
+}
+
+message Message {
+  MessageType type = 1;
+  string code = 2;
+  string message = 3;
+  string param = 4;
+}
+
+enum OrderStatus {
+  ORDER_STATUS_UNSPECIFIED = 0;
+  PLACED = 1;
+  FAILED = 2;
+  REFUNDED = 3;
+}
+
+message Order {
+  string id = 1;
+  string checkout_session_id = 2;
+  OrderStatus status = 3;
+  string permalink_url = 4;
+}
+
+message DelegatePaymentRequest {
+  PaymentMethod payment_method = 1;
+  Allowance allowance = 2;
+  BillingAddress billing_address = 3;
+  repeated RiskSignal risk_signals = 4;
+  string metadata_json = 5;
+}
+
+message DelegatePaymentResponse {
+  string id = 1;
+  string created = 2;
+  string metadata_json = 3;
+}
+
+message PaymentMethod {
+  string type = 1;
+  string card_number_type = 2;
+  string number = 3;
+  string exp_month = 4;
+  string exp_year = 5;
+  string name = 6;
+  string cvc = 7;
+  string cryptogram = 8;
+  string eci_value = 9;
+  repeated string checks_performed = 10;
+  string iin = 11;
+  string display_card_funding_type = 12;
+  string display_wallet_type = 13;
+  string display_brand = 14;
+  string display_last4 = 15;
+  string metadata_json = 16;
+}
+
+message BillingAddress {
+  string name = 1;
+  string line_one = 2;
+  string line_two = 3;
+  string city = 4;
+  string state = 5;
+  string country = 6;
+  string postal_code = 7;
+}
+
+message Allowance {
+  string reason = 1;
+  int64 max_amount = 2;
+  string currency = 3;
+  string checkout_session_id = 4;
+  string merchant_id = 5;
+  string expires_at = 6;
+}
+
+message RiskSignal {
+  string type = 1;
+  int32 score = 2;
+  string action = 3;
+}
+