[v5] feat(web): Add usage information for yearly subs

packages/db/prisma/migrations/20260509000000_add_license_table/migration.sql

@@ -16,6 +16,16 @@ CREATE TABLE "License" (
  "cancelAt" TIMESTAMP(3),
  "trialEnd" TIMESTAMP(3),
  "hasPaymentMethod" BOOLEAN,
+ "yearlyCommittedSeats" INTEGER,
+ "yearlyCurrentQuarterEndsAt" TIMESTAMP(3),
+ "yearlyCurrentQuarterNumber" INTEGER,
+ "yearlyCurrentQuarterStartedAt" TIMESTAMP(3),
+ "yearlyOverageSeats" INTEGER,
+ "yearlyBillableOverageSeats" INTEGER,
+ "yearlyPeakSeats" INTEGER,
+ "yearlyTermEndsAt" TIMESTAMP(3),
+ "yearlyTermStartedAt" TIMESTAMP(3),
+ "yearlyTotalQuartersInTerm" INTEGER,
  "lastSyncAt" TIMESTAMP(3),
  "lastSyncErrorCode" TEXT,
  "createdAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,

packages/db/prisma/schema.prisma

@@ -315,6 +315,20 @@ model License {
  cancelAt DateTime?
  trialEnd DateTime?
  hasPaymentMethod Boolean?
+
+ // Yearly-only fields, mirroring `yearlyTermStatus` on the lighthouse ping
+ // response. All null for monthly subs and for unactivated/canceled licenses.
+ yearlyTermStartedAt DateTime?
+ yearlyTermEndsAt DateTime?
+ yearlyTotalQuartersInTerm Int?
+ yearlyCurrentQuarterNumber Int?
+ yearlyCurrentQuarterStartedAt DateTime?
+ yearlyCurrentQuarterEndsAt DateTime?
+ yearlyCommittedSeats Int?
+ yearlyOverageSeats Int?
+ yearlyBillableOverageSeats Int?
+ yearlyPeakSeats Int?
+
  lastSyncAt DateTime?
  lastSyncErrorCode String?
  createdAt DateTime @default(now())

packages/web/src/app/(app)/components/banners/bannerResolver.test.ts

@@ -48,6 +48,16 @@ const makeLicense = (overrides: Partial<License> = {}): License => ({
  cancelAt: null,
  trialEnd: null,
  hasPaymentMethod: null,
+ yearlyTermStartedAt: null,
+ yearlyTermEndsAt: null,
+ yearlyTotalQuartersInTerm: null,
+ yearlyCurrentQuarterNumber: null,
+ yearlyCurrentQuarterStartedAt: null,
+ yearlyCurrentQuarterEndsAt: null,
+ yearlyCommittedSeats: null,
+ yearlyOverageSeats: null,
+ yearlyBillableOverageSeats: null,
+ yearlyPeakSeats: null,
  lastSyncAt: NOW,
  lastSyncErrorCode: null,
  createdAt: NOW,

packages/web/src/app/(app)/settings/license/onlineLicenseCard.tsx → packages/web/src/app/(app)/settings/license/onlineLicenseCard/onlineLicenseCard.tsx

@@ -11,6 +11,7 @@ import { cn, formatCurrency } from "@/lib/utils";
 import { LicenseInactiveBanner } from "./licenseInactiveBanner";
 import { PlanActionsMenu } from "./planActionsMenu";
 import { TrialMissingPaymentMethodBanner } from "./trialMissingPaymentMethodBanner";
+import { UpcomingYearlyRenewalBanner } from "./upcomingYearlyRenewalBanner";
 
 interface OnlineLicenseCardProps {
  license: License;
@@ -123,6 +124,18 @@ export function OnlineLicenseCard({ license }: OnlineLicenseCardProps) {
  {isLicenseActive && license.status === 'trialing' && license.hasPaymentMethod === false && (
  <TrialMissingPaymentMethodBanner />
  )}
+ {isLicenseActive
+ && license.interval === 'year'
+ && license.yearlyCurrentQuarterNumber !== null
+ && license.yearlyTotalQuartersInTerm !== null
+ && license.yearlyCurrentQuarterNumber === license.yearlyTotalQuartersInTerm
+ && license.nextRenewalAt !== null
+ && license.seats !== null && (
+ <UpcomingYearlyRenewalBanner
+ renewalAt={license.nextRenewalAt}
+ seats={license.seats}
+ />
+ )}
  </div>
  );
 }

packages/web/src/app/(app)/settings/license/onlineLicenseCard/upcomingYearlyRenewalBanner.tsx

@@ -0,0 +1,89 @@
+"use client";
+
+import { useCallback, useState } from "react";
+import { useRouter } from "next/navigation";
+import { Info } from "lucide-react";
+import { useToast } from "@/components/hooks/use-toast";
+import { createPortalSession } from "@/ee/features/lighthouse/actions";
+import { isServiceError } from "@/lib/utils";
+
+// @note take care to keep this in sync with
+// the value in constants.ts in lighthouse.
+const YEARLY_CANCELLATION_NOTICE_DAYS = 30;
+const DAY_MS = 24 * 60 * 60 * 1000;
+
+interface UpcomingRenewalBannerProps {
+ renewalAt: Date;
+ seats: number;
+}
+
+export function UpcomingYearlyRenewalBanner({ renewalAt, seats }: UpcomingRenewalBannerProps) {
+ const router = useRouter();
+ const { toast } = useToast();
+ const [isOpeningPortal, setIsOpeningPortal] = useState(false);
+ const [nowMs] = useState(() => Date.now());
+
+ const handleCancelClick = useCallback(() => {
+ setIsOpeningPortal(true);
+ createPortalSession().then((response) => {
+ if (isServiceError(response)) {
+ toast({
+ description: `Failed to open subscription portal: ${response.message}`,
+ variant: "destructive",
+ });
+ setIsOpeningPortal(false);
+ return;
+ }
+ router.push(response.url);
+ });
+ }, [router, toast]);
+
+ const daysUntilRenewal = (renewalAt.getTime() - nowMs) / DAY_MS;
+ const noticeDeadlineHasPassed = daysUntilRenewal < YEARLY_CANCELLATION_NOTICE_DAYS;
+ const noticeDeadline = new Date(renewalAt.getTime() - YEARLY_CANCELLATION_NOTICE_DAYS * DAY_MS);
+
+ return (
+ <div className="flex items-start gap-3 border-t bg-blue-500/10 px-4 py-2.5">
+ <Info className="h-4 w-4 mt-0.5 flex-shrink-0 text-blue-400" />
+ <div className="text-sm">
+ <p>
+ <span className="font-medium">
+ Auto-renewing on {formatDate(renewalAt)}
+ </span>{" "}
+ <span className="text-muted-foreground">
+ with {seats} {seats === 1 ? 'seat' : 'seats'}.
+ </span>
+ </p>
+ {!noticeDeadlineHasPassed && (
+ <p className="text-muted-foreground mt-1">
+ You have until {formatDate(noticeDeadline)} to{" "}
+ <button
+ type="button"
+ onClick={handleCancelClick}
+ disabled={isOpeningPortal}
+ className="text-link hover:underline disabled:opacity-50"
+ >
+ cancel
+ </button>{" "}
+ your subscription or{" "}
+ <a
+ href="mailto:ar@sourcebot.dev"
+ className="text-link hover:underline"
+ >
+ request
+ </a>{" "}
+ a different seat count for renewal.
+ </p>
+ )}
+ </div>
+ </div>
+ );
+}
+
+function formatDate(date: Date): string {
+ return new Date(date).toLocaleDateString('en-US', {
+ month: 'short',
+ day: 'numeric',
+ year: 'numeric',
+ });
+}

packages/web/src/app/(app)/settings/license/page.tsx

@@ -5,14 +5,16 @@ import { Button } from "@/components/ui/button";
 import { ExternalLink } from "lucide-react";
 import { redirect } from "next/navigation";
 import { ActivationCodeCard } from "./activationCodeCard";
-import { OnlineLicenseCard } from "./onlineLicenseCard";
+import { OnlineLicenseCard } from "./onlineLicenseCard/onlineLicenseCard";
 import { OfflineLicenseCard } from "./offlineLicenseCard";
 import { RecentInvoicesCard } from "./recentInvoicesCard";
+import { YearlyTermSeatsUsageCard } from "./yearlyTermSeatsUsageCard";
 import { SettingsCard } from "../components/settingsCard";
 import { UpsellPanel } from "@/ee/features/lighthouse/upsellDialog";
 import { getAllInvoices } from "@/ee/features/lighthouse/actions";
 import { syncWithLighthouse } from "@/ee/features/lighthouse/servicePing";
 import { isServiceError } from "@/lib/utils";
+import { getYearlyTermStatus } from "./types";
 
 type LicensePageProps = {
  searchParams?: Promise<Record<string, string | string[] | undefined>>;
@@ -36,6 +38,7 @@ export default authenticatedPage<LicensePageProps>(async ({ prisma, org }, props
  redirect(suffix ? `/settings/license?${suffix}` : '/settings/license');
  }
 
+
  const offlineLicense = getOfflineLicenseMetadata();
  const isOfflineLicenseExpired = offlineLicense
  ? new Date(offlineLicense.expiryDate).getTime() < Date.now()
@@ -45,6 +48,9 @@ export default authenticatedPage<LicensePageProps>(async ({ prisma, org }, props
  ? null
  : await prisma.license.findUnique({ where: { orgId: org.id } });
 
+ const yearlyTermStatus = getYearlyTermStatus(license);
+ const currentUserCount = await prisma.userToOrg.count({ where: { orgId: org.id } });
+
  const invoicesResult = license ? await getAllInvoices() : null;
  const invoices = invoicesResult && !isServiceError(invoicesResult) ? invoicesResult : [];
 
@@ -87,6 +93,13 @@ export default authenticatedPage<LicensePageProps>(async ({ prisma, org }, props
  <OfflineLicenseCard license={offlineLicense} isExpired={isOfflineLicenseExpired} />
  )}
  {license && <OnlineLicenseCard license={license} />}
+ {license
+ && yearlyTermStatus && (
+ <YearlyTermSeatsUsageCard
+ currentUsers={currentUserCount}
+ status={yearlyTermStatus}
+ />
+ )}
  {!offlineLicense && !license && <ActivationCodeCard />}
  {license && <RecentInvoicesCard invoices={invoices} />}
  </div>

packages/web/src/app/(app)/settings/license/types.ts

@@ -0,0 +1,41 @@
+import { YearlyTermStatus as RawYearlyTermStatus } from "@/ee/features/lighthouse/types";
+import { License } from "@sourcebot/db";
+
+export type YearlyTermStatus = Omit<RawYearlyTermStatus, 'currentQuarterStartedAt' | 'currentQuarterEndsAt' | 'termStartedAt' | 'termEndsAt'> & {
+ currentQuarterStartedAt: Date,
+ currentQuarterEndsAt: Date,
+ termStartedAt: Date,
+ termEndsAt: Date,
+}
+
+export function getYearlyTermStatus(
+ license: License | null,
+): YearlyTermStatus | undefined {
+ if (
+ license === null
+ || license.yearlyCommittedSeats === null
+ || license.yearlyPeakSeats === null
+ || license.yearlyOverageSeats === null
+ || license.yearlyBillableOverageSeats === null
+ || license.yearlyCurrentQuarterNumber === null
+ || license.yearlyTotalQuartersInTerm === null
+ || license.yearlyCurrentQuarterStartedAt === null
+ || license.yearlyCurrentQuarterEndsAt === null
+ || license.yearlyTermStartedAt === null
+ || license.yearlyTermEndsAt === null
+ ) {
+ return undefined;
+ }
+ return {
+ committedSeats: license.yearlyCommittedSeats,
+ peakSeats: license.yearlyPeakSeats,
+ overageSeats: license.yearlyOverageSeats,
+ billableOverageSeats: license.yearlyBillableOverageSeats,
+ currentQuarterNumber: license.yearlyCurrentQuarterNumber,
+ totalQuartersInTerm: license.yearlyTotalQuartersInTerm,
+ currentQuarterStartedAt: license.yearlyCurrentQuarterStartedAt,
+ currentQuarterEndsAt: license.yearlyCurrentQuarterEndsAt,
+ termStartedAt: license.yearlyTermStartedAt,
+ termEndsAt: license.yearlyTermEndsAt,
+ };
+}

packages/db/prisma/migrations/20260509000000_add_license_table/migration.sql

@@ -16,6 +16,16 @@ CREATE TABLE "License" (
  "cancelAt" TIMESTAMP(3),
  "trialEnd" TIMESTAMP(3),
  "hasPaymentMethod" BOOLEAN,
+ "yearlyCommittedSeats" INTEGER,
+ "yearlyCurrentQuarterEndsAt" TIMESTAMP(3),
+ "yearlyCurrentQuarterNumber" INTEGER,
+ "yearlyCurrentQuarterStartedAt" TIMESTAMP(3),
+ "yearlyOverageSeats" INTEGER,
+ "yearlyBillableOverageSeats" INTEGER,
+ "yearlyPeakSeats" INTEGER,
+ "yearlyTermEndsAt" TIMESTAMP(3),
+ "yearlyTermStartedAt" TIMESTAMP(3),
+ "yearlyTotalQuartersInTerm" INTEGER,
  "lastSyncAt" TIMESTAMP(3),
  "lastSyncErrorCode" TEXT,
  "createdAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,

packages/db/prisma/schema.prisma

@@ -315,6 +315,20 @@ model License {
  cancelAt DateTime?
  trialEnd DateTime?
  hasPaymentMethod Boolean?
+
+ // Yearly-only fields, mirroring `yearlyTermStatus` on the lighthouse ping
+ // response. All null for monthly subs and for unactivated/canceled licenses.
+ yearlyTermStartedAt DateTime?
+ yearlyTermEndsAt DateTime?
+ yearlyTotalQuartersInTerm Int?
+ yearlyCurrentQuarterNumber Int?
+ yearlyCurrentQuarterStartedAt DateTime?
+ yearlyCurrentQuarterEndsAt DateTime?
+ yearlyCommittedSeats Int?
+ yearlyOverageSeats Int?
+ yearlyBillableOverageSeats Int?
+ yearlyPeakSeats Int?
+
  lastSyncAt DateTime?
  lastSyncErrorCode String?
  createdAt DateTime @default(now())

packages/web/src/app/(app)/components/banners/bannerResolver.test.ts

@@ -48,6 +48,16 @@ const makeLicense = (overrides: Partial<License> = {}): License => ({
  cancelAt: null,
  trialEnd: null,
  hasPaymentMethod: null,
+ yearlyTermStartedAt: null,
+ yearlyTermEndsAt: null,
+ yearlyTotalQuartersInTerm: null,
+ yearlyCurrentQuarterNumber: null,
+ yearlyCurrentQuarterStartedAt: null,
+ yearlyCurrentQuarterEndsAt: null,
+ yearlyCommittedSeats: null,
+ yearlyOverageSeats: null,
+ yearlyBillableOverageSeats: null,
+ yearlyPeakSeats: null,
  lastSyncAt: NOW,
  lastSyncErrorCode: null,
  createdAt: NOW,

packages/web/src/app/(app)/settings/license/onlineLicenseCard.tsx → packages/web/src/app/(app)/settings/license/onlineLicenseCard/onlineLicenseCard.tsx

@@ -11,6 +11,7 @@ import { cn, formatCurrency } from "@/lib/utils";
 import { LicenseInactiveBanner } from "./licenseInactiveBanner";
 import { PlanActionsMenu } from "./planActionsMenu";
 import { TrialMissingPaymentMethodBanner } from "./trialMissingPaymentMethodBanner";
+import { UpcomingYearlyRenewalBanner } from "./upcomingYearlyRenewalBanner";
 
 interface OnlineLicenseCardProps {
  license: License;
@@ -123,6 +124,18 @@ export function OnlineLicenseCard({ license }: OnlineLicenseCardProps) {
  {isLicenseActive && license.status === 'trialing' && license.hasPaymentMethod === false && (
  <TrialMissingPaymentMethodBanner />
  )}
+ {isLicenseActive
+ && license.interval === 'year'
+ && license.yearlyCurrentQuarterNumber !== null
+ && license.yearlyTotalQuartersInTerm !== null
+ && license.yearlyCurrentQuarterNumber === license.yearlyTotalQuartersInTerm
+ && license.nextRenewalAt !== null
+ && license.seats !== null && (
+ <UpcomingYearlyRenewalBanner
+ renewalAt={license.nextRenewalAt}
+ seats={license.seats}
+ />
+ )}
  </div>
  );
 }

packages/web/src/app/(app)/settings/license/onlineLicenseCard/upcomingYearlyRenewalBanner.tsx

@@ -0,0 +1,89 @@
+"use client";
+
+import { useCallback, useState } from "react";
+import { useRouter } from "next/navigation";
+import { Info } from "lucide-react";
+import { useToast } from "@/components/hooks/use-toast";
+import { createPortalSession } from "@/ee/features/lighthouse/actions";
+import { isServiceError } from "@/lib/utils";
+
+// @note take care to keep this in sync with
+// the value in constants.ts in lighthouse.
+const YEARLY_CANCELLATION_NOTICE_DAYS = 30;
+const DAY_MS = 24 * 60 * 60 * 1000;
+
+interface UpcomingRenewalBannerProps {
+ renewalAt: Date;
+ seats: number;
+}
+
+export function UpcomingYearlyRenewalBanner({ renewalAt, seats }: UpcomingRenewalBannerProps) {
+ const router = useRouter();
+ const { toast } = useToast();
+ const [isOpeningPortal, setIsOpeningPortal] = useState(false);
+ const [nowMs] = useState(() => Date.now());
+
+ const handleCancelClick = useCallback(() => {
+ setIsOpeningPortal(true);
+ createPortalSession().then((response) => {
+ if (isServiceError(response)) {
+ toast({
+ description: `Failed to open subscription portal: ${response.message}`,
+ variant: "destructive",
+ });
+ setIsOpeningPortal(false);
+ return;
+ }
+ router.push(response.url);
+ });
+ }, [router, toast]);
+
+ const daysUntilRenewal = (renewalAt.getTime() - nowMs) / DAY_MS;
+ const noticeDeadlineHasPassed = daysUntilRenewal < YEARLY_CANCELLATION_NOTICE_DAYS;
+ const noticeDeadline = new Date(renewalAt.getTime() - YEARLY_CANCELLATION_NOTICE_DAYS * DAY_MS);
+
+ return (
+ <div className="flex items-start gap-3 border-t bg-blue-500/10 px-4 py-2.5">
+ <Info className="h-4 w-4 mt-0.5 flex-shrink-0 text-blue-400" />
+ <div className="text-sm">
+ <p>
+ <span className="font-medium">
+ Auto-renewing on {formatDate(renewalAt)}
+ </span>{" "}
+ <span className="text-muted-foreground">
+ with {seats} {seats === 1 ? 'seat' : 'seats'}.
+ </span>
+ </p>
+ {!noticeDeadlineHasPassed && (
+ <p className="text-muted-foreground mt-1">
+ You have until {formatDate(noticeDeadline)} to{" "}
+ <button
+ type="button"
+ onClick={handleCancelClick}
+ disabled={isOpeningPortal}
+ className="text-link hover:underline disabled:opacity-50"
+ >
+ cancel
+ </button>{" "}
+ your subscription or{" "}
+ <a
+ href="mailto:ar@sourcebot.dev"
+ className="text-link hover:underline"
+ >
+ request
+ </a>{" "}
+ a different seat count for renewal.
+ </p>
+ )}
+ </div>
+ </div>
+ );
+}
+
+function formatDate(date: Date): string {
+ return new Date(date).toLocaleDateString('en-US', {
+ month: 'short',
+ day: 'numeric',
+ year: 'numeric',
+ });
+}

packages/web/src/app/(app)/settings/license/page.tsx

@@ -5,14 +5,16 @@ import { Button } from "@/components/ui/button";
 import { ExternalLink } from "lucide-react";
 import { redirect } from "next/navigation";
 import { ActivationCodeCard } from "./activationCodeCard";
-import { OnlineLicenseCard } from "./onlineLicenseCard";
+import { OnlineLicenseCard } from "./onlineLicenseCard/onlineLicenseCard";
 import { OfflineLicenseCard } from "./offlineLicenseCard";
 import { RecentInvoicesCard } from "./recentInvoicesCard";
+import { YearlyTermSeatsUsageCard } from "./yearlyTermSeatsUsageCard";
 import { SettingsCard } from "../components/settingsCard";
 import { UpsellPanel } from "@/ee/features/lighthouse/upsellDialog";
 import { getAllInvoices } from "@/ee/features/lighthouse/actions";
 import { syncWithLighthouse } from "@/ee/features/lighthouse/servicePing";
 import { isServiceError } from "@/lib/utils";
+import { getYearlyTermStatus } from "./types";
 
 type LicensePageProps = {
  searchParams?: Promise<Record<string, string | string[] | undefined>>;
@@ -36,6 +38,7 @@ export default authenticatedPage<LicensePageProps>(async ({ prisma, org }, props
  redirect(suffix ? `/settings/license?${suffix}` : '/settings/license');
  }
 
+
  const offlineLicense = getOfflineLicenseMetadata();
  const isOfflineLicenseExpired = offlineLicense
  ? new Date(offlineLicense.expiryDate).getTime() < Date.now()
@@ -45,6 +48,9 @@ export default authenticatedPage<LicensePageProps>(async ({ prisma, org }, props
  ? null
  : await prisma.license.findUnique({ where: { orgId: org.id } });
 
+ const yearlyTermStatus = getYearlyTermStatus(license);
+ const currentUserCount = await prisma.userToOrg.count({ where: { orgId: org.id } });
+
  const invoicesResult = license ? await getAllInvoices() : null;
  const invoices = invoicesResult && !isServiceError(invoicesResult) ? invoicesResult : [];
 
@@ -87,6 +93,13 @@ export default authenticatedPage<LicensePageProps>(async ({ prisma, org }, props
  <OfflineLicenseCard license={offlineLicense} isExpired={isOfflineLicenseExpired} />
  )}
  {license && <OnlineLicenseCard license={license} />}
+ {license
+ && yearlyTermStatus && (
+ <YearlyTermSeatsUsageCard
+ currentUsers={currentUserCount}
+ status={yearlyTermStatus}
+ />
+ )}
  {!offlineLicense && !license && <ActivationCodeCard />}
  {license && <RecentInvoicesCard invoices={invoices} />}
  </div>

packages/web/src/app/(app)/settings/license/types.ts

@@ -0,0 +1,41 @@
+import { YearlyTermStatus as RawYearlyTermStatus } from "@/ee/features/lighthouse/types";
+import { License } from "@sourcebot/db";
+
+export type YearlyTermStatus = Omit<RawYearlyTermStatus, 'currentQuarterStartedAt' | 'currentQuarterEndsAt' | 'termStartedAt' | 'termEndsAt'> & {
+ currentQuarterStartedAt: Date,
+ currentQuarterEndsAt: Date,
+ termStartedAt: Date,
+ termEndsAt: Date,
+}
+
+export function getYearlyTermStatus(
+ license: License | null,
+): YearlyTermStatus | undefined {
+ if (
+ license === null
+ || license.yearlyCommittedSeats === null
+ || license.yearlyPeakSeats === null
+ || license.yearlyOverageSeats === null
+ || license.yearlyBillableOverageSeats === null
+ || license.yearlyCurrentQuarterNumber === null
+ || license.yearlyTotalQuartersInTerm === null
+ || license.yearlyCurrentQuarterStartedAt === null
+ || license.yearlyCurrentQuarterEndsAt === null
+ || license.yearlyTermStartedAt === null
+ || license.yearlyTermEndsAt === null
+ ) {
+ return undefined;
+ }
+ return {
+ committedSeats: license.yearlyCommittedSeats,
+ peakSeats: license.yearlyPeakSeats,
+ overageSeats: license.yearlyOverageSeats,
+ billableOverageSeats: license.yearlyBillableOverageSeats,
+ currentQuarterNumber: license.yearlyCurrentQuarterNumber,
+ totalQuartersInTerm: license.yearlyTotalQuartersInTerm,
+ currentQuarterStartedAt: license.yearlyCurrentQuarterStartedAt,
+ currentQuarterEndsAt: license.yearlyCurrentQuarterEndsAt,
+ termStartedAt: license.yearlyTermStartedAt,
+ termEndsAt: license.yearlyTermEndsAt,
+ };
+}

packages/db/prisma/migrations/20260509000000_add_license_table/migration.sql

@@ -16,6 +16,16 @@ CREATE TABLE "License" (
  "cancelAt" TIMESTAMP(3),
  "trialEnd" TIMESTAMP(3),
  "hasPaymentMethod" BOOLEAN,
+ "yearlyCommittedSeats" INTEGER,
+ "yearlyCurrentQuarterEndsAt" TIMESTAMP(3),
+ "yearlyCurrentQuarterNumber" INTEGER,
+ "yearlyCurrentQuarterStartedAt" TIMESTAMP(3),
+ "yearlyOverageSeats" INTEGER,
+ "yearlyBillableOverageSeats" INTEGER,
+ "yearlyPeakSeats" INTEGER,
+ "yearlyTermEndsAt" TIMESTAMP(3),
+ "yearlyTermStartedAt" TIMESTAMP(3),
+ "yearlyTotalQuartersInTerm" INTEGER,
  "lastSyncAt" TIMESTAMP(3),
  "lastSyncErrorCode" TEXT,
  "createdAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,

packages/db/prisma/schema.prisma

@@ -315,6 +315,20 @@ model License {
  cancelAt DateTime?
  trialEnd DateTime?
  hasPaymentMethod Boolean?
+
+ // Yearly-only fields, mirroring `yearlyTermStatus` on the lighthouse ping
+ // response. All null for monthly subs and for unactivated/canceled licenses.
+ yearlyTermStartedAt DateTime?
+ yearlyTermEndsAt DateTime?
+ yearlyTotalQuartersInTerm Int?
+ yearlyCurrentQuarterNumber Int?
+ yearlyCurrentQuarterStartedAt DateTime?
+ yearlyCurrentQuarterEndsAt DateTime?
+ yearlyCommittedSeats Int?
+ yearlyOverageSeats Int?
+ yearlyBillableOverageSeats Int?
+ yearlyPeakSeats Int?
+
  lastSyncAt DateTime?
  lastSyncErrorCode String?
  createdAt DateTime @default(now())

packages/web/src/app/(app)/components/banners/bannerResolver.test.ts

@@ -48,6 +48,16 @@ const makeLicense = (overrides: Partial<License> = {}): License => ({
  cancelAt: null,
  trialEnd: null,
  hasPaymentMethod: null,
+ yearlyTermStartedAt: null,
+ yearlyTermEndsAt: null,
+ yearlyTotalQuartersInTerm: null,
+ yearlyCurrentQuarterNumber: null,
+ yearlyCurrentQuarterStartedAt: null,
+ yearlyCurrentQuarterEndsAt: null,
+ yearlyCommittedSeats: null,
+ yearlyOverageSeats: null,
+ yearlyBillableOverageSeats: null,
+ yearlyPeakSeats: null,
  lastSyncAt: NOW,
  lastSyncErrorCode: null,
  createdAt: NOW,

packages/web/src/app/(app)/settings/license/onlineLicenseCard.tsx → packages/web/src/app/(app)/settings/license/onlineLicenseCard/onlineLicenseCard.tsx

@@ -11,6 +11,7 @@ import { cn, formatCurrency } from "@/lib/utils";
 import { LicenseInactiveBanner } from "./licenseInactiveBanner";
 import { PlanActionsMenu } from "./planActionsMenu";
 import { TrialMissingPaymentMethodBanner } from "./trialMissingPaymentMethodBanner";
+import { UpcomingYearlyRenewalBanner } from "./upcomingYearlyRenewalBanner";
 
 interface OnlineLicenseCardProps {
  license: License;
@@ -123,6 +124,18 @@ export function OnlineLicenseCard({ license }: OnlineLicenseCardProps) {
  {isLicenseActive && license.status === 'trialing' && license.hasPaymentMethod === false && (
  <TrialMissingPaymentMethodBanner />
  )}
+ {isLicenseActive
+ && license.interval === 'year'
+ && license.yearlyCurrentQuarterNumber !== null
+ && license.yearlyTotalQuartersInTerm !== null
+ && license.yearlyCurrentQuarterNumber === license.yearlyTotalQuartersInTerm
+ && license.nextRenewalAt !== null
+ && license.seats !== null && (
+ <UpcomingYearlyRenewalBanner
+ renewalAt={license.nextRenewalAt}
+ seats={license.seats}
+ />
+ )}
  </div>
  );
 }

packages/web/src/app/(app)/settings/license/onlineLicenseCard/upcomingYearlyRenewalBanner.tsx

@@ -0,0 +1,89 @@
+"use client";
+
+import { useCallback, useState } from "react";
+import { useRouter } from "next/navigation";
+import { Info } from "lucide-react";
+import { useToast } from "@/components/hooks/use-toast";
+import { createPortalSession } from "@/ee/features/lighthouse/actions";
+import { isServiceError } from "@/lib/utils";
+
+// @note take care to keep this in sync with
+// the value in constants.ts in lighthouse.
+const YEARLY_CANCELLATION_NOTICE_DAYS = 30;
+const DAY_MS = 24 * 60 * 60 * 1000;
+
+interface UpcomingRenewalBannerProps {
+ renewalAt: Date;
+ seats: number;
+}
+
+export function UpcomingYearlyRenewalBanner({ renewalAt, seats }: UpcomingRenewalBannerProps) {
+ const router = useRouter();
+ const { toast } = useToast();
+ const [isOpeningPortal, setIsOpeningPortal] = useState(false);
+ const [nowMs] = useState(() => Date.now());
+
+ const handleCancelClick = useCallback(() => {
+ setIsOpeningPortal(true);
+ createPortalSession().then((response) => {
+ if (isServiceError(response)) {
+ toast({
+ description: `Failed to open subscription portal: ${response.message}`,
+ variant: "destructive",
+ });
+ setIsOpeningPortal(false);
+ return;
+ }
+ router.push(response.url);
+ });
+ }, [router, toast]);
+
+ const daysUntilRenewal = (renewalAt.getTime() - nowMs) / DAY_MS;
+ const noticeDeadlineHasPassed = daysUntilRenewal < YEARLY_CANCELLATION_NOTICE_DAYS;
+ const noticeDeadline = new Date(renewalAt.getTime() - YEARLY_CANCELLATION_NOTICE_DAYS * DAY_MS);
+
+ return (
+ <div className="flex items-start gap-3 border-t bg-blue-500/10 px-4 py-2.5">
+ <Info className="h-4 w-4 mt-0.5 flex-shrink-0 text-blue-400" />
+ <div className="text-sm">
+ <p>
+ <span className="font-medium">
+ Auto-renewing on {formatDate(renewalAt)}
+ </span>{" "}
+ <span className="text-muted-foreground">
+ with {seats} {seats === 1 ? 'seat' : 'seats'}.
+ </span>
+ </p>
+ {!noticeDeadlineHasPassed && (
+ <p className="text-muted-foreground mt-1">
+ You have until {formatDate(noticeDeadline)} to{" "}
+ <button
+ type="button"
+ onClick={handleCancelClick}
+ disabled={isOpeningPortal}
+ className="text-link hover:underline disabled:opacity-50"
+ >
+ cancel
+ </button>{" "}
+ your subscription or{" "}
+ <a
+ href="mailto:ar@sourcebot.dev"
+ className="text-link hover:underline"
+ >
+ request
+ </a>{" "}
+ a different seat count for renewal.
+ </p>
+ )}
+ </div>
+ </div>
+ );
+}
+
+function formatDate(date: Date): string {
+ return new Date(date).toLocaleDateString('en-US', {
+ month: 'short',
+ day: 'numeric',
+ year: 'numeric',
+ });
+}

packages/web/src/app/(app)/settings/license/page.tsx

@@ -5,14 +5,16 @@ import { Button } from "@/components/ui/button";
 import { ExternalLink } from "lucide-react";
 import { redirect } from "next/navigation";
 import { ActivationCodeCard } from "./activationCodeCard";
-import { OnlineLicenseCard } from "./onlineLicenseCard";
+import { OnlineLicenseCard } from "./onlineLicenseCard/onlineLicenseCard";
 import { OfflineLicenseCard } from "./offlineLicenseCard";
 import { RecentInvoicesCard } from "./recentInvoicesCard";
+import { YearlyTermSeatsUsageCard } from "./yearlyTermSeatsUsageCard";
 import { SettingsCard } from "../components/settingsCard";
 import { UpsellPanel } from "@/ee/features/lighthouse/upsellDialog";
 import { getAllInvoices } from "@/ee/features/lighthouse/actions";
 import { syncWithLighthouse } from "@/ee/features/lighthouse/servicePing";
 import { isServiceError } from "@/lib/utils";
+import { getYearlyTermStatus } from "./types";
 
 type LicensePageProps = {
  searchParams?: Promise<Record<string, string | string[] | undefined>>;
@@ -36,6 +38,7 @@ export default authenticatedPage<LicensePageProps>(async ({ prisma, org }, props
  redirect(suffix ? `/settings/license?${suffix}` : '/settings/license');
  }
 
+
  const offlineLicense = getOfflineLicenseMetadata();
  const isOfflineLicenseExpired = offlineLicense
  ? new Date(offlineLicense.expiryDate).getTime() < Date.now()
@@ -45,6 +48,9 @@ export default authenticatedPage<LicensePageProps>(async ({ prisma, org }, props
  ? null
  : await prisma.license.findUnique({ where: { orgId: org.id } });
 
+ const yearlyTermStatus = getYearlyTermStatus(license);
+ const currentUserCount = await prisma.userToOrg.count({ where: { orgId: org.id } });
+
  const invoicesResult = license ? await getAllInvoices() : null;
  const invoices = invoicesResult && !isServiceError(invoicesResult) ? invoicesResult : [];
 
@@ -87,6 +93,13 @@ export default authenticatedPage<LicensePageProps>(async ({ prisma, org }, props
  <OfflineLicenseCard license={offlineLicense} isExpired={isOfflineLicenseExpired} />
  )}
  {license && <OnlineLicenseCard license={license} />}
+ {license
+ && yearlyTermStatus && (
+ <YearlyTermSeatsUsageCard
+ currentUsers={currentUserCount}
+ status={yearlyTermStatus}
+ />
+ )}
  {!offlineLicense && !license && <ActivationCodeCard />}
  {license && <RecentInvoicesCard invoices={invoices} />}
  </div>

packages/web/src/app/(app)/settings/license/types.ts

@@ -0,0 +1,41 @@
+import { YearlyTermStatus as RawYearlyTermStatus } from "@/ee/features/lighthouse/types";
+import { License } from "@sourcebot/db";
+
+export type YearlyTermStatus = Omit<RawYearlyTermStatus, 'currentQuarterStartedAt' | 'currentQuarterEndsAt' | 'termStartedAt' | 'termEndsAt'> & {
+ currentQuarterStartedAt: Date,
+ currentQuarterEndsAt: Date,
+ termStartedAt: Date,
+ termEndsAt: Date,
+}
+
+export function getYearlyTermStatus(
+ license: License | null,
+): YearlyTermStatus | undefined {
+ if (
+ license === null
+ || license.yearlyCommittedSeats === null
+ || license.yearlyPeakSeats === null
+ || license.yearlyOverageSeats === null
+ || license.yearlyBillableOverageSeats === null
+ || license.yearlyCurrentQuarterNumber === null
+ || license.yearlyTotalQuartersInTerm === null
+ || license.yearlyCurrentQuarterStartedAt === null
+ || license.yearlyCurrentQuarterEndsAt === null
+ || license.yearlyTermStartedAt === null
+ || license.yearlyTermEndsAt === null
+ ) {
+ return undefined;
+ }
+ return {
+ committedSeats: license.yearlyCommittedSeats,
+ peakSeats: license.yearlyPeakSeats,
+ overageSeats: license.yearlyOverageSeats,
+ billableOverageSeats: license.yearlyBillableOverageSeats,
+ currentQuarterNumber: license.yearlyCurrentQuarterNumber,
+ totalQuartersInTerm: license.yearlyTotalQuartersInTerm,
+ currentQuarterStartedAt: license.yearlyCurrentQuarterStartedAt,
+ currentQuarterEndsAt: license.yearlyCurrentQuarterEndsAt,
+ termStartedAt: license.yearlyTermStartedAt,
+ termEndsAt: license.yearlyTermEndsAt,
+ };
+}

packages/db/prisma/migrations/20260509000000_add_license_table/migration.sql

@@ -16,6 +16,16 @@ CREATE TABLE "License" (
  "cancelAt" TIMESTAMP(3),
  "trialEnd" TIMESTAMP(3),
  "hasPaymentMethod" BOOLEAN,
+ "yearlyCommittedSeats" INTEGER,
+ "yearlyCurrentQuarterEndsAt" TIMESTAMP(3),
+ "yearlyCurrentQuarterNumber" INTEGER,
+ "yearlyCurrentQuarterStartedAt" TIMESTAMP(3),
+ "yearlyOverageSeats" INTEGER,
+ "yearlyBillableOverageSeats" INTEGER,
+ "yearlyPeakSeats" INTEGER,
+ "yearlyTermEndsAt" TIMESTAMP(3),
+ "yearlyTermStartedAt" TIMESTAMP(3),
+ "yearlyTotalQuartersInTerm" INTEGER,
  "lastSyncAt" TIMESTAMP(3),
  "lastSyncErrorCode" TEXT,
  "createdAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,

packages/db/prisma/schema.prisma

@@ -315,6 +315,20 @@ model License {
  cancelAt DateTime?
  trialEnd DateTime?
  hasPaymentMethod Boolean?
+
+ // Yearly-only fields, mirroring `yearlyTermStatus` on the lighthouse ping
+ // response. All null for monthly subs and for unactivated/canceled licenses.
+ yearlyTermStartedAt DateTime?
+ yearlyTermEndsAt DateTime?
+ yearlyTotalQuartersInTerm Int?
+ yearlyCurrentQuarterNumber Int?
+ yearlyCurrentQuarterStartedAt DateTime?
+ yearlyCurrentQuarterEndsAt DateTime?
+ yearlyCommittedSeats Int?
+ yearlyOverageSeats Int?
+ yearlyBillableOverageSeats Int?
+ yearlyPeakSeats Int?
+
  lastSyncAt DateTime?
  lastSyncErrorCode String?
  createdAt DateTime @default(now())

packages/web/src/app/(app)/components/banners/bannerResolver.test.ts

@@ -48,6 +48,16 @@ const makeLicense = (overrides: Partial<License> = {}): License => ({
  cancelAt: null,
  trialEnd: null,
  hasPaymentMethod: null,
+ yearlyTermStartedAt: null,
+ yearlyTermEndsAt: null,
+ yearlyTotalQuartersInTerm: null,
+ yearlyCurrentQuarterNumber: null,
+ yearlyCurrentQuarterStartedAt: null,
+ yearlyCurrentQuarterEndsAt: null,
+ yearlyCommittedSeats: null,
+ yearlyOverageSeats: null,
+ yearlyBillableOverageSeats: null,
+ yearlyPeakSeats: null,
  lastSyncAt: NOW,
  lastSyncErrorCode: null,
  createdAt: NOW,

packages/web/src/app/(app)/settings/license/onlineLicenseCard.tsx → packages/web/src/app/(app)/settings/license/onlineLicenseCard/onlineLicenseCard.tsx

@@ -11,6 +11,7 @@ import { cn, formatCurrency } from "@/lib/utils";
 import { LicenseInactiveBanner } from "./licenseInactiveBanner";
 import { PlanActionsMenu } from "./planActionsMenu";
 import { TrialMissingPaymentMethodBanner } from "./trialMissingPaymentMethodBanner";
+import { UpcomingYearlyRenewalBanner } from "./upcomingYearlyRenewalBanner";
 
 interface OnlineLicenseCardProps {
  license: License;
@@ -123,6 +124,18 @@ export function OnlineLicenseCard({ license }: OnlineLicenseCardProps) {
  {isLicenseActive && license.status === 'trialing' && license.hasPaymentMethod === false && (
  <TrialMissingPaymentMethodBanner />
  )}
+ {isLicenseActive
+ && license.interval === 'year'
+ && license.yearlyCurrentQuarterNumber !== null
+ && license.yearlyTotalQuartersInTerm !== null
+ && license.yearlyCurrentQuarterNumber === license.yearlyTotalQuartersInTerm
+ && license.nextRenewalAt !== null
+ && license.seats !== null && (
+ <UpcomingYearlyRenewalBanner
+ renewalAt={license.nextRenewalAt}
+ seats={license.seats}
+ />
+ )}
  </div>
  );
 }

packages/web/src/app/(app)/settings/license/onlineLicenseCard/upcomingYearlyRenewalBanner.tsx

@@ -0,0 +1,89 @@
+"use client";
+
+import { useCallback, useState } from "react";
+import { useRouter } from "next/navigation";
+import { Info } from "lucide-react";
+import { useToast } from "@/components/hooks/use-toast";
+import { createPortalSession } from "@/ee/features/lighthouse/actions";
+import { isServiceError } from "@/lib/utils";
+
+// @note take care to keep this in sync with
+// the value in constants.ts in lighthouse.
+const YEARLY_CANCELLATION_NOTICE_DAYS = 30;
+const DAY_MS = 24 * 60 * 60 * 1000;
+
+interface UpcomingRenewalBannerProps {
+ renewalAt: Date;
+ seats: number;
+}
+
+export function UpcomingYearlyRenewalBanner({ renewalAt, seats }: UpcomingRenewalBannerProps) {
+ const router = useRouter();
+ const { toast } = useToast();
+ const [isOpeningPortal, setIsOpeningPortal] = useState(false);
+ const [nowMs] = useState(() => Date.now());
+
+ const handleCancelClick = useCallback(() => {
+ setIsOpeningPortal(true);
+ createPortalSession().then((response) => {
+ if (isServiceError(response)) {
+ toast({
+ description: `Failed to open subscription portal: ${response.message}`,
+ variant: "destructive",
+ });
+ setIsOpeningPortal(false);
+ return;
+ }
+ router.push(response.url);
+ });
+ }, [router, toast]);
+
+ const daysUntilRenewal = (renewalAt.getTime() - nowMs) / DAY_MS;
+ const noticeDeadlineHasPassed = daysUntilRenewal < YEARLY_CANCELLATION_NOTICE_DAYS;
+ const noticeDeadline = new Date(renewalAt.getTime() - YEARLY_CANCELLATION_NOTICE_DAYS * DAY_MS);
+
+ return (
+ <div className="flex items-start gap-3 border-t bg-blue-500/10 px-4 py-2.5">
+ <Info className="h-4 w-4 mt-0.5 flex-shrink-0 text-blue-400" />
+ <div className="text-sm">
+ <p>
+ <span className="font-medium">
+ Auto-renewing on {formatDate(renewalAt)}
+ </span>{" "}
+ <span className="text-muted-foreground">
+ with {seats} {seats === 1 ? 'seat' : 'seats'}.
+ </span>
+ </p>
+ {!noticeDeadlineHasPassed && (
+ <p className="text-muted-foreground mt-1">
+ You have until {formatDate(noticeDeadline)} to{" "}
+ <button
+ type="button"
+ onClick={handleCancelClick}
+ disabled={isOpeningPortal}
+ className="text-link hover:underline disabled:opacity-50"
+ >
+ cancel
+ </button>{" "}
+ your subscription or{" "}
+ <a
+ href="mailto:ar@sourcebot.dev"
+ className="text-link hover:underline"
+ >
+ request
+ </a>{" "}
+ a different seat count for renewal.
+ </p>
+ )}
+ </div>
+ </div>
+ );
+}
+
+function formatDate(date: Date): string {
+ return new Date(date).toLocaleDateString('en-US', {
+ month: 'short',
+ day: 'numeric',
+ year: 'numeric',
+ });
+}

packages/web/src/app/(app)/settings/license/page.tsx

@@ -5,14 +5,16 @@ import { Button } from "@/components/ui/button";
 import { ExternalLink } from "lucide-react";
 import { redirect } from "next/navigation";
 import { ActivationCodeCard } from "./activationCodeCard";
-import { OnlineLicenseCard } from "./onlineLicenseCard";
+import { OnlineLicenseCard } from "./onlineLicenseCard/onlineLicenseCard";
 import { OfflineLicenseCard } from "./offlineLicenseCard";
 import { RecentInvoicesCard } from "./recentInvoicesCard";
+import { YearlyTermSeatsUsageCard } from "./yearlyTermSeatsUsageCard";
 import { SettingsCard } from "../components/settingsCard";
 import { UpsellPanel } from "@/ee/features/lighthouse/upsellDialog";
 import { getAllInvoices } from "@/ee/features/lighthouse/actions";
 import { syncWithLighthouse } from "@/ee/features/lighthouse/servicePing";
 import { isServiceError } from "@/lib/utils";
+import { getYearlyTermStatus } from "./types";
 
 type LicensePageProps = {
  searchParams?: Promise<Record<string, string | string[] | undefined>>;
@@ -36,6 +38,7 @@ export default authenticatedPage<LicensePageProps>(async ({ prisma, org }, props
  redirect(suffix ? `/settings/license?${suffix}` : '/settings/license');
  }
 
+
  const offlineLicense = getOfflineLicenseMetadata();
  const isOfflineLicenseExpired = offlineLicense
  ? new Date(offlineLicense.expiryDate).getTime() < Date.now()
@@ -45,6 +48,9 @@ export default authenticatedPage<LicensePageProps>(async ({ prisma, org }, props
  ? null
  : await prisma.license.findUnique({ where: { orgId: org.id } });
 
+ const yearlyTermStatus = getYearlyTermStatus(license);
+ const currentUserCount = await prisma.userToOrg.count({ where: { orgId: org.id } });
+
  const invoicesResult = license ? await getAllInvoices() : null;
  const invoices = invoicesResult && !isServiceError(invoicesResult) ? invoicesResult : [];
 
@@ -87,6 +93,13 @@ export default authenticatedPage<LicensePageProps>(async ({ prisma, org }, props
  <OfflineLicenseCard license={offlineLicense} isExpired={isOfflineLicenseExpired} />
  )}
  {license && <OnlineLicenseCard license={license} />}
+ {license
+ && yearlyTermStatus && (
+ <YearlyTermSeatsUsageCard
+ currentUsers={currentUserCount}
+ status={yearlyTermStatus}
+ />
+ )}
  {!offlineLicense && !license && <ActivationCodeCard />}
  {license && <RecentInvoicesCard invoices={invoices} />}
  </div>

packages/web/src/app/(app)/settings/license/types.ts

@@ -0,0 +1,41 @@
+import { YearlyTermStatus as RawYearlyTermStatus } from "@/ee/features/lighthouse/types";
+import { License } from "@sourcebot/db";
+
+export type YearlyTermStatus = Omit<RawYearlyTermStatus, 'currentQuarterStartedAt' | 'currentQuarterEndsAt' | 'termStartedAt' | 'termEndsAt'> & {
+ currentQuarterStartedAt: Date,
+ currentQuarterEndsAt: Date,
+ termStartedAt: Date,
+ termEndsAt: Date,
+}
+
+export function getYearlyTermStatus(
+ license: License | null,
+): YearlyTermStatus | undefined {
+ if (
+ license === null
+ || license.yearlyCommittedSeats === null
+ || license.yearlyPeakSeats === null
+ || license.yearlyOverageSeats === null
+ || license.yearlyBillableOverageSeats === null
+ || license.yearlyCurrentQuarterNumber === null
+ || license.yearlyTotalQuartersInTerm === null
+ || license.yearlyCurrentQuarterStartedAt === null
+ || license.yearlyCurrentQuarterEndsAt === null
+ || license.yearlyTermStartedAt === null
+ || license.yearlyTermEndsAt === null
+ ) {
+ return undefined;
+ }
+ return {
+ committedSeats: license.yearlyCommittedSeats,
+ peakSeats: license.yearlyPeakSeats,
+ overageSeats: license.yearlyOverageSeats,
+ billableOverageSeats: license.yearlyBillableOverageSeats,
+ currentQuarterNumber: license.yearlyCurrentQuarterNumber,
+ totalQuartersInTerm: license.yearlyTotalQuartersInTerm,
+ currentQuarterStartedAt: license.yearlyCurrentQuarterStartedAt,
+ currentQuarterEndsAt: license.yearlyCurrentQuarterEndsAt,
+ termStartedAt: license.yearlyTermStartedAt,
+ termEndsAt: license.yearlyTermEndsAt,
+ };
+}

packages/db/prisma/migrations/20260509000000_add_license_table/migration.sql

@@ -16,6 +16,16 @@ CREATE TABLE "License" (
  "cancelAt" TIMESTAMP(3),
  "trialEnd" TIMESTAMP(3),
  "hasPaymentMethod" BOOLEAN,
+ "yearlyCommittedSeats" INTEGER,
+ "yearlyCurrentQuarterEndsAt" TIMESTAMP(3),
+ "yearlyCurrentQuarterNumber" INTEGER,
+ "yearlyCurrentQuarterStartedAt" TIMESTAMP(3),
+ "yearlyOverageSeats" INTEGER,
+ "yearlyBillableOverageSeats" INTEGER,
+ "yearlyPeakSeats" INTEGER,
+ "yearlyTermEndsAt" TIMESTAMP(3),
+ "yearlyTermStartedAt" TIMESTAMP(3),
+ "yearlyTotalQuartersInTerm" INTEGER,
  "lastSyncAt" TIMESTAMP(3),
  "lastSyncErrorCode" TEXT,
  "createdAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,

packages/db/prisma/schema.prisma

@@ -315,6 +315,20 @@ model License {
  cancelAt DateTime?
  trialEnd DateTime?
  hasPaymentMethod Boolean?
+
+ // Yearly-only fields, mirroring `yearlyTermStatus` on the lighthouse ping
+ // response. All null for monthly subs and for unactivated/canceled licenses.
+ yearlyTermStartedAt DateTime?
+ yearlyTermEndsAt DateTime?
+ yearlyTotalQuartersInTerm Int?
+ yearlyCurrentQuarterNumber Int?
+ yearlyCurrentQuarterStartedAt DateTime?
+ yearlyCurrentQuarterEndsAt DateTime?
+ yearlyCommittedSeats Int?
+ yearlyOverageSeats Int?
+ yearlyBillableOverageSeats Int?
+ yearlyPeakSeats Int?
+
  lastSyncAt DateTime?
  lastSyncErrorCode String?
  createdAt DateTime @default(now())

packages/web/src/app/(app)/components/banners/bannerResolver.test.ts

@@ -48,6 +48,16 @@ const makeLicense = (overrides: Partial<License> = {}): License => ({
  cancelAt: null,
  trialEnd: null,
  hasPaymentMethod: null,
+ yearlyTermStartedAt: null,
+ yearlyTermEndsAt: null,
+ yearlyTotalQuartersInTerm: null,
+ yearlyCurrentQuarterNumber: null,
+ yearlyCurrentQuarterStartedAt: null,
+ yearlyCurrentQuarterEndsAt: null,
+ yearlyCommittedSeats: null,
+ yearlyOverageSeats: null,
+ yearlyBillableOverageSeats: null,
+ yearlyPeakSeats: null,
  lastSyncAt: NOW,
  lastSyncErrorCode: null,
  createdAt: NOW,

packages/web/src/app/(app)/settings/license/onlineLicenseCard.tsx → packages/web/src/app/(app)/settings/license/onlineLicenseCard/onlineLicenseCard.tsx

@@ -11,6 +11,7 @@ import { cn, formatCurrency } from "@/lib/utils";
 import { LicenseInactiveBanner } from "./licenseInactiveBanner";
 import { PlanActionsMenu } from "./planActionsMenu";
 import { TrialMissingPaymentMethodBanner } from "./trialMissingPaymentMethodBanner";
+import { UpcomingYearlyRenewalBanner } from "./upcomingYearlyRenewalBanner";
 
 interface OnlineLicenseCardProps {
  license: License;
@@ -123,6 +124,18 @@ export function OnlineLicenseCard({ license }: OnlineLicenseCardProps) {
  {isLicenseActive && license.status === 'trialing' && license.hasPaymentMethod === false && (
  <TrialMissingPaymentMethodBanner />
  )}
+ {isLicenseActive
+ && license.interval === 'year'
+ && license.yearlyCurrentQuarterNumber !== null
+ && license.yearlyTotalQuartersInTerm !== null
+ && license.yearlyCurrentQuarterNumber === license.yearlyTotalQuartersInTerm
+ && license.nextRenewalAt !== null
+ && license.seats !== null && (
+ <UpcomingYearlyRenewalBanner
+ renewalAt={license.nextRenewalAt}
+ seats={license.seats}
+ />
+ )}
  </div>
  );
 }

packages/web/src/app/(app)/settings/license/onlineLicenseCard/upcomingYearlyRenewalBanner.tsx

@@ -0,0 +1,89 @@
+"use client";
+
+import { useCallback, useState } from "react";
+import { useRouter } from "next/navigation";
+import { Info } from "lucide-react";
+import { useToast } from "@/components/hooks/use-toast";
+import { createPortalSession } from "@/ee/features/lighthouse/actions";
+import { isServiceError } from "@/lib/utils";
+
+// @note take care to keep this in sync with
+// the value in constants.ts in lighthouse.
+const YEARLY_CANCELLATION_NOTICE_DAYS = 30;
+const DAY_MS = 24 * 60 * 60 * 1000;
+
+interface UpcomingRenewalBannerProps {
+ renewalAt: Date;
+ seats: number;
+}
+
+export function UpcomingYearlyRenewalBanner({ renewalAt, seats }: UpcomingRenewalBannerProps) {
+ const router = useRouter();
+ const { toast } = useToast();
+ const [isOpeningPortal, setIsOpeningPortal] = useState(false);
+ const [nowMs] = useState(() => Date.now());
+
+ const handleCancelClick = useCallback(() => {
+ setIsOpeningPortal(true);
+ createPortalSession().then((response) => {
+ if (isServiceError(response)) {
+ toast({
+ description: `Failed to open subscription portal: ${response.message}`,
+ variant: "destructive",
+ });
+ setIsOpeningPortal(false);
+ return;
+ }
+ router.push(response.url);
+ });
+ }, [router, toast]);
+
+ const daysUntilRenewal = (renewalAt.getTime() - nowMs) / DAY_MS;
+ const noticeDeadlineHasPassed = daysUntilRenewal < YEARLY_CANCELLATION_NOTICE_DAYS;
+ const noticeDeadline = new Date(renewalAt.getTime() - YEARLY_CANCELLATION_NOTICE_DAYS * DAY_MS);
+
+ return (
+ <div className="flex items-start gap-3 border-t bg-blue-500/10 px-4 py-2.5">
+ <Info className="h-4 w-4 mt-0.5 flex-shrink-0 text-blue-400" />
+ <div className="text-sm">
+ <p>
+ <span className="font-medium">
+ Auto-renewing on {formatDate(renewalAt)}
+ </span>{" "}
+ <span className="text-muted-foreground">
+ with {seats} {seats === 1 ? 'seat' : 'seats'}.
+ </span>
+ </p>
+ {!noticeDeadlineHasPassed && (
+ <p className="text-muted-foreground mt-1">
+ You have until {formatDate(noticeDeadline)} to{" "}
+ <button
+ type="button"
+ onClick={handleCancelClick}
+ disabled={isOpeningPortal}
+ className="text-link hover:underline disabled:opacity-50"
+ >
+ cancel
+ </button>{" "}
+ your subscription or{" "}
+ <a
+ href="mailto:ar@sourcebot.dev"
+ className="text-link hover:underline"
+ >
+ request
+ </a>{" "}
+ a different seat count for renewal.
+ </p>
+ )}
+ </div>
+ </div>
+ );
+}
+
+function formatDate(date: Date): string {
+ return new Date(date).toLocaleDateString('en-US', {
+ month: 'short',
+ day: 'numeric',
+ year: 'numeric',
+ });
+}

packages/web/src/app/(app)/settings/license/page.tsx

@@ -5,14 +5,16 @@ import { Button } from "@/components/ui/button";
 import { ExternalLink } from "lucide-react";
 import { redirect } from "next/navigation";
 import { ActivationCodeCard } from "./activationCodeCard";
-import { OnlineLicenseCard } from "./onlineLicenseCard";
+import { OnlineLicenseCard } from "./onlineLicenseCard/onlineLicenseCard";
 import { OfflineLicenseCard } from "./offlineLicenseCard";
 import { RecentInvoicesCard } from "./recentInvoicesCard";
+import { YearlyTermSeatsUsageCard } from "./yearlyTermSeatsUsageCard";
 import { SettingsCard } from "../components/settingsCard";
 import { UpsellPanel } from "@/ee/features/lighthouse/upsellDialog";
 import { getAllInvoices } from "@/ee/features/lighthouse/actions";
 import { syncWithLighthouse } from "@/ee/features/lighthouse/servicePing";
 import { isServiceError } from "@/lib/utils";
+import { getYearlyTermStatus } from "./types";
 
 type LicensePageProps = {
  searchParams?: Promise<Record<string, string | string[] | undefined>>;
@@ -36,6 +38,7 @@ export default authenticatedPage<LicensePageProps>(async ({ prisma, org }, props
  redirect(suffix ? `/settings/license?${suffix}` : '/settings/license');
  }
 
+
  const offlineLicense = getOfflineLicenseMetadata();
  const isOfflineLicenseExpired = offlineLicense
  ? new Date(offlineLicense.expiryDate).getTime() < Date.now()
@@ -45,6 +48,9 @@ export default authenticatedPage<LicensePageProps>(async ({ prisma, org }, props
  ? null
  : await prisma.license.findUnique({ where: { orgId: org.id } });
 
+ const yearlyTermStatus = getYearlyTermStatus(license);
+ const currentUserCount = await prisma.userToOrg.count({ where: { orgId: org.id } });
+
  const invoicesResult = license ? await getAllInvoices() : null;
  const invoices = invoicesResult && !isServiceError(invoicesResult) ? invoicesResult : [];
 
@@ -87,6 +93,13 @@ export default authenticatedPage<LicensePageProps>(async ({ prisma, org }, props
  <OfflineLicenseCard license={offlineLicense} isExpired={isOfflineLicenseExpired} />
  )}
  {license && <OnlineLicenseCard license={license} />}
+ {license
+ && yearlyTermStatus && (
+ <YearlyTermSeatsUsageCard
+ currentUsers={currentUserCount}
+ status={yearlyTermStatus}
+ />
+ )}
  {!offlineLicense && !license && <ActivationCodeCard />}
  {license && <RecentInvoicesCard invoices={invoices} />}
  </div>

packages/web/src/app/(app)/settings/license/types.ts

@@ -0,0 +1,41 @@
+import { YearlyTermStatus as RawYearlyTermStatus } from "@/ee/features/lighthouse/types";
+import { License } from "@sourcebot/db";
+
+export type YearlyTermStatus = Omit<RawYearlyTermStatus, 'currentQuarterStartedAt' | 'currentQuarterEndsAt' | 'termStartedAt' | 'termEndsAt'> & {
+ currentQuarterStartedAt: Date,
+ currentQuarterEndsAt: Date,
+ termStartedAt: Date,
+ termEndsAt: Date,
+}
+
+export function getYearlyTermStatus(
+ license: License | null,
+): YearlyTermStatus | undefined {
+ if (
+ license === null
+ || license.yearlyCommittedSeats === null
+ || license.yearlyPeakSeats === null
+ || license.yearlyOverageSeats === null
+ || license.yearlyBillableOverageSeats === null
+ || license.yearlyCurrentQuarterNumber === null
+ || license.yearlyTotalQuartersInTerm === null
+ || license.yearlyCurrentQuarterStartedAt === null
+ || license.yearlyCurrentQuarterEndsAt === null
+ || license.yearlyTermStartedAt === null
+ || license.yearlyTermEndsAt === null
+ ) {
+ return undefined;
+ }
+ return {
+ committedSeats: license.yearlyCommittedSeats,
+ peakSeats: license.yearlyPeakSeats,
+ overageSeats: license.yearlyOverageSeats,
+ billableOverageSeats: license.yearlyBillableOverageSeats,
+ currentQuarterNumber: license.yearlyCurrentQuarterNumber,
+ totalQuartersInTerm: license.yearlyTotalQuartersInTerm,
+ currentQuarterStartedAt: license.yearlyCurrentQuarterStartedAt,
+ currentQuarterEndsAt: license.yearlyCurrentQuarterEndsAt,
+ termStartedAt: license.yearlyTermStartedAt,
+ termEndsAt: license.yearlyTermEndsAt,
+ };
+}

packages/db/prisma/migrations/20260509000000_add_license_table/migration.sql

@@ -16,6 +16,16 @@ CREATE TABLE "License" (
  "cancelAt" TIMESTAMP(3),
  "trialEnd" TIMESTAMP(3),
  "hasPaymentMethod" BOOLEAN,
+ "yearlyCommittedSeats" INTEGER,
+ "yearlyCurrentQuarterEndsAt" TIMESTAMP(3),
+ "yearlyCurrentQuarterNumber" INTEGER,
+ "yearlyCurrentQuarterStartedAt" TIMESTAMP(3),
+ "yearlyOverageSeats" INTEGER,
+ "yearlyBillableOverageSeats" INTEGER,
+ "yearlyPeakSeats" INTEGER,
+ "yearlyTermEndsAt" TIMESTAMP(3),
+ "yearlyTermStartedAt" TIMESTAMP(3),
+ "yearlyTotalQuartersInTerm" INTEGER,
  "lastSyncAt" TIMESTAMP(3),
  "lastSyncErrorCode" TEXT,
  "createdAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,

packages/db/prisma/schema.prisma

@@ -315,6 +315,20 @@ model License {
  cancelAt DateTime?
  trialEnd DateTime?
  hasPaymentMethod Boolean?
+
+ // Yearly-only fields, mirroring `yearlyTermStatus` on the lighthouse ping
+ // response. All null for monthly subs and for unactivated/canceled licenses.
+ yearlyTermStartedAt DateTime?
+ yearlyTermEndsAt DateTime?
+ yearlyTotalQuartersInTerm Int?
+ yearlyCurrentQuarterNumber Int?
+ yearlyCurrentQuarterStartedAt DateTime?
+ yearlyCurrentQuarterEndsAt DateTime?
+ yearlyCommittedSeats Int?
+ yearlyOverageSeats Int?
+ yearlyBillableOverageSeats Int?
+ yearlyPeakSeats Int?
+
  lastSyncAt DateTime?
  lastSyncErrorCode String?
  createdAt DateTime @default(now())

packages/web/src/app/(app)/components/banners/bannerResolver.test.ts

@@ -48,6 +48,16 @@ const makeLicense = (overrides: Partial<License> = {}): License => ({
  cancelAt: null,
  trialEnd: null,
  hasPaymentMethod: null,
+ yearlyTermStartedAt: null,
+ yearlyTermEndsAt: null,
+ yearlyTotalQuartersInTerm: null,
+ yearlyCurrentQuarterNumber: null,
+ yearlyCurrentQuarterStartedAt: null,
+ yearlyCurrentQuarterEndsAt: null,
+ yearlyCommittedSeats: null,
+ yearlyOverageSeats: null,
+ yearlyBillableOverageSeats: null,
+ yearlyPeakSeats: null,
  lastSyncAt: NOW,
  lastSyncErrorCode: null,
  createdAt: NOW,

packages/web/src/app/(app)/settings/license/onlineLicenseCard.tsx → packages/web/src/app/(app)/settings/license/onlineLicenseCard/onlineLicenseCard.tsx

@@ -11,6 +11,7 @@ import { cn, formatCurrency } from "@/lib/utils";
 import { LicenseInactiveBanner } from "./licenseInactiveBanner";
 import { PlanActionsMenu } from "./planActionsMenu";
 import { TrialMissingPaymentMethodBanner } from "./trialMissingPaymentMethodBanner";
+import { UpcomingYearlyRenewalBanner } from "./upcomingYearlyRenewalBanner";
 
 interface OnlineLicenseCardProps {
  license: License;
@@ -123,6 +124,18 @@ export function OnlineLicenseCard({ license }: OnlineLicenseCardProps) {
  {isLicenseActive && license.status === 'trialing' && license.hasPaymentMethod === false && (
  <TrialMissingPaymentMethodBanner />
  )}
+ {isLicenseActive
+ && license.interval === 'year'
+ && license.yearlyCurrentQuarterNumber !== null
+ && license.yearlyTotalQuartersInTerm !== null
+ && license.yearlyCurrentQuarterNumber === license.yearlyTotalQuartersInTerm
+ && license.nextRenewalAt !== null
+ && license.seats !== null && (
+ <UpcomingYearlyRenewalBanner
+ renewalAt={license.nextRenewalAt}
+ seats={license.seats}
+ />
+ )}
  </div>
  );
 }

packages/web/src/app/(app)/settings/license/onlineLicenseCard/upcomingYearlyRenewalBanner.tsx

@@ -0,0 +1,89 @@
+"use client";
+
+import { useCallback, useState } from "react";
+import { useRouter } from "next/navigation";
+import { Info } from "lucide-react";
+import { useToast } from "@/components/hooks/use-toast";
+import { createPortalSession } from "@/ee/features/lighthouse/actions";
+import { isServiceError } from "@/lib/utils";
+
+// @note take care to keep this in sync with
+// the value in constants.ts in lighthouse.
+const YEARLY_CANCELLATION_NOTICE_DAYS = 30;
+const DAY_MS = 24 * 60 * 60 * 1000;
+
+interface UpcomingRenewalBannerProps {
+ renewalAt: Date;
+ seats: number;
+}
+
+export function UpcomingYearlyRenewalBanner({ renewalAt, seats }: UpcomingRenewalBannerProps) {
+ const router = useRouter();
+ const { toast } = useToast();
+ const [isOpeningPortal, setIsOpeningPortal] = useState(false);
+ const [nowMs] = useState(() => Date.now());
+
+ const handleCancelClick = useCallback(() => {
+ setIsOpeningPortal(true);
+ createPortalSession().then((response) => {
+ if (isServiceError(response)) {
+ toast({
+ description: `Failed to open subscription portal: ${response.message}`,
+ variant: "destructive",
+ });
+ setIsOpeningPortal(false);
+ return;
+ }
+ router.push(response.url);
+ });
+ }, [router, toast]);
+
+ const daysUntilRenewal = (renewalAt.getTime() - nowMs) / DAY_MS;
+ const noticeDeadlineHasPassed = daysUntilRenewal < YEARLY_CANCELLATION_NOTICE_DAYS;
+ const noticeDeadline = new Date(renewalAt.getTime() - YEARLY_CANCELLATION_NOTICE_DAYS * DAY_MS);
+
+ return (
+ <div className="flex items-start gap-3 border-t bg-blue-500/10 px-4 py-2.5">
+ <Info className="h-4 w-4 mt-0.5 flex-shrink-0 text-blue-400" />
+ <div className="text-sm">
+ <p>
+ <span className="font-medium">
+ Auto-renewing on {formatDate(renewalAt)}
+ </span>{" "}
+ <span className="text-muted-foreground">
+ with {seats} {seats === 1 ? 'seat' : 'seats'}.
+ </span>
+ </p>
+ {!noticeDeadlineHasPassed && (
+ <p className="text-muted-foreground mt-1">
+ You have until {formatDate(noticeDeadline)} to{" "}
+ <button
+ type="button"
+ onClick={handleCancelClick}
+ disabled={isOpeningPortal}
+ className="text-link hover:underline disabled:opacity-50"
+ >
+ cancel
+ </button>{" "}
+ your subscription or{" "}
+ <a
+ href="mailto:ar@sourcebot.dev"
+ className="text-link hover:underline"
+ >
+ request
+ </a>{" "}
+ a different seat count for renewal.
+ </p>
+ )}
+ </div>
+ </div>
+ );
+}
+
+function formatDate(date: Date): string {
+ return new Date(date).toLocaleDateString('en-US', {
+ month: 'short',
+ day: 'numeric',
+ year: 'numeric',
+ });
+}

packages/web/src/app/(app)/settings/license/page.tsx

@@ -5,14 +5,16 @@ import { Button } from "@/components/ui/button";
 import { ExternalLink } from "lucide-react";
 import { redirect } from "next/navigation";
 import { ActivationCodeCard } from "./activationCodeCard";
-import { OnlineLicenseCard } from "./onlineLicenseCard";
+import { OnlineLicenseCard } from "./onlineLicenseCard/onlineLicenseCard";
 import { OfflineLicenseCard } from "./offlineLicenseCard";
 import { RecentInvoicesCard } from "./recentInvoicesCard";
+import { YearlyTermSeatsUsageCard } from "./yearlyTermSeatsUsageCard";
 import { SettingsCard } from "../components/settingsCard";
 import { UpsellPanel } from "@/ee/features/lighthouse/upsellDialog";
 import { getAllInvoices } from "@/ee/features/lighthouse/actions";
 import { syncWithLighthouse } from "@/ee/features/lighthouse/servicePing";
 import { isServiceError } from "@/lib/utils";
+import { getYearlyTermStatus } from "./types";
 
 type LicensePageProps = {
  searchParams?: Promise<Record<string, string | string[] | undefined>>;
@@ -36,6 +38,7 @@ export default authenticatedPage<LicensePageProps>(async ({ prisma, org }, props
  redirect(suffix ? `/settings/license?${suffix}` : '/settings/license');
  }
 
+
  const offlineLicense = getOfflineLicenseMetadata();
  const isOfflineLicenseExpired = offlineLicense
  ? new Date(offlineLicense.expiryDate).getTime() < Date.now()
@@ -45,6 +48,9 @@ export default authenticatedPage<LicensePageProps>(async ({ prisma, org }, props
  ? null
  : await prisma.license.findUnique({ where: { orgId: org.id } });
 
+ const yearlyTermStatus = getYearlyTermStatus(license);
+ const currentUserCount = await prisma.userToOrg.count({ where: { orgId: org.id } });
+
  const invoicesResult = license ? await getAllInvoices() : null;
  const invoices = invoicesResult && !isServiceError(invoicesResult) ? invoicesResult : [];
 
@@ -87,6 +93,13 @@ export default authenticatedPage<LicensePageProps>(async ({ prisma, org }, props
  <OfflineLicenseCard license={offlineLicense} isExpired={isOfflineLicenseExpired} />
  )}
  {license && <OnlineLicenseCard license={license} />}
+ {license
+ && yearlyTermStatus && (
+ <YearlyTermSeatsUsageCard
+ currentUsers={currentUserCount}
+ status={yearlyTermStatus}
+ />
+ )}
  {!offlineLicense && !license && <ActivationCodeCard />}
  {license && <RecentInvoicesCard invoices={invoices} />}
  </div>

packages/web/src/app/(app)/settings/license/types.ts

@@ -0,0 +1,41 @@
+import { YearlyTermStatus as RawYearlyTermStatus } from "@/ee/features/lighthouse/types";
+import { License } from "@sourcebot/db";
+
+export type YearlyTermStatus = Omit<RawYearlyTermStatus, 'currentQuarterStartedAt' | 'currentQuarterEndsAt' | 'termStartedAt' | 'termEndsAt'> & {
+ currentQuarterStartedAt: Date,
+ currentQuarterEndsAt: Date,
+ termStartedAt: Date,
+ termEndsAt: Date,
+}
+
+export function getYearlyTermStatus(
+ license: License | null,
+): YearlyTermStatus | undefined {
+ if (
+ license === null
+ || license.yearlyCommittedSeats === null
+ || license.yearlyPeakSeats === null
+ || license.yearlyOverageSeats === null
+ || license.yearlyBillableOverageSeats === null
+ || license.yearlyCurrentQuarterNumber === null
+ || license.yearlyTotalQuartersInTerm === null
+ || license.yearlyCurrentQuarterStartedAt === null
+ || license.yearlyCurrentQuarterEndsAt === null
+ || license.yearlyTermStartedAt === null
+ || license.yearlyTermEndsAt === null
+ ) {
+ return undefined;
+ }
+ return {
+ committedSeats: license.yearlyCommittedSeats,
+ peakSeats: license.yearlyPeakSeats,
+ overageSeats: license.yearlyOverageSeats,
+ billableOverageSeats: license.yearlyBillableOverageSeats,
+ currentQuarterNumber: license.yearlyCurrentQuarterNumber,
+ totalQuartersInTerm: license.yearlyTotalQuartersInTerm,
+ currentQuarterStartedAt: license.yearlyCurrentQuarterStartedAt,
+ currentQuarterEndsAt: license.yearlyCurrentQuarterEndsAt,
+ termStartedAt: license.yearlyTermStartedAt,
+ termEndsAt: license.yearlyTermEndsAt,
+ };
+}

packages/db/prisma/migrations/20260509000000_add_license_table/migration.sql

@@ -16,6 +16,16 @@ CREATE TABLE "License" (
  "cancelAt" TIMESTAMP(3),
  "trialEnd" TIMESTAMP(3),
  "hasPaymentMethod" BOOLEAN,
+ "yearlyCommittedSeats" INTEGER,
+ "yearlyCurrentQuarterEndsAt" TIMESTAMP(3),
+ "yearlyCurrentQuarterNumber" INTEGER,
+ "yearlyCurrentQuarterStartedAt" TIMESTAMP(3),
+ "yearlyOverageSeats" INTEGER,
+ "yearlyBillableOverageSeats" INTEGER,
+ "yearlyPeakSeats" INTEGER,
+ "yearlyTermEndsAt" TIMESTAMP(3),
+ "yearlyTermStartedAt" TIMESTAMP(3),
+ "yearlyTotalQuartersInTerm" INTEGER,
  "lastSyncAt" TIMESTAMP(3),
  "lastSyncErrorCode" TEXT,
  "createdAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,

packages/db/prisma/schema.prisma

@@ -315,6 +315,20 @@ model License {
  cancelAt DateTime?
  trialEnd DateTime?
  hasPaymentMethod Boolean?
+
+ // Yearly-only fields, mirroring `yearlyTermStatus` on the lighthouse ping
+ // response. All null for monthly subs and for unactivated/canceled licenses.
+ yearlyTermStartedAt DateTime?
+ yearlyTermEndsAt DateTime?
+ yearlyTotalQuartersInTerm Int?
+ yearlyCurrentQuarterNumber Int?
+ yearlyCurrentQuarterStartedAt DateTime?
+ yearlyCurrentQuarterEndsAt DateTime?
+ yearlyCommittedSeats Int?
+ yearlyOverageSeats Int?
+ yearlyBillableOverageSeats Int?
+ yearlyPeakSeats Int?
+
  lastSyncAt DateTime?
  lastSyncErrorCode String?
  createdAt DateTime @default(now())

packages/web/src/app/(app)/components/banners/bannerResolver.test.ts

@@ -48,6 +48,16 @@ const makeLicense = (overrides: Partial<License> = {}): License => ({
  cancelAt: null,
  trialEnd: null,
  hasPaymentMethod: null,
+ yearlyTermStartedAt: null,
+ yearlyTermEndsAt: null,
+ yearlyTotalQuartersInTerm: null,
+ yearlyCurrentQuarterNumber: null,
+ yearlyCurrentQuarterStartedAt: null,
+ yearlyCurrentQuarterEndsAt: null,
+ yearlyCommittedSeats: null,
+ yearlyOverageSeats: null,
+ yearlyBillableOverageSeats: null,
+ yearlyPeakSeats: null,
  lastSyncAt: NOW,
  lastSyncErrorCode: null,
  createdAt: NOW,

packages/web/src/app/(app)/settings/license/onlineLicenseCard.tsx → packages/web/src/app/(app)/settings/license/onlineLicenseCard/onlineLicenseCard.tsx

@@ -11,6 +11,7 @@ import { cn, formatCurrency } from "@/lib/utils";
 import { LicenseInactiveBanner } from "./licenseInactiveBanner";
 import { PlanActionsMenu } from "./planActionsMenu";
 import { TrialMissingPaymentMethodBanner } from "./trialMissingPaymentMethodBanner";
+import { UpcomingYearlyRenewalBanner } from "./upcomingYearlyRenewalBanner";
 
 interface OnlineLicenseCardProps {
  license: License;
@@ -123,6 +124,18 @@ export function OnlineLicenseCard({ license }: OnlineLicenseCardProps) {
  {isLicenseActive && license.status === 'trialing' && license.hasPaymentMethod === false && (
  <TrialMissingPaymentMethodBanner />
  )}
+ {isLicenseActive
+ && license.interval === 'year'
+ && license.yearlyCurrentQuarterNumber !== null
+ && license.yearlyTotalQuartersInTerm !== null
+ && license.yearlyCurrentQuarterNumber === license.yearlyTotalQuartersInTerm
+ && license.nextRenewalAt !== null
+ && license.seats !== null && (
+ <UpcomingYearlyRenewalBanner
+ renewalAt={license.nextRenewalAt}
+ seats={license.seats}
+ />
+ )}
  </div>
  );
 }

packages/web/src/app/(app)/settings/license/onlineLicenseCard/upcomingYearlyRenewalBanner.tsx

@@ -0,0 +1,89 @@
+"use client";
+
+import { useCallback, useState } from "react";
+import { useRouter } from "next/navigation";
+import { Info } from "lucide-react";
+import { useToast } from "@/components/hooks/use-toast";
+import { createPortalSession } from "@/ee/features/lighthouse/actions";
+import { isServiceError } from "@/lib/utils";
+
+// @note take care to keep this in sync with
+// the value in constants.ts in lighthouse.
+const YEARLY_CANCELLATION_NOTICE_DAYS = 30;
+const DAY_MS = 24 * 60 * 60 * 1000;
+
+interface UpcomingRenewalBannerProps {
+ renewalAt: Date;
+ seats: number;
+}
+
+export function UpcomingYearlyRenewalBanner({ renewalAt, seats }: UpcomingRenewalBannerProps) {
+ const router = useRouter();
+ const { toast } = useToast();
+ const [isOpeningPortal, setIsOpeningPortal] = useState(false);
+ const [nowMs] = useState(() => Date.now());
+
+ const handleCancelClick = useCallback(() => {
+ setIsOpeningPortal(true);
+ createPortalSession().then((response) => {
+ if (isServiceError(response)) {
+ toast({
+ description: `Failed to open subscription portal: ${response.message}`,
+ variant: "destructive",
+ });
+ setIsOpeningPortal(false);
+ return;
+ }
+ router.push(response.url);
+ });
+ }, [router, toast]);
+
+ const daysUntilRenewal = (renewalAt.getTime() - nowMs) / DAY_MS;
+ const noticeDeadlineHasPassed = daysUntilRenewal < YEARLY_CANCELLATION_NOTICE_DAYS;
+ const noticeDeadline = new Date(renewalAt.getTime() - YEARLY_CANCELLATION_NOTICE_DAYS * DAY_MS);
+
+ return (
+ <div className="flex items-start gap-3 border-t bg-blue-500/10 px-4 py-2.5">
+ <Info className="h-4 w-4 mt-0.5 flex-shrink-0 text-blue-400" />
+ <div className="text-sm">
+ <p>
+ <span className="font-medium">
+ Auto-renewing on {formatDate(renewalAt)}
+ </span>{" "}
+ <span className="text-muted-foreground">
+ with {seats} {seats === 1 ? 'seat' : 'seats'}.
+ </span>
+ </p>
+ {!noticeDeadlineHasPassed && (
+ <p className="text-muted-foreground mt-1">
+ You have until {formatDate(noticeDeadline)} to{" "}
+ <button
+ type="button"
+ onClick={handleCancelClick}
+ disabled={isOpeningPortal}
+ className="text-link hover:underline disabled:opacity-50"
+ >
+ cancel
+ </button>{" "}
+ your subscription or{" "}
+ <a
+ href="mailto:ar@sourcebot.dev"
+ className="text-link hover:underline"
+ >
+ request
+ </a>{" "}
+ a different seat count for renewal.
+ </p>
+ )}
+ </div>
+ </div>
+ );
+}
+
+function formatDate(date: Date): string {
+ return new Date(date).toLocaleDateString('en-US', {
+ month: 'short',
+ day: 'numeric',
+ year: 'numeric',
+ });
+}

packages/web/src/app/(app)/settings/license/page.tsx

@@ -5,14 +5,16 @@ import { Button } from "@/components/ui/button";
 import { ExternalLink } from "lucide-react";
 import { redirect } from "next/navigation";
 import { ActivationCodeCard } from "./activationCodeCard";
-import { OnlineLicenseCard } from "./onlineLicenseCard";
+import { OnlineLicenseCard } from "./onlineLicenseCard/onlineLicenseCard";
 import { OfflineLicenseCard } from "./offlineLicenseCard";
 import { RecentInvoicesCard } from "./recentInvoicesCard";
+import { YearlyTermSeatsUsageCard } from "./yearlyTermSeatsUsageCard";
 import { SettingsCard } from "../components/settingsCard";
 import { UpsellPanel } from "@/ee/features/lighthouse/upsellDialog";
 import { getAllInvoices } from "@/ee/features/lighthouse/actions";
 import { syncWithLighthouse } from "@/ee/features/lighthouse/servicePing";
 import { isServiceError } from "@/lib/utils";
+import { getYearlyTermStatus } from "./types";
 
 type LicensePageProps = {
  searchParams?: Promise<Record<string, string | string[] | undefined>>;
@@ -36,6 +38,7 @@ export default authenticatedPage<LicensePageProps>(async ({ prisma, org }, props
  redirect(suffix ? `/settings/license?${suffix}` : '/settings/license');
  }
 
+
  const offlineLicense = getOfflineLicenseMetadata();
  const isOfflineLicenseExpired = offlineLicense
  ? new Date(offlineLicense.expiryDate).getTime() < Date.now()
@@ -45,6 +48,9 @@ export default authenticatedPage<LicensePageProps>(async ({ prisma, org }, props
  ? null
  : await prisma.license.findUnique({ where: { orgId: org.id } });
 
+ const yearlyTermStatus = getYearlyTermStatus(license);
+ const currentUserCount = await prisma.userToOrg.count({ where: { orgId: org.id } });
+
  const invoicesResult = license ? await getAllInvoices() : null;
  const invoices = invoicesResult && !isServiceError(invoicesResult) ? invoicesResult : [];
 
@@ -87,6 +93,13 @@ export default authenticatedPage<LicensePageProps>(async ({ prisma, org }, props
  <OfflineLicenseCard license={offlineLicense} isExpired={isOfflineLicenseExpired} />
  )}
  {license && <OnlineLicenseCard license={license} />}
+ {license
+ && yearlyTermStatus && (
+ <YearlyTermSeatsUsageCard
+ currentUsers={currentUserCount}
+ status={yearlyTermStatus}
+ />
+ )}
  {!offlineLicense && !license && <ActivationCodeCard />}
  {license && <RecentInvoicesCard invoices={invoices} />}
  </div>

packages/web/src/app/(app)/settings/license/types.ts

@@ -0,0 +1,41 @@
+import { YearlyTermStatus as RawYearlyTermStatus } from "@/ee/features/lighthouse/types";
+import { License } from "@sourcebot/db";
+
+export type YearlyTermStatus = Omit<RawYearlyTermStatus, 'currentQuarterStartedAt' | 'currentQuarterEndsAt' | 'termStartedAt' | 'termEndsAt'> & {
+ currentQuarterStartedAt: Date,
+ currentQuarterEndsAt: Date,
+ termStartedAt: Date,
+ termEndsAt: Date,
+}
+
+export function getYearlyTermStatus(
+ license: License | null,
+): YearlyTermStatus | undefined {
+ if (
+ license === null
+ || license.yearlyCommittedSeats === null
+ || license.yearlyPeakSeats === null
+ || license.yearlyOverageSeats === null
+ || license.yearlyBillableOverageSeats === null
+ || license.yearlyCurrentQuarterNumber === null
+ || license.yearlyTotalQuartersInTerm === null
+ || license.yearlyCurrentQuarterStartedAt === null
+ || license.yearlyCurrentQuarterEndsAt === null
+ || license.yearlyTermStartedAt === null
+ || license.yearlyTermEndsAt === null
+ ) {
+ return undefined;
+ }
+ return {
+ committedSeats: license.yearlyCommittedSeats,
+ peakSeats: license.yearlyPeakSeats,
+ overageSeats: license.yearlyOverageSeats,
+ billableOverageSeats: license.yearlyBillableOverageSeats,
+ currentQuarterNumber: license.yearlyCurrentQuarterNumber,
+ totalQuartersInTerm: license.yearlyTotalQuartersInTerm,
+ currentQuarterStartedAt: license.yearlyCurrentQuarterStartedAt,
+ currentQuarterEndsAt: license.yearlyCurrentQuarterEndsAt,
+ termStartedAt: license.yearlyTermStartedAt,
+ termEndsAt: license.yearlyTermEndsAt,
+ };
+}

packages/db/prisma/migrations/20260509000000_add_license_table/migration.sql

@@ -16,6 +16,16 @@ CREATE TABLE "License" (
  "cancelAt" TIMESTAMP(3),
  "trialEnd" TIMESTAMP(3),
  "hasPaymentMethod" BOOLEAN,
+ "yearlyCommittedSeats" INTEGER,
+ "yearlyCurrentQuarterEndsAt" TIMESTAMP(3),
+ "yearlyCurrentQuarterNumber" INTEGER,
+ "yearlyCurrentQuarterStartedAt" TIMESTAMP(3),
+ "yearlyOverageSeats" INTEGER,
+ "yearlyBillableOverageSeats" INTEGER,
+ "yearlyPeakSeats" INTEGER,
+ "yearlyTermEndsAt" TIMESTAMP(3),
+ "yearlyTermStartedAt" TIMESTAMP(3),
+ "yearlyTotalQuartersInTerm" INTEGER,
  "lastSyncAt" TIMESTAMP(3),
  "lastSyncErrorCode" TEXT,
  "createdAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,

packages/db/prisma/schema.prisma

@@ -315,6 +315,20 @@ model License {
  cancelAt DateTime?
  trialEnd DateTime?
  hasPaymentMethod Boolean?
+
+ // Yearly-only fields, mirroring `yearlyTermStatus` on the lighthouse ping
+ // response. All null for monthly subs and for unactivated/canceled licenses.
+ yearlyTermStartedAt DateTime?
+ yearlyTermEndsAt DateTime?
+ yearlyTotalQuartersInTerm Int?
+ yearlyCurrentQuarterNumber Int?
+ yearlyCurrentQuarterStartedAt DateTime?
+ yearlyCurrentQuarterEndsAt DateTime?
+ yearlyCommittedSeats Int?
+ yearlyOverageSeats Int?
+ yearlyBillableOverageSeats Int?
+ yearlyPeakSeats Int?
+
  lastSyncAt DateTime?
  lastSyncErrorCode String?
  createdAt DateTime @default(now())

packages/web/src/app/(app)/components/banners/bannerResolver.test.ts

@@ -48,6 +48,16 @@ const makeLicense = (overrides: Partial<License> = {}): License => ({
  cancelAt: null,
  trialEnd: null,
  hasPaymentMethod: null,
+ yearlyTermStartedAt: null,
+ yearlyTermEndsAt: null,
+ yearlyTotalQuartersInTerm: null,
+ yearlyCurrentQuarterNumber: null,
+ yearlyCurrentQuarterStartedAt: null,
+ yearlyCurrentQuarterEndsAt: null,
+ yearlyCommittedSeats: null,
+ yearlyOverageSeats: null,
+ yearlyBillableOverageSeats: null,
+ yearlyPeakSeats: null,
  lastSyncAt: NOW,
  lastSyncErrorCode: null,
  createdAt: NOW,

packages/web/src/app/(app)/settings/license/onlineLicenseCard.tsx → packages/web/src/app/(app)/settings/license/onlineLicenseCard/onlineLicenseCard.tsx

@@ -11,6 +11,7 @@ import { cn, formatCurrency } from "@/lib/utils";
 import { LicenseInactiveBanner } from "./licenseInactiveBanner";
 import { PlanActionsMenu } from "./planActionsMenu";
 import { TrialMissingPaymentMethodBanner } from "./trialMissingPaymentMethodBanner";
+import { UpcomingYearlyRenewalBanner } from "./upcomingYearlyRenewalBanner";
 
 interface OnlineLicenseCardProps {
  license: License;
@@ -123,6 +124,18 @@ export function OnlineLicenseCard({ license }: OnlineLicenseCardProps) {
  {isLicenseActive && license.status === 'trialing' && license.hasPaymentMethod === false && (
  <TrialMissingPaymentMethodBanner />
  )}
+ {isLicenseActive
+ && license.interval === 'year'
+ && license.yearlyCurrentQuarterNumber !== null
+ && license.yearlyTotalQuartersInTerm !== null
+ && license.yearlyCurrentQuarterNumber === license.yearlyTotalQuartersInTerm
+ && license.nextRenewalAt !== null
+ && license.seats !== null && (
+ <UpcomingYearlyRenewalBanner
+ renewalAt={license.nextRenewalAt}
+ seats={license.seats}
+ />
+ )}
  </div>
  );
 }

packages/web/src/app/(app)/settings/license/onlineLicenseCard/upcomingYearlyRenewalBanner.tsx

@@ -0,0 +1,89 @@
+"use client";
+
+import { useCallback, useState } from "react";
+import { useRouter } from "next/navigation";
+import { Info } from "lucide-react";
+import { useToast } from "@/components/hooks/use-toast";
+import { createPortalSession } from "@/ee/features/lighthouse/actions";
+import { isServiceError } from "@/lib/utils";
+
+// @note take care to keep this in sync with
+// the value in constants.ts in lighthouse.
+const YEARLY_CANCELLATION_NOTICE_DAYS = 30;
+const DAY_MS = 24 * 60 * 60 * 1000;
+
+interface UpcomingRenewalBannerProps {
+ renewalAt: Date;
+ seats: number;
+}
+
+export function UpcomingYearlyRenewalBanner({ renewalAt, seats }: UpcomingRenewalBannerProps) {
+ const router = useRouter();
+ const { toast } = useToast();
+ const [isOpeningPortal, setIsOpeningPortal] = useState(false);
+ const [nowMs] = useState(() => Date.now());
+
+ const handleCancelClick = useCallback(() => {
+ setIsOpeningPortal(true);
+ createPortalSession().then((response) => {
+ if (isServiceError(response)) {
+ toast({
+ description: `Failed to open subscription portal: ${response.message}`,
+ variant: "destructive",
+ });
+ setIsOpeningPortal(false);
+ return;
+ }
+ router.push(response.url);
+ });
+ }, [router, toast]);
+
+ const daysUntilRenewal = (renewalAt.getTime() - nowMs) / DAY_MS;
+ const noticeDeadlineHasPassed = daysUntilRenewal < YEARLY_CANCELLATION_NOTICE_DAYS;
+ const noticeDeadline = new Date(renewalAt.getTime() - YEARLY_CANCELLATION_NOTICE_DAYS * DAY_MS);
+
+ return (
+ <div className="flex items-start gap-3 border-t bg-blue-500/10 px-4 py-2.5">
+ <Info className="h-4 w-4 mt-0.5 flex-shrink-0 text-blue-400" />
+ <div className="text-sm">
+ <p>
+ <span className="font-medium">
+ Auto-renewing on {formatDate(renewalAt)}
+ </span>{" "}
+ <span className="text-muted-foreground">
+ with {seats} {seats === 1 ? 'seat' : 'seats'}.
+ </span>
+ </p>
+ {!noticeDeadlineHasPassed && (
+ <p className="text-muted-foreground mt-1">
+ You have until {formatDate(noticeDeadline)} to{" "}
+ <button
+ type="button"
+ onClick={handleCancelClick}
+ disabled={isOpeningPortal}
+ className="text-link hover:underline disabled:opacity-50"
+ >
+ cancel
+ </button>{" "}
+ your subscription or{" "}
+ <a
+ href="mailto:ar@sourcebot.dev"
+ className="text-link hover:underline"
+ >
+ request
+ </a>{" "}
+ a different seat count for renewal.
+ </p>
+ )}
+ </div>
+ </div>
+ );
+}
+
+function formatDate(date: Date): string {
+ return new Date(date).toLocaleDateString('en-US', {
+ month: 'short',
+ day: 'numeric',
+ year: 'numeric',
+ });
+}

packages/web/src/app/(app)/settings/license/page.tsx

@@ -5,14 +5,16 @@ import { Button } from "@/components/ui/button";
 import { ExternalLink } from "lucide-react";
 import { redirect } from "next/navigation";
 import { ActivationCodeCard } from "./activationCodeCard";
-import { OnlineLicenseCard } from "./onlineLicenseCard";
+import { OnlineLicenseCard } from "./onlineLicenseCard/onlineLicenseCard";
 import { OfflineLicenseCard } from "./offlineLicenseCard";
 import { RecentInvoicesCard } from "./recentInvoicesCard";
+import { YearlyTermSeatsUsageCard } from "./yearlyTermSeatsUsageCard";
 import { SettingsCard } from "../components/settingsCard";
 import { UpsellPanel } from "@/ee/features/lighthouse/upsellDialog";
 import { getAllInvoices } from "@/ee/features/lighthouse/actions";
 import { syncWithLighthouse } from "@/ee/features/lighthouse/servicePing";
 import { isServiceError } from "@/lib/utils";
+import { getYearlyTermStatus } from "./types";
 
 type LicensePageProps = {
  searchParams?: Promise<Record<string, string | string[] | undefined>>;
@@ -36,6 +38,7 @@ export default authenticatedPage<LicensePageProps>(async ({ prisma, org }, props
  redirect(suffix ? `/settings/license?${suffix}` : '/settings/license');
  }
 
+
  const offlineLicense = getOfflineLicenseMetadata();
  const isOfflineLicenseExpired = offlineLicense
  ? new Date(offlineLicense.expiryDate).getTime() < Date.now()
@@ -45,6 +48,9 @@ export default authenticatedPage<LicensePageProps>(async ({ prisma, org }, props
  ? null
  : await prisma.license.findUnique({ where: { orgId: org.id } });
 
+ const yearlyTermStatus = getYearlyTermStatus(license);
+ const currentUserCount = await prisma.userToOrg.count({ where: { orgId: org.id } });
+
  const invoicesResult = license ? await getAllInvoices() : null;
  const invoices = invoicesResult && !isServiceError(invoicesResult) ? invoicesResult : [];
 
@@ -87,6 +93,13 @@ export default authenticatedPage<LicensePageProps>(async ({ prisma, org }, props
  <OfflineLicenseCard license={offlineLicense} isExpired={isOfflineLicenseExpired} />
  )}
  {license && <OnlineLicenseCard license={license} />}
+ {license
+ && yearlyTermStatus && (
+ <YearlyTermSeatsUsageCard
+ currentUsers={currentUserCount}
+ status={yearlyTermStatus}
+ />
+ )}
  {!offlineLicense && !license && <ActivationCodeCard />}
  {license && <RecentInvoicesCard invoices={invoices} />}
  </div>

packages/web/src/app/(app)/settings/license/types.ts

@@ -0,0 +1,41 @@
+import { YearlyTermStatus as RawYearlyTermStatus } from "@/ee/features/lighthouse/types";
+import { License } from "@sourcebot/db";
+
+export type YearlyTermStatus = Omit<RawYearlyTermStatus, 'currentQuarterStartedAt' | 'currentQuarterEndsAt' | 'termStartedAt' | 'termEndsAt'> & {
+ currentQuarterStartedAt: Date,
+ currentQuarterEndsAt: Date,
+ termStartedAt: Date,
+ termEndsAt: Date,
+}
+
+export function getYearlyTermStatus(
+ license: License | null,
+): YearlyTermStatus | undefined {
+ if (
+ license === null
+ || license.yearlyCommittedSeats === null
+ || license.yearlyPeakSeats === null
+ || license.yearlyOverageSeats === null
+ || license.yearlyBillableOverageSeats === null
+ || license.yearlyCurrentQuarterNumber === null
+ || license.yearlyTotalQuartersInTerm === null
+ || license.yearlyCurrentQuarterStartedAt === null
+ || license.yearlyCurrentQuarterEndsAt === null
+ || license.yearlyTermStartedAt === null
+ || license.yearlyTermEndsAt === null
+ ) {
+ return undefined;
+ }
+ return {
+ committedSeats: license.yearlyCommittedSeats,
+ peakSeats: license.yearlyPeakSeats,
+ overageSeats: license.yearlyOverageSeats,
+ billableOverageSeats: license.yearlyBillableOverageSeats,
+ currentQuarterNumber: license.yearlyCurrentQuarterNumber,
+ totalQuartersInTerm: license.yearlyTotalQuartersInTerm,
+ currentQuarterStartedAt: license.yearlyCurrentQuarterStartedAt,
+ currentQuarterEndsAt: license.yearlyCurrentQuarterEndsAt,
+ termStartedAt: license.yearlyTermStartedAt,
+ termEndsAt: license.yearlyTermEndsAt,
+ };
+}