Align sync SDK with snapshot and workspace contracts

dist/plugin-api.d.ts

@@ -27,6 +27,8 @@ export interface PluginEvent<TPayload = Record<string, unknown>> {
 export interface SyncStatus {
     configured: boolean;
     serverUrl: string;
+    /** Remote sync scope selected during pairing. It can differ from this device's local vault UUID. */
+    vaultId: string;
     deviceId: string;
     deviceName: string;
     connected: boolean;
@@ -36,8 +38,47 @@ export interface SyncStatus {
     lastSyncAt: string;
     syncInterval: number;
     lastError: string;
+    /** A persistent unresolved scanner warning, for example an over-limit file. */
+    lastWarning: string;
     statusLabel: string;
 }
+/** Core operation-log contract. Plugins can display status but cannot create these operations. */
+export type SyncEntityType = 'file' | 'folder' | 'workspace';
+export type SyncOperationType = 'create' | 'update' | 'delete' | 'move' | 'rename' | 'trash' | 'restore';
+export interface SyncOperation {
+    opId: string;
+    serverSequence?: number;
+    deviceId: string;
+    entityType: SyncEntityType;
+    entityId: string;
+    opType: SyncOperationType;
+    payloadJson: string;
+    createdAt: string;
+    clientSequence?: number;
+    lastSeenServerSeq?: number;
+}
+export interface SyncFilePayload {
+    path: string;
+    content?: string;
+    dataBase64?: string;
+    contentHash?: string;
+    fromPath?: string;
+    toPath?: string;
+}
+export interface SyncWorkspacePayload {
+    workspaceId: string;
+    path: string;
+    previousPath?: string;
+    name: string;
+    metadata?: Record<string, unknown>;
+}
+export interface SyncSnapshotEntry {
+    path: string;
+    type: 'file' | 'folder';
+    size: number;
+    modifiedAt: string;
+    hash?: string;
+}
 export interface SyncConflict {
     op_id?: string;
     opId?: string;
@@ -133,7 +174,7 @@ export interface VerstakPluginAPI {
     };
     sync: {
         status(): Promise<SyncStatus>;
-        configure(serverUrl: string, username: string, password: string): Promise<void>;
+        configure(serverUrl: string, username: string, password: string, remoteVaultId?: string): Promise<void>;
         disconnect(): Promise<void>;
         testConnection(serverUrl: string, username: string, password: string): Promise<void>;
         setInterval(minutes: number): Promise<void>;

dist/plugin-api.js.map

@@ -1 +1 @@
-{"version":3,"file":"plugin-api.js","sourceRoot":"","sources":["../src/plugin-api.ts"],"names":[],"mappings":"AAAA,6DAA6D;AAC7D,EAAE;AACF,8EAA8E;AAC9E,gFAAgF;AAChF,8EAA8E;AAC9E,gDAAgD;AA8LhD,MAAM,UAAU,eAAe,CAAC,SAAiB;IAC/C,MAAM,IAAI,KAAK,CAAC,kEAAkE,CAAC,CAAC;AACtF,CAAC"}
+{"version":3,"file":"plugin-api.js","sourceRoot":"","sources":["../src/plugin-api.ts"],"names":[],"mappings":"AAAA,6DAA6D;AAC7D,EAAE;AACF,8EAA8E;AAC9E,gFAAgF;AAChF,8EAA8E;AAC9E,gDAAgD;AA4OhD,MAAM,UAAU,eAAe,CAAC,SAAiB;IAC/C,MAAM,IAAI,KAAK,CAAC,kEAAkE,CAAC,CAAC;AACtF,CAAC"}

dist/test-utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"test-utils.d.ts","sourceRoot":"","sources":["../src/test-utils.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,4BAA4B,EAAE,MAAM,SAAS,CAAC;AACzF,OAAO,KAAK,EAAwB,YAAY,EAAqB,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAQ5G,MAAM,WAAW,oBAAoB;IACnC,aAAa,CAAC,EAAE,4BAA4B,CAAC;IAC7C,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,aAAa,CAAC,EAAE,YAAY,CAAC;IAC7B,QAAQ,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;CAClE;AASD;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,GAAG,cAAc,CAetF;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,GAAG,WAAW,CASnF;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,SAAgB,EAAE,OAAO,GAAE,oBAAyB,GAAG,gBAAgB,CA0XlH;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,OAAO,GAAG;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAgCxF;AAGD,OAAO,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAAE,EAAE,EAAE,CAAC"}
+{"version":3,"file":"test-utils.d.ts","sourceRoot":"","sources":["../src/test-utils.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,4BAA4B,EAAE,MAAM,SAAS,CAAC;AACzF,OAAO,KAAK,EAAwB,YAAY,EAAqB,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAQ5G,MAAM,WAAW,oBAAoB;IACnC,aAAa,CAAC,EAAE,4BAA4B,CAAC;IAC7C,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,aAAa,CAAC,EAAE,YAAY,CAAC;IAC7B,QAAQ,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;CAClE;AASD;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,GAAG,cAAc,CAetF;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,GAAG,WAAW,CASnF;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,SAAgB,EAAE,OAAO,GAAE,oBAAyB,GAAG,gBAAgB,CA4XlH;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,OAAO,GAAG;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAgCxF;AAGD,OAAO,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAAE,EAAE,EAAE,CAAC"}

dist/test-utils.js

@@ -421,6 +421,7 @@ export function createMockPluginAPI(pluginId = 'test.plugin', options = {}) {
             status: vi.fn(async () => ({
                 configured: false,
                 serverUrl: '',
+                vaultId: '',
                 deviceId: '',
                 deviceName: '',
                 connected: false,
@@ -430,6 +431,7 @@ export function createMockPluginAPI(pluginId = 'test.plugin', options = {}) {
                 lastSyncAt: '',
                 syncInterval: 0,
                 lastError: '',
+                lastWarning: '',
                 statusLabel: 'disabled',
             })),
             configure: vi.fn(async () => { }),