@crvouga/mockingbird-service-flex 3.10.0 → 4.0.1

package/dist/{chunk-OATZRDML.js → chunk-BW7LXOWN.js}

@@ -9,7 +9,7 @@ import {
   parseFaultHeader,
   resolveAdminPrefix,
   restoreClock
-} from "./chunk-NKBXNJ5B.js";
+} from "./chunk-AGWRBLUO.js";
 
 // ../../adapters/node/dist/cli.js
 import { readFile as readFile5 } from "node:fs/promises";
@@ -3057,7 +3057,7 @@ async function preflightFleet(config, options) {
             break;
         }
       }
-      targets.set(name, { ...target, packageVersion: packageVersion ?? "3.10.0" });
+      targets.set(name, { ...target, packageVersion: packageVersion ?? "4.0.1" });
     } catch (error) {
       throw new Error(`service ${name}: ${error instanceof Error ? error.message : String(error)}`, { cause: error });
     }
@@ -5062,4 +5062,4 @@ export {
   createServer2 as createServer,
   serveTarget
 };
-//# sourceMappingURL=chunk-OATZRDML.js.map
+//# sourceMappingURL=chunk-BW7LXOWN.js.map

package/dist/cli.js

@@ -3,8 +3,8 @@ import {
   runCli,
   serveCommand,
   serveTarget
-} from "./chunk-OATZRDML.js";
-import "./chunk-NKBXNJ5B.js";
+} from "./chunk-BW7LXOWN.js";
+import "./chunk-AGWRBLUO.js";
 
 // src/cli.ts
 var code = await runCli(

package/dist/index.d.ts

@@ -1494,6 +1494,12 @@ declare const FLEX_NAMESPACE = "flex";
 /** Every webhook event type the mock sends (our receiver reconciles on each). */
 declare const FLEX_EVENT_TYPES: readonly ["product.updated", "checkout.session.completed", "checkout_session.completed", "checkout.session.async_payment_succeeded", "checkout.session.async_payment_failed", "checkout.session.refunded", "checkout.session.expired", "checkout_session.expired", "payment_intent.succeeded", "customer.subscription.created", "refund.created", "refund.updated", "charge.refunded", "charge.refund.updated"];
 type FlexEventType = (typeof FLEX_EVENT_TYPES)[number];
+/**
+ * The key Flex nests an event's object under (`EventObject` in Flex's OpenAPI): a
+ * `refund.created` event carries `{refund: {...}}`, a `checkout.session.completed` event
+ * `{checkout_session: {...}}`. `charge.refund.updated` carries the refund.
+ */
+declare const eventObjectKey: (type: string) => string;
 /** The event inside the `{event: {...}}` webhook envelope. */
 type FlexEvent = {
     event_id: string;
@@ -1569,8 +1575,23 @@ declare class FlexAPI implements FetchAPI$1 {
     private getSession;
     private listSessions;
     private refund;
-    /** Refund part or all of a paid session, emitting the refund events. */
+    /**
+     * Refund part or all of a paid session, emitting the refund events Flex sends:
+     * `checkout.session.refunded` (seen in test mode, carrying the session and its refunds),
+     * then, in the order production delivers a dashboard refund, `refund.created` twice,
+     * `charge.refunded`, `refund.updated` and `charge.refund.updated`. An endpoint receives only
+     * the types it subscribes to.
+     */
     applyRefund(id: string, amount: number): SessionRecord | undefined;
+    /** Refund a paid session from Flex's dashboard (`POST /__admin/sessions/:id/refund`). */
+    dashboardRefund(id: string, amount?: number): {
+        session: SessionRecord;
+    } | {
+        status: 400 | 404 | 409;
+        message: string;
+    };
+    private presentRefund;
+    private presentCharge;
     private createCustomer;
     private newCustomer;
     private getSetupIntent;
@@ -1621,5 +1642,5 @@ declare class FlexAPI implements FetchAPI$1 {
 /** Whether a string is one of the next-action types. */
 declare const isNextActionType: (value: unknown) => value is NextActionType;
 
-export { CARDS, CORPUS_ROWS, DEFAULT_SETTINGS, ELIGIBILITIES, FLEX_EVENT_TYPES, FLEX_NAMESPACE, FLEX_PRESETS, FlexAPI, NEXT_ACTION_TYPES, PAYMENT_INTENT_STATUSES, SUBSCRIPTION_STATUSES, classifyCard, corpusProduct, createRuntime, document, isNextActionType, keyMode, operationIds, periodEnd, substituteSessionId, supportedOperationIds };
+export { CARDS, CORPUS_ROWS, DEFAULT_SETTINGS, ELIGIBILITIES, FLEX_EVENT_TYPES, FLEX_NAMESPACE, FLEX_PRESETS, FlexAPI, NEXT_ACTION_TYPES, PAYMENT_INTENT_STATUSES, SUBSCRIPTION_STATUSES, classifyCard, corpusProduct, createRuntime, document, eventObjectKey, isNextActionType, keyMode, operationIds, periodEnd, substituteSessionId, supportedOperationIds };
 export type { CardOutcome, CorpusRow, CustomerRecord, Eligibility, FetchAPI$1 as FetchAPI, FlexAPIOptions, FlexEvent, FlexEventType, FlexRuntime, FlexRuntimeOptions, LineItemRecord, NextAction, NextActionType, OperationId, PaymentIntentRecord, PaymentIntentStatus, PaymentMethodRecord, ProductRecord, Recurring, RefundRecord, SessionMode, SessionRecord, SessionStatus, Settings, SetupIntentRecord, SqliteClient, SubscriptionData, SubscriptionRecord, SubscriptionStatus, SupportedOperationId };

package/dist/index.js

@@ -14,13 +14,14 @@ import {
   corpusProduct,
   createRuntime,
   document,
+  eventObjectKey,
   isNextActionType,
   keyMode,
   operationIds,
   periodEnd,
   substituteSessionId,
   supportedOperationIds
-} from "./chunk-NKBXNJ5B.js";
+} from "./chunk-AGWRBLUO.js";
 export {
   CARDS,
   CORPUS_ROWS,
@@ -37,6 +38,7 @@ export {
   corpusProduct,
   createRuntime,
   document,
+  eventObjectKey,
   isNextActionType,
   keyMode,
   operationIds,

package/dist/server.d.ts

@@ -2289,8 +2289,23 @@ declare class FlexAPI implements FetchAPI {
     private getSession;
     private listSessions;
     private refund;
-    /** Refund part or all of a paid session, emitting the refund events. */
+    /**
+     * Refund part or all of a paid session, emitting the refund events Flex sends:
+     * `checkout.session.refunded` (seen in test mode, carrying the session and its refunds),
+     * then, in the order production delivers a dashboard refund, `refund.created` twice,
+     * `charge.refunded`, `refund.updated` and `charge.refund.updated`. An endpoint receives only
+     * the types it subscribes to.
+     */
     applyRefund(id: string, amount: number): SessionRecord | undefined;
+    /** Refund a paid session from Flex's dashboard (`POST /__admin/sessions/:id/refund`). */
+    dashboardRefund(id: string, amount?: number): {
+        session: SessionRecord;
+    } | {
+        status: 400 | 404 | 409;
+        message: string;
+    };
+    private presentRefund;
+    private presentCharge;
     private createCustomer;
     private newCustomer;
     private getSetupIntent;

package/dist/server.js

@@ -2,8 +2,8 @@ import {
   DEFAULT_PORT,
   createServer,
   serveTarget
-} from "./chunk-OATZRDML.js";
-import "./chunk-NKBXNJ5B.js";
+} from "./chunk-BW7LXOWN.js";
+import "./chunk-AGWRBLUO.js";
 export {
   DEFAULT_PORT,
   createServer,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@crvouga/mockingbird-service-flex",
-  "version": "3.10.0",
+  "version": "4.0.1",
   "description": "Stateful emulator of the Flex HSA/FSA payments API: products (recorded catalog corpus), checkout sessions in payment, subscription, off-session and setup modes, subscriptions, customers, setup intents, refunds, the hosted checkout page, and Svix-signed webhooks.",
   "license": "MIT",
   "type": "module",