@aglyn/plugins-marketplace 1.0.0-beta.199 → 1.0.0-beta.201

package/src/lib/hooks/use-listing-name-lookup.js

@@ -0,0 +1,131 @@
+/**
+ * @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 { _ as _extends } from "@swc/helpers/_/_extends";
+import { nameSearchNormalizers } from "@aglyn/aglyn/app-utils/name-search";
+import { planListQuery } from "@aglyn/shared-ui-jsx/const/list-query-plan";
+import { useFirestore, useFirestoreCollection } from "@aglyn/tenant-feature-instance";
+import { listQueryConstraints } from "@aglyn/tenant-feature-instance/hooks/use-list-query";
+import { collection, documentId, getDocs, limit, query, where } from "firebase/firestore";
+import { useEffect, useMemo, useState } from "react";
+import { LICENCE_LISTING_MATCH_CAP, LISTING_NAME_LOOKUP } from "../model/listing-query.js";
+/**
+ * The listings whose NAME holds a typed word (AGL-3321).
+ *
+ * A license row names its listing by id, and the name lives on the listing,
+ * where the publisher can change it. So a license search asks the listings
+ * first — `nameTokens array-contains` the word, the key every listing writer
+ * stamps — and the license query then asks for those listing ids. Nothing is
+ * matched over rows already loaded.
+ *
+ * Firestore takes at most thirty values in one `in`, so a word naming more
+ * than thirty listings is refused by name rather than answered with thirty of
+ * them.
+ */ export function useListingNameLookup(words) {
+    var _read_data;
+    const firestore = useFirestore();
+    const plan = useMemo(()=>planListQuery(LISTING_NAME_LOOKUP, {
+            clauses: [],
+            search: words
+        }, nameSearchNormalizers), // The words are data; their text is their identity.
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+    [
+        words.join(' ')
+    ]);
+    const read = useFirestoreCollection(()=>plan.searched ? query(collection(firestore, 'marketplaceListings'), ...listQueryConstraints(plan), limit(LICENCE_LISTING_MATCH_CAP + 1)) : null, [
+        firestore,
+        plan.searched
+    ], {
+        idField: '$id'
+    });
+    if (!plan.searched) {
+        return {
+            ids: null,
+            pending: false,
+            refused: plan.refused,
+            notices: []
+        };
+    }
+    if (read.status !== 'success') {
+        return {
+            ids: null,
+            pending: true,
+            refused: [],
+            notices: plan.notices
+        };
+    }
+    const ids = ((_read_data = read.data) != null ? _read_data : []).map((row)=>row.$id);
+    if (ids.length > LICENCE_LISTING_MATCH_CAP) {
+        return {
+            ids: null,
+            pending: false,
+            refused: [
+                {
+                    clause: 'search',
+                    reason: `more than ${LICENCE_LISTING_MATCH_CAP} listings have a name ` + 'with that word — type more of it'
+                }
+            ],
+            notices: []
+        };
+    }
+    return {
+        ids,
+        pending: false,
+        refused: [],
+        notices: plan.notices
+    };
+}
+/**
+ * Listing id → display name, for the rows on screen: read BY ID, thirty at a
+ * time, so a license always names its listing however large the catalog is.
+ * A listing that cannot be read keeps its id as its label.
+ */ export function useListingNames(ids) {
+    const firestore = useFirestore();
+    const key = [
+        ...new Set(ids.filter(Boolean))
+    ].sort().join(',');
+    const [names, setNames] = useState({});
+    useEffect(()=>{
+        const wanted = key ? key.split(',') : [];
+        if (!wanted.length) return;
+        let active = true;
+        const chunks = [];
+        for(let at = 0; at < wanted.length; at += LICENCE_LISTING_MATCH_CAP){
+            chunks.push(wanted.slice(at, at + LICENCE_LISTING_MATCH_CAP));
+        }
+        void Promise.all(chunks.map((chunk)=>getDocs(query(collection(firestore, 'marketplaceListings'), where(documentId(), 'in', chunk))).catch(()=>null))).then((snapshots)=>{
+            if (!active) return;
+            const found = {};
+            for (const snapshot of snapshots){
+                var _ref;
+                for (const listing of (_ref = snapshot == null ? void 0 : snapshot.docs) != null ? _ref : []){
+                    const name = listing.get('displayName');
+                    if (typeof name === 'string' && name) found[listing.id] = name;
+                }
+            }
+            setNames((previous)=>Object.entries(found).every(([id, name])=>previous[id] === name) ? previous : _extends({}, previous, found));
+        });
+        return ()=>{
+            active = false;
+        };
+    }, [
+        firestore,
+        key
+    ]);
+    return names;
+}
+
+//# sourceMappingURL=use-listing-name-lookup.js.map

package/src/lib/hooks/use-listing-name-lookup.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/marketplace/src/lib/hooks/use-listing-name-lookup.ts"],"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 { nameSearchNormalizers } from '@aglyn/aglyn/app-utils/name-search'\nimport {\n  type ListQueryRefusal,\n  planListQuery,\n} from '@aglyn/shared-ui-jsx/const/list-query-plan'\nimport { useFirestore, useFirestoreCollection } from '@aglyn/tenant-feature-instance'\nimport { listQueryConstraints } from '@aglyn/tenant-feature-instance/hooks/use-list-query'\nimport {\n  collection,\n  documentId,\n  getDocs,\n  limit,\n  query,\n  where,\n} from 'firebase/firestore'\nimport { useEffect, useMemo, useState } from 'react'\nimport {\n  LICENCE_LISTING_MATCH_CAP,\n  LISTING_NAME_LOOKUP,\n} from '../model/listing-query'\n\nexport interface ListingNameLookup {\n  /**\n   * The listings a search names, for a `listingId in [...]` clause; `null`\n   * when nothing is searched, so the list is not narrowed at all.\n   */\n  ids: string[] | null\n  /** Still asking which listings the word names. */\n  pending: boolean\n  /** The search, refused — too many listings share the word. */\n  refused: ListQueryRefusal[]\n  /** Said about what was searched, e.g. one word of two. */\n  notices: string[]\n}\n\n/**\n * The listings whose NAME holds a typed word (AGL-3321).\n *\n * A license row names its listing by id, and the name lives on the listing,\n * where the publisher can change it. So a license search asks the listings\n * first — `nameTokens array-contains` the word, the key every listing writer\n * stamps — and the license query then asks for those listing ids. Nothing is\n * matched over rows already loaded.\n *\n * Firestore takes at most thirty values in one `in`, so a word naming more\n * than thirty listings is refused by name rather than answered with thirty of\n * them.\n */\nexport function useListingNameLookup(words: readonly string[]): ListingNameLookup {\n  const firestore = useFirestore()\n  const plan = useMemo(\n    () =>\n      planListQuery(LISTING_NAME_LOOKUP, { clauses: [], search: words }, nameSearchNormalizers),\n    // The words are data; their text is their identity.\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n    [words.join(' ')],\n  )\n  const read = useFirestoreCollection<{ $id: string }>(\n    () =>\n      plan.searched\n        ? query(\n            collection(firestore, 'marketplaceListings'),\n            ...listQueryConstraints(plan),\n            limit(LICENCE_LISTING_MATCH_CAP + 1),\n          )\n        : null,\n    [firestore, plan.searched],\n    { idField: '$id' },\n  )\n  if (!plan.searched) {\n    return { ids: null, pending: false, refused: plan.refused, notices: [] }\n  }\n  if (read.status !== 'success') {\n    return { ids: null, pending: true, refused: [], notices: plan.notices }\n  }\n  const ids = (read.data ?? []).map((row) => row.$id)\n  if (ids.length > LICENCE_LISTING_MATCH_CAP) {\n    return {\n      ids: null,\n      pending: false,\n      refused: [\n        {\n          clause: 'search',\n          reason:\n            `more than ${LICENCE_LISTING_MATCH_CAP} listings have a name ` +\n            'with that word — type more of it',\n        },\n      ],\n      notices: [],\n    }\n  }\n  return { ids, pending: false, refused: [], notices: plan.notices }\n}\n\n/**\n * Listing id → display name, for the rows on screen: read BY ID, thirty at a\n * time, so a license always names its listing however large the catalog is.\n * A listing that cannot be read keeps its id as its label.\n */\nexport function useListingNames(ids: readonly string[]): Record<string, string> {\n  const firestore = useFirestore()\n  const key = [...new Set(ids.filter(Boolean))].sort().join(',')\n  const [names, setNames] = useState<Record<string, string>>({})\n  useEffect(() => {\n    const wanted = key ? key.split(',') : []\n    if (!wanted.length) return\n    let active = true\n    const chunks: string[][] = []\n    for (let at = 0; at < wanted.length; at += LICENCE_LISTING_MATCH_CAP) {\n      chunks.push(wanted.slice(at, at + LICENCE_LISTING_MATCH_CAP))\n    }\n    void Promise.all(\n      chunks.map((chunk) =>\n        getDocs(\n          query(\n            collection(firestore, 'marketplaceListings'),\n            where(documentId(), 'in', chunk),\n          ),\n        ).catch(() => null),\n      ),\n    ).then((snapshots) => {\n      if (!active) return\n      const found: Record<string, string> = {}\n      for (const snapshot of snapshots) {\n        for (const listing of snapshot?.docs ?? []) {\n          const name = listing.get('displayName')\n          if (typeof name === 'string' && name) found[listing.id] = name\n        }\n      }\n      setNames((previous) =>\n        Object.entries(found).every(([id, name]) => previous[id] === name)\n          ? previous\n          : { ...previous, ...found },\n      )\n    })\n    return () => {\n      active = false\n    }\n  }, [firestore, key])\n  return names\n}\n"],"names":["nameSearchNormalizers","planListQuery","useFirestore","useFirestoreCollection","listQueryConstraints","collection","documentId","getDocs","limit","query","where","useEffect","useMemo","useState","LICENCE_LISTING_MATCH_CAP","LISTING_NAME_LOOKUP","useListingNameLookup","words","read","firestore","plan","clauses","search","join","searched","idField","ids","pending","refused","notices","status","data","map","row","$id","length","clause","reason","useListingNames","key","Set","filter","Boolean","sort","names","setNames","wanted","split","active","chunks","at","push","slice","Promise","all","chunk","catch","then","snapshots","found","snapshot","listing","docs","name","get","id","previous","Object","entries","every"],"mappings":"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"}

package/src/lib/model/listing-query.d.ts

@@ -0,0 +1,140 @@
+/**
+ * @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.
+ */
+import type { ListFilterClause } from '@aglyn/shared-ui-jsx/const/list-grid-filter';
+import { type ListQueryDeclaration, type ListQueryFilter, type ListQuerySort } from '@aglyn/shared-ui-jsx/const/list-query-plan';
+/** Everyone, as a browse audience scope. */
+export declare const BROWSE_EVERYONE = "*";
+/** Joins an audience scope to the publisher it is narrowed to. */
+export declare const BROWSE_PUBLISHER_JOIN = "|";
+export declare const LISTING_BROWSE_AUDIENCE = "browseAudience";
+export declare const LISTING_BROWSE_TOKENS = "browseTokens";
+export declare const LISTING_NAME_TOKENS = "nameTokens";
+export declare const LISTING_TAKEN_DOWN = "takenDown";
+/** The fields a listing's lists query by, all derived. */
+export interface ListingQueryFields {
+    nameLower: string;
+    nameTokens: string[];
+    nameReversed: string;
+    browseAudience: string[];
+    browseTokens: string[];
+    takenDown: boolean;
+}
+/** What the derivation reads off a listing. */
+export interface ListingQuerySource {
+    displayName?: unknown;
+    profileId?: unknown;
+    deletedAt?: unknown;
+    hiddenAt?: unknown;
+    visibility?: string;
+    reviewStatus?: string;
+    artifactType?: string;
+    type?: string;
+    kind?: string;
+}
+/**
+ * Who browse shows a listing to — the same rule the grid applied in memory:
+ * never a deleted or private listing; a browsable one to everyone; one that
+ * is not browsable (in review, rejected, taken down) to its own publisher
+ * only, so a publisher can watch a submission move through review.
+ */
+export declare function listingBrowseAudience(listing: ListingQuerySource): string[];
+/** Every derived field, from the listing as stored. */
+export declare function listingQueryFields(listing: ListingQuerySource): ListingQueryFields;
+/**
+ * What a listing that never had one holds in each field browse ORDERS by. An
+ * `orderBy` drops a document missing its field, so a listing nobody has
+ * installed or rated would vanish from Most installed and Highest rated
+ * rather than sort last. `null` sorts after every number in a descending
+ * order, which is where "not yet rated" belongs; the reviews route writes a
+ * number over it on the first rating. Only ever stamped where the field is
+ * ABSENT — the install and review routes own the values.
+ */
+export declare const LISTING_SORT_DEFAULTS: Readonly<Record<string, number | null>>;
+/**
+ * The derived fields a stored listing is missing or holds stale, plus any
+ * sort field it lacks, or null when it is current — what a writer's refresh
+ * and the backfill write.
+ */
+export declare function listingQueryFieldsPatch(listing: ListingQuerySource & Record<string, unknown>): Record<string, unknown> | null;
+export type BrowseSort = 'newest' | 'installed' | 'rated';
+export declare const BROWSE_SORTS: Readonly<Record<BrowseSort, ListQuerySort>>;
+/**
+ * The browse shelf: a category chip, the search box and three orders, every
+ * one on the query. The audience clause is its base (`browseBase`), and the
+ * search folds into it.
+ */
+export declare const MARKETPLACE_BROWSE_QUERY: ListQueryDeclaration;
+/** The base clause's path, for the index enumeration. */
+export declare const MARKETPLACE_BROWSE_BASE_PATHS: readonly [{
+    readonly path: "browseAudience";
+    readonly array: true;
+}];
+/**
+ * What a reader may see on browse: everything public, plus their own org's
+ * listings still in review — narrowed to one publisher on a publisher page.
+ */
+export declare function browseBase(viewerOrgId: string | null | undefined, publisherId?: string | null): ListQueryFilter[];
+/** "This workspace": who on the team bought it. */
+export declare const HELD_LICENCE_QUERY: ListQueryDeclaration;
+/**
+ * "Bought by you": which workspace a license landed in. A purchase that
+ * names none (before AGL-2331) is stored with `buyerOrgId: null` and is
+ * asked for as empty.
+ */
+export declare const MINE_LICENCE_QUERY: ListQueryDeclaration;
+/** The picked value that means "every workspace" — a purchase naming none. */
+export declare const EVERY_WORKSPACE = "every";
+/**
+ * The Licensed-to select's "every workspace" as the query reads it: a
+ * purchase whose `buyerOrgId` is null.
+ */
+export declare function mineLicenceClauses(clauses: readonly ListFilterClause[]): ListFilterClause[];
+/**
+ * At most this many listings are named by one license search: they go on the
+ * purchases query as `listingId in [...]`, which Firestore caps at thirty.
+ */
+export declare const LICENCE_LISTING_MATCH_CAP = 30;
+/**
+ * The listing-name lookup a license search runs first: the listings whose
+ * name has the typed word, by the same token array the staff queue searches.
+ */
+export declare const LISTING_NAME_LOOKUP: ListQueryDeclaration;
+/**
+ * A license table's scope: its owner clause, live purchases only (a refunded
+ * purchase is not a license, AGL-1546), and the listings a search named.
+ */
+export declare function licenceBase(owner: {
+    path: 'buyerOrgId' | 'buyerUid';
+    value: string;
+}, listingIds: readonly string[] | null): ListQueryFilter[];
+/** The queue's Status select, as clauses the query serves. */
+export declare const REVIEW_QUEUE_QUERY: ListQueryDeclaration;
+/** The three sections the queue reads, each its own query. */
+export type ReviewQueueSection = 'queue' | 'listed' | 'verification';
+/** A listing's newest bytes have no approval: the `latestVersionReviewState` values that mean it. */
+export declare const AWAITING_REVIEW_STATES: readonly ["pending", "rejected"];
+export declare const LISTED_REVIEW_STATUSES: readonly ["listed", "verified"];
+/**
+ * One section's scope: live plugin listings, narrowed to the section. The
+ * Listed section's own `reviewStatus in [...]` steps aside for a Status
+ * clause that names one of its two values, and a clause naming any other
+ * value leaves the section empty by definition — `null`, never queried.
+ */
+export declare function reviewQueueBase(section: ReviewQueueSection, clauses: readonly ListFilterClause[]): ListQueryFilter[] | null;
+/** The queue's Status select as the clause it asks for, or none for "All". */
+export declare function reviewQueueStatusClauses(status: string): ListFilterClause[];
+export declare const MARKETPLACE_REPORTS_QUERY: ListQueryDeclaration;

package/src/lib/model/listing-query.js

@@ -0,0 +1,393 @@
+import { _ as _extends } from "@swc/helpers/_/_extends";
+/**
+ * @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.
+ */ import { displayNameSearchFields, scopedSearch, scopedSearchTokens } from "@aglyn/aglyn/app-utils/name-search";
+import { isListingBrowsable, isListingDeleted, isPrivateListing } from "@aglyn/aglyn/app-utils/marketplace-listing-visibility";
+import { LIST_QUERY_ID_PATH } from "@aglyn/shared-ui-jsx/const/list-query-plan";
+/*
+ * EVERY MARKETPLACE LIST ON ITS QUERY (AGL-3321).
+ *
+ * Browse, the licenses tab, the staff review queue and the abuse-report queue
+ * each matched their filters and search over the rows they had loaded — a
+ * window of ninety listings, two hundred reports, a hundred plugins. A match
+ * on the next page was answered "no match". Each list now declares what its
+ * query can hold, and the fields below are what the listing writers stamp so
+ * the query has something to ask.
+ *
+ * ## What a listing carries for its lists
+ *
+ *   - `nameLower`/`nameTokens`/`nameReversed` — the display name's search
+ *     keys (`displayNameSearchFields`), for the staff queue's search and for
+ *     the licenses tab's listing-name lookup.
+ *   - `browseAudience` — who browse shows the listing to, as scope tokens:
+ *     `*` for everyone, the publisher's org id for the owner's own view of a
+ *     listing still in review or taken down, and each again joined to the
+ *     publisher (`*|<org>`) so a publisher page asks the same question
+ *     narrowed to one publisher without a second equality. Empty for a
+ *     deleted or private listing, which browse never shows anyone.
+ *   - `browseTokens` — the name tokens under each audience scope
+ *     (`scopedSearchTokens`), so browse's search folds into its audience
+ *     clause: one `array-contains-any` answers both.
+ *   - `takenDown` — `hiddenAt` as a boolean, for the staff queue's Taken down
+ *     status by equality rather than by a range that would lead the order.
+ *
+ * All five follow from fields other writers own (`displayName`, `deletedAt`,
+ * `visibility`, `hiddenAt`, `reviewStatus`, the artifact discriminators,
+ * `profileId`), so no writer computes them from its own patch: each calls
+ * `refreshListingQueryFields` after it writes, which re-derives them from the
+ * document as stored. `tools/scripts/lib/listing-query-fields.mjs`
+ * restates the derivation for the seeds and the backfill, held to
+ * `listing-query-fields.fixtures.json` beside it by both sides.
+ */ /** Everyone, as a browse audience scope. */ export const BROWSE_EVERYONE = '*';
+/** Joins an audience scope to the publisher it is narrowed to. */ export const BROWSE_PUBLISHER_JOIN = '|';
+export const LISTING_BROWSE_AUDIENCE = 'browseAudience';
+export const LISTING_BROWSE_TOKENS = 'browseTokens';
+export const LISTING_NAME_TOKENS = 'nameTokens';
+export const LISTING_TAKEN_DOWN = 'takenDown';
+/**
+ * Who browse shows a listing to — the same rule the grid applied in memory:
+ * never a deleted or private listing; a browsable one to everyone; one that
+ * is not browsable (in review, rejected, taken down) to its own publisher
+ * only, so a publisher can watch a submission move through review.
+ */ export function listingBrowseAudience(listing) {
+    if (isListingDeleted(listing) || isPrivateListing(listing)) return [];
+    const publisher = typeof listing.profileId === 'string' ? listing.profileId : '';
+    const scope = isListingBrowsable(listing) ? BROWSE_EVERYONE : publisher;
+    if (!scope) return [];
+    return publisher ? [
+        scope,
+        `${scope}${BROWSE_PUBLISHER_JOIN}${publisher}`
+    ] : [
+        scope
+    ];
+}
+/** Every derived field, from the listing as stored. */ export function listingQueryFields(listing) {
+    const name = displayNameSearchFields(listing.displayName);
+    const browseAudience = listingBrowseAudience(listing);
+    return _extends({}, name, {
+        browseAudience,
+        browseTokens: scopedSearchTokens(browseAudience, name.nameTokens),
+        takenDown: Boolean(listing.hiddenAt)
+    });
+}
+const same = (left, right)=>JSON.stringify(left != null ? left : null) === JSON.stringify(right != null ? right : null);
+/**
+ * What a listing that never had one holds in each field browse ORDERS by. An
+ * `orderBy` drops a document missing its field, so a listing nobody has
+ * installed or rated would vanish from Most installed and Highest rated
+ * rather than sort last. `null` sorts after every number in a descending
+ * order, which is where "not yet rated" belongs; the reviews route writes a
+ * number over it on the first rating. Only ever stamped where the field is
+ * ABSENT — the install and review routes own the values.
+ */ export const LISTING_SORT_DEFAULTS = {
+    installCount: 0,
+    ratingAverage: null
+};
+/**
+ * The derived fields a stored listing is missing or holds stale, plus any
+ * sort field it lacks, or null when it is current — what a writer's refresh
+ * and the backfill write.
+ */ export function listingQueryFieldsPatch(listing) {
+    const computed = listingQueryFields(listing);
+    const patch = {};
+    for (const [key, value] of Object.entries(computed)){
+        if (!same(listing[key], value)) patch[key] = value;
+    }
+    for (const [key, value] of Object.entries(LISTING_SORT_DEFAULTS)){
+        if (listing[key] === undefined) patch[key] = value;
+    }
+    return Object.keys(patch).length ? patch : null;
+}
+export const BROWSE_SORTS = {
+    newest: {
+        path: 'createdAt',
+        direction: 'desc'
+    },
+    installed: {
+        path: 'installCount',
+        direction: 'desc'
+    },
+    rated: {
+        path: 'ratingAverage',
+        direction: 'desc'
+    }
+};
+/**
+ * The browse shelf: a category chip, the search box and three orders, every
+ * one on the query. The audience clause is its base (`browseBase`), and the
+ * search folds into it.
+ */ export const MARKETPLACE_BROWSE_QUERY = {
+    fields: [
+        {
+            column: 'category',
+            kind: 'exact',
+            path: 'category',
+            operators: [
+                'equals'
+            ]
+        }
+    ],
+    sorts: [
+        BROWSE_SORTS.newest,
+        BROWSE_SORTS.installed,
+        BROWSE_SORTS.rated
+    ],
+    search: {
+        tokensPath: LISTING_BROWSE_TOKENS,
+        scoped: scopedSearch(LISTING_BROWSE_TOKENS)
+    }
+};
+/** The base clause's path, for the index enumeration. */ export const MARKETPLACE_BROWSE_BASE_PATHS = [
+    {
+        path: LISTING_BROWSE_AUDIENCE,
+        array: true
+    }
+];
+/**
+ * What a reader may see on browse: everything public, plus their own org's
+ * listings still in review — narrowed to one publisher on a publisher page.
+ */ export function browseBase(viewerOrgId, publisherId) {
+    const scopes = [
+        BROWSE_EVERYONE,
+        ...viewerOrgId ? [
+            viewerOrgId
+        ] : []
+    ];
+    return [
+        {
+            path: LISTING_BROWSE_AUDIENCE,
+            op: 'array-contains-any',
+            value: publisherId ? scopes.map((scope)=>`${scope}${BROWSE_PUBLISHER_JOIN}${publisherId}`) : scopes
+        }
+    ];
+}
+/*==========================================
+ * Licenses (`marketplacePurchases`, web SDK, buyer/org-gated).
+ *=========================================*/ /**
+ * Both license tables keep the order they always had — Firestore's, by
+ * document id — which index merging serves with no composite at all.
+ */ const BY_ID = {
+    path: LIST_QUERY_ID_PATH,
+    direction: 'asc'
+};
+/** "This workspace": who on the team bought it. */ export const HELD_LICENCE_QUERY = {
+    fields: [
+        {
+            column: 'buyerUid',
+            kind: 'exact',
+            path: 'buyerUid',
+            operators: [
+                'equals'
+            ]
+        }
+    ],
+    sorts: [
+        BY_ID
+    ]
+};
+/**
+ * "Bought by you": which workspace a license landed in. A purchase that
+ * names none (before AGL-2331) is stored with `buyerOrgId: null` and is
+ * asked for as empty.
+ */ export const MINE_LICENCE_QUERY = {
+    fields: [
+        {
+            column: 'buyerOrgId',
+            kind: 'exact',
+            path: 'buyerOrgId',
+            presence: 'nullable',
+            operators: [
+                'equals',
+                'isEmpty'
+            ]
+        }
+    ],
+    sorts: [
+        BY_ID
+    ]
+};
+/** The picked value that means "every workspace" — a purchase naming none. */ export const EVERY_WORKSPACE = 'every';
+/**
+ * The Licensed-to select's "every workspace" as the query reads it: a
+ * purchase whose `buyerOrgId` is null.
+ */ export function mineLicenceClauses(clauses) {
+    return clauses.map((clause)=>clause.field === 'buyerOrgId' && clause.op === 'equals' && clause.value === EVERY_WORKSPACE ? _extends({}, clause, {
+            op: 'isEmpty',
+            value: ''
+        }) : clause);
+}
+/**
+ * At most this many listings are named by one license search: they go on the
+ * purchases query as `listingId in [...]`, which Firestore caps at thirty.
+ */ export const LICENCE_LISTING_MATCH_CAP = 30;
+/**
+ * The listing-name lookup a license search runs first: the listings whose
+ * name has the typed word, by the same token array the staff queue searches.
+ */ export const LISTING_NAME_LOOKUP = {
+    fields: [],
+    sorts: [
+        BY_ID
+    ],
+    search: {
+        tokensPath: LISTING_NAME_TOKENS
+    }
+};
+/**
+ * A license table's scope: its owner clause, live purchases only (a refunded
+ * purchase is not a license, AGL-1546), and the listings a search named.
+ */ export function licenceBase(owner, listingIds) {
+    return [
+        {
+            path: owner.path,
+            op: '==',
+            value: owner.value
+        },
+        {
+            path: 'refundedAt',
+            op: '==',
+            value: null
+        },
+        ...listingIds ? [
+            {
+                path: 'listingId',
+                op: 'in',
+                value: [
+                    ...listingIds
+                ]
+            }
+        ] : []
+    ];
+}
+/*==========================================
+ * The staff review queue (Admin SDK, staff route).
+ *=========================================*/ /** The queue's Status select, as clauses the query serves. */ export const REVIEW_QUEUE_QUERY = {
+    fields: [
+        {
+            column: 'reviewStatus',
+            kind: 'exact',
+            path: 'reviewStatus',
+            operators: [
+                'equals'
+            ]
+        },
+        {
+            column: LISTING_TAKEN_DOWN,
+            kind: 'boolean',
+            path: LISTING_TAKEN_DOWN
+        }
+    ],
+    sorts: [
+        BY_ID
+    ],
+    search: {
+        tokensPath: LISTING_NAME_TOKENS
+    }
+};
+/** A listing's newest bytes have no approval: the `latestVersionReviewState` values that mean it. */ export const AWAITING_REVIEW_STATES = [
+    'pending',
+    'rejected'
+];
+export const LISTED_REVIEW_STATUSES = [
+    'listed',
+    'verified'
+];
+/**
+ * One section's scope: live plugin listings, narrowed to the section. The
+ * Listed section's own `reviewStatus in [...]` steps aside for a Status
+ * clause that names one of its two values, and a clause naming any other
+ * value leaves the section empty by definition — `null`, never queried.
+ */ export function reviewQueueBase(section, clauses) {
+    const base = [
+        {
+            path: 'type',
+            op: '==',
+            value: 'plugin'
+        },
+        {
+            path: 'deletedAt',
+            op: '==',
+            value: null
+        }
+    ];
+    if (section === 'queue') {
+        base.push({
+            path: 'latestVersionReviewState',
+            op: 'in',
+            value: [
+                ...AWAITING_REVIEW_STATES
+            ]
+        });
+    } else if (section === 'verification') {
+        base.push({
+            path: 'verificationRequest.state',
+            op: '==',
+            value: 'pending'
+        });
+    } else {
+        const status = clauses.find((clause)=>clause.field === 'reviewStatus' && clause.op === 'equals' && clause.value);
+        if (status) {
+            if (!LISTED_REVIEW_STATUSES.includes(status.value)) return null;
+        } else {
+            base.push({
+                path: 'reviewStatus',
+                op: 'in',
+                value: [
+                    ...LISTED_REVIEW_STATUSES
+                ]
+            });
+        }
+    }
+    return base;
+}
+/** The queue's Status select as the clause it asks for, or none for "All". */ export function reviewQueueStatusClauses(status) {
+    if (!status || status === 'all') return [];
+    if (status === 'hidden') return [
+        {
+            field: LISTING_TAKEN_DOWN,
+            op: 'is',
+            value: 'true'
+        }
+    ];
+    return [
+        {
+            field: 'reviewStatus',
+            op: 'equals',
+            value: status
+        }
+    ];
+}
+/*==========================================
+ * The abuse-report queue (Admin SDK, staff route).
+ *=========================================*/ export const MARKETPLACE_REPORTS_QUERY = {
+    fields: [
+        {
+            column: 'status',
+            kind: 'exact',
+            path: 'status',
+            operators: [
+                'equals'
+            ]
+        }
+    ],
+    sorts: [
+        {
+            path: 'updatedAt',
+            direction: 'desc'
+        }
+    ]
+};
+
+//# sourceMappingURL=listing-query.js.map