@taskforcehq/taskforce 0.3.168

package/dist/hooks/useSyncOrchestrator.d.ts

@@ -0,0 +1,164 @@
+import type { TaskItem } from '../types';
+import { type WorkspaceSyncDocumentSnapshot } from '../sync/workspaceSyncModel';
+import type { RealtimeReconcileTelemetry } from '../sync/realtimeReconcile';
+import { type RealtimeConnectionState } from './useRealtimeSync';
+import type { SupportedLocale } from '../localization';
+export interface UseSyncOrchestratorInput {
+    currentWorkspaceId: string;
+    cloudAuthConfigured: boolean;
+    runtimeMode: 'local' | 'cloud';
+    isAuthenticated: boolean;
+    authUserId: string | null;
+    projectName: string;
+    resolveCloudAuthUrl: (path: string) => string;
+    resolveWebSocketUrl: (path: string) => string;
+    realtimeSyncEnabled: boolean;
+    tasks: TaskItem[];
+    archivedTasks: TaskItem[];
+    taxonomies: unknown[];
+    setupState: {
+        mode?: string;
+    } | null;
+    globalTheme: 'dark' | 'light' | 'midnight';
+    locale: SupportedLocale;
+    globalWeekStartsOn: 'sunday' | 'monday';
+    themeUseGlobalDefault: boolean;
+    setTasks: React.Dispatch<React.SetStateAction<TaskItem[]>>;
+    setArchivedTasks: React.Dispatch<React.SetStateAction<TaskItem[]>>;
+    setAuthBlocked: (value: boolean) => void;
+    setIsAuthenticated: (value: boolean) => void;
+    checkAuthSession: () => Promise<boolean>;
+    setGlobalTheme: (value: 'dark' | 'light' | 'midnight') => void;
+    setCurrentTheme: (value: 'dark' | 'light' | 'midnight') => void;
+    setSetupState: React.Dispatch<React.SetStateAction<any>>;
+    setLocale: (value: SupportedLocale) => void;
+    setGlobalWeekStartsOn: (value: 'sunday' | 'monday') => void;
+}
+export declare function useSyncOrchestrator(input: UseSyncOrchestratorInput): {
+    userGlobalSyncStatus: "error" | "disconnected" | "idle" | "syncing";
+    setUserGlobalSyncStatus: import("react").Dispatch<import("react").SetStateAction<"error" | "disconnected" | "idle" | "syncing">>;
+    userGlobalLastSyncedAt: string | null;
+    setUserGlobalLastSyncedAt: import("react").Dispatch<import("react").SetStateAction<string | null>>;
+    userGlobalSyncPendingChanges: number;
+    setUserGlobalSyncPendingChanges: import("react").Dispatch<import("react").SetStateAction<number>>;
+    userGlobalSyncError: string | null;
+    setUserGlobalSyncError: import("react").Dispatch<import("react").SetStateAction<string | null>>;
+    workspaceLastPullAt: string | null;
+    setWorkspaceLastPullAt: import("react").Dispatch<import("react").SetStateAction<string | null>>;
+    workspaceLastPushAt: string | null;
+    setWorkspaceLastPushAt: import("react").Dispatch<import("react").SetStateAction<string | null>>;
+    workspaceLastErrorAt: string | null;
+    setWorkspaceLastErrorAt: import("react").Dispatch<import("react").SetStateAction<string | null>>;
+    workspaceLastErrorMessage: string | null;
+    setWorkspaceLastErrorMessage: import("react").Dispatch<import("react").SetStateAction<string | null>>;
+    workspaceLastWarningMessage: string | null;
+    setWorkspaceLastWarningMessage: import("react").Dispatch<import("react").SetStateAction<string | null>>;
+    workspaceCloudSyncEnabled: boolean;
+    realtimeConnectionState: RealtimeConnectionState;
+    realtimeTelemetry: RealtimeReconcileTelemetry;
+    setWorkspaceCloudSyncEnabled: import("react").Dispatch<import("react").SetStateAction<boolean>>;
+    workspaceSyncSourceOfTruth: "local" | "cloud" | null;
+    setWorkspaceSyncSourceOfTruth: import("react").Dispatch<import("react").SetStateAction<"local" | "cloud" | null>>;
+    workspaceSyncOnboardingCompleted: boolean;
+    setWorkspaceSyncOnboardingCompleted: import("react").Dispatch<import("react").SetStateAction<boolean>>;
+    workspaceSyncReady: boolean;
+    setWorkspaceSyncReady: import("react").Dispatch<import("react").SetStateAction<boolean>>;
+    workspaceCloudHydrated: boolean;
+    setWorkspaceCloudHydrated: import("react").Dispatch<import("react").SetStateAction<boolean>>;
+    workspaceSyncDocuments: WorkspaceSyncDocumentSnapshot[];
+    setWorkspaceSyncDocuments: import("react").Dispatch<import("react").SetStateAction<WorkspaceSyncDocumentSnapshot[]>>;
+    workspaceSyncDocumentsFingerprint: string;
+    setWorkspaceSyncDocumentsFingerprint: import("react").Dispatch<import("react").SetStateAction<string>>;
+    syncInFlightRef: import("react").RefObject<boolean>;
+    workspaceRetryAt: string | null;
+    isWorkspacePullRetryPending: () => boolean;
+    workspaceBootstrapSyncInProgress: boolean;
+    setWorkspaceBootstrapSyncInProgress: import("react").Dispatch<import("react").SetStateAction<boolean>>;
+    workspaceBootstrapSyncPages: number;
+    setWorkspaceBootstrapSyncPages: import("react").Dispatch<import("react").SetStateAction<number>>;
+    workspaceBootstrapSyncAppliedChanges: number;
+    setWorkspaceBootstrapSyncAppliedChanges: import("react").Dispatch<import("react").SetStateAction<number>>;
+    workspaceSyncFailureCount: number;
+    workspaceSyncRetryScheduledCount: number;
+    workspaceSyncAuthFailureCount: number;
+    workspaceSyncLastFailureSource: ("push" | "pull" | "apply" | "handshake") | null;
+    workspaceSyncLastFailureStatusCode: number | null;
+    workspacePushInFlightRef: import("react").RefObject<boolean>;
+    workspacePullInFlightRef: import("react").RefObject<boolean>;
+    workspaceLastPushedSignatureRef: import("react").RefObject<string>;
+    workspacePendingSignatureRef: import("react").RefObject<string>;
+    workspaceLastPushedTaskIdsRef: import("react").RefObject<Set<string>>;
+    workspaceDeletedTaskIdsRef: import("react").RefObject<Set<string>>;
+    workspacePullCursorRef: import("react").RefObject<string | null>;
+    workspacePullBootstrapDoneRef: import("react").RefObject<boolean>;
+    workspaceBackfillForcedRef: import("react").RefObject<Set<string>>;
+    workspaceSyncReadyRef: import("react").RefObject<Set<string>>;
+    workspaceCloudHydratedRef: import("react").RefObject<Set<string>>;
+    clearWorkspaceRetry: () => void;
+    scheduleWorkspacePullRetry: (invokePull: () => Promise<boolean>, options?: {
+        minDelayMs?: number;
+        workspaceId?: string;
+    }) => void;
+    isWorkspacePullCooldownActive: (workspaceId: string) => boolean;
+    markWorkspacePullCooldown: (workspaceId: string, minDelayMs?: number) => void;
+    tryAcquireWorkspacePullLease: (workspaceId: string) => Promise<boolean>;
+    releaseWorkspacePullLease: (workspaceId: string) => void;
+    recordWorkspaceSyncFailure: (source: "push" | "pull" | "apply" | "handshake", statusCode?: number | null) => void;
+    incrementWorkspaceSyncAuthFailure: () => void;
+    persistWorkspaceSyncPatch: (patch: Record<string, unknown>) => Promise<void>;
+    loadWorkspaceSyncState: () => Promise<void>;
+    applyWorkspaceSyncStateSnapshot: (nextState: {
+        cloudSyncEnabled: boolean;
+        sourceOfTruth?: "cloud" | "local" | null;
+        onboardingCompleted?: boolean;
+        pullCursor?: string | null;
+    }) => void;
+    syncUserGlobalSettings: (options?: {
+        preferCloudOnFirstSync?: boolean;
+    }) => Promise<void>;
+    getLocalUserSyncUpdatedAt: (userId: string) => string | null;
+    setLocalUserSyncUpdatedAt: (userId: string, updatedAt: string) => void;
+    buildUserGlobalSyncPayload: () => {
+        theme: "dark" | "light" | "midnight";
+        operatingMode: string;
+        localization: {
+            locale: "en-US" | "es-419" | "pt-BR";
+            weekStartsOn: "sunday" | "monday";
+        };
+    };
+    applyRemoteUserGlobalSyncPayload: (remote: any) => Promise<void>;
+    ensureCloudWorkspaceReadyForSync: () => Promise<{
+        success: boolean;
+        error?: string;
+        provisioned?: boolean;
+        statusCode?: number;
+        retryAfterMs?: number;
+    }>;
+    buildWorkspaceSyncPayload: () => import("../sync/workspaceSyncModel").WorkspaceSyncPayload;
+    buildWorkspaceSyncSignature: () => string;
+    refreshWorkspaceSyncDocumentsSnapshot: () => Promise<void>;
+    handleSyncAuthFailure: (source: "push" | "pull" | "apply" | "handshake", statusCode: number) => Promise<void>;
+    ensureWorkspaceSyncReady: () => Promise<boolean>;
+    pushWorkspaceChangesToCloud: (signature: string) => Promise<boolean>;
+    pullWorkspaceChangesFromCloud: () => Promise<boolean>;
+    fetchLocalWorkspaceSnapshot: () => Promise<{
+        tasks: never[];
+        archived: never[];
+        error: string;
+    } | {
+        tasks: any;
+        archived: any;
+        error?: undefined;
+    }>;
+    saveWorkspaceCloudSyncSettings: (input: {
+        enabled: boolean;
+        sourceOfTruth?: "cloud" | "local" | null;
+        onboardingCompleted?: boolean;
+    }) => Promise<{
+        success: boolean;
+        error?: string;
+    }>;
+    retryUserGlobalSettingsSync: () => Promise<void>;
+    retryWorkspaceCloudSync: () => Promise<void>;
+    resetWorkspaceSyncCursorAndPull: () => Promise<void>;
+};