@aglyn/plugins-marketplace 1.2.0 → 1.3.0

package/src/lib/hooks/use-starter-purchase.js

@@ -14,87 +14,40 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */ 'use client';
-import { lockdownRefusalText, parseLockdownRefusal } from "@aglyn/aglyn/app-utils/lockdown";
-import { readGaClientId } from "@aglyn/aglyn/app-utils/analytics-events";
-import { authorizedFetch } from "@aglyn/shared-util-http/authorized-token";
-import { useUser } from "@aglyn/tenant-feature-instance";
-import { useCallback, useRef, useState } from "react";
-import { STARTER_CHECKOUT_PATH, starterCheckoutBody } from "../model/starter-query.js";
-/** Where the browser goes to pay: replaced in a spec. */ export const starterPurchaseNavigation = {
-    assign: (url)=>window.location.assign(url)
-};
+import { buildRoute, Route } from "@aglyn/aglyn/app-utils/console-routes";
+import { useCallback, useState } from "react";
+import { useMarketplacePay } from "./use-marketplace-pay.js";
 /**
- * "Buy and continue" for a priced starter in Create site (AGL-4049): opens
- * the marketplace's payment for it, licensed to the workspace the site is
- * for, and names Create site as the way back, so the person returns to the
- * same pick with the site still to be created. Today's payment page, until
- * the marketplace pays in-app.
- *
- * One attempt per starter: the same key goes with a second click, so a
- * double click cannot open a second payment (AGL-1697). A workspace that
- * already owns it is told so, not charged again.
- */ export function useStarterPurchase(orgId) {
-    const { data: user } = useUser();
-    const userRef = useRef(user);
-    userRef.current = user;
-    const attempts = useRef(new Map());
-    const [busy, setBusy] = useState(false);
+ * "Buy and continue" for a priced starter in Create site (AGL-4049): pays in
+ * the console, licensed to the workspace the site is for, so the person stays
+ * on the same pick with the site still to be created. The purchase is on
+ * record when it answers, so Create is ready on the next click.
+ */ export function useStarterPurchase(orgId, orgSlug) {
+    const pay = useMarketplacePay({
+        orgId,
+        billingHref: orgSlug ? buildRoute(Route.MANAGE_BILLING, {
+            orgSlug
+        }) : null
+    });
     const [error, setError] = useState(null);
-    const buy = useCallback(async (listingId)=>{
-        var _attempts_current_get;
-        if (!orgId || !listingId) return 'failed';
-        const key = (_attempts_current_get = attempts.current.get(listingId)) != null ? _attempts_current_get : `${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 10)}`;
-        attempts.current.set(listingId, key);
-        setBusy(true);
+    const buy = useCallback(async (listing)=>{
         setError(null);
-        // Busy until the page leaves for the payment, so a second click cannot
-        // land in between.
-        let opening = false;
-        try {
-            const response = await authorizedFetch(userRef.current, STARTER_CHECKOUT_PATH, {
-                method: 'POST',
-                headers: {
-                    'Content-Type': 'application/json',
-                    'Idempotency-Key': key
-                },
-                body: JSON.stringify(starterCheckoutBody({
-                    listingId,
-                    orgId,
-                    gaClientId: await readGaClientId(process.env.NEXT_PUBLIC_FIREBASE_MEASUREMENT_ID)
-                }))
-            });
-            const payload = await response.json().catch(()=>null);
-            if (response.status === 409 && (payload == null ? void 0 : payload.code) === 'already_purchased') return 'owned';
-            const locked = parseLockdownRefusal(response.status, payload);
-            if (locked) {
-                setError(lockdownRefusalText(locked));
-                return 'failed';
-            }
-            if (response.status === 501) {
-                setError('Purchases are not set up here yet, so a starter with a price cannot be bought.');
-                return 'failed';
-            }
-            if (!response.ok || typeof (payload == null ? void 0 : payload.url) !== 'string' || !payload.url) {
-                setError(typeof (payload == null ? void 0 : payload.error) === 'string' && payload.error ? payload.error : 'The payment could not open. Try again.');
-                return 'failed';
-            }
-            opening = true;
-            starterPurchaseNavigation.assign(payload.url);
-            return 'opening';
-        } catch (caught) {
-            console.error(caught);
-            setError('The payment could not open. Check your connection and try again.');
-            return 'failed';
-        } finally{
-            if (!opening) setBusy(false);
+        const result = await pay.buy(listing);
+        if (result.outcome === 'paid' || result.outcome === 'owned') return 'owned';
+        if (result.outcome === 'pending') {
+            setError('Your payment is going through. You can create this site as soon as it clears.');
+            return 'pending';
         }
+        setError(result.error);
+        return 'stopped';
     }, [
-        orgId
+        pay.buy
     ]);
     return {
         buy,
-        busy,
-        error
+        busy: pay.busy,
+        error,
+        panel: pay.panel
     };
 }
 

package/src/lib/hooks/use-starter-purchase.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../../../../libs/plugins/marketplace/src/lib/hooks/use-starter-purchase.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 { lockdownRefusalText, parseLockdownRefusal } from '@aglyn/aglyn/app-utils/lockdown'\nimport { readGaClientId } from '@aglyn/aglyn/app-utils/analytics-events'\nimport { authorizedFetch } from '@aglyn/shared-util-http/authorized-token'\nimport { useUser } from '@aglyn/tenant-feature-instance'\nimport { useCallback, useRef, useState } from 'react'\nimport { STARTER_CHECKOUT_PATH, starterCheckoutBody } from '../model/starter-query'\n\n/** How one \"Buy and continue\" ended. */\nexport type StarterPurchaseOutcome =\n  /** The payment page is opening: the person comes back to Create site on the same pick. */\n  | 'opening'\n  /** The workspace owns it already: nothing to pay, the site can be created. */\n  | 'owned'\n  /** It could not open; {@link StarterPurchase.error} says why. */\n  | 'failed'\n\nexport interface StarterPurchase {\n  buy: (listingId: string) => Promise<StarterPurchaseOutcome>\n  /** A purchase is opening. */\n  busy: boolean\n  /** Why the last one did not open, or `null`. */\n  error: string | null\n}\n\n/** Where the browser goes to pay: replaced in a spec. */\nexport const starterPurchaseNavigation = {\n  assign: (url: string) => window.location.assign(url),\n}\n\n/**\n * \"Buy and continue\" for a priced starter in Create site (AGL-4049): opens\n * the marketplace's payment for it, licensed to the workspace the site is\n * for, and names Create site as the way back, so the person returns to the\n * same pick with the site still to be created. Today's payment page, until\n * the marketplace pays in-app.\n *\n * One attempt per starter: the same key goes with a second click, so a\n * double click cannot open a second payment (AGL-1697). A workspace that\n * already owns it is told so, not charged again.\n */\nexport function useStarterPurchase(orgId: string | undefined): StarterPurchase {\n  const { data: user } = useUser()\n  const userRef = useRef(user)\n  userRef.current = user\n  const attempts = useRef(new Map<string, string>())\n  const [busy, setBusy] = useState(false)\n  const [error, setError] = useState<string | null>(null)\n\n  const buy = useCallback(\n    async (listingId: string): Promise<StarterPurchaseOutcome> => {\n      if (!orgId || !listingId) return 'failed'\n      const key =\n        attempts.current.get(listingId) ??\n        `${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 10)}`\n      attempts.current.set(listingId, key)\n      setBusy(true)\n      setError(null)\n      // Busy until the page leaves for the payment, so a second click cannot\n      // land in between.\n      let opening = false\n      try {\n        const response = await authorizedFetch(userRef.current, STARTER_CHECKOUT_PATH, {\n          method: 'POST',\n          headers: { 'Content-Type': 'application/json', 'Idempotency-Key': key },\n          body: JSON.stringify(\n            starterCheckoutBody({\n              listingId,\n              orgId,\n              gaClientId: await readGaClientId(process.env.NEXT_PUBLIC_FIREBASE_MEASUREMENT_ID),\n            }),\n          ),\n        })\n        const payload = (await response.json().catch((): null => null)) as\n          | { url?: unknown; error?: unknown; code?: unknown }\n          | null\n        if (response.status === 409 && payload?.code === 'already_purchased') return 'owned'\n        const locked = parseLockdownRefusal(response.status, payload)\n        if (locked) {\n          setError(lockdownRefusalText(locked))\n          return 'failed'\n        }\n        if (response.status === 501) {\n          setError('Purchases are not set up here yet, so a starter with a price cannot be bought.')\n          return 'failed'\n        }\n        if (!response.ok || typeof payload?.url !== 'string' || !payload.url) {\n          setError(typeof payload?.error === 'string' && payload.error ? payload.error : 'The payment could not open. Try again.')\n          return 'failed'\n        }\n        opening = true\n        starterPurchaseNavigation.assign(payload.url)\n        return 'opening'\n      } catch (caught) {\n        console.error(caught)\n        setError('The payment could not open. Check your connection and try again.')\n        return 'failed'\n      } finally {\n        if (!opening) setBusy(false)\n      }\n    },\n    [orgId],\n  )\n\n  return { buy, busy, error }\n}\n"],"names":["lockdownRefusalText","parseLockdownRefusal","readGaClientId","authorizedFetch","useUser","useCallback","useRef","useState","STARTER_CHECKOUT_PATH","starterCheckoutBody","starterPurchaseNavigation","assign","url","window","location","useStarterPurchase","orgId","data","user","userRef","current","attempts","Map","busy","setBusy","error","setError","buy","listingId","key","get","Date","now","toString","Math","random","slice","set","opening","response","method","headers","body","JSON","stringify","gaClientId","process","env","NEXT_PUBLIC_FIREBASE_MEASUREMENT_ID","payload","json","catch","status","code","locked","ok","caught","console"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GACD;AAEA,SAASA,mBAAmB,EAAEC,oBAAoB,QAAQ,kCAAiC;AAC3F,SAASC,cAAc,QAAQ,0CAAyC;AACxE,SAASC,eAAe,QAAQ,2CAA0C;AAC1E,SAASC,OAAO,QAAQ,iCAAgC;AACxD,SAASC,WAAW,EAAEC,MAAM,EAAEC,QAAQ,QAAQ,QAAO;AACrD,SAASC,qBAAqB,EAAEC,mBAAmB,QAAQ,4BAAwB;AAmBnF,uDAAuD,GACvD,OAAO,MAAMC,4BAA4B;IACvCC,QAAQ,CAACC,MAAgBC,OAAOC,QAAQ,CAACH,MAAM,CAACC;AAClD,EAAC;AAED;;;;;;;;;;CAUC,GACD,OAAO,SAASG,mBAAmBC,KAAyB;IAC1D,MAAM,EAAEC,MAAMC,IAAI,EAAE,GAAGd;IACvB,MAAMe,UAAUb,OAAOY;IACvBC,QAAQC,OAAO,GAAGF;IAClB,MAAMG,WAAWf,OAAO,IAAIgB;IAC5B,MAAM,CAACC,MAAMC,QAAQ,GAAGjB,SAAS;IACjC,MAAM,CAACkB,OAAOC,SAAS,GAAGnB,SAAwB;IAElD,MAAMoB,MAAMtB,YACV,OAAOuB;YAGHP;QAFF,IAAI,CAACL,SAAS,CAACY,WAAW,OAAO;QACjC,MAAMC,OACJR,wBAAAA,SAASD,OAAO,CAACU,GAAG,CAACF,sBAArBP,wBACA,GAAGU,KAAKC,GAAG,GAAGC,QAAQ,CAAC,IAAI,CAAC,EAAEC,KAAKC,MAAM,GAAGF,QAAQ,CAAC,IAAIG,KAAK,CAAC,GAAG,KAAK;QACzEf,SAASD,OAAO,CAACiB,GAAG,CAACT,WAAWC;QAChCL,QAAQ;QACRE,SAAS;QACT,uEAAuE;QACvE,mBAAmB;QACnB,IAAIY,UAAU;QACd,IAAI;YACF,MAAMC,WAAW,MAAMpC,gBAAgBgB,QAAQC,OAAO,EAAEZ,uBAAuB;gBAC7EgC,QAAQ;gBACRC,SAAS;oBAAE,gBAAgB;oBAAoB,mBAAmBZ;gBAAI;gBACtEa,MAAMC,KAAKC,SAAS,CAClBnC,oBAAoB;oBAClBmB;oBACAZ;oBACA6B,YAAY,MAAM3C,eAAe4C,QAAQC,GAAG,CAACC,mCAAmC;gBAClF;YAEJ;YACA,MAAMC,UAAW,MAAMV,SAASW,IAAI,GAAGC,KAAK,CAAC,IAAY;YAGzD,IAAIZ,SAASa,MAAM,KAAK,OAAOH,CAAAA,2BAAAA,QAASI,IAAI,MAAK,qBAAqB,OAAO;YAC7E,MAAMC,SAASrD,qBAAqBsC,SAASa,MAAM,EAAEH;YACrD,IAAIK,QAAQ;gBACV5B,SAAS1B,oBAAoBsD;gBAC7B,OAAO;YACT;YACA,IAAIf,SAASa,MAAM,KAAK,KAAK;gBAC3B1B,SAAS;gBACT,OAAO;YACT;YACA,IAAI,CAACa,SAASgB,EAAE,IAAI,QAAON,2BAAAA,QAASrC,GAAG,MAAK,YAAY,CAACqC,QAAQrC,GAAG,EAAE;gBACpEc,SAAS,QAAOuB,2BAAAA,QAASxB,KAAK,MAAK,YAAYwB,QAAQxB,KAAK,GAAGwB,QAAQxB,KAAK,GAAG;gBAC/E,OAAO;YACT;YACAa,UAAU;YACV5B,0BAA0BC,MAAM,CAACsC,QAAQrC,GAAG;YAC5C,OAAO;QACT,EAAE,OAAO4C,QAAQ;YACfC,QAAQhC,KAAK,CAAC+B;YACd9B,SAAS;YACT,OAAO;QACT,SAAU;YACR,IAAI,CAACY,SAASd,QAAQ;QACxB;IACF,GACA;QAACR;KAAM;IAGT,OAAO;QAAEW;QAAKJ;QAAME;IAAM;AAC5B"}
+{"version":3,"sources":["../../../../../../../libs/plugins/marketplace/src/lib/hooks/use-starter-purchase.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 { buildRoute, Route } from '@aglyn/aglyn/app-utils/console-routes'\nimport { useCallback, useState, type ReactNode } from 'react'\nimport { useMarketplacePay, type PayListing } from './use-marketplace-pay'\n\n/** How one \"Buy and continue\" ended. */\nexport type StarterPurchaseOutcome =\n  /** Paid just now, or owned already: the site can be created. */\n  | 'owned'\n  /** Paid and still clearing: the site can be created once it has. */\n  | 'pending'\n  /** Closed, or it could not open; {@link StarterPurchase.error} says why. */\n  | 'stopped'\n\nexport interface StarterPurchase {\n  buy: (listing: PayListing) => Promise<StarterPurchaseOutcome>\n  /** A purchase is opening or paying. */\n  busy: boolean\n  /** Why the last one did not open, or `null`. */\n  error: string | null\n  /** The payment, in place under the pick, or `null`. */\n  panel: ReactNode\n}\n\n/**\n * \"Buy and continue\" for a priced starter in Create site (AGL-4049): pays in\n * the console, licensed to the workspace the site is for, so the person stays\n * on the same pick with the site still to be created. The purchase is on\n * record when it answers, so Create is ready on the next click.\n */\nexport function useStarterPurchase(orgId: string | undefined, orgSlug: string): StarterPurchase {\n  const pay = useMarketplacePay({\n    orgId,\n    billingHref: orgSlug ? buildRoute(Route.MANAGE_BILLING, { orgSlug }) : null,\n  })\n  const [error, setError] = useState<string | null>(null)\n\n  const buy = useCallback(\n    async (listing: PayListing): Promise<StarterPurchaseOutcome> => {\n      setError(null)\n      const result = await pay.buy(listing)\n      if (result.outcome === 'paid' || result.outcome === 'owned') return 'owned'\n      if (result.outcome === 'pending') {\n        setError('Your payment is going through. You can create this site as soon as it clears.')\n        return 'pending'\n      }\n      setError(result.error)\n      return 'stopped'\n    },\n    [pay.buy],\n  )\n\n  return { buy, busy: pay.busy, error, panel: pay.panel }\n}\n"],"names":["buildRoute","Route","useCallback","useState","useMarketplacePay","useStarterPurchase","orgId","orgSlug","pay","billingHref","MANAGE_BILLING","error","setError","buy","listing","result","outcome","busy","panel"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GACD;AAEA,SAASA,UAAU,EAAEC,KAAK,QAAQ,wCAAuC;AACzE,SAASC,WAAW,EAAEC,QAAQ,QAAwB,QAAO;AAC7D,SAASC,iBAAiB,QAAyB,2BAAuB;AAqB1E;;;;;CAKC,GACD,OAAO,SAASC,mBAAmBC,KAAyB,EAAEC,OAAe;IAC3E,MAAMC,MAAMJ,kBAAkB;QAC5BE;QACAG,aAAaF,UAAUP,WAAWC,MAAMS,cAAc,EAAE;YAAEH;QAAQ,KAAK;IACzE;IACA,MAAM,CAACI,OAAOC,SAAS,GAAGT,SAAwB;IAElD,MAAMU,MAAMX,YACV,OAAOY;QACLF,SAAS;QACT,MAAMG,SAAS,MAAMP,IAAIK,GAAG,CAACC;QAC7B,IAAIC,OAAOC,OAAO,KAAK,UAAUD,OAAOC,OAAO,KAAK,SAAS,OAAO;QACpE,IAAID,OAAOC,OAAO,KAAK,WAAW;YAChCJ,SAAS;YACT,OAAO;QACT;QACAA,SAASG,OAAOJ,KAAK;QACrB,OAAO;IACT,GACA;QAACH,IAAIK,GAAG;KAAC;IAGX,OAAO;QAAEA;QAAKI,MAAMT,IAAIS,IAAI;QAAEN;QAAOO,OAAOV,IAAIU,KAAK;IAAC;AACxD"}

package/src/lib/model/marketplace-invoice.d.ts

@@ -0,0 +1,52 @@
+/**
+ * @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.
+ */
+/** The discriminator every Stripe object of a marketplace sale carries. */
+export declare const MARKETPLACE_PURCHASE_TYPE = "marketplace-purchase";
+/** The facts a marketplace sale carries across Stripe, as the webhook reads them. */
+export interface MarketplaceSaleFacts {
+    listingId: string;
+    buyerUid: string;
+    buyerOrgId: string;
+    sellerOrgId: string;
+    feeCents: number;
+    transferCents: number;
+    /** The buyer's GA client id, so the server's `purchase` joins their session. */
+    gaClientId?: string | null;
+}
+/**
+ * A sale's metadata as Stripe form params (AGL-4049): the same fields a
+ * hosted checkout session carries, so the purchase record cannot tell the two
+ * doors apart, plus the marker that keeps the sale out of the platform's own
+ * revenue.
+ */
+export declare function marketplaceSaleMetadataParams(facts: MarketplaceSaleFacts): Record<string, string>;
+/** Whether a Stripe invoice is a marketplace sale's. */
+export declare function isMarketplaceInvoice(invoice: unknown): boolean;
+/**
+ * The tax on an invoice, in cents.
+ *
+ * The breakdown first, the scalar only when no array said anything: measured
+ * on the live account, a computed invoice can send `tax: 0` or `tax: null`
+ * beside a populated `total_taxes[]` (AGL-1811).
+ */
+export declare function invoiceTaxCents(invoice: any): number;
+/**
+ * The PaymentIntent an invoice settles through, whichever generation of the
+ * field it carries: an id or an expanded object at the top level, or under
+ * `payments[]` on newer API versions.
+ */
+export declare function invoicePaymentIntentId(invoice: any): string;

package/src/lib/model/marketplace-invoice.js

@@ -0,0 +1,75 @@
+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 { PLUGIN_SALE_METADATA_KEY, PLUGIN_SALE_METADATA_VALUE } from "@aglyn/aglyn/app-utils/plugin-sale";
+/** The discriminator every Stripe object of a marketplace sale carries. */ export const MARKETPLACE_PURCHASE_TYPE = 'marketplace-purchase';
+/**
+ * A sale's metadata as Stripe form params (AGL-4049): the same fields a
+ * hosted checkout session carries, so the purchase record cannot tell the two
+ * doors apart, plus the marker that keeps the sale out of the platform's own
+ * revenue.
+ */ export function marketplaceSaleMetadataParams(facts) {
+    return _extends({
+        'metadata[type]': MARKETPLACE_PURCHASE_TYPE,
+        [`metadata[${PLUGIN_SALE_METADATA_KEY}]`]: PLUGIN_SALE_METADATA_VALUE,
+        'metadata[listingId]': facts.listingId,
+        'metadata[buyerUid]': facts.buyerUid,
+        'metadata[buyerOrgId]': facts.buyerOrgId,
+        'metadata[sellerOrgId]': facts.sellerOrgId,
+        'metadata[feeCents]': String(facts.feeCents),
+        'metadata[transferCents]': String(facts.transferCents)
+    }, facts.gaClientId && /^\d+\.\d+$/.test(facts.gaClientId) ? {
+        'metadata[ga_client_id]': facts.gaClientId
+    } : {});
+}
+/** Whether a Stripe invoice is a marketplace sale's. */ export function isMarketplaceInvoice(invoice) {
+    var _invoice_metadata;
+    return (invoice == null ? void 0 : (_invoice_metadata = invoice.metadata) == null ? void 0 : _invoice_metadata.type) === MARKETPLACE_PURCHASE_TYPE;
+}
+/**
+ * The tax on an invoice, in cents.
+ *
+ * The breakdown first, the scalar only when no array said anything: measured
+ * on the live account, a computed invoice can send `tax: 0` or `tax: null`
+ * beside a populated `total_taxes[]` (AGL-1811).
+ */ export function invoiceTaxCents(invoice) {
+    var _ref;
+    const entries = Array.isArray(invoice == null ? void 0 : invoice.total_taxes) ? invoice.total_taxes : Array.isArray(invoice == null ? void 0 : invoice.total_tax_amounts) ? invoice.total_tax_amounts : [];
+    if (entries.length > 0) {
+        return entries.reduce((sum, entry)=>{
+            var _ref;
+            const amount = Number((_ref = entry == null ? void 0 : entry.amount) != null ? _ref : 0);
+            return sum + (Number.isFinite(amount) ? Math.round(amount) : 0);
+        }, 0);
+    }
+    const scalar = Number((_ref = invoice == null ? void 0 : invoice.tax) != null ? _ref : NaN);
+    return Number.isFinite(scalar) && scalar > 0 ? Math.round(scalar) : 0;
+}
+/**
+ * The PaymentIntent an invoice settles through, whichever generation of the
+ * field it carries: an id or an expanded object at the top level, or under
+ * `payments[]` on newer API versions.
+ */ export function invoicePaymentIntentId(invoice) {
+    var _invoice_payments_data__payment, _invoice_payments_data_, _invoice_payments_data, _invoice_payments;
+    const intent = invoice == null ? void 0 : invoice.payment_intent;
+    if (typeof intent === 'string' && intent) return intent;
+    if (typeof (intent == null ? void 0 : intent.id) === 'string' && intent.id) return intent.id;
+    const nested = invoice == null ? void 0 : (_invoice_payments = invoice.payments) == null ? void 0 : (_invoice_payments_data = _invoice_payments.data) == null ? void 0 : (_invoice_payments_data_ = _invoice_payments_data[0]) == null ? void 0 : (_invoice_payments_data__payment = _invoice_payments_data_.payment) == null ? void 0 : _invoice_payments_data__payment.payment_intent;
+    if (typeof nested === 'string' && nested) return nested;
+    return typeof (nested == null ? void 0 : nested.id) === 'string' ? nested.id : '';
+}
+
+//# sourceMappingURL=marketplace-invoice.js.map

package/src/lib/model/marketplace-invoice.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/marketplace/src/lib/model/marketplace-invoice.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\nimport {\n  PLUGIN_SALE_METADATA_KEY,\n  PLUGIN_SALE_METADATA_VALUE,\n} from '@aglyn/aglyn/app-utils/plugin-sale'\n\n/** The discriminator every Stripe object of a marketplace sale carries. */\nexport const MARKETPLACE_PURCHASE_TYPE = 'marketplace-purchase'\n\n/** The facts a marketplace sale carries across Stripe, as the webhook reads them. */\nexport interface MarketplaceSaleFacts {\n  listingId: string\n  buyerUid: string\n  buyerOrgId: string\n  sellerOrgId: string\n  feeCents: number\n  transferCents: number\n  /** The buyer's GA client id, so the server's `purchase` joins their session. */\n  gaClientId?: string | null\n}\n\n/**\n * A sale's metadata as Stripe form params (AGL-4049): the same fields a\n * hosted checkout session carries, so the purchase record cannot tell the two\n * doors apart, plus the marker that keeps the sale out of the platform's own\n * revenue.\n */\nexport function marketplaceSaleMetadataParams(facts: MarketplaceSaleFacts): Record<string, string> {\n  return {\n    'metadata[type]': MARKETPLACE_PURCHASE_TYPE,\n    [`metadata[${PLUGIN_SALE_METADATA_KEY}]`]: PLUGIN_SALE_METADATA_VALUE,\n    'metadata[listingId]': facts.listingId,\n    'metadata[buyerUid]': facts.buyerUid,\n    'metadata[buyerOrgId]': facts.buyerOrgId,\n    'metadata[sellerOrgId]': facts.sellerOrgId,\n    'metadata[feeCents]': String(facts.feeCents),\n    'metadata[transferCents]': String(facts.transferCents),\n    ...(facts.gaClientId && /^\\d+\\.\\d+$/.test(facts.gaClientId)\n      ? { 'metadata[ga_client_id]': facts.gaClientId }\n      : {}),\n  }\n}\n\n/** Whether a Stripe invoice is a marketplace sale's. */\nexport function isMarketplaceInvoice(invoice: unknown): boolean {\n  return (invoice as { metadata?: { type?: unknown } } | null | undefined)?.metadata?.type ===\n    MARKETPLACE_PURCHASE_TYPE\n}\n\n/**\n * The tax on an invoice, in cents.\n *\n * The breakdown first, the scalar only when no array said anything: measured\n * on the live account, a computed invoice can send `tax: 0` or `tax: null`\n * beside a populated `total_taxes[]` (AGL-1811).\n */\nexport function invoiceTaxCents(invoice: any): number {\n  const entries: any[] = Array.isArray(invoice?.total_taxes)\n    ? invoice.total_taxes\n    : Array.isArray(invoice?.total_tax_amounts)\n      ? invoice.total_tax_amounts\n      : []\n  if (entries.length > 0) {\n    return entries.reduce((sum: number, entry: any) => {\n      const amount = Number(entry?.amount ?? 0)\n      return sum + (Number.isFinite(amount) ? Math.round(amount) : 0)\n    }, 0)\n  }\n  const scalar = Number(invoice?.tax ?? NaN)\n  return Number.isFinite(scalar) && scalar > 0 ? Math.round(scalar) : 0\n}\n\n/**\n * The PaymentIntent an invoice settles through, whichever generation of the\n * field it carries: an id or an expanded object at the top level, or under\n * `payments[]` on newer API versions.\n */\nexport function invoicePaymentIntentId(invoice: any): string {\n  const intent = invoice?.payment_intent\n  if (typeof intent === 'string' && intent) return intent\n  if (typeof intent?.id === 'string' && intent.id) return intent.id\n  const nested = invoice?.payments?.data?.[0]?.payment?.payment_intent\n  if (typeof nested === 'string' && nested) return nested\n  return typeof nested?.id === 'string' ? nested.id : ''\n}\n"],"names":["PLUGIN_SALE_METADATA_KEY","PLUGIN_SALE_METADATA_VALUE","MARKETPLACE_PURCHASE_TYPE","marketplaceSaleMetadataParams","facts","listingId","buyerUid","buyerOrgId","sellerOrgId","String","feeCents","transferCents","gaClientId","test","isMarketplaceInvoice","invoice","metadata","type","invoiceTaxCents","entries","Array","isArray","total_taxes","total_tax_amounts","length","reduce","sum","entry","amount","Number","isFinite","Math","round","scalar","tax","NaN","invoicePaymentIntentId","intent","payment_intent","id","nested","payments","data","payment"],"mappings":";AAAA;;;;;;;;;;;;;;;CAeC,GAED,SACEA,wBAAwB,EACxBC,0BAA0B,QACrB,qCAAoC;AAE3C,yEAAyE,GACzE,OAAO,MAAMC,4BAA4B,uBAAsB;AAc/D;;;;;CAKC,GACD,OAAO,SAASC,8BAA8BC,KAA2B;IACvE,OAAO;QACL,kBAAkBF;QAClB,CAAC,CAAC,SAAS,EAAEF,yBAAyB,CAAC,CAAC,CAAC,EAAEC;QAC3C,uBAAuBG,MAAMC,SAAS;QACtC,sBAAsBD,MAAME,QAAQ;QACpC,wBAAwBF,MAAMG,UAAU;QACxC,yBAAyBH,MAAMI,WAAW;QAC1C,sBAAsBC,OAAOL,MAAMM,QAAQ;QAC3C,2BAA2BD,OAAOL,MAAMO,aAAa;OACjDP,MAAMQ,UAAU,IAAI,aAAaC,IAAI,CAACT,MAAMQ,UAAU,IACtD;QAAE,0BAA0BR,MAAMQ,UAAU;IAAC,IAC7C,CAAC;AAET;AAEA,sDAAsD,GACtD,OAAO,SAASE,qBAAqBC,OAAgB;QAC5C;IAAP,OAAO,CAACA,4BAAD,oBAAA,AAACA,QAAkEC,QAAQ,qBAA3E,kBAA6EC,IAAI,MACtFf;AACJ;AAEA;;;;;;CAMC,GACD,OAAO,SAASgB,gBAAgBH,OAAY;;IAC1C,MAAMI,UAAiBC,MAAMC,OAAO,CAACN,2BAAAA,QAASO,WAAW,IACrDP,QAAQO,WAAW,GACnBF,MAAMC,OAAO,CAACN,2BAAAA,QAASQ,iBAAiB,IACtCR,QAAQQ,iBAAiB,GACzB,EAAE;IACR,IAAIJ,QAAQK,MAAM,GAAG,GAAG;QACtB,OAAOL,QAAQM,MAAM,CAAC,CAACC,KAAaC;;YAClC,MAAMC,SAASC,eAAOF,yBAAAA,MAAOC,MAAM,mBAAI;YACvC,OAAOF,MAAOG,CAAAA,OAAOC,QAAQ,CAACF,UAAUG,KAAKC,KAAK,CAACJ,UAAU,CAAA;QAC/D,GAAG;IACL;IACA,MAAMK,SAASJ,eAAOd,2BAAAA,QAASmB,GAAG,mBAAIC;IACtC,OAAON,OAAOC,QAAQ,CAACG,WAAWA,SAAS,IAAIF,KAAKC,KAAK,CAACC,UAAU;AACtE;AAEA;;;;CAIC,GACD,OAAO,SAASG,uBAAuBrB,OAAY;QAIlCA,iCAAAA,yBAAAA,wBAAAA;IAHf,MAAMsB,SAAStB,2BAAAA,QAASuB,cAAc;IACtC,IAAI,OAAOD,WAAW,YAAYA,QAAQ,OAAOA;IACjD,IAAI,QAAOA,0BAAAA,OAAQE,EAAE,MAAK,YAAYF,OAAOE,EAAE,EAAE,OAAOF,OAAOE,EAAE;IACjE,MAAMC,SAASzB,4BAAAA,oBAAAA,QAAS0B,QAAQ,sBAAjB1B,yBAAAA,kBAAmB2B,IAAI,sBAAvB3B,0BAAAA,sBAAyB,CAAC,EAAE,sBAA5BA,kCAAAA,wBAA8B4B,OAAO,qBAArC5B,gCAAuCuB,cAAc;IACpE,IAAI,OAAOE,WAAW,YAAYA,QAAQ,OAAOA;IACjD,OAAO,QAAOA,0BAAAA,OAAQD,EAAE,MAAK,WAAWC,OAAOD,EAAE,GAAG;AACtD"}

package/src/lib/model/marketplace-pay.d.ts

@@ -0,0 +1,42 @@
+/**
+ * @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.
+ */
+/** The card a quote names, as far as this person may see it. */
+export interface PayQuoteCard {
+    type?: string | null;
+    brand?: string | null;
+    last4?: string | null;
+    email?: string | null;
+}
+/** What the pay door answers a `quote` with: what will be charged, before it is. */
+export interface PayQuote {
+    listingName: string;
+    amountCents: number;
+    taxCents: number;
+    totalCents: number;
+    /** `null` for someone who may buy but may not see billing. */
+    card: PayQuoteCard | null;
+    /** Whether this person holds `billing.manage`, which paying takes. */
+    canPay: boolean;
+}
+/** The two things a workspace needs before it can be charged. */
+export type PayPrerequisite = 'card_required' | 'billing_address_required';
+/** Reads the prerequisite a refusal names, or `null` when it names none. */
+export declare function payPrerequisiteOf(status: number, payload: unknown): PayPrerequisite | null;
+/** Dollars and cents, for a line a buyer is about to agree to. */
+export declare function formatPayCents(cents: number): string;
+/** The saved method in words, wallets included: they carry an email, not a number. */
+export declare function payCardLabel(card: PayQuoteCard | null): string;

package/src/lib/model/marketplace-pay.js

@@ -0,0 +1,33 @@
+/**
+ * @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.
+ */ /** The card a quote names, as far as this person may see it. */ /** Reads the prerequisite a refusal names, or `null` when it names none. */ export function payPrerequisiteOf(status, payload) {
+    const code = payload == null ? void 0 : payload.code;
+    return status === 412 && (code === 'card_required' || code === 'billing_address_required') ? code : null;
+}
+/** Dollars and cents, for a line a buyer is about to agree to. */ export function formatPayCents(cents) {
+    return new Intl.NumberFormat('en-US', {
+        style: 'currency',
+        currency: 'USD'
+    }).format(cents / 100);
+}
+/** The saved method in words, wallets included: they carry an email, not a number. */ export function payCardLabel(card) {
+    var _ref, _card_brand, _card_type;
+    if (card == null ? void 0 : card.last4) return `${((_ref = (_card_brand = card.brand) != null ? _card_brand : card.type) != null ? _ref : 'card').toUpperCase()} •••• ${card.last4}`;
+    if (card == null ? void 0 : card.email) return `${(_card_type = card.type) != null ? _card_type : 'wallet'} · ${card.email}`;
+    return 'the card on file';
+}
+
+//# sourceMappingURL=marketplace-pay.js.map

package/src/lib/model/marketplace-pay.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/marketplace/src/lib/model/marketplace-pay.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\n/** The card a quote names, as far as this person may see it. */\nexport interface PayQuoteCard {\n  type?: string | null\n  brand?: string | null\n  last4?: string | null\n  email?: string | null\n}\n\n/** What the pay door answers a `quote` with: what will be charged, before it is. */\nexport interface PayQuote {\n  listingName: string\n  amountCents: number\n  taxCents: number\n  totalCents: number\n  /** `null` for someone who may buy but may not see billing. */\n  card: PayQuoteCard | null\n  /** Whether this person holds `billing.manage`, which paying takes. */\n  canPay: boolean\n}\n\n/** The two things a workspace needs before it can be charged. */\nexport type PayPrerequisite = 'card_required' | 'billing_address_required'\n\n/** Reads the prerequisite a refusal names, or `null` when it names none. */\nexport function payPrerequisiteOf(status: number, payload: unknown): PayPrerequisite | null {\n  const code = (payload as { code?: unknown } | null | undefined)?.code\n  return status === 412 && (code === 'card_required' || code === 'billing_address_required')\n    ? code\n    : null\n}\n\n/** Dollars and cents, for a line a buyer is about to agree to. */\nexport function formatPayCents(cents: number): string {\n  return new Intl.NumberFormat('en-US', { style: 'currency', currency: 'USD' }).format(cents / 100)\n}\n\n/** The saved method in words, wallets included: they carry an email, not a number. */\nexport function payCardLabel(card: PayQuoteCard | null): string {\n  if (card?.last4) return `${(card.brand ?? card.type ?? 'card').toUpperCase()} •••• ${card.last4}`\n  if (card?.email) return `${card.type ?? 'wallet'} · ${card.email}`\n  return 'the card on file'\n}\n"],"names":["payPrerequisiteOf","status","payload","code","formatPayCents","cents","Intl","NumberFormat","style","currency","format","payCardLabel","card","last4","brand","type","toUpperCase","email"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED,8DAA8D,GAuB9D,0EAA0E,GAC1E,OAAO,SAASA,kBAAkBC,MAAc,EAAEC,OAAgB;IAChE,MAAMC,OAAQD,2BAAD,AAACA,QAAmDC,IAAI;IACrE,OAAOF,WAAW,OAAQE,CAAAA,SAAS,mBAAmBA,SAAS,0BAAyB,IACpFA,OACA;AACN;AAEA,gEAAgE,GAChE,OAAO,SAASC,eAAeC,KAAa;IAC1C,OAAO,IAAIC,KAAKC,YAAY,CAAC,SAAS;QAAEC,OAAO;QAAYC,UAAU;IAAM,GAAGC,MAAM,CAACL,QAAQ;AAC/F;AAEA,oFAAoF,GACpF,OAAO,SAASM,aAAaC,IAAyB;QACxBA,MAAAA,aACDA;IAD3B,IAAIA,wBAAAA,KAAMC,KAAK,EAAE,OAAO,GAAG,EAACD,QAAAA,cAAAA,KAAKE,KAAK,YAAVF,cAAcA,KAAKG,IAAI,YAAvBH,OAA2B,QAAQI,WAAW,GAAG,MAAM,EAAEJ,KAAKC,KAAK,EAAE;IACjG,IAAID,wBAAAA,KAAMK,KAAK,EAAE,OAAO,IAAGL,aAAAA,KAAKG,IAAI,YAATH,aAAa,SAAS,GAAG,EAAEA,KAAKK,KAAK,EAAE;IAClE,OAAO;AACT"}

package/src/lib/model/platform-seller.d.ts

@@ -0,0 +1,37 @@
+/**
+ * @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.
+ */
+/**
+ * Whether a seller is the platform itself, selling at a waived fee (AGL-4049).
+ *
+ * The platform's own org sells through the marketplace the same way any
+ * publisher does, with one difference that is not a privilege: there is nobody
+ * to pay. Its money already lands on the platform's account, so a Connect
+ * transfer would be the platform paying itself, and it never onboards Connect.
+ *
+ * BOTH HALVES, ALWAYS. The waiver is the existing staff override
+ * (`marketplaceFeePct: 0`) and the org is a server-side marker
+ * (`AGLYN_PLATFORM_ORG_ID`, read in `server/platform-org.ts`). A waiver on any
+ * other seller still pays that seller, and the platform's org at a real rate
+ * still needs a payout account. No client-writable field decides this.
+ *
+ * Pure, so the sale, the publish gate and their specs all ask one question.
+ */
+export declare function sellsAsPlatform(input: {
+    sellerOrgId: string;
+    feePercent: number;
+    platformOrgId: string | null | undefined;
+}): boolean;

package/src/lib/model/platform-seller.js

@@ -0,0 +1,36 @@
+/**
+ * @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.
+ */ /**
+ * Whether a seller is the platform itself, selling at a waived fee (AGL-4049).
+ *
+ * The platform's own org sells through the marketplace the same way any
+ * publisher does, with one difference that is not a privilege: there is nobody
+ * to pay. Its money already lands on the platform's account, so a Connect
+ * transfer would be the platform paying itself, and it never onboards Connect.
+ *
+ * BOTH HALVES, ALWAYS. The waiver is the existing staff override
+ * (`marketplaceFeePct: 0`) and the org is a server-side marker
+ * (`AGLYN_PLATFORM_ORG_ID`, read in `server/platform-org.ts`). A waiver on any
+ * other seller still pays that seller, and the platform's org at a real rate
+ * still needs a payout account. No client-writable field decides this.
+ *
+ * Pure, so the sale, the publish gate and their specs all ask one question.
+ */ export function sellsAsPlatform(input) {
+    const { sellerOrgId, feePercent, platformOrgId } = input;
+    return feePercent === 0 && !!platformOrgId && sellerOrgId === platformOrgId;
+}
+
+//# sourceMappingURL=platform-seller.js.map

package/src/lib/model/platform-seller.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/marketplace/src/lib/model/platform-seller.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\n/**\n * Whether a seller is the platform itself, selling at a waived fee (AGL-4049).\n *\n * The platform's own org sells through the marketplace the same way any\n * publisher does, with one difference that is not a privilege: there is nobody\n * to pay. Its money already lands on the platform's account, so a Connect\n * transfer would be the platform paying itself, and it never onboards Connect.\n *\n * BOTH HALVES, ALWAYS. The waiver is the existing staff override\n * (`marketplaceFeePct: 0`) and the org is a server-side marker\n * (`AGLYN_PLATFORM_ORG_ID`, read in `server/platform-org.ts`). A waiver on any\n * other seller still pays that seller, and the platform's org at a real rate\n * still needs a payout account. No client-writable field decides this.\n *\n * Pure, so the sale, the publish gate and their specs all ask one question.\n */\nexport function sellsAsPlatform(input: {\n  sellerOrgId: string\n  feePercent: number\n  platformOrgId: string | null | undefined\n}): boolean {\n  const { sellerOrgId, feePercent, platformOrgId } = input\n  return feePercent === 0 && !!platformOrgId && sellerOrgId === platformOrgId\n}\n"],"names":["sellsAsPlatform","input","sellerOrgId","feePercent","platformOrgId"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED;;;;;;;;;;;;;;;CAeC,GACD,OAAO,SAASA,gBAAgBC,KAI/B;IACC,MAAM,EAAEC,WAAW,EAAEC,UAAU,EAAEC,aAAa,EAAE,GAAGH;IACnD,OAAOE,eAAe,KAAK,CAAC,CAACC,iBAAiBF,gBAAgBE;AAChE"}

package/src/lib/model/starter-publish.d.ts

@@ -0,0 +1,159 @@
+/**
+ * @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 { SiteStarterBuiltinReading } from '@aglyn/aglyn/app-utils/site-starter-theme';
+/** The pages a starter publish captures, as counted before the click. */
+export interface StarterPublishPages {
+    /** Pages in the site's routing that were saved at least once and not deleted. */
+    count: number;
+    /** Whether one of them is the Home page, at `/`. */
+    hasHome: boolean;
+}
+/** One screen document, as the dialog reads it. */
+export interface StarterPublishScreen {
+    $id: string;
+    versionId?: unknown;
+    deletedAt?: unknown;
+    [field: string]: unknown;
+}
+/**
+ * The pages the door will capture: every page in the host's routing map
+ * (`screens`, id → slug) with a published version and not deleted, as the
+ * door walks them. An email screen is never in the routing map.
+ */
+export declare function starterPublishPages(routing: unknown, screens: readonly StarterPublishScreen[]): StarterPublishPages;
+export type StarterPublishStepId = 'plan' | 'profile' | 'payouts' | 'home' | 'pages';
+/** One thing that stands between this site and a starter publish. */
+export interface StarterPublishStep {
+    id: StarterPublishStepId;
+    /** What is missing, in one sentence. */
+    text: string;
+    /** Where it is fixed, or `null` until the address is known. */
+    href: string | null;
+    /** The link's label: the page it opens. */
+    actionLabel: string;
+}
+/** What the dialog has read, each `undefined`/`null` while it is pending. */
+export interface StarterPublishFacts {
+    /** The owning org's plan, as `usePlanFeature(hostId, 'marketplaceSelling')` resolves it. */
+    plan: {
+        ready: boolean;
+        locked: boolean;
+        planLabel?: string;
+        upgradeHref?: string;
+    };
+    /**
+     * `publisherProfiles/{orgId}`: `undefined` while it loads or when it cannot
+     * be read, `null` when the org has none.
+     */
+    profile: Record<string, unknown> | null | undefined;
+    /** The pages it will capture, or `null` while they load. */
+    pages: StarterPublishPages | null;
+    /** The price typed in the form, in whole dollars. */
+    priceUsd: number;
+    /**
+     * The server says this org is the platform at the staff fee waiver, so a
+     * price needs no payout account (AGL-4049). Only the server can say.
+     */
+    sellsAsPlatform?: boolean;
+    /** `/{org}/marketplace`, or `null` until the org's address is known. */
+    marketplacePath: string | null;
+    /** The site's Pages list, or `null` until its address is known. */
+    pagesPath: string | null;
+}
+/**
+ * Whether a profile's payout account can take a sale, as far as the console
+ * can tell: an account that takes charges. The door also checks which Stripe
+ * world the account belongs to, which only the server knows, and says so if
+ * that is what is missing.
+ */
+export declare const payoutsReady: (profile: Record<string, unknown>) => boolean;
+/**
+ * Every step that stands between this site and a starter publish, the setup
+ * steps first, then the site's own. A read still pending refuses nothing.
+ */
+export declare function starterPublishSteps(facts: StarterPublishFacts): StarterPublishStep[];
+/**
+ * Where a setup refusal from the door (412) is fixed. The door's words are
+ * shown as they are; this picks the link beside them from what the dialog
+ * read: the plan, the profile, or payouts for a priced starter. With nothing
+ * read to say which, the publisher profile, where the other two are set up.
+ */
+export declare function starterRefusalLink(facts: StarterPublishFacts): {
+    href: string | null;
+    actionLabel: string;
+};
+/** The two theme shapes a publisher chooses between. */
+export type StarterThemeChoice = 'builtin' | 'full';
+/** What a starter publish adds to the listing form's body. */
+export interface StarterPublishBody {
+    theme: SiteStarterBuiltinReading['theme'] | {
+        kind: 'full';
+    };
+    /** Always a base starter: publishers' AI starters are not offered yet. */
+    mode: 'base';
+    facets: {
+        kind: string | null;
+    };
+}
+/**
+ * The starter half of the publish body, or `null` until it can be sent: no
+ * theme chosen (neither is chosen for the publisher), or the built-in chosen
+ * on a site that wears none. The full theme is the site's own, read by the
+ * door off the site itself.
+ */
+export declare function starterPublishBody(input: {
+    choice: StarterThemeChoice | null;
+    builtin: SiteStarterBuiltinReading | null;
+    kind: string | null;
+}): StarterPublishBody | null;
+/** What a publish captures, in a sentence, from the pages counted before the click. */
+export declare function starterCapturesSentence(pages: StarterPublishPages): string;
+/**
+ * The line under the built-in theme choice: what the starter would carry, or
+ * why this site has no built-in to name. `hostReady` is false while the site
+ * is still being read.
+ */
+export declare function starterBuiltinDetail(builtin: SiteStarterBuiltinReading | null, hostReady?: boolean): string;
+/** What the built-in choice leaves behind, for a site whose fonts it cannot name, or `null`. */
+export declare function starterFontsNote(builtin: SiteStarterBuiltinReading | null): string | null;
+/**
+ * What "Publish as a starter" reads before the click, for a surface that
+ * cannot read it (AGL-4049): the native apps ask
+ * `GET /api/marketplace/starter-publish-facts`, and show these words.
+ */
+export interface StarterPublishFactsAnswer {
+    /** What the publish captures, in a sentence. */
+    captures: string;
+    /** The site's built-in theme as the publish body sends it, or `null` when it wears none. */
+    builtin: SiteStarterBuiltinReading['theme'] | null;
+    /** The line under the built-in choice. */
+    builtinDetail: string;
+    /** What the built-in choice leaves behind, or `null`. */
+    fontsNote: string | null;
+    /**
+     * What stands in the way, by step: a step left out is one that is done.
+     * `payouts` says what a price would need, whether or not one is typed yet.
+     */
+    steps: Partial<Record<StarterPublishStepId, string>>;
+    /** Whether a step stands in the way of a free publish too, so Publish is off. */
+    blocked: boolean;
+}
+/** The answer, from what the door would read. Pure: the route hands in what it read. */
+export declare function starterPublishFactsAnswer(input: {
+    facts: Omit<StarterPublishFacts, 'priceUsd'>;
+    builtin: SiteStarterBuiltinReading | null;
+}): StarterPublishFactsAnswer;