@mohasinac/appkit 3.6.5 → 3.8.0

package/dist/features/stores/components/StoresIndexListing.js

@@ -4,7 +4,7 @@ import { Row, SIEVE_OP, Stack, sieveFilter } from "@mohasinac/appkit";
 import { useState, useCallback, useMemo } from "react";
 import { useUrlTable } from "../../../react/hooks/useUrlTable";
 import { useStores } from "../hooks/useStores";
-import { BulkActionBar, Div, ListingFilterDrawer, ListingToolbar, Pagination, Text } from "../../../ui";
+import { BulkActionBar, Div, ListingFilterDrawer, ListingToolbar, Pagination, Text, StickyToolbar } from "../../../ui";
 import { ROUTES } from "../../../next";
 import { InteractiveStoreCard } from "./InteractiveStoreCard";
 import { StoreFilters } from "./StoreFilters";
@@ -161,7 +161,7 @@ export function StoresIndexListing({ initialData }) {
                         disabled: selection.selectedCount !== 1,
                         onClick: () => { selection.clearSelection(); },
                     },
-                ] }), totalPages > 1 && (_jsx(Row, { border: "bottom", className: "sticky top-[calc(var(--header-height,0px)+44px)] z-10 backdrop-blur-sm", surface: "default", padding: "toolbar", justify: "center", children: _jsx(Pagination, { currentPage: table.getNumber("page", 1), totalPages: totalPages, onPageChange: (p) => table.setPage(p) }) })), _jsx(Div, { padding: "y-lg", children: isLoading ? (_jsx(Div, { layout: "grid", gap: "6", className: "grid-cols-1 sm:grid-cols-2 lg:grid-cols-3", children: Array.from({ length: 6 }).map((_, i) => (_jsxs(Div, { className: `${__O.hidden} animate-pulse`, border: "subtle", rounded: "xl", children: [_jsx(Div, { className: "aspect-video", surface: "subtle" }), _jsxs(Div, { className: `${__P.p4} space-y-[0.625rem]`, children: [_jsx(Row, { align: "center", gap: "sm", children: _jsx(Div, { className: "h-10 w-10", surface: "subtle", rounded: "lg" }) }), _jsx(Div, { className: "h-4 w-2/3", surface: "subtle", rounded: "default" }), _jsx(Div, { className: "h-3 w-full", surface: "subtle", rounded: "default" }), _jsx(Div, { className: "h-3 w-1/2", surface: "subtle", rounded: "default" })] })] }, i))) })) : stores.length === 0 ? (_jsx(Text, { paddingY: "4xl", color: "muted", size: "sm", align: "start", children: "No stores found." })) : view === "list" ? (_jsx(Stack, { className: "divide-y divide-zinc-100 divide-[var(--appkit-color-border-subtle)]", border: "subtle", rounded: "xl", children: stores.map((store) => {
+                ] }), totalPages > 1 && (_jsx(StickyToolbar, { offset: "header+pagination", tone: "translucent", border: true, padding: "toolbar", children: _jsx(Row, { justify: "center", children: _jsx(Pagination, { currentPage: table.getNumber("page", 1), totalPages: totalPages, onPageChange: (p) => table.setPage(p) }) }) })), _jsx(Div, { padding: "y-lg", children: isLoading ? (_jsx(Div, { layout: "grid", gap: "6", className: "grid-cols-1 sm:grid-cols-2 lg:grid-cols-3", children: Array.from({ length: 6 }).map((_, i) => (_jsxs(Div, { className: `${__O.hidden} animate-pulse`, border: "subtle", rounded: "xl", children: [_jsx(Div, { className: "aspect-video", surface: "subtle" }), _jsxs(Div, { className: `${__P.p4} space-y-[0.625rem]`, children: [_jsx(Row, { align: "center", gap: "sm", children: _jsx(Div, { className: "h-10 w-10", surface: "subtle", rounded: "lg" }) }), _jsx(Div, { className: "h-4 w-2/3", surface: "subtle", rounded: "default" }), _jsx(Div, { className: "h-3 w-full", surface: "subtle", rounded: "default" }), _jsx(Div, { className: "h-3 w-1/2", surface: "subtle", rounded: "default" })] })] }, i))) })) : stores.length === 0 ? (_jsx(Text, { paddingY: "4xl", color: "muted", size: "sm", align: "start", children: "No stores found." })) : view === "list" ? (_jsx(Stack, { className: "divide-y divide-zinc-100 divide-[var(--appkit-color-border-subtle)]", border: "subtle", rounded: "xl", children: stores.map((store) => {
                         const storeKey = store.storeSlug ?? store.id;
                         return (_jsx(InteractiveStoreCard, { store: store, href: String(ROUTES.PUBLIC.STORE_DETAIL(storeKey)), selectable: selection.isSelecting, isSelected: selection.isSelected(store.id ?? store.storeSlug), onSelect: (id, sel) => { void sel; selection.toggle(id); } }, storeKey));
                     }) })) : (_jsx(Div, { layout: "grid", gap: "6", className: "grid-cols-1 sm:grid-cols-2 lg:grid-cols-3", children: stores.map((store) => {

package/dist/features/stores/repository/store.repository.js

@@ -119,6 +119,9 @@ export class StoreRepository extends BaseRepository {
             [STORE_FIELDS.STATUS]: { canFilter: true, canSort: false },
             [STORE_FIELDS.IS_PUBLIC]: { canFilter: true, canSort: false },
             [STORE_FIELDS.CREATED_AT]: { canFilter: false, canSort: true },
+            "stats.itemsSold": { canFilter: false, canSort: true },
+            "stats.averageRating": { canFilter: false, canSort: true },
+            "stats.totalProducts": { canFilter: true, canSort: false },
         };
         let baseQuery = this.getCollection();
         if (activeOnly) {

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

@@ -50,6 +50,10 @@ export type StoreStatus = (typeof StoreStatusValues)[keyof typeof StoreStatusVal
 export interface StoreDocument extends BaseDocument {
     storeSlug: string;
     ownerId: string;
+    /** Tester sandbox flag — set on the shared admin-seeded test store; swept by testerSandboxCleanup. */
+    isTestData?: boolean;
+    /** When isTestData, the cutoff after which testerSandboxCleanup deletes this doc. */
+    testDataExpiresAt?: Date;
     storeName: string;
     storeDescription?: string;
     storeCategory?: string;

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

@@ -0,0 +1,69 @@
+import { z } from "zod";
+import type { TesterChecklistItemDocument } from "../schemas/firestore";
+export declare const checklistItemCreateSchema: z.ZodObject<{
+    groupKey: z.ZodString;
+    groupLabel: z.ZodString;
+    pageKey: z.ZodString;
+    pageLabel: z.ZodString;
+    label: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    href: z.ZodOptional<z.ZodString>;
+    order: z.ZodDefault<z.ZodNumber>;
+    isActive: z.ZodDefault<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    label: string;
+    order: number;
+    isActive: boolean;
+    groupKey: string;
+    pageKey: string;
+    groupLabel: string;
+    pageLabel: string;
+    href?: string | undefined;
+    description?: string | undefined;
+}, {
+    label: string;
+    groupKey: string;
+    pageKey: string;
+    groupLabel: string;
+    pageLabel: string;
+    href?: string | undefined;
+    description?: string | undefined;
+    order?: number | undefined;
+    isActive?: boolean | undefined;
+}>;
+export declare const checklistItemUpdateSchema: z.ZodObject<{
+    groupKey: z.ZodOptional<z.ZodString>;
+    groupLabel: z.ZodOptional<z.ZodString>;
+    pageKey: z.ZodOptional<z.ZodString>;
+    pageLabel: z.ZodOptional<z.ZodString>;
+    label: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+    href: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+    order: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+    isActive: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+}, "strip", z.ZodTypeAny, {
+    label?: string | undefined;
+    href?: string | undefined;
+    description?: string | undefined;
+    order?: number | undefined;
+    isActive?: boolean | undefined;
+    groupKey?: string | undefined;
+    pageKey?: string | undefined;
+    groupLabel?: string | undefined;
+    pageLabel?: string | undefined;
+}, {
+    label?: string | undefined;
+    href?: string | undefined;
+    description?: string | undefined;
+    order?: number | undefined;
+    isActive?: boolean | undefined;
+    groupKey?: string | undefined;
+    pageKey?: string | undefined;
+    groupLabel?: string | undefined;
+    pageLabel?: string | undefined;
+}>;
+export type ChecklistItemCreateInput = z.infer<typeof checklistItemCreateSchema>;
+export type ChecklistItemUpdateInput = z.infer<typeof checklistItemUpdateSchema>;
+export declare function createChecklistItem(input: ChecklistItemCreateInput): Promise<TesterChecklistItemDocument>;
+export declare function updateChecklistItem(id: string, input: ChecklistItemUpdateInput): Promise<TesterChecklistItemDocument>;
+export declare function deleteChecklistItem(id: string): Promise<void>;

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

@@ -0,0 +1,42 @@
+import { z } from "zod";
+import { serverLogger } from "../../../monitoring";
+import { testerChecklistItemRepository } from "../repository/tester-checklist-item.repository";
+// --- Schemas --------------------------------------------------------------
+const checklistItemBaseSchema = z.object({
+    groupKey: z.string().min(1).max(100),
+    groupLabel: z.string().min(1).max(200),
+    pageKey: z.string().min(1).max(100),
+    pageLabel: z.string().min(1).max(200),
+    label: z.string().min(3).max(500),
+    description: z.string().max(2000).optional(),
+    href: z.string().max(300).optional(),
+    order: z.number().int().min(0).default(0),
+    isActive: z.boolean().default(true),
+});
+export const checklistItemCreateSchema = checklistItemBaseSchema;
+export const checklistItemUpdateSchema = checklistItemBaseSchema.partial();
+// --- Actions --------------------------------------------------------------
+export async function createChecklistItem(input) {
+    const item = await testerChecklistItemRepository.createItem({
+        groupKey: input.groupKey,
+        groupLabel: input.groupLabel,
+        pageKey: input.pageKey,
+        pageLabel: input.pageLabel,
+        label: input.label,
+        description: input.description,
+        href: input.href,
+        order: input.order ?? 0,
+        isActive: input.isActive ?? true,
+    });
+    serverLogger.info("createChecklistItem", { itemId: item.id });
+    return item;
+}
+export async function updateChecklistItem(id, input) {
+    const item = await testerChecklistItemRepository.update(id, input);
+    serverLogger.info("updateChecklistItem", { itemId: id });
+    return item;
+}
+export async function deleteChecklistItem(id) {
+    await testerChecklistItemRepository.delete(id);
+    serverLogger.info("deleteChecklistItem", { itemId: id });
+}

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

@@ -0,0 +1 @@
+export * from "./checklist-item-actions";

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

@@ -0,0 +1 @@
+export * from "./checklist-item-actions";

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

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

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

@@ -0,0 +1,22 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useQuery } from "@tanstack/react-query";
+import { Card, Stack, Text } from "../../../ui";
+import { MediaImage } from "../../media/MediaImage";
+import { apiClient } from "../../../http";
+import { ADMIN_ENDPOINTS } from "../../../constants/api-endpoints";
+export function AdminTesterFeedbackIssuesView() {
+    const query = useQuery({
+        queryKey: ["admin", "tester-feedback", "report"],
+        queryFn: async () => {
+            const res = await apiClient.get(ADMIN_ENDPOINTS.TESTER_FEEDBACK_REPORT);
+            return res?.data ?? res;
+        },
+    });
+    const issues = query.data?.issues ?? [];
+    if (query.isLoading)
+        return _jsx(Text, { color: "muted", children: "Loading issues\u2026" });
+    if (issues.length === 0)
+        return _jsx(Text, { color: "muted", children: "No \"No\" answers recorded yet." });
+    return (_jsx(Stack, { gap: "sm", children: issues.map((issue) => (_jsx(Card, { padding: "md", variant: "default", children: _jsxs(Stack, { gap: "xs", children: [_jsxs(Text, { weight: "semibold", children: [issue.groupKey, " / ", issue.pageKey] }), _jsxs(Text, { size: "sm", color: "muted", children: ["Reported by ", issue.testerDisplayName] }), issue.comment && _jsx(Text, { size: "sm", children: issue.comment }), issue.screenshotUrl && (_jsx(MediaImage, { src: issue.screenshotUrl, alt: "Tester screenshot", size: "card" }))] }) }, issue.id))) }));
+}

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

@@ -0,0 +1,3 @@
+import React from "react";
+export type AdminTesterFeedbackListViewProps = Record<string, never>;
+export declare function AdminTesterFeedbackListView(_props: AdminTesterFeedbackListViewProps): React.JSX.Element;

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

@@ -0,0 +1,100 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { useApiMutation } from "../../../client";
+import { SIEVE_OP, sieveFilter } from "../../../utils/sieve-builder";
+import { sortBy } from "../../../constants/sort";
+import { TESTER_CHECKLIST_RESPONSE_FIELDS } from "../schemas/firestore";
+import { useQueryClient } from "@tanstack/react-query";
+import { FilterChipGroup, RowActionMenu, Stack, Text } from "../../../ui";
+import { ADMIN_ENDPOINTS } from "../../../constants/api-endpoints";
+import { ACTIONS } from "../../../_internal/shared/actions/action-registry";
+import { toRecordArray, toRelativeDate, toStringValue, } from "../../admin/hooks/useAdminListingData";
+import { DataListingView } from "../../admin/components/DataListingView";
+import { apiClient } from "../../../http";
+const COLUMNS = [
+    {
+        key: "primary",
+        header: "Tester / Case",
+        sortable: true,
+        render: (row) => (_jsxs(Stack, { gap: "xs", children: [_jsx(Text, { weight: "semibold", color: "primary", children: row.primary }), _jsx(Text, { size: "xs", color: "muted", children: row.secondary })] })),
+    },
+    {
+        key: "answer",
+        header: "Answer",
+        className: "w-24",
+        render: (row) => (_jsx(Text, { weight: "medium", color: row.answer === "no" ? "error" : "success", children: row.answer === "no" ? "No" : row.answer === "yes" ? "Yes" : "—" })),
+    },
+    {
+        key: "status",
+        header: "Status",
+        className: "w-28",
+        render: (row) => _jsx(Text, { size: "sm", color: "muted", children: row.status }),
+    },
+    {
+        key: "updatedAt",
+        header: "Updated",
+        className: "w-32",
+        render: (row) => _jsx(Text, { size: "sm", color: "muted", children: row.updatedAt }),
+    },
+];
+export function AdminTesterFeedbackListView(_props) {
+    const queryClient = useQueryClient();
+    const patchMutation = useApiMutation({
+        mutationFn: async (id) => {
+            await apiClient.patch(ADMIN_ENDPOINTS.TESTER_FEEDBACK_BY_ID(id), {});
+        },
+        onSuccess: () => {
+            queryClient.invalidateQueries({ queryKey: ["admin", "tester-feedback"] });
+        },
+    });
+    const config = {
+        portal: "admin",
+        title: "All Submissions",
+        searchPlaceholder: "Search tester, comment, or case",
+        emptyLabel: "No feedback submitted yet",
+        filterKeys: ["answer", "status"],
+        defaultSort: sortBy(TESTER_CHECKLIST_RESPONSE_FIELDS.CREATED_AT, "DESC"),
+        queryKey: ["admin", "tester-feedback", "listing"],
+        endpoint: ADMIN_ENDPOINTS.TESTER_FEEDBACK,
+        sortOptions: [
+            { value: sortBy(TESTER_CHECKLIST_RESPONSE_FIELDS.CREATED_AT, "DESC"), label: "Newest" },
+            { value: sortBy(TESTER_CHECKLIST_RESPONSE_FIELDS.CREATED_AT, "ASC"), label: "Oldest" },
+        ],
+        columns: COLUMNS,
+        mapRows: (response) => toRecordArray(response.items).map((item, index) => ({
+            id: toStringValue(item.id, `feedback-${index}`),
+            primary: toStringValue(item.testerDisplayName, "Unknown tester"),
+            secondary: `${toStringValue(item.groupKey, "")} / ${toStringValue(item.pageKey, "")}${item.comment ? " — " + toStringValue(item.comment, "") : ""}`,
+            answer: toStringValue(item.answer, ""),
+            status: toStringValue(item.status, "new"),
+            updatedAt: toRelativeDate(item.updatedAt ?? item.createdAt),
+            screenshotUrl: item.screenshotUrl ? toStringValue(item.screenshotUrl, "") : undefined,
+        })),
+        getTotal: (response, mappedRows) => typeof response.total === "number" ? response.total : mappedRows.length,
+        buildFilters: (state) => {
+            const parts = [];
+            if (state.answer && state.answer !== "All")
+                parts.push(sieveFilter("answer", SIEVE_OP.EQ, state.answer));
+            if (state.status && state.status !== "All")
+                parts.push(sieveFilter("status", SIEVE_OP.EQ, state.status));
+            return parts.join(",") || undefined;
+        },
+        renderFilterPanel: ({ pendingFilters, setPendingFilters }) => (_jsxs(_Fragment, { children: [_jsx(FilterChipGroup, { label: "Answer", tabs: [
+                        { id: "All", label: "All" },
+                        { id: "yes", label: "Yes" },
+                        { id: "no", label: "No" },
+                    ], value: pendingFilters.answer || "", onChange: (v) => setPendingFilters((p) => ({ ...p, answer: v })) }), _jsx(FilterChipGroup, { label: "Status", tabs: [
+                        { id: "All", label: "All" },
+                        { id: "new", label: "New" },
+                        { id: "reviewed", label: "Reviewed" },
+                    ], value: pendingFilters.status || "", onChange: (v) => setPendingFilters((p) => ({ ...p, status: v })) })] })),
+        renderRowActions: (row) => (_jsx(RowActionMenu, { actions: [
+                {
+                    label: ACTIONS.ADMIN["mark-feedback-reviewed"].label,
+                    disabled: row.status === "reviewed",
+                    onClick: () => patchMutation.mutate(row.id),
+                },
+            ] })),
+    };
+    return _jsx(DataListingView, { config: config });
+}

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

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

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,29 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Button, Heading, Row, Stack, Tabs, TabsContent, TabsList, TabsTrigger, useToast } from "../../../ui";
+import { apiClient } from "../../../http";
+import { normalizeError } from "../../../errors/normalize";
+import { ACTIONS } from "../../../_internal/shared/actions/action-registry";
+import { ADMIN_ENDPOINTS } from "../../../constants/api-endpoints";
+import { AdminTesterFeedbackReportView } from "./AdminTesterFeedbackReportView";
+import { AdminTesterFeedbackIssuesView } from "./AdminTesterFeedbackIssuesView";
+import { AdminTesterFeedbackListView } from "./AdminTesterFeedbackListView";
+export function AdminTesterFeedbackView() {
+    const { showToast } = useToast();
+    const handleExportReport = async () => {
+        try {
+            const blob = await apiClient.blob(ADMIN_ENDPOINTS.TESTER_FEEDBACK_EXPORT);
+            const url = URL.createObjectURL(blob);
+            const a = document.createElement("a");
+            a.href = url;
+            a.download = `tester-feedback-report-${new Date().toISOString().slice(0, 10)}.md`;
+            a.click();
+            URL.revokeObjectURL(url);
+        }
+        catch (_err) {
+            void normalizeError(_err);
+            showToast("Report export failed.", "error");
+        }
+    };
+    return (_jsxs(Stack, { gap: "lg", children: [_jsxs(Row, { justify: "between", align: "center", wrap: true, children: [_jsx(Heading, { level: 1, children: "Tester Feedback" }), _jsx(Button, { variant: "ghost", action: ACTIONS.ADMIN["export-tester-feedback"], onClick: handleExportReport })] }), _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;