@aglyn/plugins-marketplace 1.0.0-beta.149 → 1.0.0-beta.151

package/src/lib/components/org-licences-panel.component.js

@@ -0,0 +1,318 @@
+/**
+ * @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 } from "react/jsx-runtime";
+import { ICON_VARIANT_COMPONENT } from "@aglyn/shared-data-enums";
+import { AppLink, CardDisplay } from "@aglyn/shared-ui-jsx";
+import { useFirestore, useFirestoreCollection, useUser } from "@aglyn/tenant-feature-instance";
+import { Alert, Chip, Stack } from "@mui/material";
+import { ListTable } from "@aglyn/shared-ui-jsx/components/list-table.component";
+import { collection, documentId, limit, orderBy, query, where } from "firebase/firestore";
+import { useMemo } from "react";
+import { pluginDocsHelp } from "@aglyn/aglyn";
+import { TABLE_ROW_HEIGHT } from "@aglyn/shared-ui-jsx/const/table-pagination";
+import { listingPath } from "../model/marketplace-paths.js";
+import EmptyState from "@aglyn/shared-ui-jsx/components/read-gated-empty-state.component";
+/**
+ * WHICH WORKSPACE HOLDS A LICENCE (AGL-2331).
+ *
+ * A marketplace purchase licenses the installing ORGANIZATION, not the person
+ * who paid. That is the model the Publisher Agreement already publishes and
+ * the model the install routes now enforce — and it is unusable without a
+ * surface, because the two questions it creates have no answer anywhere else
+ * in the console:
+ *
+ *   "Does THIS workspace own that component, or was it the other client's?"
+ *   "I bought this once — which workspace did the licence land in?"
+ *
+ * An agency is the population this matters to most, and an agency is exactly
+ * the population that cannot answer either question from memory. Before this
+ * panel the only signal was a Buy button, and a Buy button is the same
+ * whether you own nothing or own three of them in other workspaces.
+ *
+ * TWO LISTS, deliberately, because they are two different facts:
+ *
+ *   `This workspace` is the org's inventory — what any member with install
+ *   rights may install here, including licences a colleague bought and
+ *   licences bought by someone who has since left. It is the list that
+ *   decides whether a Buy is needed.
+ *
+ *   `Bought by you` is the buyer's own receipt trail across every workspace
+ *   they belong to. It is what turns "I already bought this" into "…for
+ *   Northwind, and this is Contoso".
+ *
+ * Both read `marketplacePurchases`, which is buyer/org/seller-gated — the org
+ * clause landed with AGL-2331 for exactly this list. Held at null until the
+ * org and uid resolve: a rules-shaped LIST is evaluated against the QUERY, so
+ * a sentinel value is a guaranteed denial retried on the refusal cadence
+ * (AGL-1440), not an empty list.
+ *
+ * ## Presentation (AGL-2486)
+ *
+ * Each list is a card, like every sibling Marketplace tab — it shipped as two
+ * bare `subtitle1` headings with a loose sentence under each, which on a page
+ * built from cards reads as an unfinished tab rather than an empty one.
+ *
+ * More than cosmetic: the sentences became `EmptyState`s, so they are now
+ * GATED on the read having succeeded (AGL-1066). "You have not bought
+ * anything" is a claim about someone's purchase history, and a refused or
+ * unfinished read supports no such claim — on a tab whose whole purpose is
+ * answering "do we already own this?", a zero-state produced by a dead
+ * session is an invitation to buy something twice. Both queries are held at
+ * `null` until the scope resolves, which reads as `loading` and can never
+ * reach the zero-state; a listen the server has REFUSED keeps painting from
+ * cache with `status: 'success'`, which is why `serverDenied` is checked
+ * alongside it rather than trusting the status alone.
+ */ export function OrgLicencesPanel({ orgId, basePath, viewerOrgs }) {
+    const firestore = useFirestore();
+    const { data: user } = useUser();
+    const uid = user == null ? void 0 : user.uid;
+    /** The licences this workspace holds — whoever in it did the buying. */ const orgLicencesRead = useFirestoreCollection(()=>orgId ? query(collection(firestore, 'marketplacePurchases'), where('buyerOrgId', '==', orgId)) : null, [
+        firestore,
+        orgId
+    ], {
+        idField: '$id'
+    });
+    /** Everything this person has ever bought, in any workspace. */ const myPurchasesRead = useFirestoreCollection(()=>uid ? query(collection(firestore, 'marketplacePurchases'), where('buyerUid', '==', uid)) : null, [
+        firestore,
+        uid
+    ], {
+        idField: '$id'
+    });
+    /**
+   * Listing id → display name.
+   *
+   * One subscription rather than a read per row: `marketplaceListings` is
+   * world-readable (it is the catalogue), the browse grid on the sibling tab
+   * already listens to it, and a per-row hook would change the hook count
+   * between renders as licences arrive.
+   */ const { data: listings } = useFirestoreCollection(/*
+     * ORDERED, so the window is a reachable 200 rather than a sample.
+     *
+     * A capped read with no `orderBy` is answered in document-id order
+     * anyway, so naming it changes no row — what it changes is that the
+     * ordering is a decision rather than an accident, and that the obvious
+     * next edit is caught: `orderBy('displayName')` would drop every listing
+     * saved without one out of the map, and a licence whose listing is
+     * missing from the map is a row that names itself by raw id.
+     *
+     * Ordering on the document NAME, which is what a listing id already is
+     * here, keeps the map's keys and the walk in the same space. Past 200
+     * listings a licence still renders — the fallback below prints the
+     * listing id — so the cap degrades the label and never the row.
+     */ ()=>query(collection(firestore, 'marketplaceListings'), orderBy(documentId()), limit(200)), [
+        firestore
+    ], {
+        idField: '$id'
+    });
+    const listingNames = useMemo(()=>{
+        const names = {};
+        for (const listing of listings != null ? listings : []){
+            var _listing_displayName;
+            names[listing.$id] = String((_listing_displayName = listing.displayName) != null ? _listing_displayName : listing.$id);
+        }
+        return names;
+    }, [
+        listings
+    ]);
+    /** Workspace id → the name the member already sees in the org switcher. */ const orgNames = useMemo(()=>{
+        const names = {};
+        for (const workspace of viewerOrgs != null ? viewerOrgs : [])names[workspace.id] = workspace.name;
+        return names;
+    }, [
+        viewerOrgs
+    ]);
+    /**
+   * A refunded purchase is not a licence (AGL-1546) and must not be listed as
+   * one — the whole point of this panel is deciding whether to buy, and a row
+   * that says "you own this" when the install route answers 402 is worse than
+   * no row.
+   */ const live = (rows)=>(rows != null ? rows : []).filter((row)=>!(row == null ? void 0 : row.refundedAt));
+    const held = live(orgLicencesRead.data);
+    const mine = live(myPurchasesRead.data);
+    /*==========================================
+   * BOTH LISTS ARE WHOLE, so the grid pages them and its counts are TOTALS.
+   *
+   * Neither query is capped: each reads one workspace's purchases or one
+   * person's, whole. So the card holds the entire list it is describing, the
+   * refund filter above has already run over all of it, and the grid's
+   * footer counts the collection's real size rather than a window's length —
+   * the one case where a client page can state a total without qualifying it.
+   *
+   * Server-paging either one would break that. `refundedAt` is filtered after
+   * reading, so a ten-document page arrives holding anywhere from zero to ten
+   * licences, and an agency deciding whether to buy a component again is
+   * exactly the reader who must not be shown a short page as a complete
+   * answer.
+   *=========================================*/ const heldColumns = useMemo(()=>[
+            {
+                field: 'listingId',
+                headerName: 'Listing',
+                flex: 1,
+                minWidth: 220,
+                valueGetter: (_value, row)=>{
+                    var _listingNames_String, _row_listingId, _row_listingId1;
+                    return (_listingNames_String = listingNames[String((_row_listingId = row.listingId) != null ? _row_listingId : '')]) != null ? _listingNames_String : String((_row_listingId1 = row.listingId) != null ? _row_listingId1 : '');
+                },
+                renderCell: ({ row, value })=>{
+                    var _row_listingId;
+                    return /*#__PURE__*/ _jsx(AppLink, {
+                        href: listingPath(basePath, String((_row_listingId = row.listingId) != null ? _row_listingId : '')),
+                        children: value
+                    });
+                }
+            },
+            {
+                field: 'buyerUid',
+                headerName: 'Bought by',
+                width: 150,
+                valueGetter: (_value, row)=>row.buyerUid === uid ? 'You' : 'A colleague'
+            },
+            {
+                field: 'amountCents',
+                headerName: 'Paid',
+                type: 'number',
+                align: 'right',
+                headerAlign: 'right',
+                width: 120,
+                // What the licence cost before tax, which is what a reader compares.
+                valueGetter: (_value, row)=>{
+                    var _row_amountCents, _row_taxCents;
+                    return (Number((_row_amountCents = row.amountCents) != null ? _row_amountCents : 0) - Number((_row_taxCents = row.taxCents) != null ? _row_taxCents : 0)) / 100;
+                },
+                valueFormatter: (value)=>`$${value.toFixed(2)}`
+            }
+        ], [
+        listingNames,
+        basePath,
+        uid
+    ]);
+    const mineColumns = useMemo(()=>[
+            {
+                field: 'listingId',
+                headerName: 'Listing',
+                flex: 1,
+                minWidth: 220,
+                valueGetter: (_value, row)=>{
+                    var _listingNames_String, _row_listingId, _row_listingId1;
+                    return (_listingNames_String = listingNames[String((_row_listingId = row.listingId) != null ? _row_listingId : '')]) != null ? _listingNames_String : String((_row_listingId1 = row.listingId) != null ? _row_listingId1 : '');
+                }
+            },
+            {
+                field: 'buyerOrgId',
+                headerName: 'Licensed to',
+                flex: 1,
+                minWidth: 220,
+                valueGetter: (_value, row)=>{
+                    var _row_buyerOrgId, _orgNames_licensedOrg;
+                    const licensedOrg = String((_row_buyerOrgId = row.buyerOrgId) != null ? _row_buyerOrgId : '');
+                    if (!licensedOrg) return 'Every workspace you belong to';
+                    return licensedOrg === orgId ? 'This workspace' : (_orgNames_licensedOrg = orgNames[licensedOrg]) != null ? _orgNames_licensedOrg : licensedOrg;
+                },
+                renderCell: ({ row, value })=>{
+                    var _row_buyerOrgId;
+                    const licensedOrg = String((_row_buyerOrgId = row.buyerOrgId) != null ? _row_buyerOrgId : '');
+                    // A purchase made before AGL-2331 named no organization, so it is
+                    // not reinterpreted as belonging to one — it keeps entitling this
+                    // buyer everywhere, exactly as it did when they paid for it. Saying
+                    // "every workspace" rather than guessing an org is the whole reason
+                    // nobody loses access here.
+                    if (!licensedOrg) return /*#__PURE__*/ _jsx(Chip, {
+                        size: "small",
+                        label: value
+                    });
+                    return licensedOrg === orgId ? /*#__PURE__*/ _jsx(Chip, {
+                        size: "small",
+                        color: "primary",
+                        label: value
+                    }) : /*#__PURE__*/ _jsx(Chip, {
+                        size: "small",
+                        variant: "outlined",
+                        label: value
+                    });
+                }
+            }
+        ], [
+        listingNames,
+        orgId,
+        orgNames
+    ]);
+    /**
+   * "You own nothing here" is a claim about this workspace's purchases, and a
+   * refused read supports no such claim (AGL-1066). Both queries are ALSO
+   * held at `null` until the org and the uid resolve, which the hook reports
+   * as `loading` — so an unresolved scope can never reach the zero-state
+   * either. `serverDenied` is folded in beside `status`: a listen the server
+   * has refused past its retry budget keeps painting whatever the local cache
+   * holds, and `status` alone still reads `success` for it.
+   */ const outcome = (read)=>read.status === 'error' || read.serverDenied === true ? 'unavailable' : read.status === 'success' ? 'loaded' : 'loading';
+    return /*#__PURE__*/ _jsxs(Stack, {
+        spacing: 3,
+        children: [
+            /*#__PURE__*/ _jsx(Alert, {
+                severity: "info",
+                children: 'A marketplace purchase licenses one organization. Any member with ' + 'install permission can install what this workspace owns — and a ' + 'second workspace needs its own license.'
+            }),
+            held.length === 0 ? /*#__PURE__*/ _jsx(EmptyState, {
+                read: outcome(orgLicencesRead),
+                subject: "this workspace’s licenses",
+                iconPath: ICON_VARIANT_COMPONENT.path,
+                title: 'This workspace holds no licenses',
+                description: 'Anything bought for this workspace shows up here, whoever on ' + 'the team paid for it.'
+            }) : /*#__PURE__*/ _jsx(CardDisplay, {
+                header: 'This workspace',
+                help: pluginDocsHelp('publisherHandbook', {
+                    anchor: '#how-installs-work-the-buyer-side',
+                    excerpt: 'What this workspace owns — installable by any member with ' + 'install permission, whoever on the team paid for it.'
+                }),
+                subheader: 'Installable by any member with install permission, whoever ' + 'on the team bought it',
+                contentGutterX: true,
+                contentGutterY: true,
+                children: /*#__PURE__*/ _jsx(ListTable, {
+                    "aria-label": "Licenses this workspace holds",
+                    rows: held,
+                    columns: heldColumns,
+                    rowHeight: TABLE_ROW_HEIGHT
+                })
+            }),
+            mine.length === 0 ? /*#__PURE__*/ _jsx(EmptyState, {
+                read: outcome(myPurchasesRead),
+                subject: "your purchases",
+                iconPath: ICON_VARIANT_COMPONENT.path,
+                title: 'You have not bought anything yet',
+                description: 'Your own marketplace receipts appear here, across every ' + 'workspace you belong to.'
+            }) : /*#__PURE__*/ _jsx(CardDisplay, {
+                header: 'Bought by you',
+                help: pluginDocsHelp('publisherHandbook', {
+                    anchor: '#how-installs-work-the-buyer-side',
+                    excerpt: 'Your own purchases across every workspace you belong to — a ' + 'purchase licenses one organization, so this says which.'
+                }),
+                subheader: 'Your own receipts, and which workspace each license landed in',
+                contentGutterX: true,
+                contentGutterY: true,
+                children: /*#__PURE__*/ _jsx(ListTable, {
+                    "aria-label": "Licenses you bought",
+                    rows: mine,
+                    columns: mineColumns,
+                    rowHeight: TABLE_ROW_HEIGHT
+                })
+            })
+        ]
+    });
+}
+export default OrgLicencesPanel;
+
+//# sourceMappingURL=org-licences-panel.component.js.map

package/src/lib/components/org-licences-panel.component.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/marketplace/src/lib/components/org-licences-panel.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 { ICON_VARIANT_COMPONENT } from '@aglyn/shared-data-enums'\nimport { AppLink, CardDisplay } from '@aglyn/shared-ui-jsx'\nimport {\n  useFirestore,\n  useFirestoreCollection,\n  useUser,\n} from '@aglyn/tenant-feature-instance'\nimport { Alert, Chip, Stack } from '@mui/material'\nimport { ListTable } from '@aglyn/shared-ui-jsx/components/list-table.component'\nimport type { GridColDef } from '@mui/x-data-grid'\nimport {\n  collection,\n  documentId,\n  limit,\n  orderBy,\n  query,\n  where,\n} from 'firebase/firestore'\nimport { useMemo } from 'react'\nimport { pluginDocsHelp } from '@aglyn/aglyn'\nimport { TABLE_ROW_HEIGHT } from '@aglyn/shared-ui-jsx/const/table-pagination'\nimport { listingPath } from '../model/marketplace-paths'\nimport EmptyState from '@aglyn/shared-ui-jsx/components/read-gated-empty-state.component'\nimport type { ReadOutcome } from '@aglyn/shared-ui-jsx/utils/read-outcome'\n\n/**\n * WHICH WORKSPACE HOLDS A LICENCE (AGL-2331).\n *\n * A marketplace purchase licenses the installing ORGANIZATION, not the person\n * who paid. That is the model the Publisher Agreement already publishes and\n * the model the install routes now enforce — and it is unusable without a\n * surface, because the two questions it creates have no answer anywhere else\n * in the console:\n *\n *   \"Does THIS workspace own that component, or was it the other client's?\"\n *   \"I bought this once — which workspace did the licence land in?\"\n *\n * An agency is the population this matters to most, and an agency is exactly\n * the population that cannot answer either question from memory. Before this\n * panel the only signal was a Buy button, and a Buy button is the same\n * whether you own nothing or own three of them in other workspaces.\n *\n * TWO LISTS, deliberately, because they are two different facts:\n *\n *   `This workspace` is the org's inventory — what any member with install\n *   rights may install here, including licences a colleague bought and\n *   licences bought by someone who has since left. It is the list that\n *   decides whether a Buy is needed.\n *\n *   `Bought by you` is the buyer's own receipt trail across every workspace\n *   they belong to. It is what turns \"I already bought this\" into \"…for\n *   Northwind, and this is Contoso\".\n *\n * Both read `marketplacePurchases`, which is buyer/org/seller-gated — the org\n * clause landed with AGL-2331 for exactly this list. Held at null until the\n * org and uid resolve: a rules-shaped LIST is evaluated against the QUERY, so\n * a sentinel value is a guaranteed denial retried on the refusal cadence\n * (AGL-1440), not an empty list.\n *\n * ## Presentation (AGL-2486)\n *\n * Each list is a card, like every sibling Marketplace tab — it shipped as two\n * bare `subtitle1` headings with a loose sentence under each, which on a page\n * built from cards reads as an unfinished tab rather than an empty one.\n *\n * More than cosmetic: the sentences became `EmptyState`s, so they are now\n * GATED on the read having succeeded (AGL-1066). \"You have not bought\n * anything\" is a claim about someone's purchase history, and a refused or\n * unfinished read supports no such claim — on a tab whose whole purpose is\n * answering \"do we already own this?\", a zero-state produced by a dead\n * session is an invitation to buy something twice. Both queries are held at\n * `null` until the scope resolves, which reads as `loading` and can never\n * reach the zero-state; a listen the server has REFUSED keeps painting from\n * cache with `status: 'success'`, which is why `serverDenied` is checked\n * alongside it rather than trusting the status alone.\n */\nexport function OrgLicencesPanel({\n  orgId,\n  basePath,\n  viewerOrgs,\n}: {\n  orgId?: string | null\n  /**\n   * Where the marketplace hub is mounted under this organization, from the\n   * shell (AGL-3080) — each row links to its listing beneath it. It replaced\n   * an org slug and the console's route table, which a plugin may not\n   * import.\n   */\n  basePath: string\n  /**\n   * Every workspace the reader belongs to, from the shell, so the \"Licensed\n   * to\" column can name the one a purchase landed in instead of printing its\n   * id. A purchase licenses an ORGANIZATION (AGL-2331), which is the whole\n   * subject of this panel, and the reader's other workspaces are the answer\n   * to half of it.\n   */\n  viewerOrgs?: readonly { id: string; name: string }[]\n}) {\n  const firestore = useFirestore()\n  const { data: user } = useUser()\n  const uid = (user as { uid?: string } | null | undefined)?.uid\n\n  /** The licences this workspace holds — whoever in it did the buying. */\n  const orgLicencesRead = useFirestoreCollection<any>(\n    () =>\n      orgId\n        ? query(\n            collection(firestore, 'marketplacePurchases'),\n            where('buyerOrgId', '==', orgId),\n          )\n        : null,\n    [firestore, orgId],\n    { idField: '$id' },\n  )\n  /** Everything this person has ever bought, in any workspace. */\n  const myPurchasesRead = useFirestoreCollection<any>(\n    () =>\n      uid\n        ? query(\n            collection(firestore, 'marketplacePurchases'),\n            where('buyerUid', '==', uid),\n          )\n        : null,\n    [firestore, uid],\n    { idField: '$id' },\n  )\n\n  /**\n   * Listing id → display name.\n   *\n   * One subscription rather than a read per row: `marketplaceListings` is\n   * world-readable (it is the catalogue), the browse grid on the sibling tab\n   * already listens to it, and a per-row hook would change the hook count\n   * between renders as licences arrive.\n   */\n  const { data: listings } = useFirestoreCollection<any>(\n    /*\n     * ORDERED, so the window is a reachable 200 rather than a sample.\n     *\n     * A capped read with no `orderBy` is answered in document-id order\n     * anyway, so naming it changes no row — what it changes is that the\n     * ordering is a decision rather than an accident, and that the obvious\n     * next edit is caught: `orderBy('displayName')` would drop every listing\n     * saved without one out of the map, and a licence whose listing is\n     * missing from the map is a row that names itself by raw id.\n     *\n     * Ordering on the document NAME, which is what a listing id already is\n     * here, keeps the map's keys and the walk in the same space. Past 200\n     * listings a licence still renders — the fallback below prints the\n     * listing id — so the cap degrades the label and never the row.\n     */\n    () =>\n      query(\n        collection(firestore, 'marketplaceListings'),\n        orderBy(documentId()),\n        limit(200),\n      ),\n    [firestore],\n    { idField: '$id' },\n  )\n  const listingNames = useMemo(() => {\n    const names: Record<string, string> = {}\n    for (const listing of listings ?? []) {\n      names[listing.$id] = String(listing.displayName ?? listing.$id)\n    }\n    return names\n  }, [listings])\n\n  /** Workspace id → the name the member already sees in the org switcher. */\n  const orgNames = useMemo(() => {\n    const names: Record<string, string> = {}\n    for (const workspace of viewerOrgs ?? []) names[workspace.id] = workspace.name\n    return names\n  }, [viewerOrgs])\n\n  /**\n   * A refunded purchase is not a licence (AGL-1546) and must not be listed as\n   * one — the whole point of this panel is deciding whether to buy, and a row\n   * that says \"you own this\" when the install route answers 402 is worse than\n   * no row.\n   */\n  const live = (rows: any[] | undefined) =>\n    (rows ?? []).filter((row) => !row?.refundedAt)\n\n  const held = live(orgLicencesRead.data)\n  const mine = live(myPurchasesRead.data)\n\n  /*==========================================\n   * BOTH LISTS ARE WHOLE, so the grid pages them and its counts are TOTALS.\n   *\n   * Neither query is capped: each reads one workspace's purchases or one\n   * person's, whole. So the card holds the entire list it is describing, the\n   * refund filter above has already run over all of it, and the grid's\n   * footer counts the collection's real size rather than a window's length —\n   * the one case where a client page can state a total without qualifying it.\n   *\n   * Server-paging either one would break that. `refundedAt` is filtered after\n   * reading, so a ten-document page arrives holding anywhere from zero to ten\n   * licences, and an agency deciding whether to buy a component again is\n   * exactly the reader who must not be shown a short page as a complete\n   * answer.\n   *=========================================*/\n  const heldColumns = useMemo<GridColDef[]>(\n    () => [\n      {\n        field: 'listingId',\n        headerName: 'Listing',\n        flex: 1,\n        minWidth: 220,\n        valueGetter: (_value, row) =>\n          listingNames[String(row.listingId ?? '')] ?? String(row.listingId ?? ''),\n        renderCell: ({ row, value }) => (\n          <AppLink href={listingPath(basePath, String(row.listingId ?? ''))}>\n            {value}\n          </AppLink>\n        ),\n      },\n      {\n        field: 'buyerUid',\n        headerName: 'Bought by',\n        width: 150,\n        valueGetter: (_value, row) => (row.buyerUid === uid ? 'You' : 'A colleague'),\n      },\n      {\n        field: 'amountCents',\n        headerName: 'Paid',\n        type: 'number',\n        align: 'right',\n        headerAlign: 'right',\n        width: 120,\n        // What the licence cost before tax, which is what a reader compares.\n        valueGetter: (_value, row) =>\n          (Number(row.amountCents ?? 0) - Number(row.taxCents ?? 0)) / 100,\n        valueFormatter: (value: number) => `$${value.toFixed(2)}`,\n      },\n    ],\n    [listingNames, basePath, uid],\n  )\n  const mineColumns = useMemo<GridColDef[]>(\n    () => [\n      {\n        field: 'listingId',\n        headerName: 'Listing',\n        flex: 1,\n        minWidth: 220,\n        valueGetter: (_value, row) =>\n          listingNames[String(row.listingId ?? '')] ?? String(row.listingId ?? ''),\n      },\n      {\n        field: 'buyerOrgId',\n        headerName: 'Licensed to',\n        flex: 1,\n        minWidth: 220,\n        valueGetter: (_value, row) => {\n          const licensedOrg = String(row.buyerOrgId ?? '')\n          if (!licensedOrg) return 'Every workspace you belong to'\n          return licensedOrg === orgId\n            ? 'This workspace'\n            : (orgNames[licensedOrg] ?? licensedOrg)\n        },\n        renderCell: ({ row, value }) => {\n          const licensedOrg = String(row.buyerOrgId ?? '')\n          // A purchase made before AGL-2331 named no organization, so it is\n          // not reinterpreted as belonging to one — it keeps entitling this\n          // buyer everywhere, exactly as it did when they paid for it. Saying\n          // \"every workspace\" rather than guessing an org is the whole reason\n          // nobody loses access here.\n          if (!licensedOrg) return <Chip size=\"small\" label={value} />\n          return licensedOrg === orgId ? (\n            <Chip size=\"small\" color=\"primary\" label={value} />\n          ) : (\n            <Chip size=\"small\" variant=\"outlined\" label={value} />\n          )\n        },\n      },\n    ],\n    [listingNames, orgId, orgNames],\n  )\n\n  /**\n   * \"You own nothing here\" is a claim about this workspace's purchases, and a\n   * refused read supports no such claim (AGL-1066). Both queries are ALSO\n   * held at `null` until the org and the uid resolve, which the hook reports\n   * as `loading` — so an unresolved scope can never reach the zero-state\n   * either. `serverDenied` is folded in beside `status`: a listen the server\n   * has refused past its retry budget keeps painting whatever the local cache\n   * holds, and `status` alone still reads `success` for it.\n   */\n  const outcome = (read: {\n    status: string\n    serverDenied: boolean\n  }): ReadOutcome =>\n    read.status === 'error' || read.serverDenied === true\n      ? 'unavailable'\n      : read.status === 'success'\n        ? 'loaded'\n        : 'loading'\n\n  return (\n    <Stack spacing={3}>\n      <Alert severity=\"info\">\n        {'A marketplace purchase licenses one organization. Any member with ' +\n          'install permission can install what this workspace owns — and a ' +\n          'second workspace needs its own license.'}\n      </Alert>\n\n      {held.length === 0 ? (\n        <EmptyState\n          read={outcome(orgLicencesRead)}\n          subject=\"this workspace’s licenses\"\n          iconPath={ICON_VARIANT_COMPONENT.path}\n          title={'This workspace holds no licenses'}\n          description={\n            'Anything bought for this workspace shows up here, whoever on ' +\n            'the team paid for it.'\n          }\n        />\n      ) : (\n        <CardDisplay\n          header={'This workspace'}\n          help={pluginDocsHelp('publisherHandbook', {\n            anchor: '#how-installs-work-the-buyer-side',\n            excerpt:\n              'What this workspace owns — installable by any member with ' +\n              'install permission, whoever on the team paid for it.',\n          })}\n          subheader={\n            'Installable by any member with install permission, whoever ' +\n            'on the team bought it'\n          }\n          contentGutterX\n          contentGutterY\n        >\n          <ListTable\n            aria-label=\"Licenses this workspace holds\"\n            rows={held}\n            columns={heldColumns}\n            rowHeight={TABLE_ROW_HEIGHT}\n          />\n        </CardDisplay>\n      )}\n\n      {mine.length === 0 ? (\n        <EmptyState\n          read={outcome(myPurchasesRead)}\n          subject=\"your purchases\"\n          iconPath={ICON_VARIANT_COMPONENT.path}\n          title={'You have not bought anything yet'}\n          description={\n            'Your own marketplace receipts appear here, across every ' +\n            'workspace you belong to.'\n          }\n        />\n      ) : (\n        <CardDisplay\n          header={'Bought by you'}\n          help={pluginDocsHelp('publisherHandbook', {\n            anchor: '#how-installs-work-the-buyer-side',\n            excerpt:\n              'Your own purchases across every workspace you belong to — a ' +\n              'purchase licenses one organization, so this says which.',\n          })}\n          subheader={\n            'Your own receipts, and which workspace each license landed in'\n          }\n          contentGutterX\n          contentGutterY\n        >\n          <ListTable\n            aria-label=\"Licenses you bought\"\n            rows={mine}\n            columns={mineColumns}\n            rowHeight={TABLE_ROW_HEIGHT}\n          />\n        </CardDisplay>\n      )}\n    </Stack>\n  )\n}\n\nexport default OrgLicencesPanel\n"],"names":["ICON_VARIANT_COMPONENT","AppLink","CardDisplay","useFirestore","useFirestoreCollection","useUser","Alert","Chip","Stack","ListTable","collection","documentId","limit","orderBy","query","where","useMemo","pluginDocsHelp","TABLE_ROW_HEIGHT","listingPath","EmptyState","OrgLicencesPanel","orgId","basePath","viewerOrgs","firestore","data","user","uid","orgLicencesRead","idField","myPurchasesRead","listings","listingNames","names","listing","$id","String","displayName","orgNames","workspace","id","name","live","rows","filter","row","refundedAt","held","mine","heldColumns","field","headerName","flex","minWidth","valueGetter","_value","listingId","renderCell","value","href","width","buyerUid","type","align","headerAlign","Number","amountCents","taxCents","valueFormatter","toFixed","mineColumns","licensedOrg","buyerOrgId","size","label","color","variant","outcome","read","status","serverDenied","spacing","severity","length","subject","iconPath","path","title","description","header","help","anchor","excerpt","subheader","contentGutterX","contentGutterY","aria-label","columns","rowHeight"],"mappings":"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"}

package/src/lib/components/org-publish-panel.component.d.ts

@@ -0,0 +1,45 @@
+import { resolveMarketplaceFeePct } from '@aglyn/aglyn';
+/**
+ * Org-level publish (AGL-776): pick a source site, then a component, a layout,
+ * or the whole site (as a template), and publish it under the org's publisher
+ * identity. This panel's whole job is choosing WHAT: it names the kind, the
+ * scope that holds it and the document, and hands that to the
+ * `hostArtifactPublish` zone (AGL-3080), whose widget owns the name/price
+ * form, the route and the POST. Plugins publish from their own bundle upload,
+ * not here.
+ *
+ * The per-site publish buttons (Components/Layouts/Setup pages) stay as
+ * in-context shortcuts; this is the one place that spans every site.
+ */
+export declare function OrgPublishPanel({ orgId, hosts, basePath, billingPath, org, orgReady, }: {
+    orgId: string;
+    hosts: ReadonlyArray<{
+        id: string;
+        label: string;
+    }>;
+    /**
+     * Where the marketplace hub is mounted under this organization, from the
+     * shell (AGL-3080). The publish-a-plugin page hangs beneath it.
+     */
+    basePath: string;
+    /**
+     * Where this organization manages its plan, from the shell's org mount.
+     * Absent on a deployment that bills nobody, and the fee notice then says
+     * the rate without offering a way to change it.
+     */
+    billingPath?: string;
+    /**
+     * The org billing doc the shell already loaded, and whether it has
+     * settled. Read here rather than through the console's `useCurrentOrg`:
+     * the fee shown is a claim about this publisher's plan, and
+     * `resolveMarketplaceFeePct(undefined)` answers the FREE rate — so a
+     * number rendered during load accuses a paying publisher of the higher
+     * cut.
+     */
+    org?: Parameters<typeof resolveMarketplaceFeePct>[0];
+    orgReady: boolean;
+}): import("react").JSX.Element;
+export declare namespace OrgPublishPanel {
+    var displayName: string;
+}
+export default OrgPublishPanel;