agentmall 0.0.1 → 0.1.0

package/dist/cli.js

@@ -0,0 +1,575 @@
+#!/usr/bin/env node
+
+// src/constants.ts
+var BASE_URL = "https://api.agentmall.sh";
+var SERVICE_FEE_CENTS = 150;
+var SUPPORTED_RETAILERS = [
+  "amazon.com",
+  "walmart.com",
+  "target.com",
+  "bestbuy.com",
+  "homedepot.com",
+  "ebay.com",
+  "lowes.com",
+  "wayfair.com",
+  "acehardware.com",
+  "1800flowers.com",
+  "pokemoncenter.com"
+];
+
+// src/errors.ts
+var AgentMallError = class extends Error {
+  status;
+  body;
+  constructor(status2, body) {
+    const message = typeof body === "object" && body !== null && "error" in body ? body.error : `Request failed with status ${status2}`;
+    super(message);
+    this.name = "AgentMallError";
+    this.status = status2;
+    this.body = body;
+  }
+};
+var RateLimitError = class extends AgentMallError {
+  retryAfterMs;
+  constructor(body, retryAfterMs) {
+    super(429, body);
+    this.name = "RateLimitError";
+    this.retryAfterMs = retryAfterMs;
+  }
+};
+var PaymentRequiredError = class extends AgentMallError {
+  headers;
+  constructor(body, headers) {
+    super(402, body);
+    this.name = "PaymentRequiredError";
+    this.headers = headers;
+  }
+};
+var ValidationError = class extends AgentMallError {
+  constructor(body) {
+    super(400, body);
+    this.name = "ValidationError";
+  }
+};
+var ConflictError = class extends AgentMallError {
+  constructor(body) {
+    super(409, body);
+    this.name = "ConflictError";
+  }
+};
+
+// src/client.ts
+function createIdempotencyKey() {
+  return globalThis.crypto?.randomUUID?.() ?? `agentmall_${Date.now()}_${Math.random().toString(16).slice(2)}`;
+}
+var AgentMall = class {
+  baseUrl;
+  apiSecret;
+  _fetch;
+  products;
+  purchases;
+  payments;
+  refunds;
+  constructor(config = {}) {
+    this.baseUrl = (config.baseUrl ?? BASE_URL).replace(/\/$/, "");
+    this.apiSecret = config.apiSecret;
+    this._fetch = config.fetch ?? globalThis.fetch.bind(globalThis);
+    this.products = new AgentMallProducts(this);
+    this.purchases = new AgentMallPurchases(this);
+    this.payments = new AgentMallPayments(this);
+    this.refunds = new AgentMallRefunds(this);
+  }
+  /** @internal */
+  async request(method, path, options) {
+    const url = new URL(`${this.baseUrl}${path}`);
+    if (options?.params) {
+      for (const [key, value] of Object.entries(options.params)) {
+        if (value !== void 0) url.searchParams.set(key, value);
+      }
+    }
+    const headers = { ...options?.headers ?? {} };
+    if (options?.auth) {
+      if (!this.apiSecret) {
+        throw new Error("apiSecret is required for this endpoint");
+      }
+      headers["Authorization"] = `Bearer ${this.apiSecret}`;
+    }
+    if (options?.body) {
+      headers["Content-Type"] = "application/json";
+    }
+    const response = await this._fetch(url.toString(), {
+      method,
+      headers,
+      body: options?.body ? JSON.stringify(options.body) : void 0
+    });
+    if (!response.ok) {
+      let body;
+      try {
+        body = await response.json();
+      } catch {
+        body = await response.text().catch(() => null);
+      }
+      if (response.status === 429) {
+        const retryAfter = response.headers.get("Retry-After");
+        const retryMs = retryAfter ? parseInt(retryAfter, 10) * 1e3 : 6e4;
+        throw new RateLimitError(body, retryMs);
+      }
+      if (response.status === 402) {
+        throw new PaymentRequiredError(body, response.headers);
+      }
+      if (response.status === 400) {
+        throw new ValidationError(body);
+      }
+      if (response.status === 409) {
+        throw new ConflictError(body);
+      }
+      throw new AgentMallError(response.status, body);
+    }
+    return await response.json();
+  }
+};
+var AgentMallProducts = class {
+  constructor(client) {
+    this.client = client;
+  }
+  /** Look up product info by URL. Returns price, availability, variants, and suggested max_budget. */
+  async lookup(url) {
+    return this.client.request("GET", "/api/products", {
+      params: { url }
+    });
+  }
+};
+var AgentMallPurchases = class {
+  constructor(client) {
+    this.client = client;
+  }
+  /**
+   * Create a purchase. The first call returns a 402 MPP payment challenge.
+   * Use mppx-wrapped fetch to handle payment automatically, or catch PaymentRequiredError.
+   */
+  async create(body) {
+    const idempotencyKey = body.idempotency_key ?? createIdempotencyKey();
+    return this.client.request("POST", "/api/purchases", {
+      body: {
+        ...body,
+        idempotency_key: idempotencyKey
+      },
+      headers: {
+        "X-Idempotency-Key": idempotencyKey
+      }
+    });
+  }
+  /** Get a single purchase by ID. Requires apiSecret. */
+  async get(id) {
+    return this.client.request("GET", "/api/purchases", {
+      auth: true,
+      params: { id }
+    });
+  }
+  /** List purchases. Requires apiSecret. */
+  async list(filters) {
+    const result = await this.client.request(
+      "GET",
+      "/api/purchases",
+      { auth: true, params: filters }
+    );
+    return result.purchases;
+  }
+};
+var AgentMallPayments = class {
+  constructor(client) {
+    this.client = client;
+  }
+  /** Get a single payment by ID. Requires apiSecret. */
+  async get(id) {
+    return this.client.request("GET", "/api/payments", {
+      auth: true,
+      params: { id }
+    });
+  }
+  /** List payments. Requires apiSecret. */
+  async list(filters) {
+    const result = await this.client.request(
+      "GET",
+      "/api/payments",
+      { auth: true, params: filters }
+    );
+    return result.payments;
+  }
+};
+var AgentMallRefunds = class {
+  constructor(client) {
+    this.client = client;
+  }
+  /** Get a single refund by public ID. Requires apiSecret. */
+  async get(id) {
+    return this.client.request("GET", "/api/refunds", {
+      auth: true,
+      params: { id }
+    });
+  }
+  /** List refunds. Requires apiSecret. */
+  async list(filters) {
+    const result = await this.client.request(
+      "GET",
+      "/api/refunds",
+      { auth: true, params: filters }
+    );
+    return result.refunds;
+  }
+};
+
+// src/purchase.ts
+async function purchase(config) {
+  const { account, baseUrl, ...body } = config;
+  const mppxModule = await import("mppx");
+  const Mppx = mppxModule.Mppx ?? mppxModule.default?.Mppx;
+  const tempo = mppxModule.tempo ?? mppxModule.default?.tempo;
+  if (!Mppx || !tempo) {
+    throw new Error("mppx is required for purchases. Install it: npm install mppx");
+  }
+  const mppx = Mppx.create({
+    methods: [tempo({ account })],
+    polyfill: false
+  });
+  const client = new AgentMall({
+    baseUrl: baseUrl ?? BASE_URL,
+    fetch: mppx.fetch.bind(mppx)
+  });
+  return client.purchases.create(body);
+}
+
+// src/cli/display.ts
+function formatCents(cents) {
+  return `$${(cents / 100).toFixed(2)}`;
+}
+function displayProduct(product) {
+  console.log();
+  console.log(`  \x1B[1m${product.title}\x1B[0m`);
+  console.log(`  ${product.retailer} \u2014 ${product.availability}`);
+  console.log();
+  if (product.listPrice && product.discountPercent) {
+    console.log(
+      `  Price: \x1B[32m${formatCents(product.price)}\x1B[0m  \x1B[2m\x1B[9m${formatCents(product.listPrice)}\x1B[0m  \x1B[33m-${product.discountPercent}%\x1B[0m`
+    );
+  } else {
+    console.log(`  Price: \x1B[32m${formatCents(product.price)}\x1B[0m`);
+  }
+  if (product.variants?.length) {
+    console.log();
+    for (const v of product.variants) {
+      const label = v.label ? `${v.label}: ` : "";
+      console.log(`  ${label}\x1B[1m${v.value}\x1B[0m \u2014 $${v.price.toFixed(2)}`);
+    }
+  }
+  console.log();
+  console.log(
+    `  Suggested budget: \x1B[1m${formatCents(product.suggestedMaxBudget)}\x1B[0m (includes 15% buffer for tax & shipping)`
+  );
+  console.log(
+    `  Service fee: ${formatCents(SERVICE_FEE_CENTS)}`
+  );
+  console.log(
+    `  Total charge: \x1B[1m${formatCents(product.suggestedMaxBudget + SERVICE_FEE_CENTS)}\x1B[0m USDC`
+  );
+  if (product.cached) {
+    console.log(`  \x1B[33m\u26A0 Price from cache \u2014 may not reflect current listing\x1B[0m`);
+  }
+  console.log();
+}
+function displayOrderSummary(body) {
+  console.log();
+  console.log("  \x1B[1mOrder Summary\x1B[0m");
+  for (const item of body.items) {
+    const url = item.product_url;
+    const qty = item.quantity ?? 1;
+    console.log(`  ${qty}x ${url}`);
+    if (item.variant?.length) {
+      for (const v of item.variant) {
+        console.log(`     ${v.label}: ${v.value}`);
+      }
+    }
+  }
+  const addr = body.delivery_address;
+  console.log();
+  console.log(`  Ship to: ${addr.first_name} ${addr.last_name}`);
+  console.log(`  ${addr.address_line1}${addr.address_line2 ? `, ${addr.address_line2}` : ""}`);
+  console.log(`  ${addr.city}, ${addr.state ?? ""} ${addr.postal_code} ${addr.country}`);
+  console.log();
+  console.log(`  Max budget: \x1B[1m${formatCents(body.max_budget)}\x1B[0m + ${formatCents(SERVICE_FEE_CENTS)} fee`);
+  console.log();
+}
+function displayOrderResult(order) {
+  console.log();
+  if (order.status === "failed") {
+    console.log(`  \x1B[31m\u2717\x1B[0m Order failed during submission.`);
+  } else if (order.deduplicated) {
+    console.log(`  \x1B[33m\u21BA\x1B[0m Reused existing order.`);
+  } else {
+    console.log(`  \x1B[32m\u2713\x1B[0m Order placed!`);
+  }
+  console.log(`  ID: \x1B[1m${order.id}\x1B[0m`);
+  console.log(`  Status: ${order.status}`);
+  console.log();
+  console.log(
+    order.status === "failed" ? "  Check status for failure details and refund progress:" : "  Check status in 5-10 minutes:"
+  );
+  console.log(`  npx agentmall status ${order.id}`);
+  console.log();
+}
+function displayStatus(purchase2) {
+  console.log();
+  console.log(`  \x1B[1mOrder ${purchase2.id}\x1B[0m`);
+  console.log(`  Status: ${purchase2.status}`);
+  if (purchase2.items?.length) {
+    for (const item of purchase2.items) {
+      const price = item.price ? ` \u2014 ${formatCents(item.price)}` : "";
+      console.log(`  ${item.quantity}x ${item.title ?? item.productRef}${price}`);
+    }
+  }
+  if (purchase2.finalTotal) {
+    console.log(`  Final total: ${formatCents(purchase2.finalTotal)}`);
+  }
+  if (purchase2.failureReason) {
+    console.log(`  \x1B[31mFailure: ${purchase2.failureReason}\x1B[0m`);
+  }
+  if (purchase2.deliveryMethod) {
+    console.log(`  Shipping: ${purchase2.deliveryMethod}`);
+  }
+  console.log(`  Created: ${new Date(purchase2.createdAt).toLocaleString()}`);
+  console.log();
+}
+
+// src/cli/prompts.ts
+import { input, confirm, select } from "@inquirer/prompts";
+async function promptProductUrl() {
+  return input({
+    message: "Product URL",
+    validate: (value) => {
+      try {
+        const url = new URL(value);
+        const hostname = url.hostname.replace(/^www\./, "");
+        const supported = SUPPORTED_RETAILERS.some(
+          (d) => hostname === d || hostname.endsWith(`.${d}`)
+        );
+        if (!supported) return `Unsupported retailer: ${hostname}`;
+        return true;
+      } catch {
+        return "Invalid URL";
+      }
+    }
+  });
+}
+async function promptVariants(variants) {
+  const groups = /* @__PURE__ */ new Map();
+  for (const v of variants) {
+    const label = v.label ?? "Option";
+    const group = groups.get(label) ?? [];
+    group.push(v);
+    groups.set(label, group);
+  }
+  const selections = [];
+  for (const [label, options] of groups) {
+    if (options.length <= 1) continue;
+    const value = await select({
+      message: label,
+      choices: options.map((o) => ({
+        name: `${o.value} \u2014 $${o.price.toFixed(2)}`,
+        value: o.value
+      }))
+    });
+    selections.push({ label, value });
+  }
+  return selections;
+}
+async function promptAddress() {
+  const first_name = await input({ message: "First name" });
+  const last_name = await input({ message: "Last name" });
+  const address_line1 = await input({ message: "Address line 1" });
+  const address_line2 = await input({ message: "Address line 2 (optional)", default: "" });
+  const city = await input({ message: "City" });
+  const state = await input({
+    message: "State (2-letter code)",
+    validate: (v) => v.length === 2 ? true : "Must be a 2-letter state code"
+  });
+  const postal_code = await input({ message: "ZIP code" });
+  const phone_number = await input({
+    message: "Phone (+1...)",
+    validate: (v) => v.startsWith("+1") ? true : "Include +1 country code"
+  });
+  return {
+    first_name,
+    last_name,
+    address_line1,
+    ...address_line2 ? { address_line2 } : {},
+    city,
+    state: state.toUpperCase(),
+    postal_code,
+    phone_number,
+    country: "US"
+  };
+}
+async function promptConfirm(message) {
+  return confirm({ message });
+}
+async function promptBudget(suggested) {
+  const value = await input({
+    message: `Max budget in cents (suggested: ${suggested})`,
+    default: String(suggested),
+    validate: (v) => {
+      const n = parseInt(v, 10);
+      if (isNaN(n) || n <= 0) return "Must be a positive integer";
+      return true;
+    }
+  });
+  return parseInt(value, 10);
+}
+
+// src/cli/index.ts
+var EMAIL_PATTERN = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
+async function resolveAccount() {
+  try {
+    const { resolveAccount: resolve } = await import("mppx/cli");
+    return await resolve();
+  } catch {
+    const key = process.env.MPPX_PRIVATE_KEY;
+    if (!key) {
+      console.error("\x1B[31mNo wallet found.\x1B[0m");
+      console.error("Set MPPX_PRIVATE_KEY or run: npx mppx account create");
+      process.exit(1);
+    }
+    const { privateKeyToAccount } = await import("viem/accounts");
+    return privateKeyToAccount(key);
+  }
+}
+async function buy(urlArg) {
+  try {
+    console.log();
+    console.log("  \x1B[1magentmall\x1B[0m \u2014 Buy anything with a URL");
+    console.log();
+    const account = await resolveAccount();
+    const url = urlArg ?? await promptProductUrl();
+    const client = new AgentMall();
+    console.log("  Fetching product info...");
+    const product = await client.products.lookup(url);
+    displayProduct(product);
+    const variantSelections = product.variants?.length ? await promptVariants(product.variants) : void 0;
+    const address = await promptAddress();
+    const maxBudget = await promptBudget(product.suggestedMaxBudget);
+    const { input: input2 } = await import("@inquirer/prompts");
+    const buyerEmail = await input2({
+      message: "Email for order updates",
+      validate: (value) => EMAIL_PATTERN.test(value.trim()) ? true : "A valid email is required"
+    });
+    const body = {
+      items: [{
+        product_url: url,
+        quantity: 1,
+        ...variantSelections?.length ? { variant: variantSelections } : {}
+      }],
+      delivery_address: address,
+      max_budget: maxBudget,
+      buyer_email: buyerEmail
+    };
+    displayOrderSummary(body);
+    console.log(`  Total charge: \x1B[1m${formatCents(maxBudget + SERVICE_FEE_CENTS)}\x1B[0m USDC on Tempo`);
+    console.log();
+    const proceed = await promptConfirm("Place order?");
+    if (!proceed) {
+      console.log("  Cancelled.");
+      return;
+    }
+    console.log("  Placing order...");
+    const order = await purchase({
+      ...body,
+      account
+    });
+    displayOrderResult(order);
+  } catch (error) {
+    console.log();
+    if (error instanceof ValidationError) {
+      console.error(`  \x1B[31mValidation error:\x1B[0m ${error.message}`);
+      process.exitCode = 1;
+      return;
+    }
+    if (error instanceof ConflictError) {
+      console.error(`  \x1B[31mConflict:\x1B[0m ${error.message}`);
+      process.exitCode = 1;
+      return;
+    }
+    if (error instanceof RateLimitError) {
+      console.error(`  \x1B[31mRate limited:\x1B[0m retry in about ${Math.ceil(error.retryAfterMs / 1e3)}s`);
+      process.exitCode = 1;
+      return;
+    }
+    if (error instanceof AgentMallError) {
+      console.error(`  \x1B[31mRequest failed:\x1B[0m ${error.message}`);
+      process.exitCode = 1;
+      return;
+    }
+    throw error;
+  }
+}
+async function status(purchaseId) {
+  const apiSecret = process.env.AGENTMALL_API_SECRET;
+  if (!apiSecret) {
+    console.error("\x1B[31mAGENTMALL_API_SECRET is required.\x1B[0m");
+    process.exit(1);
+  }
+  const client = new AgentMall({ apiSecret });
+  const result = await client.purchases.get(purchaseId);
+  displayStatus(result);
+}
+
+// src/cli.ts
+var args = process.argv.slice(2);
+var command = args[0];
+async function main() {
+  try {
+    switch (command) {
+      case "buy":
+        await buy(args[1]);
+        break;
+      case "status":
+        if (!args[1]) {
+          console.error("Usage: agentmall status <purchase_id>");
+          process.exit(1);
+        }
+        await status(args[1]);
+        break;
+      case "help":
+      case "--help":
+      case "-h":
+        printHelp();
+        break;
+      default:
+        await buy(args[0]);
+        break;
+    }
+  } catch (err) {
+    if (err instanceof Error) {
+      console.error(`
+  \x1B[31mError: ${err.message}\x1B[0m
+`);
+    } else {
+      console.error(err);
+    }
+    process.exit(1);
+  }
+}
+function printHelp() {
+  console.log(`
+  \x1B[1magentmall\x1B[0m \u2014 Buy anything with a URL
+
+  Usage:
+    agentmall [url]              Buy a product (interactive)
+    agentmall buy <url>          Buy a product
+    agentmall status <id>        Check order status
+    agentmall help               Show this help
+
+  Environment:
+    MPPX_PRIVATE_KEY             Wallet private key for payments
+    AGENTMALL_API_SECRET         Operator secret for read endpoints
+`);
+}
+main();