@open-mercato/documents 0.6.8-develop.7016.1.4ed7b1e49d

package/dist/modules/documents/backend/documents/components/usePrincipalPicker.js

@@ -0,0 +1,221 @@
+"use client";
+import * as React from "react";
+import { apiCall } from "@open-mercato/ui/backend/utils/apiCall";
+import {
+  buildPrincipalUrl,
+  mergePrincipalOptions,
+  PRINCIPAL_DEBOUNCE_MS,
+  PRINCIPAL_SEARCH_MIN_LENGTH,
+  readPrincipalPage
+} from "./principalPickerModel.js";
+const OPTIONAL_HEADERS = { "x-om-forbidden-redirect": "0", "x-om-unauthorized-redirect": "0" };
+function buildResultContext(documentId, principalType, query) {
+  return JSON.stringify([documentId, principalType, query.trim()]);
+}
+function usePrincipalPicker({ documentId, principalType, value, onChange, disabled, fallbackLabel }) {
+  const request = React.useRef(0);
+  const activeRequest = React.useRef(null);
+  const activeContext = React.useRef("");
+  const resultContext = React.useRef(null);
+  const onChangeRef = React.useRef(onChange);
+  React.useEffect(() => {
+    onChangeRef.current = onChange;
+  }, [onChange]);
+  const [searchValue, setSearchValue] = React.useState("");
+  const [selectedLabel, setSelectedLabel] = React.useState(null);
+  const [items, setItems] = React.useState([]);
+  const [open, setOpenState] = React.useState(false);
+  const [loading, setLoading] = React.useState(false);
+  const [loadingMore, setLoadingMore] = React.useState(false);
+  const [fetchError, setFetchError] = React.useState(false);
+  const [hasFetched, setHasFetched] = React.useState(false);
+  const [page, setPage] = React.useState(1);
+  const [total, setTotal] = React.useState(0);
+  const [totalPages, setTotalPages] = React.useState(1);
+  const [activeIndex, setActiveIndex] = React.useState(-1);
+  const currentContext = buildResultContext(documentId, principalType, searchValue);
+  activeContext.current = currentContext;
+  const invalidateResults = React.useCallback(() => {
+    request.current += 1;
+    activeRequest.current?.abort();
+    activeRequest.current = null;
+    resultContext.current = null;
+    setItems([]);
+    setLoading(false);
+    setLoadingMore(false);
+    setHasFetched(false);
+    setPage(1);
+    setTotal(0);
+    setTotalPages(1);
+    setActiveIndex(-1);
+  }, []);
+  React.useEffect(() => {
+    if (!disabled) return;
+    invalidateResults();
+    setOpenState(false);
+    setFetchError(false);
+  }, [disabled, invalidateResults]);
+  const reset = React.useCallback((notify) => {
+    invalidateResults();
+    setSearchValue("");
+    setSelectedLabel(null);
+    setOpenState(false);
+    setFetchError(false);
+    if (notify) onChangeRef.current(null, null);
+  }, [invalidateResults]);
+  React.useEffect(() => {
+    reset(false);
+  }, [documentId, principalType, reset]);
+  React.useEffect(() => {
+    if (!value) reset(false);
+  }, [reset, value]);
+  const enterError = React.useCallback(() => {
+    invalidateResults();
+    setFetchError(true);
+    setOpenState(false);
+  }, [invalidateResults]);
+  const fetchPage = React.useCallback(async (query, nextPage, append) => {
+    const requestId = ++request.current;
+    const requestContext = buildResultContext(documentId, principalType, query);
+    const controller = new AbortController();
+    activeRequest.current?.abort();
+    activeRequest.current = controller;
+    if (append) setLoadingMore(true);
+    else {
+      resultContext.current = null;
+      setItems([]);
+      setLoading(true);
+      setHasFetched(false);
+      setActiveIndex(-1);
+    }
+    setFetchError(false);
+    try {
+      const call = await apiCall(
+        buildPrincipalUrl(documentId, principalType, query, nextPage),
+        { headers: OPTIONAL_HEADERS, signal: controller.signal },
+        { fallback: { items: [], total: 0, totalPages: 1 } }
+      );
+      if (request.current !== requestId || activeContext.current !== requestContext) return;
+      if (!call.ok) {
+        enterError();
+        return;
+      }
+      const result = readPrincipalPage(call.result, principalType, nextPage, fallbackLabel);
+      resultContext.current = requestContext;
+      setItems((current) => append ? mergePrincipalOptions(current, result.items) : result.items);
+      setPage(nextPage);
+      setTotal(result.total);
+      setTotalPages(result.totalPages);
+      setFetchError(false);
+      setHasFetched(true);
+      setOpenState(true);
+      if (!append) setActiveIndex(result.items.length ? 0 : -1);
+      else if (result.items.length) setActiveIndex((current) => current < 0 ? 0 : current);
+    } catch {
+      if (!controller.signal.aborted && request.current === requestId && activeContext.current === requestContext) enterError();
+    } finally {
+      if (request.current === requestId) {
+        if (activeRequest.current === controller) activeRequest.current = null;
+        append ? setLoadingMore(false) : setLoading(false);
+      }
+    }
+  }, [documentId, enterError, fallbackLabel, principalType]);
+  React.useEffect(() => {
+    if (disabled || fetchError || !open || selectedLabel) return;
+    const query = searchValue.trim();
+    if (query.length > 0 && query.length < PRINCIPAL_SEARCH_MIN_LENGTH) return;
+    const timer = window.setTimeout(() => {
+      void fetchPage(query, 1, false);
+    }, PRINCIPAL_DEBOUNCE_MS);
+    return () => window.clearTimeout(timer);
+  }, [disabled, fetchError, fetchPage, open, searchValue, selectedLabel]);
+  const selectOption = React.useCallback((option) => {
+    if (disabled || resultContext.current === null || resultContext.current !== activeContext.current) return;
+    invalidateResults();
+    setSelectedLabel(option.label);
+    setSearchValue("");
+    setOpenState(false);
+    setFetchError(false);
+    onChangeRef.current(option.id, option.label);
+  }, [disabled, invalidateResults]);
+  const changeSearch = React.useCallback((next) => {
+    if (selectedLabel || value) onChangeRef.current(null, null);
+    activeContext.current = buildResultContext(documentId, principalType, next);
+    invalidateResults();
+    setSelectedLabel(null);
+    setSearchValue(next);
+    setFetchError(false);
+    setOpenState(true);
+  }, [documentId, invalidateResults, principalType, selectedLabel, value]);
+  const setOpen = React.useCallback((nextOpen) => {
+    if (disabled && nextOpen) return;
+    if (!nextOpen) invalidateResults();
+    setOpenState(nextOpen);
+  }, [disabled, invalidateResults]);
+  const loadMore = React.useCallback(() => {
+    if (!disabled && resultContext.current === activeContext.current && !loading && !loadingMore && page < totalPages) {
+      void fetchPage(searchValue.trim(), page + 1, true);
+    }
+  }, [disabled, fetchPage, loading, loadingMore, page, searchValue, totalPages]);
+  const retry = React.useCallback(() => {
+    setFetchError(false);
+    setOpenState(false);
+    void fetchPage(searchValue.trim(), 1, false);
+  }, [fetchPage, searchValue]);
+  const hasCurrentResult = resultContext.current !== null && resultContext.current === currentContext;
+  const visibleItems = hasCurrentResult ? items : [];
+  const handleKeyDown = React.useCallback((event) => {
+    if ((event.metaKey || event.ctrlKey) && event.key === "Enter") return;
+    if (event.key === "Escape" && open) {
+      event.preventDefault();
+      event.stopPropagation();
+      setOpen(false);
+      return;
+    }
+    if (!open || !visibleItems.length) return;
+    if (event.key === "ArrowDown") {
+      event.preventDefault();
+      setActiveIndex((index) => Math.min(index + 1, visibleItems.length - 1));
+      return;
+    }
+    if (event.key === "ArrowUp") {
+      event.preventDefault();
+      setActiveIndex((index) => Math.max(index - 1, 0));
+      return;
+    }
+    if (event.key === "Enter" && visibleItems[activeIndex]) {
+      event.preventDefault();
+      selectOption(visibleItems[activeIndex]);
+    }
+  }, [activeIndex, open, selectOption, setOpen, visibleItems]);
+  React.useEffect(() => () => {
+    activeRequest.current?.abort();
+  }, []);
+  return {
+    searchValue,
+    selectedLabel,
+    items: visibleItems,
+    open,
+    setOpen,
+    loading,
+    loadingMore,
+    fetchError,
+    hasFetched: hasCurrentResult && hasFetched,
+    page,
+    total,
+    totalPages,
+    activeIndex: hasCurrentResult ? activeIndex : -1,
+    setActiveIndex,
+    displayValue: selectedLabel ?? searchValue,
+    changeSearch,
+    clear: () => reset(true),
+    selectOption,
+    loadMore,
+    retry,
+    handleKeyDown
+  };
+}
+export {
+  usePrincipalPicker
+};
+//# sourceMappingURL=usePrincipalPicker.js.map

package/dist/modules/documents/backend/documents/components/usePrincipalPicker.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../../src/modules/documents/backend/documents/components/usePrincipalPicker.ts"],
+  "sourcesContent": ["\"use client\"\n\nimport * as React from 'react'\nimport { apiCall } from '@open-mercato/ui/backend/utils/apiCall'\nimport {\n  buildPrincipalUrl,\n  mergePrincipalOptions,\n  PRINCIPAL_DEBOUNCE_MS,\n  PRINCIPAL_SEARCH_MIN_LENGTH,\n  readPrincipalPage,\n  type PrincipalListPayload,\n  type PrincipalOption,\n  type PrincipalType,\n} from './principalPickerModel'\n\nconst OPTIONAL_HEADERS = { 'x-om-forbidden-redirect': '0', 'x-om-unauthorized-redirect': '0' }\n\nfunction buildResultContext(documentId: string, principalType: PrincipalType, query: string): string {\n  return JSON.stringify([documentId, principalType, query.trim()])\n}\n\nexport function usePrincipalPicker({ documentId, principalType, value, onChange, disabled, fallbackLabel }: {\n  documentId: string\n  principalType: PrincipalType\n  value: string | null\n  onChange: (id: string | null, label: string | null) => void\n  disabled: boolean\n  fallbackLabel: string\n}) {\n  const request = React.useRef(0)\n  const activeRequest = React.useRef<AbortController | null>(null)\n  const activeContext = React.useRef('')\n  const resultContext = React.useRef<string | null>(null)\n  const onChangeRef = React.useRef(onChange)\n  React.useEffect(() => { onChangeRef.current = onChange }, [onChange])\n  const [searchValue, setSearchValue] = React.useState('')\n  const [selectedLabel, setSelectedLabel] = React.useState<string | null>(null)\n  const [items, setItems] = React.useState<PrincipalOption[]>([])\n  const [open, setOpenState] = React.useState(false)\n  const [loading, setLoading] = React.useState(false)\n  const [loadingMore, setLoadingMore] = React.useState(false)\n  const [fetchError, setFetchError] = React.useState(false)\n  const [hasFetched, setHasFetched] = React.useState(false)\n  const [page, setPage] = React.useState(1)\n  const [total, setTotal] = React.useState(0)\n  const [totalPages, setTotalPages] = React.useState(1)\n  const [activeIndex, setActiveIndex] = React.useState(-1)\n  const currentContext = buildResultContext(documentId, principalType, searchValue)\n  activeContext.current = currentContext\n\n  const invalidateResults = React.useCallback(() => {\n    request.current += 1\n    activeRequest.current?.abort()\n    activeRequest.current = null\n    resultContext.current = null\n    setItems([]); setLoading(false); setLoadingMore(false); setHasFetched(false)\n    setPage(1); setTotal(0); setTotalPages(1); setActiveIndex(-1)\n  }, [])\n\n  React.useEffect(() => {\n    if (!disabled) return\n    invalidateResults()\n    setOpenState(false)\n    setFetchError(false)\n  }, [disabled, invalidateResults])\n\n  const reset = React.useCallback((notify: boolean) => {\n    invalidateResults()\n    setSearchValue(''); setSelectedLabel(null); setOpenState(false); setFetchError(false)\n    if (notify) onChangeRef.current(null, null)\n  }, [invalidateResults])\n  React.useEffect(() => { reset(false) }, [documentId, principalType, reset])\n  React.useEffect(() => { if (!value) reset(false) }, [reset, value])\n\n  const enterError = React.useCallback(() => {\n    invalidateResults()\n    setFetchError(true); setOpenState(false)\n  }, [invalidateResults])\n\n  const fetchPage = React.useCallback(async (query: string, nextPage: number, append: boolean) => {\n    const requestId = ++request.current\n    const requestContext = buildResultContext(documentId, principalType, query)\n    const controller = new AbortController()\n    activeRequest.current?.abort()\n    activeRequest.current = controller\n    if (append) setLoadingMore(true)\n    else { resultContext.current = null; setItems([]); setLoading(true); setHasFetched(false); setActiveIndex(-1) }\n    setFetchError(false)\n    try {\n      const call = await apiCall<PrincipalListPayload>(\n        buildPrincipalUrl(documentId, principalType, query, nextPage),\n        { headers: OPTIONAL_HEADERS, signal: controller.signal },\n        { fallback: { items: [], total: 0, totalPages: 1 } },\n      )\n      if (request.current !== requestId || activeContext.current !== requestContext) return\n      if (!call.ok) { enterError(); return }\n      const result = readPrincipalPage(call.result, principalType, nextPage, fallbackLabel)\n      resultContext.current = requestContext\n      setItems((current) => append ? mergePrincipalOptions(current, result.items) : result.items)\n      setPage(nextPage); setTotal(result.total); setTotalPages(result.totalPages)\n      setFetchError(false); setHasFetched(true); setOpenState(true)\n      if (!append) setActiveIndex(result.items.length ? 0 : -1)\n      else if (result.items.length) setActiveIndex((current) => current < 0 ? 0 : current)\n    } catch {\n      if (!controller.signal.aborted && request.current === requestId && activeContext.current === requestContext) enterError()\n    } finally {\n      if (request.current === requestId) {\n        if (activeRequest.current === controller) activeRequest.current = null\n        append ? setLoadingMore(false) : setLoading(false)\n      }\n    }\n  }, [documentId, enterError, fallbackLabel, principalType])\n\n  React.useEffect(() => {\n    if (disabled || fetchError || !open || selectedLabel) return\n    const query = searchValue.trim()\n    if (query.length > 0 && query.length < PRINCIPAL_SEARCH_MIN_LENGTH) return\n    const timer = window.setTimeout(() => { void fetchPage(query, 1, false) }, PRINCIPAL_DEBOUNCE_MS)\n    return () => window.clearTimeout(timer)\n  }, [disabled, fetchError, fetchPage, open, searchValue, selectedLabel])\n\n  const selectOption = React.useCallback((option: PrincipalOption) => {\n    if (disabled || resultContext.current === null || resultContext.current !== activeContext.current) return\n    invalidateResults()\n    setSelectedLabel(option.label); setSearchValue(''); setOpenState(false); setFetchError(false)\n    onChangeRef.current(option.id, option.label)\n  }, [disabled, invalidateResults])\n  const changeSearch = React.useCallback((next: string) => {\n    if (selectedLabel || value) onChangeRef.current(null, null)\n    activeContext.current = buildResultContext(documentId, principalType, next)\n    invalidateResults()\n    setSelectedLabel(null); setSearchValue(next); setFetchError(false); setOpenState(true)\n  }, [documentId, invalidateResults, principalType, selectedLabel, value])\n  const setOpen = React.useCallback((nextOpen: boolean) => {\n    if (disabled && nextOpen) return\n    if (!nextOpen) invalidateResults()\n    setOpenState(nextOpen)\n  }, [disabled, invalidateResults])\n  const loadMore = React.useCallback(() => {\n    if (!disabled && resultContext.current === activeContext.current && !loading && !loadingMore && page < totalPages) {\n      void fetchPage(searchValue.trim(), page + 1, true)\n    }\n  }, [disabled, fetchPage, loading, loadingMore, page, searchValue, totalPages])\n  const retry = React.useCallback(() => { setFetchError(false); setOpenState(false); void fetchPage(searchValue.trim(), 1, false) }, [fetchPage, searchValue])\n  const hasCurrentResult = resultContext.current !== null && resultContext.current === currentContext\n  const visibleItems = hasCurrentResult ? items : []\n  const handleKeyDown = React.useCallback((event: React.KeyboardEvent<HTMLDivElement>) => {\n    if ((event.metaKey || event.ctrlKey) && event.key === 'Enter') return\n    if (event.key === 'Escape' && open) { event.preventDefault(); event.stopPropagation(); setOpen(false); return }\n    if (!open || !visibleItems.length) return\n    if (event.key === 'ArrowDown') { event.preventDefault(); setActiveIndex((index) => Math.min(index + 1, visibleItems.length - 1)); return }\n    if (event.key === 'ArrowUp') { event.preventDefault(); setActiveIndex((index) => Math.max(index - 1, 0)); return }\n    if (event.key === 'Enter' && visibleItems[activeIndex]) { event.preventDefault(); selectOption(visibleItems[activeIndex]) }\n  }, [activeIndex, open, selectOption, setOpen, visibleItems])\n\n  React.useEffect(() => () => { activeRequest.current?.abort() }, [])\n\n  return {\n    searchValue, selectedLabel, items: visibleItems, open, setOpen, loading, loadingMore, fetchError,\n    hasFetched: hasCurrentResult && hasFetched, page, total, totalPages,\n    activeIndex: hasCurrentResult ? activeIndex : -1, setActiveIndex,\n    displayValue: selectedLabel ?? searchValue, changeSearch, clear: () => reset(true),\n    selectOption, loadMore, retry, handleKeyDown,\n  }\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/modules/documents/backend/documents/components/useShareDialog.js

@@ -0,0 +1,236 @@
+"use client";
+import * as React from "react";
+import { useT } from "@open-mercato/shared/lib/i18n/context";
+import { surfaceRecordConflict } from "@open-mercato/ui/backend/conflicts";
+import { flash } from "@open-mercato/ui/backend/FlashMessages";
+import { useGuardedMutation } from "@open-mercato/ui/backend/injection/useGuardedMutation";
+import { apiCall, apiCallOrThrow, withScopedApiRequestHeaders } from "@open-mercato/ui/backend/utils/apiCall";
+import { buildOptimisticLockHeader } from "@open-mercato/ui/backend/utils/optimisticLock";
+import {
+  readShareItems
+} from "./shareDialogModel.js";
+function useShareDialog({ documentId, open, canManage }) {
+  const t = useT();
+  const [shares, setShares] = React.useState([]);
+  const [isLoading, setIsLoading] = React.useState(false);
+  const [error, setError] = React.useState(null);
+  const [principalType, setPrincipalType] = React.useState("user");
+  const [principalId, setPrincipalId] = React.useState("");
+  const [permission, setPermission] = React.useState("viewer");
+  const [isSubmitting, setIsSubmitting] = React.useState(false);
+  const [pendingShareIds, setPendingShareIds] = React.useState(() => /* @__PURE__ */ new Set());
+  const submitInFlight = React.useRef(false);
+  const shareMutationsInFlight = React.useRef(/* @__PURE__ */ new Set());
+  const loadSequence = React.useRef(0);
+  const activeLoad = React.useRef(null);
+  const activeDialogContext = React.useRef({ documentId, open, generation: 0 });
+  if (activeDialogContext.current.documentId !== documentId || activeDialogContext.current.open !== open) {
+    activeDialogContext.current = {
+      documentId,
+      open,
+      generation: activeDialogContext.current.generation + 1
+    };
+  }
+  const dialogContextGeneration = activeDialogContext.current.generation;
+  const isActiveDialogContext = React.useCallback(() => activeDialogContext.current.generation === dialogContextGeneration && activeDialogContext.current.open, [dialogContextGeneration]);
+  const mutationContextId = `documents-share-dialog:${documentId}`;
+  const { runMutation, retryLastMutation } = useGuardedMutation({
+    contextId: mutationContextId,
+    blockedMessage: t("ui.forms.flash.saveBlocked")
+  });
+  const mutationContext = React.useCallback((resourceKind, resourceId) => ({
+    formId: mutationContextId,
+    resourceKind,
+    resourceId,
+    retryLastMutation
+  }), [mutationContextId, retryLastMutation]);
+  const loadShares = React.useCallback(async () => {
+    if (!isActiveDialogContext()) return;
+    const loadId = ++loadSequence.current;
+    const controller = new AbortController();
+    activeLoad.current?.abort();
+    activeLoad.current = controller;
+    const isCurrent = () => isActiveDialogContext() && loadSequence.current === loadId && !controller.signal.aborted;
+    setIsLoading(true);
+    setError(null);
+    const fallback = { items: [] };
+    try {
+      const call = await apiCall(
+        `/api/documents/${encodeURIComponent(documentId)}/shares`,
+        { signal: controller.signal },
+        { fallback }
+      );
+      if (!isCurrent()) return;
+      if (!call.ok) {
+        setError(t("documents.share.dialog.error.load"));
+        return;
+      }
+      setShares(readShareItems(call.result ?? fallback, t("documents.share.removedPrincipal")));
+    } catch (caught) {
+      if (isCurrent()) {
+        setError(caught instanceof Error ? caught.message : t("documents.share.dialog.error.load"));
+      }
+    } finally {
+      if (activeLoad.current === controller) activeLoad.current = null;
+      if (isCurrent()) setIsLoading(false);
+    }
+  }, [documentId, isActiveDialogContext, t]);
+  React.useEffect(() => {
+    if (!open) {
+      loadSequence.current += 1;
+      activeLoad.current?.abort();
+      activeLoad.current = null;
+      setIsLoading(false);
+      return;
+    }
+    void loadShares();
+    return () => {
+      loadSequence.current += 1;
+      activeLoad.current?.abort();
+      activeLoad.current = null;
+    };
+  }, [loadShares, open]);
+  const beginShareMutation = React.useCallback((shareId) => {
+    if (shareMutationsInFlight.current.has(shareId)) return false;
+    shareMutationsInFlight.current.add(shareId);
+    setPendingShareIds((current) => new Set(current).add(shareId));
+    return true;
+  }, []);
+  const finishShareMutation = React.useCallback((shareId) => {
+    shareMutationsInFlight.current.delete(shareId);
+    setPendingShareIds((current) => {
+      if (!current.has(shareId)) return current;
+      const next = new Set(current);
+      next.delete(shareId);
+      return next;
+    });
+  }, []);
+  const addShare = React.useCallback(async () => {
+    const trimmedPrincipal = principalId.trim();
+    if (!trimmedPrincipal || !canManage || submitInFlight.current || !isActiveDialogContext()) return;
+    submitInFlight.current = true;
+    setIsSubmitting(true);
+    try {
+      await runMutation({
+        operation: async () => {
+          await apiCallOrThrow(
+            `/api/documents/${encodeURIComponent(documentId)}/shares`,
+            {
+              method: "POST",
+              headers: { "content-type": "application/json" },
+              body: JSON.stringify({ principalType, principalId: trimmedPrincipal, permission })
+            },
+            { errorMessage: t("documents.share.dialog.error.add") }
+          );
+        },
+        context: mutationContext("documents.document_share", documentId),
+        mutationPayload: { principalType, principalId: trimmedPrincipal, permission }
+      });
+      if (!isActiveDialogContext()) return;
+      setPrincipalId("");
+      setPermission("viewer");
+      await loadShares();
+      if (!isActiveDialogContext()) return;
+      flash(t("documents.share.dialog.success.add"), "success");
+    } catch (caught) {
+      if (!isActiveDialogContext()) return;
+      flash(caught instanceof Error ? caught.message : t("documents.share.dialog.error.add"), "error");
+    } finally {
+      submitInFlight.current = false;
+      setIsSubmitting(false);
+    }
+  }, [canManage, documentId, isActiveDialogContext, loadShares, mutationContext, permission, principalId, principalType, runMutation, t]);
+  const changePermission = React.useCallback(async (share, nextPermission) => {
+    if (!canManage || share.permission === nextPermission || !isActiveDialogContext() || !beginShareMutation(share.id)) return;
+    try {
+      await runMutation({
+        operation: () => withScopedApiRequestHeaders(
+          buildOptimisticLockHeader(share.updatedAt),
+          () => apiCallOrThrow(
+            `/api/documents/${encodeURIComponent(documentId)}/shares`,
+            {
+              method: "PUT",
+              headers: { "content-type": "application/json" },
+              body: JSON.stringify({ id: share.id, permission: nextPermission })
+            },
+            { errorMessage: t("documents.share.dialog.error.update") }
+          )
+        ),
+        context: mutationContext("documents.document_share", share.id),
+        mutationPayload: { id: share.id, permission: nextPermission }
+      });
+      if (!isActiveDialogContext()) return;
+      setShares((current) => current.map((row) => row.id === share.id ? { ...row, permission: nextPermission } : row));
+      await loadShares();
+      if (!isActiveDialogContext()) return;
+      flash(t("documents.share.dialog.success.update"), "success");
+    } catch (caught) {
+      if (!isActiveDialogContext()) return;
+      if (!surfaceRecordConflict(caught, t, { onRefresh: () => {
+        void loadShares();
+      } })) {
+        flash(caught instanceof Error ? caught.message : t("documents.share.dialog.error.update"), "error");
+      }
+    } finally {
+      finishShareMutation(share.id);
+    }
+  }, [beginShareMutation, canManage, documentId, finishShareMutation, isActiveDialogContext, loadShares, mutationContext, runMutation, t]);
+  const removeShare = React.useCallback(async (share) => {
+    if (!canManage || !isActiveDialogContext() || !beginShareMutation(share.id)) return;
+    try {
+      await runMutation({
+        operation: () => withScopedApiRequestHeaders(
+          buildOptimisticLockHeader(share.updatedAt),
+          () => apiCallOrThrow(
+            `/api/documents/${encodeURIComponent(documentId)}/shares`,
+            {
+              method: "DELETE",
+              headers: { "content-type": "application/json" },
+              body: JSON.stringify({ id: share.id })
+            },
+            { errorMessage: t("documents.share.dialog.error.remove") }
+          )
+        ),
+        context: mutationContext("documents.document_share", share.id),
+        mutationPayload: { id: share.id }
+      });
+      if (!isActiveDialogContext()) return;
+      setShares((current) => current.filter((row) => row.id !== share.id));
+      flash(t("documents.share.dialog.success.remove"), "success");
+    } catch (caught) {
+      if (!isActiveDialogContext()) return;
+      if (!surfaceRecordConflict(caught, t, { onRefresh: () => {
+        void loadShares();
+      } })) {
+        flash(caught instanceof Error ? caught.message : t("documents.share.dialog.error.remove"), "error");
+      }
+    } finally {
+      finishShareMutation(share.id);
+    }
+  }, [beginShareMutation, canManage, documentId, finishShareMutation, isActiveDialogContext, loadShares, mutationContext, runMutation, t]);
+  const changePrincipalType = React.useCallback((nextType) => {
+    setPrincipalType(nextType);
+    setPrincipalId("");
+  }, []);
+  return {
+    shares,
+    isLoading,
+    error,
+    principalType,
+    principalId,
+    permission,
+    isSubmitting,
+    pendingShareIds,
+    setPrincipalId,
+    setPermission,
+    changePrincipalType,
+    addShare,
+    reload: loadShares,
+    changePermission,
+    removeShare
+  };
+}
+export {
+  useShareDialog
+};
+//# sourceMappingURL=useShareDialog.js.map

package/dist/modules/documents/backend/documents/components/useShareDialog.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../../src/modules/documents/backend/documents/components/useShareDialog.ts"],
+  "sourcesContent": ["\"use client\"\n\nimport * as React from 'react'\nimport { useT } from '@open-mercato/shared/lib/i18n/context'\nimport { surfaceRecordConflict } from '@open-mercato/ui/backend/conflicts'\nimport { flash } from '@open-mercato/ui/backend/FlashMessages'\nimport { useGuardedMutation } from '@open-mercato/ui/backend/injection/useGuardedMutation'\nimport { apiCall, apiCallOrThrow, withScopedApiRequestHeaders } from '@open-mercato/ui/backend/utils/apiCall'\nimport { buildOptimisticLockHeader } from '@open-mercato/ui/backend/utils/optimisticLock'\nimport {\n  readShareItems,\n  type DocumentSharePermission,\n  type DocumentSharePrincipalType,\n  type ShareRow,\n  type SharesResponse,\n} from './shareDialogModel'\n\ntype UseShareDialogInput = {\n  documentId: string\n  open: boolean\n  canManage: boolean\n}\n\ntype ShareMutationContext = {\n  formId: string\n  resourceKind: string\n  resourceId: string\n  retryLastMutation: () => Promise<boolean>\n}\n\nexport function useShareDialog({ documentId, open, canManage }: UseShareDialogInput) {\n  const t = useT()\n  const [shares, setShares] = React.useState<ShareRow[]>([])\n  const [isLoading, setIsLoading] = React.useState(false)\n  const [error, setError] = React.useState<string | null>(null)\n  const [principalType, setPrincipalType] = React.useState<DocumentSharePrincipalType>('user')\n  const [principalId, setPrincipalId] = React.useState('')\n  const [permission, setPermission] = React.useState<DocumentSharePermission>('viewer')\n  const [isSubmitting, setIsSubmitting] = React.useState(false)\n  const [pendingShareIds, setPendingShareIds] = React.useState<ReadonlySet<string>>(() => new Set())\n  const submitInFlight = React.useRef(false)\n  const shareMutationsInFlight = React.useRef(new Set<string>())\n  const loadSequence = React.useRef(0)\n  const activeLoad = React.useRef<AbortController | null>(null)\n  const activeDialogContext = React.useRef({ documentId, open, generation: 0 })\n  if (activeDialogContext.current.documentId !== documentId || activeDialogContext.current.open !== open) {\n    activeDialogContext.current = {\n      documentId,\n      open,\n      generation: activeDialogContext.current.generation + 1,\n    }\n  }\n  const dialogContextGeneration = activeDialogContext.current.generation\n  const isActiveDialogContext = React.useCallback(() => (\n    activeDialogContext.current.generation === dialogContextGeneration\n      && activeDialogContext.current.open\n  ), [dialogContextGeneration])\n  const mutationContextId = `documents-share-dialog:${documentId}`\n  const { runMutation, retryLastMutation } = useGuardedMutation<ShareMutationContext>({\n    contextId: mutationContextId,\n    blockedMessage: t('ui.forms.flash.saveBlocked'),\n  })\n\n  const mutationContext = React.useCallback((resourceKind: string, resourceId: string) => ({\n    formId: mutationContextId,\n    resourceKind,\n    resourceId,\n    retryLastMutation,\n  }), [mutationContextId, retryLastMutation])\n\n  const loadShares = React.useCallback(async () => {\n    if (!isActiveDialogContext()) return\n    const loadId = ++loadSequence.current\n    const controller = new AbortController()\n    activeLoad.current?.abort()\n    activeLoad.current = controller\n    const isCurrent = () => isActiveDialogContext()\n      && loadSequence.current === loadId\n      && !controller.signal.aborted\n    setIsLoading(true)\n    setError(null)\n    const fallback: SharesResponse = { items: [] }\n    try {\n      const call = await apiCall<SharesResponse>(\n        `/api/documents/${encodeURIComponent(documentId)}/shares`,\n        { signal: controller.signal },\n        { fallback },\n      )\n      if (!isCurrent()) return\n      if (!call.ok) {\n        setError(t('documents.share.dialog.error.load'))\n        return\n      }\n      setShares(readShareItems(call.result ?? fallback, t('documents.share.removedPrincipal')))\n    } catch (caught) {\n      if (isCurrent()) {\n        setError(caught instanceof Error ? caught.message : t('documents.share.dialog.error.load'))\n      }\n    } finally {\n      if (activeLoad.current === controller) activeLoad.current = null\n      if (isCurrent()) setIsLoading(false)\n    }\n  }, [documentId, isActiveDialogContext, t])\n\n  React.useEffect(() => {\n    if (!open) {\n      loadSequence.current += 1\n      activeLoad.current?.abort()\n      activeLoad.current = null\n      setIsLoading(false)\n      return\n    }\n    void loadShares()\n    return () => {\n      loadSequence.current += 1\n      activeLoad.current?.abort()\n      activeLoad.current = null\n    }\n  }, [loadShares, open])\n\n  const beginShareMutation = React.useCallback((shareId: string) => {\n    if (shareMutationsInFlight.current.has(shareId)) return false\n    shareMutationsInFlight.current.add(shareId)\n    setPendingShareIds((current) => new Set(current).add(shareId))\n    return true\n  }, [])\n\n  const finishShareMutation = React.useCallback((shareId: string) => {\n    shareMutationsInFlight.current.delete(shareId)\n    setPendingShareIds((current) => {\n      if (!current.has(shareId)) return current\n      const next = new Set(current)\n      next.delete(shareId)\n      return next\n    })\n  }, [])\n\n  const addShare = React.useCallback(async () => {\n    const trimmedPrincipal = principalId.trim()\n    if (!trimmedPrincipal || !canManage || submitInFlight.current || !isActiveDialogContext()) return\n    submitInFlight.current = true\n    setIsSubmitting(true)\n    try {\n      await runMutation({\n        operation: async () => {\n          await apiCallOrThrow(\n            `/api/documents/${encodeURIComponent(documentId)}/shares`,\n            {\n              method: 'POST',\n              headers: { 'content-type': 'application/json' },\n              body: JSON.stringify({ principalType, principalId: trimmedPrincipal, permission }),\n            },\n            { errorMessage: t('documents.share.dialog.error.add') },\n          )\n        },\n        context: mutationContext('documents.document_share', documentId),\n        mutationPayload: { principalType, principalId: trimmedPrincipal, permission },\n      })\n      if (!isActiveDialogContext()) return\n      setPrincipalId('')\n      setPermission('viewer')\n      await loadShares()\n      if (!isActiveDialogContext()) return\n      flash(t('documents.share.dialog.success.add'), 'success')\n    } catch (caught) {\n      if (!isActiveDialogContext()) return\n      flash(caught instanceof Error ? caught.message : t('documents.share.dialog.error.add'), 'error')\n    } finally {\n      submitInFlight.current = false\n      setIsSubmitting(false)\n    }\n  }, [canManage, documentId, isActiveDialogContext, loadShares, mutationContext, permission, principalId, principalType, runMutation, t])\n\n  const changePermission = React.useCallback(async (\n    share: ShareRow,\n    nextPermission: DocumentSharePermission,\n  ) => {\n    if (!canManage || share.permission === nextPermission || !isActiveDialogContext() || !beginShareMutation(share.id)) return\n    try {\n      await runMutation({\n        operation: () => withScopedApiRequestHeaders(\n          buildOptimisticLockHeader(share.updatedAt),\n          () => apiCallOrThrow(\n            `/api/documents/${encodeURIComponent(documentId)}/shares`,\n            {\n              method: 'PUT',\n              headers: { 'content-type': 'application/json' },\n              body: JSON.stringify({ id: share.id, permission: nextPermission }),\n            },\n            { errorMessage: t('documents.share.dialog.error.update') },\n          ),\n        ),\n        context: mutationContext('documents.document_share', share.id),\n        mutationPayload: { id: share.id, permission: nextPermission },\n      })\n      if (!isActiveDialogContext()) return\n      setShares((current) => current.map((row) => (\n        row.id === share.id ? { ...row, permission: nextPermission } : row\n      )))\n      await loadShares()\n      if (!isActiveDialogContext()) return\n      flash(t('documents.share.dialog.success.update'), 'success')\n    } catch (caught) {\n      if (!isActiveDialogContext()) return\n      if (!surfaceRecordConflict(caught, t, { onRefresh: () => { void loadShares() } })) {\n        flash(caught instanceof Error ? caught.message : t('documents.share.dialog.error.update'), 'error')\n      }\n    } finally {\n      finishShareMutation(share.id)\n    }\n  }, [beginShareMutation, canManage, documentId, finishShareMutation, isActiveDialogContext, loadShares, mutationContext, runMutation, t])\n\n  const removeShare = React.useCallback(async (share: ShareRow) => {\n    if (!canManage || !isActiveDialogContext() || !beginShareMutation(share.id)) return\n    try {\n      await runMutation({\n        operation: () => withScopedApiRequestHeaders(\n          buildOptimisticLockHeader(share.updatedAt),\n          () => apiCallOrThrow(\n            `/api/documents/${encodeURIComponent(documentId)}/shares`,\n            {\n              method: 'DELETE',\n              headers: { 'content-type': 'application/json' },\n              body: JSON.stringify({ id: share.id }),\n            },\n            { errorMessage: t('documents.share.dialog.error.remove') },\n          ),\n        ),\n        context: mutationContext('documents.document_share', share.id),\n        mutationPayload: { id: share.id },\n      })\n      if (!isActiveDialogContext()) return\n      setShares((current) => current.filter((row) => row.id !== share.id))\n      flash(t('documents.share.dialog.success.remove'), 'success')\n    } catch (caught) {\n      if (!isActiveDialogContext()) return\n      if (!surfaceRecordConflict(caught, t, { onRefresh: () => { void loadShares() } })) {\n        flash(caught instanceof Error ? caught.message : t('documents.share.dialog.error.remove'), 'error')\n      }\n    } finally {\n      finishShareMutation(share.id)\n    }\n  }, [beginShareMutation, canManage, documentId, finishShareMutation, isActiveDialogContext, loadShares, mutationContext, runMutation, t])\n\n  const changePrincipalType = React.useCallback((nextType: DocumentSharePrincipalType) => {\n    setPrincipalType(nextType)\n    setPrincipalId('')\n  }, [])\n\n  return {\n    shares,\n    isLoading,\n    error,\n    principalType,\n    principalId,\n    permission,\n    isSubmitting,\n    pendingShareIds,\n    setPrincipalId,\n    setPermission,\n    changePrincipalType,\n    addShare,\n    reload: loadShares,\n    changePermission,\n    removeShare,\n  }\n}\n"],
+  "mappings": ";AAEA,YAAY,WAAW;AACvB,SAAS,YAAY;AACrB,SAAS,6BAA6B;AACtC,SAAS,aAAa;AACtB,SAAS,0BAA0B;AACnC,SAAS,SAAS,gBAAgB,mCAAmC;AACrE,SAAS,iCAAiC;AAC1C;AAAA,EACE;AAAA,OAKK;AAeA,SAAS,eAAe,EAAE,YAAY,MAAM,UAAU,GAAwB;AACnF,QAAM,IAAI,KAAK;AACf,QAAM,CAAC,QAAQ,SAAS,IAAI,MAAM,SAAqB,CAAC,CAAC;AACzD,QAAM,CAAC,WAAW,YAAY,IAAI,MAAM,SAAS,KAAK;AACtD,QAAM,CAAC,OAAO,QAAQ,IAAI,MAAM,SAAwB,IAAI;AAC5D,QAAM,CAAC,eAAe,gBAAgB,IAAI,MAAM,SAAqC,MAAM;AAC3F,QAAM,CAAC,aAAa,cAAc,IAAI,MAAM,SAAS,EAAE;AACvD,QAAM,CAAC,YAAY,aAAa,IAAI,MAAM,SAAkC,QAAQ;AACpF,QAAM,CAAC,cAAc,eAAe,IAAI,MAAM,SAAS,KAAK;AAC5D,QAAM,CAAC,iBAAiB,kBAAkB,IAAI,MAAM,SAA8B,MAAM,oBAAI,IAAI,CAAC;AACjG,QAAM,iBAAiB,MAAM,OAAO,KAAK;AACzC,QAAM,yBAAyB,MAAM,OAAO,oBAAI,IAAY,CAAC;AAC7D,QAAM,eAAe,MAAM,OAAO,CAAC;AACnC,QAAM,aAAa,MAAM,OAA+B,IAAI;AAC5D,QAAM,sBAAsB,MAAM,OAAO,EAAE,YAAY,MAAM,YAAY,EAAE,CAAC;AAC5E,MAAI,oBAAoB,QAAQ,eAAe,cAAc,oBAAoB,QAAQ,SAAS,MAAM;AACtG,wBAAoB,UAAU;AAAA,MAC5B;AAAA,MACA;AAAA,MACA,YAAY,oBAAoB,QAAQ,aAAa;AAAA,IACvD;AAAA,EACF;AACA,QAAM,0BAA0B,oBAAoB,QAAQ;AAC5D,QAAM,wBAAwB,MAAM,YAAY,MAC9C,oBAAoB,QAAQ,eAAe,2BACtC,oBAAoB,QAAQ,MAChC,CAAC,uBAAuB,CAAC;AAC5B,QAAM,oBAAoB,0BAA0B,UAAU;AAC9D,QAAM,EAAE,aAAa,kBAAkB,IAAI,mBAAyC;AAAA,IAClF,WAAW;AAAA,IACX,gBAAgB,EAAE,4BAA4B;AAAA,EAChD,CAAC;AAED,QAAM,kBAAkB,MAAM,YAAY,CAAC,cAAsB,gBAAwB;AAAA,IACvF,QAAQ;AAAA,IACR;AAAA,IACA;AAAA,IACA;AAAA,EACF,IAAI,CAAC,mBAAmB,iBAAiB,CAAC;AAE1C,QAAM,aAAa,MAAM,YAAY,YAAY;AAC/C,QAAI,CAAC,sBAAsB,EAAG;AAC9B,UAAM,SAAS,EAAE,aAAa;AAC9B,UAAM,aAAa,IAAI,gBAAgB;AACvC,eAAW,SAAS,MAAM;AAC1B,eAAW,UAAU;AACrB,UAAM,YAAY,MAAM,sBAAsB,KACzC,aAAa,YAAY,UACzB,CAAC,WAAW,OAAO;AACxB,iBAAa,IAAI;AACjB,aAAS,IAAI;AACb,UAAM,WAA2B,EAAE,OAAO,CAAC,EAAE;AAC7C,QAAI;AACF,YAAM,OAAO,MAAM;AAAA,QACjB,kBAAkB,mBAAmB,UAAU,CAAC;AAAA,QAChD,EAAE,QAAQ,WAAW,OAAO;AAAA,QAC5B,EAAE,SAAS;AAAA,MACb;AACA,UAAI,CAAC,UAAU,EAAG;AAClB,UAAI,CAAC,KAAK,IAAI;AACZ,iBAAS,EAAE,mCAAmC,CAAC;AAC/C;AAAA,MACF;AACA,gBAAU,eAAe,KAAK,UAAU,UAAU,EAAE,kCAAkC,CAAC,CAAC;AAAA,IAC1F,SAAS,QAAQ;AACf,UAAI,UAAU,GAAG;AACf,iBAAS,kBAAkB,QAAQ,OAAO,UAAU,EAAE,mCAAmC,CAAC;AAAA,MAC5F;AAAA,IACF,UAAE;AACA,UAAI,WAAW,YAAY,WAAY,YAAW,UAAU;AAC5D,UAAI,UAAU,EAAG,cAAa,KAAK;AAAA,IACrC;AAAA,EACF,GAAG,CAAC,YAAY,uBAAuB,CAAC,CAAC;AAEzC,QAAM,UAAU,MAAM;AACpB,QAAI,CAAC,MAAM;AACT,mBAAa,WAAW;AACxB,iBAAW,SAAS,MAAM;AAC1B,iBAAW,UAAU;AACrB,mBAAa,KAAK;AAClB;AAAA,IACF;AACA,SAAK,WAAW;AAChB,WAAO,MAAM;AACX,mBAAa,WAAW;AACxB,iBAAW,SAAS,MAAM;AAC1B,iBAAW,UAAU;AAAA,IACvB;AAAA,EACF,GAAG,CAAC,YAAY,IAAI,CAAC;AAErB,QAAM,qBAAqB,MAAM,YAAY,CAAC,YAAoB;AAChE,QAAI,uBAAuB,QAAQ,IAAI,OAAO,EAAG,QAAO;AACxD,2BAAuB,QAAQ,IAAI,OAAO;AAC1C,uBAAmB,CAAC,YAAY,IAAI,IAAI,OAAO,EAAE,IAAI,OAAO,CAAC;AAC7D,WAAO;AAAA,EACT,GAAG,CAAC,CAAC;AAEL,QAAM,sBAAsB,MAAM,YAAY,CAAC,YAAoB;AACjE,2BAAuB,QAAQ,OAAO,OAAO;AAC7C,uBAAmB,CAAC,YAAY;AAC9B,UAAI,CAAC,QAAQ,IAAI,OAAO,EAAG,QAAO;AAClC,YAAM,OAAO,IAAI,IAAI,OAAO;AAC5B,WAAK,OAAO,OAAO;AACnB,aAAO;AAAA,IACT,CAAC;AAAA,EACH,GAAG,CAAC,CAAC;AAEL,QAAM,WAAW,MAAM,YAAY,YAAY;AAC7C,UAAM,mBAAmB,YAAY,KAAK;AAC1C,QAAI,CAAC,oBAAoB,CAAC,aAAa,eAAe,WAAW,CAAC,sBAAsB,EAAG;AAC3F,mBAAe,UAAU;AACzB,oBAAgB,IAAI;AACpB,QAAI;AACF,YAAM,YAAY;AAAA,QAChB,WAAW,YAAY;AACrB,gBAAM;AAAA,YACJ,kBAAkB,mBAAmB,UAAU,CAAC;AAAA,YAChD;AAAA,cACE,QAAQ;AAAA,cACR,SAAS,EAAE,gBAAgB,mBAAmB;AAAA,cAC9C,MAAM,KAAK,UAAU,EAAE,eAAe,aAAa,kBAAkB,WAAW,CAAC;AAAA,YACnF;AAAA,YACA,EAAE,cAAc,EAAE,kCAAkC,EAAE;AAAA,UACxD;AAAA,QACF;AAAA,QACA,SAAS,gBAAgB,4BAA4B,UAAU;AAAA,QAC/D,iBAAiB,EAAE,eAAe,aAAa,kBAAkB,WAAW;AAAA,MAC9E,CAAC;AACD,UAAI,CAAC,sBAAsB,EAAG;AAC9B,qBAAe,EAAE;AACjB,oBAAc,QAAQ;AACtB,YAAM,WAAW;AACjB,UAAI,CAAC,sBAAsB,EAAG;AAC9B,YAAM,EAAE,oCAAoC,GAAG,SAAS;AAAA,IAC1D,SAAS,QAAQ;AACf,UAAI,CAAC,sBAAsB,EAAG;AAC9B,YAAM,kBAAkB,QAAQ,OAAO,UAAU,EAAE,kCAAkC,GAAG,OAAO;AAAA,IACjG,UAAE;AACA,qBAAe,UAAU;AACzB,sBAAgB,KAAK;AAAA,IACvB;AAAA,EACF,GAAG,CAAC,WAAW,YAAY,uBAAuB,YAAY,iBAAiB,YAAY,aAAa,eAAe,aAAa,CAAC,CAAC;AAEtI,QAAM,mBAAmB,MAAM,YAAY,OACzC,OACA,mBACG;AACH,QAAI,CAAC,aAAa,MAAM,eAAe,kBAAkB,CAAC,sBAAsB,KAAK,CAAC,mBAAmB,MAAM,EAAE,EAAG;AACpH,QAAI;AACF,YAAM,YAAY;AAAA,QAChB,WAAW,MAAM;AAAA,UACf,0BAA0B,MAAM,SAAS;AAAA,UACzC,MAAM;AAAA,YACJ,kBAAkB,mBAAmB,UAAU,CAAC;AAAA,YAChD;AAAA,cACE,QAAQ;AAAA,cACR,SAAS,EAAE,gBAAgB,mBAAmB;AAAA,cAC9C,MAAM,KAAK,UAAU,EAAE,IAAI,MAAM,IAAI,YAAY,eAAe,CAAC;AAAA,YACnE;AAAA,YACA,EAAE,cAAc,EAAE,qCAAqC,EAAE;AAAA,UAC3D;AAAA,QACF;AAAA,QACA,SAAS,gBAAgB,4BAA4B,MAAM,EAAE;AAAA,QAC7D,iBAAiB,EAAE,IAAI,MAAM,IAAI,YAAY,eAAe;AAAA,MAC9D,CAAC;AACD,UAAI,CAAC,sBAAsB,EAAG;AAC9B,gBAAU,CAAC,YAAY,QAAQ,IAAI,CAAC,QAClC,IAAI,OAAO,MAAM,KAAK,EAAE,GAAG,KAAK,YAAY,eAAe,IAAI,GAChE,CAAC;AACF,YAAM,WAAW;AACjB,UAAI,CAAC,sBAAsB,EAAG;AAC9B,YAAM,EAAE,uCAAuC,GAAG,SAAS;AAAA,IAC7D,SAAS,QAAQ;AACf,UAAI,CAAC,sBAAsB,EAAG;AAC9B,UAAI,CAAC,sBAAsB,QAAQ,GAAG,EAAE,WAAW,MAAM;AAAE,aAAK,WAAW;AAAA,MAAE,EAAE,CAAC,GAAG;AACjF,cAAM,kBAAkB,QAAQ,OAAO,UAAU,EAAE,qCAAqC,GAAG,OAAO;AAAA,MACpG;AAAA,IACF,UAAE;AACA,0BAAoB,MAAM,EAAE;AAAA,IAC9B;AAAA,EACF,GAAG,CAAC,oBAAoB,WAAW,YAAY,qBAAqB,uBAAuB,YAAY,iBAAiB,aAAa,CAAC,CAAC;AAEvI,QAAM,cAAc,MAAM,YAAY,OAAO,UAAoB;AAC/D,QAAI,CAAC,aAAa,CAAC,sBAAsB,KAAK,CAAC,mBAAmB,MAAM,EAAE,EAAG;AAC7E,QAAI;AACF,YAAM,YAAY;AAAA,QAChB,WAAW,MAAM;AAAA,UACf,0BAA0B,MAAM,SAAS;AAAA,UACzC,MAAM;AAAA,YACJ,kBAAkB,mBAAmB,UAAU,CAAC;AAAA,YAChD;AAAA,cACE,QAAQ;AAAA,cACR,SAAS,EAAE,gBAAgB,mBAAmB;AAAA,cAC9C,MAAM,KAAK,UAAU,EAAE,IAAI,MAAM,GAAG,CAAC;AAAA,YACvC;AAAA,YACA,EAAE,cAAc,EAAE,qCAAqC,EAAE;AAAA,UAC3D;AAAA,QACF;AAAA,QACA,SAAS,gBAAgB,4BAA4B,MAAM,EAAE;AAAA,QAC7D,iBAAiB,EAAE,IAAI,MAAM,GAAG;AAAA,MAClC,CAAC;AACD,UAAI,CAAC,sBAAsB,EAAG;AAC9B,gBAAU,CAAC,YAAY,QAAQ,OAAO,CAAC,QAAQ,IAAI,OAAO,MAAM,EAAE,CAAC;AACnE,YAAM,EAAE,uCAAuC,GAAG,SAAS;AAAA,IAC7D,SAAS,QAAQ;AACf,UAAI,CAAC,sBAAsB,EAAG;AAC9B,UAAI,CAAC,sBAAsB,QAAQ,GAAG,EAAE,WAAW,MAAM;AAAE,aAAK,WAAW;AAAA,MAAE,EAAE,CAAC,GAAG;AACjF,cAAM,kBAAkB,QAAQ,OAAO,UAAU,EAAE,qCAAqC,GAAG,OAAO;AAAA,MACpG;AAAA,IACF,UAAE;AACA,0BAAoB,MAAM,EAAE;AAAA,IAC9B;AAAA,EACF,GAAG,CAAC,oBAAoB,WAAW,YAAY,qBAAqB,uBAAuB,YAAY,iBAAiB,aAAa,CAAC,CAAC;AAEvI,QAAM,sBAAsB,MAAM,YAAY,CAAC,aAAyC;AACtF,qBAAiB,QAAQ;AACzB,mBAAe,EAAE;AAAA,EACnB,GAAG,CAAC,CAAC;AAEL,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA,QAAQ;AAAA,IACR;AAAA,IACA;AAAA,EACF;AACF;",
+  "names": []
+}

package/dist/modules/documents/backend/documents/components/useTemplateDetail.js

@@ -0,0 +1,49 @@
+"use client";
+import * as React from "react";
+import { apiCall } from "@open-mercato/ui/backend/utils/apiCall";
+import { normalizeTemplateDetail } from "./templateUi.js";
+function useTemplateDetail(open, templateId) {
+  const requestId = React.useRef(0);
+  const [loadAttempt, setLoadAttempt] = React.useState(0);
+  const [state, setState] = React.useState({ templateId: null, template: null, status: "idle" });
+  React.useEffect(() => {
+    const currentRequestId = ++requestId.current;
+    if (!open || !templateId) {
+      setState({ templateId: null, template: null, status: "idle" });
+      return;
+    }
+    const controller = new AbortController();
+    setState({ templateId, template: null, status: "loading" });
+    void apiCall(
+      `/api/documents/templates/${encodeURIComponent(templateId)}`,
+      { signal: controller.signal },
+      { fallback: null }
+    ).then((call) => {
+      if (controller.signal.aborted || requestId.current !== currentRequestId) return;
+      const detail = call.ok ? normalizeTemplateDetail(call.result) : null;
+      if (!detail || detail.id !== templateId) throw new Error("[internal] failed to load document template detail");
+      setState({ templateId, template: detail, status: "ready" });
+    }).catch(() => {
+      if (!controller.signal.aborted && requestId.current === currentRequestId) {
+        setState({ templateId, template: null, status: "error" });
+      }
+    });
+    return () => {
+      controller.abort();
+    };
+  }, [loadAttempt, open, templateId]);
+  const retry = React.useCallback(() => {
+    setLoadAttempt((current) => current + 1);
+  }, []);
+  const matchesRequest = state.templateId === templateId;
+  return {
+    template: matchesRequest ? state.template : null,
+    isLoading: Boolean(open && templateId) && (!matchesRequest || state.status === "loading"),
+    error: matchesRequest && state.status === "error",
+    retry
+  };
+}
+export {
+  useTemplateDetail
+};
+//# sourceMappingURL=useTemplateDetail.js.map

package/dist/modules/documents/backend/documents/components/useTemplateDetail.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../../src/modules/documents/backend/documents/components/useTemplateDetail.ts"],
+  "sourcesContent": ["\"use client\"\n\nimport * as React from 'react'\nimport { apiCall } from '@open-mercato/ui/backend/utils/apiCall'\nimport { normalizeTemplateDetail, type TemplateRow } from './templateUi'\n\nexport function useTemplateDetail(open: boolean, templateId: string | null) {\n  const requestId = React.useRef(0)\n  const [loadAttempt, setLoadAttempt] = React.useState(0)\n  const [state, setState] = React.useState<{\n    templateId: string | null\n    template: TemplateRow | null\n    status: 'idle' | 'loading' | 'ready' | 'error'\n  }>({ templateId: null, template: null, status: 'idle' })\n\n  React.useEffect(() => {\n    const currentRequestId = ++requestId.current\n    if (!open || !templateId) {\n      setState({ templateId: null, template: null, status: 'idle' })\n      return\n    }\n\n    const controller = new AbortController()\n    setState({ templateId, template: null, status: 'loading' })\n    void apiCall<unknown>(\n      `/api/documents/templates/${encodeURIComponent(templateId)}`,\n      { signal: controller.signal },\n      { fallback: null },\n    ).then((call) => {\n      if (controller.signal.aborted || requestId.current !== currentRequestId) return\n      const detail = call.ok ? normalizeTemplateDetail(call.result) : null\n      if (!detail || detail.id !== templateId) throw new Error('[internal] failed to load document template detail')\n      setState({ templateId, template: detail, status: 'ready' })\n    }).catch(() => {\n      if (!controller.signal.aborted && requestId.current === currentRequestId) {\n        setState({ templateId, template: null, status: 'error' })\n      }\n    })\n\n    return () => { controller.abort() }\n  }, [loadAttempt, open, templateId])\n\n  const retry = React.useCallback(() => {\n    setLoadAttempt((current) => current + 1)\n  }, [])\n\n  const matchesRequest = state.templateId === templateId\n  return {\n    template: matchesRequest ? state.template : null,\n    isLoading: Boolean(open && templateId) && (!matchesRequest || state.status === 'loading'),\n    error: matchesRequest && state.status === 'error',\n    retry,\n  }\n}\n"],
+  "mappings": ";AAEA,YAAY,WAAW;AACvB,SAAS,eAAe;AACxB,SAAS,+BAAiD;AAEnD,SAAS,kBAAkB,MAAe,YAA2B;AAC1E,QAAM,YAAY,MAAM,OAAO,CAAC;AAChC,QAAM,CAAC,aAAa,cAAc,IAAI,MAAM,SAAS,CAAC;AACtD,QAAM,CAAC,OAAO,QAAQ,IAAI,MAAM,SAI7B,EAAE,YAAY,MAAM,UAAU,MAAM,QAAQ,OAAO,CAAC;AAEvD,QAAM,UAAU,MAAM;AACpB,UAAM,mBAAmB,EAAE,UAAU;AACrC,QAAI,CAAC,QAAQ,CAAC,YAAY;AACxB,eAAS,EAAE,YAAY,MAAM,UAAU,MAAM,QAAQ,OAAO,CAAC;AAC7D;AAAA,IACF;AAEA,UAAM,aAAa,IAAI,gBAAgB;AACvC,aAAS,EAAE,YAAY,UAAU,MAAM,QAAQ,UAAU,CAAC;AAC1D,SAAK;AAAA,MACH,4BAA4B,mBAAmB,UAAU,CAAC;AAAA,MAC1D,EAAE,QAAQ,WAAW,OAAO;AAAA,MAC5B,EAAE,UAAU,KAAK;AAAA,IACnB,EAAE,KAAK,CAAC,SAAS;AACf,UAAI,WAAW,OAAO,WAAW,UAAU,YAAY,iBAAkB;AACzE,YAAM,SAAS,KAAK,KAAK,wBAAwB,KAAK,MAAM,IAAI;AAChE,UAAI,CAAC,UAAU,OAAO,OAAO,WAAY,OAAM,IAAI,MAAM,oDAAoD;AAC7G,eAAS,EAAE,YAAY,UAAU,QAAQ,QAAQ,QAAQ,CAAC;AAAA,IAC5D,CAAC,EAAE,MAAM,MAAM;AACb,UAAI,CAAC,WAAW,OAAO,WAAW,UAAU,YAAY,kBAAkB;AACxE,iBAAS,EAAE,YAAY,UAAU,MAAM,QAAQ,QAAQ,CAAC;AAAA,MAC1D;AAAA,IACF,CAAC;AAED,WAAO,MAAM;AAAE,iBAAW,MAAM;AAAA,IAAE;AAAA,EACpC,GAAG,CAAC,aAAa,MAAM,UAAU,CAAC;AAElC,QAAM,QAAQ,MAAM,YAAY,MAAM;AACpC,mBAAe,CAAC,YAAY,UAAU,CAAC;AAAA,EACzC,GAAG,CAAC,CAAC;AAEL,QAAM,iBAAiB,MAAM,eAAe;AAC5C,SAAO;AAAA,IACL,UAAU,iBAAiB,MAAM,WAAW;AAAA,IAC5C,WAAW,QAAQ,QAAQ,UAAU,MAAM,CAAC,kBAAkB,MAAM,WAAW;AAAA,IAC/E,OAAO,kBAAkB,MAAM,WAAW;AAAA,IAC1C;AAAA,EACF;AACF;",
+  "names": []
+}