@stardeck-customer-apps/testing 0.20.0 → 0.22.0

package/SKILL.md

@@ -421,6 +421,24 @@ externalId })` helper models a trusted platform/channel link, and
   `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).
+  Beam direct charges (inline checkout): `.directCharges`, `.getDirectCharge(id)`,
+  `.completeDirectCharge(id)` and `.failDirectCharge(id, failureCode?)` settle a
+  PENDING charge and return the `charge.succeeded` / `charge.failed` payload to
+  pass to `.deliverBeamEvent`. `QR_PROMPT_PAY` returns `ENCODED_IMAGE` (expiry
+  honours `expiryDurationInSec`), wallets and mobile banking return `REDIRECT`
+  to `https://beam.stardeck.test/pay/<id>?returnUrl=…`, and the same
+  `idempotencyKey` returns the same charge. Card tokens: `tokenizeBeamCard`
+  against the simulated Beam host returns `ctok_sim_<n>`; the card number picks
+  the outcome of a `CARD_TOKEN` charge — `4111111111111111` / `5372074248113841`
+  succeed (`NONE`), `4953261730509988` / `4389783280144506` need OTP
+  (`REDIRECT`), `4943129900084541` fails `CH_INSUFFICIENT_FUNDS`,
+  `4111111111000025` fails `CH_CARD_DECLINED`, `4111111111000033` fails
+  `CH_CARD_RESTRICTED`, anything else fails `CH_PROCESSING_FAILED`.
+  `.setCardTokenization(false)` models a merchant with no publishable key
+  (`getCardTokenizationConfig` throws `CARD_TOKENIZATION_NOT_CONFIGURED`).
+  Raw `CARD` / `CARD_INSTALLMENTS`, token methods without a `cardToken`, and
+  non-QR methods without a `returnUrl` are
+  refused with 400, as on the control plane.
 - `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()`. LINE Flex
@@ -497,8 +515,8 @@ 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 + Bolt+
-  connections/intents/charges, product list) — captured in `app.payments`;
+- `PaymentsServerClient` (Stripe checkout + Beam payment links + Beam direct
+  charges and card tokenization + 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`. Beam payment-link
@@ -512,7 +530,8 @@ cursor, limit })`; `list()` intentionally keeps its previous array shape.
   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
+  `beam.createPaymentLink`, `beam.getPaymentLinkStatus`, `beam.createDirectCharge`,
+  and `beam.getCharge`. 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.
@@ -530,8 +549,13 @@ cursor, limit })`; `list()` intentionally keeps its previous array shape.
   production) or `app.starlens.reject("not a receipt")` (the 422 the SDK maps to
   `UnsupportedDocumentError`). An unregistered call fails with a descriptive 502 so a
   test never passes on an invented extraction. `app.starlens.calls` records each
-  request's version, input names/media types (never bytes), schema and
-  instructions — assert your `.describe()` aliases reached the wire there.
+  request's version, effort, input names/media types (never bytes), schema and
+  instructions — assert your `.describe()` aliases and `effort: "high"` retries
+  reached the wire there. `version: "v1"` with `effort: "high"` is refused with the
+  same 400 `unsupported_effort` as production (the SDK throws `ValidationError`). A
+  high request with no image input answers `effort: "low"` as production does;
+  pass `effort: "low"` in `app.starlens.mock(...)` to simulate an image production
+  could not decode.
 
 ### Receipt layout and printer capabilities
 

package/dist/index.d.mts

@@ -210,7 +210,7 @@ interface CapturedCheckout {
     metadata?: Record<string, string>;
     createdAt: Date;
 }
-type PaymentSimulatorOperation = "stripe.createCheckout" | "stripe.getCheckoutSessionStatus" | "beam.createPaymentLink" | "beam.getPaymentLinkStatus";
+type PaymentSimulatorOperation = "stripe.createCheckout" | "stripe.getCheckoutSessionStatus" | "beam.createPaymentLink" | "beam.getPaymentLinkStatus" | "beam.createDirectCharge" | "beam.getCharge";
 type PaymentSimulatorFailure = {
     kind?: "http";
     status: 400 | 402 | 409 | 429 | 500 | 503;
@@ -269,6 +269,26 @@ interface SimBoltCharge {
     sourceId?: string;
     createdAt?: string;
 }
+/** A direct charge (`createDirectCharge`) as the simulator holds it. */
+interface SimDirectCharge {
+    id: string;
+    status: "SUCCEEDED" | "FAILED" | "PENDING";
+    amount: number;
+    currency: string;
+    paymentMethodType: string;
+    referenceId: string | null;
+    deviceType: string | null;
+    returnUrl: string | null;
+    actionRequired: "NONE" | "REDIRECT" | "ENCODED_IMAGE";
+    redirectUrl: string | null;
+    /** When the QR (or the charge) stops being payable. */
+    expiresAt: string;
+    failureCode: string | null;
+    /** Last four digits of a CARD_TOKEN charge's card. */
+    cardLast4: string | null;
+    idempotencyKey: string | null;
+    createdAt: string;
+}
 interface TestPayments {
     get checkouts(): CapturedCheckout[];
     latest(): CapturedCheckout | undefined;
@@ -317,6 +337,19 @@ interface TestPayments {
     expireBoltIntent(intentId: string): void;
     listBoltIntents(): SimBoltIntentRecord[];
     getBoltIntent(intentId: string): SimBoltIntentRecord | undefined;
+    /** Every direct charge created so far, oldest first. */
+    get directCharges(): SimDirectCharge[];
+    getDirectCharge(chargeId: string): SimDirectCharge | undefined;
+    /**
+     * The shopper paid: mark a PENDING direct charge SUCCEEDED and return the
+     * `charge.succeeded` payload. Delivers no webhook; pass the payload to
+     * `deliverBeamEvent` the way Beam would.
+     */
+    completeDirectCharge(chargeId: string): Record<string, unknown>;
+    /** Mark a PENDING direct charge FAILED; returns the `charge.failed` payload. */
+    failDirectCharge(chargeId: string, failureCode?: string): Record<string, unknown>;
+    /** Turn card tokenization off, as for a merchant with no publishable key. On by default. */
+    setCardTokenization(enabled: boolean): void;
     clear(): void;
     get count(): number;
 }
@@ -536,7 +569,10 @@ interface TestEdge {
 }
 /** One Starlens request the app made, as the simulator saw it (names only, never bytes). */
 interface CapturedStarlensCall {
+    /** As sent (`latest` stays `latest`). */
     version: string;
+    /** As requested; `"low"` when the app did not set one. The reply says what ran. */
+    effort: "low" | "high";
     inputs: {
         name: string;
         mediaType: string | null;
@@ -557,6 +593,12 @@ type StarlensReply = {
         path: string;
         reason: string;
     }[];
+    /**
+     * The effort the reply says ran. Defaults to the requested effort, or `"low"` for a
+     * high request with no image input (production cannot crop a PDF, audio or video).
+     * Set `"low"` to simulate a high request on an image production could not decode.
+     */
+    effort?: "low" | "high";
 } | {
     reject: string;
 };

package/dist/index.d.ts

@@ -210,7 +210,7 @@ interface CapturedCheckout {
     metadata?: Record<string, string>;
     createdAt: Date;
 }
-type PaymentSimulatorOperation = "stripe.createCheckout" | "stripe.getCheckoutSessionStatus" | "beam.createPaymentLink" | "beam.getPaymentLinkStatus";
+type PaymentSimulatorOperation = "stripe.createCheckout" | "stripe.getCheckoutSessionStatus" | "beam.createPaymentLink" | "beam.getPaymentLinkStatus" | "beam.createDirectCharge" | "beam.getCharge";
 type PaymentSimulatorFailure = {
     kind?: "http";
     status: 400 | 402 | 409 | 429 | 500 | 503;
@@ -269,6 +269,26 @@ interface SimBoltCharge {
     sourceId?: string;
     createdAt?: string;
 }
+/** A direct charge (`createDirectCharge`) as the simulator holds it. */
+interface SimDirectCharge {
+    id: string;
+    status: "SUCCEEDED" | "FAILED" | "PENDING";
+    amount: number;
+    currency: string;
+    paymentMethodType: string;
+    referenceId: string | null;
+    deviceType: string | null;
+    returnUrl: string | null;
+    actionRequired: "NONE" | "REDIRECT" | "ENCODED_IMAGE";
+    redirectUrl: string | null;
+    /** When the QR (or the charge) stops being payable. */
+    expiresAt: string;
+    failureCode: string | null;
+    /** Last four digits of a CARD_TOKEN charge's card. */
+    cardLast4: string | null;
+    idempotencyKey: string | null;
+    createdAt: string;
+}
 interface TestPayments {
     get checkouts(): CapturedCheckout[];
     latest(): CapturedCheckout | undefined;
@@ -317,6 +337,19 @@ interface TestPayments {
     expireBoltIntent(intentId: string): void;
     listBoltIntents(): SimBoltIntentRecord[];
     getBoltIntent(intentId: string): SimBoltIntentRecord | undefined;
+    /** Every direct charge created so far, oldest first. */
+    get directCharges(): SimDirectCharge[];
+    getDirectCharge(chargeId: string): SimDirectCharge | undefined;
+    /**
+     * The shopper paid: mark a PENDING direct charge SUCCEEDED and return the
+     * `charge.succeeded` payload. Delivers no webhook; pass the payload to
+     * `deliverBeamEvent` the way Beam would.
+     */
+    completeDirectCharge(chargeId: string): Record<string, unknown>;
+    /** Mark a PENDING direct charge FAILED; returns the `charge.failed` payload. */
+    failDirectCharge(chargeId: string, failureCode?: string): Record<string, unknown>;
+    /** Turn card tokenization off, as for a merchant with no publishable key. On by default. */
+    setCardTokenization(enabled: boolean): void;
     clear(): void;
     get count(): number;
 }
@@ -536,7 +569,10 @@ interface TestEdge {
 }
 /** One Starlens request the app made, as the simulator saw it (names only, never bytes). */
 interface CapturedStarlensCall {
+    /** As sent (`latest` stays `latest`). */
     version: string;
+    /** As requested; `"low"` when the app did not set one. The reply says what ran. */
+    effort: "low" | "high";
     inputs: {
         name: string;
         mediaType: string | null;
@@ -557,6 +593,12 @@ type StarlensReply = {
         path: string;
         reason: string;
     }[];
+    /**
+     * The effort the reply says ran. Defaults to the requested effort, or `"low"` for a
+     * high request with no image input (production cannot crop a PDF, audio or video).
+     * Set `"low"` to simulate a high request on an image production could not decode.
+     */
+    effort?: "low" | "high";
 } | {
     reject: string;
 };