@osdk/react-components 0.0.0 → 0.1.0-beta.1

package/build/esm/object-table/hooks/__tests__/useDefaultTableStates.test.js

@@ -0,0 +1,178 @@
+/*
+ * Copyright 2025 Palantir Technologies, Inc. All rights reserved.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import { renderHook, waitFor } from "@testing-library/react";
+import { describe, expect, it } from "vitest";
+import { useDefaultTableStates } from "../useDefaultTableStates.js";
+const TestObjectType = {
+  type: "object",
+  apiName: "TestObject"
+};
+describe(useDefaultTableStates, () => {
+  it("returns undefined columnVisibility when no columnDefinitions provided", () => {
+    const {
+      result
+    } = renderHook(() => useDefaultTableStates({
+      columnDefinitions: undefined
+    }));
+    expect(result.current.columnVisibility).toBeUndefined();
+  });
+  it("returns empty columnVisibility when columnDefinitions have no isVisible properties", () => {
+    const columnDefinitions = [{
+      locator: {
+        type: "property",
+        id: "name"
+      }
+    }, {
+      locator: {
+        type: "property",
+        id: "email"
+      }
+    }];
+    const {
+      result
+    } = renderHook(() => useDefaultTableStates({
+      columnDefinitions
+    }));
+    expect(result.current.columnVisibility).toEqual({});
+  });
+  it("handles mixed column types with different visibility states", async () => {
+    const columnDefinitions = [{
+      locator: {
+        type: "property",
+        id: "name"
+      },
+      isVisible: true
+    }, {
+      locator: {
+        type: "function",
+        id: "myFunction"
+      },
+      isVisible: false
+    }, {
+      locator: {
+        type: "rdp",
+        id: "myRdp",
+        creator: () => ({})
+      },
+      isVisible: true
+    }, {
+      locator: {
+        type: "property",
+        id: "email"
+      }
+    }];
+    const {
+      result
+    } = renderHook(() => useDefaultTableStates({
+      columnDefinitions
+    }));
+    await waitFor(() => {
+      expect(result.current.columnVisibility).toEqual({
+        name: true,
+        myFunction: false,
+        myRdp: true
+      });
+    });
+  });
+  it("updates columnVisibility when columnDefinitions change", async () => {
+    const {
+      result,
+      rerender
+    } = renderHook(({
+      columnDefinitions
+    }) => useDefaultTableStates({
+      columnDefinitions
+    }), {
+      initialProps: {
+        columnDefinitions: [{
+          locator: {
+            type: "property",
+            id: "name"
+          },
+          isVisible: true
+        }]
+      }
+    });
+    await waitFor(() => {
+      expect(result.current.columnVisibility).toEqual({
+        name: true
+      });
+    });
+    rerender({
+      columnDefinitions: [{
+        locator: {
+          type: "property",
+          id: "name"
+        },
+        isVisible: false
+      }, {
+        locator: {
+          type: "property",
+          id: "email"
+        },
+        isVisible: true
+      }]
+    });
+    await waitFor(() => {
+      expect(result.current.columnVisibility).toEqual({
+        name: false,
+        email: true
+      });
+    });
+  });
+  it("only includes columns with explicit isVisible in the visibility state", async () => {
+    const columnDefinitions = [{
+      locator: {
+        type: "property",
+        id: "name"
+      },
+      isVisible: true
+    }, {
+      locator: {
+        type: "property",
+        id: "email"
+      }
+    }, {
+      locator: {
+        type: "property",
+        id: "age"
+      },
+      isVisible: false
+    }, {
+      locator: {
+        type: "property",
+        id: "id"
+      }
+    }];
+    const {
+      result
+    } = renderHook(() => useDefaultTableStates({
+      columnDefinitions
+    }));
+    await waitFor(() => {
+      expect(result.current.columnVisibility).toEqual({
+        name: true,
+        age: false
+      });
+    });
+
+    // Verify that columns without isVisible are not in the state
+    expect(result.current.columnVisibility).not.toHaveProperty("email");
+    expect(result.current.columnVisibility).not.toHaveProperty("id");
+  });
+});
+//# sourceMappingURL=useDefaultTableStates.test.js.map

package/build/esm/object-table/hooks/__tests__/useDefaultTableStates.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDefaultTableStates.test.js","names":["renderHook","waitFor","describe","expect","it","useDefaultTableStates","TestObjectType","type","apiName","result","columnDefinitions","undefined","current","columnVisibility","toBeUndefined","locator","id","toEqual","isVisible","creator","name","myFunction","myRdp","rerender","initialProps","email","age","not","toHaveProperty"],"sources":["useDefaultTableStates.test.tsx"],"sourcesContent":["/*\n * Copyright 2025 Palantir Technologies, Inc. All rights reserved.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport type {\n  DerivedProperty,\n  ObjectTypeDefinition,\n  PropertyKeys,\n  QueryDefinition,\n  SimplePropertyDef,\n} from \"@osdk/api\";\nimport { renderHook, waitFor } from \"@testing-library/react\";\nimport { describe, expect, it } from \"vitest\";\nimport type { ColumnDefinition } from \"../../ObjectTableApi.js\";\nimport { useDefaultTableStates } from \"../useDefaultTableStates.js\";\n\nconst TestObjectType = {\n  type: \"object\",\n  apiName: \"TestObject\",\n} as const satisfies ObjectTypeDefinition;\n\ntype TestObject = typeof TestObjectType;\ntype TestObjectKeys = PropertyKeys<TestObject>;\n\ndescribe(useDefaultTableStates, () => {\n  it(\"returns undefined columnVisibility when no columnDefinitions provided\", () => {\n    const { result } = renderHook(() =>\n      useDefaultTableStates({\n        columnDefinitions: undefined,\n      })\n    );\n\n    expect(result.current.columnVisibility).toBeUndefined();\n  });\n\n  it(\"returns empty columnVisibility when columnDefinitions have no isVisible properties\", () => {\n    const columnDefinitions: Array<ColumnDefinition<TestObject, {}, {}>> = [\n      {\n        locator: { type: \"property\", id: \"name\" as TestObjectKeys },\n      },\n      {\n        locator: { type: \"property\", id: \"email\" as TestObjectKeys },\n      },\n    ];\n\n    const { result } = renderHook(() =>\n      useDefaultTableStates({\n        columnDefinitions,\n      })\n    );\n\n    expect(result.current.columnVisibility).toEqual({});\n  });\n\n  it(\"handles mixed column types with different visibility states\", async () => {\n    const mockRdpCreator = (() => ({})) as unknown as DerivedProperty.Creator<\n      TestObject,\n      SimplePropertyDef\n    >;\n\n    const columnDefinitions: Array<\n      ColumnDefinition<\n        TestObject,\n        { myRdp: SimplePropertyDef },\n        { myFunction: QueryDefinition<{}> }\n      >\n    > = [\n      {\n        locator: { type: \"property\", id: \"name\" as TestObjectKeys },\n        isVisible: true,\n      },\n      {\n        locator: { type: \"function\", id: \"myFunction\" },\n        isVisible: false,\n      },\n      {\n        locator: { type: \"rdp\", id: \"myRdp\", creator: mockRdpCreator },\n        isVisible: true,\n      },\n      {\n        locator: { type: \"property\", id: \"email\" as TestObjectKeys },\n      },\n    ];\n\n    const { result } = renderHook(() =>\n      useDefaultTableStates({\n        columnDefinitions,\n      })\n    );\n\n    await waitFor(() => {\n      expect(result.current.columnVisibility).toEqual({\n        name: true,\n        myFunction: false,\n        myRdp: true,\n      });\n    });\n  });\n\n  it(\"updates columnVisibility when columnDefinitions change\", async () => {\n    const initialColumnDefinitions: Array<\n      ColumnDefinition<TestObject, {}, {}>\n    > = [\n      {\n        locator: { type: \"property\", id: \"name\" as TestObjectKeys },\n        isVisible: true,\n      },\n    ];\n\n    const { result, rerender } = renderHook(\n      ({ columnDefinitions }) =>\n        useDefaultTableStates({\n          columnDefinitions,\n        }),\n      {\n        initialProps: { columnDefinitions: initialColumnDefinitions },\n      },\n    );\n\n    await waitFor(() => {\n      expect(result.current.columnVisibility).toEqual({\n        name: true,\n      });\n    });\n\n    const updatedColumnDefinitions: Array<\n      ColumnDefinition<TestObject, {}, {}>\n    > = [\n      {\n        locator: { type: \"property\", id: \"name\" as TestObjectKeys },\n        isVisible: false,\n      },\n      {\n        locator: { type: \"property\", id: \"email\" as TestObjectKeys },\n        isVisible: true,\n      },\n    ];\n\n    rerender({ columnDefinitions: updatedColumnDefinitions });\n\n    await waitFor(() => {\n      expect(result.current.columnVisibility).toEqual({\n        name: false,\n        email: true,\n      });\n    });\n  });\n\n  it(\"only includes columns with explicit isVisible in the visibility state\", async () => {\n    const columnDefinitions: Array<ColumnDefinition<TestObject, {}, {}>> = [\n      {\n        locator: { type: \"property\", id: \"name\" as TestObjectKeys },\n        isVisible: true,\n      },\n      {\n        locator: { type: \"property\", id: \"email\" as TestObjectKeys },\n      },\n      {\n        locator: { type: \"property\", id: \"age\" as TestObjectKeys },\n        isVisible: false,\n      },\n      {\n        locator: { type: \"property\", id: \"id\" as TestObjectKeys },\n      },\n    ];\n\n    const { result } = renderHook(() =>\n      useDefaultTableStates({\n        columnDefinitions,\n      })\n    );\n\n    await waitFor(() => {\n      expect(result.current.columnVisibility).toEqual({\n        name: true,\n        age: false,\n      });\n    });\n\n    // Verify that columns without isVisible are not in the state\n    expect(result.current.columnVisibility).not.toHaveProperty(\"email\");\n    expect(result.current.columnVisibility).not.toHaveProperty(\"id\");\n  });\n});\n"],"mappings":"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","ignoreList":[]}

package/build/esm/object-table/hooks/__tests__/useObjectTableData.test.js

@@ -0,0 +1,217 @@
+/*
+ * Copyright 2025 Palantir Technologies, Inc. All rights reserved.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import { OsdkProvider } from "@osdk/react";
+import { renderHook } from "@testing-library/react";
+import * as React from "react";
+import { describe, expect, it, vi } from "vitest";
+import { useObjectTableData } from "../useObjectTableData.js";
+vi.mock("@osdk/react/experimental", () => ({
+  useObjectSet: vi.fn((objectSet, options) => {
+    return {
+      data: [],
+      isLoading: false,
+      error: undefined,
+      fetchNextPage: vi.fn(),
+      hasNextPage: false,
+      isFetchingNextPage: false,
+      // Return the options to verify they were passed correctly
+      _testOptions: options
+    };
+  })
+}));
+const TestObjectType = {
+  type: "object",
+  apiName: "TestObject"
+};
+const mockObjectSet = {
+  objectType: TestObjectType
+};
+describe(useObjectTableData, () => {
+  const wrapper = (client => {
+    return ({
+      children
+    }) => {
+      return /*#__PURE__*/React.createElement(OsdkProvider, {
+        client: client
+      }, children);
+    };
+  })({});
+  it("calls useObjectSet with pageSize of 50", () => {
+    const {
+      result
+    } = renderHook(() => useObjectTableData(mockObjectSet), {
+      wrapper
+    });
+    const mockResult = result.current;
+    expect(mockResult._testOptions).toEqual({
+      withProperties: undefined,
+      pageSize: 50
+    });
+  });
+  it("calls useObjectSet without withProperties when no columnDefinitions provided", () => {
+    const {
+      result
+    } = renderHook(() => useObjectTableData(mockObjectSet, undefined), {
+      wrapper
+    });
+    const mockResult = result.current;
+    expect(mockResult._testOptions.withProperties).toBeUndefined();
+    expect(mockResult._testOptions.pageSize).toBe(50);
+  });
+  it("calls useObjectSet without withProperties when columnDefinitions have no RDP columns", () => {
+    const columnDefinitions = [{
+      locator: {
+        type: "property",
+        id: "name"
+      }
+    }, {
+      locator: {
+        type: "property",
+        id: "email"
+      }
+    }];
+    const {
+      result
+    } = renderHook(() => useObjectTableData(mockObjectSet, columnDefinitions), {
+      wrapper
+    });
+    const mockResult = result.current;
+    expect(mockResult._testOptions.withProperties).toEqual({});
+    expect(mockResult._testOptions.pageSize).toBe(50);
+  });
+  it("extracts RDP creators and passes them to useObjectSet", () => {
+    const mockRdpCreator1 = vi.fn();
+    const mockRdpCreator2 = vi.fn();
+    const columnDefinitions = [{
+      locator: {
+        type: "property",
+        id: "name"
+      }
+    }, {
+      locator: {
+        type: "rdp",
+        id: "rdp1",
+        creator: mockRdpCreator1
+      }
+    }, {
+      locator: {
+        type: "rdp",
+        id: "rdp2",
+        creator: mockRdpCreator2
+      }
+    }, {
+      locator: {
+        type: "function",
+        id: "myFunction"
+      }
+    }];
+    const {
+      result
+    } = renderHook(() => useObjectTableData(mockObjectSet, columnDefinitions), {
+      wrapper
+    });
+    const mockResult = result.current;
+    expect(mockResult._testOptions.withProperties).toEqual({
+      rdp1: mockRdpCreator1,
+      rdp2: mockRdpCreator2
+    });
+  });
+  it("memoizes withProperties based on columnDefinitions", () => {
+    const mockRdpCreator = vi.fn();
+    const columnDefinitions = [{
+      locator: {
+        type: "rdp",
+        id: "myRdp",
+        creator: mockRdpCreator
+      }
+    }];
+    const {
+      result,
+      rerender
+    } = renderHook(({
+      colDefs
+    }) => useObjectTableData(mockObjectSet, colDefs), {
+      initialProps: {
+        colDefs: columnDefinitions
+      },
+      wrapper
+    });
+    const firstMockResult = result.current;
+    const firstWithProperties = firstMockResult._testOptions.withProperties;
+
+    // Rerender with same columnDefinitions reference
+    rerender({
+      colDefs: columnDefinitions
+    });
+
+    // Should be the same reference (memoized)
+    const secondMockResult = result.current;
+    expect(secondMockResult._testOptions.withProperties).toBe(firstWithProperties);
+  });
+  it("updates withProperties when columnDefinitions change", () => {
+    const mockRdpCreator1 = vi.fn();
+    const mockRdpCreator2 = vi.fn();
+    const {
+      result,
+      rerender
+    } = renderHook(({
+      colDefs
+    }) => useObjectTableData(mockObjectSet, colDefs), {
+      initialProps: {
+        colDefs: [{
+          locator: {
+            type: "rdp",
+            id: "rdp1",
+            creator: mockRdpCreator1
+          }
+        }]
+      },
+      wrapper
+    });
+    const firstMockResult = result.current;
+    expect(firstMockResult._testOptions.withProperties).toEqual({
+      rdp1: mockRdpCreator1
+    });
+    rerender({
+      colDefs: [{
+        locator: {
+          type: "rdp",
+          id: "rdp2",
+          creator: mockRdpCreator2
+        }
+      }]
+    });
+    const secondMockResult = result.current;
+    expect(secondMockResult._testOptions.withProperties).toEqual({
+      rdp2: mockRdpCreator2
+    });
+  });
+  it("returns useObjectSet result structure", () => {
+    const {
+      result
+    } = renderHook(() => useObjectTableData(mockObjectSet), {
+      wrapper
+    });
+    expect(result.current).toHaveProperty("data");
+    expect(result.current).toHaveProperty("isLoading");
+    expect(result.current).toHaveProperty("error");
+    expect(result.current).toHaveProperty("fetchNextPage");
+    expect(result.current).toHaveProperty("hasNextPage");
+    expect(result.current).toHaveProperty("isFetchingNextPage");
+  });
+});
+//# sourceMappingURL=useObjectTableData.test.js.map

package/build/esm/object-table/hooks/__tests__/useObjectTableData.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useObjectTableData.test.js","names":["OsdkProvider","renderHook","React","describe","expect","it","vi","useObjectTableData","mock","useObjectSet","fn","objectSet","options","data","isLoading","error","undefined","fetchNextPage","hasNextPage","isFetchingNextPage","_testOptions","TestObjectType","type","apiName","mockObjectSet","objectType","wrapper","client","children","createElement","result","mockResult","current","toEqual","withProperties","pageSize","toBeUndefined","toBe","columnDefinitions","locator","id","mockRdpCreator1","mockRdpCreator2","creator","rdp1","rdp2","mockRdpCreator","rerender","colDefs","initialProps","firstMockResult","firstWithProperties","secondMockResult","toHaveProperty"],"sources":["useObjectTableData.test.tsx"],"sourcesContent":["/*\n * Copyright 2025 Palantir Technologies, Inc. All rights reserved.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport type {\n  DerivedProperty,\n  ObjectSet,\n  ObjectTypeDefinition,\n  PropertyKeys,\n  SimplePropertyDef,\n} from \"@osdk/api\";\nimport type { Client } from \"@osdk/client\";\nimport { OsdkProvider } from \"@osdk/react\";\nimport { renderHook } from \"@testing-library/react\";\nimport * as React from \"react\";\nimport { describe, expect, it, vi } from \"vitest\";\nimport type { ColumnDefinition } from \"../../ObjectTableApi.js\";\nimport { useObjectTableData } from \"../useObjectTableData.js\";\n\ninterface MockUseObjectSetReturn {\n  data: [];\n  isLoading: false;\n  error: undefined;\n  fetchNextPage: ReturnType<typeof vi.fn>;\n  hasNextPage: false;\n  isFetchingNextPage: false;\n  _testOptions: {\n    withProperties?: Record<string, unknown>;\n    pageSize: number;\n  };\n}\n\nvi.mock(\"@osdk/react/experimental\", () => ({\n  useObjectSet: vi.fn((objectSet, options): MockUseObjectSetReturn => {\n    return {\n      data: [],\n      isLoading: false,\n      error: undefined,\n      fetchNextPage: vi.fn(),\n      hasNextPage: false,\n      isFetchingNextPage: false,\n      // Return the options to verify they were passed correctly\n      _testOptions: options,\n    };\n  }),\n}));\n\nconst TestObjectType = {\n  type: \"object\",\n  apiName: \"TestObject\",\n} as const satisfies ObjectTypeDefinition;\n\ntype TestObject = typeof TestObjectType;\ntype TestObjectKeys = PropertyKeys<TestObject>;\n\nconst mockObjectSet = {\n  objectType: TestObjectType,\n} as unknown as ObjectSet<TestObject>;\n\ndescribe(useObjectTableData, () => {\n  const createWrapper = (client: Client) => {\n    return ({ children }: React.PropsWithChildren) => {\n      return <OsdkProvider client={client}>{children}</OsdkProvider>;\n    };\n  };\n\n  const fakeClient = {} as unknown as Client;\n  const wrapper = createWrapper(fakeClient);\n\n  it(\"calls useObjectSet with pageSize of 50\", () => {\n    const { result } = renderHook(\n      () => useObjectTableData(mockObjectSet),\n      { wrapper },\n    );\n\n    const mockResult = result.current as unknown as MockUseObjectSetReturn;\n    expect(mockResult._testOptions).toEqual({\n      withProperties: undefined,\n      pageSize: 50,\n    });\n  });\n\n  it(\"calls useObjectSet without withProperties when no columnDefinitions provided\", () => {\n    const { result } = renderHook(\n      () => useObjectTableData(mockObjectSet, undefined),\n      { wrapper },\n    );\n\n    const mockResult = result.current as unknown as MockUseObjectSetReturn;\n    expect(mockResult._testOptions.withProperties).toBeUndefined();\n    expect(mockResult._testOptions.pageSize).toBe(50);\n  });\n\n  it(\"calls useObjectSet without withProperties when columnDefinitions have no RDP columns\", () => {\n    const columnDefinitions: Array<ColumnDefinition<TestObject, {}, {}>> = [\n      {\n        locator: { type: \"property\", id: \"name\" as TestObjectKeys },\n      },\n      {\n        locator: { type: \"property\", id: \"email\" as TestObjectKeys },\n      },\n    ];\n\n    const { result } = renderHook(\n      () => useObjectTableData(mockObjectSet, columnDefinitions),\n      { wrapper },\n    );\n\n    const mockResult = result.current as unknown as MockUseObjectSetReturn;\n    expect(mockResult._testOptions.withProperties).toEqual({});\n    expect(mockResult._testOptions.pageSize).toBe(50);\n  });\n\n  it(\"extracts RDP creators and passes them to useObjectSet\", () => {\n    const mockRdpCreator1 = vi.fn() as unknown as DerivedProperty.Creator<\n      TestObject,\n      SimplePropertyDef\n    >;\n    const mockRdpCreator2 = vi.fn() as unknown as DerivedProperty.Creator<\n      TestObject,\n      SimplePropertyDef\n    >;\n\n    const columnDefinitions: Array<\n      ColumnDefinition<\n        TestObject,\n        { rdp1: any; rdp2: any },\n        { myFunction: any }\n      >\n    > = [\n      {\n        locator: { type: \"property\", id: \"name\" as TestObjectKeys },\n      },\n      {\n        locator: { type: \"rdp\", id: \"rdp1\", creator: mockRdpCreator1 },\n      },\n      {\n        locator: { type: \"rdp\", id: \"rdp2\", creator: mockRdpCreator2 },\n      },\n      {\n        locator: { type: \"function\", id: \"myFunction\" },\n      },\n    ];\n\n    const { result } = renderHook(\n      () => useObjectTableData(mockObjectSet, columnDefinitions),\n      { wrapper },\n    );\n\n    const mockResult = result.current as unknown as MockUseObjectSetReturn;\n    expect(mockResult._testOptions.withProperties).toEqual({\n      rdp1: mockRdpCreator1,\n      rdp2: mockRdpCreator2,\n    });\n  });\n\n  it(\"memoizes withProperties based on columnDefinitions\", () => {\n    const mockRdpCreator = vi.fn() as unknown as DerivedProperty.Creator<\n      TestObject,\n      SimplePropertyDef\n    >;\n\n    const columnDefinitions: Array<\n      ColumnDefinition<TestObject, { myRdp: any }, {}>\n    > = [\n      {\n        locator: { type: \"rdp\", id: \"myRdp\", creator: mockRdpCreator },\n      },\n    ];\n\n    const { result, rerender } = renderHook(\n      ({ colDefs }) => useObjectTableData(mockObjectSet, colDefs),\n      {\n        initialProps: { colDefs: columnDefinitions },\n        wrapper,\n      },\n    );\n\n    const firstMockResult = result.current as unknown as MockUseObjectSetReturn;\n    const firstWithProperties = firstMockResult._testOptions.withProperties;\n\n    // Rerender with same columnDefinitions reference\n    rerender({ colDefs: columnDefinitions });\n\n    // Should be the same reference (memoized)\n    const secondMockResult = result\n      .current as unknown as MockUseObjectSetReturn;\n    expect(secondMockResult._testOptions.withProperties).toBe(\n      firstWithProperties,\n    );\n  });\n\n  it(\"updates withProperties when columnDefinitions change\", () => {\n    const mockRdpCreator1 = vi.fn() as unknown as DerivedProperty.Creator<\n      TestObject,\n      SimplePropertyDef\n    >;\n    const mockRdpCreator2 = vi.fn() as unknown as DerivedProperty.Creator<\n      TestObject,\n      SimplePropertyDef\n    >;\n\n    const initialColumnDefinitions: Array<\n      ColumnDefinition<TestObject, { rdp1: any }, {}>\n    > = [\n      {\n        locator: { type: \"rdp\", id: \"rdp1\", creator: mockRdpCreator1 },\n      },\n    ];\n\n    type ColDefs =\n      | Array<\n        ColumnDefinition<TestObject, Record<string, SimplePropertyDef>, {}>\n      >\n      | undefined;\n\n    const { result, rerender } = renderHook(\n      ({ colDefs }: { colDefs: ColDefs }) =>\n        useObjectTableData(mockObjectSet, colDefs),\n      {\n        initialProps: { colDefs: initialColumnDefinitions as ColDefs },\n        wrapper,\n      },\n    );\n\n    const firstMockResult = result.current as unknown as MockUseObjectSetReturn;\n    expect(firstMockResult._testOptions.withProperties).toEqual({\n      rdp1: mockRdpCreator1,\n    });\n\n    const updatedColumnDefinitions: Array<\n      ColumnDefinition<TestObject, { rdp2: SimplePropertyDef }, {}>\n    > = [\n      {\n        locator: { type: \"rdp\", id: \"rdp2\", creator: mockRdpCreator2 },\n      },\n    ];\n\n    rerender({ colDefs: updatedColumnDefinitions as ColDefs });\n\n    const secondMockResult = result\n      .current as unknown as MockUseObjectSetReturn;\n    expect(secondMockResult._testOptions.withProperties).toEqual({\n      rdp2: mockRdpCreator2,\n    });\n  });\n\n  it(\"returns useObjectSet result structure\", () => {\n    const { result } = renderHook(\n      () => useObjectTableData(mockObjectSet),\n      { wrapper },\n    );\n\n    expect(result.current).toHaveProperty(\"data\");\n    expect(result.current).toHaveProperty(\"isLoading\");\n    expect(result.current).toHaveProperty(\"error\");\n    expect(result.current).toHaveProperty(\"fetchNextPage\");\n    expect(result.current).toHaveProperty(\"hasNextPage\");\n    expect(result.current).toHaveProperty(\"isFetchingNextPage\");\n  });\n});\n"],"mappings":"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","ignoreList":[]}

package/build/esm/object-table/hooks/useColumnDefs.js

@@ -0,0 +1,87 @@
+/*
+ * Copyright 2025 Palantir Technologies, Inc. All rights reserved.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import { useOsdkMetadata } from "@osdk/react";
+import { useMemo } from "react";
+/**
+ * Hook which builds column definitions for tanstack-table given the objectSet
+ */
+export function useColumnDefs(objectType, columnDefinitions) {
+  const {
+    metadata,
+    loading,
+    error
+  } = useOsdkMetadata(objectType);
+  const columns = useMemo(() => {
+    const objectProperties = metadata?.properties;
+    // If columnDefinitions is provided, construct colDefs with it
+    if (columnDefinitions) {
+      return getColumnsFromColumnDefinitions(columnDefinitions, objectProperties);
+    }
+
+    // If not, return the default columns from the object properties
+    return getDefaultColumns(objectProperties);
+  }, [columnDefinitions, metadata?.properties]);
+  return {
+    columns,
+    loading,
+    error
+  };
+}
+function getColumnsFromColumnDefinitions(columnDefinitions, objectProperties) {
+  return columnDefinitions.map(col => {
+    const {
+      locator,
+      width,
+      minWidth,
+      maxWidth,
+      resizable,
+      orderable,
+      filterable,
+      renderCell,
+      renderHeader
+    } = col;
+    const propertyMetadata = locator.type === "property" ? objectProperties?.[locator.id] : undefined;
+    const colKey = locator.id;
+    const colDef = {
+      id: colKey,
+      accessorKey: colKey,
+      header: renderHeader ?? propertyMetadata?.displayName,
+      size: width,
+      minSize: minWidth,
+      maxSize: maxWidth,
+      enableResizing: resizable,
+      enableSorting: orderable,
+      enableColumnFilter: filterable,
+      cell: cellContext => {
+        const object = cellContext.row.original;
+        return renderCell ? renderCell(object, locator) : cellContext.getValue();
+      }
+    };
+    return colDef;
+  });
+}
+function getDefaultColumns(objectProperties) {
+  if (!objectProperties) return [];
+  return Object.entries(objectProperties).map(([key, property]) => {
+    const colDef = {
+      accessorKey: key,
+      header: property.displayName ?? key
+    };
+    return colDef;
+  });
+}
+//# sourceMappingURL=useColumnDefs.js.map

package/build/esm/object-table/hooks/useColumnDefs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useColumnDefs.js","names":["useOsdkMetadata","useMemo","useColumnDefs","objectType","columnDefinitions","metadata","loading","error","columns","objectProperties","properties","getColumnsFromColumnDefinitions","getDefaultColumns","map","col","locator","width","minWidth","maxWidth","resizable","orderable","filterable","renderCell","renderHeader","propertyMetadata","type","id","undefined","colKey","colDef","accessorKey","header","displayName","size","minSize","maxSize","enableResizing","enableSorting","enableColumnFilter","cell","cellContext","object","row","original","getValue","Object","entries","key","property"],"sources":["useColumnDefs.ts"],"sourcesContent":["/*\n * Copyright 2025 Palantir Technologies, Inc. All rights reserved.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport type {\n  ObjectMetadata,\n  ObjectTypeDefinition,\n  Osdk,\n  PropertyKeys,\n  QueryDefinition,\n  SimplePropertyDef,\n} from \"@osdk/api\";\nimport { useOsdkMetadata } from \"@osdk/react\";\nimport type { AccessorColumnDef } from \"@tanstack/react-table\";\nimport { useMemo } from \"react\";\nimport type { ColumnDefinition } from \"../ObjectTableApi.js\";\n\ninterface UseColumnDefsResult<\n  Q extends ObjectTypeDefinition,\n  RDPs extends Record<string, SimplePropertyDef> = Record<\n    string,\n    never\n  >,\n> {\n  columns: AccessorColumnDef<\n    Osdk.Instance<Q, \"$allBaseProperties\", PropertyKeys<Q>, RDPs>\n  >[];\n\n  loading: boolean;\n\n  error: string | undefined;\n}\n\n/**\n * Hook which builds column definitions for tanstack-table given the objectSet\n */\nexport function useColumnDefs<\n  Q extends ObjectTypeDefinition,\n  RDPs extends Record<string, SimplePropertyDef> = Record<\n    string,\n    never\n  >,\n  FunctionColumns extends Record<string, QueryDefinition<{}>> = Record<\n    string,\n    never\n  >,\n>(\n  objectType: Q,\n  columnDefinitions?: Array<ColumnDefinition<Q, RDPs, FunctionColumns>>,\n): UseColumnDefsResult<Q, RDPs> {\n  const { metadata, loading, error } = useOsdkMetadata(objectType);\n\n  const columns = useMemo(() => {\n    const objectProperties = metadata?.properties;\n    // If columnDefinitions is provided, construct colDefs with it\n    if (columnDefinitions) {\n      return getColumnsFromColumnDefinitions<Q, RDPs, FunctionColumns>(\n        columnDefinitions,\n        objectProperties,\n      );\n    }\n\n    // If not, return the default columns from the object properties\n    return getDefaultColumns<Q, RDPs>(objectProperties);\n  }, [columnDefinitions, metadata?.properties]);\n\n  return { columns, loading, error };\n}\n\nfunction getColumnsFromColumnDefinitions<\n  Q extends ObjectTypeDefinition,\n  RDPs extends Record<string, SimplePropertyDef> = Record<\n    string,\n    never\n  >,\n  FunctionColumns extends Record<string, QueryDefinition<{}>> = Record<\n    string,\n    never\n  >,\n>(\n  columnDefinitions: Array<ColumnDefinition<Q, RDPs, FunctionColumns>>,\n  objectProperties?: Record<any, ObjectMetadata.Property>,\n): Array<\n  AccessorColumnDef<\n    Osdk.Instance<Q, \"$allBaseProperties\", PropertyKeys<Q>, RDPs>\n  >\n> {\n  return columnDefinitions.map((col) => {\n    const {\n      locator,\n      width,\n      minWidth,\n      maxWidth,\n      resizable,\n      orderable,\n      filterable,\n      renderCell,\n      renderHeader,\n    } = col;\n\n    const propertyMetadata = locator.type === \"property\"\n      ? objectProperties?.[locator.id]\n      : undefined;\n\n    const colKey = locator.id as string;\n\n    const colDef: AccessorColumnDef<\n      Osdk.Instance<Q, \"$allBaseProperties\", PropertyKeys<Q>, RDPs>\n    > = {\n      id: colKey,\n      accessorKey: colKey,\n      header: renderHeader ?? propertyMetadata?.displayName,\n      size: width,\n      minSize: minWidth,\n      maxSize: maxWidth,\n      enableResizing: resizable,\n      enableSorting: orderable,\n      enableColumnFilter: filterable,\n      cell: (cellContext) => {\n        const object: Osdk.Instance<\n          Q,\n          \"$allBaseProperties\",\n          PropertyKeys<Q>,\n          RDPs\n        > = cellContext.row.original;\n\n        return renderCell\n          ? renderCell(object, locator)\n          : cellContext.getValue();\n      },\n    };\n\n    return colDef;\n  });\n}\n\nfunction getDefaultColumns<\n  Q extends ObjectTypeDefinition,\n  RDPs extends Record<string, SimplePropertyDef> = Record<\n    string,\n    never\n  >,\n>(\n  objectProperties?: Record<any, ObjectMetadata.Property>,\n): Array<\n  AccessorColumnDef<\n    Osdk.Instance<Q, \"$allBaseProperties\", PropertyKeys<Q>, RDPs>\n  >\n> {\n  if (!objectProperties) return [];\n\n  return Object.entries(objectProperties).map(([key, property]) => {\n    const colDef: AccessorColumnDef<\n      Osdk.Instance<Q, \"$allBaseProperties\", PropertyKeys<Q>, RDPs>\n    > = {\n      accessorKey: key,\n      header: property.displayName ?? key,\n    };\n    return colDef;\n  });\n}\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAUA,SAASA,eAAe,QAAQ,aAAa;AAE7C,SAASC,OAAO,QAAQ,OAAO;AAmB/B;AACA;AACA;AACA,OAAO,SAASC,aAAaA,CAW3BC,UAAa,EACbC,iBAAqE,EACvC;EAC9B,MAAM;IAAEC,QAAQ;IAAEC,OAAO;IAAEC;EAAM,CAAC,GAAGP,eAAe,CAACG,UAAU,CAAC;EAEhE,MAAMK,OAAO,GAAGP,OAAO,CAAC,MAAM;IAC5B,MAAMQ,gBAAgB,GAAGJ,QAAQ,EAAEK,UAAU;IAC7C;IACA,IAAIN,iBAAiB,EAAE;MACrB,OAAOO,+BAA+B,CACpCP,iBAAiB,EACjBK,gBACF,CAAC;IACH;;IAEA;IACA,OAAOG,iBAAiB,CAAUH,gBAAgB,CAAC;EACrD,CAAC,EAAE,CAACL,iBAAiB,EAAEC,QAAQ,EAAEK,UAAU,CAAC,CAAC;EAE7C,OAAO;IAAEF,OAAO;IAAEF,OAAO;IAAEC;EAAM,CAAC;AACpC;AAEA,SAASI,+BAA+BA,CAWtCP,iBAAoE,EACpEK,gBAAuD,EAKvD;EACA,OAAOL,iBAAiB,CAACS,GAAG,CAAEC,GAAG,IAAK;IACpC,MAAM;MACJC,OAAO;MACPC,KAAK;MACLC,QAAQ;MACRC,QAAQ;MACRC,SAAS;MACTC,SAAS;MACTC,UAAU;MACVC,UAAU;MACVC;IACF,CAAC,GAAGT,GAAG;IAEP,MAAMU,gBAAgB,GAAGT,OAAO,CAACU,IAAI,KAAK,UAAU,GAChDhB,gBAAgB,GAAGM,OAAO,CAACW,EAAE,CAAC,GAC9BC,SAAS;IAEb,MAAMC,MAAM,GAAGb,OAAO,CAACW,EAAY;IAEnC,MAAMG,MAEL,GAAG;MACFH,EAAE,EAAEE,MAAM;MACVE,WAAW,EAAEF,MAAM;MACnBG,MAAM,EAAER,YAAY,IAAIC,gBAAgB,EAAEQ,WAAW;MACrDC,IAAI,EAAEjB,KAAK;MACXkB,OAAO,EAAEjB,QAAQ;MACjBkB,OAAO,EAAEjB,QAAQ;MACjBkB,cAAc,EAAEjB,SAAS;MACzBkB,aAAa,EAAEjB,SAAS;MACxBkB,kBAAkB,EAAEjB,UAAU;MAC9BkB,IAAI,EAAGC,WAAW,IAAK;QACrB,MAAMC,MAKL,GAAGD,WAAW,CAACE,GAAG,CAACC,QAAQ;QAE5B,OAAOrB,UAAU,GACbA,UAAU,CAACmB,MAAM,EAAE1B,OAAO,CAAC,GAC3ByB,WAAW,CAACI,QAAQ,CAAC,CAAC;MAC5B;IACF,CAAC;IAED,OAAOf,MAAM;EACf,CAAC,CAAC;AACJ;AAEA,SAASjB,iBAAiBA,CAOxBH,gBAAuD,EAKvD;EACA,IAAI,CAACA,gBAAgB,EAAE,OAAO,EAAE;EAEhC,OAAOoC,MAAM,CAACC,OAAO,CAACrC,gBAAgB,CAAC,CAACI,GAAG,CAAC,CAAC,CAACkC,GAAG,EAAEC,QAAQ,CAAC,KAAK;IAC/D,MAAMnB,MAEL,GAAG;MACFC,WAAW,EAAEiB,GAAG;MAChBhB,MAAM,EAAEiB,QAAQ,CAAChB,WAAW,IAAIe;IAClC,CAAC;IACD,OAAOlB,MAAM;EACf,CAAC,CAAC;AACJ","ignoreList":[]}

package/build/esm/object-table/hooks/useDefaultTableStates.js

@@ -0,0 +1,43 @@
+/*
+ * Copyright 2025 Palantir Technologies, Inc. All rights reserved.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import { useMemo } from "react";
+export const useDefaultTableStates = ({
+  columnDefinitions
+}) => {
+  const columnVisibility = useMemo(() => {
+    if (columnDefinitions) {
+      const colVisibility = columnDefinitions.reduce((acc, colDef) => {
+        if (colDef.isVisible !== undefined) {
+          const {
+            locator
+          } = colDef;
+          const colKey = locator.id;
+          return {
+            ...acc,
+            [colKey]: colDef.isVisible
+          };
+        }
+        return acc;
+      }, {});
+      return colVisibility;
+    }
+  }, [columnDefinitions]);
+  return {
+    columnVisibility
+  };
+};
+//# sourceMappingURL=useDefaultTableStates.js.map

package/build/esm/object-table/hooks/useDefaultTableStates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDefaultTableStates.js","names":["useMemo","useDefaultTableStates","columnDefinitions","columnVisibility","colVisibility","reduce","acc","colDef","isVisible","undefined","locator","colKey","id"],"sources":["useDefaultTableStates.ts"],"sourcesContent":["/*\n * Copyright 2025 Palantir Technologies, Inc. All rights reserved.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport type {\n  ObjectTypeDefinition,\n  QueryDefinition,\n  SimplePropertyDef,\n} from \"@osdk/api\";\nimport type { VisibilityState } from \"@tanstack/react-table\";\nimport { useMemo } from \"react\";\nimport type { ObjectTableProps } from \"../ObjectTableApi.js\";\n\ninterface UseDefaultTableStatesProps<\n  Q extends ObjectTypeDefinition,\n  RDPs extends Record<string, SimplePropertyDef> = {},\n  FunctionColumns extends Record<string, QueryDefinition<{}>> = Record<\n    string,\n    never\n  >,\n> {\n  columnDefinitions: ObjectTableProps<\n    Q,\n    RDPs,\n    FunctionColumns\n  >[\"columnDefinitions\"];\n}\n\ninterface UseDefaultTableStatesResult {\n  columnVisibility: VisibilityState | undefined;\n}\n\nexport const useDefaultTableStates = <\n  Q extends ObjectTypeDefinition,\n  RDPs extends Record<string, SimplePropertyDef> = {},\n  FunctionColumns extends Record<string, QueryDefinition<{}>> = Record<\n    string,\n    never\n  >,\n>(\n  { columnDefinitions }: UseDefaultTableStatesProps<\n    Q,\n    RDPs,\n    FunctionColumns\n  >,\n): UseDefaultTableStatesResult => {\n  const columnVisibility = useMemo(() => {\n    if (columnDefinitions) {\n      const colVisibility: VisibilityState = columnDefinitions.reduce(\n        (acc, colDef) => {\n          if (colDef.isVisible !== undefined) {\n            const { locator } = colDef;\n\n            const colKey = locator.id;\n\n            return {\n              ...acc,\n              [colKey]: colDef.isVisible,\n            };\n          }\n          return acc;\n        },\n        {},\n      );\n\n      return colVisibility;\n    }\n  }, [columnDefinitions]);\n\n  return { columnVisibility };\n};\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAQA,SAASA,OAAO,QAAQ,OAAO;AAsB/B,OAAO,MAAMC,qBAAqB,GAAGA,CAQnC;EAAEC;AAIF,CAAC,KAC+B;EAChC,MAAMC,gBAAgB,GAAGH,OAAO,CAAC,MAAM;IACrC,IAAIE,iBAAiB,EAAE;MACrB,MAAME,aAA8B,GAAGF,iBAAiB,CAACG,MAAM,CAC7D,CAACC,GAAG,EAAEC,MAAM,KAAK;QACf,IAAIA,MAAM,CAACC,SAAS,KAAKC,SAAS,EAAE;UAClC,MAAM;YAAEC;UAAQ,CAAC,GAAGH,MAAM;UAE1B,MAAMI,MAAM,GAAGD,OAAO,CAACE,EAAE;UAEzB,OAAO;YACL,GAAGN,GAAG;YACN,CAACK,MAAM,GAAGJ,MAAM,CAACC;UACnB,CAAC;QACH;QACA,OAAOF,GAAG;MACZ,CAAC,EACD,CAAC,CACH,CAAC;MAED,OAAOF,aAAa;IACtB;EACF,CAAC,EAAE,CAACF,iBAAiB,CAAC,CAAC;EAEvB,OAAO;IAAEC;EAAiB,CAAC;AAC7B,CAAC","ignoreList":[]}

package/build/esm/object-table/hooks/useObjectTableData.js

@@ -0,0 +1,48 @@
+/*
+ * Copyright 2025 Palantir Technologies, Inc. All rights reserved.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import { useObjectSet } from "@osdk/react/experimental";
+import { useMemo } from "react";
+const PAGE_SIZE = 50;
+
+/**
+ * This hook is a wrapper around useObjectSet
+ * It extracts RDP locators from columnDefinitions and calls useObjectSet + withProperties
+ * to return data containing the derived properties.
+ */
+
+export function useObjectTableData(objectSet, columnDefinitions) {
+  // Extract derived properties definition to be passed to useObjectSet hook
+  const withProperties = useMemo(() => {
+    if (!columnDefinitions) {
+      return;
+    }
+    const rdpColumns = columnDefinitions.map(colDef => colDef.locator).filter(colLocator => {
+      return colLocator.type === "rdp";
+    });
+    return rdpColumns.reduce((acc, cur) => {
+      return {
+        ...acc,
+        [cur.id]: cur.creator
+      };
+    }, {});
+  }, [columnDefinitions]);
+  return useObjectSet(objectSet, {
+    withProperties,
+    pageSize: PAGE_SIZE
+  });
+}
+//# sourceMappingURL=useObjectTableData.js.map

package/build/esm/object-table/hooks/useObjectTableData.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useObjectTableData.js","names":["useObjectSet","useMemo","PAGE_SIZE","useObjectTableData","objectSet","columnDefinitions","withProperties","rdpColumns","map","colDef","locator","filter","colLocator","type","reduce","acc","cur","id","creator","pageSize"],"sources":["useObjectTableData.ts"],"sourcesContent":["/*\n * Copyright 2025 Palantir Technologies, Inc. All rights reserved.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport type {\n  DerivedProperty,\n  ObjectSet,\n  ObjectTypeDefinition,\n  QueryDefinition,\n  SimplePropertyDef,\n} from \"@osdk/api\";\nimport { useObjectSet } from \"@osdk/react/experimental\";\nimport { useMemo } from \"react\";\nimport type { ColumnDefinition } from \"../ObjectTableApi.js\";\n\nconst PAGE_SIZE = 50;\n\n/**\n * This hook is a wrapper around useObjectSet\n * It extracts RDP locators from columnDefinitions and calls useObjectSet + withProperties\n * to return data containing the derived properties.\n */\n\nexport function useObjectTableData<\n  Q extends ObjectTypeDefinition,\n  RDPs extends Record<string, SimplePropertyDef>,\n  FunctionColumns extends Record<string, QueryDefinition<{}>> = Record<\n    string,\n    never\n  >,\n>(\n  objectSet: ObjectSet<Q>,\n  columnDefinitions?: Array<ColumnDefinition<Q, RDPs, FunctionColumns>>,\n): ReturnType<typeof useObjectSet<Q, never, RDPs>> {\n  // Extract derived properties definition to be passed to useObjectSet hook\n  const withProperties = useMemo(() => {\n    if (!columnDefinitions) {\n      return;\n    }\n\n    const rdpColumns = columnDefinitions.map(colDef => colDef.locator).filter(\n      (colLocator) => {\n        return colLocator.type === \"rdp\";\n      },\n    );\n\n    return rdpColumns.reduce<\n      { [K in keyof RDPs]: DerivedProperty.Creator<Q, RDPs[K]> }\n    >(\n      (acc, cur) => {\n        return {\n          ...acc,\n          [cur.id]: cur.creator,\n        };\n      },\n      {} as {\n        [K in keyof RDPs]: DerivedProperty.Creator<Q, RDPs[K]>;\n      },\n    );\n  }, [columnDefinitions]);\n\n  return useObjectSet<Q, never, RDPs>(\n    objectSet,\n    {\n      withProperties,\n      pageSize: PAGE_SIZE,\n    },\n  );\n}\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AASA,SAASA,YAAY,QAAQ,0BAA0B;AACvD,SAASC,OAAO,QAAQ,OAAO;AAG/B,MAAMC,SAAS,GAAG,EAAE;;AAEpB;AACA;AACA;AACA;AACA;;AAEA,OAAO,SAASC,kBAAkBA,CAQhCC,SAAuB,EACvBC,iBAAqE,EACpB;EACjD;EACA,MAAMC,cAAc,GAAGL,OAAO,CAAC,MAAM;IACnC,IAAI,CAACI,iBAAiB,EAAE;MACtB;IACF;IAEA,MAAME,UAAU,GAAGF,iBAAiB,CAACG,GAAG,CAACC,MAAM,IAAIA,MAAM,CAACC,OAAO,CAAC,CAACC,MAAM,CACtEC,UAAU,IAAK;MACd,OAAOA,UAAU,CAACC,IAAI,KAAK,KAAK;IAClC,CACF,CAAC;IAED,OAAON,UAAU,CAACO,MAAM,CAGtB,CAACC,GAAG,EAAEC,GAAG,KAAK;MACZ,OAAO;QACL,GAAGD,GAAG;QACN,CAACC,GAAG,CAACC,EAAE,GAAGD,GAAG,CAACE;MAChB,CAAC;IACH,CAAC,EACD,CAAC,CAGH,CAAC;EACH,CAAC,EAAE,CAACb,iBAAiB,CAAC,CAAC;EAEvB,OAAOL,YAAY,CACjBI,SAAS,EACT;IACEE,cAAc;IACda,QAAQ,EAAEjB;EACZ,CACF,CAAC;AACH","ignoreList":[]}