Sync public snapshot from freebuff-private

Source: CodebuffAI/freebuff-private@013a92699e0c98cb3a4febd54cff29ac9966f862

Author: github-actions[bot]

common/src/ads/billboard.ts

@@ -51,19 +51,42 @@ export const BILLBOARD_DISMISS_LOCK_MS = 10_000
 /** A pause in typing/clicking that may open a closed panel for its billboard. */
 export const BILLBOARD_PANEL_IDLE_MS = 3_000
 
+export type BillboardFrequencyCap = {
+  /** Whose serves share one count: the campaign's, or a single ad's. */
+  per: 'campaign' | 'ad'
+  /** Every limit must have room. The first is the slot's daily allowance. */
+  limits: readonly { maxImpressions: number; windowMs: number }[]
+}
+
+const HOUR_MS = 60 * 60_000
+const DAY_MS = 24 * HOUR_MS
+
 /**
- * The frequency cap on a billboard serve: per user, per campaign, per slot
- * (sidebar and panel each), over a rolling day. It REPLACES the campaign's
- * own cap and the hourly ad and advertiser caps for these serves, which count
- * serves rather than screen time: a billboard stays up for up to
+ * The frequency cap on each billboard slot, per user. It REPLACES the
+ * campaign's own cap and the hourly ad and advertiser caps for these serves,
+ * which count serves rather than screen time: a billboard stays up for up to
  * {@link BILLBOARD_REFRESH_MS}, so an hourly cap still let one campaign hold
  * the sidebar all day. Billboard serves therefore do not spend the
  * campaign's hourly cap on its other placements either.
+ *
+ * - The sidebar serves each campaign 3 times a rolling day, at most once an
+ *   hour, so a day's allowance cannot all land in one sitting.
+ * - The panel takes over the right panel, so the same ad opens it at most
+ *   once a day.
  */
-export const BILLBOARD_DAILY_FREQUENCY_CAP = {
-  maxImpressions: 5,
-  windowMs: 24 * 60 * 60_000,
-} as const
+export const BILLBOARD_FREQUENCY_CAPS: Readonly<Record<string, BillboardFrequencyCap>> = {
+  [BILLBOARD_SIDEBAR_PLACEMENT_ID]: {
+    per: 'campaign',
+    limits: [
+      { maxImpressions: 3, windowMs: DAY_MS },
+      { maxImpressions: 1, windowMs: HOUR_MS },
+    ],
+  },
+  [BILLBOARD_PANEL_PLACEMENT_ID]: {
+    per: 'ad',
+    limits: [{ maxImpressions: 1, windowMs: DAY_MS }],
+  },
+}
 
 export type BillboardAsset = { url: string; width: number; height: number }
 export type BillboardAssets = Partial<Record<BillboardShape, BillboardAsset>>