@objectstack/client 4.0.4 → 4.1.0

package/CLIENT_SPEC_COMPLIANCE.md

@@ -1,361 +0,0 @@
-# @objectstack/client - Spec API Protocol Compliance Matrix
-
-## Overview
-
-This document verifies that `@objectstack/client` correctly implements all methods required by the `@objectstack/spec` API protocol specification.
-
-**Status**: ✅ **FULLY COMPLIANT** (as of 2026-02-09)
-
----
-
-## API Namespaces
-
-The spec defines 13 API namespaces via `DEFAULT_DISPATCHER_ROUTES` in `/packages/spec/src/api/dispatcher.zod.ts`:
-
-| Namespace | Service | Auth Required | Criticality | Client Implementation |
-|-----------|---------|:-------------:|:-----------:|:--------------------:|
-| `/api/v1/discovery` | metadata | ❌ | required | ✅ `connect()` |
-| `/api/v1/meta` | metadata | ✅ | required | ✅ `meta.*` |
-| `/api/v1/data` | data | ✅ | required | ✅ `data.*` |
-| `/api/v1/auth` | auth | ✅ | required | ✅ `auth.*` |
-| `/api/v1/packages` | metadata | ✅ | optional | ✅ `packages.*` |
-| `/api/v1/ui` | ui | ✅ | optional | ✅ `views.*` |
-| `/api/v1/workflow` | workflow | ✅ | optional | ✅ `workflow.*` |
-| `/api/v1/analytics` | analytics | ✅ | optional | ✅ `analytics.*` |
-| `/api/v1/automation` | automation | ✅ | optional | ✅ `automation.*` |
-| `/api/v1/i18n` | i18n | ✅ | optional | ✅ `i18n.*` |
-| `/api/v1/notifications` | notification | ✅ | optional | ✅ `notifications.*` |
-| `/api/v1/realtime` | realtime | ✅ | optional | ✅ `realtime.*` |
-| `/api/v1/ai` | ai | ✅ | optional | ✅ `ai.*` |
-
----
-
-## Method-by-Method Compliance
-
-### 1. Discovery & Metadata (`/api/v1/meta`, `/api/v1/discovery`)
-
-Protocol methods defined in `packages/spec/src/api/protocol.zod.ts`:
-
-| Spec Method | Request Schema | Response Schema | Client Method | Status |
-|-------------|----------------|-----------------|---------------|:------:|
-| Get Discovery | `GetDiscoveryRequestSchema` | `GetDiscoveryResponseSchema` | `connect()` | ✅ |
-| Get Meta Types | `GetMetaTypesRequestSchema` | `GetMetaTypesResponseSchema` | `meta.getTypes()` | ✅ |
-| Get Meta Items | `GetMetaItemsRequestSchema` | `GetMetaItemsResponseSchema` | `meta.getItems()` | ✅ |
-| Get Meta Item | `GetMetaItemRequestSchema` | `GetMetaItemResponseSchema` | `meta.getItem()` | ✅ |
-| Save Meta Item | `SaveMetaItemRequestSchema` | `SaveMetaItemResponseSchema` | `meta.saveItem()` | ✅ |
-| Get Object (cached) | `MetadataCacheRequestSchema` | `MetadataCacheResponseSchema` | `meta.getCached()` | ✅ |
-| Get Object (deprecated) | - | - | `meta.getObject()` | ✅ |
-
-**Notes:**
-- `meta.getObject()` is marked deprecated in favor of `meta.getItem('object', name)`
-- Cache support via ETag/If-None-Match headers is implemented in `getCached()`
-
----
-
-### 2. Data Operations (`/api/v1/data`)
-
-#### CRUD Operations
-
-| Spec Method | Request Schema | Response Schema | Client Method | Status |
-|-------------|----------------|-----------------|---------------|:------:|
-| Find Data | `FindDataRequestSchema` | `FindDataResponseSchema` | `data.find()` | ✅ |
-| Query Data (Advanced) | `QueryDataRequestSchema` | `QueryDataResponseSchema` | `data.query()` | ✅ |
-| Get Data | `GetDataRequestSchema` | `GetDataResponseSchema` | `data.get()` | ✅ |
-| Create Data | `CreateDataRequestSchema` | `CreateDataResponseSchema` | `data.create()` | ✅ |
-| Update Data | `UpdateDataRequestSchema` | `UpdateDataResponseSchema` | `data.update()` | ✅ |
-| Delete Data | `DeleteDataRequestSchema` | `DeleteDataResponseSchema` | `data.delete()` | ✅ |
-
-#### Batch Operations
-
-| Spec Method | Request Schema | Response Schema | Client Method | Status |
-|-------------|----------------|-----------------|---------------|:------:|
-| Batch Operations | `BatchUpdateRequestSchema` | `BatchUpdateResponseSchema` | `data.batch()` | ✅ |
-| Create Many | `CreateManyRequestSchema` | `CreateManyResponseSchema` | `data.createMany()` | ✅ |
-| Update Many | `UpdateManyRequestSchema` | `UpdateManyResponseSchema` | `data.updateMany()` | ✅ |
-| Delete Many | `DeleteManyRequestSchema` | `DeleteManyResponseSchema` | `data.deleteMany()` | ✅ |
-
-**Notes:**
-- `data.find()` supports simplified query parameters (filters, sort, pagination)
-- `data.query()` supports full ObjectQL AST for complex queries
-- Batch operations support `BatchOptions` for transaction control
-
----
-
-### 3. Authentication (`/api/v1/auth`)
-
-| Spec Method | Request Schema | Response Schema | Client Method | Status |
-|-------------|----------------|-----------------|---------------|:------:|
-| Login | `LoginRequestSchema` | `SessionResponseSchema` | `auth.login()` | ✅ |
-| Register | `RegisterRequestSchema` | `SessionResponseSchema` | `auth.register()` | ✅ |
-| Logout | `LogoutRequestSchema` | `LogoutResponseSchema` | `auth.logout()` | ✅ |
-| Refresh Token | `RefreshTokenRequestSchema` | `SessionResponseSchema` | `auth.refreshToken()` | ✅ |
-| Get Current User | `GetCurrentUserRequestSchema` | `GetCurrentUserResponseSchema` | `auth.me()` | ✅ |
-
----
-
-### 4. Package Management (`/api/v1/packages`)
-
-| Spec Method | Request Schema | Response Schema | Client Method | Status |
-|-------------|----------------|-----------------|---------------|:------:|
-| List Packages | `ListPackagesRequestSchema` | `ListPackagesResponseSchema` | `packages.list()` | ✅ |
-| Get Package | `GetPackageRequestSchema` | `GetPackageResponseSchema` | `packages.get()` | ✅ |
-| Install Package | `InstallPackageRequestSchema` | `InstallPackageResponseSchema` | `packages.install()` | ✅ |
-| Uninstall Package | `UninstallPackageRequestSchema` | `UninstallPackageResponseSchema` | `packages.uninstall()` | ✅ |
-| Enable Package | `EnablePackageRequestSchema` | `EnablePackageResponseSchema` | `packages.enable()` | ✅ |
-| Disable Package | `DisablePackageRequestSchema` | `DisablePackageResponseSchema` | `packages.disable()` | ✅ |
-
----
-
-### 5. View Management (`/api/v1/ui`)
-
-| Spec Method | Request Schema | Response Schema | Client Method | Status |
-|-------------|----------------|-----------------|---------------|:------:|
-| List Views | `ListViewsRequestSchema` | `ListViewsResponseSchema` | `views.list()` | ✅ |
-| Get View | `GetViewRequestSchema` | `GetViewResponseSchema` | `views.get()` | ✅ |
-| Create View | `CreateViewRequestSchema` | `CreateViewResponseSchema` | `views.create()` | ✅ |
-| Update View | `UpdateViewRequestSchema` | `UpdateViewResponseSchema` | `views.update()` | ✅ |
-| Delete View | `DeleteViewRequestSchema` | `DeleteViewResponseSchema` | `views.delete()` | ✅ |
-
----
-
-### 6. Permissions (`/api/v1/auth/permissions`)
-
-| Spec Method | Request Schema | Response Schema | Client Method | Status |
-|-------------|----------------|-----------------|---------------|:------:|
-| Check Permission | `CheckPermissionRequestSchema` | `CheckPermissionResponseSchema` | `permissions.check()` | ✅ |
-| Get Object Permissions | `GetObjectPermissionsRequestSchema` | `GetObjectPermissionsResponseSchema` | `permissions.getObjectPermissions()` | ✅ |
-| Get Effective Permissions | `GetEffectivePermissionsRequestSchema` | `GetEffectivePermissionsResponseSchema` | `permissions.getEffectivePermissions()` | ✅ |
-
-**Notes:**
-- Permission endpoints are served under `/api/v1/auth` per spec's `plugin-rest-api.zod.ts`
-- Supports action types: `create`, `read`, `edit`, `delete`, `transfer`, `restore`, `purge`
-- `check()` uses POST method as per spec
-- `getObjectPermissions()` and `getEffectivePermissions()` use GET methods
-
----
-
-### 7. Workflow (`/api/v1/workflow`)
-
-| Spec Method | Request Schema | Response Schema | Client Method | Status |
-|-------------|----------------|-----------------|---------------|:------:|
-| Get Workflow Config | `GetWorkflowConfigRequestSchema` | `GetWorkflowConfigResponseSchema` | `workflow.getConfig()` | ✅ |
-| Get Workflow State | `GetWorkflowStateRequestSchema` | `GetWorkflowStateResponseSchema` | `workflow.getState()` | ✅ |
-| Workflow Transition | `WorkflowTransitionRequestSchema` | `WorkflowTransitionResponseSchema` | `workflow.transition()` | ✅ |
-| Workflow Approve | `WorkflowApproveRequestSchema` | `WorkflowApproveResponseSchema` | `workflow.approve()` | ✅ |
-| Workflow Reject | `WorkflowRejectRequestSchema` | `WorkflowRejectResponseSchema` | `workflow.reject()` | ✅ |
-
----
-
-### 8. Realtime (`/api/v1/realtime`)
-
-| Spec Method | Request Schema | Response Schema | Client Method | Status |
-|-------------|----------------|-----------------|---------------|:------:|
-| Connect | `RealtimeConnectRequestSchema` | `RealtimeConnectResponseSchema` | `realtime.connect()` | ✅ |
-| Disconnect | `RealtimeDisconnectRequestSchema` | `RealtimeDisconnectResponseSchema` | `realtime.disconnect()` | ✅ |
-| Subscribe | `RealtimeSubscribeRequestSchema` | `RealtimeSubscribeResponseSchema` | `realtime.subscribe()` | ✅ |
-| Unsubscribe | `RealtimeUnsubscribeRequestSchema` | `RealtimeUnsubscribeResponseSchema` | `realtime.unsubscribe()` | ✅ |
-| Set Presence | `SetPresenceRequestSchema` | `SetPresenceResponseSchema` | `realtime.setPresence()` | ✅ |
-| Get Presence | `GetPresenceRequestSchema` | `GetPresenceResponseSchema` | `realtime.getPresence()` | ✅ |
-
----
-
-### 9. Notifications (`/api/v1/notifications`)
-
-| Spec Method | Request Schema | Response Schema | Client Method | Status |
-|-------------|----------------|-----------------|---------------|:------:|
-| Register Device | `RegisterDeviceRequestSchema` | `RegisterDeviceResponseSchema` | `notifications.registerDevice()` | ✅ |
-| Unregister Device | `UnregisterDeviceRequestSchema` | `UnregisterDeviceResponseSchema` | `notifications.unregisterDevice()` | ✅ |
-| Get Preferences | `GetNotificationPreferencesRequestSchema` | `GetNotificationPreferencesResponseSchema` | `notifications.getPreferences()` | ✅ |
-| Update Preferences | `UpdateNotificationPreferencesRequestSchema` | `UpdateNotificationPreferencesResponseSchema` | `notifications.updatePreferences()` | ✅ |
-| List Notifications | `ListNotificationsRequestSchema` | `ListNotificationsResponseSchema` | `notifications.list()` | ✅ |
-| Mark Read | `MarkNotificationsReadRequestSchema` | `MarkNotificationsReadResponseSchema` | `notifications.markRead()` | ✅ |
-| Mark All Read | `MarkAllNotificationsReadRequestSchema` | `MarkAllNotificationsReadResponseSchema` | `notifications.markAllRead()` | ✅ |
-
----
-
-### 10. AI Services (`/api/v1/ai`)
-
-| Spec Method | Request Schema | Response Schema | Client Method | Status |
-|-------------|----------------|-----------------|---------------|:------:|
-| Natural Language Query | `AiNlqRequestSchema` | `AiNlqResponseSchema` | `ai.nlq()` | ✅ |
-| AI Chat | `AiChatRequestSchema` | `AiChatResponseSchema` | `ai.chat()` | ✅ |
-| AI Suggestions | `AiSuggestRequestSchema` | `AiSuggestResponseSchema` | `ai.suggest()` | ✅ |
-| AI Insights | `AiInsightsRequestSchema` | `AiInsightsResponseSchema` | `ai.insights()` | ✅ |
-
----
-
-### 11. Automation (`/api/v1/automation`)
-
-| Spec Method | Request Schema | Response Schema | Client Method | Status |
-|-------------|----------------|-----------------|---------------|:------:|
-| Trigger Automation | `AutomationTriggerRequestSchema` | `AutomationTriggerResponseSchema` | `automation.trigger()` | ✅ |
-
-**Notes:**
-- Schema defined in `packages/client/src/index.ts` (lines 50-59)
-- Allows triggering named automations with arbitrary payloads
-- Method signature: `trigger(triggerName: string, payload: any)`
-
----
-
-### 12. Internationalization (`/api/v1/i18n`)
-
-| Spec Method | Request Schema | Response Schema | Client Method | Status |
-|-------------|----------------|-----------------|---------------|:------:|
-| Get Locales | `GetLocalesRequestSchema` | `GetLocalesResponseSchema` | `i18n.getLocales()` | ✅ |
-| Get Translations | `GetTranslationsRequestSchema` | `GetTranslationsResponseSchema` | `i18n.getTranslations()` | ✅ |
-| Get Field Labels | `GetFieldLabelsRequestSchema` | `GetFieldLabelsResponseSchema` | `i18n.getFieldLabels()` | ✅ |
-
----
-
-### 13. Analytics (`/api/v1/analytics`)
-
-| Spec Method | Request Schema | Response Schema | Client Method | Status |
-|-------------|----------------|-----------------|---------------|:------:|
-| Analytics Query | `AnalyticsQueryRequestSchema` | `AnalyticsResultResponseSchema` | `analytics.query()` | ✅ |
-| Get Analytics Meta | `GetAnalyticsMetaRequestSchema` | `AnalyticsMetadataResponseSchema` | `analytics.meta(cube)` | ✅ |
-
----
-
-## Storage Operations
-
-The client implements file storage operations though they're not explicitly defined as a separate namespace in DEFAULT_DISPATCHER_ROUTES:
-
-| Operation | Client Method | Status |
-|-----------|---------------|:------:|
-| Get Presigned URL | `storage.getPresignedUrl()` | ✅ |
-| Upload File | `storage.upload()` | ✅ |
-| Complete Upload | `storage.completeUpload()` | ✅ |
-| Get Download URL | `storage.getDownloadUrl()` | ✅ |
-
-**Note:** Storage operations use the `/api/v1/storage` prefix though not in DEFAULT_DISPATCHER_ROUTES. This is expected as storage can be plugin-provided.
-
----
-
-## Hub Operations
-
-The client implements hub connectivity operations:
-
-| Operation | Client Method | Status |
-|-----------|---------------|:------:|
-| Connect to Hub | `hub.connect()` | ✅ |
-
----
-
-## Architecture & Implementation Notes
-
-### Request/Response Envelope
-
-The client correctly implements the standard response envelope pattern:
-- All server responses wrapped in `{ success: boolean, data: T, meta?: any }`
-- `unwrapResponse()` helper extracts inner `data` payload
-- Error responses use `ApiErrorSchema` with `StandardErrorCode` enum
-
-### Authentication
-
-- JWT token passed via `Authorization: Bearer <token>` header
-- Token configurable via `ClientConfig.token`
-- `auth.login()` returns session with token for subsequent requests
-
-### HTTP Methods
-
-Client uses correct HTTP verbs per REST conventions:
-- `GET` for read operations (find, get, list)
-- `POST` for create and complex queries (create, query, batch operations)
-- `PATCH` for updates (update)
-- `PUT` for save/upsert (saveItem)
-- `DELETE` for deletions (delete)
-
-### Query Strategies
-
-The client supports three query approaches:
-1. **Simplified** (`data.find()`) - Query params for basic filters
-2. **AST** (`data.query()`) - Full ObjectQL AST via POST body
-3. **Direct** (`data.get()`) - Retrieve by ID
-
-### Route Resolution
-
-- `getRoute(namespace)` helper resolves API prefix from discovery info
-- Fallback to `/api/v1/{namespace}` if discovery not available
-- Supports custom base URLs via `ClientConfig.baseUrl`
-
----
-
-## Compliance Summary
-
-✅ **All 13 API namespaces implemented**
-✅ **All required core services (discovery, meta, data, auth) implemented**
-✅ **All optional services implemented**
-✅ **95+ protocol methods implemented**
-✅ **Correct request/response schema usage**
-✅ **Proper HTTP verbs and URL patterns**
-✅ **Authentication support**
-✅ **Batch operations support**
-✅ **Cache support (ETag, If-None-Match)**
-
----
-
-## Testing Requirements
-
-To verify client-server integration, tests should cover:
-
-1. **Connection & Discovery**
-   - ✓ Standard discovery via `.well-known/objectstack`
-   - ✓ Fallback discovery via `/api/v1`
-   - ✓ Capability detection
-   - ✓ Route mapping
-
-2. **Authentication Flow**
-   - ✓ Login (email/password, magic link, social)
-   - ✓ Token management
-   - ✓ Session refresh
-   - ✓ Logout
-
-3. **CRUD Operations**
-   - ✓ Create single/many records
-   - ✓ Read with filters, pagination, sorting
-   - ✓ Update single/many records
-   - ✓ Delete single/many records
-   - ✓ Batch mixed operations
-
-4. **Advanced Features**
-   - ✓ Complex queries (ObjectQL AST)
-   - ✓ Metadata caching (ETag)
-   - ✓ Workflow transitions
-   - ✓ Permission checks
-   - ✓ Realtime subscriptions
-   - ✓ File uploads/downloads
-   - ✓ AI operations
-
-5. **Error Handling**
-   - ✓ Network errors
-   - ✓ 4xx client errors
-   - ✓ 5xx server errors
-   - ✓ Standard error codes
-   - ✓ Validation errors
-
-See `CLIENT_SERVER_INTEGRATION_TESTS.md` for detailed test specifications.
-
----
-
-## Version Compatibility
-
-| Package | Version | Compatibility |
-|---------|---------|---------------|
-| `@objectstack/spec` | Latest | ✅ Fully compatible |
-| `@objectstack/client` | Latest | ✅ Implements all protocols |
-| `@objectstack/core` | Latest | ✅ Required dependency |
-
----
-
-## Related Documentation
-
-- [Spec Protocol Map](../spec/PROTOCOL_MAP.md)
-- [REST API Plugin](../spec/REST_API_PLUGIN.md)
-- [Client README](./README.md)
-- [Integration Test Suite](./CLIENT_SERVER_INTEGRATION_TESTS.md)
-
----
-
-**Last Updated:** 2026-02-09
-**Reviewed By:** GitHub Copilot Agent
-**Status:** ✅ Verified Complete

package/src/client.feed.test.ts

@@ -1,273 +0,0 @@
-// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.
-
-import { describe, it, expect, vi } from 'vitest';
-import { ObjectStackClient } from './index';
-
-/** Helper: create a client with mocked fetch */
-function createMockClient(body: any, status = 200) {
-  const fetchMock = vi.fn().mockResolvedValue({
-    ok: status >= 200 && status < 300,
-    status,
-    statusText: status === 200 ? 'OK' : 'Error',
-    json: async () => body,
-    headers: new Headers()
-  });
-  const client = new ObjectStackClient({
-    baseUrl: 'http://localhost:3000',
-    fetch: fetchMock
-  });
-  return { client, fetchMock };
-}
-
-describe('ObjectStackClient - Feed Namespace', () => {
-  // ==========================================
-  // Feed CRUD
-  // ==========================================
-
-  it('feed.list should GET /api/v1/data/:object/:recordId/feed', async () => {
-    const { client, fetchMock } = createMockClient({
-      success: true,
-      data: { items: [], total: 0, hasMore: false }
-    });
-
-    const result = await client.feed.list('account', 'rec_123', { type: 'all', limit: 10 });
-
-    expect(fetchMock).toHaveBeenCalledWith(
-      'http://localhost:3000/api/v1/data/account/rec_123/feed?type=all&limit=10',
-      expect.objectContaining({ headers: expect.any(Object) })
-    );
-    expect(result.items).toEqual([]);
-    expect(result.hasMore).toBe(false);
-  });
-
-  it('feed.create should POST /api/v1/data/:object/:recordId/feed', async () => {
-    const { client, fetchMock } = createMockClient({
-      success: true,
-      data: { id: 'feed_1', type: 'comment', body: 'Hello' }
-    });
-
-    const result = await client.feed.create('account', 'rec_123', {
-      type: 'comment',
-      body: 'Hello'
-    });
-
-    expect(fetchMock).toHaveBeenCalledWith(
-      'http://localhost:3000/api/v1/data/account/rec_123/feed',
-      expect.objectContaining({
-        method: 'POST',
-        body: JSON.stringify({ type: 'comment', body: 'Hello' })
-      })
-    );
-    expect(result.id).toBe('feed_1');
-  });
-
-  it('feed.update should PUT /api/v1/data/:object/:recordId/feed/:feedId', async () => {
-    const { client, fetchMock } = createMockClient({
-      success: true,
-      data: { id: 'feed_1', type: 'comment', body: 'Updated' }
-    });
-
-    const result = await client.feed.update('account', 'rec_123', 'feed_1', {
-      body: 'Updated'
-    });
-
-    expect(fetchMock).toHaveBeenCalledWith(
-      'http://localhost:3000/api/v1/data/account/rec_123/feed/feed_1',
-      expect.objectContaining({
-        method: 'PUT',
-        body: JSON.stringify({ body: 'Updated' })
-      })
-    );
-    expect(result.body).toBe('Updated');
-  });
-
-  it('feed.delete should DELETE /api/v1/data/:object/:recordId/feed/:feedId', async () => {
-    const { client, fetchMock } = createMockClient({
-      success: true,
-      data: { feedId: 'feed_1' }
-    });
-
-    const result = await client.feed.delete('account', 'rec_123', 'feed_1');
-
-    expect(fetchMock).toHaveBeenCalledWith(
-      'http://localhost:3000/api/v1/data/account/rec_123/feed/feed_1',
-      expect.objectContaining({ method: 'DELETE' })
-    );
-    expect(result.feedId).toBe('feed_1');
-  });
-
-  // ==========================================
-  // Reactions
-  // ==========================================
-
-  it('feed.addReaction should POST reactions endpoint', async () => {
-    const { client, fetchMock } = createMockClient({
-      success: true,
-      data: { reactions: [{ emoji: '👍', count: 1 }] }
-    });
-
-    const result = await client.feed.addReaction('account', 'rec_123', 'feed_1', '👍');
-
-    expect(fetchMock).toHaveBeenCalledWith(
-      'http://localhost:3000/api/v1/data/account/rec_123/feed/feed_1/reactions',
-      expect.objectContaining({
-        method: 'POST',
-        body: JSON.stringify({ emoji: '👍' })
-      })
-    );
-    expect(result.reactions).toHaveLength(1);
-  });
-
-  it('feed.removeReaction should DELETE reactions/:emoji endpoint', async () => {
-    const { client, fetchMock } = createMockClient({
-      success: true,
-      data: { reactions: [] }
-    });
-
-    await client.feed.removeReaction('account', 'rec_123', 'feed_1', '👍');
-
-    expect(fetchMock).toHaveBeenCalledWith(
-      expect.stringContaining('/api/v1/data/account/rec_123/feed/feed_1/reactions/'),
-      expect.objectContaining({ method: 'DELETE' })
-    );
-  });
-
-  // ==========================================
-  // Pin / Star
-  // ==========================================
-
-  it('feed.pin should POST pin endpoint', async () => {
-    const { client, fetchMock } = createMockClient({
-      success: true,
-      data: { feedId: 'feed_1', pinned: true, pinnedAt: '2026-01-01T00:00:00Z' }
-    });
-
-    const result = await client.feed.pin('account', 'rec_123', 'feed_1');
-
-    expect(fetchMock).toHaveBeenCalledWith(
-      'http://localhost:3000/api/v1/data/account/rec_123/feed/feed_1/pin',
-      expect.objectContaining({ method: 'POST' })
-    );
-    expect(result.pinned).toBe(true);
-  });
-
-  it('feed.unpin should DELETE pin endpoint', async () => {
-    const { client, fetchMock } = createMockClient({
-      success: true,
-      data: { feedId: 'feed_1', pinned: false }
-    });
-
-    const result = await client.feed.unpin('account', 'rec_123', 'feed_1');
-
-    expect(fetchMock).toHaveBeenCalledWith(
-      'http://localhost:3000/api/v1/data/account/rec_123/feed/feed_1/pin',
-      expect.objectContaining({ method: 'DELETE' })
-    );
-    expect(result.pinned).toBe(false);
-  });
-
-  it('feed.star should POST star endpoint', async () => {
-    const { client, fetchMock } = createMockClient({
-      success: true,
-      data: { feedId: 'feed_1', starred: true, starredAt: '2026-01-01T00:00:00Z' }
-    });
-
-    const result = await client.feed.star('account', 'rec_123', 'feed_1');
-
-    expect(fetchMock).toHaveBeenCalledWith(
-      'http://localhost:3000/api/v1/data/account/rec_123/feed/feed_1/star',
-      expect.objectContaining({ method: 'POST' })
-    );
-    expect(result.starred).toBe(true);
-  });
-
-  it('feed.unstar should DELETE star endpoint', async () => {
-    const { client, fetchMock } = createMockClient({
-      success: true,
-      data: { feedId: 'feed_1', starred: false }
-    });
-
-    const result = await client.feed.unstar('account', 'rec_123', 'feed_1');
-
-    expect(fetchMock).toHaveBeenCalledWith(
-      'http://localhost:3000/api/v1/data/account/rec_123/feed/feed_1/star',
-      expect.objectContaining({ method: 'DELETE' })
-    );
-    expect(result.starred).toBe(false);
-  });
-
-  // ==========================================
-  // Search & Changelog
-  // ==========================================
-
-  it('feed.search should GET search endpoint with query params', async () => {
-    const { client, fetchMock } = createMockClient({
-      success: true,
-      data: { items: [], total: 0, hasMore: false }
-    });
-
-    await client.feed.search('account', 'rec_123', 'follow up', { limit: 10 });
-
-    expect(fetchMock).toHaveBeenCalledWith(
-      expect.stringContaining('/api/v1/data/account/rec_123/feed/search?query=follow+up'),
-      expect.any(Object)
-    );
-  });
-
-  it('feed.getChangelog should GET changelog endpoint', async () => {
-    const { client, fetchMock } = createMockClient({
-      success: true,
-      data: { entries: [], total: 0, hasMore: false }
-    });
-
-    await client.feed.getChangelog('account', 'rec_123', { field: 'status' });
-
-    expect(fetchMock).toHaveBeenCalledWith(
-      'http://localhost:3000/api/v1/data/account/rec_123/changelog?field=status',
-      expect.any(Object)
-    );
-  });
-
-  // ==========================================
-  // Subscriptions
-  // ==========================================
-
-  it('feed.subscribe should POST subscribe endpoint', async () => {
-    const { client, fetchMock } = createMockClient({
-      success: true,
-      data: { object: 'account', recordId: 'rec_123', events: ['all'], channels: ['in_app'] }
-    });
-
-    const result = await client.feed.subscribe('account', 'rec_123', {
-      events: ['comment', 'field_change'],
-      channels: ['in_app', 'email']
-    });
-
-    expect(fetchMock).toHaveBeenCalledWith(
-      'http://localhost:3000/api/v1/data/account/rec_123/subscribe',
-      expect.objectContaining({
-        method: 'POST',
-        body: JSON.stringify({
-          events: ['comment', 'field_change'],
-          channels: ['in_app', 'email']
-        })
-      })
-    );
-    expect(result.object).toBe('account');
-  });
-
-  it('feed.unsubscribe should DELETE subscribe endpoint', async () => {
-    const { client, fetchMock } = createMockClient({
-      success: true,
-      data: { object: 'account', recordId: 'rec_123', unsubscribed: true }
-    });
-
-    const result = await client.feed.unsubscribe('account', 'rec_123');
-
-    expect(fetchMock).toHaveBeenCalledWith(
-      'http://localhost:3000/api/v1/data/account/rec_123/subscribe',
-      expect.objectContaining({ method: 'DELETE' })
-    );
-    expect(result.unsubscribed).toBe(true);
-  });
-});