@aglyn/tenant-feature-instance 1.0.0-beta.217 → 1.0.0-beta.219

package/src/lib/hooks/{use-form-version.js → use-host-document-version.js}

@@ -23,19 +23,9 @@ 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";
-/**
- * A form's working version, at
- * `hosts/{hostId}/forms/{formId}/versions/{versionId}`.
- *
- * Compressed at rest, and carrying the same asymmetry a component version
- * does: the PUBLISHED tree lives on the parent `forms/{formId}` document,
- * because a placed form has to resolve on the hot path of a page render and
- * one collection query reaches every form on the site. These documents are
- * editing history — the besigner's draft surface — and nothing renders from
- * them.
- */ export const useFormVersionRef = ({ hostId, formId, versionId })=>{
+export const useHostDocumentVersionRef = ({ hostId, collection, docId, versionId })=>{
     const firestore = useFirestore();
-    const ref = doc(firestore, 'hosts', hostId, 'forms', formId, 'versions', versionId);
+    const ref = doc(firestore, 'hosts', hostId, collection, docId, 'versions', versionId);
     return ref.withConverter({
         toFirestore (data) {
             const { $id } = data, rest = _object_without_properties_loose(data, [
@@ -65,9 +55,9 @@ import useDoc from "./helpers/use-doc.js";
         }
     });
 };
-export const useFormVersion = (data, options)=>{
-    return useDoc(useFormVersionRef(data), options);
+export const useHostDocumentVersion = (ids, options)=>{
+    return useDoc(useHostDocumentVersionRef(ids), options);
 };
-export default useFormVersion;
+export default useHostDocumentVersion;
 
-//# sourceMappingURL=use-form-version.js.map
+//# sourceMappingURL=use-host-document-version.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../../libs/tenant/feature/instance/src/lib/hooks/use-host-document-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 {\n  useFirestore,\n  type FirestoreDocOptions,\n} from './firebase/firebase-services'\nimport useDoc from './helpers/use-doc'\n\n/**\n * A plugin document's working version, at\n * `hosts/{hostId}/{collection}/{docId}/versions/{versionId}` — the storage a\n * kind declared in `besignerDocuments` keeps (`plugin-manager/\n * besigner-documents.ts`).\n *\n * Compressed at rest, and carrying the same asymmetry a component version\n * does: the PUBLISHED tree lives on the parent document, because a placed\n * document has to resolve on the hot path of a page render and one\n * collection query reaches every one on the site. These documents are\n * editing history — the besigner's draft surface — and nothing renders from\n * them.\n */\nexport interface HostDocumentVersion {\n  displayName?: string\n  /** The node a placed copy grafts from; absent on a tree never published. */\n  rootId?: Aglyn.NodeId\n  nodes?: Record<Aglyn.NodeId, Aglyn.AglynNodeSchema>\n  updatedAt?: unknown\n}\n\nexport interface HostDocumentVersionIds {\n  hostId: string\n  /** The subcollection under `hosts/{hostId}` the document lives in. */\n  collection: string\n  docId: string\n  versionId: string\n}\n\nexport const useHostDocumentVersionRef = ({\n  hostId,\n  collection,\n  docId,\n  versionId,\n}: HostDocumentVersionIds) => {\n  const firestore = useFirestore()\n  const ref = doc(\n    firestore,\n    'hosts',\n    hostId,\n    collection,\n    docId,\n    'versions',\n    versionId,\n  )\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 write that compressed\n      // `undefined` would replace the stored tree with an empty one.\n      if (rest?.nodes === undefined)\n        return { ...rest, updatedAt: Timestamp.now() }\n      const nodes =\n        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 HostDocumentVersion\n      }\n      return data as HostDocumentVersion\n    },\n  }) as DocumentReference<HostDocumentVersion>\n}\n\nexport const useHostDocumentVersion = (\n  ids: HostDocumentVersionIds,\n  options?: FirestoreDocOptions<HostDocumentVersion>,\n) => {\n  return useDoc(useHostDocumentVersionRef(ids), options)\n}\n\nexport default useHostDocumentVersion\n"],"names":["compress","decompress","Timestamp","Bytes","doc","useFirestore","useDoc","useHostDocumentVersionRef","hostId","collection","docId","versionId","firestore","ref","withConverter","toFirestore","data","$id","rest","nodes","undefined","updatedAt","now","fromUint8Array","fromFirestore","snapshot","options","exists","useHostDocumentVersion","ids"],"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,SACEC,YAAY,QAEP,kCAA8B;AACrC,OAAOC,YAAY,uBAAmB;AA+BtC,OAAO,MAAMC,4BAA4B,CAAC,EACxCC,MAAM,EACNC,UAAU,EACVC,KAAK,EACLC,SAAS,EACc;IACvB,MAAMC,YAAYP;IAClB,MAAMQ,MAAMT,IACVQ,WACA,SACAJ,QACAC,YACAC,OACA,YACAC;IAEF,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,WAClB,OAAO,aAAKF;gBAAMG,WAAWnB,UAAUoB,GAAG;;YAC5C,MAAMH,QACJD,KAAKC,KAAK,YAAYhB,QAClBe,KAAKC,KAAK,GACVhB,MAAMoB,cAAc,CAACvB,SAASkB,KAAKC,KAAK;YAC9C,OAAO,aAAKD;gBAAMC;gBAAOE,WAAWnB,UAAUoB,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,aAAYhB,OAAO;gBAChC,OAAO,aACFa;oBACHG,OAAOlB,WAAWe,KAAKG,KAAK;;YAEhC;YACA,OAAOH;QACT;IACF;AACF,EAAC;AAED,OAAO,MAAMY,yBAAyB,CACpCC,KACAH;IAEA,OAAOpB,OAAOC,0BAA0BsB,MAAMH;AAChD,EAAC;AAED,eAAeE,uBAAsB"}

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

@@ -83,6 +83,7 @@ export declare const useHostRef: ({ hostId }: {
         advertising?: boolean;
     };
     screens?: Record<Aglyn.ScreenUid, Aglyn.ScreenSlug>;
+    defaultHomeScreenId?: Aglyn.ScreenUid;
     notFoundScreenId?: Aglyn.ScreenUid;
     errorScreens?: Aglyn.HostErrorScreens;
     authScreens?: import("@aglyn/aglyn/src/lib/foundation/definitions/platform.types").HostAuthScreens;
@@ -91,6 +92,7 @@ export declare const useHostRef: ({ hostId }: {
     suspendedReasonCode?: string;
     suspendedMessage?: string;
     suspendedUntilMs?: number;
+    suspended?: boolean;
     disabledPlugins?: string[];
     enabledPlugins?: string[];
     approvedImageHosts?: string[];

package/src/lib/tenant.d.ts

@@ -41,7 +41,7 @@ export * from './hooks/use-host-activity-logger';
 export * from './hooks/use-live-artifact-count';
 export * from './hooks/use-component';
 export * from './hooks/use-component-version';
-export * from './hooks/use-form-version';
+export * from './hooks/use-host-document-version';
 export * from './hooks/use-host-template';
 export * from './hooks/use-console-host-route';
 export * from './hooks/use-host-org-id';

package/src/lib/tenant.js

@@ -40,7 +40,7 @@ export * from "./hooks/use-host-activity-logger.js";
 export * from "./hooks/use-live-artifact-count.js";
 export * from "./hooks/use-component.js";
 export * from "./hooks/use-component-version.js";
-export * from "./hooks/use-form-version.js";
+export * from "./hooks/use-host-document-version.js";
 export * from "./hooks/use-host-template.js";
 export * from "./hooks/use-console-host-route.js";
 export * from "./hooks/use-host-org-id.js";

package/src/lib/tenant.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../../../../libs/tenant/feature/instance/src/lib/tenant.ts"],"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\nexport * from './constants/mock-data'\nexport * from './constants/site-paths'\nexport * from './constants/firebase-config'\nexport * from './constants/firebase-emulator-hosts'\n\nexport * from './hooks/firebase/auth-persistence'\nexport * from './hooks/firebase/firebase-services'\nexport * from './hooks/firebase/firestore-cache'\nexport * from './hooks/firebase/firestore-stall-recovery'\nexport * from './hooks/firebase/firestore-bounded-read'\nexport * from './hooks/helpers/use-doc'\nexport * from './hooks/helpers/use-modify-doc-callback'\nexport * from './hooks/helpers/besigner-nodes-converter'\nexport * from './hooks/helpers/guarded-nodes-save'\nexport * from './hooks/helpers/guarded-seed-write'\n\nexport * from './hooks/firestore-denial-reporter'\nexport * from './hooks/use-firestore-collection'\nexport * from './hooks/use-paged-collection'\nexport * from './hooks/use-sorted-paged-collection'\nexport * from './hooks/sorted-collection-window'\nexport * from './hooks/host-collection-queries'\nexport * from './hooks/list-filter-constraints'\nexport * from './hooks/use-firestore-doc'\nexport * from './hooks/use-switcher-collection'\nexport * from './hooks/use-host-activity-logger'\nexport * from './hooks/use-live-artifact-count'\nexport * from './hooks/use-component'\nexport * from './hooks/use-component-version'\nexport * from './hooks/use-form-version'\nexport * from './hooks/use-host-template'\nexport * from './hooks/use-console-host-route'\nexport * from './hooks/use-host-org-id'\nexport * from './hooks/use-host-campaigns'\nexport * from './hooks/use-org-member-options'\nexport * from './hooks/use-org-plan'\nexport * from './hooks/use-scope-tokens'\nexport * from './hooks/use-host-resource-api'\nexport * from './hooks/use-host-version-api'\nexport * from './hooks/use-duplicate-resource-api'\nexport * from './hooks/use-plugin-api-post'\nexport * from './components/duplicate-resource-dialog'\nexport * from './hooks/use-plugin-config'\nexport * from './hooks/use-host'\nexport * from './hooks/use-layout'\nexport * from './hooks/use-layout-version'\nexport * from './hooks/use-screen'\nexport * from './hooks/use-screen-version'\nexport * from './hooks/use-user-name'\nexport * from './hooks/use-user-photo'\n"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED,cAAc,2BAAuB;AACrC,cAAc,4BAAwB;AACtC,cAAc,iCAA6B;AAC3C,cAAc,yCAAqC;AAEnD,cAAc,uCAAmC;AACjD,cAAc,wCAAoC;AAClD,cAAc,sCAAkC;AAChD,cAAc,+CAA2C;AACzD,cAAc,6CAAyC;AACvD,cAAc,6BAAyB;AACvC,cAAc,6CAAyC;AACvD,cAAc,8CAA0C;AACxD,cAAc,wCAAoC;AAClD,cAAc,wCAAoC;AAElD,cAAc,uCAAmC;AACjD,cAAc,sCAAkC;AAChD,cAAc,kCAA8B;AAC5C,cAAc,yCAAqC;AACnD,cAAc,sCAAkC;AAChD,cAAc,qCAAiC;AAC/C,cAAc,qCAAiC;AAC/C,cAAc,+BAA2B;AACzC,cAAc,qCAAiC;AAC/C,cAAc,sCAAkC;AAChD,cAAc,qCAAiC;AAC/C,cAAc,2BAAuB;AACrC,cAAc,mCAA+B;AAC7C,cAAc,8BAA0B;AACxC,cAAc,+BAA2B;AACzC,cAAc,oCAAgC;AAC9C,cAAc,6BAAyB;AACvC,cAAc,gCAA4B;AAC1C,cAAc,oCAAgC;AAC9C,cAAc,0BAAsB;AACpC,cAAc,8BAA0B;AACxC,cAAc,mCAA+B;AAC7C,cAAc,kCAA8B;AAC5C,cAAc,wCAAoC;AAClD,cAAc,iCAA6B;AAC3C,cAAc,4CAAwC;AACtD,cAAc,+BAA2B;AACzC,cAAc,sBAAkB;AAChC,cAAc,wBAAoB;AAClC,cAAc,gCAA4B;AAC1C,cAAc,wBAAoB;AAClC,cAAc,gCAA4B;AAC1C,cAAc,2BAAuB;AACrC,cAAc,4BAAwB"}
+{"version":3,"sources":["../../../../../../../libs/tenant/feature/instance/src/lib/tenant.ts"],"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\nexport * from './constants/mock-data'\nexport * from './constants/site-paths'\nexport * from './constants/firebase-config'\nexport * from './constants/firebase-emulator-hosts'\n\nexport * from './hooks/firebase/auth-persistence'\nexport * from './hooks/firebase/firebase-services'\nexport * from './hooks/firebase/firestore-cache'\nexport * from './hooks/firebase/firestore-stall-recovery'\nexport * from './hooks/firebase/firestore-bounded-read'\nexport * from './hooks/helpers/use-doc'\nexport * from './hooks/helpers/use-modify-doc-callback'\nexport * from './hooks/helpers/besigner-nodes-converter'\nexport * from './hooks/helpers/guarded-nodes-save'\nexport * from './hooks/helpers/guarded-seed-write'\n\nexport * from './hooks/firestore-denial-reporter'\nexport * from './hooks/use-firestore-collection'\nexport * from './hooks/use-paged-collection'\nexport * from './hooks/use-sorted-paged-collection'\nexport * from './hooks/sorted-collection-window'\nexport * from './hooks/host-collection-queries'\nexport * from './hooks/list-filter-constraints'\nexport * from './hooks/use-firestore-doc'\nexport * from './hooks/use-switcher-collection'\nexport * from './hooks/use-host-activity-logger'\nexport * from './hooks/use-live-artifact-count'\nexport * from './hooks/use-component'\nexport * from './hooks/use-component-version'\nexport * from './hooks/use-host-document-version'\nexport * from './hooks/use-host-template'\nexport * from './hooks/use-console-host-route'\nexport * from './hooks/use-host-org-id'\nexport * from './hooks/use-host-campaigns'\nexport * from './hooks/use-org-member-options'\nexport * from './hooks/use-org-plan'\nexport * from './hooks/use-scope-tokens'\nexport * from './hooks/use-host-resource-api'\nexport * from './hooks/use-host-version-api'\nexport * from './hooks/use-duplicate-resource-api'\nexport * from './hooks/use-plugin-api-post'\nexport * from './components/duplicate-resource-dialog'\nexport * from './hooks/use-plugin-config'\nexport * from './hooks/use-host'\nexport * from './hooks/use-layout'\nexport * from './hooks/use-layout-version'\nexport * from './hooks/use-screen'\nexport * from './hooks/use-screen-version'\nexport * from './hooks/use-user-name'\nexport * from './hooks/use-user-photo'\n"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED,cAAc,2BAAuB;AACrC,cAAc,4BAAwB;AACtC,cAAc,iCAA6B;AAC3C,cAAc,yCAAqC;AAEnD,cAAc,uCAAmC;AACjD,cAAc,wCAAoC;AAClD,cAAc,sCAAkC;AAChD,cAAc,+CAA2C;AACzD,cAAc,6CAAyC;AACvD,cAAc,6BAAyB;AACvC,cAAc,6CAAyC;AACvD,cAAc,8CAA0C;AACxD,cAAc,wCAAoC;AAClD,cAAc,wCAAoC;AAElD,cAAc,uCAAmC;AACjD,cAAc,sCAAkC;AAChD,cAAc,kCAA8B;AAC5C,cAAc,yCAAqC;AACnD,cAAc,sCAAkC;AAChD,cAAc,qCAAiC;AAC/C,cAAc,qCAAiC;AAC/C,cAAc,+BAA2B;AACzC,cAAc,qCAAiC;AAC/C,cAAc,sCAAkC;AAChD,cAAc,qCAAiC;AAC/C,cAAc,2BAAuB;AACrC,cAAc,mCAA+B;AAC7C,cAAc,uCAAmC;AACjD,cAAc,+BAA2B;AACzC,cAAc,oCAAgC;AAC9C,cAAc,6BAAyB;AACvC,cAAc,gCAA4B;AAC1C,cAAc,oCAAgC;AAC9C,cAAc,0BAAsB;AACpC,cAAc,8BAA0B;AACxC,cAAc,mCAA+B;AAC7C,cAAc,kCAA8B;AAC5C,cAAc,wCAAoC;AAClD,cAAc,iCAA6B;AAC3C,cAAc,4CAAwC;AACtD,cAAc,+BAA2B;AACzC,cAAc,sBAAkB;AAChC,cAAc,wBAAoB;AAClC,cAAc,gCAA4B;AAC1C,cAAc,wBAAoB;AAClC,cAAc,gCAA4B;AAC1C,cAAc,2BAAuB;AACrC,cAAc,4BAAwB"}

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

@@ -1,44 +0,0 @@
-/**
- * @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';
-/**
- * A form's working version, at
- * `hosts/{hostId}/forms/{formId}/versions/{versionId}`.
- *
- * Compressed at rest, and carrying the same asymmetry a component version
- * does: the PUBLISHED tree lives on the parent `forms/{formId}` document,
- * because a placed form has to resolve on the hot path of a page render and
- * one collection query reaches every form on the site. These documents are
- * editing history — the besigner's draft surface — and nothing renders from
- * them.
- */
-export declare const useFormVersionRef: ({ hostId, formId, versionId, }: {
-    hostId: string;
-    formId: string;
-    versionId: string;
-}) => DocumentReference<Aglyn.FormVersion>;
-export declare const useFormVersion: (data: {
-    hostId: string;
-    formId: string;
-    versionId: string;
-}, options?: FirestoreDocOptions<Aglyn.FormVersion>) => {
-    doc: import("./firebase/firebase-services").ObservableStatus<Aglyn.FormVersion<Aglyn.AglynNodeSchema<Partial<Record<JSX.Key.Any, unknown>>>>>;
-    setDoc: import("./helpers/use-modify-doc-callback").ModifyDocCallback<Aglyn.FormVersion<Aglyn.AglynNodeSchema<Partial<Record<JSX.Key.Any, unknown>>>>>;
-};
-export default useFormVersion;

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

@@ -1 +0,0 @@
-{"version":3,"sources":["../../../../../../../../libs/tenant/feature/instance/src/lib/hooks/use-form-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 {\n  useFirestore,\n  type FirestoreDocOptions,\n} from './firebase/firebase-services'\nimport useDoc from './helpers/use-doc'\n\n/**\n * A form's working version, at\n * `hosts/{hostId}/forms/{formId}/versions/{versionId}`.\n *\n * Compressed at rest, and carrying the same asymmetry a component version\n * does: the PUBLISHED tree lives on the parent `forms/{formId}` document,\n * because a placed form has to resolve on the hot path of a page render and\n * one collection query reaches every form on the site. These documents are\n * editing history — the besigner's draft surface — and nothing renders from\n * them.\n */\nexport const useFormVersionRef = ({\n  hostId,\n  formId,\n  versionId,\n}: {\n  hostId: string\n  formId: string\n  versionId: string\n}) => {\n  const firestore = useFirestore()\n  const ref = doc(\n    firestore,\n    'hosts',\n    hostId,\n    'forms',\n    formId,\n    'versions',\n    versionId,\n  )\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 write that compressed\n      // `undefined` would replace the stored tree with an empty one.\n      if (rest?.nodes === undefined)\n        return { ...rest, updatedAt: Timestamp.now() }\n      const nodes =\n        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.FormVersion\n      }\n      return data as Aglyn.FormVersion\n    },\n  }) as DocumentReference<Aglyn.FormVersion>\n}\n\nexport const useFormVersion = (\n  data: {\n    hostId: string\n    formId: string\n    versionId: string\n  },\n  options?: FirestoreDocOptions<Aglyn.FormVersion>,\n) => {\n  return useDoc(useFormVersionRef(data), options)\n}\n\nexport default useFormVersion\n"],"names":["compress","decompress","Timestamp","Bytes","doc","useFirestore","useDoc","useFormVersionRef","hostId","formId","versionId","firestore","ref","withConverter","toFirestore","data","$id","rest","nodes","undefined","updatedAt","now","fromUint8Array","fromFirestore","snapshot","options","exists","useFormVersion"],"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,SACEC,YAAY,QAEP,kCAA8B;AACrC,OAAOC,YAAY,uBAAmB;AAEtC;;;;;;;;;;CAUC,GACD,OAAO,MAAMC,oBAAoB,CAAC,EAChCC,MAAM,EACNC,MAAM,EACNC,SAAS,EAKV;IACC,MAAMC,YAAYN;IAClB,MAAMO,MAAMR,IACVO,WACA,SACAH,QACA,SACAC,QACA,YACAC;IAEF,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,WAClB,OAAO,aAAKF;gBAAMG,WAAWlB,UAAUmB,GAAG;;YAC5C,MAAMH,QACJD,KAAKC,KAAK,YAAYf,QAClBc,KAAKC,KAAK,GACVf,MAAMmB,cAAc,CAACtB,SAASiB,KAAKC,KAAK;YAC9C,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,iBAAiB,CAC5BZ,MAKAU;IAEA,OAAOnB,OAAOC,kBAAkBQ,OAAOU;AACzC,EAAC;AAED,eAAeE,eAAc"}