@mindbill/react 0.28.0 → 0.28.1

package/README.md

@@ -20,6 +20,11 @@ import { ConnectedBillLifecycle } from "@mindbill/react";
 />
 ```
 
+Sandbox and live responses use the same component contract. Simulation controls
+are hidden by default, including when the connected organization is a sandbox.
+Only a dedicated developer playground should opt in with
+`sandboxControls={true}`; production applications should omit the prop.
+
 ## Appearance
 
 Choose a complete preset, then override only the tokens your design system owns. The preset applies to review, payer search, attachments, submission, status, EOR, payment, denial, resubmission, and close states.

package/dist/index.d.ts

@@ -844,13 +844,19 @@ type UseBillLifecycleResult = {
 declare function useBillLifecycle({ billId: providedBillId, sessionEndpoint, getSession, apiBaseUrl, refreshInterval, enabled, fetch: fetchOverride, }: UseBillLifecycleOptions): UseBillLifecycleResult;
 type ConnectedBillLifecycleProps = UseBillLifecycleOptions & {
     appearance?: MindBillReactAppearance;
+    /**
+     * Exposes payer-response simulation controls for an explicit sandbox
+     * playground. Sandbox responses remain indistinguishable from live
+     * lifecycle responses to ordinary host applications.
+     */
+    sandboxControls?: boolean;
     className?: string;
     style?: CSSProperties;
     loadingFallback?: ReactNode;
     errorFallback?: (error: Error, retry: () => Promise<void>) => ReactNode;
     onChanged?: (data: BillLifecycleData) => void;
 };
-declare function ConnectedBillLifecycle({ appearance, className, style, loadingFallback, errorFallback, onChanged, ...options }: ConnectedBillLifecycleProps): ReactElement;
+declare function ConnectedBillLifecycle({ appearance, sandboxControls, className, style, loadingFallback, errorFallback, onChanged, ...options }: ConnectedBillLifecycleProps): ReactElement;
 
 type MindBillWidgetProps = {
     sessionToken: string;

package/dist/index.js

@@ -3566,7 +3566,10 @@ function sandboxScenarios(state) {
   ];
   return [];
 }
-function ConnectedBillLifecycle({ appearance, className, style, loadingFallback, errorFallback, onChanged, ...options }) {
+function shouldShowSandboxControls(environment, enabled = false) {
+  return enabled && environment === "sandbox";
+}
+function ConnectedBillLifecycle({ appearance, sandboxControls = false, className, style, loadingFallback, errorFallback, onChanged, ...options }) {
   const lifecycle = useBillLifecycle(options);
   const { data } = lifecycle;
   const [tab, setTab] = useState6("details");
@@ -3615,7 +3618,8 @@ function ConnectedBillLifecycle({ appearance, className, style, loadingFallback,
   const viewEor = data.lifecycle.actions.find((action) => action.id === "view_eor" && action.enabled);
   const supportedActions = /* @__PURE__ */ new Set(["resubmit", "second_review", "post_payment", "close", "reopen"]);
   const actions = data.lifecycle.actions.filter((action) => action.enabled && supportedActions.has(action.id));
-  const simulations = data.environment === "sandbox" ? sandboxScenarios(data.lifecycle.state) : [];
+  const showSandboxControls = shouldShowSandboxControls(data.environment, sandboxControls);
+  const simulations = showSandboxControls ? sandboxScenarios(data.lifecycle.state) : [];
   return /* @__PURE__ */ jsxs7("section", { className: ["mb-connected-lifecycle", className].filter(Boolean).join(" "), style: mindBillAppearanceStyle(appearance, style), children: [
     /* @__PURE__ */ jsx7("style", { children: CONNECTED_LIFECYCLE_STYLES }),
     /* @__PURE__ */ jsx7(BillLifecycleProgress, { state: data.lifecycle.state, nativeStatus: data.lifecycle.nativeStatus, submittedAt: data.lifecycle.submittedAt ?? null, agingDays: data.lifecycle.agingDays ?? null, ...appearance ? { appearance } : {} }),
@@ -3639,7 +3643,7 @@ function ConnectedBillLifecycle({ appearance, className, style, loadingFallback,
     ] }),
     tab === "details" ? /* @__PURE__ */ jsxs7("div", { className: "mb-lifecycle-tabpanel", role: "tabpanel", children: [
       data.eors.length || data.payments.length || ["processed", "denied", "partially_paid"].includes(data.lifecycle.state) ? /* @__PURE__ */ jsx7(BillExplanationOfReview, { remittance: data.remittance, eors: data.eors, payments: data.payments, submittedAt: data.lifecycle.submittedAt ?? null, onOpenEor: lifecycle.openEor, ...appearance ? { appearance } : {} }) : null,
-      data.environment === "sandbox" ? /* @__PURE__ */ jsxs7("section", { className: "mb-lifecycle-simulator", "aria-label": "Sandbox lifecycle simulator", children: [
+      showSandboxControls ? /* @__PURE__ */ jsxs7("section", { className: "mb-lifecycle-simulator", "aria-label": "Sandbox lifecycle simulator", children: [
         /* @__PURE__ */ jsxs7("div", { children: [
           /* @__PURE__ */ jsx7("span", { children: "Sandbox demo controls" }),
           /* @__PURE__ */ jsx7("h3", { children: "Simulate the next payer response" }),