@bash-app/bash-common 30.236.0 → 30.238.0

package/src/__tests__/statusEnums.test.ts

@@ -1,19 +1,31 @@
 /**
- * Pin the value sets of the three status enums introduced as part of the
+ * Pin the value sets of the status enums introduced as part of the
  * "stringly-typed status" cleanup. These enums are the contract between
- *   - api endpoints (uploadIdApi, serviceApi, adminDashboardSummaryApi)
- *   - bash-app UI components (IdRequirementGate, IdVerificationSection,
- *     CustomScopeRequestsAdminPage, ServicesRatesAndPricing)
+ *   - api endpoints (uploadIdApi, adminDashboardSummaryApi)
+ *   - bash-app UI components (IdRequirementGate, IdVerificationSection)
  *   - the database (Postgres ENUM columns)
  *
  * Adding/removing/renaming a member without intentionally updating the
  * migration + all callers should fail this test loudly.
+ *
+ * ServiceBookingOfferStatus and ServiceBookingOfferDirection are tested via
+ * the browser-safe mirrors exported from definitions.ts because Prisma's
+ * index-browser bundle omits them as runtime values (they crash on first
+ * property access in the browser otherwise).
  */
+import { GovIdRetentionPolicy, SchoolNameSource } from "@prisma/client";
+import {
+  ServiceBookingOfferDirection,
+  ServiceBookingOfferStatus,
+} from "../definitions.js";
 import {
-  CustomScopeStatus,
-  GovIdRetentionPolicy,
-  SchoolNameSource,
-} from "@prisma/client";
+  BashPointsPayoutSource,
+  CreditSourceType,
+  FBShortfallResolution,
+  PricingModel,
+  ServiceBookingSettlementBasis,
+  VolunteerCompensationType,
+} from "../mirroredPrismaEnums.js";
 
 describe("status enum value sets", () => {
   test("GovIdRetentionPolicy", () => {
@@ -28,9 +40,105 @@ describe("status enum value sets", () => {
     );
   });
 
-  test("CustomScopeStatus", () => {
-    expect(Object.values(CustomScopeStatus).sort()).toEqual(
-      ["Approved", "None", "Pending", "Rejected"].sort(),
+  test("ServiceBookingOfferStatus mirror values match schema", () => {
+    expect(Object.values(ServiceBookingOfferStatus).sort()).toEqual(
+      ["Accepted", "Countered", "Declined", "Expired", "Pending"].sort(),
+    );
+  });
+
+  test("ServiceBookingOfferDirection mirror values match schema", () => {
+    expect(Object.values(ServiceBookingOfferDirection).sort()).toEqual(
+      ["HostToProvider", "ProviderToHost"].sort(),
+    );
+  });
+
+  test("PricingModel mirror values match schema (Phase 1 adds PER_PAID_ATTENDEE + PER_BASHPOINTS_ATTENDEE)", () => {
+    expect(Object.values(PricingModel).sort()).toEqual(
+      [
+        "FLAT_FEE",
+        "PER_ATTENDEE",
+        "PER_PAID_ATTENDEE",
+        "PER_BASHPOINTS_ATTENDEE",
+        "HOURLY",
+        "PER_DAY",
+        "TIERED",
+        "CUSTOM",
+        "TICKET_REVENUE_PERCENTAGE",
+        "PRODUCT_SALES_PERCENTAGE",
+      ].sort(),
+    );
+  });
+
+  test("BashPointsPayoutSource mirror values match schema", () => {
+    expect(Object.values(BashPointsPayoutSource).sort()).toEqual(
+      ["BashBpPool", "HostWallet"].sort(),
+    );
+  });
+
+  test("ServiceBookingSettlementBasis mirror values match schema (Phase 2 adds FBMinimumShortfall + RevenueShare)", () => {
+    expect(Object.values(ServiceBookingSettlementBasis).sort()).toEqual(
+      [
+        "TicketRevenue",
+        "ProductSales",
+        "AttendeeCount",
+        "FBMinimumShortfall",
+        "RevenueShare",
+      ].sort(),
+    );
+  });
+
+  test("FBShortfallResolution mirror values match schema", () => {
+    expect(Object.values(FBShortfallResolution).sort()).toEqual(
+      ["ChargeDelta", "CreditFutureBooking", "Forgiven"].sort(),
+    );
+  });
+
+  test("VolunteerCompensationType mirror values match schema (narrower than PricingModel by design)", () => {
+    expect(Object.values(VolunteerCompensationType).sort()).toEqual(
+      [
+        "None",
+        "BashPointsStipend",
+        "PerksOnly",
+        "BashPointsAndPerks",
+      ].sort(),
+    );
+  });
+
+  test("CreditSourceType mirror values match schema (adds VenueLoyaltyRedemption for venue loyalty BP flow)", () => {
+    expect(Object.values(CreditSourceType).sort()).toEqual(
+      [
+        "MembershipReward",
+        "TicketPurchase",
+        "TicketSale",
+        "ServiceBooking",
+        "ReferralBonus",
+        "SignupBonus",
+        "AdminAdjustment",
+        "PromotionalBonus",
+        "PromoterCommission",
+        "GiftedPoints",
+        "AmbashadorAchievement",
+        "ScoutAchievement",
+        "InsiderAchievement",
+        "AgentAchievement",
+        "ReferralSignupBonus",
+        "FirstServiceProfile",
+        "FirstBashCreated",
+        "FirstTaskTaken",
+        "FirstTaskAssigned",
+        "FirstFavoriteBash",
+        "FirstShareBash",
+        "FirstInviteToBash",
+        "BirthdayReward",
+        "EventReferralReward",
+        "RsvpBonus",
+        "TicketCheckout",
+        "AttendanceBonus",
+        "PostBeforeEvent",
+        "PostAfterEvent",
+        "ReferralCodeUsed",
+        "VenueLoyaltyRedemption",
+      ].sort(),
     );
   });
 });

package/src/definitions.ts

@@ -5,7 +5,6 @@ import {
     BracketType,
     CompetitionType,
     Contact,
-    CustomScopeStatus,
     EntertainmentServiceType,
     GovIdRetentionPolicy,
     JudgingType,
@@ -17,9 +16,14 @@ import {
     Ticket,
     TicketTier,
     User,
-    YearsOfExperience,
 } from "@prisma/client";
-import type { BashEventDressTags, BashEventVibeTags } from "@prisma/client";
+import type {
+    BashEventDressTags,
+    BashEventVibeTags,
+    ServiceBookingOfferDirection as ServiceBookingOfferDirectionEnum,
+    ServiceBookingOfferStatus as ServiceBookingOfferStatusEnum,
+    YearsOfExperience as YearsOfExperienceEnum,
+} from "@prisma/client";
 import {
   CheckoutExt,
   PublicUser,
@@ -33,6 +37,37 @@ import { FrontendServiceGetPriceToBookResult } from "./utils/service/frontendSer
 import { ServiceSubscriptionTier } from "./utils/userSubscriptionUtils.js";
 import type { UtmFields } from "./utmAttribution.js";
 
+/**
+ * Prisma's `index-browser` bundle (used by Vite in bash-app) omits some enums as runtime
+ * values — importing them from `@prisma/client` yields `undefined` and crashes on first
+ * property access. These mirrors match the Prisma schema / full client enum strings.
+ */
+export const ServiceBookingOfferDirection = {
+    HostToProvider: "HostToProvider",
+    ProviderToHost: "ProviderToHost",
+} as const satisfies Record<
+    ServiceBookingOfferDirectionEnum,
+    ServiceBookingOfferDirectionEnum
+>;
+
+export const ServiceBookingOfferStatus = {
+    Pending: "Pending",
+    Accepted: "Accepted",
+    Declined: "Declined",
+    Countered: "Countered",
+    Expired: "Expired",
+} as const satisfies Record<ServiceBookingOfferStatusEnum, ServiceBookingOfferStatusEnum>;
+
+/** Mirrors Prisma YearsOfExperience — `@prisma/client` browser/Jest bundles may omit runtime enum keys. */
+export const YearsOfExperience = {
+    LessThanOneYear: "LessThanOneYear",
+    OneToThreeYears: "OneToThreeYears",
+    ThreeToFiveYears: "ThreeToFiveYears",
+    FivePlusYears: "FivePlusYears",
+} as const satisfies Record<YearsOfExperienceEnum, YearsOfExperienceEnum>;
+
+export type YearsOfExperience = YearsOfExperienceEnum;
+
 export const PASSWORD_MIN_LENGTH = 8 as const;
 export const PASSWORD_REQUIREMENTS_REGEX = new RegExp(
   String.raw`^(?=.*[a-z])(?=.*[A-Z])(?=.*\d)(?=.*[@$!%*?&^#])[A-Za-z\d@$!%*?&^#]{${PASSWORD_MIN_LENGTH},}$`
@@ -71,6 +106,18 @@ export const BASH_PASS_PRICE_ENV_KEYS: Record<BashPassTier, string> = {
   [BashPassTier.UNLIMITED]: "STRIPE_BASH_PASS_UNLIMITED_PRICE_ID",
 };
 
+/** Per-tier pricing info returned by GET /api/user/bash-pass/pricing. */
+export type BashPassTierPricing = {
+  /** Human-readable price string, e.g. "$9.99/mo". */
+  displayPrice: string;
+};
+
+/** Response shape for GET /api/user/bash-pass/pricing. */
+export type BashPassPricingResponse = {
+  /** Map of tier → pricing info. A tier is absent when its Stripe price is unconfigured. */
+  tiers: Partial<Record<BashPassTier, BashPassTierPricing>>;
+};
+
 // ─── Ticket.purchaseType values (string column; keep in sync with API writers) ───
 
 export const TICKET_PURCHASE_TYPE_USD = "USD" as const;
@@ -991,7 +1038,7 @@ export const DressTagsToString: { [key in BashEventDressTags]: string } = {
 //   [ServicesTags.AwardRecipient]: "Award recipient"
 // }
 
-export const YearsOfExperienceToString: { [key in YearsOfExperience]: string } =
+export const YearsOfExperienceToString: { [key in YearsOfExperienceEnum]: string } =
   {
     [YearsOfExperience.LessThanOneYear]: "Less than one year",
     [YearsOfExperience.OneToThreeYears]: "One to three years",
@@ -1004,14 +1051,12 @@ export {
     AgePolicy,
     BracketType,
     CompetitionType,
-    CustomScopeStatus,
     EntertainmentServiceType,
     GovIdRetentionPolicy,
     JudgingType,
     MusicGenreType,
     SchoolNameSource,
     ServiceTypes,
-    YearsOfExperience,
 };
 
 /**
@@ -1027,14 +1072,12 @@ export const GovIdRetentionPolicyLabel: Record<GovIdRetentionPolicy, string> = {
     [GovIdRetentionPolicy.Indefinite]: "Keep on file (indefinite)",
 };
 
-/**
- * Display labels for `Service.customScopeStatus` (admin dashboard, provider pricing UI).
- */
-export const CustomScopeStatusLabel: Record<CustomScopeStatus, string> = {
-    [CustomScopeStatus.None]: "None",
-    [CustomScopeStatus.Pending]: "Pending Review",
-    [CustomScopeStatus.Approved]: "Approved",
-    [CustomScopeStatus.Rejected]: "Rejected",
+export const ServiceBookingOfferStatusLabel: Record<ServiceBookingOfferStatusEnum, string> = {
+    [ServiceBookingOfferStatus.Pending]: "Pending",
+    [ServiceBookingOfferStatus.Accepted]: "Accepted",
+    [ServiceBookingOfferStatus.Declined]: "Declined",
+    [ServiceBookingOfferStatus.Countered]: "Countered",
+    [ServiceBookingOfferStatus.Expired]: "Expired",
 };
 
 /** Display label for an event's age policy (BashCard pill, filter UI, wizard). */

package/src/extendedSchemas.ts

@@ -365,6 +365,12 @@ export interface BashEventExt extends Omit<
   // Event page visual customisation (stored as scalar columns on BashEvent)
   backgroundImage: string | null;
   themeColor: string | null;
+  /**
+   * Computed at request time from the host Organization's nonprofit verification.
+   * Drives the buyer-facing fee breakdown ("Nonprofit — no Bash platform fee").
+   * Optional because not every endpoint that returns BashEventExt resolves the host org.
+   */
+  isVerifiedNonprofitHost?: boolean;
 }
 
 /**

package/src/index.ts

@@ -10,11 +10,12 @@ export * from "./membershipDefinitions.js";
 export * from "./onSaleCapabilityRecommendations.js";
 export * from "./aiApproval.js";
 export * from "./userReportTypes.js";
+export * from "./mirroredPrismaEnums.js";
 
 // Re-export ALL Prisma enums as values (usable as runtime constants, e.g. ServiceTypes.Entertainment)
-// Excludes enums already re-exported by definitions.ts and membershipDefinitions.ts:
-//   definitions.ts:      YearsOfExperience, EntertainmentServiceType, MusicGenreType, ServiceTypes,
-//                        CompetitionType, JudgingType, BracketType
+// Excludes enums already re-exported by definitions.ts, mirroredPrismaEnums.ts, and membershipDefinitions.ts:
+//   mirroredPrismaEnums.ts: ServiceCancellationPolicy
+//   definitions.ts:       YearsOfExperience, EntertainmentServiceType, MusicGenreType, ServiceTypes,
 //   membershipDefinitions.ts: MembershipTier, ReferralTier, CreditTransactionType
 export {
   $Enums,
@@ -63,7 +64,6 @@ export {
   ConnectionStatus,
   ConsentType,
   ConsultantFormat,
-  CreditSourceType,
   CreditTransactionStatus,
   CrewHandFormat,
   CustomSignageFormat,
@@ -137,7 +137,6 @@ export {
   ParkingManagementFormat,
   ParticipantStatus,
   PartyBusFormat,
-  PendingGiftStatus,
   PhotoBoothFormat,
   PhotographerFormat,
   PredictionSource,
@@ -171,7 +170,6 @@ export {
   ServiceBookingRateOption,
   ServiceBookingStatus,
   ServiceBookingType,
-  ServiceCancellationPolicy,
   ServiceCategoryRequestStatus,
   ServiceCondition,
   ServiceIncludeResponse,
@@ -192,6 +190,7 @@ export {
   StaffingSubType,
   StageTechFormat,
   StagingFormat,
+  StripeNonprofitPricingStatus,
   TableStylingFormat,
   TablesFormat,
   TaskStatus,
@@ -295,15 +294,26 @@ export type {
 export * from "./utils/displayDateUtils.js";
 export * from "./utils/discountEngine/bestPriceResolver.js";
 export * from "./utils/discountEngine/eligibilityValidator.js";
+export * from "./utils/nonprofitUtils.js";
 export * from "./utils/objUtils.js";
 export * from "./utils/paymentUtils.js";
 export * from "./utils/promoCodesUtils.js";
 export * from "./utils/qrCodeUtils.js";
 export * from "./utils/recurrenceUtils.js";
 export * from "./utils/service/attendeeOptionUtils.js";
+export * from "./utils/service/billingCapUtils.js";
+export * from "./utils/service/eventPromoterUtils.js";
 export * from "./utils/service/regexUtils.js";
+export * from "./utils/service/serviceBookingExposureUtils.js";
 export * from "./utils/service/serviceUtils.js";
+export * from "./utils/service/venueSettlementUtils.js";
+export * from "./utils/service/offerAllowListUtils.js";
+export * from "./utils/service/offerComparisonUtils.js";
+export * from "./utils/service/unifiedPricingResolver.js";
+export * from "./utils/service/volunteerCompensationUtils.js";
 export * from "./utils/service/cancellationPolicyRefundResolver.js";
+export * from "./utils/venueLoyalty/eligibilityUtils.js";
+export * from "./utils/venueLoyalty/redemptionCodeUtils.js";
 // Venue utils moved to paymentUtils.ts for better organization
 export * from "./utils/slugUtils.js";
 export * from "./utils/sortUtils.js";

package/src/mirroredPrismaEnums.ts

@@ -0,0 +1,181 @@
+import type {
+  BashPointsPayoutSource as BashPointsPayoutSourceEnum,
+  CreditSourceType as CreditSourceTypeEnum,
+  FBShortfallResolution as FBShortfallResolutionEnum,
+  PricingModel as PricingModelEnum,
+  ServiceBookingSettlementBasis as ServiceBookingSettlementBasisEnum,
+  ServiceBookingSettlementStatus as ServiceBookingSettlementStatusEnum,
+  ServiceCancellationPolicy as ServiceCancellationPolicyEnum,
+  VolunteerCompensationType as VolunteerCompensationTypeEnum,
+} from "@prisma/client";
+
+/**
+ * Mirrors Prisma `ServiceCancellationPolicy` — `@prisma/client` browser/Jest bundles may omit
+ * runtime enum objects (see `definitions.ts` comment on `index-browser`).
+ *
+ * Kept dependency-free besides Prisma types so modules like `serviceUtils.ts` can import it without
+ * loading `definitions.ts` (which participates in circular imports during index/init).
+ */
+export const ServiceCancellationPolicy = {
+  None: "None",
+  VeryFlexible: "VeryFlexible",
+  Flexible: "Flexible",
+  Standard90Day: "Standard90Day",
+  Standard30Day: "Standard30Day",
+  VendorFlexible: "VendorFlexible",
+  VendorStandard: "VendorStandard",
+  VendorStrict: "VendorStrict",
+  ExhibitorFlexible: "ExhibitorFlexible",
+  ExhibitorStandard: "ExhibitorStandard",
+  ExhibitorStrict: "ExhibitorStrict",
+  SponsorFlexible: "SponsorFlexible",
+  SponsorStandard: "SponsorStandard",
+  SponsorStrict: "SponsorStrict",
+} as const satisfies Record<
+  ServiceCancellationPolicyEnum,
+  ServiceCancellationPolicyEnum
+>;
+
+export type ServiceCancellationPolicy = ServiceCancellationPolicyEnum;
+
+/**
+ * Mirrors Prisma `ServiceBookingSettlementBasis`. Includes the new
+ * `AttendeeCount` basis used by Event Promoter bookings.
+ */
+export const ServiceBookingSettlementBasis = {
+  TicketRevenue: "TicketRevenue",
+  ProductSales: "ProductSales",
+  AttendeeCount: "AttendeeCount",
+  FBMinimumShortfall: "FBMinimumShortfall",
+  RevenueShare: "RevenueShare",
+} as const satisfies Record<
+  ServiceBookingSettlementBasisEnum,
+  ServiceBookingSettlementBasisEnum
+>;
+
+export type ServiceBookingSettlementBasis = ServiceBookingSettlementBasisEnum;
+
+/**
+ * Mirrors Prisma `FBShortfallResolution`. Describes how a venue F&B minimum
+ * shortfall was resolved at settlement — Phase 2 of the unified-pricing
+ * roadmap.
+ */
+export const FBShortfallResolution = {
+  ChargeDelta: "ChargeDelta",
+  CreditFutureBooking: "CreditFutureBooking",
+  Forgiven: "Forgiven",
+} as const satisfies Record<FBShortfallResolutionEnum, FBShortfallResolutionEnum>;
+
+export type FBShortfallResolution = FBShortfallResolutionEnum;
+
+/**
+ * Mirrors Prisma `ServiceBookingSettlementStatus`. Used to drive Stripe
+ * webhook handlers, dunning UI, dispute window, and retry logic on Event
+ * Promoter bookings.
+ */
+export const ServiceBookingSettlementStatus = {
+  Pending: "Pending",
+  Settled: "Settled",
+  SettlementPaymentFailed: "SettlementPaymentFailed",
+  SettlementHeld: "SettlementHeld",
+  SettlementDisputed: "SettlementDisputed",
+} as const satisfies Record<
+  ServiceBookingSettlementStatusEnum,
+  ServiceBookingSettlementStatusEnum
+>;
+
+export type ServiceBookingSettlementStatus = ServiceBookingSettlementStatusEnum;
+
+/**
+ * Mirrors Prisma `PricingModel`. Includes the Phase 1 additions
+ * `PER_PAID_ATTENDEE` and `PER_BASHPOINTS_ATTENDEE` introduced by the
+ * unified-pricing roadmap.
+ */
+export const PricingModel = {
+  FLAT_FEE: "FLAT_FEE",
+  PER_ATTENDEE: "PER_ATTENDEE",
+  PER_PAID_ATTENDEE: "PER_PAID_ATTENDEE",
+  PER_BASHPOINTS_ATTENDEE: "PER_BASHPOINTS_ATTENDEE",
+  HOURLY: "HOURLY",
+  PER_DAY: "PER_DAY",
+  TIERED: "TIERED",
+  CUSTOM: "CUSTOM",
+  TICKET_REVENUE_PERCENTAGE: "TICKET_REVENUE_PERCENTAGE",
+  PRODUCT_SALES_PERCENTAGE: "PRODUCT_SALES_PERCENTAGE",
+} as const satisfies Record<PricingModelEnum, PricingModelEnum>;
+
+export type PricingModel = PricingModelEnum;
+
+/**
+ * Mirrors Prisma `BashPointsPayoutSource`. Drives where the BashPoints for a
+ * PER_BASHPOINTS_ATTENDEE settlement are paid from — host wallet (default) or
+ * the per-bash BashPoints pool that ticket sales fund.
+ */
+export const BashPointsPayoutSource = {
+  HostWallet: "HostWallet",
+  BashBpPool: "BashBpPool",
+} as const satisfies Record<BashPointsPayoutSourceEnum, BashPointsPayoutSourceEnum>;
+
+export type BashPointsPayoutSource = BashPointsPayoutSourceEnum;
+
+/**
+ * Mirrors Prisma `VolunteerCompensationType`. Intentionally NARROWER than
+ * `PricingModel` because volunteers are not employees or contractors — see
+ * `bash-common/src/utils/service/volunteerCompensationUtils.ts` and the
+ * matching help-center page for the policy story.
+ */
+export const VolunteerCompensationType = {
+  None: "None",
+  BashPointsStipend: "BashPointsStipend",
+  PerksOnly: "PerksOnly",
+  BashPointsAndPerks: "BashPointsAndPerks",
+} as const satisfies Record<
+  VolunteerCompensationTypeEnum,
+  VolunteerCompensationTypeEnum
+>;
+
+export type VolunteerCompensationType = VolunteerCompensationTypeEnum;
+
+/**
+ * Mirrors Prisma `CreditSourceType`. Includes
+ * `VenueLoyaltyRedemption` introduced for the venue loyalty redemption
+ * BashPoints flow (claim escrow / decline + expire refund / redeem credit).
+ *
+ * Centralizing the mirror keeps the BashPoints ledger writers, the host
+ * earnings UI, and any analytics views aligned on a single source of truth.
+ */
+export const CreditSourceType = {
+  MembershipReward: "MembershipReward",
+  TicketPurchase: "TicketPurchase",
+  TicketSale: "TicketSale",
+  ServiceBooking: "ServiceBooking",
+  ReferralBonus: "ReferralBonus",
+  SignupBonus: "SignupBonus",
+  AdminAdjustment: "AdminAdjustment",
+  PromotionalBonus: "PromotionalBonus",
+  PromoterCommission: "PromoterCommission",
+  GiftedPoints: "GiftedPoints",
+  AmbashadorAchievement: "AmbashadorAchievement",
+  ScoutAchievement: "ScoutAchievement",
+  InsiderAchievement: "InsiderAchievement",
+  AgentAchievement: "AgentAchievement",
+  ReferralSignupBonus: "ReferralSignupBonus",
+  FirstServiceProfile: "FirstServiceProfile",
+  FirstBashCreated: "FirstBashCreated",
+  FirstTaskTaken: "FirstTaskTaken",
+  FirstTaskAssigned: "FirstTaskAssigned",
+  FirstFavoriteBash: "FirstFavoriteBash",
+  FirstShareBash: "FirstShareBash",
+  FirstInviteToBash: "FirstInviteToBash",
+  BirthdayReward: "BirthdayReward",
+  EventReferralReward: "EventReferralReward",
+  RsvpBonus: "RsvpBonus",
+  TicketCheckout: "TicketCheckout",
+  AttendanceBonus: "AttendanceBonus",
+  PostBeforeEvent: "PostBeforeEvent",
+  PostAfterEvent: "PostAfterEvent",
+  ReferralCodeUsed: "ReferralCodeUsed",
+  VenueLoyaltyRedemption: "VenueLoyaltyRedemption",
+} as const satisfies Record<CreditSourceTypeEnum, CreditSourceTypeEnum>;
+
+export type CreditSourceType = CreditSourceTypeEnum;

package/src/utils/__tests__/nonprofitUtils.test.ts

@@ -0,0 +1,117 @@
+import { describe, expect, test } from "@jest/globals";
+import {
+  isVerifiedNonprofitOrganization,
+  type NonprofitVerificationFields,
+} from "../nonprofitUtils.js";
+
+const fullyVerified: NonprofitVerificationFields = {
+  nonprofitCountry: "US",
+  nonprofitRegistrationNumber: "12-3456789",
+  nonprofitVerifiedAt: new Date("2025-01-15T00:00:00Z"),
+  stripeNonprofitPricingStatus: "NotApplied",
+};
+
+describe("isVerifiedNonprofitOrganization", () => {
+  test("null returns false", () => {
+    expect(isVerifiedNonprofitOrganization(null)).toBe(false);
+  });
+
+  test("undefined returns false", () => {
+    expect(isVerifiedNonprofitOrganization(undefined)).toBe(false);
+  });
+
+  test("missing nonprofitVerifiedAt returns false even with country + EIN", () => {
+    expect(
+      isVerifiedNonprofitOrganization({
+        ...fullyVerified,
+        nonprofitVerifiedAt: null,
+      })
+    ).toBe(false);
+  });
+
+  test("missing nonprofitRegistrationNumber returns false", () => {
+    expect(
+      isVerifiedNonprofitOrganization({
+        ...fullyVerified,
+        nonprofitRegistrationNumber: null,
+      })
+    ).toBe(false);
+  });
+
+  test("blank/whitespace nonprofitRegistrationNumber returns false", () => {
+    expect(
+      isVerifiedNonprofitOrganization({
+        ...fullyVerified,
+        nonprofitRegistrationNumber: "   ",
+      })
+    ).toBe(false);
+  });
+
+  test("missing nonprofitCountry returns false", () => {
+    expect(
+      isVerifiedNonprofitOrganization({
+        ...fullyVerified,
+        nonprofitCountry: null,
+      })
+    ).toBe(false);
+  });
+
+  test("blank/whitespace nonprofitCountry returns false", () => {
+    expect(
+      isVerifiedNonprofitOrganization({
+        ...fullyVerified,
+        nonprofitCountry: "   ",
+      })
+    ).toBe(false);
+  });
+
+  test("all required fields set returns true", () => {
+    expect(isVerifiedNonprofitOrganization(fullyVerified)).toBe(true);
+  });
+
+  test("non-US verified charity (e.g. UK) returns true", () => {
+    expect(
+      isVerifiedNonprofitOrganization({
+        ...fullyVerified,
+        nonprofitCountry: "GB",
+        nonprofitRegistrationNumber: "1234567",
+      })
+    ).toBe(true);
+  });
+
+  test("Stripe nonprofit-pricing status does NOT affect verification truthiness", () => {
+    const statuses: NonprofitVerificationFields["stripeNonprofitPricingStatus"][] = [
+      "NotApplied",
+      "Pending",
+      "Approved",
+      "Declined",
+    ];
+    for (const status of statuses) {
+      expect(
+        isVerifiedNonprofitOrganization({
+          ...fullyVerified,
+          stripeNonprofitPricingStatus: status,
+        })
+      ).toBe(true);
+    }
+  });
+
+  test("Declined Stripe status with no Bash verification stamp is still NOT verified", () => {
+    expect(
+      isVerifiedNonprofitOrganization({
+        ...fullyVerified,
+        nonprofitVerifiedAt: null,
+        stripeNonprofitPricingStatus: "Declined",
+      })
+    ).toBe(false);
+  });
+
+  test("future nonprofitVerifiedAt is NOT yet verified", () => {
+    expect(
+      isVerifiedNonprofitOrganization({
+        ...fullyVerified,
+        nonprofitVerifiedAt: new Date(Date.now() + 60_000),
+      })
+    ).toBe(false);
+  });
+});