[wixysam]

Reviews the payments reference and changes the docs pipeline so the user and service role methods share one page. The regenerated docs go in a separate docs PR.

Payments page

• Overview: a capability list for the whole module, a Providers table, and Authentication modes. The Errors paragraph moves to the PaymentsErrorCode intro.
• One page: ServiceRolePaymentsModule is appended as "Service role methods", and PaymentsErrorCode sits under an "Errors" heading.
• Method order follows the checkout flow: preloadCheckout(), mountCheckout(), completeCheckout(), listPurchases(), and on the service role, createCheckout(), completeCheckout(), listPurchases(), and then refunds and subscriptions.
• Content:
  • createCheckout() explains redirect and embedded checkouts.
  • listPurchases() says why PayPal needs a checkout_id or subscription_id.
  • The user methods link to their service role versions.
  • The service role completeCheckout() stands on its own.
• Examples: shorter tab titles, a plain preloadCheckout() call, a Stripe success page example, and a backend example that confirms a purchase before granting access.
• Naming: "Wix Payments" is now "Base44 Payments", the product name. The first mention is "Base44 Payments powered by Wix".

Pipeline

• Appended modules: an appended module's section is headed with its interface name, so typesWithOwnMethods in page-sections.json can rename it. The connectors and integrations special cases now match ## UserConnectorsModule and ## CustomIntegrationsModule, and their output doesn't change.
• Links: links back to the host module, or to an appended module by its slug, become same-page anchors.
• Returns sections: a Returns section shows the method's @returns text, and falls back to the return type's description only when there's none. Before, both showed, as in "A mounted embedded checkout." followed by "Promise resolving to the mounted checkout once it renders." This removes about 90 generic lines across the App SDK reference and 5 in the Platform SDK. Two descriptions with details that appear nowhere else moved into @returns:
  • createCheckout()
  • openLiveSession() on useChat()
• Helper types: AiGatewayConnectionOptions, ConnectorApiRequest, and ConnectorApiResponse already render inline, so they're on the delete-after-processing list and no longer show up as modules in the nav.

Also in this PR

• AI Gateway: the video generation JSDoc from docs(ai-gateway): document video generation #305, plus four punctuation fixes that are already live on the published page. Without them, a regen from main would remove the published Video section. docs(ai-gateway): document video generation #305's other two commits are already covered on main, so it can be closed after this merges.
• Connectors: a style and accuracy pass on the metered connectors section, callApi(), and its request and response types:
  • house style, with no em dashes, colon breaks, or status codes in prose
  • "credits" instead of "integration credits", now that metered calls bill unified credits
  • callApi()'s integration type no longer points at the Available connectors table, which lists getConnection() connectors only
• sdk-docs-writing skill:
  • when {@link} can't be used: methods on another page, and methods mentioned in type or property comments
  • plain calls first in examples, with a React tab only when needed
  • "the current user"

Checks

• App SDK: npm test, 430 passing
• Platform SDK: test:types, plus test:unit with 160 passing
• Lint: npm run lint is clean
• Regen: create-docs for both packages. Reviewed the output page by page.

🤖 Generated with Claude Code

[github-actions]

🚀 Package Preview Available! (@base44/platform)

---

Install this PR's preview build with npm:

npm i @base44-preview/platform@0.6.0-pr.364.6994ab8

Prefer not to change any import paths? Install using npm alias so your code still imports @base44/platform:

npm i "@base44/platform@npm:@base44-preview/platform@0.6.0-pr.364.6994ab8"

Or add it to your package.json dependencies:

{
  "dependencies": {
    "@base44/platform": "npm:@base44-preview/platform@0.6.0-pr.364.6994ab8"
  }
}

• 📦 Preview Package: @base44-preview/platform@0.6.0-pr.364.6994ab8
• 🔗 View this commit on GitHub

---

_{Preview published to npm registry — try new features instantly!}

[github-actions]

🚀 Package Preview Available!

---

Install this PR's preview build with npm:

npm i @base44-preview/sdk@0.8.58-beta.0-pr.364.6994ab8

Prefer not to change any import paths? Install using npm alias so your code still imports @base44/sdk:

npm i "@base44/sdk@npm:@base44-preview/sdk@0.8.58-beta.0-pr.364.6994ab8"

Or add it to your package.json dependencies:

{
  "dependencies": {
    "@base44/sdk": "npm:@base44-preview/sdk@0.8.58-beta.0-pr.364.6994ab8"
  }
}

• 📦 Preview Package: @base44-preview/sdk@0.8.58-beta.0-pr.364.6994ab8
• 🔗 View this commit on GitHub

---

_{Preview published to npm registry — try new features instantly!}