@osdk/client 2.1.1 → 2.2.0-beta.10

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

@@ -0,0 +1,112 @@
+/*
+ * 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 { beforeEach, describe, expect, it, vi } from "vitest";
+import { BulkObjectLoader } from "./BulkObjectLoader.js";
+import { createClientMockHelper } from "./testUtils.js";
+describe(BulkObjectLoader, () => {
+  let client;
+  let mockClient;
+  beforeEach(async () => {
+    mockClient = createClientMockHelper();
+    client = mockClient.client;
+
+    // eslint-disable-next-line @typescript-eslint/unbound-method
+    vi.mocked(client.fetchMetadata).mockReturnValue(Promise.resolve({
+      primaryKeyApiName: "id"
+    }));
+  });
+  const employees = [{
+    $apiName: "Employee",
+    $objectType: "Employee",
+    $primaryKey: 0
+  }, {
+    $apiName: "Employee",
+    $objectType: "Employee",
+    $primaryKey: 1
+  }, {
+    $apiName: "Employee",
+    $objectType: "Employee",
+    $primaryKey: 2
+  }];
+  it("splits up work by count", async () => {
+    const loader = new BulkObjectLoader(client, 25, /*ms*/2 /*entries*/);
+    const firstRequest = mockClient.mockFetchPageOnce();
+    const secondRequest = mockClient.mockFetchPageOnce();
+    const load0 = loader.fetch("Employee", 0);
+    const load1 = loader.fetch("Employee", 1);
+    const load2 = loader.fetch("Employee", 2);
+    firstRequest.resolve({
+      data: [employees[0], employees[1]],
+      nextPageToken: undefined,
+      totalCount: "2"
+    });
+    await expect(load0).resolves.toMatchObject({
+      $primaryKey: 0
+    });
+    await expect(load1).resolves.toMatchObject({
+      $primaryKey: 1
+    });
+    const mock = vi.fn();
+    void load2.then(mock);
+    expect(mock).not.toHaveBeenCalled();
+    secondRequest.resolve({
+      data: [employees[2]],
+      nextPageToken: undefined,
+      totalCount: "1"
+    });
+    await expect(load2).resolves.toMatchObject({
+      $primaryKey: 2
+    });
+    expect(mock).toHaveBeenCalled();
+  });
+  it("splits up work by time", async () => {
+    const loader = new BulkObjectLoader(client, /*ms*/25, /*entries*/100);
+    const firstRequest = mockClient.mockFetchPageOnce();
+    const secondRequest = mockClient.mockFetchPageOnce();
+    vi.useFakeTimers();
+    const load0 = loader.fetch("Employee", 0);
+    vi.advanceTimersByTime(26);
+    const load1 = loader.fetch("Employee", 1);
+    const load2 = loader.fetch("Employee", 2);
+    firstRequest.resolve({
+      data: [employees[0]],
+      nextPageToken: undefined,
+      totalCount: "1"
+    });
+    vi.runOnlyPendingTimers();
+    await expect(load0).resolves.toMatchObject({
+      $primaryKey: 0
+    });
+    const mockThen = vi.fn();
+    void load2.then(mockThen);
+    expect(mockThen).not.toHaveBeenCalled();
+    secondRequest.resolve({
+      data: [employees[1], employees[2]],
+      nextPageToken: undefined,
+      totalCount: "2"
+    });
+    await expect(load1).resolves.toMatchObject({
+      $primaryKey: 1
+    });
+    await expect(load2).resolves.toMatchObject({
+      $primaryKey: 2
+    });
+    expect(mockThen).toHaveBeenCalled();
+    vi.useRealTimers();
+  });
+});
+//# sourceMappingURL=BulkObjectLoader.test.js.map

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

@@ -0,0 +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":[]}

package/build/browser/observable/internal/CacheKey.js

@@ -1,2 +1,39 @@
-export {};
+/*
+ * 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.
+ */
+
+/**
+ * This isn't performant and should only be used for debug logging!
+ * @internal
+ */
+export function DEBUG_ONLY__cacheKeyToString(x) {
+  if (process.env.NODE_ENV !== "production") {
+    return `${x.type}CacheKey<${x.otherKeys.map(xx => JSON.stringify(xx)).join(", ")}>`.replaceAll("\"", "'");
+  } else {
+    throw new Error("not implemented");
+  }
+}
+/**
+ * This isn't performant and should only be used for debug logging!
+ * @internal
+ */
+export function DEBUG_ONLY__cacheKeysToString(x) {
+  if (process.env.NODE_ENV !== "production") {
+    return "\n  - " + x.map(DEBUG_ONLY__cacheKeyToString).join("\n  - ");
+  } else {
+    throw new Error("not implemented");
+  }
+}
 //# sourceMappingURL=CacheKey.js.map

package/build/browser/observable/internal/CacheKey.js.map

@@ -1 +1 @@
-{"version":3,"file":"CacheKey.js","names":[],"sources":["CacheKey.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 { Query } from \"./Query.js\";\n\nexport type CacheKey<\n  X extends string = string,\n  T_StoreValue = unknown,\n  T_Query extends Query<any, any, any> = Query<any, any, any>,\n  T_KeyFactoryArgs extends any[] = any[],\n> = {\n  type: X;\n  otherKeys: T_KeyFactoryArgs;\n  __cacheKey: {\n    value: T_StoreValue;\n    query: T_Query;\n    args: T_KeyFactoryArgs;\n  };\n};\n"],"mappings":"","ignoreList":[]}
+{"version":3,"file":"CacheKey.js","names":["DEBUG_ONLY__cacheKeyToString","x","process","env","NODE_ENV","type","otherKeys","map","xx","JSON","stringify","join","replaceAll","Error","DEBUG_ONLY__cacheKeysToString"],"sources":["CacheKey.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 { Query } from \"./Query.js\";\n\nexport type CacheKey<\n  X extends string = string,\n  T_StoreValue = unknown,\n  T_Query extends Query<any, any, any> = Query<any, any, any>,\n  T_KeyFactoryArgs extends any[] = any[],\n> = {\n  type: X;\n  otherKeys: T_KeyFactoryArgs;\n  __cacheKey: {\n    value: T_StoreValue;\n    query: T_Query;\n    args: T_KeyFactoryArgs;\n  };\n};\n\n/**\n * This isn't performant and should only be used for debug logging!\n * @internal\n */\nexport function DEBUG_ONLY__cacheKeyToString(x: CacheKey) {\n  if (process.env.NODE_ENV !== \"production\") {\n    return `${x.type}CacheKey<${\n      x.otherKeys.map(xx => JSON.stringify(xx)).join(\", \")\n    }>`.replaceAll(\"\\\"\", \"'\");\n  } else {\n    throw new Error(\"not implemented\");\n  }\n}\n/**\n * This isn't performant and should only be used for debug logging!\n * @internal\n */\nexport function DEBUG_ONLY__cacheKeysToString(x: CacheKey[]) {\n  if (process.env.NODE_ENV !== \"production\") {\n    return \"\\n  - \" + x.map(DEBUG_ONLY__cacheKeyToString).join(\"\\n  - \");\n  } else {\n    throw new Error(\"not implemented\");\n  }\n}\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAmBA;AACA;AACA;AACA;AACA,OAAO,SAASA,4BAA4BA,CAACC,CAAW,EAAE;EACxD,IAAIC,OAAO,CAACC,GAAG,CAACC,QAAQ,KAAK,YAAY,EAAE;IACzC,OAAO,GAAGH,CAAC,CAACI,IAAI,YACdJ,CAAC,CAACK,SAAS,CAACC,GAAG,CAACC,EAAE,IAAIC,IAAI,CAACC,SAAS,CAACF,EAAE,CAAC,CAAC,CAACG,IAAI,CAAC,IAAI,CAAC,GACnD,CAACC,UAAU,CAAC,IAAI,EAAE,GAAG,CAAC;EAC3B,CAAC,MAAM;IACL,MAAM,IAAIC,KAAK,CAAC,iBAAiB,CAAC;EACpC;AACF;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,6BAA6BA,CAACb,CAAa,EAAE;EAC3D,IAAIC,OAAO,CAACC,GAAG,CAACC,QAAQ,KAAK,YAAY,EAAE;IACzC,OAAO,QAAQ,GAAGH,CAAC,CAACM,GAAG,CAACP,4BAA4B,CAAC,CAACW,IAAI,CAAC,QAAQ,CAAC;EACtE,CAAC,MAAM;IACL,MAAM,IAAIE,KAAK,CAAC,iBAAiB,CAAC;EACpC;AACF","ignoreList":[]}

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

@@ -28,7 +28,7 @@ export class CacheKeys {
   });
   #cacheKeyFactories = new Map();
   #onCreate;
-  constructor(whereCanonicalizer, onCreate) {
+  constructor(whereCanonicalizer, orderByCanonicalizer, onCreate) {
     this.#onCreate = onCreate;
     this.#registerCacheKeyFactory("object", (apiName, pk) => {
       if (process.env.NODE_ENV !== "production" && DEBUG_CACHE_KEYS) {
@@ -37,12 +37,12 @@ export class CacheKeys {
       }
       return this.#cacheKeys.lookupArray(["object", apiName, pk]);
     });
-    this.#registerCacheKeyFactory("list", (apiName, where) => {
+    this.#registerCacheKeyFactory("list", (type, apiName, where, orderBy) => {
       if (process.env.NODE_ENV !== "production" && DEBUG_CACHE_KEYS) {
         // eslint-disable-next-line no-console
-        console.debug(`CacheKeys.get([list, ${apiName}, ${JSON.stringify(where)}]) -- already exists? `, this.#cacheKeys.peekArray(["list", apiName, whereCanonicalizer.canonicalize(where)]) != null);
+        console.debug(`CacheKeys.get([list, ${apiName}, ${JSON.stringify(where)}, ${JSON.stringify(orderBy)}]) -- already exists? `, this.#cacheKeys.peekArray(["list", apiName, whereCanonicalizer.canonicalize(where), orderByCanonicalizer.canonicalize(orderBy)]) != null);
       }
-      return this.#cacheKeys.lookupArray(["list", apiName, whereCanonicalizer.canonicalize(where)]);
+      return this.#cacheKeys.lookupArray(["list", type, apiName, whereCanonicalizer.canonicalize(where), orderByCanonicalizer.canonicalize(orderBy)]);
     });
   }
   #registerCacheKeyFactory(type, factory) {

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

@@ -1 +1 @@
-{"version":3,"file":"CacheKeys.js","names":["Trie","invariant","DEBUG_CACHE_KEYS","CacheKeys","cacheKeys","keys","ret","type","otherKeys","slice","onCreate","cacheKeyFactories","Map","constructor","whereCanonicalizer","registerCacheKeyFactory","apiName","pk","process","env","NODE_ENV","console","debug","peekArray","lookupArray","where","JSON","stringify","canonicalize","#registerCacheKeyFactory","factory","set","get","args","remove","cacheKey"],"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 invariant from \"tiny-invariant\";\nimport { DEBUG_CACHE_KEYS } from \"../DebugFlags.js\";\nimport type { CacheKey } from \"./CacheKey.js\";\nimport type { ListCacheKey } from \"./ListQuery.js\";\nimport type { ObjectCacheKey } from \"./ObjectQuery.js\";\nimport type { WhereClauseCanonicalizer } from \"./WhereClauseCanonicalizer.js\";\n\nexport class CacheKeys {\n  #cacheKeys = new Trie<CacheKey<string, any, any>>(false, (keys) => {\n    const ret = {\n      type: keys[0],\n      otherKeys: keys.slice(1),\n    } as unknown as CacheKey<\n      string,\n      any,\n      any\n    >;\n    this.#onCreate(ret);\n    return ret;\n  });\n  #cacheKeyFactories = new Map<string, (...args: any[]) => CacheKey>();\n  #onCreate: (cacheKey: CacheKey) => void;\n\n  constructor(\n    whereCanonicalizer: WhereClauseCanonicalizer,\n    onCreate: (cacheKey: CacheKey) => void,\n  ) {\n    this.#onCreate = onCreate;\n    this.#registerCacheKeyFactory<ObjectCacheKey>(\n      \"object\",\n      (apiName, pk) => {\n        if (process.env.NODE_ENV !== \"production\" && DEBUG_CACHE_KEYS) {\n          // eslint-disable-next-line no-console\n          console.debug(\n            `CacheKeys.get([object, ${apiName}, ${pk}]) -- already exists? `,\n            this.#cacheKeys.peekArray([\n              \"object\",\n              apiName,\n              pk,\n            ]) != null,\n          );\n        }\n        return this.#cacheKeys.lookupArray([\n          \"object\",\n          apiName,\n          pk,\n        ]) as ObjectCacheKey;\n      },\n    );\n    this.#registerCacheKeyFactory<ListCacheKey>(\n      \"list\",\n      (apiName, where) => {\n        if (process.env.NODE_ENV !== \"production\" && DEBUG_CACHE_KEYS) {\n          // eslint-disable-next-line no-console\n          console.debug(\n            `CacheKeys.get([list, ${apiName}, ${\n              JSON.stringify(where)\n            }]) -- already exists? `,\n            this.#cacheKeys.peekArray([\n              \"list\",\n              apiName,\n              whereCanonicalizer.canonicalize(where),\n            ]) != null,\n          );\n        }\n        return this.#cacheKeys.lookupArray([\n          \"list\",\n          apiName,\n          whereCanonicalizer.canonicalize(where),\n        ]) as ListCacheKey;\n      },\n    );\n  }\n\n  #registerCacheKeyFactory<K extends CacheKey>(\n    type: K[\"type\"],\n    factory: (...args: K[\"__cacheKey\"][\"args\"]) => K,\n  ): void {\n    this.#cacheKeyFactories.set(type, factory);\n  }\n\n  get<K extends CacheKey<string, any, any>>(\n    type: K[\"type\"],\n    ...args: K[\"__cacheKey\"][\"args\"]\n  ): K {\n    const factory = this.#cacheKeyFactories.get(type);\n    invariant(factory, `no cache key factory for type \"${type}\"`);\n    return factory(...args) as K;\n  }\n\n  remove<K extends CacheKey<string, any, any>>(\n    cacheKey: K,\n  ): void {\n    this.#cacheKeys.remove(cacheKey.type, ...cacheKey.otherKeys);\n  }\n}\n"],"mappings":"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","ignoreList":[]}
+{"version":3,"file":"CacheKeys.js","names":["Trie","invariant","DEBUG_CACHE_KEYS","CacheKeys","cacheKeys","keys","ret","type","otherKeys","slice","onCreate","cacheKeyFactories","Map","constructor","whereCanonicalizer","orderByCanonicalizer","registerCacheKeyFactory","apiName","pk","process","env","NODE_ENV","console","debug","peekArray","lookupArray","where","orderBy","JSON","stringify","canonicalize","#registerCacheKeyFactory","factory","set","get","args","remove","cacheKey"],"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 invariant from \"tiny-invariant\";\nimport { DEBUG_CACHE_KEYS } from \"../DebugFlags.js\";\nimport type { CacheKey } from \"./CacheKey.js\";\nimport type { ListCacheKey } from \"./ListQuery.js\";\nimport type { ObjectCacheKey } from \"./ObjectQuery.js\";\nimport type { OrderByCanonicalizer } from \"./OrderByCanonicalizer.js\";\nimport type { WhereClauseCanonicalizer } from \"./WhereClauseCanonicalizer.js\";\n\ntype CacheKeyArgs<K extends CacheKey> = [K[\"type\"], ...K[\"otherKeys\"]];\n\nexport class CacheKeys {\n  #cacheKeys = new Trie<CacheKey<string, any, any>>(false, (keys) => {\n    const ret = {\n      type: keys[0],\n      otherKeys: keys.slice(1),\n    } as unknown as CacheKey<\n      string,\n      any,\n      any\n    >;\n    this.#onCreate(ret);\n    return ret;\n  });\n  #cacheKeyFactories = new Map<string, (...args: any[]) => CacheKey>();\n  #onCreate: (cacheKey: CacheKey) => void;\n\n  constructor(\n    whereCanonicalizer: WhereClauseCanonicalizer,\n    orderByCanonicalizer: OrderByCanonicalizer,\n    onCreate: (cacheKey: CacheKey) => void,\n  ) {\n    this.#onCreate = onCreate;\n    this.#registerCacheKeyFactory<ObjectCacheKey>(\n      \"object\",\n      (apiName, pk) => {\n        if (process.env.NODE_ENV !== \"production\" && DEBUG_CACHE_KEYS) {\n          // eslint-disable-next-line no-console\n          console.debug(\n            `CacheKeys.get([object, ${apiName}, ${pk}]) -- already exists? `,\n            this.#cacheKeys.peekArray([\n              \"object\",\n              apiName,\n              pk,\n            ]) != null,\n          );\n        }\n        return this.#cacheKeys.lookupArray([\n          \"object\",\n          apiName,\n          pk,\n        ]) as ObjectCacheKey;\n      },\n    );\n    this.#registerCacheKeyFactory<ListCacheKey>(\n      \"list\",\n      (type, apiName, where, orderBy) => {\n        if (process.env.NODE_ENV !== \"production\" && DEBUG_CACHE_KEYS) {\n          // eslint-disable-next-line no-console\n          console.debug(\n            `CacheKeys.get([list, ${apiName}, ${JSON.stringify(where)}, ${\n              JSON.stringify(orderBy)\n            }]) -- already exists? `,\n            this.#cacheKeys.peekArray([\n              \"list\",\n              apiName,\n              whereCanonicalizer.canonicalize(where),\n              orderByCanonicalizer.canonicalize(orderBy),\n            ]) != null,\n          );\n        }\n        return this.#cacheKeys.lookupArray<\n          CacheKeyArgs<ListCacheKey>\n        >([\n          \"list\",\n          type,\n          apiName,\n          whereCanonicalizer.canonicalize(where),\n          orderByCanonicalizer.canonicalize(orderBy),\n        ]) as ListCacheKey;\n      },\n    );\n  }\n\n  #registerCacheKeyFactory<K extends CacheKey>(\n    type: K[\"type\"],\n    factory: (...args: K[\"__cacheKey\"][\"args\"]) => K,\n  ): void {\n    this.#cacheKeyFactories.set(type, factory);\n  }\n\n  get<K extends CacheKey<string, any, any>>(\n    type: K[\"type\"],\n    ...args: K[\"__cacheKey\"][\"args\"]\n  ): K {\n    const factory = this.#cacheKeyFactories.get(type);\n    invariant(factory, `no cache key factory for type \"${type}\"`);\n    return factory(...args) as K;\n  }\n\n  remove<K extends CacheKey<string, any, any>>(\n    cacheKey: K,\n  ): void {\n    this.#cacheKeys.remove(cacheKey.type, ...cacheKey.otherKeys);\n  }\n}\n"],"mappings":"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","ignoreList":[]}

package/build/browser/observable/internal/Changes.js

@@ -0,0 +1,58 @@
+/*
+ * 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 { MultiMap } from "mnemonist";
+import { DEBUG_ONLY__cacheKeyToString } from "./CacheKey.js";
+export class Changes {
+  modifiedObjects = new MultiMap();
+  addedObjects = new MultiMap();
+  added = new Set();
+  modified = new Set();
+  registerObject = (cacheKey, data, isNew) => {
+    this[isNew ? "addedObjects" : "modifiedObjects"].set(data.$apiName, data);
+    this[isNew ? "added" : "modified"].add(cacheKey);
+  };
+  registerList = key => {
+    this.modified.add(key);
+  };
+  isEmpty() {
+    return this.modifiedObjects.size === 0 && this.addedObjects.size === 0 && this.added.size === 0 && this.modified.size === 0;
+  }
+}
+export function createChangedObjects() {
+  return new Changes();
+}
+export function DEBUG_ONLY__changesToString(changes) {
+  if (process.env.NODE_ENV !== "production") {
+    return JSON.stringify({
+      modifiedObjects: multimapHelper(changes.modifiedObjects),
+      addedObjects: multimapHelper(changes.addedObjects),
+      added: listHelper(changes.added),
+      modified: listHelper(changes.modified)
+    }, null, 2);
+  } else {
+    throw new Error("not implemented");
+  }
+}
+function listHelper(set) {
+  return Array.from(set).map(DEBUG_ONLY__cacheKeyToString);
+}
+function multimapHelper(multimap) {
+  return Object.fromEntries(Array.from(multimap.associations()).map(([type, objects]) => {
+    return [type, objects.map(o => o.$primaryKey)];
+  }));
+}
+//# sourceMappingURL=Changes.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Changes.js","names":["MultiMap","DEBUG_ONLY__cacheKeyToString","Changes","modifiedObjects","addedObjects","added","Set","modified","registerObject","cacheKey","data","isNew","set","$apiName","add","registerList","key","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 { ListCacheKey } from \"./ListQuery.js\";\nimport type { ObjectCacheKey } from \"./ObjectQuery.js\";\n\nexport class Changes {\n  modifiedObjects: MultiMap<string, ObjectHolder> = new MultiMap();\n  addedObjects: MultiMap<string, ObjectHolder> = new MultiMap();\n\n  added: Set<ListCacheKey | ObjectCacheKey> = new Set();\n  modified: Set<ListCacheKey | ObjectCacheKey> = 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  registerList = (key: ListCacheKey): 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    );\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":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA,SAASA,QAAQ,QAAQ,WAAW;AAGpC,SAASC,4BAA4B,QAAQ,eAAe;AAI5D,OAAO,MAAMC,OAAO,CAAC;EACnBC,eAAe,GAAmC,IAAIH,QAAQ,CAAC,CAAC;EAChEI,YAAY,GAAmC,IAAIJ,QAAQ,CAAC,CAAC;EAE7DK,KAAK,GAAuC,IAAIC,GAAG,CAAC,CAAC;EACrDC,QAAQ,GAAuC,IAAID,GAAG,CAAC,CAAC;EAExDE,cAAc,GAAGA,CACfC,QAAwB,EACxBC,IAAkB,EAClBC,KAAc,KACL;IACT,IAAI,CAACA,KAAK,GAAG,cAAc,GAAG,iBAAiB,CAAC,CAACC,GAAG,CAACF,IAAI,CAACG,QAAQ,EAAEH,IAAI,CAAC;IACzE,IAAI,CAACC,KAAK,GAAG,OAAO,GAAG,UAAU,CAAC,CAACG,GAAG,CAACL,QAAQ,CAAC;EAClD,CAAC;EAEDM,YAAY,GAAIC,GAAiB,IAAW;IAC1C,IAAI,CAACT,QAAQ,CAACO,GAAG,CAACE,GAAG,CAAC;EACxB,CAAC;EAEDC,OAAOA,CAAA,EAAY;IACjB,OACE,IAAI,CAACd,eAAe,CAACe,IAAI,KAAK,CAAC,IAC5B,IAAI,CAACd,YAAY,CAACc,IAAI,KAAK,CAAC,IAC5B,IAAI,CAACb,KAAK,CAACa,IAAI,KAAK,CAAC,IACrB,IAAI,CAACX,QAAQ,CAACW,IAAI,KAAK,CAAC;EAE/B;AACF;AAEA,OAAO,SAASC,oBAAoBA,CAAA,EAAY;EAC9C,OAAO,IAAIjB,OAAO,CAAC,CAAC;AACtB;AAEA,OAAO,SAASkB,2BAA2BA,CAACC,OAAgB,EAAU;EACpE,IAAIC,OAAO,CAACC,GAAG,CAACC,QAAQ,KAAK,YAAY,EAAE;IACzC,OAAOC,IAAI,CAACC,SAAS,CACnB;MACEvB,eAAe,EAAEwB,cAAc,CAACN,OAAO,CAAClB,eAAe,CAAC;MACxDC,YAAY,EAAEuB,cAAc,CAACN,OAAO,CAACjB,YAAY,CAAC;MAClDC,KAAK,EAAEuB,UAAU,CAACP,OAAO,CAAChB,KAAK,CAAC;MAChCE,QAAQ,EAAEqB,UAAU,CAACP,OAAO,CAACd,QAAQ;IACvC,CAAC,EACD,IAAI,EACJ,CACF,CAAC;EACH,CAAC,MAAM;IACL,MAAM,IAAIsB,KAAK,CAAC,iBAAiB,CAAC;EACpC;AACF;AAEA,SAASD,UAAUA,CAAChB,GAAkB,EAAE;EACtC,OAAOkB,KAAK,CAACC,IAAI,CAACnB,GAAG,CAAC,CAACoB,GAAG,CAAC/B,4BAA4B,CAAC;AAC1D;AAEA,SAAS0B,cAAcA,CACrBM,QAAwC,EACxC;EACA,OAAOC,MAAM,CAACC,WAAW,CACvBL,KAAK,CAACC,IAAI,CAACE,QAAQ,CAACG,YAAY,CAAC,CAAC,CAAC,CAACJ,GAAG,CACrC,CAAC,CAACK,IAAI,EAAEC,OAAO,CAAC,KAAK;IACnB,OAAO,CAACD,IAAI,EAAEC,OAAO,CAACN,GAAG,CAACO,CAAC,IAAIA,CAAC,CAACC,WAAW,CAAC,CAAC;EAChD,CACF,CACF,CAAC;AACH","ignoreList":[]}

package/build/browser/observable/internal/Layer.js

@@ -53,11 +53,14 @@ export class Layer {
       this.#parent = this.#parent.removeLayer(layerId);
       return this;
     }
-    return this.#parent ?? this;
+    return this.#parent.removeLayer(layerId);
   }
   entries() {
     return this.#cache.entries();
   }
+  keys() {
+    return this.#cache.keys();
+  }
   get(cacheKey) {
     return this.#cache.get(cacheKey) ?? this.#parent?.get(cacheKey);
   }
@@ -66,11 +69,11 @@ export class Layer {
   }
 }
 export class Entry {
-  constructor(cacheKey, value, lastUpdated) {
+  constructor(cacheKey, value, lastUpdated, status = "init") {
     this.cacheKey = cacheKey;
     this.value = value;
     this.lastUpdated = lastUpdated;
-    this.status = "init";
+    this.status = status;
   }
 }
 //# sourceMappingURL=Layer.js.map

package/build/browser/observable/internal/Layer.js.map

@@ -1 +1 @@
-{"version":3,"file":"Layer.js","names":["WeakMapWithEntries","Layer","parent","cache","layerId","constructor","parentLayer","addLayer","removeLayer","entries","get","cacheKey","set","value","Entry","lastUpdated","status"],"sources":["Layer.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 { CacheKey } from \"./CacheKey.js\";\nimport { WeakMapWithEntries } from \"./WeakMapWithEntries.js\";\n\n/*\n  Image some layers\n\n  [\n    { cache: { obj1: { a: 1 } }, layerId: undefined },\n    { cache: { obj1: { a: 1, b: 2 } }, layerId: \"layer1\" },\n    { cache: { obj1: { a: undefined, b: 2 } }, layerId: \"layer2\" },\n    { cache: { obj1: { a: 1, b: 2 } }, layerId: \"layer3\" },\n  ]\n*/\n\nexport class Layer {\n  #parent: Layer | undefined;\n  #cache = new WeakMapWithEntries<CacheKey<string, any, any>, Entry<any>>();\n  #layerId: unknown;\n\n  constructor(parent: Layer | undefined, layerId: unknown) {\n    this.#parent = parent;\n    this.#layerId = layerId;\n  }\n\n  get parentLayer(): Layer | undefined {\n    return this.#parent;\n  }\n\n  get layerId(): unknown {\n    return this.#layerId;\n  }\n\n  addLayer(layerId: unknown): Layer {\n    return new Layer(this, layerId);\n  }\n\n  removeLayer(layerId: unknown): Layer {\n    if (layerId == null || this.#parent == null) {\n      // we are the root, so we can't remove anything\n      return this;\n    }\n    if (this.#layerId !== layerId) {\n      this.#parent = this.#parent.removeLayer(layerId);\n      return this;\n    }\n\n    return this.#parent ?? this;\n  }\n\n  entries(): IterableIterator<[CacheKey<string, any, any>, Entry<any>]> {\n    return this.#cache.entries();\n  }\n\n  public get<K extends CacheKey<string, unknown, any>>(\n    cacheKey: K,\n  ): Entry<K> | undefined {\n    return this.#cache.get(cacheKey) as Entry<K> | undefined\n      ?? this.#parent?.get(cacheKey) as Entry<K> | undefined;\n  }\n\n  public set<K extends CacheKey<string, unknown, any>>(\n    cacheKey: K,\n    value: Entry<K>,\n  ): void {\n    this.#cache.set(cacheKey, value);\n  }\n}\n\nexport class Entry<K extends CacheKey<any, any, any>> {\n  readonly cacheKey: K;\n  value: K[\"__cacheKey\"][\"value\"] | undefined;\n  lastUpdated: number;\n  status: \"init\" | \"loading\" | \"loaded\" | \"error\";\n\n  constructor(\n    cacheKey: K,\n    value: K[\"__cacheKey\"][\"value\"],\n    lastUpdated: number,\n  ) {\n    this.cacheKey = cacheKey;\n    this.value = value;\n    this.lastUpdated = lastUpdated;\n    this.status = \"init\";\n  }\n}\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAGA,SAASA,kBAAkB,QAAQ,yBAAyB;;AAE5D;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA,OAAO,MAAMC,KAAK,CAAC;EACjB,CAACC,MAAM;EACP,CAACC,KAAK,GAAG,IAAIH,kBAAkB,CAAyC,CAAC;EACzE,CAACI,OAAO;EAERC,WAAWA,CAACH,MAAyB,EAAEE,OAAgB,EAAE;IACvD,IAAI,CAAC,CAACF,MAAM,GAAGA,MAAM;IACrB,IAAI,CAAC,CAACE,OAAO,GAAGA,OAAO;EACzB;EAEA,IAAIE,WAAWA,CAAA,EAAsB;IACnC,OAAO,IAAI,CAAC,CAACJ,MAAM;EACrB;EAEA,IAAIE,OAAOA,CAAA,EAAY;IACrB,OAAO,IAAI,CAAC,CAACA,OAAO;EACtB;EAEAG,QAAQA,CAACH,OAAgB,EAAS;IAChC,OAAO,IAAIH,KAAK,CAAC,IAAI,EAAEG,OAAO,CAAC;EACjC;EAEAI,WAAWA,CAACJ,OAAgB,EAAS;IACnC,IAAIA,OAAO,IAAI,IAAI,IAAI,IAAI,CAAC,CAACF,MAAM,IAAI,IAAI,EAAE;MAC3C;MACA,OAAO,IAAI;IACb;IACA,IAAI,IAAI,CAAC,CAACE,OAAO,KAAKA,OAAO,EAAE;MAC7B,IAAI,CAAC,CAACF,MAAM,GAAG,IAAI,CAAC,CAACA,MAAM,CAACM,WAAW,CAACJ,OAAO,CAAC;MAChD,OAAO,IAAI;IACb;IAEA,OAAO,IAAI,CAAC,CAACF,MAAM,IAAI,IAAI;EAC7B;EAEAO,OAAOA,CAAA,EAA+D;IACpE,OAAO,IAAI,CAAC,CAACN,KAAK,CAACM,OAAO,CAAC,CAAC;EAC9B;EAEOC,GAAGA,CACRC,QAAW,EACW;IACtB,OAAO,IAAI,CAAC,CAACR,KAAK,CAACO,GAAG,CAACC,QAAQ,CAAC,IAC3B,IAAI,CAAC,CAACT,MAAM,EAAEQ,GAAG,CAACC,QAAQ,CAAyB;EAC1D;EAEOC,GAAGA,CACRD,QAAW,EACXE,KAAe,EACT;IACN,IAAI,CAAC,CAACV,KAAK,CAACS,GAAG,CAACD,QAAQ,EAAEE,KAAK,CAAC;EAClC;AACF;AAEA,OAAO,MAAMC,KAAK,CAAoC;EAMpDT,WAAWA,CACTM,QAAW,EACXE,KAA+B,EAC/BE,WAAmB,EACnB;IACA,IAAI,CAACJ,QAAQ,GAAGA,QAAQ;IACxB,IAAI,CAACE,KAAK,GAAGA,KAAK;IAClB,IAAI,CAACE,WAAW,GAAGA,WAAW;IAC9B,IAAI,CAACC,MAAM,GAAG,MAAM;EACtB;AACF","ignoreList":[]}
+{"version":3,"file":"Layer.js","names":["WeakMapWithEntries","Layer","parent","cache","layerId","constructor","parentLayer","addLayer","removeLayer","entries","keys","get","cacheKey","set","value","Entry","lastUpdated","status"],"sources":["Layer.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 { CacheKey } from \"./CacheKey.js\";\nimport { WeakMapWithEntries } from \"./WeakMapWithEntries.js\";\n\n/*\n  Image some layers\n\n  [\n    { cache: { obj1: { a: 1 } }, layerId: undefined },\n    { cache: { obj1: { a: 1, b: 2 } }, layerId: \"layer1\" },\n    { cache: { obj1: { a: undefined, b: 2 } }, layerId: \"layer2\" },\n    { cache: { obj1: { a: 1, b: 2 } }, layerId: \"layer3\" },\n  ]\n*/\n\nexport class Layer {\n  #parent: Layer | undefined;\n  #cache = new WeakMapWithEntries<CacheKey<string, any, any>, Entry<any>>();\n  #layerId: unknown;\n\n  constructor(parent: Layer | undefined, layerId: unknown) {\n    this.#parent = parent;\n    this.#layerId = layerId;\n  }\n\n  get parentLayer(): Layer | undefined {\n    return this.#parent;\n  }\n\n  get layerId(): unknown {\n    return this.#layerId;\n  }\n\n  addLayer(layerId: unknown): Layer {\n    return new Layer(this, layerId);\n  }\n\n  removeLayer(layerId: unknown): Layer {\n    if (layerId == null || this.#parent == null) {\n      // we are the root, so we can't remove anything\n      return this;\n    }\n\n    if (this.#layerId !== layerId) {\n      this.#parent = this.#parent.removeLayer(layerId);\n      return this;\n    }\n\n    return this.#parent.removeLayer(layerId);\n  }\n\n  entries(): IterableIterator<[CacheKey<string, any, any>, Entry<any>]> {\n    return this.#cache.entries();\n  }\n\n  keys(): IterableIterator<CacheKey<string, any, any>> {\n    return this.#cache.keys();\n  }\n\n  public get<K extends CacheKey<string, unknown, any>>(\n    cacheKey: K,\n  ): Entry<K> | undefined {\n    return this.#cache.get(cacheKey) as Entry<K> | undefined\n      ?? this.#parent?.get(cacheKey) as Entry<K> | undefined;\n  }\n\n  public set<K extends CacheKey<string, unknown, any>>(\n    cacheKey: K,\n    value: Entry<K>,\n  ): void {\n    this.#cache.set(cacheKey, value);\n  }\n}\n\nexport class Entry<K extends CacheKey<any, any, any>> {\n  readonly cacheKey: K;\n  value: K[\"__cacheKey\"][\"value\"] | undefined;\n  lastUpdated: number;\n  status: \"init\" | \"loading\" | \"loaded\" | \"error\";\n\n  constructor(\n    cacheKey: K,\n    value: K[\"__cacheKey\"][\"value\"],\n    lastUpdated: number,\n    status: \"init\" | \"loading\" | \"loaded\" | \"error\" = \"init\",\n  ) {\n    this.cacheKey = cacheKey;\n    this.value = value;\n    this.lastUpdated = lastUpdated;\n    this.status = status;\n  }\n}\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAGA,SAASA,kBAAkB,QAAQ,yBAAyB;;AAE5D;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA,OAAO,MAAMC,KAAK,CAAC;EACjB,CAACC,MAAM;EACP,CAACC,KAAK,GAAG,IAAIH,kBAAkB,CAAyC,CAAC;EACzE,CAACI,OAAO;EAERC,WAAWA,CAACH,MAAyB,EAAEE,OAAgB,EAAE;IACvD,IAAI,CAAC,CAACF,MAAM,GAAGA,MAAM;IACrB,IAAI,CAAC,CAACE,OAAO,GAAGA,OAAO;EACzB;EAEA,IAAIE,WAAWA,CAAA,EAAsB;IACnC,OAAO,IAAI,CAAC,CAACJ,MAAM;EACrB;EAEA,IAAIE,OAAOA,CAAA,EAAY;IACrB,OAAO,IAAI,CAAC,CAACA,OAAO;EACtB;EAEAG,QAAQA,CAACH,OAAgB,EAAS;IAChC,OAAO,IAAIH,KAAK,CAAC,IAAI,EAAEG,OAAO,CAAC;EACjC;EAEAI,WAAWA,CAACJ,OAAgB,EAAS;IACnC,IAAIA,OAAO,IAAI,IAAI,IAAI,IAAI,CAAC,CAACF,MAAM,IAAI,IAAI,EAAE;MAC3C;MACA,OAAO,IAAI;IACb;IAEA,IAAI,IAAI,CAAC,CAACE,OAAO,KAAKA,OAAO,EAAE;MAC7B,IAAI,CAAC,CAACF,MAAM,GAAG,IAAI,CAAC,CAACA,MAAM,CAACM,WAAW,CAACJ,OAAO,CAAC;MAChD,OAAO,IAAI;IACb;IAEA,OAAO,IAAI,CAAC,CAACF,MAAM,CAACM,WAAW,CAACJ,OAAO,CAAC;EAC1C;EAEAK,OAAOA,CAAA,EAA+D;IACpE,OAAO,IAAI,CAAC,CAACN,KAAK,CAACM,OAAO,CAAC,CAAC;EAC9B;EAEAC,IAAIA,CAAA,EAAiD;IACnD,OAAO,IAAI,CAAC,CAACP,KAAK,CAACO,IAAI,CAAC,CAAC;EAC3B;EAEOC,GAAGA,CACRC,QAAW,EACW;IACtB,OAAO,IAAI,CAAC,CAACT,KAAK,CAACQ,GAAG,CAACC,QAAQ,CAAC,IAC3B,IAAI,CAAC,CAACV,MAAM,EAAES,GAAG,CAACC,QAAQ,CAAyB;EAC1D;EAEOC,GAAGA,CACRD,QAAW,EACXE,KAAe,EACT;IACN,IAAI,CAAC,CAACX,KAAK,CAACU,GAAG,CAACD,QAAQ,EAAEE,KAAK,CAAC;EAClC;AACF;AAEA,OAAO,MAAMC,KAAK,CAAoC;EAMpDV,WAAWA,CACTO,QAAW,EACXE,KAA+B,EAC/BE,WAAmB,EACnBC,MAA+C,GAAG,MAAM,EACxD;IACA,IAAI,CAACL,QAAQ,GAAGA,QAAQ;IACxB,IAAI,CAACE,KAAK,GAAGA,KAAK;IAClB,IAAI,CAACE,WAAW,GAAGA,WAAW;IAC9B,IAAI,CAACC,MAAM,GAAGA,MAAM;EACtB;AACF","ignoreList":[]}