Generic Node HTTP recipe

npm install @atmosphere-money/app-node@beta tsx

import { createServer } from "node:http";
import { createAtmAppClient } from "@atmosphere-money/app-node";

const atm = createAtmAppClient({
  getServiceAuthToken: ({ lxm, aud }) => mintAppServiceAuthJwt({ lxm, aud })
});

async function handleCheckout(request: Request) {
  const { recipientDid, amountCents } = await request.json();
  const payout = await atm.getPayoutStatus(recipientDid);
  if (!payout.payable) return json(409, { error: "RecipientNotPayable" });

  const approval = await atm.requestRecipientApproval({
    recipientDid,
    environment: "test",
    paymentTypes: ["shop"],
    feeShareBps: 300,
    requestReason: "Enable Node checkout"
  });
  if (approval.status !== "approved") {
    return json(409, {
      error: "RecipientAppApprovalRequired",
      approvalUrl: approval.dashboardUrl
    });
  }

  const order = await createAppOrder({ recipientDid, amountCents });
  const checkout = await atm.initiatePayment({
    environment: "test",
    recipient: order.recipientDid,
    amount: order.amountCents,
    currency: "usd",
    paymentType: "shop",
    returnUrl: `https://app.example/orders/${order.id}/return`,
    cancelUrl: `https://app.example/orders/${order.id}`,
    metadata: { appOrderId: order.id }
  });
  return json(200, { url: checkout.url, token: checkout.token });
}

import { constructAtmWebhookEvent } from "@atmosphere-money/app-node";

async function handleWebhook(request: Request) {
  const rawBody = await request.text();
  const event = constructAtmWebhookEvent({
    rawBody,
    secret: process.env.ATM_WEBHOOK_SECRET!,
    headers: {
      signature: request.headers.get("atm-signature"),
      deliveryId: request.headers.get("atm-delivery-id"),
      event: request.headers.get("atm-event"),
      apiVersion: request.headers.get("atm-api-version"),
      environment: request.headers.get("atm-environment")
    }
  });

  if (await hasHandled(event.id)) return json(200, { ok: true, duplicate: true });
  await fulfillFromAtmEvent(event);
  await markHandled(event.id);
  return json(200, { ok: true });
}

cd examples/atm-node-app
cp .env.example .env
npm install
npm run typecheck
npm run smoke