@mohasinac/appkit 4.58.0 → 4.59.0

package/dist/features/tester/seed-data/tester-responses-seed-data.d.ts

@@ -1,2 +0,0 @@
-import type { TesterChecklistResponseDocument } from "../schemas/firestore";
-export declare const testerResponsesSeedData: Partial<TesterChecklistResponseDocument>[];

package/dist/features/tester/seed-data/tester-responses-seed-data.js

@@ -1,95 +0,0 @@
-/*
- * WHY: Three `admin/bug-hunter-rewards` cases need a tester submission that
- *      ALREADY EXISTS before the tester arrives — you cannot test "confirm this
- *      reported bug" or "reopen this confirmed case" against an empty inbox.
- *
- *      `testerChecklistResponses` is DERIVED tier, so a run wipes it at setup
- *      and on a fresh project there are genuinely zero submissions. That is
- *      correct — stale verdicts from a previous run must not leak into the next
- *      one — but it left those three cases permanently unrunnable. Measured
- *      2026-09-11: 0 pass / 0 fail / 5 blocked on that page, with both
- *      calibration controls answered correctly, so the batch was trustworthy and
- *      the emptiness was real.
- *
- *      The fix is NOT to stop wiping the collection. It is to restore these
- *      fixtures after the wipe — `SEED_TRANSACTIONAL` in
- *      tester/scripts/lib/collections.mjs is a RESTORE list, orthogonal to the
- *      delete tiers, so a collection can be both wiped and re-seeded.
- *
- * WHAT: Two response documents against the two demo-fixture checklist items that
- *       already live in the catalogue.
- *
- * 🛑 THE DOC ID IS DETERMINISTIC: `${testerId}__${checklistItemId}`.
- *    That is the same id the live answer path computes, and it is what makes an
- *    answer an UPSERT rather than a duplicate — `set({merge:true})`, never
- *    `add()`. Generating a random id here would (a) create a second, competing
- *    response for the same (tester, case) pair the moment a real tester answers,
- *    and (b) break idempotency, so every `appkit-seed load` would pile up
- *    another copy — Root Cause #25 exactly.
- *
- * @tag domain:tester
- * @tag layer:seed
- * @tag access:server-only
- * @tag consumers:appkit/scripts/seed-cli.mjs, seed/manifest.ts
- * @tag sideEffects:none
- */
-/** The seeded buyer the demo fixtures credit as "Mock User 3". */
-const TESTER_ID = "user-yugi-muto";
-const TESTER_NAME = "Mock User 3";
-/** Same shape the answer route computes — see the callout above. */
-const responseId = (testerId, checklistItemId) => `${testerId}__${checklistItemId}`;
-const DEMO_V1 = "checklist-admin-bug-hunter-rewards-demo-fixture";
-const DEMO_V2 = "checklist-admin-bug-hunter-rewards-demo-fixture-v2";
-const seededAt = new Date("2026-08-18T09:30:00.000Z");
-export const testerResponsesSeedData = [
-    /*
-     * The ALREADY-CONFIRMED submission. The v1 catalogue item carries
-     * bugConfirmed:true / bugHunterId:"user-yugi-muto" / bugHunterName:"Mock User
-     * 3", and until now there was no response row behind that credit — so
-     * /admin/tester-feedback showed "No feedback submitted yet" while the
-     * leaderboard showed a confirmed bug. This is the missing half.
-     *
-     * Backs: confirm-bug-idempotent (needs a row that is already confirmed) and
-     * reopen-case (needs the v1 credit to be visible from a real submission).
-     *
-     * `status: "reviewed"` because an admin has already acted on it.
-     */
-    {
-        id: responseId(TESTER_ID, DEMO_V1),
-        testerId: TESTER_ID,
-        testerDisplayName: TESTER_NAME,
-        checklistItemId: DEMO_V1,
-        groupKey: "admin",
-        pageKey: "bug-hunter-rewards",
-        phase: 1,
-        answer: "no",
-        comment: "Seed fixture — the reported bug behind the v1 demo case. Already confirmed and credited, then reopened as v2. Exists so an admin can see what a confirmed submission looks like without waiting for a real tester to file one.",
-        status: "reviewed",
-        createdAt: seededAt,
-        updatedAt: seededAt,
-    },
-    /*
-     * The UNCONFIRMED submission, against the active v2 retest. This is the row
-     * "Mark as Bug" is meant to be tried on end-to-end.
-     *
-     * 🛑 status MUST stay "new" and the case MUST stay un-confirmed, or the
-     * confirm-bug case has nothing left to do — it would open an already-confirmed
-     * row and correctly report that it could not perform its own steps. A fixture
-     * that pre-completes the thing under test is worse than no fixture, because it
-     * looks like coverage.
-     */
-    {
-        id: responseId(TESTER_ID, DEMO_V2),
-        testerId: TESTER_ID,
-        testerDisplayName: TESTER_NAME,
-        checklistItemId: DEMO_V2,
-        groupKey: "admin",
-        pageKey: "bug-hunter-rewards",
-        phase: 1,
-        answer: "no",
-        comment: "Seed fixture — a fresh 'No' on the reopened v2 case, deliberately NOT yet confirmed. This is the row to try Mark as Bug against.",
-        status: "new",
-        createdAt: seededAt,
-        updatedAt: seededAt,
-    },
-];

package/dist/features/tester/seed-data/tester-window.d.ts

@@ -1,25 +0,0 @@
-/** Reproduces the historical 1h/2h/3h auction stagger when nothing overrides it. */
-export declare const DEFAULT_TESTER_WINDOW_MINUTES = 180;
-/** Below this nothing is observable — a page load alone can outlast it. */
-export declare const MIN_TESTER_WINDOW_MINUTES = 5;
-/** The sandbox TTL is 7 days; a window longer than that outlives its own fixtures. */
-export declare const MAX_TESTER_WINDOW_MINUTES: number;
-/**
- * Length of the testing window, in minutes.
- *
- * Read at call time rather than captured at module scope so a caller that sets the
- * env var before importing a seed file still wins. Anything unparseable, non-finite
- * or out of range falls back to the default rather than throwing: a malformed env
- * var must not be able to brick `appkit-seed load`.
- */
-export declare function windowMinutes(): number;
-/**
- * A point `fraction` of the way through the window, measured from now.
- *
- * `windowOffset(0)` is now, `windowOffset(1)` is the window's end. Fractions above 1
- * are allowed and mean "after this run" — that is how a fixture says "still open when
- * testing finishes" without hard-coding a duration.
- */
-export declare function windowOffset(fraction: number): Date;
-/** The mirror of windowOffset, into the past — for fixtures that must already be closed. */
-export declare function windowAgo(fraction: number): Date;

package/dist/features/tester/seed-data/tester-window.js

@@ -1,66 +0,0 @@
-/*
- * WHY: Every time-bound tester fixture — auction end dates, coupon validity, event
- *      start/end, prize-draw reveal windows, offer expiry, lottery draw windows —
- *      must open and close INSIDE one testing session. Hand-written offsets like
- *      `Date.now() + 2 * 60 * 60 * 1000` cannot do that: they bake in a duration
- *      nobody can shorten, so a case reading "watch the auction actually end" is
- *      untestable without sitting there for two hours.
- *
- *      This file is the one knob. Fixtures express WHEN as a fraction of the run
- *      window; the window's real length comes from TESTER_WINDOW_MINUTES.
- *
- * WHAT: windowMinutes() / windowOffset(fraction) / windowAgo(fraction).
- *
- * 🛑 The default is 180 minutes ON PURPOSE — it reproduces the pre-existing 1h/2h/3h
- *    auction stagger exactly (fractions 1/3, 2/3, 1), so an ordinary `appkit-seed load`
- *    behaves as it always has. Only the automated runner shortens it. Changing this
- *    default silently re-times every fixture for human testers too.
- *
- * @tag domain:tester
- * @tag layer:seed
- * @tag pattern:none
- * @tag access:server-only
- * @tag consumers:seed-data/*-tester-seed-data.ts
- * @tag sideEffects:none
- */
-/** Reproduces the historical 1h/2h/3h auction stagger when nothing overrides it. */
-export const DEFAULT_TESTER_WINDOW_MINUTES = 180;
-/** Below this nothing is observable — a page load alone can outlast it. */
-export const MIN_TESTER_WINDOW_MINUTES = 5;
-/** The sandbox TTL is 7 days; a window longer than that outlives its own fixtures. */
-export const MAX_TESTER_WINDOW_MINUTES = 7 * 24 * 60;
-/**
- * Length of the testing window, in minutes.
- *
- * Read at call time rather than captured at module scope so a caller that sets the
- * env var before importing a seed file still wins. Anything unparseable, non-finite
- * or out of range falls back to the default rather than throwing: a malformed env
- * var must not be able to brick `appkit-seed load`.
- */
-export function windowMinutes() {
-    const raw = process.env.TESTER_WINDOW_MINUTES;
-    if (!raw)
-        return DEFAULT_TESTER_WINDOW_MINUTES;
-    const parsed = Number(raw);
-    if (!Number.isFinite(parsed))
-        return DEFAULT_TESTER_WINDOW_MINUTES;
-    if (parsed < MIN_TESTER_WINDOW_MINUTES)
-        return MIN_TESTER_WINDOW_MINUTES;
-    if (parsed > MAX_TESTER_WINDOW_MINUTES)
-        return MAX_TESTER_WINDOW_MINUTES;
-    return parsed;
-}
-/**
- * A point `fraction` of the way through the window, measured from now.
- *
- * `windowOffset(0)` is now, `windowOffset(1)` is the window's end. Fractions above 1
- * are allowed and mean "after this run" — that is how a fixture says "still open when
- * testing finishes" without hard-coding a duration.
- */
-export function windowOffset(fraction) {
-    return new Date(Date.now() + fraction * windowMinutes() * 60000);
-}
-/** The mirror of windowOffset, into the past — for fixtures that must already be closed. */
-export function windowAgo(fraction) {
-    return windowOffset(-fraction);
-}

package/dist/seed/_helpers/brand-rows.d.ts

@@ -1,35 +0,0 @@
-import type { CategoryDocument } from "../../features/categories/schemas";
-export interface BrandSeedInput {
-    /** Without the `brand-` prefix. */
-    slug: string;
-    /** 🛑 The display name products match on. Changing it orphans the catalogue. */
-    name: string;
-    description: string;
-    country: string;
-    founded?: number;
-    website?: string;
-    highlights: string[];
-    faqs?: {
-        question: string;
-        answer: string;
-    }[];
-    /** Shows in the footer brand list. Reserved for the few with real breadth. */
-    footer?: boolean;
-    featured?: boolean;
-    keywords: string[];
-    seoDescription: string;
-}
-export declare function brandRow(input: BrandSeedInput, order: number, stamps: {
-    createdBy: string;
-    createdAt: Date;
-    updatedAt: Date;
-}): Partial<CategoryDocument>;
-/** Declaration order is display order; `order` is assigned from it. */
-export declare const BRAND_SEED_INPUTS: BrandSeedInput[];
-export declare function buildBrandRows(stamps: {
-    createdBy: string;
-    createdAt: Date;
-    updatedAt: Date;
-}): Partial<CategoryDocument>[];
-/** Asserted by the seed so a silently dropped row is loud. */
-export declare const BRAND_ROW_COUNT: number;