@talex-touch/utils 1.0.42 → 1.0.45

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","/Users/talexdreamsoul/Workspace/Projects/talex-touch/packages/utils/transport/events/types/app-index.ts":"32","/Users/talexdreamsoul/Workspace/Projects/talex-touch/packages/utils/transport/index.ts":"33","/Users/talexdreamsoul/Workspace/Projects/talex-touch/packages/utils/transport/prelude.ts":"34","/Users/talexdreamsoul/Workspace/Projects/talex-touch/packages/utils/transport/events/types/plugin.ts":"35"},{"size":5306,"mtime":1771563102452,"results":"36","hashOfConfig":"37"},{"size":15379,"mtime":1771563102455,"results":"38","hashOfConfig":"37"},{"size":5659,"mtime":1771563102455,"results":"39","hashOfConfig":"37"},{"size":2691,"mtime":1771563102456,"results":"40","hashOfConfig":"37"},{"size":2710,"mtime":1771755191828,"results":"41","hashOfConfig":"42"},{"size":2472,"mtime":1771563102458,"results":"43","hashOfConfig":"37"},{"size":7760,"mtime":1771563102481,"results":"44","hashOfConfig":"37"},{"size":4206,"mtime":1771563102484,"results":"45","hashOfConfig":"37"},{"size":7775,"mtime":1771563102484,"results":"46","hashOfConfig":"37"},{"size":3423,"mtime":1771563102493,"results":"47","hashOfConfig":"37"},{"size":3750,"mtime":1771563102509,"results":"48","hashOfConfig":"37"},{"size":26935,"mtime":1771563102511,"results":"49","hashOfConfig":"37"},{"size":6457,"mtime":1771563102514,"results":"50","hashOfConfig":"37"},{"size":21154,"mtime":1771563102519,"results":"51","hashOfConfig":"37"},{"size":3091,"mtime":1771563102519,"results":"52","hashOfConfig":"37"},{"size":55314,"mtime":1771563102519,"results":"53","hashOfConfig":"37"},{"size":6327,"mtime":1771566199653,"results":"54","hashOfConfig":"42"},{"size":2888,"mtime":1771563689317,"results":"55","hashOfConfig":"37"},{"size":3003,"mtime":1771611450129,"results":"56","hashOfConfig":"42"},{"size":986,"mtime":1771611509397,"results":"57","hashOfConfig":"42"},{"size":683,"mtime":1771611477506,"results":"58","hashOfConfig":"42"},{"size":26106,"mtime":1771611536284,"results":"59","hashOfConfig":"42"},{"size":11083,"mtime":1771632074503,"results":"60","hashOfConfig":"42"},{"size":74847,"mtime":1771749468590,"results":"61","hashOfConfig":"42"},{"size":1770,"mtime":1771710444200,"results":"62","hashOfConfig":"42"},{"size":4523,"mtime":1771710495855,"results":"63","hashOfConfig":"42"},{"size":3327,"mtime":1771678966584,"results":"64","hashOfConfig":"42"},{"size":18271,"mtime":1771679568421,"results":"65","hashOfConfig":"42"},{"size":329,"mtime":1771678957747,"results":"66","hashOfConfig":"42"},{"size":135,"mtime":1771678957747,"results":"67","hashOfConfig":"68"},{"size":9317,"mtime":1771684543626,"results":"69","hashOfConfig":"42"},{"size":478,"mtime":1771710451259,"results":"70","hashOfConfig":"42"},{"size":3533,"mtime":1771739652939,"results":"71","hashOfConfig":"42"},{"size":6426,"mtime":1771739449023,"results":"72","hashOfConfig":"42"},{"size":11904,"mtime":1771750097131,"results":"73","hashOfConfig":"42"},{"filePath":"74","messages":"75","suppressedMessages":"76","errorCount":0,"fatalErrorCount":0,"warningCount":0,"fixableErrorCount":0,"fixableWarningCount":0},"tyugd7",{"filePath":"77","messages":"78","suppressedMessages":"79","errorCount":0,"fatalErrorCount":0,"warningCount":0,"fixableErrorCount":0,"fixableWarningCount":0},{"filePath":"80","messages":"81","suppressedMessages":"82","errorCount":0,"fatalErrorCount":0,"warningCount":0,"fixableErrorCount":0,"fixableWarningCount":0},{"filePath":"83","messages":"84","suppressedMessages":"85","errorCount":0,"fatalErrorCount":0,"warningCount":0,"fixableErrorCount":0,"fixableWarningCount":0},{"filePath":"86","messages":"87","suppressedMessages":"88","errorCount":0,"fatalErrorCount":0,"warningCount":0,"fixableErrorCount":0,"fixableWarningCount":0},"m7p77f",{"filePath":"89","messages":"90","suppressedMessages":"91","errorCount":0,"fatalErrorCount":0,"warningCount":0,"fixableErrorCount":0,"fixableWarningCount":0},{"filePath":"92","messages":"93","suppressedMessages":"94","errorCount":0,"fatalErrorCount":0,"warningCount":0,"fixableErrorCount":0,"fixableWarningCount":0},{"filePath":"95","messages":"96","suppressedMessages":"97","errorCount":0,"fatalErrorCount":0,"warningCount":0,"fixableErrorCount":0,"fixableWarningCount":0},{"filePath":"98","messages":"99","suppressedMessages":"100","errorCount":0,"fatalErrorCount":0,"warningCount":0,"fixableErrorCount":0,"fixableWarningCount":0},{"filePath":"101","messages":"102","suppressedMessages":"103","errorCount":0,"fatalErrorCount":0,"warningCount":0,"fixableErrorCount":0,"fixableWarningCount":0},{"filePath":"104","messages":"105","suppressedMessages":"106","errorCount":0,"fatalErrorCount":0,"warningCount":0,"fixableErrorCount":0,"fixableWarningCount":0},{"filePath":"107","messages":"108","suppressedMessages":"109","errorCount":0,"fatalErrorCount":0,"warningCount":0,"fixableErrorCount":0,"fixableWarningCount":0},{"filePath":"110","messages":"111","suppressedMessages":"112","errorCount":0,"fatalErrorCount":0,"warningCount":0,"fixableErrorCount":0,"fixableWarningCount":0},{"filePath":"113","messages":"114","suppressedMessages":"115","errorCount":0,"fatalErrorCount":0,"warningCount":0,"fixableErrorCount":0,"fixableWarningCount":0},{"filePath":"116","messages":"117","suppressedMessages":"118","errorCount":0,"fatalErrorCount":0,"warningCount":0,"fixableErrorCount":0,"fixableWarningCount":0},{"filePath":"119","messages":"120","suppressedMessages":"121","errorCount":0,"fatalErrorCount":0,"warningCount":0,"fixableErrorCount":0,"fixableWarningCount":0},{"filePath":"122","messages":"123","suppressedMessages":"124","errorCount":0,"fatalErrorCount":0,"warningCount":0,"fixableErrorCount":0,"fixableWarningCount":0},{"filePath":"125","messages":"126","suppressedMessages":"127","errorCount":0,"fatalErrorCount":0,"warningCount":0,"fixableErrorCount":0,"fixableWarningCount":0},{"filePath":"128","messages":"129","suppressedMessages":"130","errorCount":0,"fatalErrorCount":0,"warningCount":0,"fixableErrorCount":0,"fixableWarningCount":0},{"filePath":"131","messages":"132","suppressedMessages":"133","errorCount":0,"fatalErrorCount":0,"warningCount":0,"fixableErrorCount":0,"fixableWarningCount":0},{"filePath":"134","messages":"135","suppressedMessages":"136","errorCount":0,"fatalErrorCount":0,"warningCount":0,"fixableErrorCount":0,"fixableWarningCount":0},{"filePath":"137","messages":"138","suppressedMessages":"139","errorCount":0,"fatalErrorCount":0,"warningCount":0,"fixableErrorCount":0,"fixableWarningCount":0},{"filePath":"140","messages":"141","suppressedMessages":"142","errorCount":0,"fatalErrorCount":0,"warningCount":0,"fixableErrorCount":0,"fixableWarningCount":0},{"filePath":"143","messages":"144","suppressedMessages":"145","errorCount":0,"fatalErrorCount":0,"warningCount":0,"fixableErrorCount":0,"fixableWarningCount":0},{"filePath":"146","messages":"147","suppressedMessages":"148","errorCount":0,"fatalErrorCount":0,"warningCount":0,"fixableErrorCount":0,"fixableWarningCount":0},{"filePath":"149","messages":"150","suppressedMessages":"151","errorCount":0,"fatalErrorCount":0,"warningCount":0,"fixableErrorCount":0,"fixableWarningCount":0},{"filePath":"152","messages":"153","suppressedMessages":"154","errorCount":0,"fatalErrorCount":0,"warningCount":0,"fixableErrorCount":0,"fixableWarningCount":0},{"filePath":"155","messages":"156","suppressedMessages":"157","errorCount":0,"fatalErrorCount":0,"warningCount":0,"fixableErrorCount":0,"fixableWarningCount":0},{"filePath":"158","messages":"159","suppressedMessages":"160","errorCount":0,"fatalErrorCount":0,"warningCount":0,"fixableErrorCount":0,"fixableWarningCount":0},{"filePath":"161","messages":"162","suppressedMessages":"163","errorCount":0,"fatalErrorCount":0,"warningCount":0,"fixableErrorCount":0,"fixableWarningCount":0},"552fw",{"filePath":"164","messages":"165","suppressedMessages":"166","errorCount":0,"fatalErrorCount":0,"warningCount":0,"fixableErrorCount":0,"fixableWarningCount":0},{"filePath":"167","messages":"168","suppressedMessages":"169","errorCount":0,"fatalErrorCount":0,"warningCount":0,"fixableErrorCount":0,"fixableWarningCount":0},{"filePath":"170","messages":"171","suppressedMessages":"172","errorCount":0,"fatalErrorCount":0,"warningCount":0,"fixableErrorCount":0,"fixableWarningCount":0},{"filePath":"173","messages":"174","suppressedMessages":"175","errorCount":0,"fatalErrorCount":0,"warningCount":0,"fixableErrorCount":0,"fixableWarningCount":0},{"filePath":"176","messages":"177","suppressedMessages":"178","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",[],[],"/Users/talexdreamsoul/Workspace/Projects/talex-touch/packages/utils/transport/events/types/app-index.ts",[],[],"/Users/talexdreamsoul/Workspace/Projects/talex-touch/packages/utils/transport/index.ts",[],[],"/Users/talexdreamsoul/Workspace/Projects/talex-touch/packages/utils/transport/prelude.ts",[],[],"/Users/talexdreamsoul/Workspace/Projects/talex-touch/packages/utils/transport/events/types/plugin.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-]+$/)
+    })
+  })
+})