@growth-operations/ui-shared 1.32.0 → 1.34.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@growth-operations/ui-shared",
-  "version": "1.32.0",
+  "version": "1.34.0",
   "description": "Shared HubSpot UI-extension modules (Home, Billing) for Growth Operations apps.",
   "license": "MIT",
   "private": false,

package/src/billing/AutoProvisionToggle.jsx

@@ -103,7 +103,7 @@ export function AutoProvisionToggle({
         <Alert variant="warning" title="Disable automatic credit provisioning?">
           <Box flex="auto">
             <Flex direction="column" gap="small">
-              <Text>{autoProvisionConfirmBody(appName)}</Text>
+              <Text>{autoProvisionConfirmBody(appName, appKey)}</Text>
               <Flex direction="row" gap="small">
                 <Button
                   variant="destructive"

package/src/billing/BillingTab.jsx

@@ -22,7 +22,7 @@ import { useStrictModeEffect } from "../lib/useStrictModeEffect";
 import { CreditMeter } from "../home/CreditMeter";
 import { PlanGrid } from "./PlanGrid";
 import { AutoProvisionToggle } from "./AutoProvisionToggle";
-import { resolveAutoProvision } from "../lib/autoProvision";
+import { autoProvisionBlockOf, resolveAutoProvision } from "../lib/autoProvision";
 import { refreshBillingActionTokens } from "../sdk/billing";
 import { getInvoices } from "../sdk/app/topUps";
 
@@ -691,7 +691,12 @@ export function CreditsBilling({ context, state, appKey, openIframe = null }) {
             <AutoProvisionToggle
               context={context}
               appKey={appKey}
-              enabled={resolveAutoProvision(state?.auto_provision).enabled}
+              // Dual-read: the backends nest auto_provision under
+              // payload.state — a top-level-only read would snap a disabled
+              // toggle back to ON on every refetch.
+              enabled={
+                resolveAutoProvision(autoProvisionBlockOf(state)).enabled
+              }
               appName={state?.app?.name ?? "this app"}
               // The POST's second auth dep (see setAutoProvision). `state`
               // here is BillingTab's interval-refreshed copy, so this token is

package/src/index.js

@@ -43,6 +43,10 @@ export {
 // Sandbox — the shared "Install on a sandbox" action (mints a signed link).
 export { SandboxInstall } from "./sandbox/SandboxInstall";
 
+// Support — the shared in-app support request form (posts to the app's
+// support route; see common.support).
+export { SupportTab } from "./support/SupportTab";
+
 // Forms — shared HubSpot-options dropdown (forms/lists/pipeline-stages picker).
 export { OptionSelect } from "./forms/OptionSelect";
 

package/src/lib/autoProvision.js

@@ -14,8 +14,19 @@ export function autoProvisionSubtext(appName) {
   return `If monthly credits are used, this will automatically purchase another pack of credits so use of ${appName} is not impacted.`;
 }
 
-export function autoProvisionConfirmBody(appName) {
-  return `Are you sure you want to disable automatic credit provisioning? If monthly credits are used, ${appName} will no longer function and workflow actions will fail.`;
+// The ON→OFF confirmation's ending, per app. The default names the generic
+// consequence (workflow actions fail); ATS has no workflow actions — its
+// credit-gated features just stop working — so Andrew's 2026-10-19 copy names
+// the user-visible consequence instead.
+const CONFIRM_BODY_ENDINGS = {
+  applicant_tracking_system:
+    "and features like resume parsing will stop functioning until credit renew at the start of the next bill period.",
+};
+const DEFAULT_CONFIRM_BODY_ENDING = "and workflow actions will fail.";
+
+export function autoProvisionConfirmBody(appName, appKey) {
+  const ending = CONFIRM_BODY_ENDINGS[appKey] ?? DEFAULT_CONFIRM_BODY_ENDING;
+  return `Are you sure you want to disable automatic credit provisioning? If monthly credits are used, ${appName} will no longer function ${ending}`;
 }
 
 export const AUTO_PROVISION_CONFIRM_YES = "Yes, disable this feature.";
@@ -28,6 +39,15 @@ export function resolveAutoProvision(autoProvision) {
   return { enabled: autoProvision?.enabled !== false };
 }
 
+// The auto_provision block off a /v1/home PAYLOAD, dual-read like
+// planFitOf/periodComparisonOf (lib/homeBlocks): base-hosted and ATS backends
+// nest it under payload.state; a top-level read alone silently resolves to
+// the default ON for a disabled account after every refetch/remount.
+export function autoProvisionBlockOf(state) {
+  if (!state || typeof state !== "object") return undefined;
+  return state.state?.auto_provision ?? state.auto_provision;
+}
+
 // The toggle's interaction state. `enabled` itself lives in the component
 // (seeded from the payload, updated on save); this machine owns everything
 // around it: the ON→OFF confirmation and the in-flight POST.

package/src/support/SupportTab.jsx

@@ -0,0 +1,198 @@
+// SupportTab — the shared in-app support request form.
+//
+// Renders a native Form mirroring the "Growth Ops Apps - Support Form" on the
+// website (First name*, Last name*, Email*, "What can we help you with
+// today?"*, optional screenshot) and POSTs it to the app's own support route
+// (common.support), which forwards it into the real form via the Forms API.
+// Name/email prefill from the signed-in HubSpot user and stay editable.
+//
+// Props:
+//   context     — the HubSpot extension context (user prefill, portal.id,
+//                 variables.BASE_URL).
+//   supportPath — the app's support route path, e.g.
+//                 "/v1/hubspot/app_pages/<app_key>/support" (base-hosted) or
+//                 "/api/v1/support" (self-hosted).
+//   appName     — display name, used in headings/success copy.
+//   supportUrl  — external support link shown as a fallback on error.
+import React, { useState } from "react";
+import {
+  Alert,
+  Button,
+  Divider,
+  Flex,
+  Form,
+  Heading,
+  Input,
+  Link,
+  Text,
+  TextArea,
+} from "@hubspot/ui-extensions";
+import { FileInput } from "@hubspot/ui-extensions/experimental";
+
+import { callAppApi } from "../sdk/app/base";
+import {
+  buildSupportBody,
+  readFileAsBase64,
+  unwrapFileEvent,
+  validateSupportFields,
+} from "./supportLogic";
+
+export function SupportTab({ context, supportPath, appName = "the app", supportUrl }) {
+  const [fields, setFields] = useState({
+    firstname: context.user?.firstName ?? "",
+    lastname: context.user?.lastName ?? "",
+    email: context.user?.email ?? "",
+    content: "",
+  });
+  const [file, setFile] = useState(null); // { name, contentBase64 }
+  const [submitting, setSubmitting] = useState(false);
+  const [submitted, setSubmitted] = useState(false);
+  const [error, setError] = useState(null);
+
+  const set = (key) => (value) =>
+    setFields((prev) => ({ ...prev, [key]: value }));
+
+  const handleFileChange = async (event) => {
+    const picked = unwrapFileEvent(event);
+    if (!picked) return;
+    try {
+      const contentBase64 = await readFileAsBase64(picked);
+      setFile({ name: picked.name, contentBase64 });
+    } catch {
+      setError("Couldn't read that file — try a different one.");
+    }
+  };
+
+  const handleSubmit = async () => {
+    const validationError = validateSupportFields(fields);
+    if (validationError) {
+      setError(validationError);
+      return;
+    }
+    setSubmitting(true);
+    setError(null);
+    try {
+      await callAppApi(
+        context,
+        `${supportPath}?portalId=${context.portal.id}`,
+        "POST",
+        buildSupportBody(fields, file)
+      );
+      setSubmitted(true);
+    } catch (err) {
+      setError(
+        err?.message ||
+          "Something went wrong sending your request. Please try again."
+      );
+    } finally {
+      setSubmitting(false);
+    }
+  };
+
+  if (submitted) {
+    return (
+      <Flex direction="column" gap="medium">
+        <Alert title="Request received" variant="success">
+          <Text>
+            Thanks — we've received your request and will be in touch soon
+            (typical response time is under 1–2 hours). You can reply to the
+            confirmation email with anything else.
+          </Text>
+        </Alert>
+        <Button
+          onClick={() => {
+            setSubmitted(false);
+            setFields((prev) => ({ ...prev, content: "" }));
+            setFile(null);
+          }}
+        >
+          Submit another request
+        </Button>
+      </Flex>
+    );
+  }
+
+  return (
+    <Flex direction="column" gap="medium">
+      <Flex direction="column" gap="small">
+        <Heading>Contact {appName} support</Heading>
+        <Text>
+          Send us a message and we'll get back to you. For urgent issues you
+          can also{" "}
+          {supportUrl ? (
+            <Link href={{ url: supportUrl, external: true }}>
+              use our contact page
+            </Link>
+          ) : (
+            "use our contact page"
+          )}
+          .
+        </Text>
+      </Flex>
+      <Divider />
+      {error && (
+        <Alert title="Couldn't send your request" variant="error">
+          <Text>{error}</Text>
+          {supportUrl ? (
+            <Text>
+              You can also reach us via{" "}
+              <Link href={{ url: supportUrl, external: true }}>
+                our contact page
+              </Link>
+              .
+            </Text>
+          ) : null}
+        </Alert>
+      )}
+      <Form onSubmit={handleSubmit}>
+        <Flex direction="column" gap="medium">
+          <Input
+            label="First name"
+            name="firstname"
+            required={true}
+            value={fields.firstname}
+            onChange={set("firstname")}
+          />
+          <Input
+            label="Last name"
+            name="lastname"
+            required={true}
+            value={fields.lastname}
+            onChange={set("lastname")}
+          />
+          <Input
+            label="Email"
+            name="email"
+            required={true}
+            value={fields.email}
+            onChange={set("email")}
+          />
+          <TextArea
+            label="What can we help you with today?"
+            name="content"
+            required={true}
+            value={fields.content}
+            onChange={set("content")}
+          />
+          <Flex direction="column" gap="extra-small">
+            <Text format={{ fontWeight: "bold" }}>Screenshot (optional)</Text>
+            <FileInput name="file" value={null} onChange={handleFileChange} />
+            {file && (
+              <Flex direction="row" gap="small" align="center">
+                <Text>Attached: {file.name}</Text>
+                <Button variant="secondary" size="xs" onClick={() => setFile(null)}>
+                  Remove
+                </Button>
+              </Flex>
+            )}
+          </Flex>
+          <Button variant="primary" type="submit" disabled={submitting}>
+            {submitting ? "Sending…" : "Send"}
+          </Button>
+        </Flex>
+      </Form>
+    </Flex>
+  );
+}
+
+export default SupportTab;

package/src/support/supportLogic.js

@@ -0,0 +1,50 @@
+// supportLogic — pure helpers for SupportTab, kept separate so the validation
+// and payload shaping are unit-testable without rendering (see
+// tests/supportTab.test.js).
+
+// Mirrors common.support's contract: contact fields + the ticket `content`,
+// optional file as base64 (hubspot.fetch carries JSON only, no multipart).
+export function validateSupportFields({ firstname, lastname, email, content }) {
+  if (!firstname?.trim()) return "First name is required.";
+  if (!lastname?.trim()) return "Last name is required.";
+  const e = email?.trim() ?? "";
+  if (!e || !e.includes("@") || e.startsWith("@") || e.endsWith("@")) {
+    return "A valid email is required.";
+  }
+  if (!content?.trim()) return "Tell us what we can help with.";
+  return null;
+}
+
+// Body for POST {supportPath}?portalId=N — plain object (callAppApi
+// serializes; NEVER pre-stringify for hubspot.fetch).
+export function buildSupportBody({ firstname, lastname, email, content }, file) {
+  const body = {
+    firstname: firstname.trim(),
+    lastname: lastname.trim(),
+    email: email.trim(),
+    content: content.trim(),
+  };
+  if (file) {
+    body.file = { filename: file.name, contentBase64: file.contentBase64 };
+  }
+  return body;
+}
+
+// FileInput (@hubspot/ui-extensions/experimental) has an ambiguous event
+// shape per HubSpot's own types (`any`) — defensively unwrap to a real File.
+// Same empirically-verified pattern as ATS AddCandidate's resume picker.
+export function unwrapFileEvent(event) {
+  const file = event?.target?.files?.[0] || event;
+  return file instanceof File ? file : null;
+}
+
+// FileReader → raw base64 (strips the "data:<mime>;base64," prefix).
+export function readFileAsBase64(file) {
+  return new Promise((resolve, reject) => {
+    const reader = new FileReader();
+    reader.onload = () => resolve(String(reader.result).split(",")[1] || "");
+    reader.onerror = () =>
+      reject(reader.error || new Error("Failed to read file"));
+    reader.readAsDataURL(file);
+  });
+}