@aglyn/plugins-marketplace 1.2.0 → 1.4.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/publisher-agreement.d.ts

@@ -106,8 +106,20 @@
  * merchant of record and determines, collects and remits transaction tax since
  * 2026-08-14. The Terms of Service moved TO them in this pass (new ToS §10.7),
  * not the other way around.
+ *
+ * ## 2026-11-02 — `2026-11-02.1`, site starters (AGL-4049)
+ *
+ * The opening names site starters among the Artifacts, and §1 is now "Site
+ * Starters": a site starter is an Artifact and everything in it is warranted
+ * under §3. That replaces §1's pre-release paragraph. Its "AS IS" wording stays
+ * in §10, and the right to change the Marketplace stays in Terms of Service
+ * §5.1. §2 to §14 keep their numbers, because the repo and the native screens
+ * cite them.
+ *
+ * The capture also carries §8.6's "license" spelling, which the page already
+ * served after the `2026-08-24.1` pin was taken.
  */
-export declare const PUBLISHER_AGREEMENT_VERSION = "2026-08-24.1";
+export declare const PUBLISHER_AGREEMENT_VERSION = "2026-11-02.1";
 export declare const PUBLISHER_AGREEMENT_TITLE = "Marketplace Publisher Agreement";
 /**
  * The snapshot pin for the version above (AGL-1678).
@@ -144,9 +156,9 @@ export declare const PUBLISHER_AGREEMENT_TITLE = "Marketplace Publisher Agreemen
  * hand-write a snapshot: it is evidence of what a publisher was shown, and a
  * snapshot of unpublished text is a false record.
  */
-export declare const PUBLISHER_AGREEMENT_SHA256 = "2df6e940f037b4630e53c8f63bad8604ef4bf370374b89afcd4ea7f9fe8e8d63";
+export declare const PUBLISHER_AGREEMENT_SHA256 = "3a345609a30e915be53dfeaf8e4a2c141e92a250e39cf741f8c8c0c9c764d23c";
 /** Byte length of the same snapshot — a cheap second check on the content. */
-export declare const PUBLISHER_AGREEMENT_BYTES = 13730;
+export declare const PUBLISHER_AGREEMENT_BYTES = 13709;
 /**
  * Canonical document, on the operator's legal origin beside the other terms.
  *

package/src/lib/model/publisher-agreement.js

@@ -129,7 +129,19 @@
  * merchant of record and determines, collects and remits transaction tax since
  * 2026-08-14. The Terms of Service moved TO them in this pass (new ToS §10.7),
  * not the other way around.
- */ export const PUBLISHER_AGREEMENT_VERSION = '2026-08-24.1';
+ *
+ * ## 2026-11-02 — `2026-11-02.1`, site starters (AGL-4049)
+ *
+ * The opening names site starters among the Artifacts, and §1 is now "Site
+ * Starters": a site starter is an Artifact and everything in it is warranted
+ * under §3. That replaces §1's pre-release paragraph. Its "AS IS" wording stays
+ * in §10, and the right to change the Marketplace stays in Terms of Service
+ * §5.1. §2 to §14 keep their numbers, because the repo and the native screens
+ * cite them.
+ *
+ * The capture also carries §8.6's "license" spelling, which the page already
+ * served after the `2026-08-24.1` pin was taken.
+ */ export const PUBLISHER_AGREEMENT_VERSION = '2026-11-02.1';
 export const PUBLISHER_AGREEMENT_TITLE = 'Marketplace Publisher Agreement';
 /**
  * The snapshot pin for the version above (AGL-1678).
@@ -165,8 +177,8 @@ export const PUBLISHER_AGREEMENT_TITLE = 'Marketplace Publisher Agreement';
  * the version's entry to `PUBLISHER_AGREEMENT_CHANGES` below. Never
  * hand-write a snapshot: it is evidence of what a publisher was shown, and a
  * snapshot of unpublished text is a false record.
- */ export const PUBLISHER_AGREEMENT_SHA256 = '2df6e940f037b4630e53c8f63bad8604ef4bf370374b89afcd4ea7f9fe8e8d63';
-/** Byte length of the same snapshot — a cheap second check on the content. */ export const PUBLISHER_AGREEMENT_BYTES = 13730;
+ */ export const PUBLISHER_AGREEMENT_SHA256 = '3a345609a30e915be53dfeaf8e4a2c141e92a250e39cf741f8c8c0c9c764d23c';
+/** Byte length of the same snapshot — a cheap second check on the content. */ export const PUBLISHER_AGREEMENT_BYTES = 13709;
 /**
  * Canonical document, on the operator's legal origin beside the other terms.
  *
@@ -277,6 +289,14 @@ export const PUBLISHER_AGREEMENT_TITLE = 'Marketplace Publisher Agreement';
         changes: [
             '§13.3: venue moves to Travis County, Texas, and governing law now cites Terms of Service Section 18.6.'
         ]
+    },
+    {
+        version: '2026-11-02.1',
+        changes: [
+            'Opening paragraph: site starters are among the Artifacts you can publish.',
+            '§1, new: a site starter is an Artifact. Its pages, shared layout, theme and, for an AI site starter, its answers are its content, and you warrant them under §3. §1 no longer describes the Marketplace as pre-release.',
+            '§8.6: a spelling correction, with no change in meaning.'
+        ]
     }
 ];
 /**