@stardeck-customer-apps/testing 0.8.0 → 0.10.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Stardeck Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/SKILL.md

@@ -29,6 +29,65 @@ This writes `src/generated/data-store-types.ts` and
 `src/generated/data-store-schema.sql`. The harness applies the SQL snapshot to
 PGlite at test boot. **Commit both files.**
 
+### Data store bindings
+
+Configure each app-local data store binding once in `vitest.config.ts`. The
+harness injects the same `STARDECK_DATA_STORES` manifest shape as production, so
+application code resolves the binding without test-only branches:
+
+```ts
+import { defineStardeckTestConfig } from "@stardeck-customer-apps/testing/config";
+
+export default defineStardeckTestConfig(
+  {},
+  {
+    dataStores: [{ bindingKey: "development" }],
+  }
+);
+```
+
+```ts
+import { createDataStore } from "@stardeck-customer-apps/data-store-sdk/server";
+
+const db = await createDataStore({ storeName: "development" });
+```
+
+Do not branch on `DATA_STORE_URL?.includes(".stardeck.test")` or otherwise
+sniff test hosts. Configure the binding and use `createDataStore({ storeName })`
+the same way in tests and production.
+
+For one test file that needs a different manifest, pass the same entries to the
+app instead. This overrides the config-level manifest for that file:
+
+```ts
+app = await createTestApp({
+  dataStores: [
+    { bindingKey: "development" },
+    { bindingKey: "uploads", name: "Customer Files", storeType: "storage" },
+  ],
+});
+```
+
+An app setup file may also set `STARDECK_DATA_STORES` directly. The harness
+adopts a non-empty raw env value when `createTestApp()` has no `dataStores`
+option; a per-app `dataStores` option still overrides it. An empty env value is
+treated as unset, matching the SDK manifest parser.
+
+Strictness follows adoption:
+
+- With no manifest configuration, `createTestApp()` injects a `main` database
+  entry and keeps `DATA_STORE_URL` for older bare `createDataStore()` calls.
+- Configuring `dataStores` through either channel removes `DATA_STORE_URL` by
+  default. A misspelled `storeName` then fails instead of silently connecting to
+  the default database.
+- Passing `dataStores: []` explicitly creates a strict zero-store test world:
+  the manifest is `[]`, `DATA_STORE_URL` is absent, and every
+  `createDataStore(...)` call fails until a store is configured.
+- Empty-string `bindingKey`, `slug`, or `name` values throw during test app
+  setup so typos cannot silently change manifest resolution.
+- Set `legacyDataStoreUrl: true` per file only while migrating legacy code. Set
+  it to `false` to test strict manifest-only resolution even with zero config.
+
 ## Writing tests
 
 ```ts
@@ -93,6 +152,47 @@ await app.payments.deliverStripeEvent(POST, {
   data: { object: { id: session.id } },
 });
 
+// Bolt+ terminal: create intent → approve → webhook (same deliverBeamEvent path)
+// Simulator intents are real-shaped (bolti_<n>, isVirtual: false) — not bolti_emu_*.
+// createBoltIntent validates like production: amount > 0, expiryDurationInSec 90–600,
+// paymentMethod enum, deploymentId UUID, boltConnectionId required.
+const connection = await payments.createBoltConnection({ pairingCode: "PAIR01" });
+const intent = await payments.createBoltIntent({
+  amount: 10000,
+  boltConnectionId: connection.beamConnectionId,
+  paymentMethod: "CARD",
+  expiryDurationInSec: 300,
+  referenceId: "order-1",
+});
+expect(app.payments.getBoltIntent(intent.id)?.status).toBe("PENDING");
+expect(app.payments.getBoltIntent(intent.id)?.isVirtual).toBe(false);
+
+const charge = app.payments.approveBoltIntent(intent.id);
+expect(app.payments.getBoltIntent(intent.id)?.status).toBe("PAID");
+
+const { POST: beamPost } = paymentsHandler({
+  provider: "beam",
+  onBeamWebhook: async (event) => {
+    if (event.type === "charge.succeeded") {
+      await fulfillOrder(String(event.payload.referenceId ?? ""));
+    }
+  },
+});
+await app.payments.deliverBeamEvent(beamPost, {
+  type: "charge.succeeded",
+  payload: {
+    id: charge.id,
+    sourceId: intent.id,
+    referenceId: "order-1",
+    amount: 10000,
+    currency: "THB",
+    status: "SUCCEEDED",
+  },
+});
+// declineBoltIntent / expireBoltIntent deliver NO webhook — Beam has no
+// charge-failure or expiry event for bolt payments.
+// EXPIRED is derived from expiresAt on read, never stored.
+
 // File upload
 const storage = new StorageClient();
 await storage.upload(new File(["hi"], "note.txt", { type: "text/plain" }));
@@ -145,7 +245,14 @@ expect(app.edge.latestDisplay()?.action).toBe("show");
 
 - `createTestApp(options)` — boots PGlite + the control-plane simulator and
   sets all Stardeck env vars (`CONTROL_PLANE_URL`, `DEPLOYMENT_SECRET`,
-  `DATA_STORE_URL`, ids). One per test file, in `beforeAll`.
+  `STARDECK_DATA_STORES`, ids, and the legacy `DATA_STORE_URL` when enabled).
+  One per test file, in `beforeAll`.
+  - `dataStores` — per-file production-shaped data store manifest entries. The
+    first entry defaults to slug `main`; later entries need a `slug` or `name`.
+    Pass `[]` for strict zero-store mode. Empty `bindingKey`, `slug`, and `name`
+    values are rejected.
+  - `legacyDataStoreUrl` — force the legacy single-store URL on or off. When
+    omitted, it is on only for zero-config tests and off after manifest adoption.
   - `schema` — path to the DDL snapshot (default
     `./src/generated/data-store-schema.sql`); `null` for apps without a store.
   - `schemaSql` — inline DDL instead of a file.
@@ -169,7 +276,16 @@ externalId })` helper models a trusted platform/channel link, and
 - `app.payments` — checkouts created through payments-sdk:
   `.checkouts`, `.latest()`, `.setProducts()`, `.markPaid(id)`,
   `.deliverStripeEvent(handler, event)`, `.deliverBeamEvent(handler, event)`,
-  `.count`, `.clear()`.
+  Bolt+ controls: `.approveBoltIntent(id)`, `.declineBoltIntent(id)`,
+  `.expireBoltIntent(id)`, `.listBoltIntents()`, `.getBoltIntent(id)`,
+  `.count`, `.clear()`. Approve marks PAID and records a charge; deliver the
+  `charge.succeeded` webhook yourself via `.deliverBeamEvent` (same signing
+  path as payment links). Decline and expire deliver no webhook. `EXPIRED` is
+  derived from `expiresAt` whenever an intent is read — it is never stored.
+  Simulator-created intents use real Beam id shapes (`bolti_<n>`) with
+  `isVirtual: false`; create/list validation matches the control plane
+  (expiry 90–600s, amount positive int, payment-method enum, deploymentId UUID,
+  list `limit` 1–100, status filter values).
 - `app.storage` — uploads through storage-sdk: `.uploads`, `.latest()`, `.count`, `.clear()`.
 - `app.messages` — outbound Slack/LINE/Facebook sends:
   `.all()`, `.latest()`, `.to(recipient)`, `.channel("line")`, `.count`, `.clear()`.
@@ -235,9 +351,11 @@ true })` remains source-compatible but the simulator (like the control plane)
 - For merge-correct reads, request aliases in batches and include every id in
   the returned canonical set. Page directory UIs through `search({ query,
 cursor, limit })`; `list()` intentionally keeps its previous array shape.
-- `PaymentsServerClient` (Stripe checkout + Beam payment links, product list) —
-  captured in `app.payments`; fulfill via `markPaid` (poll) or
-  `deliverStripeEvent` / `deliverBeamEvent` (webhook push).
+- `PaymentsServerClient` (Stripe checkout + Beam payment links + Bolt+
+  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`.
 - `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/config.d.mts

@@ -1,5 +1,9 @@
 import { ViteUserConfig } from 'vitest/config';
+import { T as TestDataStoreInput } from './data-store-manifest-Zwgcv0DJ.mjs';
 
+interface StardeckTestConfigOptions {
+    dataStores?: TestDataStoreInput[];
+}
 /**
  * Vitest config for Stardeck customer apps. Aliases `next/headers` (and
  * `server-only`) to harness shims so server code runs outside a Next request
@@ -11,6 +15,6 @@ import { ViteUserConfig } from 'vitest/config';
  * export default defineStardeckTestConfig();
  * ```
  */
-declare function defineStardeckTestConfig(overrides?: ViteUserConfig): ViteUserConfig;
+declare function defineStardeckTestConfig(overrides?: ViteUserConfig, stardeck?: StardeckTestConfigOptions): ViteUserConfig;
 
-export { defineStardeckTestConfig };
+export { type StardeckTestConfigOptions, defineStardeckTestConfig };

package/dist/config.d.ts

@@ -1,5 +1,9 @@
 import { ViteUserConfig } from 'vitest/config';
+import { T as TestDataStoreInput } from './data-store-manifest-Zwgcv0DJ.js';
 
+interface StardeckTestConfigOptions {
+    dataStores?: TestDataStoreInput[];
+}
 /**
  * Vitest config for Stardeck customer apps. Aliases `next/headers` (and
  * `server-only`) to harness shims so server code runs outside a Next request
@@ -11,6 +15,6 @@ import { ViteUserConfig } from 'vitest/config';
  * export default defineStardeckTestConfig();
  * ```
  */
-declare function defineStardeckTestConfig(overrides?: ViteUserConfig): ViteUserConfig;
+declare function defineStardeckTestConfig(overrides?: ViteUserConfig, stardeck?: StardeckTestConfigOptions): ViteUserConfig;
 
-export { defineStardeckTestConfig };
+export { type StardeckTestConfigOptions, defineStardeckTestConfig };

package/dist/config.js

@@ -23,7 +23,77 @@ __export(config_exports, {
   defineStardeckTestConfig: () => defineStardeckTestConfig
 });
 module.exports = __toCommonJS(config_exports);
-function defineStardeckTestConfig(overrides = {}) {
+
+// src/constants.ts
+var DATA_STORE_TEST_HOST = "db.stardeck.test";
+var DATA_STORE_TEST_URL = `postgresql://test:test@${DATA_STORE_TEST_HOST}/main`;
+
+// src/data-store-manifest.ts
+var STARDECK_DATA_STORES_ENV = "STARDECK_DATA_STORES";
+function dataStoreSlug(name) {
+  const slug = name.toLowerCase().replace(/[^a-z0-9]+/g, "_").replace(/^_+|_+$/g, "");
+  return slug || "store";
+}
+function buildTestDataStoreManifest(inputs = [{}]) {
+  const takenSlugs = /* @__PURE__ */ new Set();
+  const takenBindingKeys = /* @__PURE__ */ new Set();
+  const takenIds = /* @__PURE__ */ new Set();
+  return inputs.map((input, index) => {
+    for (const field of ["bindingKey", "slug", "name"]) {
+      if (input[field] === "") {
+        throw new Error(`[stardeck-testing] dataStores[${index}].${field} cannot be empty.`);
+      }
+    }
+    let slug;
+    if (input.slug !== void 0) {
+      slug = input.slug;
+      if (takenSlugs.has(slug)) {
+        throw new Error(`[stardeck-testing] dataStores[${index}].slug must be unique.`);
+      }
+    } else {
+      const base = input.name !== void 0 ? dataStoreSlug(input.name) : index === 0 ? "main" : null;
+      if (base === null) {
+        throw new Error(
+          `[stardeck-testing] dataStores[${index}] requires a slug or name. Only the first entry defaults to the "main" slug.`
+        );
+      }
+      slug = base;
+      let suffix = 2;
+      while (takenSlugs.has(slug)) {
+        slug = `${base}_${suffix}`;
+        suffix++;
+      }
+    }
+    const id = input.id ?? `00000000-0000-4000-8000-${String(index + 1).padStart(12, "0")}`;
+    if (takenIds.has(id)) {
+      throw new Error(`[stardeck-testing] dataStores[${index}].id must be unique.`);
+    }
+    if (input.bindingKey !== void 0 && takenBindingKeys.has(input.bindingKey)) {
+      throw new Error(`[stardeck-testing] dataStores[${index}].bindingKey must be unique.`);
+    }
+    takenSlugs.add(slug);
+    takenIds.add(id);
+    if (input.bindingKey !== void 0) takenBindingKeys.add(input.bindingKey);
+    const storeType = input.storeType ?? "database";
+    return {
+      id,
+      name: input.name ?? slug,
+      slug,
+      storeType,
+      accessLevel: input.accessLevel ?? "admin",
+      ...storeType === "database" ? { url: input.url ?? DATA_STORE_TEST_URL } : {},
+      ...input.bindingKey ? { bindingKey: input.bindingKey } : {}
+    };
+  });
+}
+
+// src/config.ts
+function defineStardeckTestConfig(overrides = {}, stardeck = {}) {
+  const dataStoreEnv = stardeck.dataStores !== void 0 ? {
+    [STARDECK_DATA_STORES_ENV]: JSON.stringify(
+      buildTestDataStoreManifest(stardeck.dataStores)
+    )
+  } : {};
   return {
     ...overrides,
     resolve: {
@@ -44,6 +114,10 @@ function defineStardeckTestConfig(overrides = {}) {
       pool: "forks",
       isolate: true,
       ...overrides.test,
+      env: {
+        ...dataStoreEnv,
+        ...overrides.test?.env
+      },
       setupFiles: [
         "@stardeck-customer-apps/testing/setup",
         ...overrides.test?.setupFiles ? Array.isArray(overrides.test.setupFiles) ? overrides.test.setupFiles : [overrides.test.setupFiles] : []

package/dist/config.mjs

@@ -1,5 +1,73 @@
+// src/constants.ts
+var DATA_STORE_TEST_HOST = "db.stardeck.test";
+var DATA_STORE_TEST_URL = `postgresql://test:test@${DATA_STORE_TEST_HOST}/main`;
+
+// src/data-store-manifest.ts
+var STARDECK_DATA_STORES_ENV = "STARDECK_DATA_STORES";
+function dataStoreSlug(name) {
+  const slug = name.toLowerCase().replace(/[^a-z0-9]+/g, "_").replace(/^_+|_+$/g, "");
+  return slug || "store";
+}
+function buildTestDataStoreManifest(inputs = [{}]) {
+  const takenSlugs = /* @__PURE__ */ new Set();
+  const takenBindingKeys = /* @__PURE__ */ new Set();
+  const takenIds = /* @__PURE__ */ new Set();
+  return inputs.map((input, index) => {
+    for (const field of ["bindingKey", "slug", "name"]) {
+      if (input[field] === "") {
+        throw new Error(`[stardeck-testing] dataStores[${index}].${field} cannot be empty.`);
+      }
+    }
+    let slug;
+    if (input.slug !== void 0) {
+      slug = input.slug;
+      if (takenSlugs.has(slug)) {
+        throw new Error(`[stardeck-testing] dataStores[${index}].slug must be unique.`);
+      }
+    } else {
+      const base = input.name !== void 0 ? dataStoreSlug(input.name) : index === 0 ? "main" : null;
+      if (base === null) {
+        throw new Error(
+          `[stardeck-testing] dataStores[${index}] requires a slug or name. Only the first entry defaults to the "main" slug.`
+        );
+      }
+      slug = base;
+      let suffix = 2;
+      while (takenSlugs.has(slug)) {
+        slug = `${base}_${suffix}`;
+        suffix++;
+      }
+    }
+    const id = input.id ?? `00000000-0000-4000-8000-${String(index + 1).padStart(12, "0")}`;
+    if (takenIds.has(id)) {
+      throw new Error(`[stardeck-testing] dataStores[${index}].id must be unique.`);
+    }
+    if (input.bindingKey !== void 0 && takenBindingKeys.has(input.bindingKey)) {
+      throw new Error(`[stardeck-testing] dataStores[${index}].bindingKey must be unique.`);
+    }
+    takenSlugs.add(slug);
+    takenIds.add(id);
+    if (input.bindingKey !== void 0) takenBindingKeys.add(input.bindingKey);
+    const storeType = input.storeType ?? "database";
+    return {
+      id,
+      name: input.name ?? slug,
+      slug,
+      storeType,
+      accessLevel: input.accessLevel ?? "admin",
+      ...storeType === "database" ? { url: input.url ?? DATA_STORE_TEST_URL } : {},
+      ...input.bindingKey ? { bindingKey: input.bindingKey } : {}
+    };
+  });
+}
+
 // src/config.ts
-function defineStardeckTestConfig(overrides = {}) {
+function defineStardeckTestConfig(overrides = {}, stardeck = {}) {
+  const dataStoreEnv = stardeck.dataStores !== void 0 ? {
+    [STARDECK_DATA_STORES_ENV]: JSON.stringify(
+      buildTestDataStoreManifest(stardeck.dataStores)
+    )
+  } : {};
   return {
     ...overrides,
     resolve: {
@@ -20,6 +88,10 @@ function defineStardeckTestConfig(overrides = {}) {
       pool: "forks",
       isolate: true,
       ...overrides.test,
+      env: {
+        ...dataStoreEnv,
+        ...overrides.test?.env
+      },
       setupFiles: [
         "@stardeck-customer-apps/testing/setup",
         ...overrides.test?.setupFiles ? Array.isArray(overrides.test.setupFiles) ? overrides.test.setupFiles : [overrides.test.setupFiles] : []

package/dist/data-store-manifest-Zwgcv0DJ.d.mts

@@ -0,0 +1,25 @@
+declare const STARDECK_DATA_STORES_ENV = "STARDECK_DATA_STORES";
+interface TestDataStoreInput {
+    bindingKey?: string;
+    /** Stable snake_case handle for the store. */
+    slug?: string;
+    name?: string;
+    id?: string;
+    accessLevel?: "read" | "write" | "admin";
+    storeType?: "database" | "storage";
+    /** Defaults to the PGlite simulator URL for database stores. */
+    url?: string;
+}
+interface TestDataStoreManifestEntry {
+    id: string;
+    name: string;
+    slug: string;
+    storeType: "database" | "storage";
+    accessLevel: "read" | "write" | "admin";
+    url?: string;
+    bindingKey?: string;
+}
+/** Builds the production-shaped manifest injected into a test app. */
+declare function buildTestDataStoreManifest(inputs?: TestDataStoreInput[]): TestDataStoreManifestEntry[];
+
+export { STARDECK_DATA_STORES_ENV as S, type TestDataStoreInput as T, type TestDataStoreManifestEntry as a, buildTestDataStoreManifest as b };

package/dist/data-store-manifest-Zwgcv0DJ.d.ts

@@ -0,0 +1,25 @@
+declare const STARDECK_DATA_STORES_ENV = "STARDECK_DATA_STORES";
+interface TestDataStoreInput {
+    bindingKey?: string;
+    /** Stable snake_case handle for the store. */
+    slug?: string;
+    name?: string;
+    id?: string;
+    accessLevel?: "read" | "write" | "admin";
+    storeType?: "database" | "storage";
+    /** Defaults to the PGlite simulator URL for database stores. */
+    url?: string;
+}
+interface TestDataStoreManifestEntry {
+    id: string;
+    name: string;
+    slug: string;
+    storeType: "database" | "storage";
+    accessLevel: "read" | "write" | "admin";
+    url?: string;
+    bindingKey?: string;
+}
+/** Builds the production-shaped manifest injected into a test app. */
+declare function buildTestDataStoreManifest(inputs?: TestDataStoreInput[]): TestDataStoreManifestEntry[];
+
+export { STARDECK_DATA_STORES_ENV as S, type TestDataStoreInput as T, type TestDataStoreManifestEntry as a, buildTestDataStoreManifest as b };

package/dist/index.d.mts

@@ -1,6 +1,8 @@
 import * as _stardeck_customer_apps_payments_sdk from '@stardeck-customer-apps/payments-sdk';
 import * as next_server from 'next/server';
 import { PGlite } from '@electric-sql/pglite';
+import { T as TestDataStoreInput } from './data-store-manifest-Zwgcv0DJ.mjs';
+export { S as STARDECK_DATA_STORES_ENV, a as TestDataStoreManifestEntry, b as buildTestDataStoreManifest } from './data-store-manifest-Zwgcv0DJ.mjs';
 
 type RouteHandler<Req extends Request = Request, P = Record<string, string | string[]>> = (request: Req, context: {
     params: Promise<P>;
@@ -131,6 +133,53 @@ interface CapturedCheckout {
     metadata?: Record<string, string>;
     createdAt: Date;
 }
+/** Simulated Bolt+ connection as returned by the control-plane store API. */
+interface SimBoltConnection {
+    id: string;
+    projectId: string;
+    beamConnectionId: string;
+    displayName: string | null;
+    pairingCode: string;
+    status: string;
+    isSandbox: boolean;
+    environments: Array<"sandbox" | "preview" | "production">;
+    createdAt: string;
+    updatedAt: string;
+}
+type SimBoltIntentStoredStatus = "PENDING" | "PAID" | "FAILED" | "CANCELED";
+type SimBoltIntentStatus = SimBoltIntentStoredStatus | "EXPIRED";
+/**
+ * Stored Bolt+ intent. `EXPIRED` is never written — derive it from
+ * `expiresAt` on read, matching the real control plane.
+ */
+type SimBoltPaymentMethod = _stardeck_customer_apps_payments_sdk.BeamBoltPaymentMethod;
+/** Bolt intent as returned by list/get helpers (timestamps ISO; nullables are null). */
+interface SimBoltIntentRecord {
+    id: string;
+    beamIntentId: string;
+    boltConnectionId: string;
+    amount: number;
+    currency: string;
+    paymentMethodType: SimBoltPaymentMethod;
+    referenceId: string | null;
+    internalNote: string | null;
+    status: SimBoltIntentStatus;
+    isVirtual: boolean;
+    environment: "sandbox" | "preview" | "production";
+    expiresAt: string;
+    settledAt: string | null;
+    chargeId: string | null;
+    failureReason: string | null;
+    createdAt: string;
+}
+interface SimBoltCharge {
+    id: string;
+    status: "SUCCEEDED" | "FAILED" | "PENDING";
+    amount?: number;
+    currency?: string;
+    sourceId?: string;
+    createdAt?: string;
+}
 interface TestPayments {
     get checkouts(): CapturedCheckout[];
     latest(): CapturedCheckout | undefined;
@@ -153,6 +202,30 @@ interface TestPayments {
         path?: string;
         deploymentSecret?: string;
     }): Promise<Response>;
+    /**
+     * Mark a PENDING bolt intent PAID and record a SUCCEEDED charge. Does not
+     * deliver a webhook — call `deliverBeamEvent` with `charge.succeeded` (reuse
+     * the existing signing path) after approving, the same way `markPaid` pairs
+     * with `deliverStripeEvent` / `deliverBeamEvent`.
+     */
+    approveBoltIntent(intentId: string, options?: {
+        chargeId?: string;
+    }): SimBoltCharge;
+    /**
+     * Mark a PENDING bolt intent FAILED and record a FAILED charge.
+     * Delivers no webhook: Beam's catalog has no charge-failure event for bolt
+     * payments, and the real product notifies the app of nothing on decline.
+     */
+    declineBoltIntent(intentId: string, options?: {
+        failureReason?: string;
+    }): SimBoltCharge;
+    /**
+     * Backdate `expiresAt` so the intent derives as EXPIRED on the next read.
+     * Delivers no webhook: Beam does not notify apps when a bolt intent expires.
+     */
+    expireBoltIntent(intentId: string): void;
+    listBoltIntents(): SimBoltIntentRecord[];
+    getBoltIntent(intentId: string): SimBoltIntentRecord | undefined;
     clear(): void;
     get count(): number;
 }
@@ -366,6 +439,13 @@ interface TestEdge {
     get count(): number;
 }
 interface TestAppOptions {
+    /** Data stores exposed through the production-shaped STARDECK_DATA_STORES manifest. */
+    dataStores?: TestDataStoreInput[];
+    /**
+     * Force the legacy single-store DATA_STORE_URL on or off. By default it is
+     * present only for the zero-config manifest, and omitted once a manifest is configured.
+     */
+    legacyDataStoreUrl?: boolean;
     /**
      * Path to the schema.sql snapshot generated by
      * `npx stardeck-data-store generate-types` (relative to the project root).
@@ -446,6 +526,7 @@ declare function parseWorkflowName(describeTitle: string): string | null;
 
 declare const CONTROL_PLANE_TEST_URL = "https://control-plane.stardeck.test";
 declare const DATA_STORE_TEST_HOST = "db.stardeck.test";
+declare const DATA_STORE_TEST_URL = "postgresql://test:test@db.stardeck.test/main";
 declare const STORAGE_TEST_URL = "https://storage.stardeck.test";
 declare const STORAGE_TEST_HOST = "storage.stardeck.test";
 declare const TEST_ENV_DEFAULTS: {
@@ -454,10 +535,9 @@ declare const TEST_ENV_DEFAULTS: {
     readonly ORGANIZATION_ID: "00000000-0000-4000-8000-00000000000a";
     readonly PROJECT_ID: "00000000-0000-4000-8000-00000000000b";
     readonly DEPLOYMENT_ID: "00000000-0000-4000-8000-00000000000c";
-    readonly DATA_STORE_URL: "postgresql://test:test@db.stardeck.test/main";
     readonly STORAGE_URL: "https://storage.stardeck.test";
 };
 /** 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, DEFAULT_SCHEMA_PATH, type DeviceInfo, type PeripheralInfo, STORAGE_TEST_HOST, STORAGE_TEST_URL, type SessionTokens, TEST_ENV_DEFAULTS, type TestApp, type TestAppOptions, 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 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 };