@funnelsgrove/cli 0.1.7 → 0.1.8

package/dist/cli.js

@@ -35,6 +35,8 @@ const resolveTemplatePath = (slug) => path.resolve(__dirname, '..', '..', '..',
 const resolveTemplateDocsPath = () => path.resolve(__dirname, '..', TEMPLATE_DOCS_DIR);
 const DEFAULT_API_URL = 'https://api.funnelsgrove.com/trpc';
 const UUID_PATTERN = /^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;
+const PUBLISH_POLL_INTERVAL_MS = 2_000;
+const PUBLISH_WAIT_TIMEOUT_MS = 30 * 60_000;
 const getApiUrl = () => {
     const options = program.opts();
     return options.apiUrl || process.env.FUNNELSGROVE_API_URL || DEFAULT_API_URL;
@@ -59,6 +61,40 @@ const callApi = async (input) => {
         token: input.token,
     });
 };
+const sleep = async (ms) => {
+    await new Promise((resolve) => {
+        setTimeout(resolve, ms);
+    });
+};
+const isTerminalDeploymentState = (state) => {
+    return ['ready', 'failed', 'expired', 'canceled'].includes(state.trim().toLowerCase());
+};
+const waitForPublishDeployment = async (input) => {
+    const deadline = Date.now() + PUBLISH_WAIT_TIMEOUT_MS;
+    while (Date.now() <= deadline) {
+        const detail = await callApi({
+            path: 'funnels.detail',
+            type: 'query',
+            token: input.token,
+            data: {
+                workspaceId: input.workspaceId,
+                funnelId: input.funnelId,
+            },
+        });
+        const deployment = detail.deployments.find((item) => item.id === input.deploymentId);
+        if (deployment && isTerminalDeploymentState(deployment.state)) {
+            if (deployment.state === 'failed') {
+                throw new Error(deployment.qa_summary || 'Publish deployment failed.');
+            }
+            if (deployment.state === 'expired' || deployment.state === 'canceled') {
+                throw new Error(`Publish deployment ${deployment.state}.`);
+            }
+            return deployment;
+        }
+        await sleep(PUBLISH_POLL_INTERVAL_MS);
+    }
+    throw new Error(`Timed out waiting for publish deployment ${input.deploymentId}.`);
+};
 const readCodeFromStdin = async () => {
     const rl = createInterface({
         input: process.stdin,
@@ -608,7 +644,13 @@ addExamples(program
             domains: publishEnv === 'production' && options.domain ? [options.domain] : undefined,
         },
     });
-    console.log(`${result.deploymentUrl}\tv${result.publishedVersionSeq}\t${result.publishedVersionId}`);
+    const readyDeployment = await waitForPublishDeployment({
+        token,
+        workspaceId: target.workspaceId,
+        funnelId: target.funnelId,
+        deploymentId: result.deploymentId,
+    });
+    console.log(`${readyDeployment.deployment_url || result.deploymentUrl}\tv${result.publishedVersionSeq}\t${result.publishedVersionId}`);
 });
 const githubCommand = addExamples(program.command('github').description('Manage GitHub funnel sync'), [
     'fgrove github status --funnel claimbee-general',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@funnelsgrove/cli",
-  "version": "0.1.7",
+  "version": "0.1.8",
   "description": "FunnelsGrove command-line tools for editing, syncing, and publishing funnels",
   "type": "module",
   "bin": {

package/template_docs/docs/editing-flow.md

@@ -7,7 +7,9 @@ Flow is product logic. The source of truth is `src/config/funnel.manifest.ts`; r
 The manifest defines:
 
 - `viewport`: the designed shell size, usually `430 x 932`.
-- `assets`: preloaded image metadata used by runtime/build tooling.
+- `assets`: image metadata used by runtime/build tooling. Funnel shells may use
+  this data to warm likely next-step images, but first-viewport images should
+  still use the framework's normal priority/preload mechanism.
 - `steps`: every routable step with `id`, `path`, `filePath`, `componentKey`, `type`, optional `kind`, and optional `assetIds`.
 - `edgesByStepId`: graph edges between steps.
 - `experiments`: optional variant routing.

package/template_docs/docs/payment-plans-and-discounts.md

@@ -48,12 +48,16 @@ Runtime config should come from `runtimePublicConfig` through a local `src/runti
 
 Subscription paywalls with on-page wallet buttons should share one `useStripeSubscriptionCheckoutSession(...)` instance across the manual card checkout and wallet checkout. Do not build funnel-local Stripe PaymentIntent or Express Checkout flows.
 
+- Keep funnel-specific checkout orchestration local when it includes product layout, analytics callbacks, return URL branching, or email prompt copy. The shared UI boundary is `SharedStripeCheckoutV2Dialog`; do not add another shared wrapper that duplicates a funnel's paywall composition.
 - Use `SharedStripeCheckoutV2Dialog` for the manual/card checkout modal. Open it from the paywall CTA after the checkout session has an `activeClientSecret` and `stripePromise`.
 - Render real wallet slots on the paywall with `ApplePaySubscriptionCheckoutSlot` and `GooglePaySubscriptionCheckoutSlot`, usually above the manual/card CTA. Pass the same checkout session, selected plan amount, return URL, customer details, summary label, success handler, and any `beforeConfirm` logic used to finalize email or analytics metadata.
 - Use `usePlatformWalletPaymentMethods()` to decide which slots to render. Desktop web can show Apple Pay and Google Pay; iOS shows Apple Pay; Android shows Google Pay.
 - Track each slot's `onAvailabilityChange` result by the current `checkoutSession.intentKey`. When opening `SharedStripeCheckoutV2Dialog`, derive `initialWalletAvailable` from the current intent's confirmed wallet availability and pass it into the dialog so checkout can show the wallet tab immediately when a wallet is already known to be available.
 - Treat unknown wallet availability as `null`, not `false`. Only hide/fallback from a wallet after Stripe or the shared slot reports that wallet unavailable.
+- Treat Checkout Session/API preparation failures as retryable checkout failures, not wallet unavailability. A failed `prepareWalletCheckout()` should leave the wallet slot in unknown availability and show the real clickable fallback placeholder after loading stops; only Stripe readiness/availability reports should mark a wallet unavailable.
 - Suspend paywall wallet slots while the shared checkout dialog or another blocking offer modal is open, so two Stripe Express Checkout elements do not compete for the same active checkout session.
+- If checkout starts without a known customer email, first try to resolve it from a known `user_id` or `stripe_customer_id`. Only show an email prompt when there is no known identity to fetch from, or that lookup returns no email.
+- Before publishing payment changes, run the shared wallet smoke helper from `@funnelsgrove/payments` against local and preview paywall URLs. The package script is `npm run smoke:wallet --workspace @funnelsgrove/payments -- --url <paywall-url>` and accepts selector overrides through CLI flags or `WALLET_SMOKE_*` env vars.
 
 ## Paywall Identity Handoff
 

package/template_docs/docs/sdk-api-endpoints.md

@@ -50,6 +50,8 @@ Always pass runtime checkout config so published funnels, preview funnels, and l
 
 Checkout endpoints receive `user_id` and `customerEmail` when available. Stripe metadata and `client_reference_id` rely on these values for webhook reconciliation, analytics, and project user support links.
 
+When a funnel sends a configured Stripe `providerPlanId`, public checkout APIs validate that price id against Stripe and fail with a client-visible error if it is missing. Do not silently replace configured price ids with generated `price_data`; dynamic price fallback is only for legacy/catalog entries that have no provider price id.
+
 ## Subscription APIs
 
 Use the runtime service methods instead of calling the endpoints directly: