@taskforcehq/taskforce 0.3.301 → 0.3.303

package/dist/sync/contentSyncState.d.ts

@@ -0,0 +1,98 @@
+import type { TaskforceCore, TaskforceSyncCapable } from '../core/Taskforce.js';
+import type { ObjectStorageClient } from '../storage/objectStorageClient.js';
+import type { WorkspaceAssetEntry, WorkspaceAssetLinkEntry, WorkspaceAssetLinkRole, WorkspaceAssetStore } from '../storage/workspaceAssetStore.js';
+import type { BinaryAssetDeleteSyncPayload, BinaryAssetSyncPayload, DocumentDeleteSyncPayload, DocumentSyncPayload } from './contentSyncPayload.js';
+type SyncCore = TaskforceCore & TaskforceSyncCapable;
+type RecordSyncDiagnostic = (workspaceId: string, eventType: 'pull' | 'push' | 'apply', errorMessage: string, details?: Record<string, unknown>) => void;
+export interface CachedWorkspaceSyncDocument {
+    path: string;
+    mtimeMs: number;
+    ctimeMs: number;
+    size: number;
+    updatedAt: string;
+    content: string;
+}
+interface ContentSyncStateDeps {
+    core: SyncCore;
+    workspaceAssetStore: WorkspaceAssetStore | null;
+    getObjectStorageClient: () => ObjectStorageClient | null;
+    normalizeWorkspaceSyncDocumentPath: (rawPath: unknown) => string | null;
+    normalizeTaskDataRelativePath: (rawPath: string) => string | null;
+    recordSyncDiagnostic: RecordSyncDiagnostic;
+    workspaceDocumentSnapshotCache: Map<string, Map<string, CachedWorkspaceSyncDocument>>;
+}
+export type DocumentSyncIndexEntry = Omit<DocumentSyncPayload, 'content'>;
+export type BinaryAssetSyncIndexEntry = Omit<BinaryAssetSyncPayload, 'contentBase64'>;
+export declare function resolveCanonicalAssetSyncLinkState(deps: ContentSyncStateDeps, asset: WorkspaceAssetEntry, workspaceId: string): {
+    primaryLink: WorkspaceAssetLinkEntry | null;
+    effectiveUpdatedAt: string;
+};
+export declare function getCanonicalSyncDocumentMetadata(deps: ContentSyncStateDeps, relativePath: string, workspaceId: string): Omit<DocumentSyncPayload, 'path' | 'updatedAt' | 'content'>;
+export declare function hasDocumentSyncMetadataDrift(deps: ContentSyncStateDeps, workspaceId: string, doc: DocumentSyncPayload, options?: {
+    allowReferenceNumberReassignment?: boolean;
+}): boolean;
+export declare function hasBinaryAssetSyncMetadataDrift(deps: ContentSyncStateDeps, workspaceId: string, asset: BinaryAssetSyncPayload, options?: {
+    allowReferenceNumberReassignment?: boolean;
+}): boolean;
+export declare function reconcileWorkspaceSyncLinks(deps: ContentSyncStateDeps, input: {
+    workspaceId: string;
+    assetId: string;
+    taskId?: string | null;
+    role?: WorkspaceAssetLinkRole | null;
+    displayName?: string | null;
+    updatedAt?: string | null;
+}): void;
+export declare function listWorkspaceSyncDocumentDeletesSnapshot(deps: ContentSyncStateDeps, workspaceId?: string): DocumentDeleteSyncPayload[];
+export declare function listWorkspaceSyncDocumentsSnapshot(deps: ContentSyncStateDeps, basePath: string, workspaceId?: string): Promise<DocumentSyncPayload[]>;
+export declare function listWorkspaceSyncDocumentIndex(deps: ContentSyncStateDeps, basePath: string, workspaceId?: string): Promise<DocumentSyncIndexEntry[]>;
+export declare function listWorkspaceSyncBinaryAssetsSnapshot(deps: ContentSyncStateDeps, basePath: string, workspaceId?: string): Promise<BinaryAssetSyncPayload[]>;
+export declare function listWorkspaceSyncBinaryAssetIndex(deps: ContentSyncStateDeps, workspaceId?: string): Promise<BinaryAssetSyncIndexEntry[]>;
+export declare function loadWorkspaceSyncDocumentPayload(deps: ContentSyncStateDeps, basePath: string, workspaceId: string, relativePath: string): Promise<DocumentSyncPayload | null>;
+export declare function loadWorkspaceSyncBinaryAssetPayload(deps: ContentSyncStateDeps, basePath: string, workspaceId: string, assetPath: string): Promise<BinaryAssetSyncPayload | null>;
+export declare function listWorkspaceSyncBinaryAssetDeletesSnapshot(deps: ContentSyncStateDeps, workspaceId?: string): BinaryAssetDeleteSyncPayload[];
+export declare function writeWorkspaceSyncDocument(deps: ContentSyncStateDeps, basePath: string, doc: DocumentSyncPayload, workspaceId?: string, options?: {
+    allowReferenceNumberReassignment?: boolean;
+}): Promise<void>;
+export declare function writeWorkspaceSyncBinaryAsset(deps: ContentSyncStateDeps, basePath: string, asset: BinaryAssetSyncPayload, workspaceId?: string, options?: {
+    allowReferenceNumberReassignment?: boolean;
+}): Promise<void>;
+export declare function deleteWorkspaceSyncBinaryAsset(deps: ContentSyncStateDeps, basePath: string, assetPath: string, workspaceId?: string): void;
+export declare function deleteWorkspaceSyncDocument(deps: ContentSyncStateDeps, basePath: string, docPath: string, workspaceId?: string): void;
+export declare function createContentSyncState(deps: ContentSyncStateDeps): {
+    resolveCanonicalAssetSyncLinkState: (asset: WorkspaceAssetEntry, workspaceId: string) => {
+        primaryLink: WorkspaceAssetLinkEntry | null;
+        effectiveUpdatedAt: string;
+    };
+    getCanonicalSyncDocumentMetadata: (relativePath: string, workspaceId: string) => Omit<DocumentSyncPayload, "path" | "updatedAt" | "content">;
+    hasDocumentSyncMetadataDrift: (workspaceId: string, doc: DocumentSyncPayload, options?: {
+        allowReferenceNumberReassignment?: boolean;
+    }) => boolean;
+    hasBinaryAssetSyncMetadataDrift: (workspaceId: string, asset: BinaryAssetSyncPayload, options?: {
+        allowReferenceNumberReassignment?: boolean;
+    }) => boolean;
+    reconcileWorkspaceSyncLinks: (input: {
+        workspaceId: string;
+        assetId: string;
+        taskId?: string | null;
+        role?: WorkspaceAssetLinkRole | null;
+        displayName?: string | null;
+        updatedAt?: string | null;
+    }) => void;
+    listWorkspaceSyncDocumentDeletesSnapshot: (workspaceId?: string) => DocumentDeleteSyncPayload[];
+    listWorkspaceSyncDocumentIndex: (basePath: string, workspaceId?: string) => Promise<DocumentSyncIndexEntry[]>;
+    listWorkspaceSyncDocumentsSnapshot: (basePath: string, workspaceId?: string) => Promise<DocumentSyncPayload[]>;
+    loadWorkspaceSyncDocumentPayload: (basePath: string, workspaceId: string, relativePath: string) => Promise<DocumentSyncPayload | null>;
+    listWorkspaceSyncBinaryAssetIndex: (workspaceId?: string) => Promise<BinaryAssetSyncIndexEntry[]>;
+    listWorkspaceSyncBinaryAssetsSnapshot: (basePath: string, workspaceId?: string) => Promise<BinaryAssetSyncPayload[]>;
+    loadWorkspaceSyncBinaryAssetPayload: (basePath: string, workspaceId: string, assetPath: string) => Promise<BinaryAssetSyncPayload | null>;
+    listWorkspaceSyncBinaryAssetDeletesSnapshot: (workspaceId?: string) => BinaryAssetDeleteSyncPayload[];
+    writeWorkspaceSyncDocument: (basePath: string, doc: DocumentSyncPayload, workspaceId?: string, options?: {
+        allowReferenceNumberReassignment?: boolean;
+    }) => Promise<void>;
+    writeWorkspaceSyncBinaryAsset: (basePath: string, asset: BinaryAssetSyncPayload, workspaceId?: string, options?: {
+        allowReferenceNumberReassignment?: boolean;
+    }) => Promise<void>;
+    deleteWorkspaceSyncBinaryAsset: (basePath: string, assetPath: string, workspaceId?: string) => void;
+    deleteWorkspaceSyncDocument: (basePath: string, docPath: string, workspaceId?: string) => void;
+};
+export {};