ucpify 1.0.0

package/dist/schema.d.ts

@@ -0,0 +1,266 @@
+import { z } from 'zod';
+export declare const UCP_VERSION = "2026-01-11";
+export declare const ItemSchema: z.ZodObject<{
+    id: z.ZodString;
+    title: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    price: z.ZodNumber;
+    image_url: z.ZodOptional<z.ZodString>;
+    sku: z.ZodOptional<z.ZodString>;
+    stock: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export declare const ShippingOptionSchema: z.ZodObject<{
+    id: z.ZodString;
+    title: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    price: z.ZodNumber;
+    estimated_days: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const PaymentHandlerSchema: z.ZodObject<{
+    namespace: z.ZodString;
+    id: z.ZodString;
+    config: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>;
+export declare const MerchantConfigSchema: z.ZodObject<{
+    name: z.ZodString;
+    domain: z.ZodString;
+    currency: z.ZodDefault<z.ZodString>;
+    terms_url: z.ZodOptional<z.ZodString>;
+    privacy_url: z.ZodOptional<z.ZodString>;
+    items: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        title: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        price: z.ZodNumber;
+        image_url: z.ZodOptional<z.ZodString>;
+        sku: z.ZodOptional<z.ZodString>;
+        stock: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+    shipping_options: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        title: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        price: z.ZodNumber;
+        estimated_days: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+    payment_handlers: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        namespace: z.ZodString;
+        id: z.ZodString;
+        config: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$strip>>>;
+    tax_rate: z.ZodDefault<z.ZodNumber>;
+    port: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>;
+export type Item = z.infer<typeof ItemSchema>;
+export type ShippingOption = z.infer<typeof ShippingOptionSchema>;
+export type PaymentHandler = z.infer<typeof PaymentHandlerSchema>;
+export type MerchantConfig = z.infer<typeof MerchantConfigSchema>;
+export type CheckoutStatus = 'incomplete' | 'requires_escalation' | 'ready_for_complete' | 'complete_in_progress' | 'completed' | 'canceled';
+export interface Buyer {
+    email?: string;
+    first_name?: string;
+    last_name?: string;
+    phone?: string;
+}
+export interface Address {
+    id?: string;
+    first_name?: string;
+    last_name?: string;
+    street_address: string;
+    address_locality: string;
+    address_region: string;
+    postal_code: string;
+    address_country: string;
+}
+export interface LineItem {
+    id: string;
+    item: Item;
+    quantity: number;
+    totals?: {
+        type: string;
+        amount: number;
+    }[];
+}
+export interface FulfillmentOption {
+    id: string;
+    title: string;
+    description?: string;
+    totals: {
+        type: string;
+        amount: number;
+    }[];
+}
+export interface FulfillmentGroup {
+    id: string;
+    line_item_ids: string[];
+    selected_option_id?: string;
+    options: FulfillmentOption[];
+}
+export interface FulfillmentMethod {
+    id: string;
+    type: 'shipping' | 'pickup' | 'digital';
+    line_item_ids: string[];
+    selected_destination_id?: string;
+    destinations: Address[];
+    groups: FulfillmentGroup[];
+}
+export interface Fulfillment {
+    methods: FulfillmentMethod[];
+}
+export interface PaymentInstrument {
+    id: string;
+    handler_id: string;
+    type: string;
+    selected?: boolean;
+    display?: Record<string, unknown>;
+}
+export interface Payment {
+    instruments: PaymentInstrument[];
+}
+export interface CheckoutMessage {
+    type: 'error' | 'warning' | 'info';
+    code: string;
+    path?: string;
+    content: string;
+    severity: 'recoverable' | 'requires_buyer_input' | 'requires_buyer_review';
+}
+export interface OrderConfirmation {
+    id: string;
+    permalink_url?: string;
+}
+export interface CheckoutSession {
+    ucp: {
+        version: string;
+        capabilities: Record<string, {
+            version: string;
+        }[]>;
+        payment_handlers?: Record<string, {
+            id: string;
+            version: string;
+            config?: Record<string, unknown>;
+        }[]>;
+    };
+    id: string;
+    status: CheckoutStatus;
+    messages?: CheckoutMessage[];
+    currency: string;
+    buyer?: Buyer;
+    line_items: LineItem[];
+    totals: {
+        type: string;
+        amount: number;
+    }[];
+    links: {
+        type: string;
+        url: string;
+        title?: string;
+    }[];
+    fulfillment?: Fulfillment;
+    payment?: Payment;
+    continue_url?: string;
+    expires_at?: string;
+    order?: OrderConfirmation;
+}
+export interface Order {
+    ucp: {
+        version: string;
+        capabilities: Record<string, {
+            version: string;
+        }[]>;
+    };
+    id: string;
+    checkout_id: string;
+    permalink_url?: string;
+    line_items: LineItem[];
+    buyer?: Buyer;
+    totals: {
+        type: string;
+        amount: number;
+    }[];
+    fulfillment?: {
+        expectations: {
+            id: string;
+            line_items: {
+                id: string;
+                quantity: number;
+            }[];
+            method_type: string;
+            destination?: Address;
+            description?: string;
+            fulfillable_on?: string;
+        }[];
+        events: {
+            id: string;
+            occurred_at: string;
+            type: string;
+            line_items: {
+                id: string;
+                quantity: number;
+            }[];
+            tracking_number?: string;
+            tracking_url?: string;
+            description?: string;
+        }[];
+    };
+    created_at: string;
+}
+export declare const CreateCheckoutRequestSchema: z.ZodObject<{
+    line_items: z.ZodArray<z.ZodObject<{
+        id: z.ZodOptional<z.ZodString>;
+        item: z.ZodObject<{
+            id: z.ZodString;
+            title: z.ZodOptional<z.ZodString>;
+            price: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>;
+        quantity: z.ZodNumber;
+    }, z.core.$strip>>;
+    buyer: z.ZodOptional<z.ZodObject<{
+        email: z.ZodOptional<z.ZodString>;
+        first_name: z.ZodOptional<z.ZodString>;
+        last_name: z.ZodOptional<z.ZodString>;
+        phone: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    fulfillment: z.ZodOptional<z.ZodObject<{
+        methods: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            id: z.ZodOptional<z.ZodString>;
+            type: z.ZodEnum<{
+                shipping: "shipping";
+                pickup: "pickup";
+                digital: "digital";
+            }>;
+            line_item_ids: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            selected_destination_id: z.ZodOptional<z.ZodString>;
+            destinations: z.ZodArray<z.ZodObject<{
+                id: z.ZodOptional<z.ZodString>;
+                first_name: z.ZodOptional<z.ZodString>;
+                last_name: z.ZodOptional<z.ZodString>;
+                street_address: z.ZodString;
+                address_locality: z.ZodString;
+                address_region: z.ZodString;
+                postal_code: z.ZodString;
+                address_country: z.ZodString;
+            }, z.core.$strip>>;
+            groups: z.ZodOptional<z.ZodArray<z.ZodAny>>;
+        }, z.core.$strip>>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export declare const UpdateCheckoutRequestSchema: z.ZodObject<{
+    buyer: z.ZodOptional<z.ZodObject<{
+        email: z.ZodOptional<z.ZodString>;
+        first_name: z.ZodOptional<z.ZodString>;
+        last_name: z.ZodOptional<z.ZodString>;
+        phone: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    line_items: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodOptional<z.ZodString>;
+        item: z.ZodObject<{
+            id: z.ZodString;
+            title: z.ZodOptional<z.ZodString>;
+            price: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>;
+        quantity: z.ZodNumber;
+    }, z.core.$strip>>>;
+    fulfillment: z.ZodOptional<z.ZodAny>;
+}, z.core.$strip>;
+export type CreateCheckoutRequest = z.infer<typeof CreateCheckoutRequestSchema>;
+export type UpdateCheckoutRequest = z.infer<typeof UpdateCheckoutRequestSchema>;

package/dist/schema.js

@@ -0,0 +1,98 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UpdateCheckoutRequestSchema = exports.CreateCheckoutRequestSchema = exports.MerchantConfigSchema = exports.PaymentHandlerSchema = exports.ShippingOptionSchema = exports.ItemSchema = exports.UCP_VERSION = void 0;
+const zod_1 = require("zod");
+// UCP Version
+exports.UCP_VERSION = '2026-01-11';
+// Product/Item Schema
+exports.ItemSchema = zod_1.z.object({
+    id: zod_1.z.string(),
+    title: zod_1.z.string(),
+    description: zod_1.z.string().optional(),
+    price: zod_1.z.number().int().min(0), // Minor units (cents)
+    image_url: zod_1.z.string().url().optional(),
+    sku: zod_1.z.string().optional(),
+    stock: zod_1.z.number().int().min(0).optional(), // Inventory tracking
+});
+// Shipping Option Schema
+exports.ShippingOptionSchema = zod_1.z.object({
+    id: zod_1.z.string(),
+    title: zod_1.z.string(),
+    description: zod_1.z.string().optional(),
+    price: zod_1.z.number().int().min(0), // Minor units
+    estimated_days: zod_1.z.string().optional(),
+});
+// Payment Handler Schema
+exports.PaymentHandlerSchema = zod_1.z.object({
+    namespace: zod_1.z.string(), // e.g., "com.stripe", "com.google.pay"
+    id: zod_1.z.string(),
+    config: zod_1.z.record(zod_1.z.string(), zod_1.z.unknown()).optional(),
+});
+// Merchant Configuration Schema
+exports.MerchantConfigSchema = zod_1.z.object({
+    name: zod_1.z.string(),
+    domain: zod_1.z.string().url(),
+    currency: zod_1.z.string().default('USD'),
+    terms_url: zod_1.z.string().url().optional(),
+    privacy_url: zod_1.z.string().url().optional(),
+    items: zod_1.z.array(exports.ItemSchema),
+    shipping_options: zod_1.z.array(exports.ShippingOptionSchema).default([]),
+    payment_handlers: zod_1.z.array(exports.PaymentHandlerSchema).default([]),
+    tax_rate: zod_1.z.number().min(0).max(1).default(0), // e.g., 0.08 for 8%
+    port: zod_1.z.number().default(3000),
+});
+// Request validation schemas
+exports.CreateCheckoutRequestSchema = zod_1.z.object({
+    line_items: zod_1.z.array(zod_1.z.object({
+        id: zod_1.z.string().optional(),
+        item: zod_1.z.object({
+            id: zod_1.z.string(),
+            title: zod_1.z.string().optional(),
+            price: zod_1.z.number().int().min(0).optional(),
+        }),
+        quantity: zod_1.z.number().int().min(1).max(100),
+    })).min(1).max(50),
+    buyer: zod_1.z.object({
+        email: zod_1.z.string().email().optional(),
+        first_name: zod_1.z.string().max(100).optional(),
+        last_name: zod_1.z.string().max(100).optional(),
+        phone: zod_1.z.string().max(30).optional(),
+    }).optional(),
+    fulfillment: zod_1.z.object({
+        methods: zod_1.z.array(zod_1.z.object({
+            id: zod_1.z.string().optional(),
+            type: zod_1.z.enum(['shipping', 'pickup', 'digital']),
+            line_item_ids: zod_1.z.array(zod_1.z.string()).optional(),
+            selected_destination_id: zod_1.z.string().optional(),
+            destinations: zod_1.z.array(zod_1.z.object({
+                id: zod_1.z.string().optional(),
+                first_name: zod_1.z.string().max(100).optional(),
+                last_name: zod_1.z.string().max(100).optional(),
+                street_address: zod_1.z.string().max(200),
+                address_locality: zod_1.z.string().max(100),
+                address_region: zod_1.z.string().max(100),
+                postal_code: zod_1.z.string().max(20),
+                address_country: zod_1.z.string().length(2),
+            })),
+            groups: zod_1.z.array(zod_1.z.any()).optional(),
+        })).optional(),
+    }).optional(),
+});
+exports.UpdateCheckoutRequestSchema = zod_1.z.object({
+    buyer: zod_1.z.object({
+        email: zod_1.z.string().email().optional(),
+        first_name: zod_1.z.string().max(100).optional(),
+        last_name: zod_1.z.string().max(100).optional(),
+        phone: zod_1.z.string().max(30).optional(),
+    }).optional(),
+    line_items: zod_1.z.array(zod_1.z.object({
+        id: zod_1.z.string().optional(),
+        item: zod_1.z.object({
+            id: zod_1.z.string(),
+            title: zod_1.z.string().optional(),
+            price: zod_1.z.number().int().min(0).optional(),
+        }),
+        quantity: zod_1.z.number().int().min(1).max(100),
+    })).optional(),
+    fulfillment: zod_1.z.any().optional(),
+});

package/dist/stripe.d.ts

@@ -0,0 +1,14 @@
+import Stripe from 'stripe';
+export declare function getStripe(): Stripe | null;
+export declare function isStripeConfigured(): boolean;
+export interface CreatePaymentIntentParams {
+    amount: number;
+    currency: string;
+    checkoutId: string;
+    customerEmail?: string;
+    metadata?: Record<string, string>;
+}
+export declare function createPaymentIntent(params: CreatePaymentIntentParams): Promise<Stripe.PaymentIntent | null>;
+export declare function confirmPaymentIntent(paymentIntentId: string): Promise<Stripe.PaymentIntent | null>;
+export declare function cancelPaymentIntent(paymentIntentId: string): Promise<Stripe.PaymentIntent | null>;
+export declare function constructWebhookEvent(payload: string | Buffer, signature: string): Stripe.Event | null;

package/dist/stripe.js

@@ -0,0 +1,103 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getStripe = getStripe;
+exports.isStripeConfigured = isStripeConfigured;
+exports.createPaymentIntent = createPaymentIntent;
+exports.confirmPaymentIntent = confirmPaymentIntent;
+exports.cancelPaymentIntent = cancelPaymentIntent;
+exports.constructWebhookEvent = constructWebhookEvent;
+const stripe_1 = __importDefault(require("stripe"));
+const config_1 = require("./config");
+const logger_1 = require("./logger");
+let stripeClient = null;
+function getStripe() {
+    if (!config_1.config.stripeSecretKey) {
+        return null;
+    }
+    if (!stripeClient) {
+        stripeClient = new stripe_1.default(config_1.config.stripeSecretKey, {
+            apiVersion: '2026-01-28.clover',
+        });
+        logger_1.logger.info('Stripe client initialized');
+    }
+    return stripeClient;
+}
+function isStripeConfigured() {
+    return !!config_1.config.stripeSecretKey;
+}
+async function createPaymentIntent(params) {
+    const stripe = getStripe();
+    if (!stripe) {
+        logger_1.logger.warn('Stripe not configured, skipping payment intent creation');
+        return null;
+    }
+    try {
+        const paymentIntent = await stripe.paymentIntents.create({
+            amount: params.amount,
+            currency: params.currency.toLowerCase(),
+            metadata: {
+                checkout_id: params.checkoutId,
+                ...params.metadata,
+            },
+            receipt_email: params.customerEmail,
+            automatic_payment_methods: {
+                enabled: true,
+            },
+        }, {
+            idempotencyKey: `checkout_${params.checkoutId}`,
+        });
+        logger_1.logger.info({
+            paymentIntentId: paymentIntent.id,
+            checkoutId: params.checkoutId,
+            amount: params.amount,
+        }, 'Payment intent created');
+        return paymentIntent;
+    }
+    catch (error) {
+        logger_1.logger.error({ error, checkoutId: params.checkoutId }, 'Failed to create payment intent');
+        throw error;
+    }
+}
+async function confirmPaymentIntent(paymentIntentId) {
+    const stripe = getStripe();
+    if (!stripe)
+        return null;
+    try {
+        const paymentIntent = await stripe.paymentIntents.retrieve(paymentIntentId);
+        logger_1.logger.info({ paymentIntentId, status: paymentIntent.status }, 'Payment intent retrieved');
+        return paymentIntent;
+    }
+    catch (error) {
+        logger_1.logger.error({ error, paymentIntentId }, 'Failed to retrieve payment intent');
+        throw error;
+    }
+}
+async function cancelPaymentIntent(paymentIntentId) {
+    const stripe = getStripe();
+    if (!stripe)
+        return null;
+    try {
+        const paymentIntent = await stripe.paymentIntents.cancel(paymentIntentId);
+        logger_1.logger.info({ paymentIntentId }, 'Payment intent canceled');
+        return paymentIntent;
+    }
+    catch (error) {
+        logger_1.logger.error({ error, paymentIntentId }, 'Failed to cancel payment intent');
+        throw error;
+    }
+}
+function constructWebhookEvent(payload, signature) {
+    const stripe = getStripe();
+    if (!stripe || !config_1.config.stripeWebhookSecret)
+        return null;
+    try {
+        return stripe.webhooks.constructEvent(payload, signature, config_1.config.stripeWebhookSecret);
+    }
+    catch (error) {
+        logger_1.logger.error({ error }, 'Webhook signature verification failed');
+        return null;
+    }
+}

package/dist/ucp-server-db.d.ts

@@ -0,0 +1,72 @@
+import { MerchantConfig, CheckoutSession, Order, Buyer, Fulfillment } from './schema';
+export declare class UCPServerDB {
+    private config;
+    private itemsMap;
+    constructor(config: MerchantConfig);
+    getProfile(): {
+        ucp: {
+            version: string;
+            services: {
+                'dev.ucp.shopping': {
+                    version: string;
+                    spec: string;
+                    transport: string;
+                    endpoint: string;
+                    schema: string;
+                }[];
+            };
+            capabilities: {
+                'dev.ucp.shopping.checkout': {
+                    version: string;
+                    spec: string;
+                    schema: string;
+                }[];
+                'dev.ucp.shopping.fulfillment': {
+                    version: string;
+                    spec: string;
+                    schema: string;
+                    extends: string;
+                }[];
+                'dev.ucp.shopping.order': {
+                    version: string;
+                    spec: string;
+                    schema: string;
+                }[];
+            };
+            payment_handlers: Record<string, {
+                id: string;
+                version: string;
+                config?: Record<string, unknown>;
+            }[]>;
+        };
+    };
+    private buildLinks;
+    private buildPaymentHandlers;
+    private validateCheckout;
+    private calculateTotals;
+    private sessionFromRow;
+    createCheckout(data: {
+        line_items: {
+            id?: string;
+            item: {
+                id: string;
+                title?: string;
+                price?: number;
+            };
+            quantity: number;
+        }[];
+    }): CheckoutSession;
+    getCheckout(id: string): CheckoutSession | undefined;
+    updateCheckout(id: string, data: {
+        buyer?: Buyer;
+        line_items?: any[];
+        fulfillment?: Fulfillment;
+    }): CheckoutSession | undefined;
+    completeCheckout(id: string): Promise<CheckoutSession | {
+        error: string;
+    }>;
+    cancelCheckout(id: string): CheckoutSession | undefined;
+    getOrder(id: string): Order | undefined;
+    listOrders(): Order[];
+    getConfig(): MerchantConfig;
+}