@commonpub/server 2.88.0 → 2.90.0

package/dist/contest/submissions.js

@@ -0,0 +1,275 @@
+import { eq, and, sql } from 'drizzle-orm';
+import { contests, contestEntries, contestAgreementAcceptances, contestEntryPrivateFields, } from '@commonpub/schema';
+import { countRows } from '../query.js';
+import { createContent, deleteContent } from '../content/content.js';
+import { normalizeStages, currentStage, isEliminated } from './stages.js';
+import { validateSubmissionFields, hashTerms } from './validation.js';
+// DB-backed submission writers. Pure validation/partition lives in validation.ts.
+/**
+ * Persist the PII + agreement halves of a partitioned submission within an open
+ * transaction. PII is upserted (one row per entry, merged with any prior PII so
+ * a later stage's PII doesn't wipe an earlier stage's); agreements are appended
+ * as immutable acceptance rows (terms hash + snapshot). No-op when both empty.
+ */
+export async function recordPrivateAndAgreements(tx, args) {
+    const { contestId, entryId, userId, stageId, pii, agreements, ip } = args;
+    if (Object.keys(pii).length > 0) {
+        const [existing] = await tx
+            .select({ fields: contestEntryPrivateFields.fields })
+            .from(contestEntryPrivateFields)
+            .where(eq(contestEntryPrivateFields.entryId, entryId))
+            .for('update');
+        const merged = { ...(existing?.fields ?? {}), ...pii };
+        await tx
+            .insert(contestEntryPrivateFields)
+            .values({ contestId, entryId, userId, fields: merged })
+            .onConflictDoUpdate({
+            target: contestEntryPrivateFields.entryId,
+            set: { fields: merged, updatedAt: new Date() },
+        });
+    }
+    if (agreements.length > 0) {
+        await tx.insert(contestAgreementAcceptances).values(agreements.map((a) => ({
+            contestId,
+            entryId,
+            userId,
+            stageId,
+            fieldKey: a.fieldKey,
+            termsHash: hashTerms(a.terms),
+            termsSnapshot: a.terms,
+            ip: ip ?? null,
+        })));
+    }
+}
+/**
+ * Submit (or update) an entrant's per-stage artifact: the filled template
+ * values for one `submission` stage, snapshotted onto the entry's
+ * `stageSubmissions`. Owner-only. The stage must be the contest's CURRENT
+ * stage while the contest is `active` (status stays the gating truth — the
+ * organizer maps a later submission round back to `active` when advancing).
+ * Re-submitting while the stage is open replaces that stage's artifact.
+ * Cohort gate: an entry culled at a prior review stage can no longer submit.
+ */
+export async function submitStageArtifact(db, entryId, stageId, fields, userId, ip) {
+    const fail = (error) => ({ submitted: false, error });
+    const existing = await db
+        .select({
+        contestId: contestEntries.contestId,
+        entrantId: contestEntries.userId,
+        stageState: contestEntries.stageState,
+        contestStatus: contests.status,
+        stages: contests.stages,
+        currentStageId: contests.currentStageId,
+        startDate: contests.startDate,
+        endDate: contests.endDate,
+        judgingEndDate: contests.judgingEndDate,
+    })
+        .from(contestEntries)
+        .innerJoin(contests, eq(contestEntries.contestId, contests.id))
+        .where(eq(contestEntries.id, entryId))
+        .limit(1);
+    if (existing.length === 0)
+        return fail('Entry not found');
+    const row = existing[0];
+    if (row.entrantId !== userId)
+        return fail('Not the entry owner');
+    if (row.contestStatus !== 'active') {
+        return fail('Stage submissions are only open while the contest is active');
+    }
+    const source = {
+        status: row.contestStatus,
+        startDate: row.startDate,
+        endDate: row.endDate,
+        judgingEndDate: row.judgingEndDate,
+        stages: row.stages,
+        currentStageId: row.currentStageId,
+    };
+    const stages = normalizeStages(source);
+    const stage = stages.find((s) => s.id === stageId);
+    if (!stage)
+        return fail('Unknown stage');
+    if (stage.kind !== 'submission')
+        return fail('This stage does not accept submissions');
+    const template = stage.submissionTemplate ?? [];
+    if (template.length === 0)
+        return fail('This stage has no submission template');
+    const current = currentStage(source);
+    if (current?.id !== stageId)
+        return fail('This stage is not currently open');
+    // Cohort gate: once a review cut culled the field, eliminated entries are
+    // out of every later round (mirrors judgeContestEntry's gate).
+    if (isEliminated({ stageState: row.stageState })) {
+        return fail('This entry was not advanced and can no longer submit');
+    }
+    const validated = validateSubmissionFields(template, fields);
+    if (!validated.ok)
+        return fail(validated.error);
+    const { artifact, pii, agreements } = validated.result;
+    // Atomic read-modify-write: lock the entry row so two concurrent saves of
+    // the same artifact can't clobber each other (same pattern as judgeScores).
+    // PII + agreements (if the template has any) are persisted in the SAME tx so
+    // they can never land in the public stageSubmissions jsonb.
+    return db.transaction(async (tx) => {
+        const [locked] = await tx
+            .select({ stageSubmissions: contestEntries.stageSubmissions })
+            .from(contestEntries)
+            .where(eq(contestEntries.id, entryId))
+            .for('update');
+        const submissions = (locked?.stageSubmissions ?? []);
+        const record = { stageId, fields: artifact, submittedAt: new Date().toISOString() };
+        const idx = submissions.findIndex((s) => s.stageId === stageId);
+        if (idx >= 0)
+            submissions[idx] = record;
+        else
+            submissions.push(record);
+        await tx
+            .update(contestEntries)
+            .set({ stageSubmissions: submissions })
+            .where(eq(contestEntries.id, entryId));
+        await recordPrivateAndAgreements(tx, { contestId: row.contestId, entryId, userId, stageId, pii, agreements, ip });
+        return { submitted: true, stageSubmissions: submissions };
+    });
+}
+// --- Form-first proposal submissions (Phase 4) ---
+/** Content types a placeholder proposal project may be created as. */
+const PLACEHOLDER_TYPES = ['project', 'blog', 'explainer'];
+/**
+ * Form-first proposal submission (Phase 4). For a `submission` stage in
+ * `proposal` mode: validate the form, create a DRAFT placeholder project, link a
+ * contest entry to it (relaxing the published-only gate that `submitContestEntry`
+ * enforces), snapshot the artifact, record agreement acceptances, store PII in
+ * the private table, and bump `entryCount`. The placeholder + the entry +
+ * PII/agreements are written atomically: the placeholder is created first, then
+ * the entry tx; if the entry tx fails the placeholder is removed (compensating
+ * delete) so a failed submit never leaves an orphan draft.
+ *
+ * Flag (`features.contestProposals`) is enforced at the route; this fn enforces
+ * the structural gate that the target stage is current + proposal-mode.
+ */
+export async function submitContestProposal(db, args) {
+    const { contestId, stageId, fields, userId, ip } = args;
+    const fail = (error) => ({ ok: false, error });
+    const [contest] = await db
+        .select({
+        id: contests.id,
+        title: contests.title,
+        status: contests.status,
+        stages: contests.stages,
+        currentStageId: contests.currentStageId,
+        startDate: contests.startDate,
+        endDate: contests.endDate,
+        judgingEndDate: contests.judgingEndDate,
+        maxEntriesPerUser: contests.maxEntriesPerUser,
+        eligibleContentTypes: contests.eligibleContentTypes,
+    })
+        .from(contests)
+        .where(eq(contests.id, contestId))
+        .limit(1);
+    if (!contest)
+        return fail('Contest not found');
+    if (contest.status !== 'active')
+        return fail('Proposals are only open while the contest is active');
+    const source = {
+        status: contest.status,
+        startDate: contest.startDate,
+        endDate: contest.endDate,
+        judgingEndDate: contest.judgingEndDate,
+        stages: contest.stages,
+        currentStageId: contest.currentStageId,
+    };
+    const stage = normalizeStages(source).find((s) => s.id === stageId);
+    if (!stage)
+        return fail('Unknown stage');
+    if (stage.kind !== 'submission')
+        return fail('This stage does not accept submissions');
+    if (stage.submissionMode !== 'proposal')
+        return fail('This stage is not accepting proposals');
+    if (currentStage(source)?.id !== stageId)
+        return fail('This stage is not currently open');
+    const template = stage.submissionTemplate ?? [];
+    const validated = validateSubmissionFields(template, fields);
+    if (!validated.ok)
+        return fail(validated.error);
+    const { artifact, pii, agreements } = validated.result;
+    // Per-user entry cap (mirrors submitContestEntry).
+    if (contest.maxEntriesPerUser != null) {
+        const existing = await countRows(db, contestEntries, and(eq(contestEntries.contestId, contestId), eq(contestEntries.userId, userId)));
+        if (existing >= contest.maxEntriesPerUser)
+            return fail('You have reached the entry limit for this contest');
+    }
+    // Pick the placeholder content type: the contest's first eligible type when
+    // it's one we can create, else a project.
+    const eligible = (contest.eligibleContentTypes ?? []).find((t) => PLACEHOLDER_TYPES.includes(t));
+    const placeholderType = (eligible ?? 'project');
+    const title = artifact.title?.trim() || `${contest.title} proposal`;
+    // 1) Create the DRAFT placeholder (its own writes). The entrant develops it in
+    //    the editor; the proposal text lives in the stage artifact below.
+    const placeholder = await createContent(db, userId, { type: placeholderType, title });
+    // 2) Link the entry + persist artifact/PII/agreements/count atomically. On any
+    //    failure, remove the placeholder so a failed submit leaves nothing behind.
+    try {
+        const entryId = await db.transaction(async (tx) => {
+            const [inserted] = await tx
+                .insert(contestEntries)
+                .values({
+                contestId,
+                contentId: placeholder.id,
+                userId,
+                stageSubmissions: [{ stageId, fields: artifact, submittedAt: new Date().toISOString() }],
+            })
+                .onConflictDoNothing()
+                .returning({ id: contestEntries.id });
+            if (!inserted)
+                throw new Error('entry-conflict');
+            await tx
+                .update(contests)
+                .set({ entryCount: sql `${contests.entryCount} + 1` })
+                .where(eq(contests.id, contestId));
+            await recordPrivateAndAgreements(tx, { contestId, entryId: inserted.id, userId, stageId, pii, agreements, ip });
+            return inserted.id;
+        });
+        return { ok: true, entryId, projectSlug: placeholder.slug, contentId: placeholder.id, contentType: placeholder.type };
+    }
+    catch (err) {
+        await deleteContent(db, placeholder.id, userId).catch(() => { });
+        if (err instanceof Error && err.message === 'entry-conflict') {
+            return fail('You already have an entry for this contest');
+        }
+        throw err;
+    }
+}
+/**
+ * Read an entry's PII + agreement acceptances. NEVER reachable through the
+ * normal entries endpoints — the calling route gates this on the `contest.pii`
+ * permission OR the requester being the entrant. Returns null when the entry has
+ * no stored PII and no agreements.
+ */
+export async function getEntryPrivateData(db, entryId) {
+    const [priv] = await db
+        .select()
+        .from(contestEntryPrivateFields)
+        .where(eq(contestEntryPrivateFields.entryId, entryId))
+        .limit(1);
+    const agreements = await db
+        .select({
+        fieldKey: contestAgreementAcceptances.fieldKey,
+        stageId: contestAgreementAcceptances.stageId,
+        termsHash: contestAgreementAcceptances.termsHash,
+        termsSnapshot: contestAgreementAcceptances.termsSnapshot,
+        acceptedAt: contestAgreementAcceptances.acceptedAt,
+        ip: contestAgreementAcceptances.ip,
+    })
+        .from(contestAgreementAcceptances)
+        .where(eq(contestAgreementAcceptances.entryId, entryId));
+    if (!priv && agreements.length === 0)
+        return null;
+    return {
+        contestId: priv?.contestId ?? '',
+        entryId,
+        userId: priv?.userId ?? '',
+        fields: (priv?.fields ?? {}),
+        updatedAt: priv?.updatedAt ?? new Date(0),
+        agreements,
+    };
+}
+//# sourceMappingURL=submissions.js.map

package/dist/contest/submissions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"submissions.js","sourceRoot":"","sources":["../../src/contest/submissions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EACL,QAAQ,EACR,cAAc,EACd,2BAA2B,EAC3B,yBAAyB,GAC1B,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACrE,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC1E,OAAO,EAAE,wBAAwB,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAGtE,kFAAkF;AAElF;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAC9C,EAAa,EACb,IAQC;IAED,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,EAAE,UAAU,EAAE,EAAE,EAAE,GAAG,IAAI,CAAC;IAE1E,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAChC,MAAM,CAAC,QAAQ,CAAC,GAAG,MAAM,EAAE;aACxB,MAAM,CAAC,EAAE,MAAM,EAAE,yBAAyB,CAAC,MAAM,EAAE,CAAC;aACpD,IAAI,CAAC,yBAAyB,CAAC;aAC/B,KAAK,CAAC,EAAE,CAAC,yBAAyB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;aACrD,GAAG,CAAC,QAAQ,CAAC,CAAC;QACjB,MAAM,MAAM,GAAG,EAAE,GAAG,CAAC,QAAQ,EAAE,MAAM,IAAI,EAAE,CAAC,EAAE,GAAG,GAAG,EAAE,CAAC;QACvD,MAAM,EAAE;aACL,MAAM,CAAC,yBAAyB,CAAC;aACjC,MAAM,CAAC,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;aACtD,kBAAkB,CAAC;YAClB,MAAM,EAAE,yBAAyB,CAAC,OAAO;YACzC,GAAG,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,IAAI,EAAE,EAAE;SAC/C,CAAC,CAAC;IACP,CAAC;IAED,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC1B,MAAM,EAAE,CAAC,MAAM,CAAC,2BAA2B,CAAC,CAAC,MAAM,CACjD,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACrB,SAAS;YACT,OAAO;YACP,MAAM;YACN,OAAO;YACP,QAAQ,EAAE,CAAC,CAAC,QAAQ;YACpB,SAAS,EAAE,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC;YAC7B,aAAa,EAAE,CAAC,CAAC,KAAK;YACtB,EAAE,EAAE,EAAE,IAAI,IAAI;SACf,CAAC,CAAC,CACJ,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,EAAM,EACN,OAAe,EACf,OAAe,EACf,MAA8B,EAC9B,MAAc,EACd,EAAkB;IAElB,MAAM,IAAI,GAAG,CAAC,KAAa,EAAE,EAAE,CAAC,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;IAE9D,MAAM,QAAQ,GAAG,MAAM,EAAE;SACtB,MAAM,CAAC;QACN,SAAS,EAAE,cAAc,CAAC,SAAS;QACnC,SAAS,EAAE,cAAc,CAAC,MAAM;QAChC,UAAU,EAAE,cAAc,CAAC,UAAU;QACrC,aAAa,EAAE,QAAQ,CAAC,MAAM;QAC9B,MAAM,EAAE,QAAQ,CAAC,MAAM;QACvB,cAAc,EAAE,QAAQ,CAAC,cAAc;QACvC,SAAS,EAAE,QAAQ,CAAC,SAAS;QAC7B,OAAO,EAAE,QAAQ,CAAC,OAAO;QACzB,cAAc,EAAE,QAAQ,CAAC,cAAc;KACxC,CAAC;SACD,IAAI,CAAC,cAAc,CAAC;SACpB,SAAS,CAAC,QAAQ,EAAE,EAAE,CAAC,cAAc,CAAC,SAAS,EAAE,QAAQ,CAAC,EAAE,CAAC,CAAC;SAC9D,KAAK,CAAC,EAAE,CAAC,cAAc,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;SACrC,KAAK,CAAC,CAAC,CAAC,CAAC;IAEZ,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC,iBAAiB,CAAC,CAAC;IAC1D,MAAM,GAAG,GAAG,QAAQ,CAAC,CAAC,CAAE,CAAC;IACzB,IAAI,GAAG,CAAC,SAAS,KAAK,MAAM;QAAE,OAAO,IAAI,CAAC,qBAAqB,CAAC,CAAC;IAEjE,IAAI,GAAG,CAAC,aAAa,KAAK,QAAQ,EAAE,CAAC;QACnC,OAAO,IAAI,CAAC,6DAA6D,CAAC,CAAC;IAC7E,CAAC;IAED,MAAM,MAAM,GAAgB;QAC1B,MAAM,EAAE,GAAG,CAAC,aAAa;QACzB,SAAS,EAAE,GAAG,CAAC,SAAS;QACxB,OAAO,EAAE,GAAG,CAAC,OAAO;QACpB,cAAc,EAAE,GAAG,CAAC,cAAc;QAClC,MAAM,EAAE,GAAG,CAAC,MAAM;QAClB,cAAc,EAAE,GAAG,CAAC,cAAc;KACnC,CAAC;IACF,MAAM,MAAM,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC;IACvC,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,OAAO,CAAC,CAAC;IACnD,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC,eAAe,CAAC,CAAC;IACzC,IAAI,KAAK,CAAC,IAAI,KAAK,YAAY;QAAE,OAAO,IAAI,CAAC,wCAAwC,CAAC,CAAC;IACvF,MAAM,QAAQ,GAAG,KAAK,CAAC,kBAAkB,IAAI,EAAE,CAAC;IAChD,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC,uCAAuC,CAAC,CAAC;IAEhF,MAAM,OAAO,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC;IACrC,IAAI,OAAO,EAAE,EAAE,KAAK,OAAO;QAAE,OAAO,IAAI,CAAC,kCAAkC,CAAC,CAAC;IAE7E,0EAA0E;IAC1E,+DAA+D;IAC/D,IAAI,YAAY,CAAC,EAAE,UAAU,EAAE,GAAG,CAAC,UAAU,EAAE,CAAC,EAAE,CAAC;QACjD,OAAO,IAAI,CAAC,sDAAsD,CAAC,CAAC;IACtE,CAAC;IAED,MAAM,SAAS,GAAG,wBAAwB,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IAC7D,IAAI,CAAC,SAAS,CAAC,EAAE;QAAE,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IAChD,MAAM,EAAE,QAAQ,EAAE,GAAG,EAAE,UAAU,EAAE,GAAG,SAAS,CAAC,MAAM,CAAC;IAEvD,0EAA0E;IAC1E,4EAA4E;IAC5E,6EAA6E;IAC7E,4DAA4D;IAC5D,OAAO,EAAE,CAAC,WAAW,CAAC,KAAK,EAAE,EAAE,EAAE,EAAE;QACjC,MAAM,CAAC,MAAM,CAAC,GAAG,MAAM,EAAE;aACtB,MAAM,CAAC,EAAE,gBAAgB,EAAE,cAAc,CAAC,gBAAgB,EAAE,CAAC;aAC7D,IAAI,CAAC,cAAc,CAAC;aACpB,KAAK,CAAC,EAAE,CAAC,cAAc,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;aACrC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAEjB,MAAM,WAAW,GAAG,CAAC,MAAM,EAAE,gBAAgB,IAAI,EAAE,CAA6B,CAAC;QACjF,MAAM,MAAM,GAA2B,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,CAAC;QAC5G,MAAM,GAAG,GAAG,WAAW,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,KAAK,OAAO,CAAC,CAAC;QAChE,IAAI,GAAG,IAAI,CAAC;YAAE,WAAW,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC;;YACnC,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAE9B,MAAM,EAAE;aACL,MAAM,CAAC,cAAc,CAAC;aACtB,GAAG,CAAC,EAAE,gBAAgB,EAAE,WAAW,EAAE,CAAC;aACtC,KAAK,CAAC,EAAE,CAAC,cAAc,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC,CAAC;QAEzC,MAAM,0BAA0B,CAAC,EAAE,EAAE,EAAE,SAAS,EAAE,GAAG,CAAC,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC,CAAC;QAElH,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,gBAAgB,EAAE,WAAW,EAAE,CAAC;IAC5D,CAAC,CAAC,CAAC;AACL,CAAC;AAED,oDAAoD;AAEpD,sEAAsE;AACtE,MAAM,iBAAiB,GAA2B,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC;AAmBnF;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,EAAM,EAAE,IAAwB;IAC1E,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,GAAG,IAAI,CAAC;IACxD,MAAM,IAAI,GAAG,CAAC,KAAa,EAAwB,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;IAE7E,MAAM,CAAC,OAAO,CAAC,GAAG,MAAM,EAAE;SACvB,MAAM,CAAC;QACN,EAAE,EAAE,QAAQ,CAAC,EAAE;QACf,KAAK,EAAE,QAAQ,CAAC,KAAK;QACrB,MAAM,EAAE,QAAQ,CAAC,MAAM;QACvB,MAAM,EAAE,QAAQ,CAAC,MAAM;QACvB,cAAc,EAAE,QAAQ,CAAC,cAAc;QACvC,SAAS,EAAE,QAAQ,CAAC,SAAS;QAC7B,OAAO,EAAE,QAAQ,CAAC,OAAO;QACzB,cAAc,EAAE,QAAQ,CAAC,cAAc;QACvC,iBAAiB,EAAE,QAAQ,CAAC,iBAAiB;QAC7C,oBAAoB,EAAE,QAAQ,CAAC,oBAAoB;KACpD,CAAC;SACD,IAAI,CAAC,QAAQ,CAAC;SACd,KAAK,CAAC,EAAE,CAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,CAAC,CAAC;SACjC,KAAK,CAAC,CAAC,CAAC,CAAC;IAEZ,IAAI,CAAC,OAAO;QAAE,OAAO,IAAI,CAAC,mBAAmB,CAAC,CAAC;IAC/C,IAAI,OAAO,CAAC,MAAM,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC,qDAAqD,CAAC,CAAC;IAEpG,MAAM,MAAM,GAAgB;QAC1B,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,cAAc,EAAE,OAAO,CAAC,cAAc;QACtC,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,cAAc,EAAE,OAAO,CAAC,cAAc;KACvC,CAAC;IACF,MAAM,KAAK,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,OAAO,CAAC,CAAC;IACpE,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC,eAAe,CAAC,CAAC;IACzC,IAAI,KAAK,CAAC,IAAI,KAAK,YAAY;QAAE,OAAO,IAAI,CAAC,wCAAwC,CAAC,CAAC;IACvF,IAAI,KAAK,CAAC,cAAc,KAAK,UAAU;QAAE,OAAO,IAAI,CAAC,uCAAuC,CAAC,CAAC;IAC9F,IAAI,YAAY,CAAC,MAAM,CAAC,EAAE,EAAE,KAAK,OAAO;QAAE,OAAO,IAAI,CAAC,kCAAkC,CAAC,CAAC;IAE1F,MAAM,QAAQ,GAAG,KAAK,CAAC,kBAAkB,IAAI,EAAE,CAAC;IAChD,MAAM,SAAS,GAAG,wBAAwB,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IAC7D,IAAI,CAAC,SAAS,CAAC,EAAE;QAAE,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IAChD,MAAM,EAAE,QAAQ,EAAE,GAAG,EAAE,UAAU,EAAE,GAAG,SAAS,CAAC,MAAM,CAAC;IAEvD,mDAAmD;IACnD,IAAI,OAAO,CAAC,iBAAiB,IAAI,IAAI,EAAE,CAAC;QACtC,MAAM,QAAQ,GAAG,MAAM,SAAS,CAC9B,EAAE,EACF,cAAc,EACd,GAAG,CAAC,EAAE,CAAC,cAAc,CAAC,SAAS,EAAE,SAAS,CAAC,EAAE,EAAE,CAAC,cAAc,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAChF,CAAC;QACF,IAAI,QAAQ,IAAI,OAAO,CAAC,iBAAiB;YAAE,OAAO,IAAI,CAAC,mDAAmD,CAAC,CAAC;IAC9G,CAAC;IAED,4EAA4E;IAC5E,0CAA0C;IAC1C,MAAM,QAAQ,GAAG,CAAC,OAAO,CAAC,oBAAoB,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,QAAQ,CAAC,CAAgB,CAAC,CAAC,CAAC;IAChH,MAAM,eAAe,GAAG,CAAC,QAAQ,IAAI,SAAS,CAAgB,CAAC;IAC/D,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,EAAE,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,KAAK,WAAW,CAAC;IAEpE,+EAA+E;IAC/E,sEAAsE;IACtE,MAAM,WAAW,GAAG,MAAM,aAAa,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,eAAe,EAAE,KAAK,EAAE,CAAC,CAAC;IAEtF,+EAA+E;IAC/E,+EAA+E;IAC/E,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,WAAW,CAAC,KAAK,EAAE,EAAE,EAAE,EAAE;YAChD,MAAM,CAAC,QAAQ,CAAC,GAAG,MAAM,EAAE;iBACxB,MAAM,CAAC,cAAc,CAAC;iBACtB,MAAM,CAAC;gBACN,SAAS;gBACT,SAAS,EAAE,WAAW,CAAC,EAAE;gBACzB,MAAM;gBACN,gBAAgB,EAAE,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,CAAC;aACzF,CAAC;iBACD,mBAAmB,EAAE;iBACrB,SAAS,CAAC,EAAE,EAAE,EAAE,cAAc,CAAC,EAAE,EAAE,CAAC,CAAC;YAExC,IAAI,CAAC,QAAQ;gBAAE,MAAM,IAAI,KAAK,CAAC,gBAAgB,CAAC,CAAC;YAEjD,MAAM,EAAE;iBACL,MAAM,CAAC,QAAQ,CAAC;iBAChB,GAAG,CAAC,EAAE,UAAU,EAAE,GAAG,CAAA,GAAG,QAAQ,CAAC,UAAU,MAAM,EAAE,CAAC;iBACpD,KAAK,CAAC,EAAE,CAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,CAAC,CAAC,CAAC;YAErC,MAAM,0BAA0B,CAAC,EAAE,EAAE,EAAE,SAAS,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC,CAAC;YAChH,OAAO,QAAQ,CAAC,EAAE,CAAC;QACrB,CAAC,CAAC,CAAC;QAEH,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE,WAAW,CAAC,IAAI,EAAE,SAAS,EAAE,WAAW,CAAC,EAAE,EAAE,WAAW,EAAE,WAAW,CAAC,IAAI,EAAE,CAAC;IACxH,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,aAAa,CAAC,EAAE,EAAE,WAAW,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QAChE,IAAI,GAAG,YAAY,KAAK,IAAI,GAAG,CAAC,OAAO,KAAK,gBAAgB,EAAE,CAAC;YAC7D,OAAO,IAAI,CAAC,4CAA4C,CAAC,CAAC;QAC5D,CAAC;QACD,MAAM,GAAG,CAAC;IACZ,CAAC;AACH,CAAC;AAoBD;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,EAAM,EAAE,OAAe;IAC/D,MAAM,CAAC,IAAI,CAAC,GAAG,MAAM,EAAE;SACpB,MAAM,EAAE;SACR,IAAI,CAAC,yBAAyB,CAAC;SAC/B,KAAK,CAAC,EAAE,CAAC,yBAAyB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;SACrD,KAAK,CAAC,CAAC,CAAC,CAAC;IAEZ,MAAM,UAAU,GAAG,MAAM,EAAE;SACxB,MAAM,CAAC;QACN,QAAQ,EAAE,2BAA2B,CAAC,QAAQ;QAC9C,OAAO,EAAE,2BAA2B,CAAC,OAAO;QAC5C,SAAS,EAAE,2BAA2B,CAAC,SAAS;QAChD,aAAa,EAAE,2BAA2B,CAAC,aAAa;QACxD,UAAU,EAAE,2BAA2B,CAAC,UAAU;QAClD,EAAE,EAAE,2BAA2B,CAAC,EAAE;KACnC,CAAC;SACD,IAAI,CAAC,2BAA2B,CAAC;SACjC,KAAK,CAAC,EAAE,CAAC,2BAA2B,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;IAE3D,IAAI,CAAC,IAAI,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAElD,OAAO;QACL,SAAS,EAAE,IAAI,EAAE,SAAS,IAAI,EAAE;QAChC,OAAO;QACP,MAAM,EAAE,IAAI,EAAE,MAAM,IAAI,EAAE;QAC1B,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,IAAI,EAAE,CAA2B;QACtD,SAAS,EAAE,IAAI,EAAE,SAAS,IAAI,IAAI,IAAI,CAAC,CAAC,CAAC;QACzC,UAAU;KACX,CAAC;AACJ,CAAC"}

package/dist/contest/types.d.ts

@@ -0,0 +1,197 @@
+import type { ContestStatus, ContestStage, ContestStageSubmission } from '@commonpub/schema';
+import type { DB } from '../types.js';
+export type ContestJudgingVisibility = 'public' | 'judges-only' | 'private';
+export type ContestVisibility = 'public' | 'unlisted' | 'private';
+export interface ContestPrize {
+    place?: number;
+    category?: string;
+    /** Optional — a prize can be description-only (no forced placement title). */
+    title?: string;
+    description?: string;
+    value?: string;
+}
+export interface ContestJudgingCriterion {
+    label: string;
+    weight?: number;
+    description?: string;
+}
+export interface CriterionScore {
+    label: string;
+    score: number;
+    max: number;
+}
+export interface JudgeScoreEntry {
+    judgeId: string;
+    score: number;
+    feedback?: string;
+    criteriaScores?: CriterionScore[];
+    /**
+     * The review stage this score was given in (Phase B2.5 per-round isolation). A
+     * judge has one score per round; the entry's live `score` aggregates only the
+     * CURRENT round. Absent on pre-B2.5 scores (treated as a single bucket).
+     */
+    roundId?: string;
+}
+export interface ContestListItem {
+    id: string;
+    title: string;
+    slug: string;
+    subheading: string | null;
+    description: string | null;
+    bannerUrl: string | null;
+    coverImageUrl: string | null;
+    status: ContestStatus;
+    startDate: Date;
+    endDate: Date;
+    entryCount: number;
+    createdAt: Date;
+}
+export interface ContestDetail extends ContestListItem {
+    subheading: string | null;
+    rules: string | null;
+    prizesDescription: string | null;
+    /** Per-field render mode ('markdown' | 'html'), independent for each field. */
+    descriptionFormat: 'markdown' | 'html';
+    rulesFormat: 'markdown' | 'html';
+    prizesDescriptionFormat: 'markdown' | 'html';
+    /** Block-editor body (BlockTuple[]); when non-null the viewer renders these
+     *  instead of the legacy description/rules text + format toggle. */
+    descriptionBlocks: unknown[] | null;
+    rulesBlocks: unknown[] | null;
+    prizesBlocks: unknown[] | null;
+    showPrizes: boolean;
+    prizes: ContestPrize[] | null;
+    judgingCriteria: ContestJudgingCriterion[] | null;
+    judgingVisibility: ContestJudgingVisibility;
+    judgingEndDate: Date | null;
+    communityVotingEnabled: boolean;
+    eligibleContentTypes: string[] | null;
+    maxEntriesPerUser: number | null;
+    visibility: ContestVisibility;
+    visibleToRoles: string[] | null;
+    createdById: string;
+    /** Phase B1 — explicit stage timeline (`[]` ⇒ classic synthesized flow). */
+    stages: ContestStage[];
+    currentStageId: string | null;
+    /**
+     * Per-request view-model flag (NOT persisted): whether the CURRENT viewer may
+     * manage this contest — owner, a per-contest `editor` stakeholder, or a
+     * `contest.manage` holder. Set by the contest GET route; undefined elsewhere.
+     * Drives the client Edit/manage affordances (server remains the enforcement
+     * boundary).
+     */
+    viewerCanManage?: boolean;
+}
+export interface ContestFilters {
+    status?: ContestStatus;
+    limit?: number;
+    offset?: number;
+}
+export interface CreateContestInput {
+    title: string;
+    slug: string;
+    subheading?: string;
+    description?: string;
+    rules?: string;
+    prizesDescription?: string;
+    descriptionFormat?: 'markdown' | 'html';
+    rulesFormat?: 'markdown' | 'html';
+    prizesDescriptionFormat?: 'markdown' | 'html';
+    /** Block-editor body (BlockTuple[]) for overview/rules. */
+    descriptionBlocks?: unknown[];
+    rulesBlocks?: unknown[];
+    prizesBlocks?: unknown[];
+    showPrizes?: boolean;
+    bannerUrl?: string;
+    coverImageUrl?: string;
+    prizes?: ContestPrize[];
+    judgingCriteria?: ContestJudgingCriterion[];
+    stages?: ContestStage[];
+    currentStageId?: string;
+    /** Seed-only: populates the contest_judges table at creation. */
+    judges?: string[];
+    communityVotingEnabled?: boolean;
+    judgingVisibility?: ContestJudgingVisibility;
+    eligibleContentTypes?: string[];
+    maxEntriesPerUser?: number;
+    visibility?: ContestVisibility;
+    visibleToRoles?: string[];
+    /** Seed-only: populates the contest_stakeholders table at creation. */
+    stakeholders?: string[];
+    startDate: string;
+    endDate: string;
+    judgingEndDate?: string;
+    createdBy: string;
+}
+/** A contest-like object the pure stage helpers (stages.ts) operate on. */
+export type StageSource = {
+    status: string;
+    startDate: Date | string;
+    endDate: Date | string;
+    judgingEndDate: Date | string | null;
+    stages?: ContestStage[] | null;
+    currentStageId?: string | null;
+};
+export interface ContestEntryItem {
+    id: string;
+    contestId: string;
+    contentId: string;
+    userId: string;
+    score: number | null;
+    rank: number | null;
+    /** Phase B2 — per-stage cohort outcome; `eliminated` is the derived convenience. */
+    stageState: Array<{
+        stageId: string;
+        status: 'advanced' | 'eliminated';
+        score?: number | null;
+        rank?: number | null;
+    }>;
+    eliminated: boolean;
+    /**
+     * Per-stage artifacts (proposal/prototype field values). Present only when
+     * the caller asked for them (privileged viewers, or the entrant's own rows
+     * via `stageSubmissionsViewerId`) — never on the public listing.
+     */
+    stageSubmissions?: ContestStageSubmission[];
+    submittedAt: Date;
+    contentTitle: string;
+    contentSlug: string;
+    contentType: string;
+    contentCoverImageUrl: string | null;
+    authorName: string;
+    authorUsername: string;
+    authorAvatarUrl: string | null;
+    judgeScores?: JudgeScoreEntry[];
+}
+/** An accepted agreement field, ready to be recorded as an acceptance row. */
+export interface AgreementAcceptanceInput {
+    fieldKey: string;
+    label: string;
+    terms: string;
+    termsFormat: 'markdown' | 'html';
+}
+/**
+ * The result of validating + partitioning a submission form. Agreements and PII
+ * are split OUT of the public `artifact` so they never reach `stageSubmissions`:
+ * agreements become immutable acceptance rows, PII lands in the private table.
+ */
+export interface PartitionedSubmission {
+    /** Non-PII, non-agreement fields → the public `stageSubmissions` artifact. */
+    artifact: Record<string, string>;
+    /** PII fields (`pii: true` or `address`) → `contest_entry_private_fields`. */
+    pii: Record<string, string>;
+    /** Accepted agreements → `contest_agreement_acceptances`. */
+    agreements: AgreementAcceptanceInput[];
+}
+export interface AdvanceStageInput {
+    /** The `review` stage whose advancement cut we're applying. */
+    reviewStageId: string;
+    mode: 'topN' | 'manual';
+    /** topN mode: how many of the eligible cohort advance (ties broken deterministically). */
+    topN?: number;
+    /** manual mode: explicit entry ids that advance; the rest of the cohort is eliminated. */
+    advancedEntryIds?: string[];
+}
+/** The transaction handle drizzle passes to `db.transaction(async (tx) => …)`. */
+export type ContestTx = Parameters<Parameters<DB['transaction']>[0]>[0];
+//# sourceMappingURL=types.d.ts.map

package/dist/contest/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/contest/types.ts"],"names":[],"mappings":"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"}

package/dist/contest/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/contest/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/contest/types.ts"],"names":[],"mappings":""}

package/dist/contest/validation.d.ts

@@ -0,0 +1,32 @@
+import type { ContestSubmissionTemplateField } from '@commonpub/schema';
+import type { PartitionedSubmission } from './types.js';
+/** sha-256 hex of an agreement's terms text (integrity check vs the snapshot). */
+export declare function hashTerms(terms: string): string;
+/**
+ * Validate an entrant's submission values against a stage template AND partition
+ * them into artifact / PII / agreements. Pure + exhaustively testable. Domain
+ * checks, not just shape: unknown keys rejected (no smuggling values outside the
+ * template), required fields non-blank, `url`/`email`/`number`/`select`/`date`/
+ * `address` validated for their kind, agreements must be accepted when required.
+ * PII (`pii`/`address`) and agreement fields are kept OUT of `artifact`.
+ */
+export declare function validateSubmissionFields(template: ContestSubmissionTemplateField[], values: Record<string, string>): {
+    ok: true;
+    result: PartitionedSubmission;
+} | {
+    ok: false;
+    error: string;
+};
+/**
+ * Back-compat artifact-only validator (the original per-stage-artifact contract).
+ * Delegates to `validateSubmissionFields` and returns just the public artifact —
+ * PII/agreement fields, if any, are partitioned out and handled by the caller.
+ */
+export declare function validateStageArtifactFields(template: ContestSubmissionTemplateField[], fields: Record<string, string>): {
+    ok: true;
+    fields: Record<string, string>;
+} | {
+    ok: false;
+    error: string;
+};
+//# sourceMappingURL=validation.d.ts.map

package/dist/contest/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../src/contest/validation.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,mBAAmB,CAAC;AACxE,OAAO,KAAK,EAA4B,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAelF,kFAAkF;AAClF,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,8BAA8B,EAAE,EAC1C,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC7B;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,qBAAqB,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CA4F5E;AAED;;;;GAIG;AACH,wBAAgB,2BAA2B,CACzC,QAAQ,EAAE,8BAA8B,EAAE,EAC1C,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC7B;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAI7E"}