@aglyn/tenant-feature-instance 1.0.0-beta.143

package/src/lib/hooks/use-host-version-api.d.ts

@@ -0,0 +1,59 @@
+/**
+ * @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.
+ */
+/**
+ * Parents that carry besigner version history (AGL-1369).
+ *
+ * `form` is here because a form is designed, not merely declared: it opens in
+ * the besigner, saves a draft per version, and publishes a snapshot onto its
+ * parent document, which is the component lifecycle exactly.
+ */
+export type HostVersionParentKind = 'screen' | 'layout' | 'component' | 'form';
+/**
+ * Options for {@link useHostVersionApi}. Either `data` (a version written from
+ * scratch — the seed a new screen/layout/component needs to be editable) or
+ * `sourceVersionId` (snapshot an existing version; the route copies the stored
+ * document server-side, so the node map never crosses the wire).
+ */
+export interface CreateHostVersionOptions {
+    hostId: string;
+    kind: HostVersionParentKind;
+    parentId: string;
+    /** Pre-generated id, when the caller must reference it immediately. */
+    id?: string;
+    data?: Record<string, unknown>;
+    sourceVersionId?: string;
+}
+/**
+ * Creates a besigner version document through the console API (AGL-1369).
+ *
+ * Firestore rules deny client-side `create` under
+ * `hosts/{h}/{screens|layouts|components}/{id}/versions`, so this is the only
+ * creation path. SAVING a version stays client-direct — a save is a merge-set
+ * onto the document already open, which is an update, and it must keep working
+ * on every plan.
+ *
+ * The route decides whether the create is free or paid by counting what is
+ * already there: the first version of a resource is allowed on any plan (a
+ * resource with no version cannot be opened), and retaining a second requires
+ * `versioning` (Pro+). Callers do not declare which case they are in.
+ *
+ * Throws with the server's message on denial, for the caller's snackbar.
+ */
+export declare function useHostVersionApi(): (options: CreateHostVersionOptions) => Promise<{
+    id: string;
+}>;
+export default useHostVersionApi;

package/src/lib/hooks/use-host-version-api.js

@@ -0,0 +1,69 @@
+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 { useCallback } from "react";
+import { useUser } from "./firebase/firebase-services.js";
+import { authorizedFetch } from "@aglyn/shared-util-http/authorized-token";
+/**
+ * Creates a besigner version document through the console API (AGL-1369).
+ *
+ * Firestore rules deny client-side `create` under
+ * `hosts/{h}/{screens|layouts|components}/{id}/versions`, so this is the only
+ * creation path. SAVING a version stays client-direct — a save is a merge-set
+ * onto the document already open, which is an update, and it must keep working
+ * on every plan.
+ *
+ * The route decides whether the create is free or paid by counting what is
+ * already there: the first version of a resource is allowed on any plan (a
+ * resource with no version cannot be opened), and retaining a second requires
+ * `versioning` (Pro+). Callers do not declare which case they are in.
+ *
+ * Throws with the server's message on denial, for the caller's snackbar.
+ */ export function useHostVersionApi() {
+    const { data: user } = useUser();
+    return useCallback(async ({ hostId, kind, parentId, id, data, sourceVersionId })=>{
+        const response = await authorizedFetch(user, '/api/hosts/versions', {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json'
+            },
+            body: JSON.stringify(_extends({
+                hostId,
+                kind,
+                parentId
+            }, id ? {
+                id
+            } : {}, data ? {
+                data
+            } : {}, sourceVersionId ? {
+                sourceVersionId
+            } : {}))
+        });
+        const result = await response.json().catch(()=>({}));
+        if (!response.ok) {
+            var _ref;
+            throw new Error((_ref = result == null ? void 0 : result.error) != null ? _ref : 'Create failed');
+        }
+        return {
+            id: String(result.id)
+        };
+    }, [
+        user
+    ]);
+}
+export default useHostVersionApi;
+
+//# sourceMappingURL=use-host-version-api.js.map

package/src/lib/hooks/use-host-version-api.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../../libs/tenant/feature/instance/src/lib/hooks/use-host-version-api.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 { useCallback } from 'react'\nimport { useUser } from './firebase/firebase-services'\nimport { authorizedFetch } from '@aglyn/shared-util-http/authorized-token'\n\n/**\n * Parents that carry besigner version history (AGL-1369).\n *\n * `form` is here because a form is designed, not merely declared: it opens in\n * the besigner, saves a draft per version, and publishes a snapshot onto its\n * parent document, which is the component lifecycle exactly.\n */\nexport type HostVersionParentKind =\n  | 'screen'\n  | 'layout'\n  | 'component'\n  | 'form'\n\n/**\n * Options for {@link useHostVersionApi}. Either `data` (a version written from\n * scratch — the seed a new screen/layout/component needs to be editable) or\n * `sourceVersionId` (snapshot an existing version; the route copies the stored\n * document server-side, so the node map never crosses the wire).\n */\nexport interface CreateHostVersionOptions {\n  hostId: string\n  kind: HostVersionParentKind\n  parentId: string\n  /** Pre-generated id, when the caller must reference it immediately. */\n  id?: string\n  data?: Record<string, unknown>\n  sourceVersionId?: string\n}\n\n/**\n * Creates a besigner version document through the console API (AGL-1369).\n *\n * Firestore rules deny client-side `create` under\n * `hosts/{h}/{screens|layouts|components}/{id}/versions`, so this is the only\n * creation path. SAVING a version stays client-direct — a save is a merge-set\n * onto the document already open, which is an update, and it must keep working\n * on every plan.\n *\n * The route decides whether the create is free or paid by counting what is\n * already there: the first version of a resource is allowed on any plan (a\n * resource with no version cannot be opened), and retaining a second requires\n * `versioning` (Pro+). Callers do not declare which case they are in.\n *\n * Throws with the server's message on denial, for the caller's snackbar.\n */\nexport function useHostVersionApi(): (\n  options: CreateHostVersionOptions,\n) => Promise<{ id: string }> {\n  const { data: user } = useUser()\n  return useCallback(\n    async ({ hostId, kind, parentId, id, data, sourceVersionId }) => {\n      const response = await authorizedFetch(user, '/api/hosts/versions', {\n        method: 'POST',\n        headers: { 'Content-Type': 'application/json' },\n        body: JSON.stringify({\n          hostId,\n          kind,\n          parentId,\n          ...(id ? { id } : {}),\n          ...(data ? { data } : {}),\n          ...(sourceVersionId ? { sourceVersionId } : {}),\n        }),\n      })\n      const result = await response.json().catch(() => ({}))\n      if (!response.ok) {\n        throw new Error(result?.error ?? 'Create failed')\n      }\n      return { id: String(result.id) }\n    },\n    [user],\n  )\n}\n\nexport default useHostVersionApi\n"],"names":["useCallback","useUser","authorizedFetch","useHostVersionApi","data","user","hostId","kind","parentId","id","sourceVersionId","response","method","headers","body","JSON","stringify","result","json","catch","ok","Error","error","String"],"mappings":";AAAA;;;;;;;;;;;;;;;CAeC,GAED,SAASA,WAAW,QAAQ,QAAO;AACnC,SAASC,OAAO,QAAQ,kCAA8B;AACtD,SAASC,eAAe,QAAQ,2CAA0C;AA+B1E;;;;;;;;;;;;;;;CAeC,GACD,OAAO,SAASC;IAGd,MAAM,EAAEC,MAAMC,IAAI,EAAE,GAAGJ;IACvB,OAAOD,YACL,OAAO,EAAEM,MAAM,EAAEC,IAAI,EAAEC,QAAQ,EAAEC,EAAE,EAAEL,IAAI,EAAEM,eAAe,EAAE;QAC1D,MAAMC,WAAW,MAAMT,gBAAgBG,MAAM,uBAAuB;YAClEO,QAAQ;YACRC,SAAS;gBAAE,gBAAgB;YAAmB;YAC9CC,MAAMC,KAAKC,SAAS,CAAC;gBACnBV;gBACAC;gBACAC;eACIC,KAAK;gBAAEA;YAAG,IAAI,CAAC,GACfL,OAAO;gBAAEA;YAAK,IAAI,CAAC,GACnBM,kBAAkB;gBAAEA;YAAgB,IAAI,CAAC;QAEjD;QACA,MAAMO,SAAS,MAAMN,SAASO,IAAI,GAAGC,KAAK,CAAC,IAAO,CAAA,CAAC,CAAA;QACnD,IAAI,CAACR,SAASS,EAAE,EAAE;;YAChB,MAAM,IAAIC,cAAMJ,0BAAAA,OAAQK,KAAK,mBAAI;QACnC;QACA,OAAO;YAAEb,IAAIc,OAAON,OAAOR,EAAE;QAAE;IACjC,GACA;QAACJ;KAAK;AAEV;AAEA,eAAeF,kBAAiB"}

package/src/lib/hooks/use-host.d.ts

@@ -0,0 +1,101 @@
+/**
+ * @license
+ * Copyright 2022 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 * as Aglyn from '@aglyn/aglyn';
+import { type FirestoreDocOptions } from './firebase/firebase-services';
+export declare const useHostRef: ({ hostId }: {
+    hostId: Aglyn.HostUid;
+}) => import("@firebase/firestore").DocumentReference<Aglyn.AglynHost, {
+    [field: string]: any;
+    orgId?: Aglyn.OrgUid;
+    memberRoles?: Record<Aglyn.UserUid, string>;
+    subdomain?: string;
+    cname?: string;
+    announcementBar?: Aglyn.HostAnnouncementBar;
+    popup?: Aglyn.HostPopup;
+    displayName?: string;
+    logoUrl?: string;
+    seo?: {
+        title?: string;
+        description?: string;
+        separator?: string;
+        favicon?: string;
+        appIcon?: string;
+        image?: string;
+        imageWidth?: number;
+        imageHeight?: number;
+        imageAlt?: string;
+        discourageSearchEngines?: boolean;
+        entity?: {
+            type?: Aglyn.HostEntityType;
+            name?: string;
+            logo?: string;
+            description?: string;
+            url?: string;
+            sameAs?: string[];
+            email?: string;
+            telephone?: string;
+            contactType?: string;
+            address?: {
+                streetAddress?: string;
+                addressLocality?: string;
+                addressRegion?: string;
+                postalCode?: string;
+                addressCountry?: string;
+            };
+        };
+        agent?: {
+            whenToUse?: string;
+            howToUse?: string;
+        };
+    };
+    analytics?: {
+        gaMeasurementId?: string;
+        gtmContainerId?: string;
+        adTags?: Record<string, string> | null;
+    };
+    consent?: {
+        disabled?: boolean;
+        mode?: "geo" | "strict";
+        advertising?: boolean;
+    };
+    screens?: Record<Aglyn.ScreenUid, Aglyn.ScreenSlug>;
+    notFoundScreenId?: Aglyn.ScreenUid;
+    errorScreens?: Aglyn.HostErrorScreens;
+    authScreens?: import("@aglyn/aglyn/src/lib/foundation/definitions/platform.types").HostAuthScreens;
+    maintenance?: boolean;
+    suspendedAt?: number;
+    suspendedReasonCode?: string;
+    suspendedMessage?: string;
+    suspendedUntilMs?: number;
+    disabledPlugins?: string[];
+    enabledPlugins?: string[];
+    approvedImageHosts?: string[];
+    locales?: string[];
+    defaultLocale?: string;
+    layouts?: Record<Aglyn.LayoutUid, string>;
+    theme?: Aglyn.AglynHostTheme;
+    redirects?: Record<Aglyn.RedirectUid, true>;
+    projectId?: Aglyn.ProjectUid;
+    projectNumber?: Aglyn.ProjectNumber;
+}>;
+export declare const useHost: (data: {
+    hostId: Aglyn.HostUid;
+}, options?: FirestoreDocOptions<Aglyn.AglynHost>) => {
+    doc: import("./firebase/firebase-services").ObservableStatus<Aglyn.AglynHost>;
+    setDoc: import("./helpers/use-modify-doc-callback").ModifyDocCallback<Aglyn.AglynHost>;
+};
+export default useHost;

package/src/lib/hooks/use-host.js

@@ -0,0 +1,45 @@
+/**
+ * @license
+ * Copyright 2022 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.
+ */ // A TYPE-only namespace: every `Aglyn.` reference below is a type, and held
+// as a VALUE the namespace pins every module the barrel reaches into the
+// console shell that renders these hooks. `import type` erases instead.
+import { _ as _object_without_properties_loose } from "@swc/helpers/_/_object_without_properties_loose";
+import { doc } from "firebase/firestore";
+import { useFirestore } from "./firebase/firebase-services.js";
+import useDoc from "./helpers/use-doc.js";
+export const useHostRef = ({ hostId })=>{
+    const firestore = useFirestore();
+    const ref = doc(firestore, 'hosts', hostId);
+    return ref.withConverter({
+        toFirestore (data) {
+            const { $id } = data, rest = _object_without_properties_loose(data, [
+                "$id"
+            ]);
+            return rest;
+        },
+        fromFirestore (snapshot, options) {
+            if (!snapshot.exists()) return undefined;
+            const data = snapshot.data(options);
+            return data;
+        }
+    });
+};
+export const useHost = (data, options)=>{
+    return useDoc(useHostRef(data), options);
+};
+export default useHost;
+
+//# sourceMappingURL=use-host.js.map

package/src/lib/hooks/use-host.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../../libs/tenant/feature/instance/src/lib/hooks/use-host.tsx"],"sourcesContent":["/**\n * @license\n * Copyright 2022 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// A TYPE-only namespace: every `Aglyn.` reference below is a type, and held\n// as a VALUE the namespace pins every module the barrel reaches into the\n// console shell that renders these hooks. `import type` erases instead.\nimport type * as Aglyn from '@aglyn/aglyn'\nimport {\n  doc,\n  type DocumentSnapshot,\n  type SnapshotOptions,\n} from 'firebase/firestore'\nimport { useFirestore, type FirestoreDocOptions } from './firebase/firebase-services'\nimport useDoc from './helpers/use-doc'\n\nexport const useHostRef = ({ hostId }: { hostId: Aglyn.HostUid }) => {\n  const firestore = useFirestore()\n  const ref = doc(firestore, 'hosts', hostId)\n  return ref.withConverter({\n    toFirestore(data: Aglyn.AglynHost) {\n      const { $id, ...rest } = data\n      return rest\n    },\n    fromFirestore(\n      snapshot: DocumentSnapshot<Aglyn.AglynHost>,\n      options: SnapshotOptions,\n    ) {\n      if (!snapshot.exists()) return undefined\n      const data = snapshot.data(options)\n      return data as Aglyn.AglynHost\n    },\n  })\n}\n\nexport const useHost = (\n  data: { hostId: Aglyn.HostUid },\n  options?: FirestoreDocOptions<Aglyn.AglynHost>,\n) => {\n  return useDoc(useHostRef(data), options)\n}\n\nexport default useHost\n"],"names":["doc","useFirestore","useDoc","useHostRef","hostId","firestore","ref","withConverter","toFirestore","data","$id","rest","fromFirestore","snapshot","options","exists","undefined","useHost"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED,4EAA4E;AAC5E,yEAAyE;AACzE,wEAAwE;;AAExE,SACEA,GAAG,QAGE,qBAAoB;AAC3B,SAASC,YAAY,QAAkC,kCAA8B;AACrF,OAAOC,YAAY,uBAAmB;AAEtC,OAAO,MAAMC,aAAa,CAAC,EAAEC,MAAM,EAA6B;IAC9D,MAAMC,YAAYJ;IAClB,MAAMK,MAAMN,IAAIK,WAAW,SAASD;IACpC,OAAOE,IAAIC,aAAa,CAAC;QACvBC,aAAYC,IAAqB;YAC/B,MAAM,EAAEC,GAAG,EAAW,GAAGD,MAATE,wCAASF;;;YACzB,OAAOE;QACT;QACAC,eACEC,QAA2C,EAC3CC,OAAwB;YAExB,IAAI,CAACD,SAASE,MAAM,IAAI,OAAOC;YAC/B,MAAMP,OAAOI,SAASJ,IAAI,CAACK;YAC3B,OAAOL;QACT;IACF;AACF,EAAC;AAED,OAAO,MAAMQ,UAAU,CACrBR,MACAK;IAEA,OAAOZ,OAAOC,WAAWM,OAAOK;AAClC,EAAC;AAED,eAAeG,QAAO"}

package/src/lib/hooks/use-layout-version.d.ts

@@ -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.
+ */
+import type * as Aglyn from '@aglyn/aglyn';
+import type { DocumentReference } from 'firebase/firestore';
+import { type FirestoreDocOptions } from './firebase/firebase-services';
+export declare const useLayoutVersionRef: ({ hostId, layoutId, versionId, }: {
+    hostId: string;
+    layoutId: string;
+    versionId: string;
+}) => DocumentReference<Aglyn.AglynLayoutVersion>;
+export declare const useLayoutVersion: (data: {
+    hostId: string;
+    layoutId: string;
+    versionId: string;
+}, options?: FirestoreDocOptions<Aglyn.AglynLayoutVersion>) => {
+    doc: import("./firebase/firebase-services").ObservableStatus<Aglyn.AglynLayoutVersion>;
+    setDoc: import("./helpers/use-modify-doc-callback").ModifyDocCallback<Aglyn.AglynLayoutVersion>;
+};
+export default useLayoutVersion;

package/src/lib/hooks/use-layout-version.js

@@ -0,0 +1,64 @@
+/**
+ * @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.
+ */ // A TYPE-only namespace: every `Aglyn.` reference below is a type, and held
+// as a VALUE the namespace pins every module the barrel reaches into the
+// console shell that renders these hooks. `import type` erases instead.
+import { _ as _extends } from "@swc/helpers/_/_extends";
+import { _ as _object_without_properties_loose } from "@swc/helpers/_/_object_without_properties_loose";
+import { compress, decompress } from "@aglyn/aglyn";
+import { Timestamp } from "@aglyn/shared-util-timestamp";
+import { Bytes, doc } from "firebase/firestore";
+import { useFirestore } from "./firebase/firebase-services.js";
+import useDoc from "./helpers/use-doc.js";
+export const useLayoutVersionRef = ({ hostId, layoutId, versionId })=>{
+    const firestore = useFirestore();
+    const ref = doc(firestore, 'hosts', hostId, 'layouts', layoutId, 'versions', versionId);
+    // Same converter behavior as screen versions: nodes are compressed at rest.
+    return ref.withConverter({
+        toFirestore (data) {
+            const { $id } = data, rest = _object_without_properties_loose(data, [
+                "$id"
+            ]);
+            // Only emit `nodes` when the write carries them — see the note in
+            // use-screen-version (AGL-1250). A partial merge write otherwise
+            // ships an empty compressed map and wipes the document's tree.
+            if ((rest == null ? void 0 : rest.nodes) === undefined) return _extends({}, rest, {
+                updatedAt: Timestamp.now()
+            });
+            const nodes = rest.nodes instanceof Bytes ? rest.nodes : Bytes.fromUint8Array(compress(rest.nodes));
+            return _extends({}, rest, {
+                nodes,
+                updatedAt: Timestamp.now()
+            });
+        },
+        fromFirestore (snapshot, options) {
+            if (!snapshot.exists()) return undefined;
+            const data = snapshot.data(options);
+            if ((data == null ? void 0 : data.nodes) instanceof Bytes) {
+                return _extends({}, data, {
+                    nodes: decompress(data.nodes)
+                });
+            }
+            return data;
+        }
+    });
+};
+export const useLayoutVersion = (data, options)=>{
+    return useDoc(useLayoutVersionRef(data), options);
+};
+export default useLayoutVersion;
+
+//# sourceMappingURL=use-layout-version.js.map

package/src/lib/hooks/use-layout-version.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../../libs/tenant/feature/instance/src/lib/hooks/use-layout-version.tsx"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\n// A TYPE-only namespace: every `Aglyn.` reference below is a type, and held\n// as a VALUE the namespace pins every module the barrel reaches into the\n// console shell that renders these hooks. `import type` erases instead.\nimport type * as Aglyn from '@aglyn/aglyn'\nimport { compress, decompress } from '@aglyn/aglyn'\nimport { Timestamp } from '@aglyn/shared-util-timestamp'\nimport type { DocumentReference } from 'firebase/firestore'\nimport { Bytes, doc } from 'firebase/firestore'\nimport { useFirestore, type FirestoreDocOptions } from './firebase/firebase-services'\nimport useDoc from './helpers/use-doc'\n\nexport const useLayoutVersionRef = ({\n  hostId,\n  layoutId,\n  versionId,\n}: {\n  hostId: string\n  layoutId: string\n  versionId: string\n}) => {\n  const firestore = useFirestore()\n  const ref = doc(\n    firestore,\n    'hosts',\n    hostId,\n    'layouts',\n    layoutId,\n    'versions',\n    versionId,\n  )\n  // Same converter behavior as screen versions: nodes are compressed at rest.\n  return ref.withConverter({\n    toFirestore(data) {\n      const { $id, ...rest } = data\n      // Only emit `nodes` when the write carries them — see the note in\n      // use-screen-version (AGL-1250). A partial merge write otherwise\n      // ships an empty compressed map and wipes the document's tree.\n      if (rest?.nodes === undefined) return { ...rest, updatedAt: Timestamp.now() }\n      const nodes = rest.nodes instanceof Bytes\n        ? rest.nodes\n        : Bytes.fromUint8Array(compress(rest.nodes))\n      return { ...rest, nodes, updatedAt: Timestamp.now() }\n    },\n    fromFirestore(snapshot, options) {\n      if (!snapshot.exists()) return undefined\n      const data = snapshot.data(options)\n      if (data?.nodes instanceof Bytes) {\n        return {\n          ...data,\n          nodes: decompress(data.nodes),\n        } as Aglyn.AglynLayoutVersion\n      }\n      return data as Aglyn.AglynLayoutVersion\n    },\n  }) as DocumentReference<Aglyn.AglynLayoutVersion>\n}\n\nexport const useLayoutVersion = (\n  data: {\n    hostId: string\n    layoutId: string\n    versionId: string\n  },\n  options?: FirestoreDocOptions<Aglyn.AglynLayoutVersion>,\n) => {\n  return useDoc(useLayoutVersionRef(data), options)\n}\n\nexport default useLayoutVersion\n"],"names":["compress","decompress","Timestamp","Bytes","doc","useFirestore","useDoc","useLayoutVersionRef","hostId","layoutId","versionId","firestore","ref","withConverter","toFirestore","data","$id","rest","nodes","undefined","updatedAt","now","fromUint8Array","fromFirestore","snapshot","options","exists","useLayoutVersion"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED,4EAA4E;AAC5E,yEAAyE;AACzE,wEAAwE;;;AAExE,SAASA,QAAQ,EAAEC,UAAU,QAAQ,eAAc;AACnD,SAASC,SAAS,QAAQ,+BAA8B;AAExD,SAASC,KAAK,EAAEC,GAAG,QAAQ,qBAAoB;AAC/C,SAASC,YAAY,QAAkC,kCAA8B;AACrF,OAAOC,YAAY,uBAAmB;AAEtC,OAAO,MAAMC,sBAAsB,CAAC,EAClCC,MAAM,EACNC,QAAQ,EACRC,SAAS,EAKV;IACC,MAAMC,YAAYN;IAClB,MAAMO,MAAMR,IACVO,WACA,SACAH,QACA,WACAC,UACA,YACAC;IAEF,4EAA4E;IAC5E,OAAOE,IAAIC,aAAa,CAAC;QACvBC,aAAYC,IAAI;YACd,MAAM,EAAEC,GAAG,EAAW,GAAGD,MAATE,wCAASF;;;YACzB,kEAAkE;YAClE,iEAAiE;YACjE,+DAA+D;YAC/D,IAAIE,CAAAA,wBAAAA,KAAMC,KAAK,MAAKC,WAAW,OAAO,aAAKF;gBAAMG,WAAWlB,UAAUmB,GAAG;;YACzE,MAAMH,QAAQD,KAAKC,KAAK,YAAYf,QAChCc,KAAKC,KAAK,GACVf,MAAMmB,cAAc,CAACtB,SAASiB,KAAKC,KAAK;YAC5C,OAAO,aAAKD;gBAAMC;gBAAOE,WAAWlB,UAAUmB,GAAG;;QACnD;QACAE,eAAcC,QAAQ,EAAEC,OAAO;YAC7B,IAAI,CAACD,SAASE,MAAM,IAAI,OAAOP;YAC/B,MAAMJ,OAAOS,SAAST,IAAI,CAACU;YAC3B,IAAIV,CAAAA,wBAAAA,KAAMG,KAAK,aAAYf,OAAO;gBAChC,OAAO,aACFY;oBACHG,OAAOjB,WAAWc,KAAKG,KAAK;;YAEhC;YACA,OAAOH;QACT;IACF;AACF,EAAC;AAED,OAAO,MAAMY,mBAAmB,CAC9BZ,MAKAU;IAEA,OAAOnB,OAAOC,oBAAoBQ,OAAOU;AAC3C,EAAC;AAED,eAAeE,iBAAgB"}

package/src/lib/hooks/use-layout.d.ts

@@ -0,0 +1,41 @@
+/**
+ * @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 * as Aglyn from '@aglyn/aglyn';
+import { Timestamp } from '@aglyn/shared-util-timestamp';
+import { type FirestoreDocOptions } from './firebase/firebase-services';
+export declare const useLayoutRef: ({ hostId, layoutId, }: {
+    hostId: Aglyn.HostUid;
+    layoutId: Aglyn.LayoutUid;
+}) => import("@firebase/firestore").DocumentReference<Aglyn.AglynLayout, {
+    updatedAt: Timestamp;
+    hostId?: Aglyn.HostUid;
+    versionId?: Aglyn.VersionUid;
+    publishSchedule?: Aglyn.PublishSchedule;
+    versions?: Array<Aglyn.VersionUid>;
+    displayName?: string;
+    description?: string;
+    layoutId?: Aglyn.LayoutUid;
+    createdAt?: import("@aglyn/shared-util-timestamp").ITimestamp;
+}>;
+export declare const useLayout: (data: {
+    hostId: Aglyn.HostUid;
+    layoutId: Aglyn.LayoutUid;
+}, options?: FirestoreDocOptions<Aglyn.AglynLayout>) => {
+    doc: import("./firebase/firebase-services").ObservableStatus<Aglyn.AglynLayout>;
+    setDoc: import("./helpers/use-modify-doc-callback").ModifyDocCallback<Aglyn.AglynLayout>;
+};
+export default useLayout;

package/src/lib/hooks/use-layout.js

@@ -0,0 +1,49 @@
+/**
+ * @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.
+ */ // A TYPE-only namespace: every `Aglyn.` reference below is a type, and held
+// as a VALUE the namespace pins every module the barrel reaches into the
+// console shell that renders these hooks. `import type` erases instead.
+import { _ as _extends } from "@swc/helpers/_/_extends";
+import { _ as _object_without_properties_loose } from "@swc/helpers/_/_object_without_properties_loose";
+import { Timestamp } from "@aglyn/shared-util-timestamp";
+import { doc } from "firebase/firestore";
+import { useFirestore } from "./firebase/firebase-services.js";
+import useDoc from "./helpers/use-doc.js";
+export const useLayoutRef = ({ hostId, layoutId })=>{
+    const firestore = useFirestore();
+    const ref = doc(firestore, 'hosts', hostId, 'layouts', layoutId);
+    return ref.withConverter({
+        toFirestore (data) {
+            const { $id } = data, rest = _object_without_properties_loose(data, [
+                "$id"
+            ]);
+            return _extends({}, rest, {
+                updatedAt: Timestamp.now()
+            });
+        },
+        fromFirestore (snapshot, options) {
+            if (!snapshot.exists()) return undefined;
+            const data = snapshot.data(options);
+            return data;
+        }
+    });
+};
+export const useLayout = (data, options)=>{
+    return useDoc(useLayoutRef(data), options);
+};
+export default useLayout;
+
+//# sourceMappingURL=use-layout.js.map

package/src/lib/hooks/use-layout.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../../libs/tenant/feature/instance/src/lib/hooks/use-layout.tsx"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\n// A TYPE-only namespace: every `Aglyn.` reference below is a type, and held\n// as a VALUE the namespace pins every module the barrel reaches into the\n// console shell that renders these hooks. `import type` erases instead.\nimport type * as Aglyn from '@aglyn/aglyn'\nimport { Timestamp } from '@aglyn/shared-util-timestamp'\nimport {\n  doc,\n  type DocumentSnapshot,\n  type SnapshotOptions,\n} from 'firebase/firestore'\nimport { useFirestore, type FirestoreDocOptions } from './firebase/firebase-services'\nimport useDoc from './helpers/use-doc'\n\nexport const useLayoutRef = ({\n  hostId,\n  layoutId,\n}: {\n  hostId: Aglyn.HostUid\n  layoutId: Aglyn.LayoutUid\n}) => {\n  const firestore = useFirestore()\n  const ref = doc(firestore, 'hosts', hostId, 'layouts', layoutId)\n  return ref.withConverter({\n    toFirestore(data: Aglyn.AglynLayout) {\n      const { $id, ...rest } = data\n      return { ...rest, updatedAt: Timestamp.now() }\n    },\n    fromFirestore(\n      snapshot: DocumentSnapshot<Aglyn.AglynLayout>,\n      options: SnapshotOptions,\n    ) {\n      if (!snapshot.exists()) return undefined\n      const data = snapshot.data(options)\n      return data as Aglyn.AglynLayout\n    },\n  })\n}\n\nexport const useLayout = (\n  data: {\n    hostId: Aglyn.HostUid\n    layoutId: Aglyn.LayoutUid\n  },\n  options?: FirestoreDocOptions<Aglyn.AglynLayout>,\n) => {\n  return useDoc(useLayoutRef(data), options)\n}\n\nexport default useLayout\n"],"names":["Timestamp","doc","useFirestore","useDoc","useLayoutRef","hostId","layoutId","firestore","ref","withConverter","toFirestore","data","$id","rest","updatedAt","now","fromFirestore","snapshot","options","exists","undefined","useLayout"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED,4EAA4E;AAC5E,yEAAyE;AACzE,wEAAwE;;;AAExE,SAASA,SAAS,QAAQ,+BAA8B;AACxD,SACEC,GAAG,QAGE,qBAAoB;AAC3B,SAASC,YAAY,QAAkC,kCAA8B;AACrF,OAAOC,YAAY,uBAAmB;AAEtC,OAAO,MAAMC,eAAe,CAAC,EAC3BC,MAAM,EACNC,QAAQ,EAIT;IACC,MAAMC,YAAYL;IAClB,MAAMM,MAAMP,IAAIM,WAAW,SAASF,QAAQ,WAAWC;IACvD,OAAOE,IAAIC,aAAa,CAAC;QACvBC,aAAYC,IAAuB;YACjC,MAAM,EAAEC,GAAG,EAAW,GAAGD,MAATE,wCAASF;;;YACzB,OAAO,aAAKE;gBAAMC,WAAWd,UAAUe,GAAG;;QAC5C;QACAC,eACEC,QAA6C,EAC7CC,OAAwB;YAExB,IAAI,CAACD,SAASE,MAAM,IAAI,OAAOC;YAC/B,MAAMT,OAAOM,SAASN,IAAI,CAACO;YAC3B,OAAOP;QACT;IACF;AACF,EAAC;AAED,OAAO,MAAMU,YAAY,CACvBV,MAIAO;IAEA,OAAOf,OAAOC,aAAaO,OAAOO;AACpC,EAAC;AAED,eAAeG,UAAS"}

package/src/lib/hooks/use-live-artifact-count.d.ts

@@ -0,0 +1,50 @@
+/**
+ * The per-site artifact collections that render as a console list.
+ *
+ * `forms` is one of them: it is created through the same resources route,
+ * keyed by the same generated uid, and listed by the same table. Its cap is
+ * enforced over the WHOLE collection rather than over live documents — a form
+ * is deleted outright, and its submissions keep their `formId` either way —
+ * so the aggregate below matches what `/api/hosts/resources` counts, with the
+ * tombstone subtraction a no-op because nothing writes `deletedAt` on a form.
+ */
+export type HostArtifactCollection = 'screens' | 'layouts' | 'components' | 'templates' | 'forms';
+/**
+ * How many artifacts of a kind a site actually holds — a server aggregate,
+ * not the length of a page (AGL-1716, the AGL-1706 shape).
+ *
+ * A list that pages holds ten rows. Handing that ten to a quota readout is a
+ * confident wrong number in the flattering direction: "10/10 layouts on your
+ * plan" on a site with sixty of them reads as room to spare, right up until
+ * `/api/hosts/resources` refuses the create. The list and the count are
+ * different questions and are asked separately — one aggregate per mount,
+ * re-asked when `epoch` moves.
+ *
+ * ## Why two aggregates rather than one
+ *
+ * Deleting an artifact stamps `deletedAt` and leaves the document in place,
+ * so a published tenant page keeps grafting until its next revalidate. The
+ * enforcing route counts the LIVE ones — `/api/hosts/resources` reads the
+ * collection with a `deletedAt` projection and keeps the entries where it is
+ * `== null` — so a console count over the whole collection would quote a cap
+ * usage the server does not enforce, and would disagree with the list beside
+ * it row for row.
+ *
+ * Firestore cannot express "field is absent" as a predicate, and the two live
+ * shapes are not one value: an artifact created through the resources route
+ * carries no `deletedAt` at all, while one installed from the marketplace
+ * carries an explicit `deletedAt: null` (`install.ts` writes it). So
+ * `where('deletedAt', '==', null)` would return the marketplace copies alone.
+ * Counting the TOMBSTONES instead is exact, because there is only one shape
+ * of tombstone — a `Timestamp` — and subtracting them from the total leaves
+ * precisely the documents the server calls live.
+ *
+ * Both aggregates bill one document read each at these collection sizes.
+ *
+ * @returns the live count, or `null` while it is pending or if it was
+ * refused. A caller must fall back to something that can only UNDERSTATE the
+ * truth, never to `0`: an entitlement check answers from whatever it is
+ * handed, and zero used is the one wrong answer that opens a gate.
+ */
+export declare function useLiveArtifactCount(hostId: string, artifact: HostArtifactCollection, epoch?: number): number | null;
+export default useLiveArtifactCount;