Funnel 接入与恢复

1import {2  createFunnelStartClient,3  createIndianaServer,4  createGuestToken,5} from "@tinkerlandai/indiana-sdk/server";6 7const options = {8  baseUrl: process.env.INDIANA_BASE_URL!,9  apiKey: process.env.INDIANA_SECRET_KEY!,10  scope: { projectId: process.env.INDIANA_PROJECT_ID!, environment: "sandbox" },11} as const;12const indiana = createIndianaServer(options);13const funnels = createFunnelStartClient(options);14 15export async function POST(request: Request) {16  if (request.headers.get("origin") !== process.env.APP_ORIGIN)17    return new Response("Forbidden", { status: 403 });18  const session = await requireHostSession(request);19  // Every run has a Customer. A signed-in user is named by your own user ID: Indiana creates the20  // Customer on first use with creation-only customerData (needs customers:write). A visitor is a21  // Guest kept in this session, referenced by its Indiana Customer ID.22  let customer;23  if (session.userId) {24    customer = { type: "externalUserId", value: session.userId } as const;25  } else {26    session.indianaGuestToken ??= createGuestToken();27    await session.save();28    const guest = await indiana.createGuestCustomer({ guestToken: session.indianaGuestToken });29    customer = { type: "id", value: guest.customerId } as const;30  }31  // Persist before the first request. Retries reuse the whole original input.32  if (!session.funnelStart) {33    session.funnelStart = {34      funnelId: process.env.INDIANA_FUNNEL_ID!,35      requestId: crypto.randomUUID(),36      customer,37      ...(session.userId ? { customerData: { attributes: { plan: session.plan } } } : {}),38      locale: session.locale,39      parameters: { commerce: { provider: "stripe", currency: "USD" } },40    };41    await session.save();42  }43  const result = await funnels.start(session.funnelStart);44  // The browser runs the Funnel as that Customer.45  const { customerToken } = session.userId46    ? await indiana.createCustomerSession(result.customerId!)47    : await indiana.resumeGuestSession({ guestToken: session.indianaGuestToken! });48  session.indianaRunToken = result.runToken;49  await session.save();50  return Response.json({ runToken: result.runToken, customerToken }, {51    headers: { "Cache-Control": "private, no-store" },52  });53}

1import { createFunnelRunController, showFunnelRun } from "@tinkerlandai/indiana-sdk";2 3// Your backend retains the original start request and run credential.4export async function openFunnel(container: HTMLElement) {5const response = await fetch("/api/indiana-funnel", {6  method: "POST", credentials: "same-origin", cache: "no-store",7});8if (!response.ok) throw new Error("Funnel bootstrap failed");9const { runToken, customerToken } = await response.json();10const client = createFunnelRunController({11  baseUrl: "https://your-indiana-host.example",12  scope: { projectId: "your-app-uuid", environment: "sandbox" },13  runToken,14});15client.identify(customerToken);16const handle = await showFunnelRun(container, {17  client,18  // Record-only purchase: your backend creates the Stripe Checkout Session from execution.19  onPurchase: ({ operation }) => startMerchantCheckout(operation.execution, operation.operationId),20  // External pages: without onOpenUrl the SDK opens this window or a new one as authored (openIn).21  onError: reportError,22});23// Keep the host's original bootstrap across navigation and payment returns.24// Destroy removes UI; close is an explicit server command.25return { handle, client, destroy() { handle.destroy(); client.reset(); } };26}27// On route leave: flow.destroy(). On explicit dismissal: await flow.client.submit({ operation: "close", requestId: crypto.randomUUID(), nodeId: flow.client.view!.nodeId, visit: flow.client.view!.visit, revision: flow.client.view!.revision });