@talex-touch/utils 1.0.42 → 1.0.44

package/.eslintcache

@@ -0,0 +1 @@
+[{"/Users/talexdreamsoul/Workspace/Projects/talex-touch/packages/utils/__tests__/transport-domain-sdks.test.ts":"1","/Users/talexdreamsoul/Workspace/Projects/talex-touch/packages/utils/cloud-sync/cloud-sync-sdk.ts":"2","/Users/talexdreamsoul/Workspace/Projects/talex-touch/packages/utils/common/utils/index.ts":"3","/Users/talexdreamsoul/Workspace/Projects/talex-touch/packages/utils/common/utils/safe-path.ts":"4","/Users/talexdreamsoul/Workspace/Projects/talex-touch/packages/utils/common/utils/safe-shell.ts":"5","/Users/talexdreamsoul/Workspace/Projects/talex-touch/packages/utils/electron/env-tool.ts":"6","/Users/talexdreamsoul/Workspace/Projects/talex-touch/packages/utils/i18n/message-keys.ts":"7","/Users/talexdreamsoul/Workspace/Projects/talex-touch/packages/utils/permission/index.ts":"8","/Users/talexdreamsoul/Workspace/Projects/talex-touch/packages/utils/permission/registry.ts":"9","/Users/talexdreamsoul/Workspace/Projects/talex-touch/packages/utils/permission/types.ts":"10","/Users/talexdreamsoul/Workspace/Projects/talex-touch/packages/utils/plugin/sdk/cloud-sync.ts":"11","/Users/talexdreamsoul/Workspace/Projects/talex-touch/packages/utils/renderer/storage/base-storage.ts":"12","/Users/talexdreamsoul/Workspace/Projects/talex-touch/packages/utils/renderer/storage/intelligence-storage.ts":"13","/Users/talexdreamsoul/Workspace/Projects/talex-touch/packages/utils/transport/sdk/domains/intelligence.ts":"14","/Users/talexdreamsoul/Workspace/Projects/talex-touch/packages/utils/types/cloud-sync.ts":"15","/Users/talexdreamsoul/Workspace/Projects/talex-touch/packages/utils/types/intelligence.ts":"16","/Users/talexdreamsoul/Workspace/Projects/talex-touch/packages/utils/types/update.ts":"17","/Users/talexdreamsoul/Workspace/Projects/talex-touch/packages/utils/transport/events/types/flow.ts":"18","/Users/talexdreamsoul/Workspace/Projects/talex-touch/packages/utils/core-box/recommendation.ts":"19","/Users/talexdreamsoul/Workspace/Projects/talex-touch/packages/utils/plugin/sdk/index.ts":"20","/Users/talexdreamsoul/Workspace/Projects/talex-touch/packages/utils/plugin/sdk/recommend.ts":"21","/Users/talexdreamsoul/Workspace/Projects/talex-touch/packages/utils/plugin/sdk/types.ts":"22","/Users/talexdreamsoul/Workspace/Projects/talex-touch/packages/utils/common/utils/polling.ts":"23","/Users/talexdreamsoul/Workspace/Projects/talex-touch/packages/utils/transport/events/index.ts":"24","/Users/talexdreamsoul/Workspace/Projects/talex-touch/packages/utils/transport/events/types/file-index.ts":"25","/Users/talexdreamsoul/Workspace/Projects/talex-touch/packages/utils/transport/sdk/domains/settings.ts":"26","/Users/talexdreamsoul/Workspace/Projects/talex-touch/packages/utils/intelligence/client.ts":"27","/Users/talexdreamsoul/Workspace/Projects/talex-touch/packages/utils/plugin/index.ts":"28","/Users/talexdreamsoul/Workspace/Projects/talex-touch/packages/utils/types/index.ts":"29","/Users/talexdreamsoul/Workspace/Projects/talex-touch/packages/utils/types/path-browserify.d.ts":"30","/Users/talexdreamsoul/Workspace/Projects/talex-touch/packages/utils/transport/events/types/core-box.ts":"31"},{"size":5306,"mtime":1771563102452,"results":"32","hashOfConfig":"33"},{"size":15379,"mtime":1771563102455,"results":"34","hashOfConfig":"33"},{"size":5659,"mtime":1771563102455,"results":"35","hashOfConfig":"33"},{"size":2691,"mtime":1771563102456,"results":"36","hashOfConfig":"33"},{"size":2879,"mtime":1771563102456,"results":"37","hashOfConfig":"33"},{"size":2472,"mtime":1771563102458,"results":"38","hashOfConfig":"33"},{"size":7760,"mtime":1771563102481,"results":"39","hashOfConfig":"33"},{"size":4206,"mtime":1771563102484,"results":"40","hashOfConfig":"33"},{"size":7775,"mtime":1771563102484,"results":"41","hashOfConfig":"33"},{"size":3423,"mtime":1771563102493,"results":"42","hashOfConfig":"33"},{"size":3750,"mtime":1771563102509,"results":"43","hashOfConfig":"33"},{"size":26935,"mtime":1771563102511,"results":"44","hashOfConfig":"33"},{"size":6457,"mtime":1771563102514,"results":"45","hashOfConfig":"33"},{"size":21154,"mtime":1771563102519,"results":"46","hashOfConfig":"33"},{"size":3091,"mtime":1771563102519,"results":"47","hashOfConfig":"33"},{"size":55314,"mtime":1771563102519,"results":"48","hashOfConfig":"33"},{"size":6327,"mtime":1771566199653,"results":"49","hashOfConfig":"50"},{"size":2888,"mtime":1771563689317,"results":"51","hashOfConfig":"33"},{"size":3003,"mtime":1771611450129,"results":"52","hashOfConfig":"50"},{"size":986,"mtime":1771611509397,"results":"53","hashOfConfig":"50"},{"size":683,"mtime":1771611477506,"results":"54","hashOfConfig":"50"},{"size":26106,"mtime":1771611536284,"results":"55","hashOfConfig":"50"},{"size":11083,"mtime":1771632074503,"results":"56","hashOfConfig":"50"},{"size":74191,"mtime":1771632883663,"results":"57","hashOfConfig":"50"},{"size":1560,"mtime":1771632863820,"results":"58","hashOfConfig":"50"},{"size":4093,"mtime":1771632913471,"results":"59","hashOfConfig":"50"},{"size":3327,"mtime":1771678966584,"results":"60","hashOfConfig":"50"},{"size":18271,"mtime":1771679568421,"results":"61","hashOfConfig":"50"},{"size":329,"mtime":1771678957747,"results":"62","hashOfConfig":"50"},{"size":135,"mtime":1771678957747,"results":"63","hashOfConfig":"64"},{"size":9317,"mtime":1771684543626,"results":"65","hashOfConfig":"50"},{"filePath":"66","messages":"67","suppressedMessages":"68","errorCount":0,"fatalErrorCount":0,"warningCount":0,"fixableErrorCount":0,"fixableWarningCount":0},"tyugd7",{"filePath":"69","messages":"70","suppressedMessages":"71","errorCount":0,"fatalErrorCount":0,"warningCount":0,"fixableErrorCount":0,"fixableWarningCount":0},{"filePath":"72","messages":"73","suppressedMessages":"74","errorCount":0,"fatalErrorCount":0,"warningCount":0,"fixableErrorCount":0,"fixableWarningCount":0},{"filePath":"75","messages":"76","suppressedMessages":"77","errorCount":0,"fatalErrorCount":0,"warningCount":0,"fixableErrorCount":0,"fixableWarningCount":0},{"filePath":"78","messages":"79","suppressedMessages":"80","errorCount":0,"fatalErrorCount":0,"warningCount":0,"fixableErrorCount":0,"fixableWarningCount":0},{"filePath":"81","messages":"82","suppressedMessages":"83","errorCount":0,"fatalErrorCount":0,"warningCount":0,"fixableErrorCount":0,"fixableWarningCount":0},{"filePath":"84","messages":"85","suppressedMessages":"86","errorCount":0,"fatalErrorCount":0,"warningCount":0,"fixableErrorCount":0,"fixableWarningCount":0},{"filePath":"87","messages":"88","suppressedMessages":"89","errorCount":0,"fatalErrorCount":0,"warningCount":0,"fixableErrorCount":0,"fixableWarningCount":0},{"filePath":"90","messages":"91","suppressedMessages":"92","errorCount":0,"fatalErrorCount":0,"warningCount":0,"fixableErrorCount":0,"fixableWarningCount":0},{"filePath":"93","messages":"94","suppressedMessages":"95","errorCount":0,"fatalErrorCount":0,"warningCount":0,"fixableErrorCount":0,"fixableWarningCount":0},{"filePath":"96","messages":"97","suppressedMessages":"98","errorCount":0,"fatalErrorCount":0,"warningCount":0,"fixableErrorCount":0,"fixableWarningCount":0},{"filePath":"99","messages":"100","suppressedMessages":"101","errorCount":0,"fatalErrorCount":0,"warningCount":0,"fixableErrorCount":0,"fixableWarningCount":0},{"filePath":"102","messages":"103","suppressedMessages":"104","errorCount":0,"fatalErrorCount":0,"warningCount":0,"fixableErrorCount":0,"fixableWarningCount":0},{"filePath":"105","messages":"106","suppressedMessages":"107","errorCount":0,"fatalErrorCount":0,"warningCount":0,"fixableErrorCount":0,"fixableWarningCount":0},{"filePath":"108","messages":"109","suppressedMessages":"110","errorCount":0,"fatalErrorCount":0,"warningCount":0,"fixableErrorCount":0,"fixableWarningCount":0},{"filePath":"111","messages":"112","suppressedMessages":"113","errorCount":0,"fatalErrorCount":0,"warningCount":0,"fixableErrorCount":0,"fixableWarningCount":0},{"filePath":"114","messages":"115","suppressedMessages":"116","errorCount":0,"fatalErrorCount":0,"warningCount":0,"fixableErrorCount":0,"fixableWarningCount":0},"m7p77f",{"filePath":"117","messages":"118","suppressedMessages":"119","errorCount":0,"fatalErrorCount":0,"warningCount":0,"fixableErrorCount":0,"fixableWarningCount":0},{"filePath":"120","messages":"121","suppressedMessages":"122","errorCount":0,"fatalErrorCount":0,"warningCount":0,"fixableErrorCount":0,"fixableWarningCount":0},{"filePath":"123","messages":"124","suppressedMessages":"125","errorCount":0,"fatalErrorCount":0,"warningCount":0,"fixableErrorCount":0,"fixableWarningCount":0},{"filePath":"126","messages":"127","suppressedMessages":"128","errorCount":0,"fatalErrorCount":0,"warningCount":0,"fixableErrorCount":0,"fixableWarningCount":0},{"filePath":"129","messages":"130","suppressedMessages":"131","errorCount":0,"fatalErrorCount":0,"warningCount":0,"fixableErrorCount":0,"fixableWarningCount":0},{"filePath":"132","messages":"133","suppressedMessages":"134","errorCount":0,"fatalErrorCount":0,"warningCount":0,"fixableErrorCount":0,"fixableWarningCount":0},{"filePath":"135","messages":"136","suppressedMessages":"137","errorCount":0,"fatalErrorCount":0,"warningCount":0,"fixableErrorCount":0,"fixableWarningCount":0},{"filePath":"138","messages":"139","suppressedMessages":"140","errorCount":0,"fatalErrorCount":0,"warningCount":0,"fixableErrorCount":0,"fixableWarningCount":0},{"filePath":"141","messages":"142","suppressedMessages":"143","errorCount":0,"fatalErrorCount":0,"warningCount":0,"fixableErrorCount":0,"fixableWarningCount":0},{"filePath":"144","messages":"145","suppressedMessages":"146","errorCount":0,"fatalErrorCount":0,"warningCount":0,"fixableErrorCount":0,"fixableWarningCount":0},{"filePath":"147","messages":"148","suppressedMessages":"149","errorCount":0,"fatalErrorCount":0,"warningCount":0,"fixableErrorCount":0,"fixableWarningCount":0},{"filePath":"150","messages":"151","suppressedMessages":"152","errorCount":0,"fatalErrorCount":0,"warningCount":0,"fixableErrorCount":0,"fixableWarningCount":0},{"filePath":"153","messages":"154","suppressedMessages":"155","errorCount":0,"fatalErrorCount":0,"warningCount":0,"fixableErrorCount":0,"fixableWarningCount":0},"552fw",{"filePath":"156","messages":"157","suppressedMessages":"158","errorCount":0,"fatalErrorCount":0,"warningCount":0,"fixableErrorCount":0,"fixableWarningCount":0},"/Users/talexdreamsoul/Workspace/Projects/talex-touch/packages/utils/__tests__/transport-domain-sdks.test.ts",[],[],"/Users/talexdreamsoul/Workspace/Projects/talex-touch/packages/utils/cloud-sync/cloud-sync-sdk.ts",[],[],"/Users/talexdreamsoul/Workspace/Projects/talex-touch/packages/utils/common/utils/index.ts",[],[],"/Users/talexdreamsoul/Workspace/Projects/talex-touch/packages/utils/common/utils/safe-path.ts",[],[],"/Users/talexdreamsoul/Workspace/Projects/talex-touch/packages/utils/common/utils/safe-shell.ts",[],[],"/Users/talexdreamsoul/Workspace/Projects/talex-touch/packages/utils/electron/env-tool.ts",[],[],"/Users/talexdreamsoul/Workspace/Projects/talex-touch/packages/utils/i18n/message-keys.ts",[],[],"/Users/talexdreamsoul/Workspace/Projects/talex-touch/packages/utils/permission/index.ts",[],[],"/Users/talexdreamsoul/Workspace/Projects/talex-touch/packages/utils/permission/registry.ts",[],[],"/Users/talexdreamsoul/Workspace/Projects/talex-touch/packages/utils/permission/types.ts",[],[],"/Users/talexdreamsoul/Workspace/Projects/talex-touch/packages/utils/plugin/sdk/cloud-sync.ts",[],[],"/Users/talexdreamsoul/Workspace/Projects/talex-touch/packages/utils/renderer/storage/base-storage.ts",[],[],"/Users/talexdreamsoul/Workspace/Projects/talex-touch/packages/utils/renderer/storage/intelligence-storage.ts",[],[],"/Users/talexdreamsoul/Workspace/Projects/talex-touch/packages/utils/transport/sdk/domains/intelligence.ts",[],[],"/Users/talexdreamsoul/Workspace/Projects/talex-touch/packages/utils/types/cloud-sync.ts",[],[],"/Users/talexdreamsoul/Workspace/Projects/talex-touch/packages/utils/types/intelligence.ts",[],[],"/Users/talexdreamsoul/Workspace/Projects/talex-touch/packages/utils/types/update.ts",[],[],"/Users/talexdreamsoul/Workspace/Projects/talex-touch/packages/utils/transport/events/types/flow.ts",[],[],"/Users/talexdreamsoul/Workspace/Projects/talex-touch/packages/utils/core-box/recommendation.ts",[],[],"/Users/talexdreamsoul/Workspace/Projects/talex-touch/packages/utils/plugin/sdk/index.ts",[],[],"/Users/talexdreamsoul/Workspace/Projects/talex-touch/packages/utils/plugin/sdk/recommend.ts",[],[],"/Users/talexdreamsoul/Workspace/Projects/talex-touch/packages/utils/plugin/sdk/types.ts",[],[],"/Users/talexdreamsoul/Workspace/Projects/talex-touch/packages/utils/common/utils/polling.ts",[],[],"/Users/talexdreamsoul/Workspace/Projects/talex-touch/packages/utils/transport/events/index.ts",[],[],"/Users/talexdreamsoul/Workspace/Projects/talex-touch/packages/utils/transport/events/types/file-index.ts",[],[],"/Users/talexdreamsoul/Workspace/Projects/talex-touch/packages/utils/transport/sdk/domains/settings.ts",[],[],"/Users/talexdreamsoul/Workspace/Projects/talex-touch/packages/utils/intelligence/client.ts",[],[],"/Users/talexdreamsoul/Workspace/Projects/talex-touch/packages/utils/plugin/index.ts",[],[],"/Users/talexdreamsoul/Workspace/Projects/talex-touch/packages/utils/types/index.ts",[],[],"/Users/talexdreamsoul/Workspace/Projects/talex-touch/packages/utils/types/path-browserify.d.ts",[],[],"/Users/talexdreamsoul/Workspace/Projects/talex-touch/packages/utils/transport/events/types/core-box.ts",[],[]]

package/__tests__/cloud-sync-sdk.test.ts

@@ -0,0 +1,442 @@
+import { describe, expect, it, vi } from 'vitest'
+import { accountSDK } from '../account'
+import { CloudSyncError, CloudSyncSDK } from '../cloud-sync/cloud-sync-sdk'
+import { CloudSyncSDK as PluginCloudSyncSDK } from '../plugin/sdk/cloud-sync'
+import type { SyncItemInput } from '../types/cloud-sync'
+
+const createJsonResponse = (payload: unknown, status = 200) => new Response(
+  JSON.stringify(payload),
+  {
+    status,
+    headers: { 'content-type': 'application/json' },
+  },
+)
+
+const createBinaryResponse = (payload: Uint8Array, status = 200, headers?: Record<string, string>) => new Response(
+  new Uint8Array(payload).buffer,
+  {
+    status,
+    headers: { 'content-type': 'application/octet-stream', ...(headers ?? {}) },
+  },
+)
+
+describe('CloudSyncSDK', () => {
+  it('handshakes and attaches sync token for push', async () => {
+    const fetchMock = vi.fn(async (input: RequestInfo | URL, init?: RequestInit) => {
+      const url = String(input)
+      if (url.endsWith('/api/v1/sync/handshake')) {
+        return createJsonResponse({
+          sync_token: 'sync-1',
+          sync_token_expires_at: '2099-01-01T00:00:00.000Z',
+          server_cursor: 0,
+          device_id: 'device-1',
+          quotas: {
+            limits: { storage_limit_bytes: 100, object_limit: 10, item_limit: 5, device_limit: 3 },
+            usage: { used_storage_bytes: 0, used_objects: 0, used_devices: 1 },
+          },
+        })
+      }
+      if (url.endsWith('/api/v1/sync/push')) {
+        const headers = new Headers(init?.headers as HeadersInit)
+        expect(headers.get('x-device-id')).toBe('device-1')
+        expect(headers.get('x-sync-token')).toBe('sync-1')
+        return createJsonResponse({ ack_cursor: 1, conflicts: [] })
+      }
+      return createJsonResponse({}, 404)
+    })
+
+    const cache: { token?: string, expiresAt?: string } = {}
+    const sdk = new CloudSyncSDK({
+      baseUrl: 'https://example.com',
+      getAuthToken: () => 'auth-1',
+      getDeviceId: () => 'device-1',
+      fetch: fetchMock as any,
+      syncTokenCache: cache,
+      now: () => 0,
+    })
+
+    const item: SyncItemInput = {
+      item_id: 'note-1',
+      type: 'note',
+      schema_version: 1,
+      payload_enc: 'enc',
+      payload_ref: null,
+      meta_plain: { title: 'hello' },
+      payload_size: 10,
+      updated_at: '2026-02-04T00:00:00.000Z',
+      deleted_at: null,
+      op_seq: 1,
+      op_hash: 'hash-1',
+      op_type: 'upsert',
+    }
+
+    const result = await sdk.push([item])
+    expect(result.ack_cursor).toBe(1)
+    expect(cache.token).toBe('sync-1')
+    expect(fetchMock).toHaveBeenCalledTimes(2)
+  })
+
+  it('throws CloudSyncError when response has errorCode', async () => {
+    const fetchMock = vi.fn(async (input: RequestInfo | URL, _init?: RequestInit) => {
+      const url = String(input)
+      if (url.endsWith('/api/v1/sync/handshake')) {
+        return createJsonResponse({
+          sync_token: 'sync-2',
+          sync_token_expires_at: '2099-01-01T00:00:00.000Z',
+          server_cursor: 0,
+          device_id: 'device-2',
+          quotas: {
+            limits: { storage_limit_bytes: 100, object_limit: 10, item_limit: 5, device_limit: 3 },
+            usage: { used_storage_bytes: 0, used_objects: 0, used_devices: 1 },
+          },
+        })
+      }
+      if (url.endsWith('/api/v1/sync/push')) {
+        return createJsonResponse({ errorCode: 'SYNC_INVALID_PAYLOAD' }, 400)
+      }
+      return createJsonResponse({}, 404)
+    })
+
+    const sdk = new CloudSyncSDK({
+      serviceBaseUrl: 'https://example.com',
+      getAuthToken: () => 'auth-2',
+      getDeviceId: () => 'device-2',
+      fetch: fetchMock as any,
+    })
+
+    const item: SyncItemInput = {
+      item_id: 'note-2',
+      type: 'note',
+      schema_version: 1,
+      payload_enc: 'enc',
+      payload_ref: null,
+      meta_plain: null,
+      payload_size: 10,
+      updated_at: '2026-02-04T00:00:00.000Z',
+      deleted_at: null,
+      op_seq: 1,
+      op_hash: 'hash-2',
+      op_type: 'upsert',
+    }
+
+    await expect(sdk.push([item])).rejects.toBeInstanceOf(CloudSyncError)
+  })
+
+  it('plugin sdk resolves auth/device via accountSDK', async () => {
+    const fetchMock = vi.fn(async (input: RequestInfo | URL, init?: RequestInit) => {
+      const url = String(input)
+      if (url.endsWith('/api/v1/sync/handshake')) {
+        const headers = new Headers(init?.headers as HeadersInit)
+        expect(headers.get('authorization')).toBe('Bearer auth-3')
+        expect(headers.get('x-device-id')).toBe('device-3')
+        return createJsonResponse({
+          sync_token: 'sync-3',
+          sync_token_expires_at: '2099-01-01T00:00:00.000Z',
+          server_cursor: 0,
+          device_id: 'device-3',
+          quotas: {
+            limits: { storage_limit_bytes: 100, object_limit: 10, item_limit: 5, device_limit: 3 },
+            usage: { used_storage_bytes: 0, used_objects: 0, used_devices: 1 },
+          },
+        })
+      }
+      if (url.endsWith('/api/v1/sync/push')) {
+        const headers = new Headers(init?.headers as HeadersInit)
+        expect(headers.get('authorization')).toBe('Bearer auth-3')
+        expect(headers.get('x-device-id')).toBe('device-3')
+        expect(headers.get('x-sync-token')).toBe('sync-3')
+        return createJsonResponse({ ack_cursor: 1, conflicts: [] })
+      }
+      return createJsonResponse({}, 404)
+    })
+
+    const authSpy = vi.spyOn(accountSDK, 'getAuthToken').mockResolvedValue('auth-3')
+    const deviceSpy = vi.spyOn(accountSDK, 'getDeviceId').mockResolvedValue('device-3')
+    const recordSpy = vi.spyOn(accountSDK, 'recordSyncActivity').mockResolvedValue()
+
+    const sdk = new PluginCloudSyncSDK({
+      baseUrl: 'https://example.com',
+      fetch: fetchMock as any,
+      channelSend: vi.fn(async () => null),
+      now: () => 0,
+    })
+
+    const item: SyncItemInput = {
+      item_id: 'note-3',
+      type: 'note',
+      schema_version: 1,
+      payload_enc: 'enc',
+      payload_ref: null,
+      meta_plain: { title: 'plugin' },
+      payload_size: 10,
+      updated_at: '2026-02-04T00:00:00.000Z',
+      deleted_at: null,
+      op_seq: 1,
+      op_hash: 'hash-3',
+      op_type: 'upsert',
+    }
+
+    await sdk.push([item])
+    expect(authSpy).toHaveBeenCalled()
+    expect(deviceSpy).toHaveBeenCalled()
+    expect(recordSpy).toHaveBeenCalledWith('push')
+
+    authSpy.mockRestore()
+    deviceSpy.mockRestore()
+    recordSpy.mockRestore()
+  })
+
+  it('plugin sdk records pull activity', async () => {
+    const fetchMock = vi.fn(async (input: RequestInfo | URL, init?: RequestInit) => {
+      const url = String(input)
+      if (url.endsWith('/api/v1/sync/handshake')) {
+        return createJsonResponse({
+          sync_token: 'sync-3-pull',
+          sync_token_expires_at: '2099-01-01T00:00:00.000Z',
+          server_cursor: 0,
+          device_id: 'device-3',
+          quotas: {
+            limits: { storage_limit_bytes: 100, object_limit: 10, item_limit: 5, device_limit: 3 },
+            usage: { used_storage_bytes: 0, used_objects: 0, used_devices: 1 },
+          },
+        })
+      }
+      if (url.includes('/api/v1/sync/pull')) {
+        const headers = new Headers(init?.headers as HeadersInit)
+        expect(headers.get('x-sync-token')).toBe('sync-3-pull')
+        return createJsonResponse({ items: [], oplog: [], next_cursor: 0 })
+      }
+      return createJsonResponse({}, 404)
+    })
+
+    const authSpy = vi.spyOn(accountSDK, 'getAuthToken').mockResolvedValue('auth-3')
+    const deviceSpy = vi.spyOn(accountSDK, 'getDeviceId').mockResolvedValue('device-3')
+    const recordSpy = vi.spyOn(accountSDK, 'recordSyncActivity').mockResolvedValue()
+
+    const sdk = new PluginCloudSyncSDK({
+      baseUrl: 'https://example.com',
+      fetch: fetchMock as any,
+      channelSend: vi.fn(async () => null),
+    })
+
+    await sdk.pull({ cursor: 0, limit: 20 })
+    expect(authSpy).toHaveBeenCalled()
+    expect(deviceSpy).toHaveBeenCalled()
+    expect(recordSpy).toHaveBeenCalledWith('pull')
+
+    authSpy.mockRestore()
+    deviceSpy.mockRestore()
+    recordSpy.mockRestore()
+  })
+
+  it('plugin sdk blocks sync requests when user disabled sync preference', async () => {
+    const fetchMock = vi.fn(async () => createJsonResponse({}, 200))
+    const authSpy = vi.spyOn(accountSDK, 'getAuthToken').mockResolvedValue('auth-disabled')
+    const deviceSpy = vi.spyOn(accountSDK, 'getDeviceId').mockResolvedValue('device-disabled')
+    const syncEnabledSpy = vi.spyOn(accountSDK, 'getSyncEnabled').mockResolvedValue(false)
+
+    const sdk = new PluginCloudSyncSDK({
+      baseUrl: 'https://example.com',
+      fetch: fetchMock as any,
+      channelSend: vi.fn(async () => null),
+      now: () => 0,
+    })
+
+    const item: SyncItemInput = {
+      item_id: 'note-disabled',
+      type: 'note',
+      schema_version: 1,
+      payload_enc: 'enc',
+      payload_ref: null,
+      meta_plain: { title: 'disabled' },
+      payload_size: 10,
+      updated_at: '2026-02-12T00:00:00.000Z',
+      deleted_at: null,
+      op_seq: 1,
+      op_hash: 'hash-disabled',
+      op_type: 'upsert',
+    }
+
+    await expect(sdk.push([item])).rejects.toBeInstanceOf(CloudSyncError)
+    expect(fetchMock).not.toHaveBeenCalled()
+    expect(authSpy).not.toHaveBeenCalled()
+    expect(deviceSpy).not.toHaveBeenCalled()
+
+    syncEnabledSpy.mockRestore()
+    authSpy.mockRestore()
+    deviceSpy.mockRestore()
+  })
+
+  it('downloads blob as binary and keeps sync token header', async () => {
+    const fetchMock = vi.fn(async (input: RequestInfo | URL, init?: RequestInit) => {
+      const url = String(input)
+      if (url.endsWith('/api/v1/sync/handshake')) {
+        return createJsonResponse({
+          sync_token: 'sync-4',
+          sync_token_expires_at: '2099-01-01T00:00:00.000Z',
+          server_cursor: 0,
+          device_id: 'device-4',
+          quotas: {
+            limits: { storage_limit_bytes: 100, object_limit: 10, item_limit: 5, device_limit: 3 },
+            usage: { used_storage_bytes: 0, used_objects: 0, used_devices: 1 },
+          },
+        })
+      }
+      if (url.endsWith('/api/v1/sync/blobs/blob-1/download')) {
+        const headers = new Headers(init?.headers as HeadersInit)
+        expect(headers.get('x-sync-token')).toBe('sync-4')
+        return createBinaryResponse(
+          new TextEncoder().encode('hello'),
+          200,
+          { 'x-content-sha256': 'sha-1', 'content-length': '5' },
+        )
+      }
+      return createJsonResponse({}, 404)
+    })
+
+    const sdk = new CloudSyncSDK({
+      baseUrl: 'https://example.com',
+      getAuthToken: () => 'auth-4',
+      getDeviceId: () => 'device-4',
+      fetch: fetchMock as any,
+      now: () => 0,
+    })
+
+    const blob = await sdk.downloadBlob('blob-1')
+    expect(blob.sha256).toBe('sha-1')
+    expect(blob.sizeBytes).toBe(5)
+    expect(new TextDecoder().decode(blob.data)).toBe('hello')
+  })
+
+  it('calls keys and device attest apis without sync token', async () => {
+    const fetchMock = vi.fn(async (input: RequestInfo | URL, init?: RequestInit) => {
+      const url = String(input)
+      if (url.endsWith('/api/v1/keys/list')) {
+        const headers = new Headers(init?.headers as HeadersInit)
+        expect(headers.get('x-sync-token')).toBeNull()
+        return createJsonResponse({
+          keyrings: [
+            {
+              keyring_id: 'k1',
+              device_id: 'd1',
+              key_type: 'uk',
+              rotated_at: null,
+              created_at: '2026-02-04T00:00:00.000Z',
+              has_recovery_code: true,
+            },
+          ],
+        })
+      }
+      if (url.endsWith('/api/v1/keys/issue-device')) {
+        return createJsonResponse({ keyring_id: 'k2' })
+      }
+      if (url.endsWith('/api/v1/keys/recover-device')) {
+        return createJsonResponse({
+          keyrings: [
+            {
+              keyring_id: 'k3',
+              device_id: 'd2',
+              key_type: 'uk',
+              encrypted_key: 'enc',
+              rotated_at: null,
+              created_at: '2026-02-04T00:00:00.000Z',
+            },
+          ],
+        })
+      }
+      if (url.endsWith('/api/v1/devices/attest')) {
+        return createJsonResponse({ ok: true, device_id: 'd1', updated_at: '2026-02-04T00:00:00.000Z' })
+      }
+      return createJsonResponse({}, 404)
+    })
+
+    const sdk = new CloudSyncSDK({
+      baseUrl: 'https://example.com',
+      getAuthToken: () => 'auth-5',
+      getDeviceId: () => 'device-5',
+      fetch: fetchMock as any,
+    })
+
+    const keyrings = await sdk.listKeyrings()
+    expect(keyrings).toHaveLength(1)
+
+    const issued = await sdk.issueDeviceKey({
+      target_device_id: 'd1',
+      key_type: 'uk',
+      encrypted_key: 'enc',
+      recovery_code_hash: 'rc',
+    })
+    expect(issued.keyring_id).toBe('k2')
+
+    const recovered = await sdk.recoverDevice({ recovery_code: 'rc' })
+    expect(recovered).toHaveLength(1)
+
+    const attested = await sdk.attestDevice({ machine_code_hash: 'mc' })
+    expect(attested.ok).toBe(true)
+  })
+
+  it('retries sensitive keys api with step-up callback token', async () => {
+    let issueCalls = 0
+    let recoverCalls = 0
+    const fetchMock = vi.fn(async (input: RequestInfo | URL, init?: RequestInit) => {
+      const url = String(input)
+      if (url.endsWith('/api/v1/keys/issue-device')) {
+        issueCalls += 1
+        const headers = new Headers(init?.headers as HeadersInit)
+        const loginToken = headers.get('x-login-token')
+        if (!loginToken) {
+          return createJsonResponse({ errorCode: 'DEVICE_NOT_AUTHORIZED', message: 'MF2A required' }, 403)
+        }
+        expect(loginToken).toBe('step-up-token')
+        return createJsonResponse({ keyring_id: 'k4' })
+      }
+
+      if (url.endsWith('/api/v1/keys/recover-device')) {
+        recoverCalls += 1
+        const headers = new Headers(init?.headers as HeadersInit)
+        const loginToken = headers.get('x-login-token')
+        if (!loginToken) {
+          return createJsonResponse({ errorCode: 'DEVICE_NOT_AUTHORIZED', message: 'MF2A required' }, 403)
+        }
+        expect(loginToken).toBe('step-up-token')
+        return createJsonResponse({
+          keyrings: [
+            {
+              keyring_id: 'k5',
+              device_id: 'd5',
+              key_type: 'uk',
+              encrypted_key: 'enc',
+              rotated_at: null,
+              created_at: '2026-02-04T00:00:00.000Z',
+            },
+          ],
+        })
+      }
+
+      return createJsonResponse({}, 404)
+    })
+
+    const onStepUpRequired = vi.fn(async () => 'step-up-token')
+    const sdk = new CloudSyncSDK({
+      baseUrl: 'https://example.com',
+      getAuthToken: () => 'auth-6',
+      getDeviceId: () => 'device-6',
+      fetch: fetchMock as any,
+      onStepUpRequired,
+    })
+
+    const issued = await sdk.issueDeviceKey({
+      target_device_id: 'd5',
+      key_type: 'uk',
+      encrypted_key: 'enc',
+    })
+    expect(issued.keyring_id).toBe('k4')
+
+    const recovered = await sdk.recoverDevice({ recovery_code: 'rc-1' })
+    expect(recovered).toHaveLength(1)
+
+    expect(onStepUpRequired).toHaveBeenCalledTimes(2)
+    expect(issueCalls).toBe(2)
+    expect(recoverCalls).toBe(2)
+  })
+})

package/__tests__/icons/icons.test.ts

@@ -0,0 +1,84 @@
+import { describe, expect, it } from 'vitest'
+
+import { AppIcons, classIcon, getIcon, TuffIcons } from '../../icons'
+
+describe('tuffIcons', () => {
+  it('should have common icons defined', () => {
+    expect(TuffIcons.Search).toBe('i-ri-search-line')
+    expect(TuffIcons.Settings).toBe('i-ri-settings-3-line')
+    expect(TuffIcons.Home).toBe('i-ri-home-line')
+    expect(TuffIcons.User).toBe('i-ri-user-line')
+  })
+
+  it('should have navigation icons', () => {
+    expect(TuffIcons.Back).toBe('i-ri-arrow-left-line')
+    expect(TuffIcons.Forward).toBe('i-ri-arrow-right-line')
+    expect(TuffIcons.Menu).toBe('i-ri-menu-line')
+  })
+
+  it('should have action icons', () => {
+    expect(TuffIcons.Add).toBe('i-ri-add-line')
+    expect(TuffIcons.Delete).toBe('i-ri-delete-bin-line')
+    expect(TuffIcons.Edit).toBe('i-ri-edit-line')
+    expect(TuffIcons.Copy).toBe('i-ri-file-copy-line')
+  })
+
+  it('should have status icons', () => {
+    expect(TuffIcons.Check).toBe('i-ri-check-line')
+    expect(TuffIcons.Close).toBe('i-ri-close-line')
+    expect(TuffIcons.Warning).toBe('i-ri-error-warning-line')
+    expect(TuffIcons.Info).toBe('i-ri-information-line')
+  })
+
+  it('should have file icons', () => {
+    expect(TuffIcons.File).toBe('i-ri-file-line')
+    expect(TuffIcons.Folder).toBe('i-ri-folder-line')
+    expect(TuffIcons.FileCode).toBe('i-ri-file-code-line')
+  })
+
+  it('should follow UnoCSS icon naming convention', () => {
+    Object.values(TuffIcons).forEach((iconClass) => {
+      expect(iconClass).toMatch(/^i-[a-z]+-[a-z0-9-]+$/)
+    })
+  })
+})
+
+describe('classIcon', () => {
+  it('should create ITuffIcon from class name', () => {
+    const icon = classIcon('i-ri-star-line')
+    expect(icon.type).toBe('class')
+    expect(icon.value).toBe('i-ri-star-line')
+  })
+})
+
+describe('getIcon', () => {
+  it('should get ITuffIcon from TuffIcons key', () => {
+    const icon = getIcon('Search')
+    expect(icon.type).toBe('class')
+    expect(icon.value).toBe('i-ri-search-line')
+  })
+
+  it('should work with all defined icon keys', () => {
+    const keys = ['Home', 'Settings', 'User', 'File', 'Folder'] as const
+    keys.forEach((key) => {
+      const icon = getIcon(key)
+      expect(icon.type).toBe('class')
+      expect(icon.value).toBeTruthy()
+    })
+  })
+})
+
+describe('appIcons', () => {
+  it('should have app brand icons', () => {
+    expect(AppIcons.VSCode).toBe('i-simple-icons-visualstudiocode')
+    expect(AppIcons.Chrome).toBe('i-simple-icons-googlechrome')
+    expect(AppIcons.GitHub).toBe('i-simple-icons-github')
+    expect(AppIcons.Slack).toBe('i-simple-icons-slack')
+  })
+
+  it('should follow UnoCSS icon naming convention', () => {
+    Object.values(AppIcons).forEach((iconClass) => {
+      expect(iconClass).toMatch(/^i-[a-z]+-[a-z0-9-]+$/)
+    })
+  })
+})