Add link-column CRUD APIs to the HTML Page SDK

src/apis/html-page-api.js

@@ -147,6 +147,42 @@ class HTMLPageAPI {
     return this._sendDelete(url, data);
   }
 
+  addLink(page_id, table_name, row_id, link_column_name, other_row_id, preview_table_config) {
+    const url = `${this.server}api/v2.1/universal-apps/${this.appUuid}/html-page-links/`;
+    const data = { page_id, table_name, row_id, link_column_name, other_row_id };
+    if (preview_table_config && typeof preview_table_config === 'object') {
+      data.preview_table_config = preview_table_config;
+    }
+    return this.req.post(url, data);
+  }
+
+  deleteLink(page_id, table_name, row_id, link_column_name, other_row_id, preview_table_config) {
+    const url = `${this.server}api/v2.1/universal-apps/${this.appUuid}/html-page-links/`;
+    const data = { page_id, table_name, row_id, link_column_name, other_row_id };
+    if (preview_table_config && typeof preview_table_config === 'object') {
+      data.preview_table_config = preview_table_config;
+    }
+    return this._sendDelete(url, data);
+  }
+
+  addLinks(page_id, table_name, links_data, preview_table_config) {
+    const url = `${this.server}api/v2.1/universal-apps/${this.appUuid}/html-page-links/batch/`;
+    const data = { page_id, table_name, links_data };
+    if (preview_table_config && typeof preview_table_config === 'object') {
+      data.preview_table_config = preview_table_config;
+    }
+    return this.req.post(url, data);
+  }
+
+  deleteLinks(page_id, table_name, links_data, preview_table_config) {
+    const url = `${this.server}api/v2.1/universal-apps/${this.appUuid}/html-page-links/batch/`;
+    const data = { page_id, table_name, links_data };
+    if (preview_table_config && typeof preview_table_config === 'object') {
+      data.preview_table_config = preview_table_config;
+    }
+    return this._sendDelete(url, data);
+  }
+
   getUploadLink(page_id, upload_type = 'file') {
     const url = `${this.server}api/v2.1/universal-apps/${this.appUuid}/html-page-upload-link/`;
     return this.req.get(url, { params: { page_id, upload_type } });

src/sdk.js

@@ -129,6 +129,40 @@ export class HTMLPageSDK {
     return this.htmlPageAPI.deleteRows(this.options.pageId, tableName, rowsIds, previewTableConfig);
   }
 
+  addLink({ tableName, rowId, linkColumnName, otherRowId }) {
+    const previewTableConfig = this._getPreviewTableConfig({ tableName });
+    return this.htmlPageAPI.addLink(
+      this.options.pageId,
+      tableName,
+      rowId,
+      linkColumnName,
+      otherRowId,
+      previewTableConfig,
+    );
+  }
+
+  deleteLink({ tableName, rowId, linkColumnName, otherRowId }) {
+    const previewTableConfig = this._getPreviewTableConfig({ tableName });
+    return this.htmlPageAPI.deleteLink(
+      this.options.pageId,
+      tableName,
+      rowId,
+      linkColumnName,
+      otherRowId,
+      previewTableConfig,
+    );
+  }
+
+  batchAddLinks({ tableName, linksData }) {
+    const previewTableConfig = this._getPreviewTableConfig({ tableName });
+    return this.htmlPageAPI.addLinks(this.options.pageId, tableName, linksData, previewTableConfig);
+  }
+
+  batchDeleteLinks({ tableName, linksData }) {
+    const previewTableConfig = this._getPreviewTableConfig({ tableName });
+    return this.htmlPageAPI.deleteLinks(this.options.pageId, tableName, linksData, previewTableConfig);
+  }
+
   uploadFile({ file }) {
     return this.htmlPageAPI.upload(this.options.pageId, file);
   }

tests/html-page-api.test.js

@@ -329,8 +329,10 @@ describe('HTMLPageAPI.updateRow(s)', () => {
     const { api, put } = createApi();
     const rowsData = [{ row_id: 'row-1', Name: 'Jane' }];
     const response = {
-      data: { success: true },
-      rows: [{ row_id: 'row-1', '0000': 'Jane' }],
+      data: {
+        success: true,
+        rows: [{ _id: 'row-1', '0000': 'Jane' }],
+      },
     };
     put.mockReturnValue(response);
 
@@ -350,6 +352,90 @@ describe('HTMLPageAPI.updateRow(s)', () => {
       },
     );
   });
+
+  it('updateRow sends link-column row ids and returns expanded link values', () => {
+    const { api, put } = createApi();
+    const rowData = {
+      Name: 'Updated task',
+      'Related projects': ['project-row-1', 'project-row-2'],
+    };
+    const updatedRow = {
+      _id: 'task-row-1',
+      Name: 'Updated task',
+      'Related projects': [
+        { row_id: 'project-row-1', display_value: 'Project 1' },
+        { row_id: 'project-row-2', display_value: 'Project 2' },
+      ],
+    };
+    const response = { data: { success: true, row: updatedRow } };
+    put.mockReturnValue(response);
+
+    const result = api.updateRow('page-1', 'Tasks', 'task-row-1', rowData);
+
+    expect(result.data.row).toEqual(updatedRow);
+    expect(put).toHaveBeenCalledWith(
+      'https://example.com/api/v2.1/universal-apps/app-uuid/html-page-rows/',
+      {
+        page_id: 'page-1',
+        table_name: 'Tasks',
+        row_id: 'task-row-1',
+        row_data: rowData,
+      },
+      {
+        headers: { 'Content-Type': 'application/json' },
+      },
+    );
+  });
+
+  it('updateRows sends link-column row ids and returns expanded link values', () => {
+    const { api, put } = createApi();
+    const rowsData = [
+      {
+        row_id: 'task-row-1',
+        row: {
+          Name: 'Updated task 1',
+          'Related projects': ['project-row-1', 'project-row-2'],
+        },
+      },
+      {
+        row_id: 'task-row-2',
+        row: {
+          'Related projects': [],
+        },
+      },
+    ];
+    const updatedRows = [
+      {
+        _id: 'task-row-1',
+        Name: 'Updated task 1',
+        'Related projects': [
+          { row_id: 'project-row-1', display_value: 'Project 1' },
+          { row_id: 'project-row-2', display_value: 'Project 2' },
+        ],
+      },
+      {
+        _id: 'task-row-2',
+        'Related projects': [],
+      },
+    ];
+    const response = { data: { success: true, rows: updatedRows } };
+    put.mockReturnValue(response);
+
+    const result = api.updateRows('page-1', 'Tasks', rowsData);
+
+    expect(result.data.rows).toEqual(updatedRows);
+    expect(put).toHaveBeenCalledWith(
+      'https://example.com/api/v2.1/universal-apps/app-uuid/html-page-rows/batch/',
+      {
+        page_id: 'page-1',
+        table_name: 'Tasks',
+        rows_data: rowsData,
+      },
+      {
+        headers: { 'Content-Type': 'application/json' },
+      },
+    );
+  });
 });
 
 describe('HTMLPageAPI.deleteRows(s)', () => {
@@ -423,6 +509,173 @@ describe('HTMLPageAPI.deleteRows(s)', () => {
   });
 });
 
+describe('HTMLPageAPI link operations', () => {
+  beforeEach(() => {
+    jest.clearAllMocks();
+  });
+
+  it('adds a link and returns the updated row', () => {
+    const { api, post } = createApi();
+    const updatedRow = {
+      _id: 'task-row-1',
+      'Related projects': [
+        { row_id: 'project-row-1', display_value: 'Project 1' },
+      ],
+    };
+    const response = { data: { success: true, row: updatedRow } };
+    post.mockReturnValue(response);
+
+    const result = api.addLink(
+      'page-1',
+      'Tasks',
+      'task-row-1',
+      'Related projects',
+      'project-row-1',
+    );
+
+    expect(result).toBe(response);
+    expect(result.data.row).toEqual(updatedRow);
+    expect(post).toHaveBeenCalledWith(
+      'https://example.com/api/v2.1/universal-apps/app-uuid/html-page-links/',
+      {
+        page_id: 'page-1',
+        table_name: 'Tasks',
+        row_id: 'task-row-1',
+        link_column_name: 'Related projects',
+        other_row_id: 'project-row-1',
+      },
+    );
+  });
+
+  it('deletes a link and returns the updated row', () => {
+    const { api, del } = createApi();
+    const updatedRow = { _id: 'task-row-1', 'Related projects': [] };
+    const response = { data: { success: true, row: updatedRow } };
+    del.mockReturnValue(response);
+
+    const result = api.deleteLink(
+      'page-1',
+      'Tasks',
+      'task-row-1',
+      'Related projects',
+      'project-row-1',
+    );
+
+    expect(result).toBe(response);
+    expect(result.data.row).toEqual(updatedRow);
+    expect(del).toHaveBeenCalledWith(
+      'https://example.com/api/v2.1/universal-apps/app-uuid/html-page-links/',
+      {
+        headers: { 'Content-Type': 'application/json' },
+        data: {
+          page_id: 'page-1',
+          table_name: 'Tasks',
+          row_id: 'task-row-1',
+          link_column_name: 'Related projects',
+          other_row_id: 'project-row-1',
+        },
+      },
+    );
+  });
+
+  it('adds and deletes links in batch and returns the updated rows', () => {
+    const { api, post, del } = createApi();
+    const linksData = [
+      {
+        row_id: 'task-row-1',
+        links: {
+          'Related projects': ['project-row-1', 'project-row-2'],
+        },
+      },
+    ];
+    const addedRows = [{
+      _id: 'task-row-1',
+      'Related projects': [
+        { row_id: 'project-row-1', display_value: 'Project 1' },
+        { row_id: 'project-row-2', display_value: 'Project 2' },
+      ],
+    }];
+    const deletedRows = [{ _id: 'task-row-1', 'Related projects': [] }];
+    const addResponse = { data: { success: true, rows: addedRows } };
+    const deleteResponse = { data: { success: true, rows: deletedRows } };
+    post.mockReturnValue(addResponse);
+    del.mockReturnValue(deleteResponse);
+
+    const addResult = api.addLinks('page-1', 'Tasks', linksData);
+    const deleteResult = api.deleteLinks('page-1', 'Tasks', linksData);
+
+    expect(addResult).toBe(addResponse);
+    expect(addResult.data.rows).toEqual(addedRows);
+    expect(deleteResult).toBe(deleteResponse);
+    expect(deleteResult.data.rows).toEqual(deletedRows);
+    expect(post).toHaveBeenCalledWith(
+      'https://example.com/api/v2.1/universal-apps/app-uuid/html-page-links/batch/',
+      {
+        page_id: 'page-1',
+        table_name: 'Tasks',
+        links_data: linksData,
+      },
+    );
+    expect(del).toHaveBeenCalledWith(
+      'https://example.com/api/v2.1/universal-apps/app-uuid/html-page-links/batch/',
+      {
+        headers: { 'Content-Type': 'application/json' },
+        data: {
+          page_id: 'page-1',
+          table_name: 'Tasks',
+          links_data: linksData,
+        },
+      },
+    );
+  });
+
+  it('includes preview_table_config in link requests for ai_agent preview', () => {
+    const { api, post, del } = createApi();
+    const previewTableConfig = { table_id: 'table-1', permissions: {} };
+    const linksData = [{ row_id: 'task-row-1', links: { related: ['project-row-1'] } }];
+
+    api.addLink('ai_agent', 'Tasks', 'task-row-1', 'related', 'project-row-1', previewTableConfig);
+    api.deleteLink('ai_agent', 'Tasks', 'task-row-1', 'related', 'project-row-1', previewTableConfig);
+    api.addLinks('ai_agent', 'Tasks', linksData, previewTableConfig);
+    api.deleteLinks('ai_agent', 'Tasks', linksData, previewTableConfig);
+
+    expect(post).toHaveBeenNthCalledWith(1, expect.any(String), {
+      page_id: 'ai_agent',
+      table_name: 'Tasks',
+      row_id: 'task-row-1',
+      link_column_name: 'related',
+      other_row_id: 'project-row-1',
+      preview_table_config: previewTableConfig,
+    });
+    expect(del).toHaveBeenNthCalledWith(1, expect.any(String), {
+      headers: { 'Content-Type': 'application/json' },
+      data: {
+        page_id: 'ai_agent',
+        table_name: 'Tasks',
+        row_id: 'task-row-1',
+        link_column_name: 'related',
+        other_row_id: 'project-row-1',
+        preview_table_config: previewTableConfig,
+      },
+    });
+    expect(post).toHaveBeenNthCalledWith(2, expect.any(String), {
+      page_id: 'ai_agent',
+      table_name: 'Tasks',
+      links_data: linksData,
+      preview_table_config: previewTableConfig,
+    });
+    expect(del).toHaveBeenNthCalledWith(2, expect.any(String), {
+      headers: { 'Content-Type': 'application/json' },
+      data: {
+        page_id: 'ai_agent',
+        table_name: 'Tasks',
+        links_data: linksData,
+        preview_table_config: previewTableConfig,
+      },
+    });
+  });
+});
+
 describe('HTMLPageAPI.upload', () => {
   beforeEach(() => {
     jest.clearAllMocks();