@stardeck-customer-apps/testing 0.12.0 → 0.14.0

package/SKILL.md

@@ -193,6 +193,21 @@ await app.payments.deliverBeamEvent(beamPost, {
 // charge-failure or expiry event for bolt payments.
 // EXPIRED is derived from expiresAt on read, never stored.
 
+// Fail exactly one real SDK call, then let the next poll recover normally.
+app.payments.failNext("beam.getPaymentLinkStatus", {
+  status: 503,
+  message: "Beam is temporarily unavailable",
+});
+await expect(payments.getPaymentLinkStatus("plink_test_1")).rejects.toMatchObject({
+  statusCode: 503,
+});
+
+// Network failures reject fetch instead of returning a PaymentError response.
+app.payments.failNext("stripe.getCheckoutSessionStatus", {
+  kind: "network",
+  message: "connection reset",
+});
+
 // File upload
 const storage = new StorageClient();
 await storage.upload(new File(["hi"], "note.txt", { type: "text/plain" }));
@@ -280,6 +295,32 @@ expect(app.edge.latestDisplay()?.action).toBe("show");
   - `allowNetwork` — permit non-Stardeck outbound fetches (off by default).
 - `app.reset()` — wipe + re-apply schema + re-seed + clear inbox/sessions.
   Call in `beforeEach`.
+- `app.reset({ mode: "data" })` — available in testing SDK **0.14.0+**. Faster
+  opt-in for stable schemas: truncate ordinary tables in `public`, restart their
+  owned serial/identity sequences, re-run the data-only seed, and clear the same
+  simulator/user/session state as the default. It preserves tables and other
+  schema objects instead of rebuilding them. The default remains full schema
+  reset; `app.reset({ mode: "schema" })` explicitly selects that default.
+
+  ```ts
+  // Only after verifying this suite keeps its schema fixed and uses a data-only seed:
+  beforeEach(() => app.reset({ mode: "data" }));
+  ```
+
+  Keep `app.reset()` for tests that change schema or depend on INSERTs in the
+  schema script. Also keep full reset for independent sequences, materialized
+  views, partitioned/foreign tables, temporary tables, and custom triggers or
+  cross-schema dependencies. Data mode does not restore those states or detect
+  eligibility; inspect both the tests and seed before opting in. All required
+  baseline rows must come from the data-only seed callback, not schema SQL.
+  Data mode refuses foreign keys requiring a cross-schema cascade. Database and
+  seed errors reject the reset; fix them before running the next test.
+
+  Do not use `it.concurrent` or `test.concurrent` with a shared test app: user,
+  database, and simulator state are shared within the file. Keep file isolation
+  enabled and let Vitest parallelize files. This option does not change workers
+  or the platform's test-run deadline.
+
 - `app.asUser(partial?)` — sign in a test user; `getSession()` in app code
   resolves to it. `app.signOut()` clears.
 - `app.issueSession(partial?)` — mint access/refresh tokens for cookie-based
@@ -302,6 +343,8 @@ externalId })` helper models a trusted platform/channel link, and
   identities through the integrations SDK.
 - `app.payments` — checkouts created through payments-sdk:
   `.checkouts`, `.latest()`, `.setProducts()`, `.markPaid(id)`,
+  `.setSessionStatus(id, status)`, `.setPaymentLinkStatus(id, status)`,
+  `.failNext(operation, failure)`,
   `.deliverStripeEvent(handler, event)`, `.deliverBeamEvent(handler, event)`,
   Bolt+ controls: `.approveBoltIntent(id)`, `.declineBoltIntent(id)`,
   `.expireBoltIntent(id)`, `.listBoltIntents()`, `.getBoltIntent(id)`,
@@ -385,7 +428,21 @@ cursor, limit })`; `list()` intentionally keeps its previous array shape.
   connections/intents/charges, product list) — captured in `app.payments`;
   fulfill checkout via `markPaid` (poll) or `deliverStripeEvent` /
   `deliverBeamEvent` (webhook push). Drive a terminal without hardware via
-  `approveBoltIntent` / `declineBoltIntent` / `expireBoltIntent`.
+  `approveBoltIntent` / `declineBoltIntent` / `expireBoltIntent`. Beam payment-link
+  polling returns the app's original `order.referenceId`; playground project
+  scoping is an internal control-plane detail and must not be handled in app code.
+- Payment outcomes are controllable without bypassing the SDK: Stripe sessions
+  support `open`, `complete`, and `expired` with `paid`, `unpaid`, or
+  `no_payment_required`; Beam links support `ACTIVE`, `DISABLED`, `EXPIRED`,
+  `PAID`, `VOIDED`, and `REFUNDED`; Bolt+ supports approve, decline, expiry, and
+  cancellation through the real SDK call. Use `app.payments.failNext()` for
+  one-shot HTTP or network failures during Stripe checkout creation/status polling
+  and Beam payment-link creation/status polling. The operation names are
+  `stripe.createCheckout`, `stripe.getCheckoutSessionStatus`,
+  `beam.createPaymentLink`, and `beam.getPaymentLinkStatus`. HTTP failures support
+  statuses 400, 402, 409, 429, 500, and 503 plus optional `code`, `details`, and
+  `retryAfterSeconds`; `{ kind: "network", message }` rejects fetch instead.
+  `app.reset()` clears pending failures.
 - `StorageClient` (upload/list/get/patch/delete, presigned upload) — captured
   in `app.storage` against the simulated `STORAGE_URL` host.
 - `client.slack` / `client.line` / `client.facebook` send endpoints — captured

package/dist/index.d.mts

@@ -138,6 +138,18 @@ interface CapturedCheckout {
     metadata?: Record<string, string>;
     createdAt: Date;
 }
+type PaymentSimulatorOperation = "stripe.createCheckout" | "stripe.getCheckoutSessionStatus" | "beam.createPaymentLink" | "beam.getPaymentLinkStatus";
+type PaymentSimulatorFailure = {
+    kind?: "http";
+    status: 400 | 402 | 409 | 429 | 500 | 503;
+    message: string;
+    code?: string;
+    details?: unknown;
+    retryAfterSeconds?: number;
+} | {
+    kind: "network";
+    message: string;
+};
 /** Simulated Bolt+ connection as returned by the control-plane store API. */
 interface SimBoltConnection {
     id: string;
@@ -189,6 +201,8 @@ interface TestPayments {
     get checkouts(): CapturedCheckout[];
     latest(): CapturedCheckout | undefined;
     setProducts(products: _stardeck_customer_apps_payments_sdk.Product[]): void;
+    /** Fail the next matching SDK request once, then resume normal simulator behavior. */
+    failNext(operation: PaymentSimulatorOperation, failure: PaymentSimulatorFailure): void;
     markPaid(id: string): void;
     setSessionStatus(id: string, status: Partial<_stardeck_customer_apps_payments_sdk.CheckoutSessionStatus>): void;
     setPaymentLinkStatus(id: string, status: _stardeck_customer_apps_payments_sdk.BeamPaymentLinkStatus): void;
@@ -506,8 +520,15 @@ interface TestApp {
      * control-plane verify endpoint resolves these tokens back to the user.
      */
     issueSession(user?: Partial<TestUser>): SessionTokens;
-    /** Drop all tables, re-apply the schema, re-run the seed, clear inbox/user. */
-    reset(): Promise<void>;
+    /**
+     * Rebuild the schema (default), re-run the seed, and clear simulator/user state.
+     * `mode: "data"` instead truncates ordinary public tables and restarts owned
+     * sequences. Use only with a stable schema and data-only seed; it does not
+     * restore DDL changes, schema-script data, or independent sequences.
+     */
+    reset(options?: {
+        mode: "schema" | "data";
+    }): Promise<void>;
     /** Tear down the app and restore global fetch. */
     close(): Promise<void>;
 }
@@ -550,4 +571,4 @@ declare const TEST_ENV_DEFAULTS: {
 /** Default location of the DDL snapshot written by `generate-types`. */
 declare const DEFAULT_SCHEMA_PATH = "./src/generated/data-store-schema.sql";
 
-export { type BindingInfo, CONTROL_PLANE_TEST_URL, type CallRouteOptions, type CapturedCheckout, type CapturedDisplay, type CapturedEmail, type CapturedIdentity, type CapturedIdentityLink, type CapturedMessage, type CapturedPrint, type CapturedTestPrint, type CapturedUpload, DATA_STORE_TEST_HOST, DATA_STORE_TEST_URL, DEFAULT_SCHEMA_PATH, type DeviceInfo, type PeripheralInfo, STORAGE_TEST_HOST, STORAGE_TEST_URL, type SessionTokens, type SimBoltCharge, type SimBoltConnection, type SimBoltIntentRecord, type SimBoltIntentStatus, TEST_ENV_DEFAULTS, type TestApp, type TestAppOptions, TestDataStoreInput, type TestDirectory, type TestEdge, type TestInbox, type TestMessages, type TestPayments, type TestStorage, type TestUser, WORKFLOW_NAME_PREFIX, callRoute, createTestApp, describeWorkflow, parseWorkflowName };
+export { type BindingInfo, CONTROL_PLANE_TEST_URL, type CallRouteOptions, type CapturedCheckout, type CapturedDisplay, type CapturedEmail, type CapturedIdentity, type CapturedIdentityLink, type CapturedMessage, type CapturedPrint, type CapturedTestPrint, type CapturedUpload, DATA_STORE_TEST_HOST, DATA_STORE_TEST_URL, DEFAULT_SCHEMA_PATH, type DeviceInfo, type PaymentSimulatorFailure, type PaymentSimulatorOperation, type PeripheralInfo, STORAGE_TEST_HOST, STORAGE_TEST_URL, type SessionTokens, type SimBoltCharge, type SimBoltConnection, type SimBoltIntentRecord, type SimBoltIntentStatus, TEST_ENV_DEFAULTS, type TestApp, type TestAppOptions, TestDataStoreInput, type TestDirectory, type TestEdge, type TestInbox, type TestMessages, type TestPayments, type TestStorage, type TestUser, WORKFLOW_NAME_PREFIX, callRoute, createTestApp, describeWorkflow, parseWorkflowName };

package/dist/index.d.ts

@@ -138,6 +138,18 @@ interface CapturedCheckout {
     metadata?: Record<string, string>;
     createdAt: Date;
 }
+type PaymentSimulatorOperation = "stripe.createCheckout" | "stripe.getCheckoutSessionStatus" | "beam.createPaymentLink" | "beam.getPaymentLinkStatus";
+type PaymentSimulatorFailure = {
+    kind?: "http";
+    status: 400 | 402 | 409 | 429 | 500 | 503;
+    message: string;
+    code?: string;
+    details?: unknown;
+    retryAfterSeconds?: number;
+} | {
+    kind: "network";
+    message: string;
+};
 /** Simulated Bolt+ connection as returned by the control-plane store API. */
 interface SimBoltConnection {
     id: string;
@@ -189,6 +201,8 @@ interface TestPayments {
     get checkouts(): CapturedCheckout[];
     latest(): CapturedCheckout | undefined;
     setProducts(products: _stardeck_customer_apps_payments_sdk.Product[]): void;
+    /** Fail the next matching SDK request once, then resume normal simulator behavior. */
+    failNext(operation: PaymentSimulatorOperation, failure: PaymentSimulatorFailure): void;
     markPaid(id: string): void;
     setSessionStatus(id: string, status: Partial<_stardeck_customer_apps_payments_sdk.CheckoutSessionStatus>): void;
     setPaymentLinkStatus(id: string, status: _stardeck_customer_apps_payments_sdk.BeamPaymentLinkStatus): void;
@@ -506,8 +520,15 @@ interface TestApp {
      * control-plane verify endpoint resolves these tokens back to the user.
      */
     issueSession(user?: Partial<TestUser>): SessionTokens;
-    /** Drop all tables, re-apply the schema, re-run the seed, clear inbox/user. */
-    reset(): Promise<void>;
+    /**
+     * Rebuild the schema (default), re-run the seed, and clear simulator/user state.
+     * `mode: "data"` instead truncates ordinary public tables and restarts owned
+     * sequences. Use only with a stable schema and data-only seed; it does not
+     * restore DDL changes, schema-script data, or independent sequences.
+     */
+    reset(options?: {
+        mode: "schema" | "data";
+    }): Promise<void>;
     /** Tear down the app and restore global fetch. */
     close(): Promise<void>;
 }
@@ -550,4 +571,4 @@ declare const TEST_ENV_DEFAULTS: {
 /** Default location of the DDL snapshot written by `generate-types`. */
 declare const DEFAULT_SCHEMA_PATH = "./src/generated/data-store-schema.sql";
 
-export { type BindingInfo, CONTROL_PLANE_TEST_URL, type CallRouteOptions, type CapturedCheckout, type CapturedDisplay, type CapturedEmail, type CapturedIdentity, type CapturedIdentityLink, type CapturedMessage, type CapturedPrint, type CapturedTestPrint, type CapturedUpload, DATA_STORE_TEST_HOST, DATA_STORE_TEST_URL, DEFAULT_SCHEMA_PATH, type DeviceInfo, type PeripheralInfo, STORAGE_TEST_HOST, STORAGE_TEST_URL, type SessionTokens, type SimBoltCharge, type SimBoltConnection, type SimBoltIntentRecord, type SimBoltIntentStatus, TEST_ENV_DEFAULTS, type TestApp, type TestAppOptions, TestDataStoreInput, type TestDirectory, type TestEdge, type TestInbox, type TestMessages, type TestPayments, type TestStorage, type TestUser, WORKFLOW_NAME_PREFIX, callRoute, createTestApp, describeWorkflow, parseWorkflowName };
+export { type BindingInfo, CONTROL_PLANE_TEST_URL, type CallRouteOptions, type CapturedCheckout, type CapturedDisplay, type CapturedEmail, type CapturedIdentity, type CapturedIdentityLink, type CapturedMessage, type CapturedPrint, type CapturedTestPrint, type CapturedUpload, DATA_STORE_TEST_HOST, DATA_STORE_TEST_URL, DEFAULT_SCHEMA_PATH, type DeviceInfo, type PaymentSimulatorFailure, type PaymentSimulatorOperation, type PeripheralInfo, STORAGE_TEST_HOST, STORAGE_TEST_URL, type SessionTokens, type SimBoltCharge, type SimBoltConnection, type SimBoltIntentRecord, type SimBoltIntentStatus, TEST_ENV_DEFAULTS, type TestApp, type TestAppOptions, TestDataStoreInput, type TestDirectory, type TestEdge, type TestInbox, type TestMessages, type TestPayments, type TestStorage, type TestUser, WORKFLOW_NAME_PREFIX, callRoute, createTestApp, describeWorkflow, parseWorkflowName };

package/dist/index.js

@@ -73,6 +73,19 @@ async function applySchema(db, schemaSql) {
 async function dropAllTables(db) {
   await db.exec(`DROP SCHEMA public CASCADE; CREATE SCHEMA public;`);
 }
+async function listPublicTables(db) {
+  const { rows } = await db.query(`
+    SELECT format('%I.%I', n.nspname, c.relname) AS name
+    FROM pg_class c JOIN pg_namespace n ON n.oid = c.relnamespace
+    WHERE n.nspname = 'public' AND c.relkind = 'r'
+    ORDER BY c.relname
+  `);
+  return rows.map(({ name }) => name);
+}
+async function truncateAllTables(db) {
+  const tables = await listPublicTables(db);
+  if (tables.length) await db.exec(`TRUNCATE TABLE ${tables.join(", ")} RESTART IDENTITY`);
+}
 var identityParsers = null;
 function getIdentityParsers() {
   if (!identityParsers) {
@@ -108,6 +121,7 @@ var state = globalSingleton("state", () => ({
   checkoutCounter: 0,
   sessionStatuses: /* @__PURE__ */ new Map(),
   paymentLinks: /* @__PURE__ */ new Map(),
+  paymentFailures: [],
   products: [],
   boltConnections: /* @__PURE__ */ new Map(),
   boltUsedPairingCodes: /* @__PURE__ */ new Set(),
@@ -1274,6 +1288,43 @@ function payErr(error, status = 400, code, details) {
   if (details !== void 0) body.details = details;
   return json(body, status);
 }
+function paymentOperationForRequest(request, pathname) {
+  if (request.method === "POST" && /^\/api\/store\/beam\/[^/]+\/payment-links$/.test(pathname)) {
+    return "beam.createPaymentLink";
+  }
+  if (request.method === "GET" && /^\/api\/store\/beam\/[^/]+\/payment-links\/[^/]+$/.test(pathname)) {
+    return "beam.getPaymentLinkStatus";
+  }
+  if (request.method === "POST" && /^\/api\/store\/(?!beam\/)[^/]+\/checkout$/.test(pathname)) {
+    return "stripe.createCheckout";
+  }
+  if (request.method === "GET" && /^\/api\/store\/(?!beam\/)[^/]+\/checkout-sessions\/[^/]+$/.test(pathname)) {
+    return "stripe.getCheckoutSessionStatus";
+  }
+  return null;
+}
+function consumePaymentFailure(request, pathname) {
+  const operation = paymentOperationForRequest(request, pathname);
+  if (!operation) return null;
+  const index = state.paymentFailures.findIndex((entry) => entry.operation === operation);
+  if (index === -1) return null;
+  const [{ failure: failure2 }] = state.paymentFailures.splice(index, 1);
+  if (failure2.kind === "network") {
+    throw new TypeError(failure2.message);
+  }
+  const headers = new Headers({ "Content-Type": "application/json" });
+  if (failure2.retryAfterSeconds !== void 0) {
+    headers.set("Retry-After", String(failure2.retryAfterSeconds));
+  }
+  return new Response(
+    JSON.stringify({
+      error: failure2.message,
+      code: failure2.code ?? "REQUEST_ERROR",
+      ...failure2.details !== void 0 ? { details: failure2.details } : {}
+    }),
+    { status: failure2.status, headers }
+  );
+}
 function isBoltPaymentMethod(value) {
   return typeof value === "string" && BEAM_BOLT_PAYMENT_METHODS.includes(value);
 }
@@ -1417,6 +1468,8 @@ async function deliverEvent(envelope, handler, options) {
 }
 async function handlePaymentsRequest(request, url) {
   const pathname = url.pathname;
+  const injectedFailure = consumePaymentFailure(request, pathname);
+  if (injectedFailure) return injectedFailure;
   if (/\/billing-portal$/.test(pathname)) {
     return payErr("Not found", 404, "NOT_FOUND");
   }
@@ -1711,6 +1764,9 @@ function createPayments() {
     setProducts(products) {
       state.products = products;
     },
+    failNext(operation, failure2) {
+      state.paymentFailures.push({ operation, failure: failure2 });
+    },
     markPaid(id) {
       const session = state.sessionStatuses.get(id);
       if (session) {
@@ -1820,6 +1876,7 @@ function createPayments() {
       state.checkoutCounter = 0;
       state.sessionStatuses.clear();
       state.paymentLinks.clear();
+      state.paymentFailures = [];
       state.products = [];
       state.boltConnections.clear();
       state.boltUsedPairingCodes.clear();
@@ -2797,9 +2854,14 @@ async function createTestApp(options = {}) {
       state.refreshSessions.set(tokens.refreshToken, fullUser);
       return tokens;
     },
-    async reset() {
-      await dropAllTables(db);
-      await initialize();
+    async reset(resetOptions) {
+      if (resetOptions?.mode === "data") {
+        await truncateAllTables(db);
+        if (options.seed) await options.seed(db);
+      } else {
+        await dropAllTables(db);
+        await initialize();
+      }
       state.currentUser = null;
       state.sessions.clear();
       state.refreshSessions.clear();

package/dist/index.mjs

@@ -24,6 +24,19 @@ async function applySchema(db, schemaSql) {
 async function dropAllTables(db) {
   await db.exec(`DROP SCHEMA public CASCADE; CREATE SCHEMA public;`);
 }
+async function listPublicTables(db) {
+  const { rows } = await db.query(`
+    SELECT format('%I.%I', n.nspname, c.relname) AS name
+    FROM pg_class c JOIN pg_namespace n ON n.oid = c.relnamespace
+    WHERE n.nspname = 'public' AND c.relkind = 'r'
+    ORDER BY c.relname
+  `);
+  return rows.map(({ name }) => name);
+}
+async function truncateAllTables(db) {
+  const tables = await listPublicTables(db);
+  if (tables.length) await db.exec(`TRUNCATE TABLE ${tables.join(", ")} RESTART IDENTITY`);
+}
 var identityParsers = null;
 function getIdentityParsers() {
   if (!identityParsers) {
@@ -59,6 +72,7 @@ var state = globalSingleton("state", () => ({
   checkoutCounter: 0,
   sessionStatuses: /* @__PURE__ */ new Map(),
   paymentLinks: /* @__PURE__ */ new Map(),
+  paymentFailures: [],
   products: [],
   boltConnections: /* @__PURE__ */ new Map(),
   boltUsedPairingCodes: /* @__PURE__ */ new Set(),
@@ -1225,6 +1239,43 @@ function payErr(error, status = 400, code, details) {
   if (details !== void 0) body.details = details;
   return json(body, status);
 }
+function paymentOperationForRequest(request, pathname) {
+  if (request.method === "POST" && /^\/api\/store\/beam\/[^/]+\/payment-links$/.test(pathname)) {
+    return "beam.createPaymentLink";
+  }
+  if (request.method === "GET" && /^\/api\/store\/beam\/[^/]+\/payment-links\/[^/]+$/.test(pathname)) {
+    return "beam.getPaymentLinkStatus";
+  }
+  if (request.method === "POST" && /^\/api\/store\/(?!beam\/)[^/]+\/checkout$/.test(pathname)) {
+    return "stripe.createCheckout";
+  }
+  if (request.method === "GET" && /^\/api\/store\/(?!beam\/)[^/]+\/checkout-sessions\/[^/]+$/.test(pathname)) {
+    return "stripe.getCheckoutSessionStatus";
+  }
+  return null;
+}
+function consumePaymentFailure(request, pathname) {
+  const operation = paymentOperationForRequest(request, pathname);
+  if (!operation) return null;
+  const index = state.paymentFailures.findIndex((entry) => entry.operation === operation);
+  if (index === -1) return null;
+  const [{ failure: failure2 }] = state.paymentFailures.splice(index, 1);
+  if (failure2.kind === "network") {
+    throw new TypeError(failure2.message);
+  }
+  const headers = new Headers({ "Content-Type": "application/json" });
+  if (failure2.retryAfterSeconds !== void 0) {
+    headers.set("Retry-After", String(failure2.retryAfterSeconds));
+  }
+  return new Response(
+    JSON.stringify({
+      error: failure2.message,
+      code: failure2.code ?? "REQUEST_ERROR",
+      ...failure2.details !== void 0 ? { details: failure2.details } : {}
+    }),
+    { status: failure2.status, headers }
+  );
+}
 function isBoltPaymentMethod(value) {
   return typeof value === "string" && BEAM_BOLT_PAYMENT_METHODS.includes(value);
 }
@@ -1368,6 +1419,8 @@ async function deliverEvent(envelope, handler, options) {
 }
 async function handlePaymentsRequest(request, url) {
   const pathname = url.pathname;
+  const injectedFailure = consumePaymentFailure(request, pathname);
+  if (injectedFailure) return injectedFailure;
   if (/\/billing-portal$/.test(pathname)) {
     return payErr("Not found", 404, "NOT_FOUND");
   }
@@ -1662,6 +1715,9 @@ function createPayments() {
     setProducts(products) {
       state.products = products;
     },
+    failNext(operation, failure2) {
+      state.paymentFailures.push({ operation, failure: failure2 });
+    },
     markPaid(id) {
       const session = state.sessionStatuses.get(id);
       if (session) {
@@ -1771,6 +1827,7 @@ function createPayments() {
       state.checkoutCounter = 0;
       state.sessionStatuses.clear();
       state.paymentLinks.clear();
+      state.paymentFailures = [];
       state.products = [];
       state.boltConnections.clear();
       state.boltUsedPairingCodes.clear();
@@ -2748,9 +2805,14 @@ async function createTestApp(options = {}) {
       state.refreshSessions.set(tokens.refreshToken, fullUser);
       return tokens;
     },
-    async reset() {
-      await dropAllTables(db);
-      await initialize();
+    async reset(resetOptions) {
+      if (resetOptions?.mode === "data") {
+        await truncateAllTables(db);
+        if (options.seed) await options.seed(db);
+      } else {
+        await dropAllTables(db);
+        await initialize();
+      }
       state.currentUser = null;
       state.sessions.clear();
       state.refreshSessions.clear();

package/dist/next/headers-shim.js

@@ -51,6 +51,7 @@ var state = globalSingleton("state", () => ({
   checkoutCounter: 0,
   sessionStatuses: /* @__PURE__ */ new Map(),
   paymentLinks: /* @__PURE__ */ new Map(),
+  paymentFailures: [],
   products: [],
   boltConnections: /* @__PURE__ */ new Map(),
   boltUsedPairingCodes: /* @__PURE__ */ new Set(),

package/dist/next/headers-shim.mjs

@@ -24,6 +24,7 @@ var state = globalSingleton("state", () => ({
   checkoutCounter: 0,
   sessionStatuses: /* @__PURE__ */ new Map(),
   paymentLinks: /* @__PURE__ */ new Map(),
+  paymentFailures: [],
   products: [],
   boltConnections: /* @__PURE__ */ new Map(),
   boltUsedPairingCodes: /* @__PURE__ */ new Set(),

package/dist/setup.js

@@ -45,6 +45,7 @@ var state = globalSingleton("state", () => ({
   checkoutCounter: 0,
   sessionStatuses: /* @__PURE__ */ new Map(),
   paymentLinks: /* @__PURE__ */ new Map(),
+  paymentFailures: [],
   products: [],
   boltConnections: /* @__PURE__ */ new Map(),
   boltUsedPairingCodes: /* @__PURE__ */ new Set(),
@@ -1012,6 +1013,43 @@ function payErr(error, status = 400, code, details) {
   if (details !== void 0) body.details = details;
   return json(body, status);
 }
+function paymentOperationForRequest(request, pathname) {
+  if (request.method === "POST" && /^\/api\/store\/beam\/[^/]+\/payment-links$/.test(pathname)) {
+    return "beam.createPaymentLink";
+  }
+  if (request.method === "GET" && /^\/api\/store\/beam\/[^/]+\/payment-links\/[^/]+$/.test(pathname)) {
+    return "beam.getPaymentLinkStatus";
+  }
+  if (request.method === "POST" && /^\/api\/store\/(?!beam\/)[^/]+\/checkout$/.test(pathname)) {
+    return "stripe.createCheckout";
+  }
+  if (request.method === "GET" && /^\/api\/store\/(?!beam\/)[^/]+\/checkout-sessions\/[^/]+$/.test(pathname)) {
+    return "stripe.getCheckoutSessionStatus";
+  }
+  return null;
+}
+function consumePaymentFailure(request, pathname) {
+  const operation = paymentOperationForRequest(request, pathname);
+  if (!operation) return null;
+  const index = state.paymentFailures.findIndex((entry) => entry.operation === operation);
+  if (index === -1) return null;
+  const [{ failure: failure2 }] = state.paymentFailures.splice(index, 1);
+  if (failure2.kind === "network") {
+    throw new TypeError(failure2.message);
+  }
+  const headers = new Headers({ "Content-Type": "application/json" });
+  if (failure2.retryAfterSeconds !== void 0) {
+    headers.set("Retry-After", String(failure2.retryAfterSeconds));
+  }
+  return new Response(
+    JSON.stringify({
+      error: failure2.message,
+      code: failure2.code ?? "REQUEST_ERROR",
+      ...failure2.details !== void 0 ? { details: failure2.details } : {}
+    }),
+    { status: failure2.status, headers }
+  );
+}
 function isBoltPaymentMethod(value) {
   return typeof value === "string" && BEAM_BOLT_PAYMENT_METHODS.includes(value);
 }
@@ -1120,6 +1158,8 @@ function storedStatusesForFilter(statuses) {
 }
 async function handlePaymentsRequest(request, url) {
   const pathname = url.pathname;
+  const injectedFailure = consumePaymentFailure(request, pathname);
+  if (injectedFailure) return injectedFailure;
   if (/\/billing-portal$/.test(pathname)) {
     return payErr("Not found", 404, "NOT_FOUND");
   }

package/dist/setup.mjs

@@ -21,6 +21,7 @@ var state = globalSingleton("state", () => ({
   checkoutCounter: 0,
   sessionStatuses: /* @__PURE__ */ new Map(),
   paymentLinks: /* @__PURE__ */ new Map(),
+  paymentFailures: [],
   products: [],
   boltConnections: /* @__PURE__ */ new Map(),
   boltUsedPairingCodes: /* @__PURE__ */ new Set(),
@@ -988,6 +989,43 @@ function payErr(error, status = 400, code, details) {
   if (details !== void 0) body.details = details;
   return json(body, status);
 }
+function paymentOperationForRequest(request, pathname) {
+  if (request.method === "POST" && /^\/api\/store\/beam\/[^/]+\/payment-links$/.test(pathname)) {
+    return "beam.createPaymentLink";
+  }
+  if (request.method === "GET" && /^\/api\/store\/beam\/[^/]+\/payment-links\/[^/]+$/.test(pathname)) {
+    return "beam.getPaymentLinkStatus";
+  }
+  if (request.method === "POST" && /^\/api\/store\/(?!beam\/)[^/]+\/checkout$/.test(pathname)) {
+    return "stripe.createCheckout";
+  }
+  if (request.method === "GET" && /^\/api\/store\/(?!beam\/)[^/]+\/checkout-sessions\/[^/]+$/.test(pathname)) {
+    return "stripe.getCheckoutSessionStatus";
+  }
+  return null;
+}
+function consumePaymentFailure(request, pathname) {
+  const operation = paymentOperationForRequest(request, pathname);
+  if (!operation) return null;
+  const index = state.paymentFailures.findIndex((entry) => entry.operation === operation);
+  if (index === -1) return null;
+  const [{ failure: failure2 }] = state.paymentFailures.splice(index, 1);
+  if (failure2.kind === "network") {
+    throw new TypeError(failure2.message);
+  }
+  const headers = new Headers({ "Content-Type": "application/json" });
+  if (failure2.retryAfterSeconds !== void 0) {
+    headers.set("Retry-After", String(failure2.retryAfterSeconds));
+  }
+  return new Response(
+    JSON.stringify({
+      error: failure2.message,
+      code: failure2.code ?? "REQUEST_ERROR",
+      ...failure2.details !== void 0 ? { details: failure2.details } : {}
+    }),
+    { status: failure2.status, headers }
+  );
+}
 function isBoltPaymentMethod(value) {
   return typeof value === "string" && BEAM_BOLT_PAYMENT_METHODS.includes(value);
 }
@@ -1096,6 +1134,8 @@ function storedStatusesForFilter(statuses) {
 }
 async function handlePaymentsRequest(request, url) {
   const pathname = url.pathname;
+  const injectedFailure = consumePaymentFailure(request, pathname);
+  if (injectedFailure) return injectedFailure;
   if (/\/billing-portal$/.test(pathname)) {
     return payErr("Not found", 404, "NOT_FOUND");
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stardeck-customer-apps/testing",
-  "version": "0.12.0",
+  "version": "0.14.0",
   "description": "Vitest test harness for Stardeck customer apps — in-process Postgres (PGlite) plus a control-plane simulator so the real Stardeck SDKs run unmodified in tests",
   "main": "dist/index.js",
   "module": "dist/index.mjs",