canopycms 0.0.0

package/dist/editor/hooks/useReferenceResolution.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Hook for live preview reference resolution
+ *
+ * LIVE PREVIEW REFERENCE RESOLUTION
+ *
+ * Problem: The preview needs full referenced content (e.g., {name: "Alice", bio: "..."}),
+ * but the form only stores IDs (e.g., "5NVkkrB1MJUvnLqEDqDkRN").
+ *
+ * Solution: Synchronous resolution with background caching
+ *
+ * 1. SYNCHRONOUS PHASE (useMemo):
+ *    - Compute resolvedValue by applying cached data to form value
+ *    - If reference ID is in cache, use full object; otherwise keep ID
+ *    - Runs during render, so no async gaps or race conditions
+ *    - Preview always gets complete, valid data
+ *
+ * 2. BACKGROUND PHASE (useEffect):
+ *    - Find IDs not in cache
+ *    - After 300ms debounce, fetch from API
+ *    - Update cache with resolved data
+ *    - Trigger useMemo re-run via resolutionTrigger
+ *    - Preview updates again with full data
+ *
+ * This two-phase approach eliminates race conditions that occurred with async state,
+ * where form data and resolved data could get out of sync during transitions
+ * (e.g., "Discard All Drafts" was passing empty objects to preview).
+ *
+ * Cache structure: Map<string, unknown> with keys like "main:5NVkkrB1MJUvnLqEDqDkRN"
+ * - Branch-scoped to prevent stale cross-branch data
+ * - Cleared on branch change
+ * - Persists across edits for instant re-renders
+ */
+import type { EntrySchema } from '../../config';
+export type FormValue = Record<string, unknown>;
+export interface UseReferenceResolutionOptions {
+    value: FormValue;
+    fields: EntrySchema;
+    branch: string;
+    onResolvedValueChange?: (resolved: FormValue) => void;
+    onLoadingStateChange?: (loadingState: FormValue) => void;
+}
+export interface UseReferenceResolutionResult {
+    resolvedValue: FormValue;
+    loadingState: FormValue;
+}
+export declare function useReferenceResolution({ value, fields, branch, onResolvedValueChange, onLoadingStateChange, }: UseReferenceResolutionOptions): UseReferenceResolutionResult;
+//# sourceMappingURL=useReferenceResolution.d.ts.map

package/dist/editor/hooks/useReferenceResolution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useReferenceResolution.d.ts","sourceRoot":"","sources":["../../../src/editor/hooks/useReferenceResolution.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAG/C,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;AAE/C,MAAM,WAAW,6BAA6B;IAC5C,KAAK,EAAE,SAAS,CAAA;IAChB,MAAM,EAAE,WAAW,CAAA;IACnB,MAAM,EAAE,MAAM,CAAA;IACd,qBAAqB,CAAC,EAAE,CAAC,QAAQ,EAAE,SAAS,KAAK,IAAI,CAAA;IACrD,oBAAoB,CAAC,EAAE,CAAC,YAAY,EAAE,SAAS,KAAK,IAAI,CAAA;CACzD;AAED,MAAM,WAAW,4BAA4B;IAC3C,aAAa,EAAE,SAAS,CAAA;IACxB,YAAY,EAAE,SAAS,CAAA;CACxB;AAED,wBAAgB,sBAAsB,CAAC,EACrC,KAAK,EACL,MAAM,EACN,MAAM,EACN,qBAAqB,EACrB,oBAAoB,GACrB,EAAE,6BAA6B,GAAG,4BAA4B,CA6L9D"}

package/dist/editor/hooks/useReferenceResolution.js

@@ -0,0 +1,207 @@
+/**
+ * Hook for live preview reference resolution
+ *
+ * LIVE PREVIEW REFERENCE RESOLUTION
+ *
+ * Problem: The preview needs full referenced content (e.g., {name: "Alice", bio: "..."}),
+ * but the form only stores IDs (e.g., "5NVkkrB1MJUvnLqEDqDkRN").
+ *
+ * Solution: Synchronous resolution with background caching
+ *
+ * 1. SYNCHRONOUS PHASE (useMemo):
+ *    - Compute resolvedValue by applying cached data to form value
+ *    - If reference ID is in cache, use full object; otherwise keep ID
+ *    - Runs during render, so no async gaps or race conditions
+ *    - Preview always gets complete, valid data
+ *
+ * 2. BACKGROUND PHASE (useEffect):
+ *    - Find IDs not in cache
+ *    - After 300ms debounce, fetch from API
+ *    - Update cache with resolved data
+ *    - Trigger useMemo re-run via resolutionTrigger
+ *    - Preview updates again with full data
+ *
+ * This two-phase approach eliminates race conditions that occurred with async state,
+ * where form data and resolved data could get out of sync during transitions
+ * (e.g., "Discard All Drafts" was passing empty objects to preview).
+ *
+ * Cache structure: Map<string, unknown> with keys like "main:5NVkkrB1MJUvnLqEDqDkRN"
+ * - Branch-scoped to prevent stale cross-branch data
+ * - Cleared on branch change
+ * - Persists across edits for instant re-renders
+ */
+import { useEffect, useMemo, useRef, useState } from 'react';
+import { resolveChangedReferences } from '../client-reference-resolver';
+export function useReferenceResolution({ value, fields, branch, onResolvedValueChange, onLoadingStateChange, }) {
+    const resolvedCache = useRef(new Map());
+    const prevValueRef = useRef({}); // Track previous value for change detection
+    const lastNotifiedValueRef = useRef(''); // Track last notified value to prevent infinite loops
+    const [resolutionTrigger, setResolutionTrigger] = useState(0); // Trigger to force useMemo re-computation
+    // Map field names to their types for fast lookup
+    const referenceFieldNames = useMemo(() => {
+        const names = new Set();
+        for (const field of fields) {
+            if (field.type === 'reference') {
+                names.add(field.name);
+            }
+        }
+        return names;
+    }, [fields]);
+    /**
+     * PHASE 1: SYNCHRONOUS RESOLUTION
+     *
+     * Compute resolved value by applying cached reference data to form value.
+     * This runs synchronously during render (useMemo), so there are no async gaps.
+     *
+     * For each reference field:
+     * - If ID is in cache: substitute full object
+     * - If ID not in cache: keep the ID (loading state)
+     *
+     * Dependencies include resolutionTrigger, which is incremented when cache updates,
+     * forcing this to re-run and pick up newly-resolved data.
+     */
+    const resolvedValue = useMemo(() => {
+        const result = { ...value };
+        // Synchronously apply cached resolutions
+        for (const fieldName of referenceFieldNames) {
+            const fieldValue = value[fieldName];
+            if (fieldValue) {
+                if (Array.isArray(fieldValue)) {
+                    // List of references
+                    result[fieldName] = fieldValue.map((id) => {
+                        if (typeof id === 'string') {
+                            const cached = resolvedCache.current.get(`${branch}:${id}`);
+                            // Return cached object, or null if not yet resolved
+                            return cached || null;
+                        }
+                        return id;
+                    });
+                }
+                else if (typeof fieldValue === 'string') {
+                    // Single reference
+                    const cached = resolvedCache.current.get(`${branch}:${fieldValue}`);
+                    // Return cached object, or null if not yet resolved
+                    result[fieldName] = cached || null;
+                }
+            }
+        }
+        return result;
+    }, [value, branch, resolutionTrigger, referenceFieldNames]);
+    /**
+     * Compute loading state that mirrors the data structure.
+     * For each reference field, track if it's currently loading (not in cache).
+     */
+    const loadingState = useMemo(() => {
+        const result = {};
+        for (const fieldName of referenceFieldNames) {
+            const fieldValue = value[fieldName];
+            if (fieldValue) {
+                if (Array.isArray(fieldValue)) {
+                    // List of references - return array of booleans
+                    result[fieldName] = fieldValue.map((id) => {
+                        if (typeof id === 'string') {
+                            return !resolvedCache.current.has(`${branch}:${id}`);
+                        }
+                        return false;
+                    });
+                }
+                else if (typeof fieldValue === 'string') {
+                    // Single reference - return boolean
+                    result[fieldName] = !resolvedCache.current.has(`${branch}:${fieldValue}`);
+                }
+                else {
+                    result[fieldName] = false;
+                }
+            }
+            else {
+                result[fieldName] = false;
+            }
+        }
+        return result;
+    }, [value, branch, resolutionTrigger, referenceFieldNames]);
+    /**
+     * PHASE 2: BACKGROUND ASYNC RESOLUTION
+     *
+     * Find reference IDs that aren't in cache yet and fetch them from the API.
+     */
+    useEffect(() => {
+        // Find all uncached reference IDs
+        const uncachedIds = new Set();
+        for (const fieldName of referenceFieldNames) {
+            const fieldValue = value[fieldName];
+            if (fieldValue) {
+                const ids = Array.isArray(fieldValue) ? fieldValue : [fieldValue];
+                for (const id of ids) {
+                    if (typeof id === 'string' && !resolvedCache.current.has(`${branch}:${id}`)) {
+                        uncachedIds.add(id);
+                    }
+                }
+            }
+        }
+        if (uncachedIds.size === 0) {
+            prevValueRef.current = value;
+            return;
+        }
+        // Debounce API calls to batch multiple rapid changes
+        const timeout = setTimeout(async () => {
+            try {
+                // Resolve uncached IDs via API
+                const updates = await resolveChangedReferences(prevValueRef.current, value, fields, branch, resolvedCache.current);
+                // Update cache with resolved values
+                for (const [fieldName, resolvedFieldValue] of Object.entries(updates)) {
+                    if (Array.isArray(resolvedFieldValue)) {
+                        resolvedFieldValue.forEach((obj, idx) => {
+                            const fieldValue = value[fieldName];
+                            if (Array.isArray(fieldValue)) {
+                                const id = fieldValue[idx];
+                                if (typeof obj === 'object' && obj !== null && typeof id === 'string') {
+                                    resolvedCache.current.set(`${branch}:${id}`, obj);
+                                }
+                            }
+                        });
+                    }
+                    else if (typeof resolvedFieldValue === 'object' && resolvedFieldValue !== null) {
+                        const id = value[fieldName];
+                        if (typeof id === 'string') {
+                            resolvedCache.current.set(`${branch}:${id}`, resolvedFieldValue);
+                        }
+                    }
+                }
+                // Trigger useMemo re-computation
+                setResolutionTrigger((prev) => prev + 1);
+                prevValueRef.current = value;
+            }
+            catch (error) {
+                console.error('Reference resolution failed:', error);
+            }
+        }, 300); // 300ms debounce
+        return () => clearTimeout(timeout);
+    }, [value, fields, branch, referenceFieldNames]);
+    // Clear cache when branch changes
+    useEffect(() => {
+        resolvedCache.current.clear();
+        setResolutionTrigger((prev) => prev + 1); // Trigger re-computation with empty cache
+    }, [branch]);
+    // Notify parent of resolved value changes (with infinite loop prevention)
+    useEffect(() => {
+        const serialized = JSON.stringify(resolvedValue);
+        if (serialized !== lastNotifiedValueRef.current) {
+            lastNotifiedValueRef.current = serialized;
+            onResolvedValueChange?.(resolvedValue);
+        }
+    }, [resolvedValue, onResolvedValueChange]);
+    // Notify parent of loading state changes
+    const lastNotifiedLoadingRef = useRef('');
+    useEffect(() => {
+        const serialized = JSON.stringify(loadingState);
+        if (serialized !== lastNotifiedLoadingRef.current) {
+            lastNotifiedLoadingRef.current = serialized;
+            onLoadingStateChange?.(loadingState);
+        }
+    }, [loadingState, onLoadingStateChange]);
+    return {
+        resolvedValue,
+        loadingState,
+    };
+}
+//# sourceMappingURL=useReferenceResolution.js.map

package/dist/editor/hooks/useReferenceResolution.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useReferenceResolution.js","sourceRoot":"","sources":["../../../src/editor/hooks/useReferenceResolution.ts"],"names":[],"mappings":"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"}

package/dist/editor/hooks/useSchemaManager.d.ts

@@ -0,0 +1,46 @@
+import type { CreateCollectionInput, UpdateCollectionInput, CreateEntryTypeInput, UpdateEntryTypeInput } from '../../api';
+import type { LogicalPath, ContentId } from '../../paths/types';
+export interface UseSchemaManagerOptions {
+    branchName: string;
+    onSchemaChange?: () => void;
+}
+export interface UseSchemaManagerReturn {
+    createCollection: (input: CreateCollectionInput) => Promise<{
+        collectionPath: LogicalPath;
+        contentId: ContentId;
+    } | null>;
+    updateCollection: (collectionPath: LogicalPath, updates: UpdateCollectionInput) => Promise<boolean>;
+    deleteCollection: (collectionPath: LogicalPath) => Promise<boolean>;
+    addEntryType: (collectionPath: LogicalPath, entryType: CreateEntryTypeInput) => Promise<boolean>;
+    updateEntryType: (collectionPath: LogicalPath, entryTypeName: string, updates: UpdateEntryTypeInput) => Promise<boolean>;
+    removeEntryType: (collectionPath: LogicalPath, entryTypeName: string) => Promise<boolean>;
+    updateOrder: (collectionPath: LogicalPath, order: string[]) => Promise<boolean>;
+    deleteEntry: (entryPath: LogicalPath) => Promise<boolean>;
+    isLoading: boolean;
+}
+/**
+ * Hook for managing schema operations (collections, entry types, ordering).
+ *
+ * Provides methods to create, update, and delete collections and entry types.
+ * All operations require admin permissions on the server.
+ *
+ * @example
+ * ```tsx
+ * const {
+ *   createCollection,
+ *   deleteCollection,
+ *   addEntryType,
+ *   updateOrder,
+ *   isLoading
+ * } = useSchemaManager({ branchName: 'main', onSchemaChange: refreshEntries })
+ *
+ * // Create a new collection
+ * await createCollection({
+ *   name: 'posts',
+ *   label: 'Blog Posts',
+ *   entries: [{ name: 'post', format: 'mdx', schema: 'postSchema' }]
+ * })
+ * ```
+ */
+export declare function useSchemaManager(options: UseSchemaManagerOptions): UseSchemaManagerReturn;
+//# sourceMappingURL=useSchemaManager.d.ts.map

package/dist/editor/hooks/useSchemaManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useSchemaManager.d.ts","sourceRoot":"","sources":["../../../src/editor/hooks/useSchemaManager.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,qBAAqB,EACrB,qBAAqB,EACrB,oBAAoB,EACpB,oBAAoB,EACrB,MAAM,WAAW,CAAA;AAClB,OAAO,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAA;AAE/D,MAAM,WAAW,uBAAuB;IACtC,UAAU,EAAE,MAAM,CAAA;IAClB,cAAc,CAAC,EAAE,MAAM,IAAI,CAAA;CAC5B;AAED,MAAM,WAAW,sBAAsB;IAErC,gBAAgB,EAAE,CAChB,KAAK,EAAE,qBAAqB,KACzB,OAAO,CAAC;QAAE,cAAc,EAAE,WAAW,CAAC;QAAC,SAAS,EAAE,SAAS,CAAA;KAAE,GAAG,IAAI,CAAC,CAAA;IAC1E,gBAAgB,EAAE,CAChB,cAAc,EAAE,WAAW,EAC3B,OAAO,EAAE,qBAAqB,KAC3B,OAAO,CAAC,OAAO,CAAC,CAAA;IACrB,gBAAgB,EAAE,CAAC,cAAc,EAAE,WAAW,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;IAGnE,YAAY,EAAE,CAAC,cAAc,EAAE,WAAW,EAAE,SAAS,EAAE,oBAAoB,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;IAChG,eAAe,EAAE,CACf,cAAc,EAAE,WAAW,EAC3B,aAAa,EAAE,MAAM,EACrB,OAAO,EAAE,oBAAoB,KAC1B,OAAO,CAAC,OAAO,CAAC,CAAA;IACrB,eAAe,EAAE,CAAC,cAAc,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;IAGzF,WAAW,EAAE,CAAC,cAAc,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;IAG/E,WAAW,EAAE,CAAC,SAAS,EAAE,WAAW,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;IAGzD,SAAS,EAAE,OAAO,CAAA;CACnB;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,uBAAuB,GAAG,sBAAsB,CA+OzF"}

package/dist/editor/hooks/useSchemaManager.js

@@ -0,0 +1,235 @@
+import { useState, useCallback } from 'react';
+import { notifications } from '@mantine/notifications';
+import { useApiClient } from '../context';
+/**
+ * Hook for managing schema operations (collections, entry types, ordering).
+ *
+ * Provides methods to create, update, and delete collections and entry types.
+ * All operations require admin permissions on the server.
+ *
+ * @example
+ * ```tsx
+ * const {
+ *   createCollection,
+ *   deleteCollection,
+ *   addEntryType,
+ *   updateOrder,
+ *   isLoading
+ * } = useSchemaManager({ branchName: 'main', onSchemaChange: refreshEntries })
+ *
+ * // Create a new collection
+ * await createCollection({
+ *   name: 'posts',
+ *   label: 'Blog Posts',
+ *   entries: [{ name: 'post', format: 'mdx', schema: 'postSchema' }]
+ * })
+ * ```
+ */
+export function useSchemaManager(options) {
+    const apiClient = useApiClient();
+    const [isLoading, setIsLoading] = useState(false);
+    const handleError = useCallback((message, error) => {
+        console.error(message, error);
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        notifications.show({
+            title: 'Error',
+            message: `${message}: ${errorMessage}`,
+            color: 'red',
+        });
+    }, []);
+    const createCollection = useCallback(async (input) => {
+        setIsLoading(true);
+        try {
+            const result = await apiClient.schema.createCollection({ branch: options.branchName }, input);
+            if (!result.ok || !result.data) {
+                throw new Error(result.error || 'Failed to create collection');
+            }
+            notifications.show({
+                message: `Collection "${input.name}" created`,
+                color: 'green',
+            });
+            options.onSchemaChange?.();
+            return result.data;
+        }
+        catch (error) {
+            handleError('Failed to create collection', error);
+            return null;
+        }
+        finally {
+            setIsLoading(false);
+        }
+    }, [apiClient, options.branchName, options.onSchemaChange, handleError]);
+    const updateCollection = useCallback(async (collectionPath, updates) => {
+        setIsLoading(true);
+        try {
+            const result = await apiClient.schema.updateCollection({ branch: options.branchName, collectionPath }, updates);
+            if (!result.ok) {
+                throw new Error(result.error || 'Failed to update collection');
+            }
+            notifications.show({
+                message: 'Collection updated',
+                color: 'green',
+            });
+            await options.onSchemaChange?.();
+            return true;
+        }
+        catch (error) {
+            handleError('Failed to update collection', error);
+            return false;
+        }
+        finally {
+            setIsLoading(false);
+        }
+    }, [apiClient, options.branchName, options.onSchemaChange, handleError]);
+    const deleteCollection = useCallback(async (collectionPath) => {
+        setIsLoading(true);
+        try {
+            const result = await apiClient.schema.deleteCollection({
+                branch: options.branchName,
+                collectionPath,
+            });
+            if (!result.ok) {
+                throw new Error(result.error || 'Failed to delete collection');
+            }
+            notifications.show({
+                message: 'Collection deleted',
+                color: 'green',
+            });
+            options.onSchemaChange?.();
+            return true;
+        }
+        catch (error) {
+            handleError('Failed to delete collection', error);
+            return false;
+        }
+        finally {
+            setIsLoading(false);
+        }
+    }, [apiClient, options.branchName, options.onSchemaChange, handleError]);
+    const addEntryType = useCallback(async (collectionPath, entryType) => {
+        setIsLoading(true);
+        try {
+            const result = await apiClient.schema.addEntryType({ branch: options.branchName, collectionPath }, entryType);
+            if (!result.ok) {
+                throw new Error(result.error || 'Failed to add entry type');
+            }
+            notifications.show({
+                message: `Entry type "${entryType.name}" added`,
+                color: 'green',
+            });
+            options.onSchemaChange?.();
+            return true;
+        }
+        catch (error) {
+            handleError('Failed to add entry type', error);
+            return false;
+        }
+        finally {
+            setIsLoading(false);
+        }
+    }, [apiClient, options.branchName, options.onSchemaChange, handleError]);
+    const updateEntryType = useCallback(async (collectionPath, entryTypeName, updates) => {
+        setIsLoading(true);
+        try {
+            const result = await apiClient.schema.updateEntryType({ branch: options.branchName, collectionPath, entryTypeName }, updates);
+            if (!result.ok) {
+                throw new Error(result.error || 'Failed to update entry type');
+            }
+            notifications.show({
+                message: 'Entry type updated',
+                color: 'green',
+            });
+            options.onSchemaChange?.();
+            return true;
+        }
+        catch (error) {
+            handleError('Failed to update entry type', error);
+            return false;
+        }
+        finally {
+            setIsLoading(false);
+        }
+    }, [apiClient, options.branchName, options.onSchemaChange, handleError]);
+    const removeEntryType = useCallback(async (collectionPath, entryTypeName) => {
+        setIsLoading(true);
+        try {
+            const result = await apiClient.schema.removeEntryType({
+                branch: options.branchName,
+                collectionPath,
+                entryTypeName,
+            });
+            if (!result.ok) {
+                throw new Error(result.error || 'Failed to remove entry type');
+            }
+            notifications.show({
+                message: `Entry type "${entryTypeName}" removed`,
+                color: 'green',
+            });
+            options.onSchemaChange?.();
+            return true;
+        }
+        catch (error) {
+            handleError('Failed to remove entry type', error);
+            return false;
+        }
+        finally {
+            setIsLoading(false);
+        }
+    }, [apiClient, options.branchName, options.onSchemaChange, handleError]);
+    const updateOrder = useCallback(async (collectionPath, order) => {
+        setIsLoading(true);
+        try {
+            const result = await apiClient.schema.updateOrder({ branch: options.branchName, collectionPath }, { order });
+            if (!result.ok) {
+                throw new Error(result.error || 'Failed to update order');
+            }
+            // Silent success for order updates (common operation)
+            options.onSchemaChange?.();
+            return true;
+        }
+        catch (error) {
+            handleError('Failed to update order', error);
+            return false;
+        }
+        finally {
+            setIsLoading(false);
+        }
+    }, [apiClient, options.branchName, options.onSchemaChange, handleError]);
+    const deleteEntry = useCallback(async (entryPath) => {
+        setIsLoading(true);
+        try {
+            const result = await apiClient.entries.delete({
+                branch: options.branchName,
+                entryPath,
+            });
+            if (!result.ok) {
+                throw new Error(result.error || 'Failed to delete entry');
+            }
+            notifications.show({
+                message: 'Entry deleted',
+                color: 'green',
+            });
+            options.onSchemaChange?.();
+            return true;
+        }
+        catch (error) {
+            handleError('Failed to delete entry', error);
+            return false;
+        }
+        finally {
+            setIsLoading(false);
+        }
+    }, [apiClient, options.branchName, options.onSchemaChange, handleError]);
+    return {
+        createCollection,
+        updateCollection,
+        deleteCollection,
+        addEntryType,
+        updateEntryType,
+        removeEntryType,
+        updateOrder,
+        deleteEntry,
+        isLoading,
+    };
+}
+//# sourceMappingURL=useSchemaManager.js.map

package/dist/editor/hooks/useSchemaManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useSchemaManager.js","sourceRoot":"","sources":["../../../src/editor/hooks/useSchemaManager.ts"],"names":[],"mappings":"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"}

package/dist/editor/hooks/useUserContext.d.ts

@@ -0,0 +1,22 @@
+import type { UserContext } from '../BranchManager';
+export interface UseUserContextReturn {
+    userContext: UserContext | undefined;
+    loading: boolean;
+    error: string | undefined;
+}
+/**
+ * Hook to fetch current user context from the API.
+ * This provides the userId and groups needed for permission checks.
+ *
+ * @example
+ * ```tsx
+ * const { userContext, loading, error } = useUserContext()
+ *
+ * if (loading) return <div>Loading...</div>
+ * if (error) return <div>Error: {error}</div>
+ *
+ * return <BranchManager user={userContext} />
+ * ```
+ */
+export declare function useUserContext(): UseUserContextReturn;
+//# sourceMappingURL=useUserContext.d.ts.map

package/dist/editor/hooks/useUserContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useUserContext.d.ts","sourceRoot":"","sources":["../../../src/editor/hooks/useUserContext.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAEnD,MAAM,WAAW,oBAAoB;IACnC,WAAW,EAAE,WAAW,GAAG,SAAS,CAAA;IACpC,OAAO,EAAE,OAAO,CAAA;IAChB,KAAK,EAAE,MAAM,GAAG,SAAS,CAAA;CAC1B;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,cAAc,IAAI,oBAAoB,CAgCrD"}

package/dist/editor/hooks/useUserContext.js

@@ -0,0 +1,49 @@
+import { useEffect, useState } from 'react';
+import { createApiClient } from '../../api';
+/**
+ * Hook to fetch current user context from the API.
+ * This provides the userId and groups needed for permission checks.
+ *
+ * @example
+ * ```tsx
+ * const { userContext, loading, error } = useUserContext()
+ *
+ * if (loading) return <div>Loading...</div>
+ * if (error) return <div>Error: {error}</div>
+ *
+ * return <BranchManager user={userContext} />
+ * ```
+ */
+export function useUserContext() {
+    const [userContext, setUserContext] = useState();
+    const [loading, setLoading] = useState(true);
+    const [error, setError] = useState();
+    useEffect(() => {
+        const fetchUserContext = async () => {
+            setLoading(true);
+            try {
+                const apiClient = createApiClient();
+                const result = await apiClient.user.whoami();
+                if (result.ok && result.data) {
+                    setUserContext({
+                        userId: result.data.userId,
+                        groups: result.data.groups,
+                    });
+                }
+                else {
+                    setError(result.error || 'Failed to load user context');
+                }
+            }
+            catch (err) {
+                console.error('Failed to fetch user context:', err);
+                setError(err instanceof Error ? err.message : 'Unknown error');
+            }
+            finally {
+                setLoading(false);
+            }
+        };
+        fetchUserContext();
+    }, []);
+    return { userContext, loading, error };
+}
+//# sourceMappingURL=useUserContext.js.map

package/dist/editor/hooks/useUserContext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useUserContext.js","sourceRoot":"","sources":["../../../src/editor/hooks/useUserContext.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAA;AAC3C,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAA;AAS3C;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,cAAc;IAC5B,MAAM,CAAC,WAAW,EAAE,cAAc,CAAC,GAAG,QAAQ,EAA2B,CAAA;IACzE,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAA;IAC5C,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,EAAsB,CAAA;IAExD,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,gBAAgB,GAAG,KAAK,IAAI,EAAE;YAClC,UAAU,CAAC,IAAI,CAAC,CAAA;YAChB,IAAI,CAAC;gBACH,MAAM,SAAS,GAAG,eAAe,EAAE,CAAA;gBACnC,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,IAAI,CAAC,MAAM,EAAE,CAAA;gBAE5C,IAAI,MAAM,CAAC,EAAE,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;oBAC7B,cAAc,CAAC;wBACb,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,MAAM;wBAC1B,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,MAAM;qBAC3B,CAAC,CAAA;gBACJ,CAAC;qBAAM,CAAC;oBACN,QAAQ,CAAC,MAAM,CAAC,KAAK,IAAI,6BAA6B,CAAC,CAAA;gBACzD,CAAC;YACH,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,OAAO,CAAC,KAAK,CAAC,+BAA+B,EAAE,GAAG,CAAC,CAAA;gBACnD,QAAQ,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,CAAC,CAAA;YAChE,CAAC;oBAAS,CAAC;gBACT,UAAU,CAAC,KAAK,CAAC,CAAA;YACnB,CAAC;QACH,CAAC,CAAA;QAED,gBAAgB,EAAE,CAAA;IACpB,CAAC,EAAE,EAAE,CAAC,CAAA;IAEN,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,KAAK,EAAE,CAAA;AACxC,CAAC"}