@aglyn/aglyn 1.0.0-beta.229 → 1.0.0-beta.231

package/src/lib/app-utils/host-status.d.ts

@@ -0,0 +1,85 @@
+/**
+ * @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.
+ */
+export interface HostStatus {
+    /** `Live`, `Draft`, `Maintenance`, `Suspended`. */
+    label: string;
+    color: 'success' | 'default' | 'warning' | 'error';
+    /** Why, in one sentence — the pill's tooltip. */
+    detail: string;
+}
+/**
+ * How many pages this site publishes.
+ *
+ * Read off `host.screens` — the map publishing writes into the host document
+ * (`hosts/{hostId}.screens[screenId] = slug`, see `template-screens.ts`) and
+ * the tenant reads to route a request. So a site with an entry has at least
+ * one page a visitor can reach, and one without has none. That makes this a
+ * fact already sitting in a document its readers hold: **no extra read**, on
+ * a page that can list a hundred sites.
+ *
+ * ⚠️ It counts PUBLISHED ROUTES, not authored work. A site with five
+ * unpublished drafts counts 0 — the map is written by publishing and by
+ * nothing else. Every caller is asking "what can a visitor reach?"; a caller
+ * that means "has anyone worked on this?" is asking a different question and
+ * this is the wrong number for it.
+ *
+ * The placeholder home page a new site is created with (AGL-3408) COUNTS
+ * here: it is a page a visitor reaches, so a new site is Live. The first-run
+ * offer asks a different question — has the OWNER published anything? — and
+ * reads `hostIsBlankSite`, which discounts it.
+ */
+export declare function publishedScreenCount(host: {
+    screens?: Record<string, unknown>;
+} | null | undefined): number;
+/**
+ * The `Live` / `Draft` pill the console Sites mockup puts on every card
+ * (AGL-2166).
+ *
+ * Derived from {@link publishedScreenCount}: the pill reports what a visitor
+ * can reach, placeholder home page included.
+ *
+ * The staff admin host page has rendered a `published` / `draft` chip since
+ * AGL-390 off `host.published`, which is not a field on `AglynHost` and is
+ * written by nothing — so that chip has always said `draft`. Deriving from
+ * `screens` is what it should have done.
+ *
+ * Order matters. A suspended site is not "live" whatever it has published,
+ * and a site in maintenance is serving the 503 screen rather than its
+ * pages — reporting either as `Live` would be the console agreeing with a
+ * customer who thinks their site is up.
+ */
+export declare function describeHostStatus(host: {
+    screens?: Record<string, unknown>;
+    maintenance?: boolean;
+    suspendedAt?: number;
+    suspendedUntilMs?: number;
+}): HostStatus;
+/**
+ * `6 of 10 sites · Business plan` — the meta line the Sites mockup puts
+ * opposite the section heading.
+ *
+ * Returns `undefined` rather than a partial line while the org or its plan
+ * is still resolving. A count against the FREE limit is what an unresolved
+ * org produces, and telling a Business customer they are at "1 of 1 sites"
+ * is how a correct page delivers a false upgrade prompt.
+ */
+export declare function describeSiteAllowance(options: {
+    used: number;
+    limit: number | undefined;
+    planLabel: string | undefined;
+    ready: boolean;
+}): string | undefined;

package/src/lib/app-utils/host-status.js

@@ -0,0 +1,115 @@
+/**
+ * @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.
+ */ /**
+ * How many pages this site publishes.
+ *
+ * Read off `host.screens` — the map publishing writes into the host document
+ * (`hosts/{hostId}.screens[screenId] = slug`, see `template-screens.ts`) and
+ * the tenant reads to route a request. So a site with an entry has at least
+ * one page a visitor can reach, and one without has none. That makes this a
+ * fact already sitting in a document its readers hold: **no extra read**, on
+ * a page that can list a hundred sites.
+ *
+ * ⚠️ It counts PUBLISHED ROUTES, not authored work. A site with five
+ * unpublished drafts counts 0 — the map is written by publishing and by
+ * nothing else. Every caller is asking "what can a visitor reach?"; a caller
+ * that means "has anyone worked on this?" is asking a different question and
+ * this is the wrong number for it.
+ *
+ * The placeholder home page a new site is created with (AGL-3408) COUNTS
+ * here: it is a page a visitor reaches, so a new site is Live. The first-run
+ * offer asks a different question — has the OWNER published anything? — and
+ * reads `hostIsBlankSite`, which discounts it.
+ */ export function publishedScreenCount(host) {
+    var _ref;
+    return Object.keys((_ref = host == null ? void 0 : host.screens) != null ? _ref : {}).length;
+}
+/**
+ * The `Live` / `Draft` pill the console Sites mockup puts on every card
+ * (AGL-2166).
+ *
+ * Derived from {@link publishedScreenCount}: the pill reports what a visitor
+ * can reach, placeholder home page included.
+ *
+ * The staff admin host page has rendered a `published` / `draft` chip since
+ * AGL-390 off `host.published`, which is not a field on `AglynHost` and is
+ * written by nothing — so that chip has always said `draft`. Deriving from
+ * `screens` is what it should have done.
+ *
+ * Order matters. A suspended site is not "live" whatever it has published,
+ * and a site in maintenance is serving the 503 screen rather than its
+ * pages — reporting either as `Live` would be the console agreeing with a
+ * customer who thinks their site is up.
+ */ export function describeHostStatus(host) {
+    if (host == null ? void 0 : host.suspendedAt) {
+        // A timed suspension that has elapsed is over, even though the fields
+        // are still on the document — the tenant makes the same check.
+        const until = host.suspendedUntilMs;
+        if (!until || until > Date.now()) {
+            return {
+                label: 'Suspended',
+                color: 'error',
+                detail: 'This site is serving a lockdown notice instead of content.'
+            };
+        }
+    }
+    if (host == null ? void 0 : host.maintenance) {
+        return {
+            label: 'Maintenance',
+            color: 'warning',
+            detail: 'Every path serves the maintenance page.'
+        };
+    }
+    const published = publishedScreenCount(host);
+    if (published > 0) {
+        return {
+            label: 'Live',
+            color: 'success',
+            detail: `${published} published page${published === 1 ? '' : 's'}.`
+        };
+    }
+    return {
+        label: 'Draft',
+        color: 'default',
+        detail: 'Nothing published yet — visitors see the placeholder.'
+    };
+}
+/**
+ * `6 of 10 sites · Business plan` — the meta line the Sites mockup puts
+ * opposite the section heading.
+ *
+ * Returns `undefined` rather than a partial line while the org or its plan
+ * is still resolving. A count against the FREE limit is what an unresolved
+ * org produces, and telling a Business customer they are at "1 of 1 sites"
+ * is how a correct page delivers a false upgrade prompt.
+ */ export function describeSiteAllowance(options) {
+    const { used, limit, planLabel, ready } = options;
+    if (!ready || !planLabel) return undefined;
+    /*
+   * `Number.isFinite`, not `limit < 0` (AGL-2223).
+   *
+   * `UNLIMITED` is `Number.POSITIVE_INFINITY`, and Enterprise's `hostLimit`
+   * is exactly that — so the `< 0` test was never true for the one plan the
+   * Unlimited branch existed for, and an Enterprise organization read
+   * `4 of Infinity sites · Enterprise plan`. The negative case is kept: an
+   * entitlement override can carry a negative sentinel, and reading that as a
+   * cap of "-1 sites" would be the same class of nonsense.
+   */ const cap = limit === undefined || limit === null ? undefined : !Number.isFinite(limit) || limit < 0 ? 'Unlimited' : String(limit);
+    const sites = cap === undefined ? `${used} site${used === 1 ? '' : 's'}` : `${used} of ${cap} site${cap === '1' ? '' : 's'}`;
+    return `${sites} · ${planLabel} plan`;
+}
+
+//# sourceMappingURL=host-status.js.map

package/src/lib/app-utils/host-status.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../libs/aglyn/src/lib/app-utils/host-status.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\nexport interface HostStatus {\n  /** `Live`, `Draft`, `Maintenance`, `Suspended`. */\n  label: string\n  color: 'success' | 'default' | 'warning' | 'error'\n  /** Why, in one sentence — the pill's tooltip. */\n  detail: string\n}\n\n/**\n * How many pages this site publishes.\n *\n * Read off `host.screens` — the map publishing writes into the host document\n * (`hosts/{hostId}.screens[screenId] = slug`, see `template-screens.ts`) and\n * the tenant reads to route a request. So a site with an entry has at least\n * one page a visitor can reach, and one without has none. That makes this a\n * fact already sitting in a document its readers hold: **no extra read**, on\n * a page that can list a hundred sites.\n *\n * ⚠️ It counts PUBLISHED ROUTES, not authored work. A site with five\n * unpublished drafts counts 0 — the map is written by publishing and by\n * nothing else. Every caller is asking \"what can a visitor reach?\"; a caller\n * that means \"has anyone worked on this?\" is asking a different question and\n * this is the wrong number for it.\n *\n * The placeholder home page a new site is created with (AGL-3408) COUNTS\n * here: it is a page a visitor reaches, so a new site is Live. The first-run\n * offer asks a different question — has the OWNER published anything? — and\n * reads `hostIsBlankSite`, which discounts it.\n */\nexport function publishedScreenCount(\n  host: { screens?: Record<string, unknown> } | null | undefined,\n): number {\n  return Object.keys(host?.screens ?? {}).length\n}\n\n/**\n * The `Live` / `Draft` pill the console Sites mockup puts on every card\n * (AGL-2166).\n *\n * Derived from {@link publishedScreenCount}: the pill reports what a visitor\n * can reach, placeholder home page included.\n *\n * The staff admin host page has rendered a `published` / `draft` chip since\n * AGL-390 off `host.published`, which is not a field on `AglynHost` and is\n * written by nothing — so that chip has always said `draft`. Deriving from\n * `screens` is what it should have done.\n *\n * Order matters. A suspended site is not \"live\" whatever it has published,\n * and a site in maintenance is serving the 503 screen rather than its\n * pages — reporting either as `Live` would be the console agreeing with a\n * customer who thinks their site is up.\n */\nexport function describeHostStatus(host: {\n  screens?: Record<string, unknown>\n  maintenance?: boolean\n  suspendedAt?: number\n  suspendedUntilMs?: number\n}): HostStatus {\n  if (host?.suspendedAt) {\n    // A timed suspension that has elapsed is over, even though the fields\n    // are still on the document — the tenant makes the same check.\n    const until = host.suspendedUntilMs\n    if (!until || until > Date.now()) {\n      return {\n        label: 'Suspended',\n        color: 'error',\n        detail: 'This site is serving a lockdown notice instead of content.',\n      }\n    }\n  }\n  if (host?.maintenance) {\n    return {\n      label: 'Maintenance',\n      color: 'warning',\n      detail: 'Every path serves the maintenance page.',\n    }\n  }\n  const published = publishedScreenCount(host)\n  if (published > 0) {\n    return {\n      label: 'Live',\n      color: 'success',\n      detail: `${published} published page${published === 1 ? '' : 's'}.`,\n    }\n  }\n  return {\n    label: 'Draft',\n    color: 'default',\n    detail: 'Nothing published yet — visitors see the placeholder.',\n  }\n}\n\n/**\n * `6 of 10 sites · Business plan` — the meta line the Sites mockup puts\n * opposite the section heading.\n *\n * Returns `undefined` rather than a partial line while the org or its plan\n * is still resolving. A count against the FREE limit is what an unresolved\n * org produces, and telling a Business customer they are at \"1 of 1 sites\"\n * is how a correct page delivers a false upgrade prompt.\n */\nexport function describeSiteAllowance(options: {\n  used: number\n  limit: number | undefined\n  planLabel: string | undefined\n  ready: boolean\n}): string | undefined {\n  const { used, limit, planLabel, ready } = options\n  if (!ready || !planLabel) return undefined\n  /*\n   * `Number.isFinite`, not `limit < 0` (AGL-2223).\n   *\n   * `UNLIMITED` is `Number.POSITIVE_INFINITY`, and Enterprise's `hostLimit`\n   * is exactly that — so the `< 0` test was never true for the one plan the\n   * Unlimited branch existed for, and an Enterprise organization read\n   * `4 of Infinity sites · Enterprise plan`. The negative case is kept: an\n   * entitlement override can carry a negative sentinel, and reading that as a\n   * cap of \"-1 sites\" would be the same class of nonsense.\n   */\n  const cap =\n    limit === undefined || limit === null\n      ? undefined\n      : !Number.isFinite(limit) || limit < 0\n        ? 'Unlimited'\n        : String(limit)\n  const sites =\n    cap === undefined\n      ? `${used} site${used === 1 ? '' : 's'}`\n      : `${used} of ${cap} site${cap === '1' ? '' : 's'}`\n  return `${sites} · ${planLabel} plan`\n}\n"],"names":["publishedScreenCount","host","Object","keys","screens","length","describeHostStatus","suspendedAt","until","suspendedUntilMs","Date","now","label","color","detail","maintenance","published","describeSiteAllowance","options","used","limit","planLabel","ready","undefined","cap","Number","isFinite","String","sites"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAUD;;;;;;;;;;;;;;;;;;;;CAoBC,GACD,OAAO,SAASA,qBACdC,IAA8D;;IAE9D,OAAOC,OAAOC,IAAI,SAACF,wBAAAA,KAAMG,OAAO,mBAAI,CAAC,GAAGC,MAAM;AAChD;AAEA;;;;;;;;;;;;;;;;CAgBC,GACD,OAAO,SAASC,mBAAmBL,IAKlC;IACC,IAAIA,wBAAAA,KAAMM,WAAW,EAAE;QACrB,sEAAsE;QACtE,+DAA+D;QAC/D,MAAMC,QAAQP,KAAKQ,gBAAgB;QACnC,IAAI,CAACD,SAASA,QAAQE,KAAKC,GAAG,IAAI;YAChC,OAAO;gBACLC,OAAO;gBACPC,OAAO;gBACPC,QAAQ;YACV;QACF;IACF;IACA,IAAIb,wBAAAA,KAAMc,WAAW,EAAE;QACrB,OAAO;YACLH,OAAO;YACPC,OAAO;YACPC,QAAQ;QACV;IACF;IACA,MAAME,YAAYhB,qBAAqBC;IACvC,IAAIe,YAAY,GAAG;QACjB,OAAO;YACLJ,OAAO;YACPC,OAAO;YACPC,QAAQ,GAAGE,UAAU,eAAe,EAAEA,cAAc,IAAI,KAAK,IAAI,CAAC,CAAC;QACrE;IACF;IACA,OAAO;QACLJ,OAAO;QACPC,OAAO;QACPC,QAAQ;IACV;AACF;AAEA;;;;;;;;CAQC,GACD,OAAO,SAASG,sBAAsBC,OAKrC;IACC,MAAM,EAAEC,IAAI,EAAEC,KAAK,EAAEC,SAAS,EAAEC,KAAK,EAAE,GAAGJ;IAC1C,IAAI,CAACI,SAAS,CAACD,WAAW,OAAOE;IACjC;;;;;;;;;GASC,GACD,MAAMC,MACJJ,UAAUG,aAAaH,UAAU,OAC7BG,YACA,CAACE,OAAOC,QAAQ,CAACN,UAAUA,QAAQ,IACjC,cACAO,OAAOP;IACf,MAAMQ,QACJJ,QAAQD,YACJ,GAAGJ,KAAK,KAAK,EAAEA,SAAS,IAAI,KAAK,KAAK,GACtC,GAAGA,KAAK,IAAI,EAAEK,IAAI,KAAK,EAAEA,QAAQ,MAAM,KAAK,KAAK;IACvD,OAAO,GAAGI,MAAM,GAAG,EAAEP,UAAU,KAAK,CAAC;AACvC"}

package/src/lib/app-utils/lockdown.js

@@ -979,7 +979,7 @@ export const LOCKDOWN_REFUSAL_FALLBACK_MESSAGE = 'This is temporarily paused whi
  * generic pause rather than a guess; being vague at a stranger is cheap,
  * being wrong about their money is not.
  */ export function lockdownPausedSurfaceForPluginApiPath(path) {
-    if (path === 'commerce/checkout' || path === 'commerce/cart-checkout' || path === 'commerce/pos-order' || path === 'commerce/draft-order') {
+    if (path === 'commerce/checkout' || path === 'commerce/cart-checkout' || path === 'commerce/pos-order' || path === 'commerce/pos-payment' || path === 'commerce/draft-order') {
         return 'checkout';
     }
     if (path === 'commerce/cart' || path.startsWith('commerce/cart/')) return 'cart';