@mohasinac/appkit 3.6.4 → 3.7.0

package/dist/features/tester/components/AdminTesterFeedbackReportView.js

@@ -0,0 +1,30 @@
+"use client";
+import { jsx as _jsx } from "react/jsx-runtime";
+import { useQuery } from "@tanstack/react-query";
+import { Stack, Text } from "../../../ui";
+import { apiClient } from "../../../http";
+import { ADMIN_ENDPOINTS } from "../../../constants/api-endpoints";
+import { TesterFeedbackChart } from "./TesterFeedbackChart";
+export function AdminTesterFeedbackReportView() {
+    const query = useQuery({
+        queryKey: ["admin", "tester-feedback", "report"],
+        queryFn: async () => {
+            const res = await apiClient.get(ADMIN_ENDPOINTS.TESTER_FEEDBACK_REPORT);
+            return res?.data ?? res;
+        },
+    });
+    if (query.isLoading)
+        return _jsx(Text, { color: "muted", children: "Loading report\u2026" });
+    const itemCoverage = query.data?.itemCoverage ?? [];
+    const totals = query.data?.totals ?? { totalAnswered: 0, totalYes: 0, totalNo: 0 };
+    const byGroup = new Map();
+    for (const item of itemCoverage) {
+        if (!byGroup.has(item.groupKey)) {
+            byGroup.set(item.groupKey, { groupLabel: item.groupKey, yes: 0, no: 0 });
+        }
+        const entry = byGroup.get(item.groupKey);
+        entry.yes += item.yesCount;
+        entry.no += item.noCount;
+    }
+    return (_jsx(Stack, { gap: "lg", children: _jsx(TesterFeedbackChart, { data: Array.from(byGroup.values()), totalCases: itemCoverage.length, totalAnswered: totals.totalAnswered, totalYes: totals.totalYes, totalNo: totals.totalNo }) }));
+}

package/dist/features/tester/components/AdminTesterFeedbackView.d.ts

@@ -0,0 +1,2 @@
+import React from "react";
+export declare function AdminTesterFeedbackView(): React.JSX.Element;

package/dist/features/tester/components/AdminTesterFeedbackView.js

@@ -0,0 +1,9 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Heading, Stack, Tabs, TabsContent, TabsList, TabsTrigger } from "../../../ui";
+import { AdminTesterFeedbackReportView } from "./AdminTesterFeedbackReportView";
+import { AdminTesterFeedbackIssuesView } from "./AdminTesterFeedbackIssuesView";
+import { AdminTesterFeedbackListView } from "./AdminTesterFeedbackListView";
+export function AdminTesterFeedbackView() {
+    return (_jsxs(Stack, { gap: "lg", children: [_jsx(Heading, { level: 1, children: "Tester Feedback" }), _jsxs(Tabs, { defaultValue: "report", children: [_jsxs(TabsList, { children: [_jsx(TabsTrigger, { value: "report", children: "Report" }), _jsx(TabsTrigger, { value: "issues", children: "Main Issues" }), _jsx(TabsTrigger, { value: "submissions", children: "All Submissions" })] }), _jsx(TabsContent, { value: "report", children: _jsx(AdminTesterFeedbackReportView, {}) }), _jsx(TabsContent, { value: "issues", children: _jsx(AdminTesterFeedbackIssuesView, {}) }), _jsx(TabsContent, { value: "submissions", children: _jsx(AdminTesterFeedbackListView, {}) })] })] }));
+}

package/dist/features/tester/components/TesterChecklistStepRow.d.ts

@@ -0,0 +1,18 @@
+import React from "react";
+import type { TesterAnswer } from "../schemas/firestore";
+export interface TesterChecklistStepItem {
+    checklistItemId: string;
+    label: string;
+    description?: string;
+    href?: string;
+    answer: TesterAnswer | null;
+    comment?: string;
+    screenshotUrl?: string;
+}
+export interface TesterChecklistStepRowProps {
+    item: TesterChecklistStepItem;
+    testerDisplayName: string;
+    onAnswer: (checklistItemId: string, answer: TesterAnswer) => void;
+    onSaveNote: (checklistItemId: string, comment: string, screenshotUrl: string) => Promise<void>;
+}
+export declare function TesterChecklistStepRow({ item, testerDisplayName, onAnswer, onSaveNote, }: TesterChecklistStepRowProps): React.JSX.Element;

package/dist/features/tester/components/TesterChecklistStepRow.js

@@ -0,0 +1,29 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import React from "react";
+import { Anchor, Button, Div, FieldTextarea, Row, Stack, Text } from "../../../ui";
+import { MediaUploadField } from "../../media/upload/MediaUploadField";
+import { useMediaUpload } from "../../media/hooks/useMedia";
+import { ACTIONS } from "../../../_internal/shared/actions/action-registry";
+export function TesterChecklistStepRow({ item, testerDisplayName, onAnswer, onSaveNote, }) {
+    const [expanded, setExpanded] = React.useState(false);
+    const [comment, setComment] = React.useState(item.comment ?? "");
+    const [screenshotUrl, setScreenshotUrl] = React.useState(item.screenshotUrl ?? "");
+    const [saving, setSaving] = React.useState(false);
+    const { upload } = useMediaUpload();
+    const handleUpload = async (file) => upload(file, "tester-screenshots", false, {
+        type: "tester-screenshot",
+        testerName: testerDisplayName,
+        checklistItemId: item.checklistItemId,
+    });
+    const handleSave = async () => {
+        setSaving(true);
+        try {
+            await onSaveNote(item.checklistItemId, comment, screenshotUrl);
+        }
+        finally {
+            setSaving(false);
+        }
+    };
+    return (_jsxs(Stack, { gap: "xs", padding: "sm", border: "default", rounded: "md", children: [_jsxs(Row, { gap: "sm", justify: "between", align: "center", wrap: true, children: [_jsxs(Stack, { gap: "none", className: "min-w-0", children: [_jsx(Text, { weight: "medium", children: item.label }), item.description && (_jsx(Text, { size: "xs", color: "muted", children: item.description })), item.href && (_jsx(Anchor, { href: item.href, tone: "brand", underline: "hover", children: "Go test this \u2192" }))] }), _jsxs(Row, { gap: "xs", children: [_jsx(Button, { type: "button", size: "sm", variant: item.answer === "yes" ? "primary" : "outline", onClick: () => onAnswer(item.checklistItemId, "yes"), children: "Yes" }), _jsx(Button, { type: "button", size: "sm", variant: item.answer === "no" ? "danger" : "outline", onClick: () => onAnswer(item.checklistItemId, "no"), children: "No" }), _jsx(Button, { type: "button", size: "sm", variant: "ghost", onClick: () => setExpanded((v) => !v), children: expanded ? "Hide note" : "Add note" })] })] }), expanded && (_jsx(Div, { padding: "t-sm", border: "default", className: "border-t", children: _jsxs(Stack, { gap: "sm", children: [_jsx(FieldTextarea, { name: `comment-${item.checklistItemId}`, label: "Comment", value: comment, onChange: setComment, placeholder: "What did you notice? Colors, styles, readability, bugs..." }), _jsx(MediaUploadField, { label: "Screenshot (optional)", value: screenshotUrl, onChange: setScreenshotUrl, onUpload: handleUpload, kind: "image" }), _jsx(Row, { children: _jsx(Button, { type: "button", action: ACTIONS.TESTER["save-note"], isLoading: saving, onClick: handleSave }) })] }) }))] }));
+}

package/dist/features/tester/components/TesterFeedbackChart.d.ts

@@ -0,0 +1,14 @@
+import React from "react";
+export interface GroupCoverageDatum {
+    groupLabel: string;
+    yes: number;
+    no: number;
+}
+export interface TesterFeedbackChartProps {
+    data: GroupCoverageDatum[];
+    totalCases: number;
+    totalAnswered: number;
+    totalYes: number;
+    totalNo: number;
+}
+export declare function TesterFeedbackChart({ data, totalCases, totalAnswered, totalYes, totalNo, }: TesterFeedbackChartProps): React.JSX.Element;

package/dist/features/tester/components/TesterFeedbackChart.js

@@ -0,0 +1,18 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import dynamic from "next/dynamic";
+import { Card, Heading, Row, Stack, Text } from "../../../ui";
+// recharts exports generic components (<DataPointType>) that don't satisfy
+// next/dynamic's ComponentType<P> constraint — cast each to ComponentType<any>.
+const ResponsiveContainer = dynamic(() => import("recharts").then((m) => m.ResponsiveContainer), { ssr: false });
+const BarChart = dynamic(() => import("recharts").then((m) => m.BarChart), { ssr: false });
+const Bar = dynamic(() => import("recharts").then((m) => m.Bar), { ssr: false });
+const XAxis = dynamic(() => import("recharts").then((m) => m.XAxis), { ssr: false });
+const YAxis = dynamic(() => import("recharts").then((m) => m.YAxis), { ssr: false });
+const CartesianGrid = dynamic(() => import("recharts").then((m) => m.CartesianGrid), { ssr: false });
+const Tooltip = dynamic(() => import("recharts").then((m) => m.Tooltip), { ssr: false });
+const Legend = dynamic(() => import("recharts").then((m) => m.Legend), { ssr: false });
+export function TesterFeedbackChart({ data, totalCases, totalAnswered, totalYes, totalNo, }) {
+    const passRate = totalAnswered > 0 ? Math.round((totalYes / totalAnswered) * 100) : 0;
+    return (_jsxs(Stack, { gap: "md", children: [_jsxs(Row, { gap: "md", wrap: true, children: [_jsxs(Card, { padding: "md", variant: "default", children: [_jsx(Text, { size: "xs", color: "muted", children: "Total test cases" }), _jsx(Heading, { level: 3, children: totalCases })] }), _jsxs(Card, { padding: "md", variant: "default", children: [_jsx(Text, { size: "xs", color: "muted", children: "Answers recorded" }), _jsx(Heading, { level: 3, children: totalAnswered })] }), _jsxs(Card, { padding: "md", variant: "default", children: [_jsx(Text, { size: "xs", color: "muted", children: "Pass rate" }), _jsxs(Heading, { level: 3, children: [passRate, "%"] })] }), _jsxs(Card, { padding: "md", variant: "default", children: [_jsx(Text, { size: "xs", color: "muted", children: "Issues (No)" }), _jsx(Heading, { level: 3, color: "error", children: totalNo })] })] }), _jsx(ResponsiveContainer, { width: "100%", height: 360, children: _jsxs(BarChart, { data: data, children: [_jsx(CartesianGrid, { strokeDasharray: "3 3" }), _jsx(XAxis, { dataKey: "groupLabel", tick: { fontSize: 12 } }), _jsx(YAxis, { allowDecimals: false }), _jsx(Tooltip, {}), _jsx(Legend, {}), _jsx(Bar, { dataKey: "yes", name: "Yes", fill: "var(--appkit-color-success)" }), _jsx(Bar, { dataKey: "no", name: "No", fill: "var(--appkit-color-error)" })] }) })] }));
+}

package/dist/features/tester/components/TesterHubView.d.ts

@@ -0,0 +1,5 @@
+import React from "react";
+export interface TesterHubViewProps {
+    sandboxExpiresAt?: string | null;
+}
+export declare function TesterHubView({ sandboxExpiresAt }: TesterHubViewProps): React.JSX.Element;

package/dist/features/tester/components/TesterHubView.js

@@ -0,0 +1,71 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import React from "react";
+import { useQuery, useQueryClient } from "@tanstack/react-query";
+import { Alert, Details, Div, FieldInput, Heading, Stack, Summary, Text } from "../../../ui";
+import { apiClient } from "../../../http";
+import { useApiMutation } from "../../../client";
+import { useSession } from "../../../react";
+import { ACCOUNT_ENDPOINTS } from "../../../constants/api-endpoints";
+import { TesterChecklistStepRow } from "./TesterChecklistStepRow";
+function matchesQuery(item, query) {
+    if (!query)
+        return true;
+    const haystack = `${item.label} ${item.description ?? ""} ${item.groupLabel} ${item.pageLabel}`.toLowerCase();
+    return haystack.includes(query.toLowerCase());
+}
+export function TesterHubView({ sandboxExpiresAt }) {
+    const { user } = useSession();
+    const queryClient = useQueryClient();
+    const [search, setSearch] = React.useState("");
+    const query = useQuery({
+        queryKey: ["user", "tester-checklist"],
+        queryFn: async () => {
+            const res = await apiClient.get(ACCOUNT_ENDPOINTS.TESTER_CHECKLIST);
+            return res?.data ?? res;
+        },
+    });
+    const upsertMutation = useApiMutation({
+        mutationFn: async (vars) => apiClient.put(ACCOUNT_ENDPOINTS.TESTER_CHECKLIST_ITEM_BY_ID(vars.checklistItemId), vars.patch),
+        onSuccess: () => {
+            void queryClient.invalidateQueries({ queryKey: ["user", "tester-checklist"] });
+        },
+    });
+    if (!user?.isTester) {
+        return (_jsx(Alert, { variant: "warning", title: "Testers only", children: "This page is only available to accounts flagged as testers. Contact an admin if you believe this is a mistake." }));
+    }
+    const items = query.data?.items ?? [];
+    const filtered = items.filter((item) => matchesQuery(item, search));
+    const groups = new Map();
+    for (const item of filtered) {
+        if (!groups.has(item.groupKey)) {
+            groups.set(item.groupKey, { groupLabel: item.groupLabel, pages: new Map() });
+        }
+        const group = groups.get(item.groupKey);
+        if (!group.pages.has(item.pageKey)) {
+            group.pages.set(item.pageKey, { pageLabel: item.pageLabel, items: [] });
+        }
+        group.pages.get(item.pageKey).items.push(item);
+    }
+    const handleAnswer = (checklistItemId, answer) => {
+        upsertMutation.mutate({ checklistItemId, patch: { answer } });
+    };
+    const handleSaveNote = async (checklistItemId, comment, screenshotUrl) => {
+        await upsertMutation.mutateAsync({ checklistItemId, patch: { comment, screenshotUrl } });
+    };
+    return (_jsxs(Stack, { gap: "lg", children: [_jsx(Heading, { level: 1, children: "Tester Hub" }), _jsx(Text, { color: "muted", children: "Work through the checklist below and answer Yes/No for each test case. Add a comment and screenshot wherever something looks off \u2014 colors, styles, readability, bugs. Your answers save automatically." }), sandboxExpiresAt && (_jsxs(Alert, { variant: "info", title: "Shared test sandbox", children: ["The shared test store/products/categories expire on ", new Date(sandboxExpiresAt).toLocaleDateString(), "."] })), _jsx(FieldInput, { name: "checklist-search", label: "Search test cases", value: search, onChange: setSearch, placeholder: "e.g. checkout, google, bidding..." }), query.isLoading && _jsx(Text, { color: "muted", children: "Loading checklist\u2026" }), Array.from(groups.entries()).map(([groupKey, group]) => (_jsxs(Stack, { gap: "sm", children: [_jsx(Heading, { level: 3, children: group.groupLabel }), Array.from(group.pages.entries()).map(([pageKey, page]) => {
+                        const answeredCount = page.items.filter((i) => i.answer).length;
+                        return (_jsxs(Details, { tone: "card", defaultOpen: false, children: [_jsxs(Summary, { children: [page.pageLabel, " (", answeredCount, "/", page.items.length, " answered)"] }), _jsx(Div, { padding: "t-sm", children: _jsx(Stack, { gap: "sm", children: page.items
+                                            .slice()
+                                            .sort((a, b) => a.order - b.order)
+                                            .map((item) => (_jsx(TesterChecklistStepRow, { testerDisplayName: user?.displayName ?? user?.email ?? "tester", item: {
+                                                checklistItemId: item.id,
+                                                label: item.label,
+                                                description: item.description,
+                                                href: item.href,
+                                                answer: item.answer,
+                                                comment: item.comment,
+                                                screenshotUrl: item.screenshotUrl,
+                                            }, onAnswer: handleAnswer, onSaveNote: handleSaveNote }, item.id))) }) })] }, pageKey));
+                    })] }, groupKey)))] }));
+}

package/dist/features/tester/components/index.d.ts

@@ -0,0 +1,11 @@
+export { TesterHubView } from "./TesterHubView";
+export type { TesterHubViewProps } from "./TesterHubView";
+export { TesterChecklistStepRow } from "./TesterChecklistStepRow";
+export type { TesterChecklistStepRowProps, TesterChecklistStepItem } from "./TesterChecklistStepRow";
+export { TesterFeedbackChart } from "./TesterFeedbackChart";
+export type { TesterFeedbackChartProps, GroupCoverageDatum } from "./TesterFeedbackChart";
+export { AdminTesterFeedbackView } from "./AdminTesterFeedbackView";
+export { AdminTesterFeedbackReportView } from "./AdminTesterFeedbackReportView";
+export { AdminTesterFeedbackIssuesView } from "./AdminTesterFeedbackIssuesView";
+export { AdminTesterFeedbackListView } from "./AdminTesterFeedbackListView";
+export type { AdminTesterFeedbackListViewProps } from "./AdminTesterFeedbackListView";

package/dist/features/tester/components/index.js

@@ -0,0 +1,7 @@
+export { TesterHubView } from "./TesterHubView";
+export { TesterChecklistStepRow } from "./TesterChecklistStepRow";
+export { TesterFeedbackChart } from "./TesterFeedbackChart";
+export { AdminTesterFeedbackView } from "./AdminTesterFeedbackView";
+export { AdminTesterFeedbackReportView } from "./AdminTesterFeedbackReportView";
+export { AdminTesterFeedbackIssuesView } from "./AdminTesterFeedbackIssuesView";
+export { AdminTesterFeedbackListView } from "./AdminTesterFeedbackListView";

package/dist/features/tester/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./schemas";
+export * from "./components";

package/dist/features/tester/index.js

@@ -0,0 +1,2 @@
+export * from "./schemas";
+export * from "./components";

package/dist/features/tester/repository/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./tester-checklist-item.repository";
+export * from "./tester-checklist-response.repository";

package/dist/features/tester/repository/index.js

@@ -0,0 +1,2 @@
+export * from "./tester-checklist-item.repository";
+export * from "./tester-checklist-response.repository";

package/dist/features/tester/repository/tester-checklist-item.repository.d.ts

@@ -0,0 +1,13 @@
+import { BaseRepository } from "../../../providers/db-firebase";
+import type { FirebaseSieveFields, FirebaseSieveResult, SieveModel } from "../../../providers/db-firebase";
+import { type TesterChecklistItemDocument, type TesterChecklistItemCreateInput, type TesterChecklistItemUpdateInput } from "../schemas/firestore";
+export declare class TesterChecklistItemRepository extends BaseRepository<TesterChecklistItemDocument> {
+    static readonly SIEVE_FIELDS: FirebaseSieveFields;
+    constructor();
+    private buildSearchTokens;
+    createItem(input: TesterChecklistItemCreateInput): Promise<TesterChecklistItemDocument>;
+    update(id: string, data: TesterChecklistItemUpdateInput): Promise<TesterChecklistItemDocument>;
+    listActive(): Promise<TesterChecklistItemDocument[]>;
+    list(model: SieveModel): Promise<FirebaseSieveResult<TesterChecklistItemDocument>>;
+}
+export declare const testerChecklistItemRepository: TesterChecklistItemRepository;

package/dist/features/tester/repository/tester-checklist-item.repository.js

@@ -0,0 +1,55 @@
+import { BaseRepository } from "../../../providers/db-firebase";
+import { DatabaseError } from "../../../errors";
+import { TESTER_CHECKLIST_ITEM_COLLECTION, TESTER_CHECKLIST_ITEM_FIELDS, createChecklistItemId, } from "../schemas/firestore";
+export class TesterChecklistItemRepository extends BaseRepository {
+    constructor() {
+        super(TESTER_CHECKLIST_ITEM_COLLECTION);
+    }
+    buildSearchTokens(input) {
+        const rawText = [input.label, input.description, input.groupLabel, input.pageLabel]
+            .filter(Boolean)
+            .join(" ")
+            .toLowerCase();
+        return Array.from(new Set(rawText
+            .split(/[^a-z0-9]+/i)
+            .map((token) => token.trim())
+            .filter((token) => token.length >= 2))).slice(0, 50);
+    }
+    async createItem(input) {
+        const id = createChecklistItemId(input.groupKey, input.pageKey, input.label);
+        const searchTokens = this.buildSearchTokens(input);
+        return this.createWithId(id, { ...input, searchTokens });
+    }
+    async update(id, data) {
+        const current = await this.findById(id);
+        if (!current) {
+            throw new DatabaseError(`Failed to update checklist item: missing document ${id}`);
+        }
+        const merged = { ...current, ...data };
+        return super.update(id, {
+            ...data,
+            searchTokens: this.buildSearchTokens(merged),
+        });
+    }
+    async listActive() {
+        const snapshot = await this.db
+            .collection(this.collection)
+            .where(TESTER_CHECKLIST_ITEM_FIELDS.IS_ACTIVE, "==", true)
+            .orderBy(TESTER_CHECKLIST_ITEM_FIELDS.ORDER, "asc")
+            .get();
+        return snapshot.docs.map((doc) => this.mapDoc(doc));
+    }
+    async list(model) {
+        return this.sieveQuery(model, TesterChecklistItemRepository.SIEVE_FIELDS);
+    }
+}
+TesterChecklistItemRepository.SIEVE_FIELDS = {
+    groupKey: { canFilter: true, canSort: true },
+    pageKey: { canFilter: true, canSort: true },
+    label: { canFilter: true, canSort: false },
+    order: { canFilter: true, canSort: true },
+    isActive: { canFilter: true, canSort: false },
+    searchTokens: { canFilter: true, canSort: false },
+    createdAt: { canFilter: true, canSort: true },
+};
+export const testerChecklistItemRepository = new TesterChecklistItemRepository();

package/dist/features/tester/repository/tester-checklist-response.repository.d.ts

@@ -0,0 +1,42 @@
+import { BaseRepository } from "../../../providers/db-firebase";
+import type { FirebaseSieveFields, FirebaseSieveResult, SieveModel } from "../../../providers/db-firebase";
+import { type TesterAnswer, type TesterChecklistResponseDocument } from "../schemas/firestore";
+export interface UpsertResponseInput {
+    testerId: string;
+    testerDisplayName: string;
+    checklistItemId: string;
+    groupKey: string;
+    pageKey: string;
+    answer?: TesterAnswer | null;
+    comment?: string;
+    screenshotUrl?: string;
+}
+export interface ChecklistItemCoverage {
+    checklistItemId: string;
+    groupKey: string;
+    pageKey: string;
+    yesCount: number;
+    noCount: number;
+    totalAnswered: number;
+}
+export interface CoverageReport {
+    itemCoverage: ChecklistItemCoverage[];
+    issues: TesterChecklistResponseDocument[];
+    totals: {
+        totalAnswered: number;
+        totalYes: number;
+        totalNo: number;
+    };
+}
+export declare class TesterChecklistResponseRepository extends BaseRepository<TesterChecklistResponseDocument> {
+    static readonly SIEVE_FIELDS: FirebaseSieveFields;
+    constructor();
+    /** Deterministic-ID upsert — the only mutation path for tester responses. */
+    upsertResponse(input: UpsertResponseInput): Promise<TesterChecklistResponseDocument>;
+    listForTester(testerId: string): Promise<TesterChecklistResponseDocument[]>;
+    list(model: SieveModel): Promise<FirebaseSieveResult<TesterChecklistResponseDocument>>;
+    markReviewed(id: string): Promise<TesterChecklistResponseDocument>;
+    /** Single collection scan (small table: testers x cases) — no join needed. */
+    getCoverageReport(): Promise<CoverageReport>;
+}
+export declare const testerChecklistResponseRepository: TesterChecklistResponseRepository;

package/dist/features/tester/repository/tester-checklist-response.repository.js

@@ -0,0 +1,98 @@
+import { BaseRepository } from "../../../providers/db-firebase";
+import { TESTER_CHECKLIST_RESPONSE_COLLECTION, TESTER_CHECKLIST_RESPONSE_FIELDS, createChecklistResponseId, } from "../schemas/firestore";
+export class TesterChecklistResponseRepository extends BaseRepository {
+    constructor() {
+        super(TESTER_CHECKLIST_RESPONSE_COLLECTION);
+    }
+    /** Deterministic-ID upsert — the only mutation path for tester responses. */
+    async upsertResponse(input) {
+        const id = createChecklistResponseId(input.testerId, input.checklistItemId);
+        const existing = await this.findById(id);
+        const patch = {
+            testerId: input.testerId,
+            testerDisplayName: input.testerDisplayName,
+            checklistItemId: input.checklistItemId,
+            groupKey: input.groupKey,
+            pageKey: input.pageKey,
+            status: "new",
+        };
+        if (input.answer !== undefined)
+            patch.answer = input.answer;
+        if (input.comment !== undefined)
+            patch.comment = input.comment;
+        if (input.screenshotUrl !== undefined)
+            patch.screenshotUrl = input.screenshotUrl;
+        if (existing) {
+            return this.update(id, patch);
+        }
+        return this.createWithId(id, {
+            answer: null,
+            ...patch,
+        });
+    }
+    async listForTester(testerId) {
+        const snapshot = await this.db
+            .collection(this.collection)
+            .where(TESTER_CHECKLIST_RESPONSE_FIELDS.TESTER_ID, "==", testerId)
+            .get();
+        return snapshot.docs.map((doc) => this.mapDoc(doc));
+    }
+    async list(model) {
+        return this.sieveQuery(model, TesterChecklistResponseRepository.SIEVE_FIELDS);
+    }
+    async markReviewed(id) {
+        return this.update(id, {
+            status: "reviewed",
+        });
+    }
+    /** Single collection scan (small table: testers x cases) — no join needed. */
+    async getCoverageReport() {
+        const snapshot = await this.db.collection(this.collection).get();
+        const docs = snapshot.docs.map((doc) => this.mapDoc(doc));
+        const byItem = new Map();
+        const issues = [];
+        let totalYes = 0;
+        let totalNo = 0;
+        for (const doc of docs) {
+            if (!doc.answer)
+                continue;
+            let entry = byItem.get(doc.checklistItemId);
+            if (!entry) {
+                entry = {
+                    checklistItemId: doc.checklistItemId,
+                    groupKey: doc.groupKey,
+                    pageKey: doc.pageKey,
+                    yesCount: 0,
+                    noCount: 0,
+                    totalAnswered: 0,
+                };
+                byItem.set(doc.checklistItemId, entry);
+            }
+            entry.totalAnswered += 1;
+            if (doc.answer === "yes") {
+                entry.yesCount += 1;
+                totalYes += 1;
+            }
+            else {
+                entry.noCount += 1;
+                totalNo += 1;
+                issues.push(doc);
+            }
+        }
+        return {
+            itemCoverage: Array.from(byItem.values()),
+            issues,
+            totals: { totalAnswered: totalYes + totalNo, totalYes, totalNo },
+        };
+    }
+}
+TesterChecklistResponseRepository.SIEVE_FIELDS = {
+    testerId: { canFilter: true, canSort: false },
+    checklistItemId: { canFilter: true, canSort: false },
+    groupKey: { canFilter: true, canSort: true },
+    pageKey: { canFilter: true, canSort: true },
+    answer: { canFilter: true, canSort: false },
+    status: { canFilter: true, canSort: false },
+    createdAt: { canFilter: true, canSort: true },
+};
+export const testerChecklistResponseRepository = new TesterChecklistResponseRepository();

package/dist/features/tester/schemas/firestore.d.ts

@@ -0,0 +1,85 @@
+/**
+ * Tester Feature Firestore Document Types & Constants
+ *
+ * Two distinct collections, deliberately separate:
+ *  - TesterChecklistItemDocument — the admin-authored catalog of test cases (mirrors FAQs).
+ *  - TesterChecklistResponseDocument — one doc per (tester, case) answer, upserted by testerId+checklistItemId.
+ */
+import type { BaseDocument } from "../../../_internal/shared/types/base-document";
+export interface TesterChecklistItemDocument extends BaseDocument {
+    groupKey: string;
+    groupLabel: string;
+    pageKey: string;
+    pageLabel: string;
+    label: string;
+    description?: string;
+    href?: string;
+    order: number;
+    isActive: boolean;
+    searchTokens: string[];
+}
+export declare const TESTER_CHECKLIST_ITEM_COLLECTION: "testerChecklistItems";
+export declare const TESTER_CHECKLIST_ITEM_ID_PREFIX: "checklist-";
+export declare const TESTER_CHECKLIST_ITEM_INDEXED_FIELDS: readonly ["groupKey", "pageKey", "order", "isActive", "searchTokens", "createdAt"];
+export declare const DEFAULT_TESTER_CHECKLIST_ITEM_DATA: Partial<TesterChecklistItemDocument>;
+export type TesterChecklistItemCreateInput = Omit<TesterChecklistItemDocument, "id" | "createdAt" | "updatedAt" | "searchTokens">;
+export type TesterChecklistItemUpdateInput = Partial<Pick<TesterChecklistItemDocument, "groupKey" | "groupLabel" | "pageKey" | "pageLabel" | "label" | "description" | "href" | "order" | "isActive">>;
+export declare const testerChecklistItemQueryHelpers: {
+    readonly byGroup: (groupKey: string) => readonly ["groupKey", "==", string];
+    readonly byPage: (pageKey: string) => readonly ["pageKey", "==", string];
+    readonly active: () => readonly ["isActive", "==", true];
+};
+export declare function slugifyChecklistLabel(label: string): string;
+export declare function createChecklistItemId(groupKey: string, pageKey: string, label: string): string;
+export type TesterAnswer = "yes" | "no";
+export type TesterFeedbackStatus = "new" | "reviewed";
+export interface TesterChecklistResponseDocument extends BaseDocument {
+    testerId: string;
+    testerDisplayName: string;
+    checklistItemId: string;
+    groupKey: string;
+    pageKey: string;
+    answer: TesterAnswer | null;
+    comment?: string;
+    screenshotUrl?: string;
+    status: TesterFeedbackStatus;
+}
+export declare const TESTER_CHECKLIST_RESPONSE_COLLECTION: "testerChecklistResponses";
+export declare const TESTER_CHECKLIST_RESPONSE_INDEXED_FIELDS: readonly ["testerId", "checklistItemId", "groupKey", "pageKey", "answer", "status", "createdAt"];
+export declare const DEFAULT_TESTER_CHECKLIST_RESPONSE_DATA: Partial<TesterChecklistResponseDocument>;
+export declare function createChecklistResponseId(testerId: string, checklistItemId: string): string;
+export declare const testerChecklistResponseQueryHelpers: {
+    readonly byTester: (testerId: string) => readonly ["testerId", "==", string];
+    readonly byItem: (checklistItemId: string) => readonly ["checklistItemId", "==", string];
+    readonly byAnswer: (answer: TesterAnswer) => readonly ["answer", "==", TesterAnswer];
+    readonly byStatus: (status: TesterFeedbackStatus) => readonly ["status", "==", TesterFeedbackStatus];
+};
+export declare const TESTER_CHECKLIST_ITEM_FIELDS: {
+    readonly ID: "id";
+    readonly GROUP_KEY: "groupKey";
+    readonly GROUP_LABEL: "groupLabel";
+    readonly PAGE_KEY: "pageKey";
+    readonly PAGE_LABEL: "pageLabel";
+    readonly LABEL: "label";
+    readonly DESCRIPTION: "description";
+    readonly HREF: "href";
+    readonly ORDER: "order";
+    readonly IS_ACTIVE: "isActive";
+    readonly SEARCH_TOKENS: "searchTokens";
+    readonly CREATED_AT: "createdAt";
+    readonly UPDATED_AT: "updatedAt";
+};
+export declare const TESTER_CHECKLIST_RESPONSE_FIELDS: {
+    readonly ID: "id";
+    readonly TESTER_ID: "testerId";
+    readonly TESTER_DISPLAY_NAME: "testerDisplayName";
+    readonly CHECKLIST_ITEM_ID: "checklistItemId";
+    readonly GROUP_KEY: "groupKey";
+    readonly PAGE_KEY: "pageKey";
+    readonly ANSWER: "answer";
+    readonly COMMENT: "comment";
+    readonly SCREENSHOT_URL: "screenshotUrl";
+    readonly STATUS: "status";
+    readonly CREATED_AT: "createdAt";
+    readonly UPDATED_AT: "updatedAt";
+};

package/dist/features/tester/schemas/firestore.js

@@ -0,0 +1,93 @@
+/**
+ * Tester Feature Firestore Document Types & Constants
+ *
+ * Two distinct collections, deliberately separate:
+ *  - TesterChecklistItemDocument — the admin-authored catalog of test cases (mirrors FAQs).
+ *  - TesterChecklistResponseDocument — one doc per (tester, case) answer, upserted by testerId+checklistItemId.
+ */
+import { generateChecklistItemId } from "../../../utils/id-generators";
+export const TESTER_CHECKLIST_ITEM_COLLECTION = "testerChecklistItems";
+export const TESTER_CHECKLIST_ITEM_ID_PREFIX = "checklist-";
+export const TESTER_CHECKLIST_ITEM_INDEXED_FIELDS = [
+    "groupKey",
+    "pageKey",
+    "order",
+    "isActive",
+    "searchTokens",
+    "createdAt",
+];
+export const DEFAULT_TESTER_CHECKLIST_ITEM_DATA = {
+    order: 0,
+    isActive: true,
+    searchTokens: [],
+};
+export const testerChecklistItemQueryHelpers = {
+    byGroup: (groupKey) => ["groupKey", "==", groupKey],
+    byPage: (pageKey) => ["pageKey", "==", pageKey],
+    active: () => ["isActive", "==", true],
+};
+export function slugifyChecklistLabel(label) {
+    return label
+        .toLowerCase()
+        .trim()
+        .replace(/[^\w\s-]/g, "")
+        .replace(/[\s_-]+/g, "-")
+        .replace(/^-+|-+$/g, "")
+        .slice(0, 40);
+}
+export function createChecklistItemId(groupKey, pageKey, label) {
+    return generateChecklistItemId({ groupKey, pageKey, label });
+}
+export const TESTER_CHECKLIST_RESPONSE_COLLECTION = "testerChecklistResponses";
+export const TESTER_CHECKLIST_RESPONSE_INDEXED_FIELDS = [
+    "testerId",
+    "checklistItemId",
+    "groupKey",
+    "pageKey",
+    "answer",
+    "status",
+    "createdAt",
+];
+export const DEFAULT_TESTER_CHECKLIST_RESPONSE_DATA = {
+    answer: null,
+    status: "new",
+};
+export function createChecklistResponseId(testerId, checklistItemId) {
+    return `${testerId}__${checklistItemId}`;
+}
+export const testerChecklistResponseQueryHelpers = {
+    byTester: (testerId) => ["testerId", "==", testerId],
+    byItem: (checklistItemId) => ["checklistItemId", "==", checklistItemId],
+    byAnswer: (answer) => ["answer", "==", answer],
+    byStatus: (status) => ["status", "==", status],
+};
+// --- Field name constants -----------------------------------------------------
+export const TESTER_CHECKLIST_ITEM_FIELDS = {
+    ID: "id",
+    GROUP_KEY: "groupKey",
+    GROUP_LABEL: "groupLabel",
+    PAGE_KEY: "pageKey",
+    PAGE_LABEL: "pageLabel",
+    LABEL: "label",
+    DESCRIPTION: "description",
+    HREF: "href",
+    ORDER: "order",
+    IS_ACTIVE: "isActive",
+    SEARCH_TOKENS: "searchTokens",
+    CREATED_AT: "createdAt",
+    UPDATED_AT: "updatedAt",
+};
+export const TESTER_CHECKLIST_RESPONSE_FIELDS = {
+    ID: "id",
+    TESTER_ID: "testerId",
+    TESTER_DISPLAY_NAME: "testerDisplayName",
+    CHECKLIST_ITEM_ID: "checklistItemId",
+    GROUP_KEY: "groupKey",
+    PAGE_KEY: "pageKey",
+    ANSWER: "answer",
+    COMMENT: "comment",
+    SCREENSHOT_URL: "screenshotUrl",
+    STATUS: "status",
+    CREATED_AT: "createdAt",
+    UPDATED_AT: "updatedAt",
+};

package/dist/features/tester/schemas/index.d.ts

@@ -0,0 +1 @@
+export * from "./firestore";