@aglyn/plugins-marketplace 1.0.0-beta.143

package/src/lib/components/listing-reviews.component.js

@@ -0,0 +1,419 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */ 'use client';
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { CardDisplay } from "@aglyn/shared-ui-jsx";
+import { useSnackbar } from "@aglyn/shared-ui-snackstack";
+import { ceilingedWindow, collectionCeiling, useFirestore, useFirestoreCollection, useUser } from "@aglyn/tenant-feature-instance";
+import { Alert, Avatar, Button, Chip, Divider, Rating, Stack, TextField, Typography } from "@mui/material";
+import { collection } from "firebase/firestore";
+import { useCallback, useEffect, useMemo, useState } from "react";
+import { ListPagination } from "@aglyn/shared-ui-jsx/components/list-pagination.component";
+import { TABLE_PAGE_SIZE_DEFAULT } from "@aglyn/shared-ui-jsx/const/table-pagination";
+import { pluginDocsHelp } from "@aglyn/aglyn";
+import { authorizedFetch } from "@aglyn/shared-util-http/authorized-token";
+import ReportTarget from "./report-target.component.js";
+/**
+ * How many review documents this card reads.
+ *
+ * A CEILING, not a page size. Three things below are computed over the whole
+ * set — the hidden-review filter, the newest-first sort, and finding the
+ * reader's OWN review to seed the form — so a server page would be a page of
+ * candidates and a reader whose review sat past the first ten would be shown
+ * an empty form over a review they had already written.
+ */ const REVIEW_CEILING = 200;
+/**
+ * Ratings and comments on a listing (AGL-655).
+ *
+ * Reads the subcollection directly — it is public-read, so there is no
+ * value in proxying it through an API. Writes go through
+ * `/api/marketplace/reviews`, which owns every rule that matters: only
+ * accounts that installed the listing may rate it, the publishing org
+ * cannot review itself, and the aggregates it maintains are frozen from
+ * client writes.
+ *
+ * The star input is offered to everyone and refused server-side rather than
+ * hidden, because "you must install this to rate it" is worth saying out
+ * loud — a control that silently does nothing teaches nothing.
+ */ export function ListingReviews({ listingId, listing }) {
+    var _ref, _ref1;
+    const firestore = useFirestore();
+    const { data: user } = useUser();
+    const { enqueueSnackbar } = useSnackbar();
+    const uid = user == null ? void 0 : user.uid;
+    // Rating (not commenting) requires a verified email (AGL-865). We can't see
+    // the install pins from here, so the "installed" half is still enforced
+    // server-side; the email half we can reflect in the control's state.
+    const emailVerified = Boolean(user == null ? void 0 : user.emailVerified);
+    const { data: reviewDocs } = useFirestoreCollection(/*
+     * ORDERED AND CEILINGED, with a probe (AGL-2501).
+     *
+     * `limit(100)` alone is answered in DOCUMENT-ID order, and a review's
+     * document id is its author's uid — so the hundred were a pseudo-random
+     * hundred of the reviewers, and on a popular listing the reviews past
+     * them were not merely unrendered but unreachable, because nothing drew
+     * them and no control asked for more.
+     *
+     * Ordering on the document NAME changes which rows come back only in the
+     * sense that the walk is now total: every reviewer is reachable by
+     * paging. It is not chronological and nothing here claims it is — the
+     * sort below puts the newest first, which it may do because it holds the
+     * whole ceiling rather than a slice of it.
+     *
+     * `orderBy('updatedAtMs')` would have been the tempting fix and is the
+     * dangerous one: it matches only documents that HAVE the field, so a
+     * review written before that field existed would vanish from a listing's
+     * page rather than sort oddly on it.
+     */ ()=>collectionCeiling(collection(firestore, 'marketplaceListings', listingId, 'reviews'), REVIEW_CEILING), [
+        firestore,
+        listingId
+    ], {
+        idField: '$id'
+    });
+    const { rows: readReviews, truncated: reviewsTruncated } = ceilingedWindow(reviewDocs, REVIEW_CEILING);
+    const reviews = useMemo(()=>[
+            ...readReviews
+        ].filter((entry)=>!entry.hidden).sort((a, b)=>{
+            var _b_updatedAtMs, _a_updatedAtMs;
+            return ((_b_updatedAtMs = b.updatedAtMs) != null ? _b_updatedAtMs : 0) - ((_a_updatedAtMs = a.updatedAtMs) != null ? _a_updatedAtMs : 0);
+        }), // eslint-disable-next-line react-hooks/exhaustive-deps
+    [
+        reviewDocs
+    ]);
+    const mine = useMemo(()=>reviews.find((entry)=>entry.$id === uid), [
+        reviews,
+        uid
+    ]);
+    /*
+   * The page is a SLICE of what the card already holds, for the three reasons
+   * the ceiling exists: `hidden` is filtered after reading, the order on
+   * screen is not the order the query walks, and `mine` seeds the form above
+   * from anywhere in the set.
+   */ const [page, setPage] = useState(0);
+    const [pageSize, setPageSize] = useState(TABLE_PAGE_SIZE_DEFAULT);
+    const visibleReviews = useMemo(()=>reviews.slice(page * pageSize, page * pageSize + pageSize), [
+        reviews,
+        page,
+        pageSize
+    ]);
+    /*
+   * A new listing starts at page one. Page four of a listing with two pages
+   * does not exist, and an out-of-range page renders as an empty list with
+   * nothing saying why — which reads as the reviews having gone.
+   */ useEffect(()=>{
+        setPage(0);
+    }, [
+        listingId
+    ]);
+    const [rating, setRating] = useState(null);
+    const [comment, setComment] = useState('');
+    const [busy, setBusy] = useState(false);
+    useEffect(()=>{
+        var _ref, _ref1;
+        setRating((_ref = mine == null ? void 0 : mine.rating) != null ? _ref : null);
+        setComment((_ref1 = mine == null ? void 0 : mine.comment) != null ? _ref1 : '');
+    }, [
+        mine
+    ]);
+    const submit = useCallback(async ()=>{
+        if (busy || !rating && !comment.trim()) return;
+        setBusy(true);
+        try {
+            const response = await authorizedFetch(user, '/api/marketplace/reviews', {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json'
+                },
+                body: JSON.stringify({
+                    listingId,
+                    rating,
+                    comment: comment.trim()
+                })
+            });
+            const payload = await response.json().catch(()=>({}));
+            if (!response.ok) {
+                var _ref;
+                // 403 here is usually "you have not installed this" — actionable,
+                // so it reads as guidance rather than an error.
+                return void enqueueSnackbar((_ref = payload == null ? void 0 : payload.error) != null ? _ref : 'Could not post that', {
+                    variant: response.status === 403 ? 'warning' : 'error',
+                    allowDuplicate: true
+                });
+            }
+            enqueueSnackbar(mine ? 'Updated your review' : 'Thanks for the review', {
+                variant: 'success',
+                persist: false
+            });
+        } catch (error) {
+            console.error(error);
+            enqueueSnackbar('Could not post that', {
+                variant: 'error',
+                allowDuplicate: true
+            });
+        } finally{
+            setBusy(false);
+        }
+    }, [
+        busy,
+        rating,
+        comment,
+        user,
+        listingId,
+        mine,
+        enqueueSnackbar
+    ]);
+    const remove = useCallback(async ()=>{
+        if (busy || !mine) return;
+        setBusy(true);
+        try {
+            await authorizedFetch(user, '/api/marketplace/reviews', {
+                method: 'DELETE',
+                headers: {
+                    'Content-Type': 'application/json'
+                },
+                body: JSON.stringify({
+                    listingId
+                })
+            });
+            setRating(null);
+            setComment('');
+            enqueueSnackbar('Removed your review', {
+                variant: 'success',
+                persist: false
+            });
+        } finally{
+            setBusy(false);
+        }
+    }, [
+        busy,
+        mine,
+        user,
+        listingId,
+        enqueueSnackbar
+    ]);
+    const average = Number((_ref = listing == null ? void 0 : listing.ratingAverage) != null ? _ref : 0);
+    const ratingCount = Number((_ref1 = listing == null ? void 0 : listing.ratingCount) != null ? _ref1 : 0);
+    return /*#__PURE__*/ _jsx(CardDisplay, {
+        header: 'Ratings & comments',
+        help: pluginDocsHelp('installYourFirstPlugin', {
+            anchor: '#step-3-reviews'
+        }),
+        contentGutterX: true,
+        contentGutterY: true,
+        children: /*#__PURE__*/ _jsxs(Stack, {
+            spacing: 2,
+            children: [
+                /*#__PURE__*/ _jsx(Stack, {
+                    direction: "row",
+                    spacing: 1,
+                    sx: {
+                        alignItems: 'center'
+                    },
+                    children: ratingCount ? /*#__PURE__*/ _jsxs(_Fragment, {
+                        children: [
+                            /*#__PURE__*/ _jsx(Rating, {
+                                value: average,
+                                precision: 0.1,
+                                size: "small",
+                                readOnly: true
+                            }),
+                            /*#__PURE__*/ _jsx(Typography, {
+                                variant: "body2",
+                                color: "text.secondary",
+                                children: `${average} · ${ratingCount} rating${ratingCount === 1 ? '' : 's'}`
+                            })
+                        ]
+                    }) : /*#__PURE__*/ _jsx(Typography, {
+                        variant: "body2",
+                        color: "text.secondary",
+                        children: 'No ratings yet.'
+                    })
+                }),
+                uid ? /*#__PURE__*/ _jsxs(Stack, {
+                    spacing: 1,
+                    children: [
+                        /*#__PURE__*/ _jsx(Typography, {
+                            variant: "subtitle2",
+                            children: mine ? 'Your review' : 'Leave a review'
+                        }),
+                        /*#__PURE__*/ _jsxs(Stack, {
+                            direction: "row",
+                            spacing: 1,
+                            sx: {
+                                alignItems: 'center'
+                            },
+                            children: [
+                                /*#__PURE__*/ _jsx(Typography, {
+                                    variant: "caption",
+                                    sx: {
+                                        minWidth: 56
+                                    },
+                                    children: 'Rating'
+                                }),
+                                /*#__PURE__*/ _jsx(Rating, {
+                                    value: rating,
+                                    size: "small",
+                                    onChange: (_event, value)=>setRating(value),
+                                    disabled: busy || !emailVerified
+                                }),
+                                /*#__PURE__*/ _jsx(Typography, {
+                                    variant: "caption",
+                                    color: "text.secondary",
+                                    children: emailVerified ? 'Requires having installed this' : 'Verify your email to rate'
+                                })
+                            ]
+                        }),
+                        /*#__PURE__*/ _jsx(TextField, {
+                            size: "small",
+                            label: "Comment",
+                            placeholder: "Share how it worked out, or ask a question — anyone can comment",
+                            value: comment,
+                            onChange: (event)=>setComment(event.target.value),
+                            disabled: busy,
+                            multiline: true,
+                            minRows: 2,
+                            fullWidth: true
+                        }),
+                        /*#__PURE__*/ _jsxs(Stack, {
+                            direction: "row",
+                            spacing: 1,
+                            children: [
+                                /*#__PURE__*/ _jsx(Button, {
+                                    size: "small",
+                                    variant: "contained",
+                                    color: "primary",
+                                    disabled: busy || !rating && !comment.trim(),
+                                    onClick: ()=>void submit(),
+                                    children: busy ? 'Posting…' : mine ? 'Update' : 'Post'
+                                }),
+                                mine ? /*#__PURE__*/ _jsx(Button, {
+                                    size: "small",
+                                    disabled: busy,
+                                    onClick: ()=>void remove(),
+                                    children: 'Remove'
+                                }) : null
+                            ]
+                        })
+                    ]
+                }) : /*#__PURE__*/ _jsx(Typography, {
+                    variant: "body2",
+                    color: "text.secondary",
+                    children: 'Sign in to leave a rating or comment.'
+                }),
+                reviews.length ? /*#__PURE__*/ _jsxs(_Fragment, {
+                    children: [
+                        /*#__PURE__*/ _jsx(Divider, {}),
+                        /*#__PURE__*/ _jsx(Stack, {
+                            spacing: 2,
+                            children: visibleReviews.map((review)=>{
+                                var _review_displayName;
+                                const name = String((_review_displayName = review.displayName) != null ? _review_displayName : 'Someone');
+                                return /*#__PURE__*/ _jsxs(Stack, {
+                                    direction: "row",
+                                    spacing: 1.5,
+                                    sx: {
+                                        alignItems: 'flex-start'
+                                    },
+                                    children: [
+                                        /*#__PURE__*/ _jsx(Avatar, {
+                                            sx: {
+                                                width: 32,
+                                                height: 32,
+                                                fontSize: 14
+                                            },
+                                            children: name.trim().charAt(0).toUpperCase() || '?'
+                                        }),
+                                        /*#__PURE__*/ _jsxs(Stack, {
+                                            spacing: 0.25,
+                                            sx: {
+                                                flex: 1,
+                                                minWidth: 0
+                                            },
+                                            children: [
+                                                /*#__PURE__*/ _jsxs(Stack, {
+                                                    direction: "row",
+                                                    spacing: 1,
+                                                    sx: {
+                                                        alignItems: 'center',
+                                                        flexWrap: 'wrap'
+                                                    },
+                                                    children: [
+                                                        /*#__PURE__*/ _jsx(Typography, {
+                                                            variant: "body2",
+                                                            sx: {
+                                                                fontWeight: 600
+                                                            },
+                                                            children: name
+                                                        }),
+                                                        review.verifiedInstaller ? /*#__PURE__*/ _jsx(Chip, {
+                                                            size: "small",
+                                                            label: "Installed",
+                                                            color: "primary"
+                                                        }) : null,
+                                                        review.updatedAtMs ? /*#__PURE__*/ _jsx(Typography, {
+                                                            variant: "caption",
+                                                            color: "text.secondary",
+                                                            children: new Date(review.updatedAtMs).toLocaleDateString()
+                                                        }) : null
+                                                    ]
+                                                }),
+                                                review.rating ? /*#__PURE__*/ _jsx(Rating, {
+                                                    value: review.rating,
+                                                    size: "small",
+                                                    readOnly: true
+                                                }) : null,
+                                                review.comment ? /*#__PURE__*/ _jsx(Typography, {
+                                                    variant: "body2",
+                                                    color: "text.secondary",
+                                                    children: review.comment
+                                                }) : null,
+                                                uid && review.$id !== uid ? /*#__PURE__*/ _jsx(ReportTarget, {
+                                                    listingId: listingId,
+                                                    reviewUid: review.$id,
+                                                    label: `this review by ${name}`
+                                                }) : null
+                                            ]
+                                        })
+                                    ]
+                                }, review.$id);
+                            })
+                        }),
+                        /*#__PURE__*/ _jsx(ListPagination, {
+                            page: page,
+                            pageSize: pageSize,
+                            rowCount: visibleReviews.length,
+                            // The reviews this card HOLDS, after the hidden ones are
+                            // dropped — a slice of rows already read, so the total is
+                            // known exactly for the window. The alert below is what says
+                            // when the window itself is short of the listing.
+                            count: reviews.length,
+                            onPageChange: setPage,
+                            onPageSizeChange: setPageSize
+                        }),
+                        reviewsTruncated ? /*#__PURE__*/ _jsx(Alert, {
+                            severity: "info",
+                            children: `Showing ${REVIEW_CEILING} reviews, ordered by author. This ` + 'listing has more, and the rating summary above counts all ' + 'of them.'
+                        }) : null
+                    ]
+                }) : null
+            ]
+        })
+    });
+}
+ListingReviews.displayName = 'ListingReviews';
+export default ListingReviews;
+
+//# sourceMappingURL=listing-reviews.component.js.map

package/src/lib/components/listing-reviews.component.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/marketplace/src/lib/components/listing-reviews.component.tsx"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n'use client'\n\nimport { CardDisplay } from '@aglyn/shared-ui-jsx'\nimport { useSnackbar } from '@aglyn/shared-ui-snackstack'\nimport {\n  ceilingedWindow,\n  collectionCeiling,\n  useFirestore,\n  useFirestoreCollection,\n  useUser,\n} from '@aglyn/tenant-feature-instance'\nimport {\n  Alert,\n  Avatar,\n  Button,\n  Chip,\n  Divider,\n  Rating,\n  Stack,\n  TextField,\n  Typography,\n} from '@mui/material'\nimport { collection } from 'firebase/firestore'\nimport { useCallback, useEffect, useMemo, useState } from 'react'\nimport { ListPagination } from '@aglyn/shared-ui-jsx/components/list-pagination.component'\nimport { TABLE_PAGE_SIZE_DEFAULT } from '@aglyn/shared-ui-jsx/const/table-pagination'\nimport { pluginDocsHelp } from '@aglyn/aglyn'\nimport { authorizedFetch } from '@aglyn/shared-util-http/authorized-token'\nimport ReportTarget from './report-target.component'\n\n/**\n * How many review documents this card reads.\n *\n * A CEILING, not a page size. Three things below are computed over the whole\n * set — the hidden-review filter, the newest-first sort, and finding the\n * reader's OWN review to seed the form — so a server page would be a page of\n * candidates and a reader whose review sat past the first ten would be shown\n * an empty form over a review they had already written.\n */\nconst REVIEW_CEILING = 200\n\n/**\n * Ratings and comments on a listing (AGL-655).\n *\n * Reads the subcollection directly — it is public-read, so there is no\n * value in proxying it through an API. Writes go through\n * `/api/marketplace/reviews`, which owns every rule that matters: only\n * accounts that installed the listing may rate it, the publishing org\n * cannot review itself, and the aggregates it maintains are frozen from\n * client writes.\n *\n * The star input is offered to everyone and refused server-side rather than\n * hidden, because \"you must install this to rate it\" is worth saying out\n * loud — a control that silently does nothing teaches nothing.\n */\nexport function ListingReviews({\n  listingId,\n  listing,\n}: {\n  listingId: string\n  listing: Record<string, any> | undefined\n}) {\n  const firestore = useFirestore()\n  const { data: user } = useUser()\n  const { enqueueSnackbar } = useSnackbar()\n  const uid = (user as any)?.uid as string | undefined\n  // Rating (not commenting) requires a verified email (AGL-865). We can't see\n  // the install pins from here, so the \"installed\" half is still enforced\n  // server-side; the email half we can reflect in the control's state.\n  const emailVerified = Boolean((user as any)?.emailVerified)\n\n  const { data: reviewDocs } = useFirestoreCollection<any>(\n    /*\n     * ORDERED AND CEILINGED, with a probe (AGL-2501).\n     *\n     * `limit(100)` alone is answered in DOCUMENT-ID order, and a review's\n     * document id is its author's uid — so the hundred were a pseudo-random\n     * hundred of the reviewers, and on a popular listing the reviews past\n     * them were not merely unrendered but unreachable, because nothing drew\n     * them and no control asked for more.\n     *\n     * Ordering on the document NAME changes which rows come back only in the\n     * sense that the walk is now total: every reviewer is reachable by\n     * paging. It is not chronological and nothing here claims it is — the\n     * sort below puts the newest first, which it may do because it holds the\n     * whole ceiling rather than a slice of it.\n     *\n     * `orderBy('updatedAtMs')` would have been the tempting fix and is the\n     * dangerous one: it matches only documents that HAVE the field, so a\n     * review written before that field existed would vanish from a listing's\n     * page rather than sort oddly on it.\n     */\n    () =>\n      collectionCeiling(\n        collection(firestore, 'marketplaceListings', listingId, 'reviews'),\n        REVIEW_CEILING,\n      ),\n    [firestore, listingId],\n    { idField: '$id' },\n  )\n  const { rows: readReviews, truncated: reviewsTruncated } = ceilingedWindow<any>(\n    reviewDocs,\n    REVIEW_CEILING,\n  )\n\n  const reviews = useMemo(\n    () =>\n      [...readReviews]\n        .filter((entry: any) => !entry.hidden)\n        .sort((a: any, b: any) => (b.updatedAtMs ?? 0) - (a.updatedAtMs ?? 0)),\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n    [reviewDocs],\n  )\n  const mine = useMemo(\n    () => reviews.find((entry: any) => entry.$id === uid),\n    [reviews, uid],\n  )\n\n  /*\n   * The page is a SLICE of what the card already holds, for the three reasons\n   * the ceiling exists: `hidden` is filtered after reading, the order on\n   * screen is not the order the query walks, and `mine` seeds the form above\n   * from anywhere in the set.\n   */\n  const [page, setPage] = useState(0)\n  const [pageSize, setPageSize] = useState(TABLE_PAGE_SIZE_DEFAULT)\n  const visibleReviews = useMemo(\n    () => reviews.slice(page * pageSize, page * pageSize + pageSize),\n    [reviews, page, pageSize],\n  )\n  /*\n   * A new listing starts at page one. Page four of a listing with two pages\n   * does not exist, and an out-of-range page renders as an empty list with\n   * nothing saying why — which reads as the reviews having gone.\n   */\n  useEffect(() => {\n    setPage(0)\n  }, [listingId])\n\n  const [rating, setRating] = useState<number | null>(null)\n  const [comment, setComment] = useState('')\n  const [busy, setBusy] = useState(false)\n\n  useEffect(() => {\n    setRating(mine?.rating ?? null)\n    setComment(mine?.comment ?? '')\n  }, [mine])\n\n  const submit = useCallback(async () => {\n    if (busy || (!rating && !comment.trim())) return\n    setBusy(true)\n    try {\n      const response = await authorizedFetch(user, '/api/marketplace/reviews', {\n        method: 'POST',\n        headers: { 'Content-Type': 'application/json' },\n        body: JSON.stringify({ listingId, rating, comment: comment.trim() }),\n      })\n      const payload = await response.json().catch(() => ({}))\n      if (!response.ok) {\n        // 403 here is usually \"you have not installed this\" — actionable,\n        // so it reads as guidance rather than an error.\n        return void enqueueSnackbar(payload?.error ?? 'Could not post that', {\n          variant: response.status === 403 ? 'warning' : 'error',\n          allowDuplicate: true,\n        })\n      }\n      enqueueSnackbar(mine ? 'Updated your review' : 'Thanks for the review', {\n        variant: 'success',\n        persist: false,\n      })\n    } catch (error) {\n      console.error(error)\n      enqueueSnackbar('Could not post that', {\n        variant: 'error',\n        allowDuplicate: true,\n      })\n    } finally {\n      setBusy(false)\n    }\n  }, [busy, rating, comment, user, listingId, mine, enqueueSnackbar])\n\n  const remove = useCallback(async () => {\n    if (busy || !mine) return\n    setBusy(true)\n    try {\n      await authorizedFetch(user, '/api/marketplace/reviews', {\n        method: 'DELETE',\n        headers: { 'Content-Type': 'application/json' },\n        body: JSON.stringify({ listingId }),\n      })\n      setRating(null)\n      setComment('')\n      enqueueSnackbar('Removed your review', {\n        variant: 'success',\n        persist: false,\n      })\n    } finally {\n      setBusy(false)\n    }\n  }, [busy, mine, user, listingId, enqueueSnackbar])\n\n  const average = Number(listing?.ratingAverage ?? 0)\n  const ratingCount = Number(listing?.ratingCount ?? 0)\n\n  return (\n    <CardDisplay\n      header={'Ratings & comments'}\n      help={pluginDocsHelp('installYourFirstPlugin', {\n        anchor: '#step-3-reviews',\n      })}\n      contentGutterX\n      contentGutterY\n    >\n      <Stack spacing={2}>\n        <Stack direction=\"row\" spacing={1} sx={{ alignItems: 'center' }}>\n          {ratingCount ? (\n            <>\n              <Rating value={average} precision={0.1} size=\"small\" readOnly />\n              <Typography variant=\"body2\" color=\"text.secondary\">\n                {`${average} · ${ratingCount} rating${\n                  ratingCount === 1 ? '' : 's'\n                }`}\n              </Typography>\n            </>\n          ) : (\n            <Typography variant=\"body2\" color=\"text.secondary\">\n              {'No ratings yet.'}\n            </Typography>\n          )}\n        </Stack>\n\n        {uid ? (\n          <Stack spacing={1}>\n            <Typography variant=\"subtitle2\">\n              {mine ? 'Your review' : 'Leave a review'}\n            </Typography>\n            {/* Rating and comment are distinct affordances (AGL-865): a rating\n                is gated on a verified email + an install and moves the score;\n                a comment is open to anyone signed in. */}\n            <Stack direction=\"row\" spacing={1} sx={{ alignItems: 'center' }}>\n              <Typography variant=\"caption\" sx={{ minWidth: 56 }}>\n                {'Rating'}\n              </Typography>\n              <Rating\n                value={rating}\n                size=\"small\"\n                onChange={(_event, value) => setRating(value)}\n                disabled={busy || !emailVerified}\n              />\n              <Typography variant=\"caption\" color=\"text.secondary\">\n                {emailVerified\n                  ? 'Requires having installed this'\n                  : 'Verify your email to rate'}\n              </Typography>\n            </Stack>\n            <TextField\n              size=\"small\"\n              label=\"Comment\"\n              placeholder=\"Share how it worked out, or ask a question — anyone can comment\"\n              value={comment}\n              onChange={(event) => setComment(event.target.value)}\n              disabled={busy}\n              multiline\n              minRows={2}\n              fullWidth\n            />\n            <Stack direction=\"row\" spacing={1}>\n              <Button\n                size=\"small\"\n                variant=\"contained\"\n                color=\"primary\"\n                disabled={busy || (!rating && !comment.trim())}\n                onClick={() => void submit()}\n              >\n                {busy ? 'Posting…' : mine ? 'Update' : 'Post'}\n              </Button>\n              {mine ? (\n                <Button size=\"small\" disabled={busy} onClick={() => void remove()}>\n                  {'Remove'}\n                </Button>\n              ) : null}\n            </Stack>\n          </Stack>\n        ) : (\n          <Typography variant=\"body2\" color=\"text.secondary\">\n            {'Sign in to leave a rating or comment.'}\n          </Typography>\n        )}\n\n        {reviews.length ? (\n          <>\n            <Divider />\n            <Stack spacing={2}>\n              {visibleReviews.map((review: any) => {\n                const name = String(review.displayName ?? 'Someone')\n                return (\n                  <Stack\n                    key={review.$id}\n                    direction=\"row\"\n                    spacing={1.5}\n                    sx={{ alignItems: 'flex-start' }}\n                  >\n                    <Avatar\n                      sx={{ width: 32, height: 32, fontSize: 14 }}\n                    >\n                      {name.trim().charAt(0).toUpperCase() || '?'}\n                    </Avatar>\n                    <Stack spacing={0.25} sx={{ flex: 1, minWidth: 0 }}>\n                      <Stack\n                        direction=\"row\"\n                        spacing={1}\n                        sx={{ alignItems: 'center', flexWrap: 'wrap' }}\n                      >\n                        <Typography variant=\"body2\" sx={{ fontWeight: 600 }}>\n                          {name}\n                        </Typography>\n                        {/* Server-set, so the badge means something: it is the\n                            difference between \"used it\" and \"walked past it\". */}\n                        {review.verifiedInstaller ? (\n                          <Chip\n                            size=\"small\"\n                            label=\"Installed\"\n                            color=\"primary\"\n                          />\n                        ) : null}\n                        {review.updatedAtMs ? (\n                          <Typography\n                            variant=\"caption\"\n                            color=\"text.secondary\"\n                          >\n                            {new Date(review.updatedAtMs).toLocaleDateString()}\n                          </Typography>\n                        ) : null}\n                      </Stack>\n                      {review.rating ? (\n                        <Rating value={review.rating} size=\"small\" readOnly />\n                      ) : null}\n                      {review.comment ? (\n                        <Typography variant=\"body2\" color=\"text.secondary\">\n                          {review.comment}\n                        </Typography>\n                      ) : null}\n                      {/* Not on your OWN review: the queue is for things a\n                          stranger wrote, and \"report yourself\" is noise a\n                          staff member then has to read. Editing yours is\n                          already the control above. */}\n                      {uid && review.$id !== uid ? (\n                        <ReportTarget\n                          listingId={listingId}\n                          reviewUid={review.$id}\n                          label={`this review by ${name}`}\n                        />\n                      ) : null}\n                    </Stack>\n                  </Stack>\n                )\n              })}\n            </Stack>\n            <ListPagination\n              page={page}\n              pageSize={pageSize}\n              rowCount={visibleReviews.length}\n              // The reviews this card HOLDS, after the hidden ones are\n              // dropped — a slice of rows already read, so the total is\n              // known exactly for the window. The alert below is what says\n              // when the window itself is short of the listing.\n              count={reviews.length}\n              onPageChange={setPage}\n              onPageSizeChange={setPageSize}\n            />\n            {reviewsTruncated ? (\n              <Alert severity=\"info\">\n                {`Showing ${REVIEW_CEILING} reviews, ordered by author. This ` +\n                  'listing has more, and the rating summary above counts all ' +\n                  'of them.'}\n              </Alert>\n            ) : null}\n          </>\n        ) : null}\n      </Stack>\n    </CardDisplay>\n  )\n}\n\nListingReviews.displayName = 'ListingReviews'\n\nexport default ListingReviews\n"],"names":["CardDisplay","useSnackbar","ceilingedWindow","collectionCeiling","useFirestore","useFirestoreCollection","useUser","Alert","Avatar","Button","Chip","Divider","Rating","Stack","TextField","Typography","collection","useCallback","useEffect","useMemo","useState","ListPagination","TABLE_PAGE_SIZE_DEFAULT","pluginDocsHelp","authorizedFetch","ReportTarget","REVIEW_CEILING","ListingReviews","listingId","listing","firestore","data","user","enqueueSnackbar","uid","emailVerified","Boolean","reviewDocs","idField","rows","readReviews","truncated","reviewsTruncated","reviews","filter","entry","hidden","sort","a","b","updatedAtMs","mine","find","$id","page","setPage","pageSize","setPageSize","visibleReviews","slice","rating","setRating","comment","setComment","busy","setBusy","submit","trim","response","method","headers","body","JSON","stringify","payload","json","catch","ok","error","variant","status","allowDuplicate","persist","console","remove","average","Number","ratingAverage","ratingCount","header","help","anchor","contentGutterX","contentGutterY","spacing","direction","sx","alignItems","value","precision","size","readOnly","color","minWidth","onChange","_event","disabled","label","placeholder","event","target","multiline","minRows","fullWidth","onClick","length","map","review","name","String","displayName","width","height","fontSize","charAt","toUpperCase","flex","flexWrap","fontWeight","verifiedInstaller","Date","toLocaleDateString","reviewUid","rowCount","count","onPageChange","onPageSizeChange","severity"],"mappings":"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"}

package/src/lib/components/marketplace-browse.component.d.ts

@@ -0,0 +1,38 @@
+import { type OrgPermissions } from '@aglyn/aglyn';
+export interface MarketplaceBrowseProps {
+    hostId: string;
+    /** Signed-in user's org permissions, supplied by the shell (AGL-395). */
+    permissions?: Partial<OrgPermissions>;
+    /**
+     * Rendered inside the org-scope `/marketplace` route (AGL-772) rather
+     * than a site's marketplace tab. Only affects link targets — the grid
+     * still installs through the acting `hostId` until targeting lands
+     * (AGL-773) — so detail links resolve to the org route, not a per-site
+     * one that is being retired.
+     */
+    orgScoped?: boolean;
+    /**
+     * The acting org's slug from the URL (AGL-867). When given at org scope,
+     * detail links build from it directly instead of the async
+     * `hostIndex`→`orgs` resolution, which can return empty and leave the detail
+     * page — the only place installs happen now — unreachable from browse.
+     */
+    orgSlug?: string;
+    /**
+     * Restrict the grid to one publisher's listings (AGL-869), for the org-scope
+     * publisher page. Omitted on the main browse, which shows everyone.
+     */
+    publisherId?: string;
+}
+/**
+ * Marketplace components browse (AGL-44). A read-only catalogue: each card links
+ * to the listing's detail page, which is the only place an install happens
+ * (AGL-867) — installing from a grid card was too easy and skipped the
+ * site-targeting choice. The card still shows install STATE (installed,
+ * org-wide) so the shelf reads honestly, but carries no install action.
+ */
+export declare function MarketplaceBrowse(props: MarketplaceBrowseProps): import("react").JSX.Element;
+export declare namespace MarketplaceBrowse {
+    var displayName: string;
+}
+export default MarketplaceBrowse;