@reactionary/acp 0.0.0-stage → 0.10.31

package/package.json

@@ -1,6 +1,20 @@
 {
   "name": "@reactionary/acp",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.10.31",
+  "type": "module",
+  "main": "./index.js",
+  "types": "./src/index.d.ts",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Solteq/reactionary.git"
+  },
+  "dependencies": {
+    "@reactionary/core": "0.10.31",
+    "@reactionary/feeds": "0.10.31",
+    "zod": "4.1.9"
+  },
+  "devDependencies": {
+    "vitest": "^4.0.9"
+  },
+  "sideEffects": false
 }

package/src/index.d.ts

@@ -0,0 +1,2 @@
+export * from './lib/acp-schemas.js';
+export * from './lib/reactionary-acp-server.js';

package/src/lib/acp-schemas.d.ts

@@ -0,0 +1,303 @@
+import * as z from 'zod';
+export declare const ACPItemSchema: z.ZodObject<{
+    id: z.ZodString;
+    quantity: z.ZodInt;
+}, z.core.$strip>;
+export declare const ACPBuyerSchema: z.ZodObject<{
+    name: z.ZodString;
+    email: z.ZodEmail;
+    phone_number: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const ACPAddressSchema: z.ZodObject<{
+    name: z.ZodString;
+    line_one: z.ZodString;
+    line_two: z.ZodOptional<z.ZodString>;
+    city: z.ZodString;
+    state: z.ZodString;
+    country: z.ZodString;
+    postal_code: z.ZodString;
+    phone_number: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const ACPCreateCheckoutSessionRequestSchema: z.ZodObject<{
+    buyer: z.ZodOptional<z.ZodObject<{
+        name: z.ZodString;
+        email: z.ZodEmail;
+        phone_number: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    items: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        quantity: z.ZodInt;
+    }, z.core.$strip>>;
+    fulfillment_address: z.ZodOptional<z.ZodObject<{
+        name: z.ZodString;
+        line_one: z.ZodString;
+        line_two: z.ZodOptional<z.ZodString>;
+        city: z.ZodString;
+        state: z.ZodString;
+        country: z.ZodString;
+        postal_code: z.ZodString;
+        phone_number: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export declare const ACPUpdateCheckoutSessionRequestSchema: z.ZodObject<{
+    buyer: z.ZodOptional<z.ZodObject<{
+        name: z.ZodString;
+        email: z.ZodEmail;
+        phone_number: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    items: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        quantity: z.ZodInt;
+    }, z.core.$strip>>>;
+    fulfillment_address: z.ZodOptional<z.ZodObject<{
+        name: z.ZodString;
+        line_one: z.ZodString;
+        line_two: z.ZodOptional<z.ZodString>;
+        city: z.ZodString;
+        state: z.ZodString;
+        country: z.ZodString;
+        postal_code: z.ZodString;
+        phone_number: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    fulfillment_option_id: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const ACPPaymentDataSchema: z.ZodObject<{
+    token: z.ZodString;
+    provider: z.ZodEnum<{
+        stripe: "stripe";
+        adyen: "adyen";
+        braintree: "braintree";
+    }>;
+    billing_address: z.ZodOptional<z.ZodObject<{
+        name: z.ZodString;
+        line_one: z.ZodString;
+        line_two: z.ZodOptional<z.ZodString>;
+        city: z.ZodString;
+        state: z.ZodString;
+        country: z.ZodString;
+        postal_code: z.ZodString;
+        phone_number: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export declare const ACPCompleteCheckoutSessionRequestSchema: z.ZodObject<{
+    buyer: z.ZodOptional<z.ZodObject<{
+        name: z.ZodString;
+        email: z.ZodEmail;
+        phone_number: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    payment_data: z.ZodObject<{
+        token: z.ZodString;
+        provider: z.ZodEnum<{
+            stripe: "stripe";
+            adyen: "adyen";
+            braintree: "braintree";
+        }>;
+        billing_address: z.ZodOptional<z.ZodObject<{
+            name: z.ZodString;
+            line_one: z.ZodString;
+            line_two: z.ZodOptional<z.ZodString>;
+            city: z.ZodString;
+            state: z.ZodString;
+            country: z.ZodString;
+            postal_code: z.ZodString;
+            phone_number: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export declare const ACPCheckoutSessionStateSchema: z.ZodObject<{
+    id: z.ZodString;
+    cartId: z.ZodString;
+    checkoutId: z.ZodString;
+    status: z.ZodEnum<{
+        not_ready_for_payment: "not_ready_for_payment";
+        ready_for_payment: "ready_for_payment";
+        completed: "completed";
+        canceled: "canceled";
+    }>;
+    buyer: z.ZodOptional<z.ZodObject<{
+        name: z.ZodString;
+        email: z.ZodEmail;
+        phone_number: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    fulfillmentAddress: z.ZodOptional<z.ZodObject<{
+        name: z.ZodString;
+        line_one: z.ZodString;
+        line_two: z.ZodOptional<z.ZodString>;
+        city: z.ZodString;
+        state: z.ZodString;
+        country: z.ZodString;
+        postal_code: z.ZodString;
+        phone_number: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    fulfillmentOptionId: z.ZodOptional<z.ZodString>;
+    orderId: z.ZodOptional<z.ZodString>;
+}, z.core.$loose>;
+export declare const ACPDescriptionSchema: z.ZodObject<{
+    plain: z.ZodOptional<z.ZodString>;
+    html: z.ZodOptional<z.ZodString>;
+    markdown: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const ACPMediaSchema: z.ZodObject<{
+    url: z.ZodString;
+    alt_text: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const ACPFeedPriceSchema: z.ZodObject<{
+    amount: z.ZodInt;
+    currency: z.ZodString;
+}, z.core.$strip>;
+export declare const ACPAvailabilitySchema: z.ZodObject<{
+    available: z.ZodOptional<z.ZodBoolean>;
+    status: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const ACPBarcodeSchema: z.ZodObject<{
+    type: z.ZodString;
+    value: z.ZodString;
+}, z.core.$strip>;
+export declare const ACPVariantOptionSchema: z.ZodObject<{
+    name: z.ZodString;
+    value: z.ZodString;
+}, z.core.$strip>;
+export declare const ACPFeedVariantSchema: z.ZodObject<{
+    id: z.ZodString;
+    title: z.ZodString;
+    description: z.ZodOptional<z.ZodObject<{
+        plain: z.ZodOptional<z.ZodString>;
+        html: z.ZodOptional<z.ZodString>;
+        markdown: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    url: z.ZodOptional<z.ZodString>;
+    barcodes: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        type: z.ZodString;
+        value: z.ZodString;
+    }, z.core.$strip>>>;
+    price: z.ZodOptional<z.ZodObject<{
+        amount: z.ZodInt;
+        currency: z.ZodString;
+    }, z.core.$strip>>;
+    list_price: z.ZodOptional<z.ZodObject<{
+        amount: z.ZodInt;
+        currency: z.ZodString;
+    }, z.core.$strip>>;
+    availability: z.ZodOptional<z.ZodObject<{
+        available: z.ZodOptional<z.ZodBoolean>;
+        status: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    variant_options: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        value: z.ZodString;
+    }, z.core.$strip>>>;
+    media: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        url: z.ZodString;
+        alt_text: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+export declare const ACPFeedProductSchema: z.ZodObject<{
+    id: z.ZodString;
+    title: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodObject<{
+        plain: z.ZodOptional<z.ZodString>;
+        html: z.ZodOptional<z.ZodString>;
+        markdown: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    url: z.ZodOptional<z.ZodString>;
+    media: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        url: z.ZodString;
+        alt_text: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+    variants: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        title: z.ZodString;
+        description: z.ZodOptional<z.ZodObject<{
+            plain: z.ZodOptional<z.ZodString>;
+            html: z.ZodOptional<z.ZodString>;
+            markdown: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        url: z.ZodOptional<z.ZodString>;
+        barcodes: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            type: z.ZodString;
+            value: z.ZodString;
+        }, z.core.$strip>>>;
+        price: z.ZodOptional<z.ZodObject<{
+            amount: z.ZodInt;
+            currency: z.ZodString;
+        }, z.core.$strip>>;
+        list_price: z.ZodOptional<z.ZodObject<{
+            amount: z.ZodInt;
+            currency: z.ZodString;
+        }, z.core.$strip>>;
+        availability: z.ZodOptional<z.ZodObject<{
+            available: z.ZodOptional<z.ZodBoolean>;
+            status: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        variant_options: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            value: z.ZodString;
+        }, z.core.$strip>>>;
+        media: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            url: z.ZodString;
+            alt_text: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export declare const ACPProductFeedResponseSchema: z.ZodObject<{
+    target_country: z.ZodOptional<z.ZodString>;
+    products: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        title: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodObject<{
+            plain: z.ZodOptional<z.ZodString>;
+            html: z.ZodOptional<z.ZodString>;
+            markdown: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        url: z.ZodOptional<z.ZodString>;
+        media: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            url: z.ZodString;
+            alt_text: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>>;
+        variants: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            title: z.ZodString;
+            description: z.ZodOptional<z.ZodObject<{
+                plain: z.ZodOptional<z.ZodString>;
+                html: z.ZodOptional<z.ZodString>;
+                markdown: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>;
+            url: z.ZodOptional<z.ZodString>;
+            barcodes: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                type: z.ZodString;
+                value: z.ZodString;
+            }, z.core.$strip>>>;
+            price: z.ZodOptional<z.ZodObject<{
+                amount: z.ZodInt;
+                currency: z.ZodString;
+            }, z.core.$strip>>;
+            list_price: z.ZodOptional<z.ZodObject<{
+                amount: z.ZodInt;
+                currency: z.ZodString;
+            }, z.core.$strip>>;
+            availability: z.ZodOptional<z.ZodObject<{
+                available: z.ZodOptional<z.ZodBoolean>;
+                status: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>;
+            variant_options: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                name: z.ZodString;
+                value: z.ZodString;
+            }, z.core.$strip>>>;
+            media: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                url: z.ZodString;
+                alt_text: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type ACPItem = z.infer<typeof ACPItemSchema>;
+export type ACPBuyer = z.infer<typeof ACPBuyerSchema>;
+export type ACPAddress = z.infer<typeof ACPAddressSchema>;
+export type ACPCreateCheckoutSessionRequest = z.infer<typeof ACPCreateCheckoutSessionRequestSchema>;
+export type ACPUpdateCheckoutSessionRequest = z.infer<typeof ACPUpdateCheckoutSessionRequestSchema>;
+export type ACPCompleteCheckoutSessionRequest = z.infer<typeof ACPCompleteCheckoutSessionRequestSchema>;
+export type ACPPaymentData = z.infer<typeof ACPPaymentDataSchema>;
+export type ACPCheckoutSessionState = z.infer<typeof ACPCheckoutSessionStateSchema>;
+export type ACPFeedProduct = z.infer<typeof ACPFeedProductSchema>;
+export type ACPFeedVariant = z.infer<typeof ACPFeedVariantSchema>;
+export type ACPProductFeedResponse = z.infer<typeof ACPProductFeedResponseSchema>;

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

@@ -0,0 +1,100 @@
+import { type Cache, type Cart, type Checkout, type Inventory, type LanguageContext, type PaymentMethod, type Price, type Product, type ProductSearchResult, type RequestContext, type Result, type SearchIdentifier, type ShippingMethod } from '@reactionary/core';
+import { type ReactionaryFeedInventoryOptions, type ReactionaryFeedProcessingOptions } from '@reactionary/feeds';
+import type { IncomingMessage, ServerResponse } from 'node:http';
+export interface ReactionaryACPClient {
+    cart?: {
+        createCart(payload: unknown): Promise<Result<Cart>>;
+        add(payload: unknown): Promise<Result<Cart>>;
+        getById(payload: unknown): Promise<Result<Cart>>;
+    };
+    checkout?: {
+        initiateCheckoutForCart(payload: unknown): Promise<Result<Checkout>>;
+        getById(payload: unknown): Promise<Result<Checkout>>;
+        setShippingAddress(payload: unknown): Promise<Result<Checkout>>;
+        getAvailableShippingMethods(payload: unknown): Promise<Result<ShippingMethod[]>>;
+        getAvailablePaymentMethods(payload: unknown): Promise<Result<PaymentMethod[]>>;
+        setShippingInstruction(payload: unknown): Promise<Result<Checkout>>;
+        addPaymentInstruction(payload: unknown): Promise<Result<Checkout>>;
+        finalizeCheckout(payload: unknown): Promise<Result<Checkout>>;
+    };
+    productSearch?: {
+        queryByTerm(payload: unknown): Promise<Result<ProductSearchResult>>;
+    };
+    product?: {
+        getBySKU(payload: unknown): Promise<Result<Product>>;
+    };
+    price?: {
+        getListPrice(payload: unknown): Promise<Result<Price>>;
+        getCustomerPrice(payload: unknown): Promise<Result<Price>>;
+    };
+    inventory?: {
+        getBySKU(payload: unknown): Promise<Result<Inventory>>;
+    };
+}
+export type ReactionaryACPClientFactory<TClient extends ReactionaryACPClient = ReactionaryACPClient> = (requestContext: RequestContext) => TClient;
+export interface ReactionaryACPServerOptions {
+    name?: string;
+    version?: string;
+    basePath?: string;
+    sessionCache?: Cache;
+    sessionTtlSeconds?: number;
+    checkoutSessionTtlSeconds?: number;
+    paymentProvider?: ACPPaymentProvider;
+    links?: ACPLink[];
+    productFeed?: ACPProductFeedOptions;
+}
+export type ACPPaymentProcessor = 'stripe' | 'adyen' | 'braintree';
+export interface ACPPaymentProvider {
+    provider: ACPPaymentProcessor;
+    supported_payment_methods: ['card'];
+}
+export interface ACPLink {
+    type: 'terms_of_use' | 'privacy_policy' | 'seller_shop_policies';
+    url: string;
+}
+export interface ACPProductFeedOptions extends ReactionaryFeedInventoryOptions, ReactionaryFeedProcessingOptions {
+    feeds: Record<string, ACPProductFeedDefinition>;
+}
+export interface ACPProductFeedDefinition {
+    languageContext: LanguageContext;
+    search: SearchIdentifier;
+    pageSize?: number;
+    maxPages?: number;
+    productUrlBase?: string;
+    fulfillmentCenterKeys?: string[];
+    fulfillmentCenterKey?: string;
+}
+export interface ReactionaryACPHttpHandler {
+    fetch(request: Request): Promise<Response>;
+    close(): Promise<void>;
+}
+export type ReactionaryACPNodeRequestHandler = (request: IncomingMessage, response: ServerResponse) => Promise<void>;
+export declare class ReactionaryACPServer<TClient extends ReactionaryACPClient = ReactionaryACPClient> {
+    private readonly clientFactory;
+    private readonly options;
+    private readonly sessionStore;
+    private readonly checkoutSessionStore;
+    constructor(clientFactory: ReactionaryACPClientFactory<TClient>, options?: ReactionaryACPServerOptions);
+    fetch(request: Request): Promise<Response>;
+    getHandler(): ReactionaryACPHttpHandler;
+    toNodeHandler(): ReactionaryACPNodeRequestHandler;
+    close(): Promise<void>;
+    private createRequestContext;
+    private handleRequest;
+    private getReadinessDocument;
+    private getProductFeed;
+    private getRequestedProductFeed;
+    private getProductFeedDefinition;
+    private handlePost;
+    private createCheckoutSession;
+    private updateCheckoutSession;
+    private getCheckoutSession;
+    private completeCheckoutSession;
+    private cancelCheckoutSession;
+    private createCartForItems;
+    private getRequiredCheckoutSessionState;
+    private getReactionaryCheckout;
+    private toACPCheckoutSession;
+    private getFulfillmentOptions;
+    private getPaymentProvider;
+}