ucpify 1.0.0

package/dist/cli.js

@@ -0,0 +1,207 @@
+#!/usr/bin/env node
+"use strict";
+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 __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+const commander_1 = require("commander");
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const schema_1 = require("./schema");
+const express_app_1 = require("./express-app");
+const program = new commander_1.Command();
+program
+    .name('ucp-server')
+    .description('Generate and run a UCP-compliant server for merchants')
+    .version('1.0.0');
+program
+    .command('init')
+    .description('Create a sample merchant configuration file')
+    .option('-o, --output <file>', 'Output file path', 'merchant-config.json')
+    .action((options) => {
+    const sampleConfig = {
+        name: 'My Store',
+        domain: 'http://localhost:3000',
+        currency: 'USD',
+        terms_url: 'https://example.com/terms',
+        privacy_url: 'https://example.com/privacy',
+        tax_rate: 0.08,
+        port: 3000,
+        items: [
+            {
+                id: 'item_001',
+                title: 'Classic T-Shirt',
+                description: 'A comfortable cotton t-shirt',
+                price: 2500, // $25.00 in cents
+                sku: 'TSH-001',
+            },
+            {
+                id: 'item_002',
+                title: 'Premium Hoodie',
+                description: 'Warm and stylish hoodie',
+                price: 5999, // $59.99 in cents
+                sku: 'HOO-001',
+            },
+        ],
+        shipping_options: [
+            {
+                id: 'standard',
+                title: 'Standard Shipping',
+                description: 'Arrives in 5-7 business days',
+                price: 500, // $5.00
+                estimated_days: '5-7 business days',
+            },
+            {
+                id: 'express',
+                title: 'Express Shipping',
+                description: 'Arrives in 2-3 business days',
+                price: 1500, // $15.00
+                estimated_days: '2-3 business days',
+            },
+            {
+                id: 'overnight',
+                title: 'Overnight Shipping',
+                description: 'Arrives next business day',
+                price: 2999, // $29.99
+                estimated_days: '1 business day',
+            },
+        ],
+        payment_handlers: [
+            {
+                namespace: 'com.stripe',
+                id: 'stripe_handler',
+                config: {
+                    publishable_key: 'pk_test_...',
+                },
+            },
+            {
+                namespace: 'com.paypal',
+                id: 'paypal_handler',
+                config: {
+                    client_id: 'your_paypal_client_id',
+                },
+            },
+        ],
+    };
+    fs.writeFileSync(options.output, JSON.stringify(sampleConfig, null, 2));
+    console.log(`✅ Created sample config at: ${options.output}`);
+    console.log('\n📝 Edit this file to configure your products, shipping, and payment handlers.');
+    console.log(`\n🚀 Run: npx ts-node src/cli.ts serve ${options.output}`);
+});
+program
+    .command('serve')
+    .description('Start the UCP server from a configuration file')
+    .argument('<config>', 'Path to merchant configuration JSON file')
+    .option('-p, --port <number>', 'Port to run on (overrides config)')
+    .option('--no-db', 'Use in-memory storage instead of SQLite')
+    .action((configPath, options) => {
+    try {
+        const configFile = path.resolve(configPath);
+        if (!fs.existsSync(configFile)) {
+            console.error(`❌ Config file not found: ${configFile}`);
+            process.exit(1);
+        }
+        const rawConfig = JSON.parse(fs.readFileSync(configFile, 'utf-8'));
+        const config = schema_1.MerchantConfigSchema.parse(rawConfig);
+        if (options.port) {
+            config.port = parseInt(options.port, 10);
+        }
+        const useDb = options.db !== false;
+        const app = (0, express_app_1.createExpressApp)(config, { useDb });
+        const port = config.port;
+        const storageType = useDb ? 'SQLite' : 'In-memory';
+        app.listen(port, () => {
+            console.log(`
+╔══════════════════════════════════════════════════════════════╗
+║                    🛒 UCP Server Running                     ║
+╠══════════════════════════════════════════════════════════════╣
+║  Merchant: ${config.name.padEnd(49)}║
+║  Domain:   ${config.domain.padEnd(49)}║
+║  Port:     ${String(port).padEnd(49)}║
+║  Storage:  ${storageType.padEnd(49)}║
+╠══════════════════════════════════════════════════════════════╣
+║  Endpoints:                                                  ║
+║  • GET  /.well-known/ucp              - UCP Profile          ║
+║  • POST /ucp/v1/checkout-sessions     - Create Checkout      ║
+║  • GET  /ucp/v1/checkout-sessions/:id - Get Checkout         ║
+║  • PUT  /ucp/v1/checkout-sessions/:id - Update Checkout      ║
+║  • POST /ucp/v1/checkout-sessions/:id/complete - Complete    ║
+║  • POST /ucp/v1/checkout-sessions/:id/cancel   - Cancel      ║
+║  • GET  /ucp/v1/orders                - List Orders          ║
+║  • GET  /ucp/v1/orders/:id            - Get Order            ║
+║  • GET  /ucp/v1/items                 - Product Catalog      ║
+║  • GET  /health                       - Health Check         ║
+╚══════════════════════════════════════════════════════════════╝
+
+🔗 UCP Profile: http://localhost:${port}/.well-known/ucp
+📦 Products: ${config.items.length} items loaded
+🚚 Shipping: ${config.shipping_options.length} options available
+💳 Payment Handlers: ${config.payment_handlers.length} configured
+💾 Storage: ${storageType}${useDb ? ' (./data/ucp.db)' : ''}
+        `);
+        });
+    }
+    catch (error) {
+        console.error('❌ Error:', error);
+        process.exit(1);
+    }
+});
+program
+    .command('validate')
+    .description('Validate a merchant configuration file')
+    .argument('<config>', 'Path to merchant configuration JSON file')
+    .action((configPath) => {
+    try {
+        const configFile = path.resolve(configPath);
+        if (!fs.existsSync(configFile)) {
+            console.error(`❌ Config file not found: ${configFile}`);
+            process.exit(1);
+        }
+        const rawConfig = JSON.parse(fs.readFileSync(configFile, 'utf-8'));
+        const config = schema_1.MerchantConfigSchema.parse(rawConfig);
+        console.log('✅ Configuration is valid!');
+        console.log(`\n📊 Summary:`);
+        console.log(`   • Name: ${config.name}`);
+        console.log(`   • Domain: ${config.domain}`);
+        console.log(`   • Currency: ${config.currency}`);
+        console.log(`   • Tax Rate: ${(config.tax_rate * 100).toFixed(2)}%`);
+        console.log(`   • Products: ${config.items.length}`);
+        console.log(`   • Shipping Options: ${config.shipping_options.length}`);
+        console.log(`   • Payment Handlers: ${config.payment_handlers.length}`);
+    }
+    catch (error) {
+        console.error('❌ Validation failed:', error);
+        process.exit(1);
+    }
+});
+program.parse();

package/dist/config.d.ts

@@ -0,0 +1,14 @@
+import 'dotenv/config';
+export declare const config: {
+    port: number;
+    nodeEnv: string;
+    databasePath: string;
+    logLevel: string;
+    domain: string;
+    stripeSecretKey: string;
+    stripeWebhookSecret: string;
+    paypalClientId: string;
+    paypalClientSecret: string;
+    paypalMode: "sandbox" | "live";
+};
+export type Config = typeof config;

package/dist/config.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.config = void 0;
+require("dotenv/config");
+exports.config = {
+    // Server
+    port: parseInt(process.env.PORT || '3000', 10),
+    nodeEnv: process.env.NODE_ENV || 'development',
+    // Database
+    databasePath: process.env.DATABASE_PATH || './data/ucp.db',
+    // Logging
+    logLevel: process.env.LOG_LEVEL || 'info',
+    // UCP
+    domain: process.env.UCP_DOMAIN || 'http://localhost:3000',
+    // Stripe
+    stripeSecretKey: process.env.STRIPE_SECRET_KEY || '',
+    stripeWebhookSecret: process.env.STRIPE_WEBHOOK_SECRET || '',
+    // PayPal
+    paypalClientId: process.env.PAYPAL_CLIENT_ID || '',
+    paypalClientSecret: process.env.PAYPAL_CLIENT_SECRET || '',
+    paypalMode: (process.env.PAYPAL_MODE || 'sandbox'),
+};

package/dist/db.d.ts

@@ -0,0 +1,4 @@
+import Database, { Database as DatabaseType } from 'better-sqlite3';
+export declare const db: DatabaseType;
+export declare function getDb(): Database.Database;
+export declare function isDbHealthy(): boolean;

package/dist/db.js

@@ -0,0 +1,129 @@
+"use strict";
+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 __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.db = void 0;
+exports.getDb = getDb;
+exports.isDbHealthy = isDbHealthy;
+const better_sqlite3_1 = __importDefault(require("better-sqlite3"));
+const config_1 = require("./config");
+const logger_1 = require("./logger");
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+// Ensure data directory exists
+const dataDir = path.dirname(config_1.config.databasePath);
+if (!fs.existsSync(dataDir)) {
+    fs.mkdirSync(dataDir, { recursive: true });
+}
+exports.db = new better_sqlite3_1.default(config_1.config.databasePath);
+// Enable WAL mode for better concurrent access
+exports.db.pragma('journal_mode = WAL');
+// Initialize schema
+const schema = `
+CREATE TABLE IF NOT EXISTS checkouts (
+  id TEXT PRIMARY KEY,
+  status TEXT NOT NULL,
+  currency TEXT NOT NULL,
+  buyer_json TEXT,
+  fulfillment_json TEXT,
+  payment_json TEXT,
+  totals_json TEXT NOT NULL,
+  links_json TEXT NOT NULL,
+  messages_json TEXT,
+  continue_url TEXT,
+  expires_at TEXT,
+  order_json TEXT,
+  payment_intent_id TEXT,
+  paypal_order_id TEXT,
+  payment_provider TEXT,
+  payment_status TEXT DEFAULT 'none',
+  created_at TEXT NOT NULL,
+  updated_at TEXT NOT NULL
+);
+
+CREATE TABLE IF NOT EXISTS line_items (
+  id TEXT NOT NULL,
+  checkout_id TEXT NOT NULL,
+  item_json TEXT NOT NULL,
+  quantity INTEGER NOT NULL,
+  totals_json TEXT,
+  PRIMARY KEY (id, checkout_id),
+  FOREIGN KEY (checkout_id) REFERENCES checkouts(id) ON DELETE CASCADE
+);
+
+CREATE TABLE IF NOT EXISTS orders (
+  id TEXT PRIMARY KEY,
+  checkout_id TEXT NOT NULL,
+  permalink_url TEXT,
+  buyer_json TEXT,
+  line_items_json TEXT NOT NULL,
+  totals_json TEXT NOT NULL,
+  fulfillment_json TEXT,
+  payment_intent_id TEXT,
+  paypal_order_id TEXT,
+  payment_provider TEXT,
+  payment_status TEXT DEFAULT 'pending',
+  created_at TEXT NOT NULL,
+  FOREIGN KEY (checkout_id) REFERENCES checkouts(id)
+);
+
+CREATE TABLE IF NOT EXISTS inventory (
+  item_id TEXT PRIMARY KEY,
+  stock INTEGER NOT NULL DEFAULT 0,
+  reserved INTEGER NOT NULL DEFAULT 0,
+  updated_at TEXT NOT NULL
+);
+
+CREATE INDEX IF NOT EXISTS idx_line_items_checkout ON line_items(checkout_id);
+CREATE INDEX IF NOT EXISTS idx_orders_checkout ON orders(checkout_id);
+CREATE INDEX IF NOT EXISTS idx_checkouts_status ON checkouts(status);
+`;
+exports.db.exec(schema);
+logger_1.logger.info({ path: config_1.config.databasePath }, 'Database initialized');
+// Helper functions
+function getDb() {
+    return exports.db;
+}
+function isDbHealthy() {
+    try {
+        exports.db.prepare('SELECT 1').get();
+        return true;
+    }
+    catch {
+        return false;
+    }
+}

package/dist/express-app.d.ts

@@ -0,0 +1,5 @@
+import express from 'express';
+import { MerchantConfig } from './schema';
+export declare function createExpressApp(config: MerchantConfig, options?: {
+    useDb?: boolean;
+}): express.Application;