Promotions : publication programmée et affichage limité à la période

Deux comportements demandés :

1. Une promotion n'apparaît sur le site que pendant sa période de validité.
   Les lectures publiques passent par `VISIBLE_PROMO` (`src/lib/queries.ts`) :
   statut `live` **et** fenêtre `starts_on` / `ends_on`, journée calculée en
   Europe/Paris pour qu'un conteneur en UTC ne retire pas une offre deux
   heures trop tôt. Le statut n'est pas touché : hors période, le backoffice
   explique pourquoi l'offre n'est pas visible (`visibilityNote`) et elle
   revient d'elle-même si les dates changent.

2. La publication peut être programmée. `promotions.publish_at` : l'adhérent
   propose une date, le modérateur la garde, la déplace ou la vide dans le
   formulaire « Valider ». Avec une échéance future la promotion passe au
   statut `scheduled` — rien n'est visible, rien n'est diffusé — et
   `releaseDuePromotions()` fait la bascule à l'heure dite, site et réseaux
   ensemble. Un bouton « Publier maintenant » court-circuite l'attente.

Mécanique :
- `src/lib/promo-schedule.ts` (pur, testé) : conversion `datetime-local` ⇄
  heure de l'association, changements d'heure compris, et refus d'une saisie
  illisible plutôt qu'une publication immédiate involontaire.
- `src/lib/promo-publish.ts` reprend `publishPromoShares()` : deux appelants
  désormais, une action serveur et la boucle de libération, qui n'a pas de
  requête et ne peut donc pas appeler `revalidatePath()`. Idem pour
  `logActivity()` dans `src/lib/activity-log.ts`.
- La bascule `scheduled → live` est un `UPDATE … RETURNING` filtré sur le
  statut : atomique, donc pas de double publication même à plusieurs
  instances, en plus de la garde existante sur `social_posts`.
- Déclencheur : `src/instrumentation.ts`, boucle d'une minute avec rattrapage
  au démarrage (`PROMO_SCHEDULER=off` la désactive). Le travail vit dans
  `instrumentation-node.ts`, écarté du bundle edge par `next.config.mjs` :
  Next compile aussi l'instrumentation pour le middleware, où `pg` ne peut
  pas être embarqué.

Migration 0016 : `promo_status += 'scheduled'`, `promotions.publish_at`.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01QXNXRC4j5VLfKvpyyisrnb

tests/promo-schedule.test.ts

@@ -0,0 +1,67 @@
+import test from "node:test";
+import assert from "node:assert/strict";
+import {
+  formatSchedule,
+  isDue,
+  isPending,
+  parseScheduleInput,
+  scheduleLabel,
+  toScheduleInput,
+} from "../src/lib/promo-schedule";
+
+test("programmation — champ vide = publication immédiate", () => {
+  assert.equal(parseScheduleInput(""), null);
+  assert.equal(parseScheduleInput(null), null);
+  assert.equal(parseScheduleInput("   "), null);
+  assert.equal(isDue(null), true);
+});
+
+test("programmation — heure d'hiver interprétée en heure de Paris (UTC+1)", () => {
+  const d = parseScheduleInput("2027-01-15T09:00");
+  assert.ok(d);
+  assert.equal(d.toISOString(), "2027-01-15T08:00:00.000Z");
+});
+
+test("programmation — heure d'été interprétée en heure de Paris (UTC+2)", () => {
+  const d = parseScheduleInput("2027-07-15T09:00");
+  assert.ok(d);
+  assert.equal(d.toISOString(), "2027-07-15T07:00:00.000Z");
+});
+
+test("programmation — minuit ne bascule pas d'un jour", () => {
+  const d = parseScheduleInput("2027-03-10T00:00");
+  assert.ok(d);
+  assert.equal(d.toISOString(), "2027-03-09T23:00:00.000Z");
+});
+
+test("programmation — aller-retour avec le champ du formulaire", () => {
+  for (const value of ["2027-01-15T09:00", "2027-07-15T18:30", "2027-12-31T23:45"]) {
+    assert.equal(toScheduleInput(parseScheduleInput(value)), value);
+  }
+  assert.equal(toScheduleInput(null), "");
+});
+
+test("programmation — une saisie illisible est refusée, jamais ignorée", () => {
+  assert.throws(() => parseScheduleInput("demain matin"));
+  assert.throws(() => parseScheduleInput("2027-13-45T99:99"));
+  assert.throws(() => parseScheduleInput("2027-01-15"));
+});
+
+test("programmation — échéance atteinte", () => {
+  const at = new Date("2027-01-15T08:00:00.000Z");
+  assert.equal(isDue(at, new Date("2027-01-15T07:59:59.000Z")), false);
+  assert.equal(isDue(at, at), true);
+  assert.equal(isDue(at, new Date("2027-01-15T08:00:01.000Z")), true);
+  assert.equal(isPending(at, new Date("2027-01-15T07:00:00.000Z")), true);
+});
+
+test("programmation — libellé en heure de Paris", () => {
+  assert.equal(formatSchedule(new Date("2027-01-15T08:00:00.000Z")), "le 15 janvier 2027 à 09:00");
+  assert.equal(formatSchedule(new Date("2027-07-15T07:00:00.000Z")), "le 15 juillet 2027 à 09:00");
+  assert.equal(formatSchedule(null), null);
+  assert.equal(
+    scheduleLabel(new Date("2027-01-15T08:00:00.000Z")),
+    "Publication programmée le 15 janvier 2027 à 09:00"
+  );
+  assert.equal(scheduleLabel(null), null);
+});

tests/promo-validity.test.ts

@@ -5,7 +5,9 @@ import {
   formatValidity,
   formatValidityShort,
   isExpired,
+  isNotStarted,
   isRangeInvalid,
+  visibilityNote,
 } from "../src/lib/promo-validity";
 
 describe("Période de validité d'une promotion", () => {
@@ -74,3 +76,25 @@ describe("Période de validité d'une promotion", () => {
     assert.equal(isRangeInvalid({ startsOn: "2027-06-01" }), false);
   });
 });
+
+describe("Visibilité publique d'une promotion", () => {
+  it("distingue avant, pendant et après la période", () => {
+    const promo = { startsOn: "2027-03-01", endsOn: "2027-03-15" };
+    assert.equal(
+      visibilityNote(promo, new Date("2027-02-20T12:00:00Z")),
+      "Pas encore affichée : elle apparaîtra sur le site le 1er mars 2027."
+    );
+    assert.equal(visibilityNote(promo, new Date("2027-03-01T00:00:00Z")), null);
+    assert.equal(visibilityNote(promo, new Date("2027-03-15T23:00:00Z")), null);
+    assert.equal(
+      visibilityNote(promo, new Date("2027-03-16T08:00:00Z")),
+      "Période terminée le 15 mars 2027 : elle n'apparaît plus sur le site."
+    );
+  });
+
+  it("laisse visible une offre sans date", () => {
+    assert.equal(visibilityNote({ startsOn: null, endsOn: null }), null);
+    assert.equal(visibilityNote({ validUntil: "Ce week-end" }), null);
+    assert.equal(isNotStarted({ startsOn: null }), false);
+  });
+});