@wix/agent-skills 1.35.1 → 1.36.1

package/skills/wix-vibe-headless/references/donations/INSTRUCTIONS.md

@@ -1,88 +0,0 @@
-# Wix Donations — client-only REST
-
-Connect the existing site's campaigns to the donor UI. No SDK, backend, Editor widget or replacement
-site. The public `WIX_CLIENT_ID` and shared visitor transport select the content site; never put owner
-credentials in the app. Do not gate donating behind member login.
-
-Read [How to Code Donations](../../../wix-headless/references/inline-recipes/how-to-code-donations.md)
-for the exact contract/troubleshooting/verification, and
-[Donations experience](../../../wix-headless/references/inline-recipes/experience-donations.md) for the donor journey.
-If a sibling skill is absent, read the same path under `https://www.wix.com/skills/`.
-
-## Shipped helper, presentation yours
-
-Copy `app/` and `../shared/app/` into the app's `src/` (the platform deploy step does this for you).
-The added file is `src/rest/wix-donations.js`; the shared transport/config stay shared with any other
-vertical. Keep the existing theme and routing system; this vertical ships no page or provider.
-On an existing app, deploy upgrades only the exact unmodified legacy transport. If it reports a
-customized/incompatible transport, merge the shared transport's strict-error support and capability
-export into that file before retrying; do not overwrite custom auth or silently ignore the warning.
-
-| Export | Returns / behavior |
-| --- | --- |
-| `queryDonationCampaigns({ limit?, cursor? })` | `{ campaigns, nextCursor }`; raw REST entities, IDs are `id`. Continue paging; do not hardcode seed IDs. |
-| `getDonationCampaign(id)` | The raw campaign, or null for missing/archived. Other failures throw. |
-| `getDonationCampaignMetrics(id)` | `currencyMetricsList`; call only with a goal. A denied/unavailable read is not zero fundraising. |
-| `donationCartBody(campaign, selection)` | Validates the choice and creates the numeric, one-time-omitting Cart V2 body; does not call Wix. |
-| `donationCheckoutUrl(id, selection, { origin?, campaignPath?, thankYouPath? }?)` | Rereads the campaign, creates a standalone cart, then a redirect session. Returns the hosted URL; does not navigate or mark anything paid. Errors retain `status`, `body`, `stage`, and a known `cartId`. |
-
-`selection` is `{ amount, frequency: 'ONE_TIME'|'WEEK'|'MONTH'|'YEAR', coverFee, note }`.
-Use fields from the actual campaign: `predefinedDonationAmounts[].price` (decimal string amounts,
-formatted display values), preset `.description` (impact), `donationFrequencies`,
-`customAmountEnabled` / `customAmountOptions`, `commentsEnabled`, `askDonorCoverFee`, optional
-`campaignGoal`. There is no campaign story or slug field. Keep story copy in the site, not in fake data.
-
-## Wire the donor surfaces
-
-Build the cause-led home/navigation, `/donate` discovery (or the single cause's form), a campaign
-route `/donate/:id`, and `/donate/thank-you` in the existing router. Make direct links/refresh work;
-wire the static thank-you route before a catch-all ID route. Unknown/archived is a real not-found
-state. Active status is `COLLECTING`; a reached goal does not necessarily stop collection.
-
-The presentation owns giving-intent routing and short-lived per-campaign draft recovery, as defined
-in the shared recipe: preserve choices through discovery, refresh and checkout cancellation. The
-helper does not persist a form. Save before leaving, restore/revalidate on return, and keep notes out
-of URLs and logs; do not infer completion or clear a draft from the callback alone.
-
-The form offers configured frequencies/presets/custom bounds, impact text, optional note and optional
-fee choice. Explain the recurring commitment and fee beside the action. Fee coverage is the catalog's
-2.9% option, not an arbitrary surcharge; the helper sends the base amount and flag. Render prices in
-the verified site currency; do not assume `$` because the API amount is a string. Preserve validation
-and choices, disable repeated submits, and show a recoverable inline failure without leaking raw donor
-data. Use a distinct loading, empty and failed-query state. Source real progress only where readable.
-
-```js
-import { donationCheckoutUrl } from '@/rest/wix-donations';
-
-// In the form's one submit handler, after client validation; pending blocks repeat activation.
-setPending(true);
-try {
-  const url = await donationCheckoutUrl(campaign.id, { amount, frequency, coverFee, note });
-  window.location.assign(url); // full document, exact URL — not the app router
-} catch (error) {
-  console.error('Donation checkout failed', { // safe diagnostic fields; original response is error.body
-    stage: error.stage, status: error.status,
-    code: error.body?.details?.applicationError?.code ?? error.body?.code,
-  });
-  setError('We could not open checkout. Please check your selection and try again.');
-} finally {
-  setPending(false);
-}
-```
-
-Use your host's actual paths/origin in the optional callback parameters when these routes differ.
-The deployed origin must be allowed on the OAuth client. The return page cannot claim payment from
-`orderId` alone; if an authorized order read is unavailable, acknowledge without amount/name/paid
-claims. Donor history and subscription management are not shipped here; do not invent controls.
-
-## Completion
-
-Follow the integration recipe's anonymous API smoke test and verify desktop/phone form states and
-the hosted checkout's cause/amount/cadence before calling the flow complete. API creation is not a
-paid donation. Do not take a real payment without explicit authorization. Report setup/verification
-limits, including payment-enabled plan/provider and allowed origins; do not explain an
-`ITEM_NOT_FOUND_IN_CATALOG` away as premium or reinstall apps before checking the option types.
-
-Campaign changes require owner authorization and the [management recipe](../../../wix-manage/references/donations/create-and-update-donation-campaigns.md).
-Preserve existing campaigns when only connecting the front. The canonical campaign dashboard route
-is the app-ID fallback: `https://manage.wix.com/dashboard/<SITE_ID>/app/333b456e-dd48-4d6b-b32b-9fd48d74e163`.

package/skills/wix-vibe-headless/references/donations/app/rest/wix-donations.js

@@ -1,112 +0,0 @@
-// Public REST only. Configure the public client id in the shared wix-config.js.
-// docs: https://dev.wix.com/docs/api-reference/business-solutions/donations/donation-campaigns/e-commerce-integration-with-donation-campaigns
-// docs: https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/purchase-flow/cart-v2/create-cart
-// docs: https://dev.wix.com/docs/api-reference/business-management/headless/redirects/create-redirect-session
-import * as wixClient from './wix-client.js';
-
-export const DONATIONS_APP_ID = '333b456e-dd48-4d6b-b32b-9fd48d74e163';
-const CAMPAIGNS = '/donation-campaigns/v2/donation-campaigns';
-const RECURRING = ['WEEK', 'MONTH', 'YEAR'];
-const request = (path, options = {}) => {
-  if (wixClient.WIX_API_SUPPORTS_STRICT_PAYMENT_ERRORS !== true) {
-    const error = new Error('Donations needs the updated Wix transport. Re-run the Donations deploy step; for a customized src/rest/wix-client.js, merge strict payment-error support from the shared transport before retrying.');
-    error.code = 'DONATIONS_TRANSPORT_UPGRADE_REQUIRED';
-    throw error;
-  }
-  return wixClient.wixApiRequest(path, { ...options, throwOnPaymentRequired: true });
-};
-
-/** Raw REST campaigns; page until nextCursor is null. Failures never become an empty result. */
-export async function queryDonationCampaigns({ limit = 100, cursor } = {}) {
-  const data = await request(`${CAMPAIGNS}/query`, { body: {
-    query: { filter: { archived: false }, cursorPaging: { limit, ...(cursor ? { cursor } : {}) } },
-  } });
-  return { campaigns: data.donationCampaigns ?? [], nextCursor: data.pagingMetadata?.cursors?.next ?? null };
-}
-
-/** null only for an absent/archived campaign; authorization and transport errors propagate. */
-export async function getDonationCampaign(id) {
-  try {
-    const { donationCampaign } = await request(`${CAMPAIGNS}/${encodeURIComponent(id)}`, { method: 'GET' });
-    return donationCampaign && !donationCampaign.archived ? donationCampaign : null;
-  } catch (error) {
-    if (error.status === 404) return null;
-    throw error;
-  }
-}
-
-/** Call only for a campaign with a goal. A failed read must not be displayed as zero fundraising. */
-export async function getDonationCampaignMetrics(id) {
-  const data = await request(`${CAMPAIGNS}/${encodeURIComponent(id)}/metrics`, { method: 'GET' });
-  return data.currencyMetricsList ?? [];
-}
-
-/** Pure, independently testable conversion from a live campaign and donor selection to Cart V2. */
-export function donationCartBody(campaign, { amount: chosen, frequency = 'ONE_TIME', coverFee = false, note = '' } = {}) {
-  if (!campaign?.id || campaign.archived || campaign.status !== 'COLLECTING') {
-    throw new Error('This campaign is not accepting donations.');
-  }
-  if ((typeof chosen !== 'string' && typeof chosen !== 'number') || String(chosen).trim() === '') {
-    throw new Error('Enter a positive donation amount.');
-  }
-  const amount = Number(chosen);
-  if (!Number.isFinite(amount) || amount <= 0) throw new Error('Enter a positive donation amount.');
-  if (!['ONE_TIME', ...RECURRING].includes(frequency) || !campaign.donationFrequencies?.includes(frequency)) {
-    throw new Error('Choose a frequency offered by this campaign.');
-  }
-  const isPreset = campaign.predefinedDonationAmounts?.some(preset => Number(preset.price?.amount) === amount);
-  if (!isPreset) {
-    if (!campaign.customAmountEnabled) throw new Error('Choose one of the suggested amounts.');
-    const { minimum, maximum } = campaign.customAmountOptions ?? {};
-    if (minimum && amount < Number(minimum.amount)) throw new Error(`The minimum donation is ${minimum.formattedAmount ?? minimum.amount}.`);
-    if (maximum && amount > Number(maximum.amount)) throw new Error(`The maximum donation is ${maximum.formattedAmount ?? maximum.amount}.`);
-  }
-  if (coverFee && !campaign.askDonorCoverFee) throw new Error('Fee coverage is not offered by this campaign.');
-  const message = String(note).trim();
-  if (message && !campaign.commentsEnabled) throw new Error('Notes are not enabled for this campaign.');
-  if (message.length > 1000) throw new Error('Keep your note within 1,000 characters.');
-  return {
-    cart: { source: { channelType: 'WEB' }, ...(message ? { note: message } : {}) },
-    catalogItems: [{ quantity: 1, catalogReference: {
-      appId: DONATIONS_APP_ID,
-      catalogItemId: campaign.id,
-      options: { amount, ...(frequency !== 'ONE_TIME' ? { frequency } : {}), ...(coverFee ? { donorCoveringFees: true } : {}) },
-    } }],
-  };
-}
-
-/** Read current settings → one standalone Cart V2 → one hosted session. Never merges the current cart. */
-export async function donationCheckoutUrl(campaignId, selection, {
-  origin = typeof window !== 'undefined' ? window.location.origin : '',
-  campaignPath = `/donate/${encodeURIComponent(campaignId)}`,
-  thankYouPath = '/donate/thank-you',
-} = {}) {
-  const site = new URL(origin);
-  if (!['https:', 'http:'].includes(site.protocol)) throw new Error('A valid site origin is required.');
-  const back = new URL(campaignPath, site.origin);
-  const thanks = new URL(thankYouPath, site.origin);
-  if (back.origin !== site.origin || thanks.origin !== site.origin) throw new Error('Checkout callbacks must use this site origin.');
-  let stage = 'campaign';
-  let cartId;
-  try {
-    const campaign = await getDonationCampaign(campaignId);
-    const body = donationCartBody(campaign, selection);
-    stage = 'cart';
-    const result = await request('/ecom/v2/carts', { body });
-    cartId = result.cart?.id;
-    if (!cartId) throw new Error('Checkout could not start: no cart id returned.');
-    stage = 'redirect';
-    const session = await request('/_api/redirects-api/v1/redirect-session', { body: {
-      ecomCheckout: { checkoutId: cartId },
-      callbacks: { postFlowUrl: back.href, thankYouPageUrl: thanks.href },
-    } });
-    const url = session.redirectSession?.fullUrl;
-    if (!url) throw new Error('Checkout could not start: no redirect URL returned.');
-    return url;
-  } catch (error) {
-    // Preserve the original HTTP status/body; stage and known cart id let the caller diagnose safely.
-    error.stage = stage;
-    if (cartId) error.cartId = cartId;
-    throw error;
-  }
-}

package/skills/wix-vibe-headless/references/donations/seed/SEED.md

@@ -1,11 +0,0 @@
-# Donations setup
-
-When the user asks for campaign setup, use the owner-authorized
-[Create and Update Donation Campaigns](../../../../wix-manage/references/donations/create-and-update-donation-campaigns.md)
-recipe. If it is not installed, read
-`https://www.wix.com/skills/wix-manage/references/donations/create-and-update-donation-campaigns.md`.
-This vertical has no second seed implementation. Confirm the site and changes, read first, preserve
-existing campaigns, and never run owner operations using the browser's visitor credentials.
-
-For a frontend-only request, do not seed at all. Report missing campaign/payment setup rather than
-creating mock causes, fundraising figures or a replacement site.

package/skills/wix-vibe-headless/references/donations/tests/donations.test.mjs

@@ -1,258 +0,0 @@
-// Compose the same shared + vertical files that deploy.cjs copies. Network is always mocked.
-// node --test skills/wix-vibe-headless/references/donations/tests/donations.test.mjs
-import test, { after } from 'node:test';
-import assert from 'node:assert/strict';
-import { cp, mkdtemp, writeFile, readFile, rm } from 'node:fs/promises';
-import { tmpdir } from 'node:os';
-import { join } from 'node:path';
-import { pathToFileURL } from 'node:url';
-import { runInNewContext } from 'node:vm';
-import { createHash } from 'node:crypto';
-
-const transportSource = await readFile(new URL('../../shared/app/rest/wix-client.js', import.meta.url), 'utf8');
-const donationSource = await readFile(new URL('../app/rest/wix-donations.js', import.meta.url), 'utf8');
-const legacyTransportSource = transportSource
-  .replace('export const WIX_API_SUPPORTS_STRICT_PAYMENT_ERRORS = true;\n', '')
-  .replace(', throwOnPaymentRequired?: boolean', '')
-  .replace(', throwOnPaymentRequired = false', '')
-  .replace('res.status === 402 && !throwOnPaymentRequired', 'res.status === 402');
-
-const moduleUrl = source => `data:text/javascript;base64,${Buffer.from(source).toString('base64')}`;
-function helperWithTransport(source) {
-  const standalone = source
-    .replace('export { WIX_CLIENT_ID } from "./wix-config.js";', '')
-    .replace('import { WIX_CLIENT_ID } from "./wix-config.js";', 'const WIX_CLIENT_ID = "public-test-client";');
-  return import(moduleUrl(donationSource.replace("'./wix-client.js'", JSON.stringify(moduleUrl(standalone)))));
-}
-
-async function deployFixture(existingTransport, verticals = ['donations']) {
-  const script = await readFile(new URL('../../../install/deploy.cjs', import.meta.url), 'utf8');
-  const ref = '/app/.agents/skills/wix-vibe-headless/references';
-  const files = new Map([
-    [`${ref}/shared/app/rest/wix-client.js`, transportSource],
-    [`${ref}/shared/app/rest/wix-config.js`, 'export const WIX_CLIENT_ID = "<YOUR-CLIENT-ID>";\nexport const WIX_METASITE_ID = "<YOUR-SITE-ID>";'],
-    [`${ref}/donations/app/rest/wix-donations.js`, donationSource],
-    [`${ref}/cms/app/rest/wix-cms.js`, 'export const fixture = true;'],
-  ]);
-  if (existingTransport !== undefined) files.set('/app/src/rest/wix-client.js', existingTransport);
-  const copies = [];
-  const writes = [];
-  let result;
-  const fs = {
-    existsSync: path => files.has(path) || [...files.keys()].some(file => file.startsWith(`${path}/`)),
-    cpSync: (from, to, options = {}) => {
-      copies.push({ from, to, options });
-      const entries = [...files].filter(([path]) => path === from || path.startsWith(`${from}/`));
-      assert.ok(entries.length, `Missing copy source: ${from}`);
-      for (const [path, source] of entries) {
-        const destination = `${to}${path.slice(from.length)}`;
-        if (!files.has(destination) || options.force !== false) files.set(destination, source);
-      }
-    },
-    mkdirSync: () => {},
-    writeFileSync: (path, source) => { writes.push(path); files.set(path, source); },
-    readFileSync: path => { assert.ok(files.has(path), `Missing fixture file: ${path}`); return files.get(path); },
-  };
-  const process = { argv: ['node', 'deploy.cjs', ...verticals, '--client-id', 'test-client', '--metasite-id', 'test-site'], exitCode: 0 };
-  runInNewContext(script, {
-    require: name => {
-      if (name === 'fs') return fs;
-      assert.equal(name, 'crypto');
-      return { createHash };
-    },
-    process,
-    console: { log: value => { result = JSON.parse(value); } },
-  });
-  return { result, files, copies, writes, exitCode: process.exitCode };
-}
-
-const fixture = await mkdtemp(join(tmpdir(), 'wix-donation-contract-'));
-await cp(new URL('../../shared/app/', import.meta.url), fixture, { recursive: true });
-await cp(new URL('../app/', import.meta.url), fixture, { recursive: true });
-await writeFile(join(fixture, 'package.json'), '{"type":"module"}');
-await writeFile(join(fixture, 'rest/wix-config.js'), 'export const WIX_CLIENT_ID = "public-test-client";');
-const api = await import(pathToFileURL(join(fixture, 'rest/wix-donations.js')));
-const transport = await import(pathToFileURL(join(fixture, 'rest/wix-client.js')));
-const originalFetch = globalThis.fetch;
-const originalWindow = globalThis.window;
-const storage = new Map();
-globalThis.window = { location: { origin: 'https://donor.example.test' }, localStorage: {
-  getItem: key => storage.get(key) ?? null, setItem: (key, value) => storage.set(key, value), removeItem: key => storage.delete(key),
-} };
-after(async () => { globalThis.fetch = originalFetch; globalThis.window = originalWindow; await rm(fixture, { recursive: true, force: true }); });
-
-const campaign = {
-  id: 'campaign-id', status: 'COLLECTING', donationFrequencies: ['ONE_TIME', 'MONTH'],
-  predefinedDonationAmounts: [{ id: 'preset-id', price: { amount: '25.00' } }],
-  customAmountEnabled: true, customAmountOptions: { minimum: { amount: '5.00' }, maximum: { amount: '1000' } },
-  askDonorCoverFee: true, commentsEnabled: true,
-};
-const json = (body, status = 200) => new Response(JSON.stringify(body), { status, headers: { 'Content-Type': 'application/json' } });
-function mockRequests(override = () => undefined) {
-  const calls = [];
-  globalThis.fetch = async (url, options) => {
-    const path = new URL(url).pathname;
-    const body = options.body ? JSON.parse(options.body) : undefined;
-    calls.push({ path, body, options });
-    const overridden = override(path, body);
-    if (overridden) return overridden;
-    if (path === '/oauth2/token') return json({ access_token: 'visitor-test-token', refresh_token: 'test-refresh', expires_in: 3600 });
-    if (path.endsWith('/campaign-id')) return json({ donationCampaign: campaign });
-    if (path === '/ecom/v2/carts') return json({ cart: { id: 'cart-id' } });
-    if (path === '/_api/redirects-api/v1/redirect-session') return json({ redirectSession: { fullUrl: 'https://checkout.example.test/session' } });
-    throw new Error(`Unexpected test request: ${path}`);
-  };
-  return calls;
-}
-
-test('one-time flow uses one visitor, one standalone cart and one redirect; no V1 checkout', async () => {
-  const calls = mockRequests();
-  assert.equal(await api.donationCheckoutUrl('campaign-id', { amount: '25', frequency: 'ONE_TIME' }), 'https://checkout.example.test/session');
-  const businessCalls = calls.filter(call => call.path !== '/oauth2/token');
-  assert.deepEqual(businessCalls.map(call => call.path), [
-    '/donation-campaigns/v2/donation-campaigns/campaign-id', '/ecom/v2/carts', '/_api/redirects-api/v1/redirect-session',
-  ]);
-  assert.ok(businessCalls.every(call => call.options.headers.Authorization === 'visitor-test-token'));
-  assert.deepEqual(businessCalls[1].body.catalogItems[0].catalogReference.options, { amount: 25 });
-  assert.deepEqual(businessCalls[2].body, { ecomCheckout: { checkoutId: 'cart-id' }, callbacks: {
-    postFlowUrl: 'https://donor.example.test/donate/campaign-id', thankYouPageUrl: 'https://donor.example.test/donate/thank-you',
-  } });
-});
-
-test('recurrence, fees and note preserve donor choices without double-charging the fee', () => {
-  const body = api.donationCartBody(campaign, { amount: '37.50', frequency: 'MONTH', coverFee: true, note: ' A message ' });
-  assert.deepEqual(body.catalogItems[0].catalogReference.options, { amount: 37.5, frequency: 'MONTH', donorCoveringFees: true });
-  assert.equal(body.cart.note, 'A message');
-});
-
-test('selection validation respects campaign settings and permits correction', () => {
-  for (const amount of ['', 'oops', 0, -1, Infinity, true, null, {}, 1, 1001]) {
-    assert.throws(() => api.donationCartBody(campaign, { amount }));
-  }
-  assert.equal(api.donationCartBody(campaign, { amount: 10 }).catalogItems[0].catalogReference.options.amount, 10);
-  assert.throws(() => api.donationCartBody(campaign, { amount: 25, frequency: 'YEAR' }), /offered/);
-  assert.throws(() => api.donationCartBody({ ...campaign, customAmountEnabled: false }, { amount: 10 }), /suggested/);
-  assert.throws(() => api.donationCartBody({ ...campaign, archived: true }, { amount: 25 }), /not accepting/);
-  assert.throws(() => api.donationCartBody({ ...campaign, commentsEnabled: false }, { amount: 25, note: 'A note' }), /not enabled/);
-  assert.throws(() => api.donationCartBody({ ...campaign, askDonorCoverFee: false }, { amount: 25, coverFee: true }), /not offered/);
-});
-
-test('bad cart options preserve the HTTP error and never attempt a redirect', async () => {
-  const errorBody = { details: { applicationError: { code: 'ITEM_NOT_FOUND_IN_CATALOG' } } };
-  const calls = mockRequests(path => path === '/ecom/v2/carts' ? json(errorBody, 400) : undefined);
-  await assert.rejects(api.donationCheckoutUrl('campaign-id', { amount: 25 }), error => {
-    assert.equal(error.status, 400); assert.deepEqual(error.body, errorBody); assert.equal(error.stage, 'cart'); return true;
-  });
-  assert.equal(calls.filter(call => call.path.includes('redirect-session')).length, 0);
-});
-
-test('redirect failure retains the known cart and does not silently create a second cart', async () => {
-  const calls = mockRequests(path => path.includes('redirect-session') ? json({ message: 'Origin not allowed' }, 403) : undefined);
-  await assert.rejects(api.donationCheckoutUrl('campaign-id', { amount: 25 }), error => {
-    assert.equal(error.status, 403); assert.equal(error.stage, 'redirect'); assert.equal(error.cartId, 'cart-id'); return true;
-  });
-  assert.equal(calls.filter(call => call.path === '/ecom/v2/carts').length, 1);
-});
-
-test('Donations retains a payment-required error body instead of returning undefined', async () => {
-  const errorBody = { message: 'Payment setup required', code: 'PAYMENT_REQUIRED' };
-  mockRequests(() => json(errorBody, 402));
-  await assert.rejects(transport.wixApiRequest('/a-test-read', { throwOnPaymentRequired: true }), error => {
-    assert.equal(error.status, 402); assert.deepEqual(error.body, errorBody); return true;
-  });
-});
-
-test('the shared transport keeps its existing 402 behavior for other verticals', async () => {
-  mockRequests(() => json({ message: 'Payment setup required' }, 402));
-  const originalWarn = console.warn;
-  const warnings = [];
-  console.warn = message => warnings.push(message);
-  try {
-    assert.equal(await transport.wixApiRequest('/a-test-read'), undefined);
-    assert.equal(warnings.length, 1);
-  } finally {
-    console.warn = originalWarn;
-  }
-});
-
-test('query errors do not become empty campaigns; nextCursor is returned on success', async () => {
-  mockRequests(path => path.endsWith('/query') ? json({ message: 'Permission denied' }, 403) : undefined);
-  await assert.rejects(api.queryDonationCampaigns(), error => error.status === 403);
-  mockRequests(path => path.endsWith('/query') ? json({ donationCampaigns: [campaign], pagingMetadata: { cursors: { next: 'next-page' } } }) : undefined);
-  assert.deepEqual(await api.queryDonationCampaigns(), { campaigns: [campaign], nextCursor: 'next-page' });
-});
-
-test('absent campaigns differ from denied access; unavailable metrics stay errors', async () => {
-  mockRequests(() => json({ message: 'Missing' }, 404));
-  assert.equal(await api.getDonationCampaign('missing-id'), null);
-  mockRequests(() => json({ message: 'Permission denied' }, 403));
-  await assert.rejects(api.getDonationCampaign('campaign-id'), error => error.status === 403);
-  await assert.rejects(api.getDonationCampaignMetrics('campaign-id'), error => error.status === 403);
-});
-
-test('platform deploy copies the new donation helper alongside the shared transport', async () => {
-  const { result, files, copies, exitCode } = await deployFixture();
-  assert.deepEqual(result.verticals, ['donations']);
-  assert.equal(result.error, undefined);
-  assert.equal(exitCode, 0);
-  assert.equal(result.donationsTransport, 'from_shared_tree');
-  assert.ok(copies.some(copy => copy.from.endsWith('/shared/app') && copy.to === '/app/src'));
-  assert.ok(copies.some(copy => copy.from.endsWith('/donations/app') && copy.to === '/app/src'));
-  assert.equal(files.get('/app/src/rest/wix-client.js'), transportSource);
-  assert.equal(files.get('/app/src/rest/wix-donations.js'), donationSource);
-  assert.equal(result.wixConfig, 'written');
-});
-
-test('incremental deployment upgrades only the exact shipped legacy transport and preserves 402 details', async () => {
-  assert.equal(createHash('sha256').update(legacyTransportSource).digest('hex'), '10d53e5e06ac3da62f93d41cfd618b6169c5bb1a5ba07fb58ec7700aad42889e');
-  const { result, files, copies, exitCode } = await deployFixture(legacyTransportSource);
-  assert.equal(exitCode, 0);
-  assert.equal(result.donationsTransport, 'upgraded_unmodified_legacy');
-  assert.equal(files.get('/app/src/rest/wix-client.js'), transportSource);
-  assert.equal(copies.filter(copy => copy.to === '/app/src/rest/wix-client.js' && copy.options.force === true).length, 1);
-  const upgraded = await helperWithTransport(files.get('/app/src/rest/wix-client.js'));
-  const errorBody = { code: 'PAYMENT_REQUIRED', message: 'Payment setup required' };
-  mockRequests(() => json(errorBody, 402));
-  await assert.rejects(upgraded.queryDonationCampaigns(), error => error.status === 402 && error.body.code === errorBody.code);
-});
-
-test('customized incompatible transport fails deployment preflight without any writes', async () => {
-  const customized = `${legacyTransportSource}\n// User-owned customization.\n`;
-  const { result, files, copies, writes, exitCode } = await deployFixture(customized);
-  assert.equal(exitCode, 1);
-  assert.deepEqual(result.verticals, []);
-  assert.match(result.error, /customized or incompatible.*left unchanged.*Merge strict payment-error support/);
-  assert.equal(files.get('/app/src/rest/wix-client.js'), customized);
-  assert.equal(files.has('/app/src/rest/wix-donations.js'), false);
-  assert.equal(copies.length, 0);
-  assert.equal(writes.length, 0);
-});
-
-test('compatible customized transport is kept byte-for-byte on a Donations deploy', async () => {
-  const customized = `${transportSource}\n// User-owned customization.\n`;
-  const { result, files, copies, exitCode } = await deployFixture(customized);
-  assert.equal(exitCode, 0);
-  assert.equal(result.donationsTransport, 'already_supported');
-  assert.equal(files.get('/app/src/rest/wix-client.js'), customized);
-  assert.equal(copies.some(copy => copy.to === '/app/src/rest/wix-client.js'), false);
-});
-
-test('non-Donations deployment leaves the legacy transport untouched', async () => {
-  const { result, files, copies, exitCode } = await deployFixture(legacyTransportSource, ['cms']);
-  assert.equal(exitCode, 0);
-  assert.deepEqual(result.verticals, ['cms']);
-  assert.equal(result.donationsTransport, undefined);
-  assert.equal(files.get('/app/src/rest/wix-client.js'), legacyTransportSource);
-  assert.equal(copies.some(copy => copy.to === '/app/src/rest/wix-client.js'), false);
-});
-
-test('manual copying with a legacy transport fails actionably before making a network request', async () => {
-  const incompatible = await helperWithTransport(legacyTransportSource);
-  const calls = mockRequests();
-  await assert.rejects(incompatible.queryDonationCampaigns(), error => {
-    assert.equal(error.code, 'DONATIONS_TRANSPORT_UPGRADE_REQUIRED');
-    assert.match(error.message, /Re-run the Donations deploy step.*customized src\/rest\/wix-client\.js/);
-    return true;
-  });
-  assert.equal(calls.length, 0);
-});