@powerhousedao/powerhouse-vetra-packages 6.2.2-dev.42 → 6.2.2-dev.44

package/dist/node/{dist-CUHBOv3P.mjs → dist-CS8QwZwZ.mjs}

@@ -1,6 +1,6 @@
 import { D as __commonJSMin, M as __toESM, t as capitalCase } from "./dist-DT7jI9ol.mjs";
-import { $ as generateId, P as replayDocumentVersioned, Q as validateStateSchemaName, S as createPresignedHeader, T as createZip, U as setName, X as validateInitialState, Z as validateModules, a as handleTargetNameCollisions, b as baseSaveToFileHandle, f as logger, g as assertAuthPreservedOnDuplicate, i as generateNodesCopy, l as moveNode, n as copyNode, o as isFileNode, s as isFolderNode, t as addFolder, u as updateNode, v as baseLoadFromInput, x as buildSignedAction, y as baseLoadFromInputVersioned } from "./document-drive-CI0J7nMj.mjs";
-import { a as DriveCollectionId, i as SyncStatus, o as ModuleNotFoundError, t as require_main } from "./main-Db0ei9wX.mjs";
+import { A as createZip, B as replayDocumentVersioned, C as baseSaveToFileHandle, D as createPresignedHeader, S as baseLoadFromInputVersioned, Y as setName, a as handleTargetNameCollisions, at as generateId, f as logger, i as generateNodesCopy, it as validateStateSchemaName, l as moveNode, n as copyNode, nt as validateInitialState, o as isFileNode, rt as validateModules, s as isFolderNode, t as addFolder, u as updateNode, v as assertAuthPreservedOnDuplicate, w as buildSignedAction, x as baseLoadFromInput } from "./document-drive-DrBAR9as.mjs";
+import { a as DriveCollectionId, i as SyncStatus, o as ModuleNotFoundError, t as require_main } from "./main-aITg389Z.mjs";
 import { t as require_graphql } from "./graphql-BfAoPeWM.mjs";
 import { createContext, use, useCallback, useContext, useEffect, useMemo, useState, useSyncExternalStore } from "react";
 import "react/jsx-runtime";
@@ -52,7 +52,7 @@ function makePHEventFunctions(key) {
 	};
 }
 //#endregion
-//#region ../reactor-browser/dist/document-by-id-BPj6Gd7n.js
+//#region ../reactor-browser/dist/document-by-id-DWEQI7wn.js
 async function queueActions(document, actionOrActions) {
 	if (!document) throw new Error("No document provided");
 	if (!actionOrActions) throw new Error("No actions provided");
@@ -103,7 +103,7 @@ async function signAction(action, document) {
 	if (!action.context?.signer) return action;
 	const reactorClient = window.ph?.reactorClientModule?.client;
 	if (!reactorClient) return action;
-	const reducer = (await reactorClient.getDocumentModelModule(document.header.documentType)).reducer;
+	const reducer = (await reactorClient.getDocumentModelModuleForDocument(document)).reducer;
 	const actionSigner = action.context.signer;
 	return await buildSignedAction(action, reducer, document, actionSigner, renown.crypto.sign);
 }
@@ -1743,7 +1743,7 @@ slug.setLocale = function(locale) {
 	defaultLocale = locales[locale] || {};
 };
 //#endregion
-//#region ../reactor-browser/dist/document-operations-DvhxGXqI.js
+//#region ../reactor-browser/dist/document-operations-D0ePGjbp.js
 var DocumentModelNotFoundError = class extends Error {
 	documentType;
 	name = "DocumentModelNotFoundError";
@@ -1765,6 +1765,22 @@ var NoSelectedDocumentError = class extends Error {
 		super("There is no selected document. Did you mean to call 'useSelectedDocumentSafe' instead?");
 	}
 };
+const modalEventFunctions = makePHEventFunctions("modal");
+modalEventFunctions.useValue;
+/** Sets the current modal */
+const setPHModal = modalEventFunctions.setValue;
+modalEventFunctions.addEventHandler;
+/** Shows a modal */
+function showPHModal(modal) {
+	setPHModal(modal);
+}
+/** Shows the delete node modal */
+function showDeleteNodeModal(nodeOrId) {
+	setPHModal({
+		type: "deleteItem",
+		id: typeof nodeOrId === "string" ? nodeOrId : nodeOrId.id
+	});
+}
 function getUserPermissions() {
 	const user = window.ph?.renown?.user;
 	const allowList = window.ph?.allowList;
@@ -1840,6 +1856,67 @@ function extractInitialState(documentScopeOps) {
 function filterDomainOperations(operations) {
 	return Object.fromEntries(Object.entries(operations).filter(([scope]) => !NON_DOMAIN_SCOPES.has(scope)));
 }
+function countOperations(operations) {
+	let total = 0;
+	for (const ops of Object.values(operations)) total += ops?.length ?? 0;
+	return total;
+}
+/**
+* Split an imported document's domain operations at its mid-history upgrade
+* boundaries, so the caller can re-dispatch each upgrade between segments.
+*
+* The seed's CREATE_DOCUMENT and 0 -> N upgrade are replayed by the creation
+* path and must not be repeated. A later upgrade must be: it is where the
+* reducer version changes, and dropping it replays everything after it through
+* the module the document was created with.
+*/
+function splitAtUpgradeBoundaries(operations) {
+	const upgrades = (operations.document ?? []).filter((op) => op.action.type === "UPGRADE_DOCUMENT").filter((op) => op.action.input.fromVersion > 0).sort((a, b) => a.index - b.index);
+	const domain = filterDomainOperations(operations);
+	if (upgrades.length === 0) return [{ operations: domain }];
+	const segments = [];
+	const consumed = /* @__PURE__ */ new Map();
+	const take = (until) => {
+		const slice = {};
+		for (const [scope, ops] of Object.entries(domain)) {
+			if (!ops) continue;
+			const from = consumed.get(scope) ?? 0;
+			const stop = Math.max(from, until(scope, ops));
+			const chunk = ops.slice(from, stop);
+			if (chunk.length > 0) slice[scope] = chunk;
+			consumed.set(scope, stop);
+		}
+		return slice;
+	};
+	for (const upgrade of upgrades) {
+		const input = upgrade.action.input;
+		const slice = take((scope, ops) => boundary(upgrade, scope, ops));
+		segments.push({
+			operations: slice,
+			upgradeTo: input.toVersion
+		});
+	}
+	const tail = take((_scope, ops) => ops.length);
+	if (countOperations(tail) > 0) segments.push({ operations: tail });
+	return segments;
+}
+/**
+* How many of a scope's operations precede an upgrade. Must stay identical to
+* the boundary computation in `replayDocumentVersioned` — snapshots compare
+* against operation indices, not array positions, and the timestamp fallback
+* excludes the upgrade's own instant.
+*/
+function boundary(upgrade, scope, ops) {
+	const snapshot = upgrade.action.input.revision;
+	if (snapshot !== void 0) {
+		const revision = snapshot[scope] ?? 0;
+		let count = 0;
+		for (let i = 0; i < ops.length; i++) if (ops[i].index < revision) count = i + 1;
+		return count;
+	}
+	for (let i = 0; i < ops.length; i++) if (ops[i].timestampUtcMs >= upgrade.timestampUtcMs) return i;
+	return ops.length;
+}
 async function exportFile(document, suggestedName) {
 	const reactorClient = window.ph?.reactorClient;
 	if (!reactorClient) throw new Error("ReactorClient not initialized");
@@ -1887,13 +1964,20 @@ async function loadFile(path) {
 		upgradeManifest
 	});
 }
-async function addDocument(driveId, name, documentType, parentFolder, document, id, preferredEditor) {
+async function addDocument(driveId, name, documentType, parentFolder, document, id, preferredEditor, documentModelVersion) {
 	const { isAllowedToCreateDocuments } = getUserPermissions();
 	if (!isAllowedToCreateDocuments) throw new Error("User is not allowed to create documents");
 	const reactorClient = window.ph?.reactorClientModule?.client;
 	if (!reactorClient) throw new Error("ReactorClient not initialized");
-	const documentModelModule = await reactorClient.getDocumentModelModule(documentType);
+	let documentModelModule;
+	if (documentModelVersion !== void 0) {
+		const { results: documentModelModules } = await reactorClient.getDocumentModelModules();
+		const module = documentModelModules.find((m) => m.documentModel.global.id === documentType && (m.version ?? 1) === documentModelVersion);
+		if (!module) throw new Error(`Document model not found for type: ${documentType} with version: ${documentModelVersion}`);
+		documentModelModule = module;
+	} else documentModelModule = await reactorClient.getDocumentModelModule(documentType);
 	const newDocument = document ?? documentModelModule.utils.createDocument();
+	if (!document) newDocument.state.document.version = documentModelModule.version ?? 1;
 	newDocument.header.name = name;
 	if (preferredEditor) newDocument.header.meta = {
 		...newDocument.header.meta,
@@ -1941,7 +2025,10 @@ async function addFile(file, driveId, name, parentFolder) {
 		}, {})
 	};
 	await addDocument(driveId, name || document.header.name, document.header.documentType, parentFolder, initialDocument, documentId, document.header.meta?.preferredEditor);
-	await uploadOperations(documentId, filterDomainOperations(document.operations), queueOperations);
+	for (const segment of splitAtUpgradeBoundaries(document.operations)) {
+		await uploadOperations(documentId, segment.operations, queueOperations);
+		if (segment.upgradeTo !== void 0) await upgradeDocument(documentId, segment.upgradeTo);
+	}
 }
 async function addFolder$1(driveId, name, parentFolder) {
 	const { isAllowedToCreateDocuments } = getUserPermissions();
@@ -2070,21 +2157,14 @@ async function copyNode$1(driveId, src, target) {
 	}
 	return await queueActions(drive, copyNodesInput.map((copyNodeInput) => copyNode(copyNodeInput)));
 }
-const modalEventFunctions = makePHEventFunctions("modal");
-modalEventFunctions.useValue;
-/** Sets the current modal */
-const setPHModal = modalEventFunctions.setValue;
-modalEventFunctions.addEventHandler;
-/** Shows a modal */
-function showPHModal(modal) {
-	setPHModal(modal);
-}
-/** Shows the delete node modal */
-function showDeleteNodeModal(nodeOrId) {
-	setPHModal({
-		type: "deleteItem",
-		id: typeof nodeOrId === "string" ? nodeOrId : nodeOrId.id
-	});
+/**
+* Upgrades a document to a newer document model version. Defaults to the
+* latest registered version for the document's type.
+*/
+async function upgradeDocument(documentId, toVersion) {
+	const reactorClient = window.ph?.reactorClientModule?.client;
+	if (!reactorClient) throw new Error("ReactorClient not initialized");
+	return reactorClient.upgradeDocument(documentId, toVersion);
 }
 /**
 * The operation selection of `GetDocumentOperations`, lifted into a fragment so
@@ -2696,6 +2776,7 @@ const useSync = () => useReactorClientModule()?.reactorModule?.syncModule?.syncM
 const useSyncList = () => {
 	return useSync()?.list() ?? [];
 };
+const useModelRegistry = () => useReactorClientModule()?.reactorModule?.documentModelRegistry;
 const revisionHistoryEventFunctions = makePHEventFunctions("revisionHistoryVisible");
 revisionHistoryEventFunctions.useValue;
 /** Sets revision history visibility */
@@ -3550,6 +3631,50 @@ function useDocumentOfType(documentId, documentType) {
 	if (document.header.documentType !== documentType) throw new DocumentTypeMismatchError(documentId, documentType, document.header.documentType);
 	return [document, dispatch];
 }
+/**
+* Classifies a document's model version against the installed module
+* versions. Pure logic, extracted for testing.
+*/
+function getDocumentVersionStatus(documentVersion, availableVersions, hasUpgradePath) {
+	if (availableVersions.length === 0) return;
+	const sorted = [...availableVersions].sort((a, b) => a - b);
+	const latestVersion = sorted[sorted.length - 1];
+	if (documentVersion > latestVersion) return {
+		kind: "unsupported",
+		documentVersion,
+		availableVersions: sorted
+	};
+	if (documentVersion === latestVersion) return {
+		kind: "current",
+		documentVersion
+	};
+	return {
+		kind: "upgrade-available",
+		documentVersion,
+		latestVersion,
+		canUpgrade: hasUpgradePath(documentVersion, latestVersion)
+	};
+}
+/**
+* Compares the given document's model version against the versions available
+* from installed Vetra packages. Returns undefined while packages load or
+* when the document type has no installed modules.
+*/
+function useDocumentVersionStatus(document) {
+	const modules = useDocumentModelModules();
+	const registry = useModelRegistry();
+	if (!document || !modules) return;
+	const documentType = document.header.documentType;
+	return getDocumentVersionStatus(document.state.document.version || 1, modules.filter((m) => m.documentModel.global.id === documentType).map((m) => m.version ?? 1), (fromVersion, toVersion) => {
+		if (!registry) return false;
+		try {
+			registry.computeUpgradePath(documentType, fromVersion, toVersion);
+			return true;
+		} catch {
+			return false;
+		}
+	});
+}
 const validateDocument = (document) => {
 	const errors = [];
 	if (document.header.documentType !== "powerhouse/document-model") return errors;
@@ -3977,6 +4102,6 @@ function createDebouncedRefreshReactorDataClient(debounceDelayMs = DEFAULT_DEBOU
 createDebouncedRefreshReactorData();
 createDebouncedRefreshReactorDataClient();
 //#endregion
-export { useDragNode as A, isFileNodeKind as C, showDeleteNodeModal as D, setSelectedNode as E, e$1 as F, e$4 as I, t$2 as L, usePHToast as M, useSelectedDriveId as N, showRevisionHistory as O, useSelectedDriveSafe as P, t$5 as R, addFolder$1 as S, setSelectedDrive as T, useSetPHAppConfig as _, useEditorModules as a, useUserPermissions as b, useNodeActions as c, useNodesInSelectedDriveOrFolder as d, useParentFolderForSelectedNode as f, useSelectedNodePath as g, useSelectedFolder as h, useDownloadDocument as i, useDropNode as j, useDisabledEditors as k, useNodeById as l, useSelectedDocumentSafe as m, preloadEditorModule as n, useEditorModulesForDocumentType as o, useSelectedDocumentOfType as p, useAllowedDocumentModelModules as r, useGetSwitchboardLink as s, getSyncStatusSync as t, useNodeParentFolderById as u, useSetPHDocumentEditorConfig as v, isFolderNodeKind as w, addDocument as x, useTheme as y, useDocumentById as z };
+export { showRevisionHistory as A, t$2 as B, addFolder$1 as C, setSelectedNode as D, setSelectedDrive as E, useSelectedDriveId as F, useDocumentById as H, useSelectedDriveSafe as I, useStudioMode as L, useDragNode as M, useDropNode as N, showDeleteNodeModal as O, usePHToast as P, e$1 as R, addDocument as S, isFolderNodeKind as T, t$5 as V, useSelectedNodePath as _, useDownloadDocument as a, useTheme as b, useGetSwitchboardLink as c, useNodeParentFolderById as d, useNodesInSelectedDriveOrFolder as f, useSelectedFolder as g, useSelectedDocumentSafe as h, useDocumentVersionStatus as i, useDisabledEditors as j, showPHModal as k, useNodeActions as l, useSelectedDocumentOfType as m, preloadEditorModule as n, useEditorModules as o, useParentFolderForSelectedNode as p, useAllowedDocumentModelModules as r, useEditorModulesForDocumentType as s, getSyncStatusSync as t, useNodeById as u, useSetPHAppConfig as v, isFileNodeKind as w, useUserPermissions as x, useSetPHDocumentEditorConfig as y, e$4 as z };
 
-//# sourceMappingURL=dist-CUHBOv3P.mjs.map
+//# sourceMappingURL=dist-CS8QwZwZ.mjs.map