@osdk/client 2.5.2 → 2.6.0-beta.10

package/build/esm/observable/internal/BulkObjectLoader.test.js

@@ -108,5 +108,53 @@ describe(BulkObjectLoader, () => {
     expect(mockThen).toHaveBeenCalled();
     vi.useRealTimers();
   });
+  it("uses $eq for single object and $in for multiple objects", async () => {
+    const loader = new BulkObjectLoader(client, 25, 100);
+    vi.useFakeTimers();
+    const whereClauses = [];
+    const mockObjectSet = {
+      where: clause => {
+        whereClauses.push(clause);
+        return mockObjectSet;
+      },
+      fetchPage: vi.fn().mockResolvedValue({
+        data: [employees[0]],
+        nextPageToken: undefined,
+        totalCount: "1"
+      })
+    };
+    client.mockReturnValueOnce(mockObjectSet);
+    const load0 = loader.fetch("Employee", 0);
+    vi.advanceTimersByTime(26);
+    await load0;
+    expect(whereClauses[0]).toEqual({
+      id: {
+        $eq: 0
+      }
+    });
+    whereClauses.length = 0;
+    const mockObjectSet2 = {
+      where: clause => {
+        whereClauses.push(clause);
+        return mockObjectSet2;
+      },
+      fetchPage: vi.fn().mockResolvedValue({
+        data: [employees[1], employees[2]],
+        nextPageToken: undefined,
+        totalCount: "2"
+      })
+    };
+    client.mockReturnValueOnce(mockObjectSet2);
+    const load1 = loader.fetch("Employee", 1);
+    const load2 = loader.fetch("Employee", 2);
+    vi.advanceTimersByTime(26);
+    await Promise.all([load1, load2]);
+    expect(whereClauses[0]).toEqual({
+      id: {
+        $in: [1, 2]
+      }
+    });
+    vi.useRealTimers();
+  });
 });
 //# sourceMappingURL=BulkObjectLoader.test.js.map

package/build/esm/observable/internal/BulkObjectLoader.test.js.map

@@ -1 +1 @@
-{"version":3,"file":"BulkObjectLoader.test.js","names":["beforeEach","describe","expect","it","vi","BulkObjectLoader","createClientMockHelper","client","mockClient","mocked","fetchMetadata","mockReturnValue","Promise","resolve","primaryKeyApiName","employees","$apiName","$objectType","$primaryKey","loader","firstRequest","mockFetchPageOnce","secondRequest","load0","fetch","load1","load2","data","nextPageToken","undefined","totalCount","resolves","toMatchObject","mock","fn","then","not","toHaveBeenCalled","useFakeTimers","advanceTimersByTime","runOnlyPendingTimers","mockThen","useRealTimers"],"sources":["BulkObjectLoader.test.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 { ObjectMetadata } from \"@osdk/api\";\nimport type { Mock } from \"vitest\";\nimport { beforeEach, describe, expect, it, vi } from \"vitest\";\nimport type { Client } from \"../../Client.js\";\nimport { BulkObjectLoader } from \"./BulkObjectLoader.js\";\nimport { createClientMockHelper, type MockClientHelper } from \"./testUtils.js\";\n\ndescribe(BulkObjectLoader, () => {\n  let client: Mock<Client> & Client;\n  let mockClient: MockClientHelper;\n\n  beforeEach(async () => {\n    mockClient = createClientMockHelper();\n    client = mockClient.client;\n\n    // eslint-disable-next-line @typescript-eslint/unbound-method\n    vi.mocked(client.fetchMetadata).mockReturnValue(\n      Promise.resolve(\n        {\n          primaryKeyApiName: \"id\",\n        } satisfies Pick<ObjectMetadata, \"primaryKeyApiName\"> as ObjectMetadata,\n      ),\n    );\n  });\n\n  const employees = [\n    {\n      $apiName: \"Employee\",\n      $objectType: \"Employee\",\n      $primaryKey: 0,\n    },\n    {\n      $apiName: \"Employee\",\n      $objectType: \"Employee\",\n      $primaryKey: 1,\n    },\n    {\n      $apiName: \"Employee\",\n      $objectType: \"Employee\",\n      $primaryKey: 2,\n    },\n  ];\n\n  it(\"splits up work by count\", async () => {\n    const loader = new BulkObjectLoader(client, 25, /*ms*/ 2 /*entries*/);\n\n    const firstRequest = mockClient.mockFetchPageOnce();\n    const secondRequest = mockClient.mockFetchPageOnce();\n\n    const load0 = loader.fetch(\"Employee\", 0);\n    const load1 = loader.fetch(\"Employee\", 1);\n    const load2 = loader.fetch(\"Employee\", 2);\n\n    firstRequest.resolve({\n      data: [employees[0], employees[1]],\n      nextPageToken: undefined,\n      totalCount: \"2\",\n    });\n\n    await expect(load0).resolves.toMatchObject({\n      $primaryKey: 0,\n    });\n\n    await expect(load1).resolves.toMatchObject({\n      $primaryKey: 1,\n    });\n\n    const mock = vi.fn();\n    void load2.then(mock);\n    expect(mock).not.toHaveBeenCalled();\n\n    secondRequest.resolve({\n      data: [employees[2]],\n      nextPageToken: undefined,\n      totalCount: \"1\",\n    });\n\n    await expect(load2).resolves.toMatchObject({\n      $primaryKey: 2,\n    });\n\n    expect(mock).toHaveBeenCalled();\n  });\n\n  it(\"splits up work by time\", async () => {\n    const loader = new BulkObjectLoader(client, /*ms*/ 25, /*entries*/ 100);\n\n    const firstRequest = mockClient.mockFetchPageOnce();\n    const secondRequest = mockClient.mockFetchPageOnce();\n\n    vi.useFakeTimers();\n\n    const load0 = loader.fetch(\"Employee\", 0);\n\n    vi.advanceTimersByTime(26);\n\n    const load1 = loader.fetch(\"Employee\", 1);\n    const load2 = loader.fetch(\"Employee\", 2);\n\n    firstRequest.resolve({\n      data: [employees[0]],\n      nextPageToken: undefined,\n      totalCount: \"1\",\n    });\n\n    vi.runOnlyPendingTimers();\n\n    await expect(load0).resolves.toMatchObject({\n      $primaryKey: 0,\n    });\n\n    const mockThen = vi.fn();\n    void load2.then(mockThen);\n\n    expect(mockThen).not.toHaveBeenCalled();\n\n    secondRequest.resolve({\n      data: [\n        employees[1],\n        employees[2],\n      ],\n      nextPageToken: undefined,\n      totalCount: \"2\",\n    });\n\n    await expect(load1).resolves.toMatchObject({\n      $primaryKey: 1,\n    });\n\n    await expect(load2).resolves.toMatchObject({\n      $primaryKey: 2,\n    });\n\n    expect(mockThen).toHaveBeenCalled();\n\n    vi.useRealTimers();\n  });\n});\n"],"mappings":"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","ignoreList":[]}
+{"version":3,"file":"BulkObjectLoader.test.js","names":["beforeEach","describe","expect","it","vi","BulkObjectLoader","createClientMockHelper","client","mockClient","mocked","fetchMetadata","mockReturnValue","Promise","resolve","primaryKeyApiName","employees","$apiName","$objectType","$primaryKey","loader","firstRequest","mockFetchPageOnce","secondRequest","load0","fetch","load1","load2","data","nextPageToken","undefined","totalCount","resolves","toMatchObject","mock","fn","then","not","toHaveBeenCalled","useFakeTimers","advanceTimersByTime","runOnlyPendingTimers","mockThen","useRealTimers","whereClauses","mockObjectSet","where","clause","push","fetchPage","mockResolvedValue","mockReturnValueOnce","toEqual","id","$eq","length","mockObjectSet2","all","$in"],"sources":["BulkObjectLoader.test.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  ObjectSet,\n  ObjectTypeDefinition,\n  WhereClause,\n} from \"@osdk/api\";\nimport type { Mock } from \"vitest\";\nimport { beforeEach, describe, expect, it, vi } from \"vitest\";\nimport type { Client } from \"../../Client.js\";\nimport { BulkObjectLoader } from \"./BulkObjectLoader.js\";\nimport { createClientMockHelper, type MockClientHelper } from \"./testUtils.js\";\n\ndescribe(BulkObjectLoader, () => {\n  let client: Mock<Client> & Client;\n  let mockClient: MockClientHelper;\n\n  beforeEach(async () => {\n    mockClient = createClientMockHelper();\n    client = mockClient.client;\n\n    // eslint-disable-next-line @typescript-eslint/unbound-method\n    vi.mocked(client.fetchMetadata).mockReturnValue(\n      Promise.resolve(\n        {\n          primaryKeyApiName: \"id\",\n        } satisfies Pick<ObjectMetadata, \"primaryKeyApiName\"> as ObjectMetadata,\n      ),\n    );\n  });\n\n  const employees = [\n    {\n      $apiName: \"Employee\",\n      $objectType: \"Employee\",\n      $primaryKey: 0,\n    },\n    {\n      $apiName: \"Employee\",\n      $objectType: \"Employee\",\n      $primaryKey: 1,\n    },\n    {\n      $apiName: \"Employee\",\n      $objectType: \"Employee\",\n      $primaryKey: 2,\n    },\n  ];\n\n  it(\"splits up work by count\", async () => {\n    const loader = new BulkObjectLoader(client, 25, /*ms*/ 2 /*entries*/);\n\n    const firstRequest = mockClient.mockFetchPageOnce();\n    const secondRequest = mockClient.mockFetchPageOnce();\n\n    const load0 = loader.fetch(\"Employee\", 0);\n    const load1 = loader.fetch(\"Employee\", 1);\n    const load2 = loader.fetch(\"Employee\", 2);\n\n    firstRequest.resolve({\n      data: [employees[0], employees[1]],\n      nextPageToken: undefined,\n      totalCount: \"2\",\n    });\n\n    await expect(load0).resolves.toMatchObject({\n      $primaryKey: 0,\n    });\n\n    await expect(load1).resolves.toMatchObject({\n      $primaryKey: 1,\n    });\n\n    const mock = vi.fn();\n    void load2.then(mock);\n    expect(mock).not.toHaveBeenCalled();\n\n    secondRequest.resolve({\n      data: [employees[2]],\n      nextPageToken: undefined,\n      totalCount: \"1\",\n    });\n\n    await expect(load2).resolves.toMatchObject({\n      $primaryKey: 2,\n    });\n\n    expect(mock).toHaveBeenCalled();\n  });\n\n  it(\"splits up work by time\", async () => {\n    const loader = new BulkObjectLoader(client, /*ms*/ 25, /*entries*/ 100);\n\n    const firstRequest = mockClient.mockFetchPageOnce();\n    const secondRequest = mockClient.mockFetchPageOnce();\n\n    vi.useFakeTimers();\n\n    const load0 = loader.fetch(\"Employee\", 0);\n\n    vi.advanceTimersByTime(26);\n\n    const load1 = loader.fetch(\"Employee\", 1);\n    const load2 = loader.fetch(\"Employee\", 2);\n\n    firstRequest.resolve({\n      data: [employees[0]],\n      nextPageToken: undefined,\n      totalCount: \"1\",\n    });\n\n    vi.runOnlyPendingTimers();\n\n    await expect(load0).resolves.toMatchObject({\n      $primaryKey: 0,\n    });\n\n    const mockThen = vi.fn();\n    void load2.then(mockThen);\n\n    expect(mockThen).not.toHaveBeenCalled();\n\n    secondRequest.resolve({\n      data: [\n        employees[1],\n        employees[2],\n      ],\n      nextPageToken: undefined,\n      totalCount: \"2\",\n    });\n\n    await expect(load1).resolves.toMatchObject({\n      $primaryKey: 1,\n    });\n\n    await expect(load2).resolves.toMatchObject({\n      $primaryKey: 2,\n    });\n\n    expect(mockThen).toHaveBeenCalled();\n\n    vi.useRealTimers();\n  });\n\n  it(\"uses $eq for single object and $in for multiple objects\", async () => {\n    const loader = new BulkObjectLoader(client, 25, 100);\n\n    vi.useFakeTimers();\n\n    const whereClauses: WhereClause<ObjectTypeDefinition>[] = [];\n\n    const mockObjectSet: ObjectSet<ObjectTypeDefinition> = {\n      where: (clause) => {\n        whereClauses.push(clause);\n        return mockObjectSet;\n      },\n      fetchPage: vi.fn().mockResolvedValue({\n        data: [employees[0]],\n        nextPageToken: undefined,\n        totalCount: \"1\",\n      }),\n    } as Pick<\n      ObjectSet<ObjectTypeDefinition>,\n      \"fetchPage\" | \"where\"\n    > as ObjectSet<ObjectTypeDefinition>;\n\n    client.mockReturnValueOnce(mockObjectSet);\n    const load0 = loader.fetch(\"Employee\", 0);\n\n    vi.advanceTimersByTime(26);\n\n    await load0;\n\n    expect(whereClauses[0]).toEqual({\n      id: { $eq: 0 },\n    });\n\n    whereClauses.length = 0;\n\n    const mockObjectSet2: ObjectSet<ObjectTypeDefinition> = {\n      where: (clause) => {\n        whereClauses.push(clause);\n        return mockObjectSet2;\n      },\n      fetchPage: vi.fn().mockResolvedValue({\n        data: [employees[1], employees[2]],\n        nextPageToken: undefined,\n        totalCount: \"2\",\n      }),\n    } as Pick<\n      ObjectSet<ObjectTypeDefinition>,\n      \"fetchPage\" | \"where\"\n    > as ObjectSet<ObjectTypeDefinition>;\n\n    client.mockReturnValueOnce(mockObjectSet2);\n\n    const load1 = loader.fetch(\"Employee\", 1);\n    const load2 = loader.fetch(\"Employee\", 2);\n\n    vi.advanceTimersByTime(26);\n\n    await Promise.all([load1, load2]);\n\n    expect(whereClauses[0]).toEqual({\n      id: { $in: [1, 2] },\n    });\n\n    vi.useRealTimers();\n  });\n});\n"],"mappings":"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","ignoreList":[]}

package/build/esm/observable/internal/CacheKeys.js

@@ -65,11 +65,17 @@ export class CacheKeys {
     });
   }
   get(type, ...args) {
-    const cacheKeyArgs = [type, ...args];
+    // Normalize trailing undefined values to ensure consistent cache key creation
+    // This makes get("object", "Foo", 1, undefined) === get("object", "Foo", 1)
+    const normalizedArgs = [...args];
+    while (normalizedArgs.length > 0 && normalizedArgs[normalizedArgs.length - 1] === undefined) {
+      normalizedArgs.pop();
+    }
+    const cacheKeyArgs = [type, ...normalizedArgs];
     if (process.env.NODE_ENV !== "production" && DEBUG_CACHE_KEYS) {
       // eslint-disable-next-line no-console
-      console.debug(`CacheKeys.get([${type}, 
-        ${args.map(x => JSON.stringify(x)).join(", ")}]) - already exists? `, this.#cacheKeys.peekArray(cacheKeyArgs) != null);
+      console.debug(`CacheKeys.get([${type},
+        ${normalizedArgs.map(x => JSON.stringify(x)).join(", ")}]) - already exists? `, this.#cacheKeys.peekArray(cacheKeyArgs) != null);
     }
     const cacheKey = this.#cacheKeys.lookupArray(cacheKeyArgs);
 

package/build/esm/observable/internal/CacheKeys.js.map

@@ -1 +1 @@
-{"version":3,"file":"CacheKeys.js","names":["Trie","DEBUG_CACHE_KEYS","DEBUG_REFCOUNTS","RefCounts","CacheKeys","cacheKeys","keys","cacheKey","type","otherKeys","slice","onCreate","console","log","JSON","stringify","finalizationRegistry","register","refCounts","k","cleanupCacheKey","onDestroy","constructor","setInterval","gc","FinalizationRegistry","cleanupCallback","e","error","get","args","cacheKeyArgs","process","env","NODE_ENV","debug","map","x","join","peekArray","lookupArray","retain","release","remove","#remove","key"],"sources":["CacheKeys.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 { Trie } from \"@wry/trie\";\nimport { DEBUG_CACHE_KEYS, DEBUG_REFCOUNTS } from \"../DebugFlags.js\";\nimport type { CacheKey } from \"./CacheKey.js\";\nimport { RefCounts } from \"./RefCounts.js\";\n\n/**\n * Cache key management with canonicalization.\n * - Uses Trie structure for efficient storage and lookup\n */\nexport class CacheKeys<TCacheKey extends CacheKey> {\n  #cacheKeys = new Trie<TCacheKey>(false, (keys) => {\n    const cacheKey = {\n      type: keys[0],\n      otherKeys: keys.slice(1),\n    } as unknown as TCacheKey;\n    this.#onCreate?.(cacheKey);\n\n    if (DEBUG_REFCOUNTS) {\n      // eslint-disable-next-line no-console\n      console.log(\n        `CacheKeys.onCreate(${cacheKey.type}, ${\n          JSON.stringify(cacheKey.otherKeys)\n        })`,\n      );\n\n      this.#finalizationRegistry.register(cacheKey, () => {\n        // eslint-disable-next-line no-console\n        console.log(\n          `CacheKey Finalization(${cacheKey.type}, ${\n            JSON.stringify(cacheKey.otherKeys)\n          })`,\n        );\n      });\n    }\n    return cacheKey;\n  });\n\n  #refCounts = new RefCounts<TCacheKey>(\n    DEBUG_REFCOUNTS ? 15_000 : 60_000,\n    (k) => this.#cleanupCacheKey(k),\n  );\n\n  // we are currently only using this for debug logging and should just remove it in the future if that\n  // continues to be true\n  #finalizationRegistry: FinalizationRegistry<() => void>;\n\n  #onCreate?: (cacheKey: TCacheKey) => void;\n  #onDestroy?: (cacheKey: TCacheKey) => void;\n\n  constructor(\n    { onCreate, onDestroy }: {\n      onCreate?: (cacheKey: TCacheKey) => void;\n      onDestroy?: (cacheKey: TCacheKey) => void;\n    },\n  ) {\n    this.#onCreate = onCreate;\n    this.#onDestroy = onDestroy;\n\n    setInterval(() => {\n      this.#refCounts.gc();\n    }, 1000);\n\n    this.#finalizationRegistry = new FinalizationRegistry<() => void>(\n      (cleanupCallback) => {\n        try {\n          cleanupCallback();\n        } catch (e) {\n          // eslint-disable-next-line no-console\n          console.error(\n            \"Caught an error while running a finalization callback\",\n            e,\n          );\n        }\n      },\n    );\n  }\n\n  get<K extends TCacheKey>(\n    type: K[\"type\"],\n    ...args: K[\"__cacheKey\"][\"args\"]\n  ): K {\n    const cacheKeyArgs = [type, ...args];\n    if (process.env.NODE_ENV !== \"production\" && DEBUG_CACHE_KEYS) {\n      // eslint-disable-next-line no-console\n      console.debug(\n        `CacheKeys.get([${type}, \n        ${args.map(x => JSON.stringify(x)).join(\", \")}]) - already exists? `,\n        this.#cacheKeys.peekArray(cacheKeyArgs) != null,\n      );\n    }\n\n    const cacheKey = this.#cacheKeys.lookupArray(\n      cacheKeyArgs,\n    ) as K;\n\n    // This is an idempotent call that ensures the cache key is registered for\n    // cleanup. If already registered, this does nothing.\n    this.#refCounts.register(cacheKey);\n\n    return cacheKey;\n  }\n\n  retain(cacheKey: TCacheKey): void {\n    this.#refCounts.retain(cacheKey);\n  }\n\n  release(cacheKey: TCacheKey): void {\n    this.#refCounts.release(cacheKey);\n  }\n\n  #remove<K extends TCacheKey>(cacheKey: K): void {\n    this.#cacheKeys.remove(cacheKey.type, ...cacheKey.otherKeys);\n  }\n\n  /**\n   * Called after a key is no longer retained and the timeout has elapsed\n   * @param key\n   */\n  #cleanupCacheKey = (key: TCacheKey) => {\n    this.#onDestroy?.(key);\n    this.#remove(key);\n  };\n}\n"],"mappings":"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","ignoreList":[]}
+{"version":3,"file":"CacheKeys.js","names":["Trie","DEBUG_CACHE_KEYS","DEBUG_REFCOUNTS","RefCounts","CacheKeys","cacheKeys","keys","cacheKey","type","otherKeys","slice","onCreate","console","log","JSON","stringify","finalizationRegistry","register","refCounts","k","cleanupCacheKey","onDestroy","constructor","setInterval","gc","FinalizationRegistry","cleanupCallback","e","error","get","args","normalizedArgs","length","undefined","pop","cacheKeyArgs","process","env","NODE_ENV","debug","map","x","join","peekArray","lookupArray","retain","release","remove","#remove","key"],"sources":["CacheKeys.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 { Trie } from \"@wry/trie\";\nimport { DEBUG_CACHE_KEYS, DEBUG_REFCOUNTS } from \"../DebugFlags.js\";\nimport type { CacheKey } from \"./CacheKey.js\";\nimport { RefCounts } from \"./RefCounts.js\";\n\n/**\n * Cache key management with canonicalization.\n * - Uses Trie structure for efficient storage and lookup\n */\nexport class CacheKeys<TCacheKey extends CacheKey> {\n  #cacheKeys = new Trie<TCacheKey>(false, (keys) => {\n    const cacheKey = {\n      type: keys[0],\n      otherKeys: keys.slice(1),\n    } as unknown as TCacheKey;\n    this.#onCreate?.(cacheKey);\n\n    if (DEBUG_REFCOUNTS) {\n      // eslint-disable-next-line no-console\n      console.log(\n        `CacheKeys.onCreate(${cacheKey.type}, ${\n          JSON.stringify(cacheKey.otherKeys)\n        })`,\n      );\n\n      this.#finalizationRegistry.register(cacheKey, () => {\n        // eslint-disable-next-line no-console\n        console.log(\n          `CacheKey Finalization(${cacheKey.type}, ${\n            JSON.stringify(cacheKey.otherKeys)\n          })`,\n        );\n      });\n    }\n    return cacheKey;\n  });\n\n  #refCounts = new RefCounts<TCacheKey>(\n    DEBUG_REFCOUNTS ? 15_000 : 60_000,\n    (k) => this.#cleanupCacheKey(k),\n  );\n\n  // we are currently only using this for debug logging and should just remove it in the future if that\n  // continues to be true\n  #finalizationRegistry: FinalizationRegistry<() => void>;\n\n  #onCreate?: (cacheKey: TCacheKey) => void;\n  #onDestroy?: (cacheKey: TCacheKey) => void;\n\n  constructor(\n    { onCreate, onDestroy }: {\n      onCreate?: (cacheKey: TCacheKey) => void;\n      onDestroy?: (cacheKey: TCacheKey) => void;\n    },\n  ) {\n    this.#onCreate = onCreate;\n    this.#onDestroy = onDestroy;\n\n    setInterval(() => {\n      this.#refCounts.gc();\n    }, 1000);\n\n    this.#finalizationRegistry = new FinalizationRegistry<() => void>(\n      (cleanupCallback) => {\n        try {\n          cleanupCallback();\n        } catch (e) {\n          // eslint-disable-next-line no-console\n          console.error(\n            \"Caught an error while running a finalization callback\",\n            e,\n          );\n        }\n      },\n    );\n  }\n\n  get<K extends TCacheKey>(\n    type: K[\"type\"],\n    ...args: K[\"__cacheKey\"][\"args\"]\n  ): K {\n    // Normalize trailing undefined values to ensure consistent cache key creation\n    // This makes get(\"object\", \"Foo\", 1, undefined) === get(\"object\", \"Foo\", 1)\n    const normalizedArgs = [...args];\n    while (\n      normalizedArgs.length > 0\n      && normalizedArgs[normalizedArgs.length - 1] === undefined\n    ) {\n      normalizedArgs.pop();\n    }\n\n    const cacheKeyArgs = [type, ...normalizedArgs];\n    if (process.env.NODE_ENV !== \"production\" && DEBUG_CACHE_KEYS) {\n      // eslint-disable-next-line no-console\n      console.debug(\n        `CacheKeys.get([${type},\n        ${\n          normalizedArgs.map(x => JSON.stringify(x)).join(\", \")\n        }]) - already exists? `,\n        this.#cacheKeys.peekArray(cacheKeyArgs) != null,\n      );\n    }\n\n    const cacheKey = this.#cacheKeys.lookupArray(\n      cacheKeyArgs,\n    ) as K;\n\n    // This is an idempotent call that ensures the cache key is registered for\n    // cleanup. If already registered, this does nothing.\n    this.#refCounts.register(cacheKey);\n\n    return cacheKey;\n  }\n\n  retain(cacheKey: TCacheKey): void {\n    this.#refCounts.retain(cacheKey);\n  }\n\n  release(cacheKey: TCacheKey): void {\n    this.#refCounts.release(cacheKey);\n  }\n\n  #remove<K extends TCacheKey>(cacheKey: K): void {\n    this.#cacheKeys.remove(cacheKey.type, ...cacheKey.otherKeys);\n  }\n\n  /**\n   * Called after a key is no longer retained and the timeout has elapsed\n   * @param key\n   */\n  #cleanupCacheKey = (key: TCacheKey) => {\n    this.#onDestroy?.(key);\n    this.#remove(key);\n  };\n}\n"],"mappings":"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","ignoreList":[]}

package/build/esm/observable/internal/Canonicalizer.js

@@ -0,0 +1,51 @@
+/*
+ * 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.
+ */
+
+/**
+ * Interface for canonicalizing objects.
+ */
+
+/**
+ * Base class for canonicalizers that provides common caching infrastructure.
+ * Subclasses control how structural deduplication is performed.
+ */
+export class CachingCanonicalizer {
+  /**
+   * Cache for input object identity.
+   */
+  inputCache = new WeakMap();
+
+  /**
+   * Look up or create a canonical form for the given input.
+   * This method handles the structural deduplication logic.
+   *
+   * @param input The input to canonicalize
+   * @returns The canonical form
+   */
+
+  canonicalize(input) {
+    if (!input) {
+      return undefined;
+    }
+    if (this.inputCache.has(input)) {
+      return this.inputCache.get(input);
+    }
+    const canonical = this.lookupOrCreate(input);
+    this.inputCache.set(input, canonical);
+    return canonical;
+  }
+}
+//# sourceMappingURL=Canonicalizer.js.map

package/build/esm/observable/internal/Canonicalizer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Canonicalizer.js","names":["CachingCanonicalizer","inputCache","WeakMap","canonicalize","input","undefined","has","get","canonical","lookupOrCreate","set"],"sources":["Canonicalizer.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 { Canonical } from \"./Canonical.js\";\n\n/**\n * Interface for canonicalizing objects.\n */\nexport interface Canonicalizer<TInput, TCanonical> {\n  /**\n   * Canonicalizes the input object. Returns the same reference for\n   * structurally identical inputs.\n   */\n  canonicalize(input: TInput | undefined): Canonical<TCanonical> | undefined;\n}\n\n/**\n * Base class for canonicalizers that provides common caching infrastructure.\n * Subclasses control how structural deduplication is performed.\n */\nexport abstract class CachingCanonicalizer<TInput extends object, TCanonical>\n  implements Canonicalizer<TInput, TCanonical>\n{\n  /**\n   * Cache for input object identity.\n   */\n  protected inputCache: WeakMap<TInput, Canonical<TCanonical>> = new WeakMap<\n    TInput,\n    Canonical<TCanonical>\n  >();\n\n  /**\n   * Look up or create a canonical form for the given input.\n   * This method handles the structural deduplication logic.\n   *\n   * @param input The input to canonicalize\n   * @returns The canonical form\n   */\n  protected abstract lookupOrCreate(input: TInput): Canonical<TCanonical>;\n\n  canonicalize(input: TInput): Canonical<TCanonical>;\n  canonicalize(input: TInput | undefined): Canonical<TCanonical> | undefined;\n  canonicalize(input: TInput | undefined): Canonical<TCanonical> | undefined {\n    if (!input) {\n      return undefined;\n    }\n    if (this.inputCache.has(input)) {\n      return this.inputCache.get(input)!;\n    }\n\n    const canonical = this.lookupOrCreate(input);\n    this.inputCache.set(input, canonical);\n\n    return canonical;\n  }\n}\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAIA;AACA;AACA;;AASA;AACA;AACA;AACA;AACA,OAAO,MAAeA,oBAAoB,CAE1C;EACE;AACF;AACA;EACYC,UAAU,GAA2C,IAAIC,OAAO,CAGxE,CAAC;;EAEH;AACF;AACA;AACA;AACA;AACA;AACA;;EAKEC,YAAYA,CAACC,KAAyB,EAAqC;IACzE,IAAI,CAACA,KAAK,EAAE;MACV,OAAOC,SAAS;IAClB;IACA,IAAI,IAAI,CAACJ,UAAU,CAACK,GAAG,CAACF,KAAK,CAAC,EAAE;MAC9B,OAAO,IAAI,CAACH,UAAU,CAACM,GAAG,CAACH,KAAK,CAAC;IACnC;IAEA,MAAMI,SAAS,GAAG,IAAI,CAACC,cAAc,CAACL,KAAK,CAAC;IAC5C,IAAI,CAACH,UAAU,CAACS,GAAG,CAACN,KAAK,EAAEI,SAAS,CAAC;IAErC,OAAOA,SAAS;EAClB;AACF","ignoreList":[]}

package/build/esm/observable/internal/Changes.js.map

@@ -1 +1 @@
-{"version":3,"file":"Changes.js","names":["MultiMap","DEBUG_ONLY__cacheKeyToString","Changes","modifiedObjects","addedObjects","added","Set","modified","deleted","registerObject","cacheKey","data","isNew","set","$apiName","add","deleteObject","registerList","key","registerLink","deleteLink","registerObjectSet","isEmpty","size","createChangedObjects","DEBUG_ONLY__changesToString","changes","process","env","NODE_ENV","JSON","stringify","multimapHelper","listHelper","Error","Array","from","map","multimap","Object","fromEntries","associations","type","objects","o","$primaryKey"],"sources":["Changes.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 { MultiMap } from \"mnemonist\";\nimport type { ObjectHolder } from \"../../object/convertWireToOsdkObjects/ObjectHolder.js\";\nimport type { CacheKey } from \"./CacheKey.js\";\nimport { DEBUG_ONLY__cacheKeyToString } from \"./CacheKey.js\";\nimport type { SpecificLinkCacheKey } from \"./links/SpecificLinkCacheKey.js\";\nimport type { ListCacheKey } from \"./list/ListCacheKey.js\";\nimport type { ObjectCacheKey } from \"./object/ObjectCacheKey.js\";\nimport type { ObjectSetCacheKey } from \"./objectset/ObjectSetCacheKey.js\";\n\nexport class Changes {\n  modifiedObjects: MultiMap<string, ObjectHolder> = new MultiMap();\n  addedObjects: MultiMap<string, ObjectHolder> = new MultiMap();\n\n  added: Set<\n    ListCacheKey | ObjectCacheKey | SpecificLinkCacheKey | ObjectSetCacheKey\n  > = new Set();\n  modified: Set<\n    ListCacheKey | ObjectCacheKey | SpecificLinkCacheKey | ObjectSetCacheKey\n  > = new Set();\n  deleted: Set<\n    ListCacheKey | ObjectCacheKey | SpecificLinkCacheKey | ObjectSetCacheKey\n  > = new Set();\n\n  registerObject = (\n    cacheKey: ObjectCacheKey,\n    data: ObjectHolder,\n    isNew: boolean,\n  ): void => {\n    this[isNew ? \"addedObjects\" : \"modifiedObjects\"].set(data.$apiName, data);\n    this[isNew ? \"added\" : \"modified\"].add(cacheKey);\n  };\n\n  deleteObject = (cacheKey: ObjectCacheKey): void => {\n    this.deleted.add(cacheKey);\n  };\n\n  registerList = (key: ListCacheKey): void => {\n    this.modified.add(key);\n  };\n\n  registerLink = (cacheKey: SpecificLinkCacheKey): void => {\n    this.modified.add(cacheKey);\n  };\n\n  deleteLink = (cacheKey: SpecificLinkCacheKey): void => {\n    this.deleted.add(cacheKey);\n  };\n\n  registerObjectSet = (key: ObjectSetCacheKey): void => {\n    this.modified.add(key);\n  };\n\n  isEmpty(): boolean {\n    return (\n      this.modifiedObjects.size === 0\n      && this.addedObjects.size === 0\n      && this.added.size === 0\n      && this.modified.size === 0\n      && this.deleted.size === 0\n    );\n  }\n}\n\nexport function createChangedObjects(): Changes {\n  return new Changes();\n}\n\nexport function DEBUG_ONLY__changesToString(changes: Changes): string {\n  if (process.env.NODE_ENV !== \"production\") {\n    return JSON.stringify(\n      {\n        modifiedObjects: multimapHelper(changes.modifiedObjects),\n        addedObjects: multimapHelper(changes.addedObjects),\n        added: listHelper(changes.added),\n        modified: listHelper(changes.modified),\n      },\n      null,\n      2,\n    );\n  } else {\n    throw new Error(\"not implemented\");\n  }\n}\n\nfunction listHelper(set: Set<CacheKey>) {\n  return Array.from(set).map(DEBUG_ONLY__cacheKeyToString);\n}\n\nfunction multimapHelper(\n  multimap: MultiMap<string, ObjectHolder>,\n) {\n  return Object.fromEntries(\n    Array.from(multimap.associations()).map(\n      ([type, objects]) => {\n        return [type, objects.map(o => o.$primaryKey)];\n      },\n    ),\n  );\n}\n"],"mappings":"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","ignoreList":[]}
+{"version":3,"file":"Changes.js","names":["MultiMap","DEBUG_ONLY__cacheKeyToString","Changes","modifiedObjects","addedObjects","added","Set","modified","deleted","registerObject","cacheKey","data","isNew","set","$apiName","add","deleteObject","registerList","key","registerLink","deleteLink","registerObjectSet","isEmpty","size","createChangedObjects","DEBUG_ONLY__changesToString","changes","process","env","NODE_ENV","JSON","stringify","multimapHelper","listHelper","Error","Array","from","map","multimap","Object","fromEntries","associations","type","objects","o","$primaryKey"],"sources":["Changes.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 { MultiMap } from \"mnemonist\";\nimport type { ObjectHolder } from \"../../object/convertWireToOsdkObjects/ObjectHolder.js\";\nimport type { AggregationCacheKey } from \"./aggregation/AggregationCacheKey.js\";\nimport type { CacheKey } from \"./CacheKey.js\";\nimport { DEBUG_ONLY__cacheKeyToString } from \"./CacheKey.js\";\nimport type { SpecificLinkCacheKey } from \"./links/SpecificLinkCacheKey.js\";\nimport type { ListCacheKey } from \"./list/ListCacheKey.js\";\nimport type { ObjectCacheKey } from \"./object/ObjectCacheKey.js\";\nimport type { ObjectSetCacheKey } from \"./objectset/ObjectSetCacheKey.js\";\n\nexport class Changes {\n  modifiedObjects: MultiMap<string, ObjectHolder> = new MultiMap();\n  addedObjects: MultiMap<string, ObjectHolder> = new MultiMap();\n\n  added: Set<\n    | AggregationCacheKey\n    | ListCacheKey\n    | ObjectCacheKey\n    | SpecificLinkCacheKey\n    | ObjectSetCacheKey\n  > = new Set();\n  modified: Set<\n    | AggregationCacheKey\n    | ListCacheKey\n    | ObjectCacheKey\n    | SpecificLinkCacheKey\n    | ObjectSetCacheKey\n  > = new Set();\n  deleted: Set<\n    | AggregationCacheKey\n    | ListCacheKey\n    | ObjectCacheKey\n    | SpecificLinkCacheKey\n    | ObjectSetCacheKey\n  > = new Set();\n\n  registerObject = (\n    cacheKey: ObjectCacheKey,\n    data: ObjectHolder,\n    isNew: boolean,\n  ): void => {\n    this[isNew ? \"addedObjects\" : \"modifiedObjects\"].set(data.$apiName, data);\n    this[isNew ? \"added\" : \"modified\"].add(cacheKey);\n  };\n\n  deleteObject = (cacheKey: ObjectCacheKey): void => {\n    this.deleted.add(cacheKey);\n  };\n\n  registerList = (key: ListCacheKey): void => {\n    this.modified.add(key);\n  };\n\n  registerLink = (cacheKey: SpecificLinkCacheKey): void => {\n    this.modified.add(cacheKey);\n  };\n\n  deleteLink = (cacheKey: SpecificLinkCacheKey): void => {\n    this.deleted.add(cacheKey);\n  };\n\n  registerObjectSet = (key: ObjectSetCacheKey): void => {\n    this.modified.add(key);\n  };\n\n  isEmpty(): boolean {\n    return (\n      this.modifiedObjects.size === 0\n      && this.addedObjects.size === 0\n      && this.added.size === 0\n      && this.modified.size === 0\n      && this.deleted.size === 0\n    );\n  }\n}\n\nexport function createChangedObjects(): Changes {\n  return new Changes();\n}\n\nexport function DEBUG_ONLY__changesToString(changes: Changes): string {\n  if (process.env.NODE_ENV !== \"production\") {\n    return JSON.stringify(\n      {\n        modifiedObjects: multimapHelper(changes.modifiedObjects),\n        addedObjects: multimapHelper(changes.addedObjects),\n        added: listHelper(changes.added),\n        modified: listHelper(changes.modified),\n      },\n      null,\n      2,\n    );\n  } else {\n    throw new Error(\"not implemented\");\n  }\n}\n\nfunction listHelper(set: Set<CacheKey>) {\n  return Array.from(set).map(DEBUG_ONLY__cacheKeyToString);\n}\n\nfunction multimapHelper(\n  multimap: MultiMap<string, ObjectHolder>,\n) {\n  return Object.fromEntries(\n    Array.from(multimap.associations()).map(\n      ([type, objects]) => {\n        return [type, objects.map(o => o.$primaryKey)];\n      },\n    ),\n  );\n}\n"],"mappings":"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","ignoreList":[]}

package/build/esm/observable/internal/IntersectCanonicalizer.js

@@ -0,0 +1,35 @@
+/*
+ * 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 { CachingCanonicalizer } from "./Canonicalizer.js";
+export class IntersectCanonicalizer extends CachingCanonicalizer {
+  structuralCache = new Map();
+  constructor(whereCanonicalizer) {
+    super();
+    this.whereCanonicalizer = whereCanonicalizer;
+  }
+  lookupOrCreate(intersectWith) {
+    const canonicalClauses = intersectWith.map(item => this.whereCanonicalizer.canonicalize(item.where ?? {}));
+    const structuralKey = canonicalClauses.map(clause => JSON.stringify(clause)).join("||");
+    let canonical = this.structuralCache.get(structuralKey);
+    if (!canonical) {
+      canonical = canonicalClauses;
+      this.structuralCache.set(structuralKey, canonical);
+    }
+    return canonical;
+  }
+}
+//# sourceMappingURL=IntersectCanonicalizer.js.map

package/build/esm/observable/internal/IntersectCanonicalizer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IntersectCanonicalizer.js","names":["CachingCanonicalizer","IntersectCanonicalizer","structuralCache","Map","constructor","whereCanonicalizer","lookupOrCreate","intersectWith","canonicalClauses","map","item","canonicalize","where","structuralKey","clause","JSON","stringify","join","canonical","get","set"],"sources":["IntersectCanonicalizer.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  ObjectOrInterfaceDefinition,\n  SimplePropertyDef,\n  WhereClause,\n} from \"@osdk/api\";\nimport type { Canonical } from \"./Canonical.js\";\nimport { CachingCanonicalizer } from \"./Canonicalizer.js\";\nimport type { SimpleWhereClause } from \"./SimpleWhereClause.js\";\nimport type { WhereClauseCanonicalizer } from \"./WhereClauseCanonicalizer.js\";\n\ntype IntersectWithInput<\n  T extends ObjectOrInterfaceDefinition = ObjectOrInterfaceDefinition,\n  RDPs extends Record<string, SimplePropertyDef> = Record<\n    string,\n    SimplePropertyDef\n  >,\n> = Array<{ where: WhereClause<T, RDPs> }>;\n\nexport class IntersectCanonicalizer extends CachingCanonicalizer<\n  IntersectWithInput,\n  Array<Canonical<SimpleWhereClause>>\n> {\n  private structuralCache = new Map<\n    string,\n    Canonical<Array<Canonical<SimpleWhereClause>>>\n  >();\n\n  constructor(private whereCanonicalizer: WhereClauseCanonicalizer) {\n    super();\n  }\n\n  protected lookupOrCreate(\n    intersectWith: IntersectWithInput,\n  ): Canonical<Array<Canonical<SimpleWhereClause>>> {\n    const canonicalClauses = intersectWith.map((item) =>\n      this.whereCanonicalizer.canonicalize(item.where ?? {})\n    );\n\n    const structuralKey = canonicalClauses\n      .map((clause) => JSON.stringify(clause))\n      .join(\"||\");\n\n    let canonical = this.structuralCache.get(structuralKey);\n\n    if (!canonical) {\n      canonical = canonicalClauses as Canonical<\n        Array<Canonical<SimpleWhereClause>>\n      >;\n      this.structuralCache.set(structuralKey, canonical);\n    }\n\n    return canonical;\n  }\n}\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAQA,SAASA,oBAAoB,QAAQ,oBAAoB;AAYzD,OAAO,MAAMC,sBAAsB,SAASD,oBAAoB,CAG9D;EACQE,eAAe,GAAG,IAAIC,GAAG,CAG/B,CAAC;EAEHC,WAAWA,CAASC,kBAA4C,EAAE;IAChE,KAAK,CAAC,CAAC;IAAC,KADUA,kBAA4C,GAA5CA,kBAA4C;EAEhE;EAEUC,cAAcA,CACtBC,aAAiC,EACe;IAChD,MAAMC,gBAAgB,GAAGD,aAAa,CAACE,GAAG,CAAEC,IAAI,IAC9C,IAAI,CAACL,kBAAkB,CAACM,YAAY,CAACD,IAAI,CAACE,KAAK,IAAI,CAAC,CAAC,CACvD,CAAC;IAED,MAAMC,aAAa,GAAGL,gBAAgB,CACnCC,GAAG,CAAEK,MAAM,IAAKC,IAAI,CAACC,SAAS,CAACF,MAAM,CAAC,CAAC,CACvCG,IAAI,CAAC,IAAI,CAAC;IAEb,IAAIC,SAAS,GAAG,IAAI,CAAChB,eAAe,CAACiB,GAAG,CAACN,aAAa,CAAC;IAEvD,IAAI,CAACK,SAAS,EAAE;MACdA,SAAS,GAAGV,gBAEX;MACD,IAAI,CAACN,eAAe,CAACkB,GAAG,CAACP,aAAa,EAAEK,SAAS,CAAC;IACpD;IAEA,OAAOA,SAAS;EAClB;AACF","ignoreList":[]}

package/build/esm/observable/internal/KnownCacheKey.js.map

@@ -1 +1 @@
-{"version":3,"file":"KnownCacheKey.js","names":[],"sources":["KnownCacheKey.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 { SpecificLinkCacheKey } from \"./links/SpecificLinkCacheKey.js\";\nimport type { ListCacheKey } from \"./list/ListCacheKey.js\";\nimport type { ObjectCacheKey } from \"./object/ObjectCacheKey.js\";\nimport type { ObjectSetCacheKey } from \"./objectset/ObjectSetCacheKey.js\";\n\nexport type KnownCacheKey =\n  | ObjectCacheKey\n  | SpecificLinkCacheKey\n  | ListCacheKey\n  | ObjectSetCacheKey;\n"],"mappings":"","ignoreList":[]}
+{"version":3,"file":"KnownCacheKey.js","names":[],"sources":["KnownCacheKey.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 { AggregationCacheKey } from \"./aggregation/AggregationCacheKey.js\";\nimport type { SpecificLinkCacheKey } from \"./links/SpecificLinkCacheKey.js\";\nimport type { ListCacheKey } from \"./list/ListCacheKey.js\";\nimport type { ObjectCacheKey } from \"./object/ObjectCacheKey.js\";\nimport type { ObjectSetCacheKey } from \"./objectset/ObjectSetCacheKey.js\";\n\nexport type KnownCacheKey =\n  | AggregationCacheKey\n  | ObjectCacheKey\n  | SpecificLinkCacheKey\n  | ListCacheKey\n  | ObjectSetCacheKey;\n"],"mappings":"","ignoreList":[]}

package/build/esm/observable/internal/ObservableClientImpl.js

@@ -45,6 +45,9 @@ export class ObservableClientImpl {
     // cast to cross typed to untyped barrier
     subFn);
   };
+  observeAggregation = (options, subFn) => {
+    return this.__experimentalStore.aggregations.observe(options, subFn);
+  };
   observeLinks = (objects, linkName, options, subFn) => {
     // Convert to array if single object provided
     const objectsArray = Array.isArray(objects) ? objects : [objects];

package/build/esm/observable/internal/ObservableClientImpl.js.map

@@ -1 +1 @@
-{"version":3,"file":"ObservableClientImpl.js","names":["Subscription","UnsubscribableWrapper","ObservableClientImpl","constructor","store","__experimentalStore","applyAction","bind","validateAction","observeObject","apiName","pk","options","subFn","objects","observe","observeList","lists","observeLinks","linkName","objectsArray","Array","isArray","parentSub","obj","querySubscription","links","srcType","type","$apiName","$primaryKey","add","observeObjectSet","baseObjectSet","objectSets","invalidateAll","invalidateObjects","invalidateObjectType","undefined","canonicalizeWhereClause","where","whereCanonicalizer","canonicalize"],"sources":["ObservableClientImpl.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  ActionDefinition,\n  ActionValidationResponse,\n  CompileTimeMetadata,\n  InterfaceDefinition,\n  ObjectSet,\n  ObjectTypeDefinition,\n  Osdk,\n  PrimaryKeyType,\n  WhereClause,\n  WirePropertyTypes,\n} from \"@osdk/api\";\nimport { Subscription } from \"rxjs\";\nimport type { ActionSignatureFromDef } from \"../../actions/applyAction.js\";\nimport type { SpecificLinkPayload } from \"../LinkPayload.js\";\nimport type { ListPayload } from \"../ListPayload.js\";\nimport type { ObjectPayload } from \"../ObjectPayload.js\";\nimport type { ObjectSetPayload } from \"../ObjectSetPayload.js\";\nimport type {\n  ObservableClient,\n  ObserveListOptions,\n  ObserveObjectArgs,\n  ObserveObjectOptions,\n  ObserveObjectsArgs,\n  ObserveObjectSetArgs,\n  Unsubscribable,\n} from \"../ObservableClient.js\";\nimport type { Observer } from \"../ObservableClient/common.js\";\nimport type { ObserveLinks } from \"../ObservableClient/ObserveLink.js\";\nimport type { Canonical } from \"./Canonical.js\";\nimport type { ObserveObjectSetOptions } from \"./objectset/ObjectSetQueryOptions.js\";\nimport type { Store } from \"./Store.js\";\nimport { UnsubscribableWrapper } from \"./UnsubscribableWrapper.js\";\n\n/**\n * Implementation of the public ObservableClient interface.\n * - Delegates all operations to the Store for consistency\n * - Serves as the entry point for reactive data management\n * - Ensures proper method binding and API exposure\n *\n * @internal\n */\nexport class ObservableClientImpl implements ObservableClient {\n  __experimentalStore: Store;\n\n  constructor(store: Store) {\n    this.__experimentalStore = store;\n\n    this.applyAction = store.applyAction.bind(store);\n    this.validateAction = store.validateAction.bind(store);\n  }\n\n  public observeObject: <T extends ObjectTypeDefinition>(\n    apiName: T[\"apiName\"] | T,\n    pk: PrimaryKeyType<T>,\n    options: Omit<ObserveObjectOptions<T>, \"apiName\" | \"pk\">,\n    subFn: Observer<ObserveObjectArgs<T>>,\n  ) => Unsubscribable = (apiName, pk, options, subFn) => {\n    return this.__experimentalStore.objects.observe(\n      {\n        ...options,\n        apiName,\n        pk,\n      },\n      // cast to cross typed to untyped barrier\n      subFn as unknown as Observer<ObjectPayload>,\n    );\n  };\n\n  public observeList: <T extends ObjectTypeDefinition | InterfaceDefinition>(\n    options: ObserveListOptions<T>,\n    subFn: Observer<ObserveObjectsArgs<T>>,\n  ) => Unsubscribable = (options, subFn) => {\n    return this.__experimentalStore.lists.observe(\n      options,\n      // cast to cross typed to untyped barrier\n      subFn as unknown as Observer<ListPayload>,\n    );\n  };\n\n  public observeLinks: <\n    T extends ObjectTypeDefinition | InterfaceDefinition,\n    L extends keyof CompileTimeMetadata<T>[\"links\"] & string,\n  >(\n    objects: Osdk.Instance<T> | Array<Osdk.Instance<T>>,\n    linkName: L,\n    options: ObserveLinks.Options<T, L>,\n    subFn: Observer<\n      ObserveLinks.CallbackArgs<\n        CompileTimeMetadata<T>[\"links\"][L][\"targetType\"]\n      >\n    >,\n  ) => Unsubscribable = (objects, linkName, options, subFn) => {\n    // Convert to array if single object provided\n    const objectsArray = Array.isArray(objects) ? objects : [objects];\n\n    const parentSub = new Subscription();\n\n    for (const obj of objectsArray) {\n      const querySubscription = this.__experimentalStore.links\n        .observe(\n          {\n            ...options,\n            srcType: {\n              type: \"object\",\n              apiName: obj.$apiName,\n            },\n            linkName,\n            pk: obj.$primaryKey,\n          },\n          // cast to cross typed to untyped barrier\n          subFn as unknown as Observer<SpecificLinkPayload>,\n        );\n\n      parentSub.add(querySubscription);\n    }\n\n    return new UnsubscribableWrapper(parentSub);\n  };\n\n  public applyAction: <Q extends ActionDefinition<any>>(\n    action: Q,\n    args: Parameters<ActionSignatureFromDef<Q>[\"applyAction\"]>[0],\n    opts?: ObservableClient.ApplyActionOptions,\n  ) => Promise<unknown>;\n\n  public validateAction: <Q extends ActionDefinition<any>>(\n    action: Q,\n    args: Parameters<ActionSignatureFromDef<Q>[\"applyAction\"]>[0],\n  ) => Promise<ActionValidationResponse>;\n\n  public observeObjectSet<\n    T extends ObjectTypeDefinition,\n    RDPs extends Record<\n      string,\n      WirePropertyTypes | undefined | Array<WirePropertyTypes>\n    > = {},\n  >(\n    baseObjectSet: ObjectSet<T>,\n    options: ObserveObjectSetOptions<T, RDPs>,\n    subFn: Observer<ObserveObjectSetArgs<T, RDPs>>,\n  ): Unsubscribable {\n    return this.__experimentalStore.objectSets.observe(\n      { baseObjectSet, ...options },\n      // cast to cross typed to untyped barrier\n      subFn as unknown as Observer<ObjectSetPayload>,\n    );\n  }\n\n  public invalidateAll(): Promise<void> {\n    return this.__experimentalStore.invalidateAll();\n  }\n\n  public invalidateObjects(\n    objects:\n      | Osdk.Instance<ObjectTypeDefinition>\n      | ReadonlyArray<Osdk.Instance<ObjectTypeDefinition>>,\n  ): Promise<void> {\n    return this.__experimentalStore.invalidateObjects(objects);\n  }\n\n  public invalidateObjectType<T extends ObjectTypeDefinition>(\n    type: T | T[\"apiName\"],\n  ): Promise<void> {\n    return this.__experimentalStore.invalidateObjectType(type, undefined);\n  }\n\n  public canonicalizeWhereClause<\n    T extends ObjectTypeDefinition | InterfaceDefinition,\n  >(where: WhereClause<T>): Canonical<WhereClause<T>> {\n    return this.__experimentalStore.whereCanonicalizer\n      .canonicalize(where) as Canonical<WhereClause<T>>;\n  }\n}\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAcA,SAASA,YAAY,QAAQ,MAAM;AAoBnC,SAASC,qBAAqB,QAAQ,4BAA4B;;AAElE;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMC,oBAAoB,CAA6B;EAG5DC,WAAWA,CAACC,KAAY,EAAE;IACxB,IAAI,CAACC,mBAAmB,GAAGD,KAAK;IAEhC,IAAI,CAACE,WAAW,GAAGF,KAAK,CAACE,WAAW,CAACC,IAAI,CAACH,KAAK,CAAC;IAChD,IAAI,CAACI,cAAc,GAAGJ,KAAK,CAACI,cAAc,CAACD,IAAI,CAACH,KAAK,CAAC;EACxD;EAEOK,aAAa,GAKEA,CAACC,OAAO,EAAEC,EAAE,EAAEC,OAAO,EAAEC,KAAK,KAAK;IACrD,OAAO,IAAI,CAACR,mBAAmB,CAACS,OAAO,CAACC,OAAO,CAC7C;MACE,GAAGH,OAAO;MACVF,OAAO;MACPC;IACF,CAAC;IACD;IACAE,KACF,CAAC;EACH,CAAC;EAEMG,WAAW,GAGIA,CAACJ,OAAO,EAAEC,KAAK,KAAK;IACxC,OAAO,IAAI,CAACR,mBAAmB,CAACY,KAAK,CAACF,OAAO,CAC3CH,OAAO;IACP;IACAC,KACF,CAAC;EACH,CAAC;EAEMK,YAAY,GAYGA,CAACJ,OAAO,EAAEK,QAAQ,EAAEP,OAAO,EAAEC,KAAK,KAAK;IAC3D;IACA,MAAMO,YAAY,GAAGC,KAAK,CAACC,OAAO,CAACR,OAAO,CAAC,GAAGA,OAAO,GAAG,CAACA,OAAO,CAAC;IAEjE,MAAMS,SAAS,GAAG,IAAIvB,YAAY,CAAC,CAAC;IAEpC,KAAK,MAAMwB,GAAG,IAAIJ,YAAY,EAAE;MAC9B,MAAMK,iBAAiB,GAAG,IAAI,CAACpB,mBAAmB,CAACqB,KAAK,CACrDX,OAAO,CACN;QACE,GAAGH,OAAO;QACVe,OAAO,EAAE;UACPC,IAAI,EAAE,QAAQ;UACdlB,OAAO,EAAEc,GAAG,CAACK;QACf,CAAC;QACDV,QAAQ;QACRR,EAAE,EAAEa,GAAG,CAACM;MACV,CAAC;MACD;MACAjB,KACF,CAAC;MAEHU,SAAS,CAACQ,GAAG,CAACN,iBAAiB,CAAC;IAClC;IAEA,OAAO,IAAIxB,qBAAqB,CAACsB,SAAS,CAAC;EAC7C,CAAC;EAaMS,gBAAgBA,CAOrBC,aAA2B,EAC3BrB,OAAyC,EACzCC,KAA8C,EAC9B;IAChB,OAAO,IAAI,CAACR,mBAAmB,CAAC6B,UAAU,CAACnB,OAAO,CAChD;MAAEkB,aAAa;MAAE,GAAGrB;IAAQ,CAAC;IAC7B;IACAC,KACF,CAAC;EACH;EAEOsB,aAAaA,CAAA,EAAkB;IACpC,OAAO,IAAI,CAAC9B,mBAAmB,CAAC8B,aAAa,CAAC,CAAC;EACjD;EAEOC,iBAAiBA,CACtBtB,OAEsD,EACvC;IACf,OAAO,IAAI,CAACT,mBAAmB,CAAC+B,iBAAiB,CAACtB,OAAO,CAAC;EAC5D;EAEOuB,oBAAoBA,CACzBT,IAAsB,EACP;IACf,OAAO,IAAI,CAACvB,mBAAmB,CAACgC,oBAAoB,CAACT,IAAI,EAAEU,SAAS,CAAC;EACvE;EAEOC,uBAAuBA,CAE5BC,KAAqB,EAA6B;IAClD,OAAO,IAAI,CAACnC,mBAAmB,CAACoC,kBAAkB,CAC/CC,YAAY,CAACF,KAAK,CAAC;EACxB;AACF","ignoreList":[]}
+{"version":3,"file":"ObservableClientImpl.js","names":["Subscription","UnsubscribableWrapper","ObservableClientImpl","constructor","store","__experimentalStore","applyAction","bind","validateAction","observeObject","apiName","pk","options","subFn","objects","observe","observeList","lists","observeAggregation","aggregations","observeLinks","linkName","objectsArray","Array","isArray","parentSub","obj","querySubscription","links","srcType","type","$apiName","$primaryKey","add","observeObjectSet","baseObjectSet","objectSets","invalidateAll","invalidateObjects","invalidateObjectType","undefined","canonicalizeWhereClause","where","whereCanonicalizer","canonicalize"],"sources":["ObservableClientImpl.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  ActionDefinition,\n  ActionValidationResponse,\n  AggregateOpts,\n  CompileTimeMetadata,\n  InterfaceDefinition,\n  ObjectOrInterfaceDefinition,\n  ObjectSet,\n  ObjectTypeDefinition,\n  Osdk,\n  PrimaryKeyType,\n  SimplePropertyDef,\n  WhereClause,\n  WirePropertyTypes,\n} from \"@osdk/api\";\nimport { Subscription } from \"rxjs\";\nimport type { ActionSignatureFromDef } from \"../../actions/applyAction.js\";\nimport type { SpecificLinkPayload } from \"../LinkPayload.js\";\nimport type { ListPayload } from \"../ListPayload.js\";\nimport type { ObjectPayload } from \"../ObjectPayload.js\";\nimport type { ObjectSetPayload } from \"../ObjectSetPayload.js\";\nimport type {\n  ObservableClient,\n  ObserveAggregationArgs,\n  ObserveAggregationOptions,\n  ObserveListOptions,\n  ObserveObjectArgs,\n  ObserveObjectOptions,\n  ObserveObjectsArgs,\n  ObserveObjectSetArgs,\n  Unsubscribable,\n} from \"../ObservableClient.js\";\nimport type { Observer } from \"../ObservableClient/common.js\";\nimport type { ObserveLinks } from \"../ObservableClient/ObserveLink.js\";\nimport type { AggregationPayloadBase } from \"./aggregation/AggregationQuery.js\";\nimport type { Canonical } from \"./Canonical.js\";\nimport type { ObserveObjectSetOptions } from \"./objectset/ObjectSetQueryOptions.js\";\nimport type { Store } from \"./Store.js\";\nimport { UnsubscribableWrapper } from \"./UnsubscribableWrapper.js\";\n\n/**\n * Implementation of the public ObservableClient interface.\n * - Delegates all operations to the Store for consistency\n * - Serves as the entry point for reactive data management\n * - Ensures proper method binding and API exposure\n *\n * @internal\n */\nexport class ObservableClientImpl implements ObservableClient {\n  __experimentalStore: Store;\n\n  constructor(store: Store) {\n    this.__experimentalStore = store;\n\n    this.applyAction = store.applyAction.bind(store);\n    this.validateAction = store.validateAction.bind(store);\n  }\n\n  public observeObject: <T extends ObjectTypeDefinition>(\n    apiName: T[\"apiName\"] | T,\n    pk: PrimaryKeyType<T>,\n    options: Omit<ObserveObjectOptions<T>, \"apiName\" | \"pk\">,\n    subFn: Observer<ObserveObjectArgs<T>>,\n  ) => Unsubscribable = (apiName, pk, options, subFn) => {\n    return this.__experimentalStore.objects.observe(\n      {\n        ...options,\n        apiName,\n        pk,\n      },\n      // cast to cross typed to untyped barrier\n      subFn as unknown as Observer<ObjectPayload>,\n    );\n  };\n\n  public observeList: <\n    T extends ObjectTypeDefinition | InterfaceDefinition,\n    RDPs extends Record<string, SimplePropertyDef> = {},\n  >(\n    options: ObserveListOptions<T, RDPs>,\n    subFn: Observer<ObserveObjectsArgs<T>>,\n  ) => Unsubscribable = (options, subFn) => {\n    return this.__experimentalStore.lists.observe(\n      options,\n      // cast to cross typed to untyped barrier\n      subFn as unknown as Observer<ListPayload>,\n    );\n  };\n\n  public observeAggregation: <\n    T extends ObjectOrInterfaceDefinition,\n    A extends AggregateOpts<T>,\n    RDPs extends Record<string, SimplePropertyDef> = {},\n  >(\n    options: ObserveAggregationOptions<T, A, RDPs>,\n    subFn: Observer<ObserveAggregationArgs<T, A>>,\n  ) => Unsubscribable = <\n    T extends ObjectOrInterfaceDefinition,\n    A extends AggregateOpts<T>,\n    RDPs extends Record<string, SimplePropertyDef> = {},\n  >(\n    options: ObserveAggregationOptions<T, A, RDPs>,\n    subFn: Observer<ObserveAggregationArgs<T, A>>,\n  ) => {\n    return this.__experimentalStore.aggregations.observe(\n      options,\n      subFn as Observer<AggregationPayloadBase>,\n    );\n  };\n\n  public observeLinks: <\n    T extends ObjectTypeDefinition | InterfaceDefinition,\n    L extends keyof CompileTimeMetadata<T>[\"links\"] & string,\n  >(\n    objects: Osdk.Instance<T> | Array<Osdk.Instance<T>>,\n    linkName: L,\n    options: ObserveLinks.Options<T, L>,\n    subFn: Observer<\n      ObserveLinks.CallbackArgs<\n        CompileTimeMetadata<T>[\"links\"][L][\"targetType\"]\n      >\n    >,\n  ) => Unsubscribable = (objects, linkName, options, subFn) => {\n    // Convert to array if single object provided\n    const objectsArray = Array.isArray(objects) ? objects : [objects];\n\n    const parentSub = new Subscription();\n\n    for (const obj of objectsArray) {\n      const querySubscription = this.__experimentalStore.links\n        .observe(\n          {\n            ...options,\n            srcType: {\n              type: \"object\",\n              apiName: obj.$apiName,\n            },\n            linkName,\n            pk: obj.$primaryKey,\n          },\n          // cast to cross typed to untyped barrier\n          subFn as unknown as Observer<SpecificLinkPayload>,\n        );\n\n      parentSub.add(querySubscription);\n    }\n\n    return new UnsubscribableWrapper(parentSub);\n  };\n\n  public applyAction: <Q extends ActionDefinition<any>>(\n    action: Q,\n    args: Parameters<ActionSignatureFromDef<Q>[\"applyAction\"]>[0],\n    opts?: ObservableClient.ApplyActionOptions,\n  ) => Promise<unknown>;\n\n  public validateAction: <Q extends ActionDefinition<any>>(\n    action: Q,\n    args: Parameters<ActionSignatureFromDef<Q>[\"applyAction\"]>[0],\n  ) => Promise<ActionValidationResponse>;\n\n  public observeObjectSet<\n    T extends ObjectTypeDefinition,\n    RDPs extends Record<\n      string,\n      WirePropertyTypes | undefined | Array<WirePropertyTypes>\n    > = {},\n  >(\n    baseObjectSet: ObjectSet<T>,\n    options: ObserveObjectSetOptions<T, RDPs>,\n    subFn: Observer<ObserveObjectSetArgs<T, RDPs>>,\n  ): Unsubscribable {\n    return this.__experimentalStore.objectSets.observe(\n      { baseObjectSet, ...options },\n      // cast to cross typed to untyped barrier\n      subFn as unknown as Observer<ObjectSetPayload>,\n    );\n  }\n\n  public invalidateAll(): Promise<void> {\n    return this.__experimentalStore.invalidateAll();\n  }\n\n  public invalidateObjects(\n    objects:\n      | Osdk.Instance<ObjectTypeDefinition>\n      | ReadonlyArray<Osdk.Instance<ObjectTypeDefinition>>,\n  ): Promise<void> {\n    return this.__experimentalStore.invalidateObjects(objects);\n  }\n\n  public invalidateObjectType<T extends ObjectTypeDefinition>(\n    type: T | T[\"apiName\"],\n  ): Promise<void> {\n    return this.__experimentalStore.invalidateObjectType(type, undefined);\n  }\n\n  public canonicalizeWhereClause<\n    T extends ObjectTypeDefinition | InterfaceDefinition,\n    RDPs extends Record<string, SimplePropertyDef> = {},\n  >(where: WhereClause<T, RDPs>): Canonical<WhereClause<T, RDPs>> {\n    return this.__experimentalStore.whereCanonicalizer\n      .canonicalize(where) as Canonical<WhereClause<T, RDPs>>;\n  }\n}\n"],"mappings":"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","ignoreList":[]}

package/build/esm/observable/internal/OrderByCanonicalizer.js

@@ -23,10 +23,7 @@ export class OrderByCanonicalizer {
       }
       return result;
     }, []);
-    let data = Object.fromEntries(pairs);
-    if (process.env.NODE_ENV !== "production") {
-      data = Object.freeze(data);
-    }
+    const data = Object.fromEntries(pairs);
     return data;
   });
   canonicalize = orderBy => {

package/build/esm/observable/internal/OrderByCanonicalizer.js.map

@@ -1 +1 @@
-{"version":3,"file":"OrderByCanonicalizer.js","names":["WeakRefTrie","OrderByCanonicalizer","trie","array","pairs","reduce","result","_","index","push","slice","data","Object","fromEntries","process","env","NODE_ENV","freeze","canonicalize","orderBy","strings","entries","flat","lookupArray"],"sources":["OrderByCanonicalizer.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 { ObjectTypeDefinition } from \"@osdk/api\";\nimport type { OrderBy } from \"../ObservableClient.js\";\nimport type { Canonical } from \"./Canonical.js\";\nimport { WeakRefTrie } from \"./WeakRefTrie.js\";\n\nexport class OrderByCanonicalizer {\n  #trie = new WeakRefTrie(\n    (array: Array<string>) => {\n      const pairs = array.reduce<Array<[string, \"asc\" | \"desc\"]>>(\n        function(result, _, index, array) {\n          if (index % 2 === 0 && array[index] != null) {\n            result.push(\n              array.slice(index, index + 2) as [string, \"asc\" | \"desc\"],\n            );\n          }\n          return result;\n        },\n        [],\n      );\n      let data = Object.fromEntries(pairs) satisfies Record<\n        string,\n        \"asc\" | \"desc\"\n      > as Canonical<OrderBy<ObjectTypeDefinition>>;\n\n      if (process.env.NODE_ENV !== \"production\") {\n        data = Object.freeze(data);\n      }\n      return data;\n    },\n  );\n\n  canonicalize: (\n    orderBy: Record<string, \"asc\" | \"desc\" | undefined>,\n  ) => Canonical<Record<string, \"asc\" | \"desc\" | undefined>> = (\n    orderBy,\n  ) => {\n    const strings = Object.entries(orderBy).flat();\n    return this.#trie.lookupArray(strings);\n  };\n}\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAKA,SAASA,WAAW,QAAQ,kBAAkB;AAE9C,OAAO,MAAMC,oBAAoB,CAAC;EAChC,CAACC,IAAI,GAAG,IAAIF,WAAW,CACpBG,KAAoB,IAAK;IACxB,MAAMC,KAAK,GAAGD,KAAK,CAACE,MAAM,CACxB,UAASC,MAAM,EAAEC,CAAC,EAAEC,KAAK,EAAEL,KAAK,EAAE;MAChC,IAAIK,KAAK,GAAG,CAAC,KAAK,CAAC,IAAIL,KAAK,CAACK,KAAK,CAAC,IAAI,IAAI,EAAE;QAC3CF,MAAM,CAACG,IAAI,CACTN,KAAK,CAACO,KAAK,CAACF,KAAK,EAAEA,KAAK,GAAG,CAAC,CAC9B,CAAC;MACH;MACA,OAAOF,MAAM;IACf,CAAC,EACD,EACF,CAAC;IACD,IAAIK,IAAI,GAAGC,MAAM,CAACC,WAAW,CAACT,KAAK,CAGU;IAE7C,IAAIU,OAAO,CAACC,GAAG,CAACC,QAAQ,KAAK,YAAY,EAAE;MACzCL,IAAI,GAAGC,MAAM,CAACK,MAAM,CAACN,IAAI,CAAC;IAC5B;IACA,OAAOA,IAAI;EACb,CACF,CAAC;EAEDO,YAAY,GAGVC,OAAO,IACJ;IACH,MAAMC,OAAO,GAAGR,MAAM,CAACS,OAAO,CAACF,OAAO,CAAC,CAACG,IAAI,CAAC,CAAC;IAC9C,OAAO,IAAI,CAAC,CAACpB,IAAI,CAACqB,WAAW,CAACH,OAAO,CAAC;EACxC,CAAC;AACH","ignoreList":[]}
+{"version":3,"file":"OrderByCanonicalizer.js","names":["WeakRefTrie","OrderByCanonicalizer","trie","array","pairs","reduce","result","_","index","push","slice","data","Object","fromEntries","canonicalize","orderBy","strings","entries","flat","lookupArray"],"sources":["OrderByCanonicalizer.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 { ObjectTypeDefinition } from \"@osdk/api\";\nimport type { OrderBy } from \"../ObservableClient.js\";\nimport type { Canonical } from \"./Canonical.js\";\nimport { WeakRefTrie } from \"./WeakRefTrie.js\";\n\nexport class OrderByCanonicalizer {\n  #trie = new WeakRefTrie(\n    (array: Array<string>) => {\n      const pairs = array.reduce<Array<[string, \"asc\" | \"desc\"]>>(\n        function(result, _, index, array) {\n          if (index % 2 === 0 && array[index] != null) {\n            result.push(\n              array.slice(index, index + 2) as [string, \"asc\" | \"desc\"],\n            );\n          }\n          return result;\n        },\n        [],\n      );\n      const data = Object.fromEntries(pairs) satisfies Record<\n        string,\n        \"asc\" | \"desc\"\n      > as Canonical<OrderBy<ObjectTypeDefinition>>;\n      return data;\n    },\n  );\n\n  canonicalize: (\n    orderBy: Record<string, \"asc\" | \"desc\" | undefined>,\n  ) => Canonical<Record<string, \"asc\" | \"desc\" | undefined>> = (\n    orderBy,\n  ) => {\n    const strings = Object.entries(orderBy).flat();\n    return this.#trie.lookupArray(strings);\n  };\n}\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAKA,SAASA,WAAW,QAAQ,kBAAkB;AAE9C,OAAO,MAAMC,oBAAoB,CAAC;EAChC,CAACC,IAAI,GAAG,IAAIF,WAAW,CACpBG,KAAoB,IAAK;IACxB,MAAMC,KAAK,GAAGD,KAAK,CAACE,MAAM,CACxB,UAASC,MAAM,EAAEC,CAAC,EAAEC,KAAK,EAAEL,KAAK,EAAE;MAChC,IAAIK,KAAK,GAAG,CAAC,KAAK,CAAC,IAAIL,KAAK,CAACK,KAAK,CAAC,IAAI,IAAI,EAAE;QAC3CF,MAAM,CAACG,IAAI,CACTN,KAAK,CAACO,KAAK,CAACF,KAAK,EAAEA,KAAK,GAAG,CAAC,CAC9B,CAAC;MACH;MACA,OAAOF,MAAM;IACf,CAAC,EACD,EACF,CAAC;IACD,MAAMK,IAAI,GAAGC,MAAM,CAACC,WAAW,CAACT,KAAK,CAGQ;IAC7C,OAAOO,IAAI;EACb,CACF,CAAC;EAEDG,YAAY,GAGVC,OAAO,IACJ;IACH,MAAMC,OAAO,GAAGJ,MAAM,CAACK,OAAO,CAACF,OAAO,CAAC,CAACG,IAAI,CAAC,CAAC;IAC9C,OAAO,IAAI,CAAC,CAAChB,IAAI,CAACiB,WAAW,CAACH,OAAO,CAAC;EACxC,CAAC;AACH","ignoreList":[]}

package/build/esm/observable/internal/PivotCanonicalizer.js

@@ -0,0 +1,33 @@
+/*
+ * 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.
+ */
+
+export class PivotCanonicalizer {
+  #cache = new Map();
+  canonicalize(sourceType, linkName) {
+    const key = `${sourceType}::${linkName}`;
+    let canonical = this.#cache.get(key);
+    if (!canonical) {
+      canonical = {
+        sourceType,
+        linkName,
+        targetType: "<targetType>"
+      };
+      this.#cache.set(key, canonical);
+    }
+    return canonical;
+  }
+}
+//# sourceMappingURL=PivotCanonicalizer.js.map

package/build/esm/observable/internal/PivotCanonicalizer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PivotCanonicalizer.js","names":["PivotCanonicalizer","cache","Map","canonicalize","sourceType","linkName","key","canonical","get","targetType","set"],"sources":["PivotCanonicalizer.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 { Canonical } from \"./Canonical.js\";\n\nexport interface PivotInfo {\n  sourceType: string;\n  linkName: string;\n  targetType: string;\n}\n\nexport class PivotCanonicalizer {\n  #cache = new Map<string, Canonical<PivotInfo>>();\n\n  canonicalize(sourceType: string, linkName: string): Canonical<PivotInfo> {\n    const key = `${sourceType}::${linkName}`;\n\n    let canonical = this.#cache.get(key);\n\n    if (!canonical) {\n      canonical = {\n        sourceType,\n        linkName,\n        targetType: \"<targetType>\",\n      } as Canonical<PivotInfo>;\n      this.#cache.set(key, canonical);\n    }\n\n    return canonical;\n  }\n}\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAUA,OAAO,MAAMA,kBAAkB,CAAC;EAC9B,CAACC,KAAK,GAAG,IAAIC,GAAG,CAA+B,CAAC;EAEhDC,YAAYA,CAACC,UAAkB,EAAEC,QAAgB,EAAwB;IACvE,MAAMC,GAAG,GAAG,GAAGF,UAAU,KAAKC,QAAQ,EAAE;IAExC,IAAIE,SAAS,GAAG,IAAI,CAAC,CAACN,KAAK,CAACO,GAAG,CAACF,GAAG,CAAC;IAEpC,IAAI,CAACC,SAAS,EAAE;MACdA,SAAS,GAAG;QACVH,UAAU;QACVC,QAAQ;QACRI,UAAU,EAAE;MACd,CAAyB;MACzB,IAAI,CAAC,CAACR,KAAK,CAACS,GAAG,CAACJ,GAAG,EAAEC,SAAS,CAAC;IACjC;IAEA,OAAOA,SAAS;EAClB;AACF","ignoreList":[]}

package/build/esm/observable/internal/RdpCanonicalizer.js

@@ -0,0 +1,66 @@
+/*
+ * 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 { createWithPropertiesObjectSet } from "../../derivedProperties/createWithPropertiesObjectSet.js";
+import { CachingCanonicalizer } from "./Canonicalizer.js";
+export class RdpCanonicalizer extends CachingCanonicalizer {
+  structuralCache = new Map();
+  lookupOrCreate(rdp) {
+    // Map from builder result symbols to their definitions
+    const definitionMap = new Map();
+    const computedProperties = {};
+
+    // Create a wrapper holding object type for the builder to let us extract the definition structure
+    const objectTypeHolder = {
+      type: "object",
+      apiName: "__rdp_canonicalizer_holder__"
+    };
+    for (const [key, rdpFunction] of Object.entries(rdp)) {
+      const builder = createWithPropertiesObjectSet(objectTypeHolder, {
+        type: "methodInput"
+      }, definitionMap, /* fromBaseObjectSet */true);
+      const result = rdpFunction(builder);
+      const definition = definitionMap.get(result);
+      if (definition) {
+        computedProperties[key] = definition;
+      }
+    }
+
+    // Sort entries by key for consistent ordering
+    const sortedKeys = Object.keys(computedProperties).sort();
+
+    // Create a serialized key for the computed definitions
+    const sortedDefinitions = {};
+    for (const key of sortedKeys) {
+      sortedDefinitions[key] = computedProperties[key];
+    }
+    const definitionsKey = JSON.stringify(sortedDefinitions);
+
+    // Check if we already have a canonical RDP for these definitions
+    let canonical = this.structuralCache.get(definitionsKey);
+    if (!canonical) {
+      // Create a canonical RDP object with sorted keys
+      const sortedRdp = {};
+      for (const key of Object.keys(rdp).sort()) {
+        sortedRdp[key] = rdp[key];
+      }
+      canonical = sortedRdp;
+      this.structuralCache.set(definitionsKey, canonical);
+    }
+    return canonical;
+  }
+}
+//# sourceMappingURL=RdpCanonicalizer.js.map

package/build/esm/observable/internal/RdpCanonicalizer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RdpCanonicalizer.js","names":["createWithPropertiesObjectSet","CachingCanonicalizer","RdpCanonicalizer","structuralCache","Map","lookupOrCreate","rdp","definitionMap","computedProperties","objectTypeHolder","type","apiName","key","rdpFunction","Object","entries","builder","result","definition","get","sortedKeys","keys","sort","sortedDefinitions","definitionsKey","JSON","stringify","canonical","sortedRdp","set"],"sources":["RdpCanonicalizer.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  ObjectOrInterfaceDefinition,\n  SimplePropertyDef,\n} from \"@osdk/api\";\nimport type { DerivedPropertyDefinition } from \"@osdk/foundry.ontologies\";\nimport { createWithPropertiesObjectSet } from \"../../derivedProperties/createWithPropertiesObjectSet.js\";\nimport type { Canonical } from \"./Canonical.js\";\nimport { CachingCanonicalizer } from \"./Canonicalizer.js\";\n\nexport type Rdp = DerivedProperty.Clause<ObjectOrInterfaceDefinition>;\n\nexport class RdpCanonicalizer extends CachingCanonicalizer<Rdp, Rdp> {\n  private structuralCache = new Map<string, Canonical<Rdp>>();\n\n  protected lookupOrCreate(rdp: Rdp): Canonical<Rdp> {\n    // Map from builder result symbols to their definitions\n    const definitionMap = new Map<\n      DerivedProperty.Definition<\n        SimplePropertyDef,\n        ObjectOrInterfaceDefinition\n      >,\n      DerivedPropertyDefinition\n    >();\n    const computedProperties: Record<string, DerivedPropertyDefinition> = {};\n\n    // Create a wrapper holding object type for the builder to let us extract the definition structure\n    const objectTypeHolder = {\n      type: \"object\" as const,\n      apiName: \"__rdp_canonicalizer_holder__\",\n    } as ObjectOrInterfaceDefinition;\n\n    for (const [key, rdpFunction] of Object.entries(rdp)) {\n      const builder = createWithPropertiesObjectSet(\n        objectTypeHolder,\n        { type: \"methodInput\" },\n        definitionMap,\n        /* fromBaseObjectSet */ true,\n      );\n\n      const result = rdpFunction(builder);\n      const definition = definitionMap.get(result);\n\n      if (definition) {\n        computedProperties[key] = definition;\n      }\n    }\n\n    // Sort entries by key for consistent ordering\n    const sortedKeys = Object.keys(computedProperties).sort();\n\n    // Create a serialized key for the computed definitions\n    const sortedDefinitions: Record<string, DerivedPropertyDefinition> = {};\n    for (const key of sortedKeys) {\n      sortedDefinitions[key] = computedProperties[key];\n    }\n    const definitionsKey = JSON.stringify(sortedDefinitions);\n\n    // Check if we already have a canonical RDP for these definitions\n    let canonical = this.structuralCache.get(definitionsKey);\n\n    if (!canonical) {\n      // Create a canonical RDP object with sorted keys\n      const sortedRdp: Rdp = {};\n      for (const key of Object.keys(rdp).sort()) {\n        sortedRdp[key] = rdp[key];\n      }\n      canonical = sortedRdp as Canonical<Rdp>;\n      this.structuralCache.set(definitionsKey, canonical);\n    }\n\n    return canonical;\n  }\n}\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAQA,SAASA,6BAA6B,QAAQ,0DAA0D;AAExG,SAASC,oBAAoB,QAAQ,oBAAoB;AAIzD,OAAO,MAAMC,gBAAgB,SAASD,oBAAoB,CAAW;EAC3DE,eAAe,GAAG,IAAIC,GAAG,CAAyB,CAAC;EAEjDC,cAAcA,CAACC,GAAQ,EAAkB;IACjD;IACA,MAAMC,aAAa,GAAG,IAAIH,GAAG,CAM3B,CAAC;IACH,MAAMI,kBAA6D,GAAG,CAAC,CAAC;;IAExE;IACA,MAAMC,gBAAgB,GAAG;MACvBC,IAAI,EAAE,QAAiB;MACvBC,OAAO,EAAE;IACX,CAAgC;IAEhC,KAAK,MAAM,CAACC,GAAG,EAAEC,WAAW,CAAC,IAAIC,MAAM,CAACC,OAAO,CAACT,GAAG,CAAC,EAAE;MACpD,MAAMU,OAAO,GAAGhB,6BAA6B,CAC3CS,gBAAgB,EAChB;QAAEC,IAAI,EAAE;MAAc,CAAC,EACvBH,aAAa,EACb,uBAAwB,IAC1B,CAAC;MAED,MAAMU,MAAM,GAAGJ,WAAW,CAACG,OAAO,CAAC;MACnC,MAAME,UAAU,GAAGX,aAAa,CAACY,GAAG,CAACF,MAAM,CAAC;MAE5C,IAAIC,UAAU,EAAE;QACdV,kBAAkB,CAACI,GAAG,CAAC,GAAGM,UAAU;MACtC;IACF;;IAEA;IACA,MAAME,UAAU,GAAGN,MAAM,CAACO,IAAI,CAACb,kBAAkB,CAAC,CAACc,IAAI,CAAC,CAAC;;IAEzD;IACA,MAAMC,iBAA4D,GAAG,CAAC,CAAC;IACvE,KAAK,MAAMX,GAAG,IAAIQ,UAAU,EAAE;MAC5BG,iBAAiB,CAACX,GAAG,CAAC,GAAGJ,kBAAkB,CAACI,GAAG,CAAC;IAClD;IACA,MAAMY,cAAc,GAAGC,IAAI,CAACC,SAAS,CAACH,iBAAiB,CAAC;;IAExD;IACA,IAAII,SAAS,GAAG,IAAI,CAACxB,eAAe,CAACgB,GAAG,CAACK,cAAc,CAAC;IAExD,IAAI,CAACG,SAAS,EAAE;MACd;MACA,MAAMC,SAAc,GAAG,CAAC,CAAC;MACzB,KAAK,MAAMhB,GAAG,IAAIE,MAAM,CAACO,IAAI,CAACf,GAAG,CAAC,CAACgB,IAAI,CAAC,CAAC,EAAE;QACzCM,SAAS,CAAChB,GAAG,CAAC,GAAGN,GAAG,CAACM,GAAG,CAAC;MAC3B;MACAe,SAAS,GAAGC,SAA2B;MACvC,IAAI,CAACzB,eAAe,CAAC0B,GAAG,CAACL,cAAc,EAAEG,SAAS,CAAC;IACrD;IAEA,OAAOA,SAAS;EAClB;AACF","ignoreList":[]}

package/build/esm/observable/internal/RdpCanonicalizer.test.js

@@ -0,0 +1,68 @@
+/*
+ * 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 { describe, expect, it } from "vitest";
+import { RdpCanonicalizer } from "./RdpCanonicalizer.js";
+describe("RdpCanonicalizer", () => {
+  it("returns same canonical object for functionally identical RDPs with different function references", () => {
+    const canonicalizer = new RdpCanonicalizer();
+
+    // Create first RDP with a function
+    const rdp1 = {
+      derivedAddress: base => base.pivotTo("lead").selectProperty("employeeId"),
+      derivedName: base => base.pivotTo("lead").selectProperty("fullName")
+    };
+
+    // Create second RDP with new function references but same logic
+    const rdp2 = {
+      derivedAddress: base => base.pivotTo("lead").selectProperty("employeeId"),
+      derivedName: base => base.pivotTo("lead").selectProperty("fullName")
+    };
+
+    // The functions should have different references
+    expect(rdp1.derivedAddress).not.toBe(rdp2.derivedAddress);
+    expect(rdp1.derivedName).not.toBe(rdp2.derivedName);
+
+    // But canonicalization should return the same object
+    const canonical1 = canonicalizer.canonicalize(rdp1);
+    const canonical2 = canonicalizer.canonicalize(rdp2);
+    expect(canonical1).toBe(canonical2);
+  });
+  it("handles complex RDP with aggregations", () => {
+    const canonicalizer = new RdpCanonicalizer();
+    const canonical1 = canonicalizer.canonicalize({
+      peepsCount: base => base.pivotTo("peeps").aggregate("$count"),
+      leadName: base => base.pivotTo("lead").selectProperty("fullName")
+    });
+    const canonical2 = canonicalizer.canonicalize({
+      peepsCount: base => base.pivotTo("peeps").aggregate("$count"),
+      leadName: base => base.pivotTo("lead").selectProperty("fullName")
+    });
+    expect(canonical1).toBe(canonical2);
+  });
+  it("caches results for the same input object", () => {
+    const canonicalizer = new RdpCanonicalizer();
+    const rdp = {
+      derivedProp: base => base.pivotTo("lead").selectProperty("employeeId")
+    };
+    const canonical1 = canonicalizer.canonicalize(rdp);
+    const canonical2 = canonicalizer.canonicalize(rdp);
+
+    // Same input object should return cached result
+    expect(canonical1).toBe(canonical2);
+  });
+});
+//# sourceMappingURL=RdpCanonicalizer.test.js.map