@osdk/client 2.2.0-beta.8 → 2.3.0-beta.1

package/build/esm/observable/ObservableClient.js.map

@@ -1 +1 @@
-{"version":3,"file":"ObservableClient.js","names":["ObservableClientImpl","Store","ObservableClient","createObservableClient","client"],"sources":["ObservableClient.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  ObjectTypeDefinition,\n  PrimaryKeyType,\n  PropertyKeys,\n  WhereClause,\n} from \"@osdk/api\";\nimport type { ActionSignatureFromDef } from \"../actions/applyAction.js\";\nimport type { Client } from \"../Client.js\";\nimport type { Canonical } from \"./internal/Canonical.js\";\nimport { ObservableClientImpl } from \"./internal/ObservableClientImpl.js\";\nimport { Store } from \"./internal/Store.js\";\nimport type { ListPayload } from \"./ListPayload.js\";\nimport type { ObjectPayload } from \"./ObjectPayload.js\";\nimport type { OptimisticBuilder } from \"./OptimisticBuilder.js\";\nimport type { SubFn } from \"./types.js\";\n\nexport type Status = \"init\" | \"loading\" | \"loaded\" | \"error\";\n\nexport namespace ObservableClient {\n  export interface ApplyActionOptions {\n    optimisticUpdate?: (ctx: OptimisticBuilder) => void;\n  }\n}\n\nexport interface CommonObserveOptions {\n  dedupeInterval?: number;\n}\n\nexport interface ObserveOptions {\n  mode?: \"offline\" | \"force\";\n}\n\nexport interface ObserveObjectOptions<T extends ObjectTypeDefinition>\n  extends ObserveOptions\n{\n  select?: PropertyKeys<T>[];\n}\n\nexport type OrderBy<Q extends ObjectTypeDefinition> = {\n  [K in PropertyKeys<Q>]?: \"asc\" | \"desc\" | undefined;\n};\n\nexport interface ObserveListOptions<Q extends ObjectTypeDefinition>\n  extends CommonObserveOptions, ObserveOptions\n{\n  objectType: Q[\"apiName\"] | Q;\n  where?: WhereClause<Q>;\n  pageSize?: number;\n  orderBy?: OrderBy<Q>;\n  invalidationMode?: \"in-place\" | \"wait\" | \"reset\";\n  expectedLength?: number;\n  streamUpdates?: boolean;\n}\n\nexport interface ObservableClient {\n  observeObject<T extends ObjectTypeDefinition>(\n    apiName: T[\"apiName\"] | T,\n    pk: PrimaryKeyType<T>,\n    options: ObserveOptions,\n    subFn: SubFn<ObjectPayload>,\n  ): Unsubscribable;\n\n  observeList<T extends ObjectTypeDefinition>(\n    options: ObserveListOptions<T>,\n    subFn: SubFn<ListPayload>,\n  ): Unsubscribable;\n\n  applyAction: <Q extends ActionDefinition<any>>(\n    action: Q,\n    args: Parameters<ActionSignatureFromDef<Q>[\"applyAction\"]>[0],\n    opts?: ObservableClient.ApplyActionOptions,\n  ) => Promise<unknown>;\n\n  canonicalizeWhereClause: <T extends ObjectTypeDefinition>(\n    where: WhereClause<T>,\n  ) => Canonical<WhereClause<T>>;\n}\n\nexport function createObservableClient(client: Client): ObservableClient {\n  return new ObservableClientImpl(new Store(client));\n}\n\nexport interface Unsubscribable {\n  unsubscribe: () => void;\n}\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAYA,SAASA,oBAAoB,QAAQ,oCAAoC;AACzE,SAASC,KAAK,QAAQ,qBAAqB;AAAC,WAQ3BC,gBAAgB;AA4DjC,OAAO,SAASC,sBAAsBA,CAACC,MAAc,EAAoB;EACvE,OAAO,IAAIJ,oBAAoB,CAAC,IAAIC,KAAK,CAACG,MAAM,CAAC,CAAC;AACpD","ignoreList":[]}
+{"version":3,"file":"ObservableClient.js","names":["ObservableClientImpl","Store","ObservableClient","createObservableClient","client"],"sources":["ObservableClient.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  InterfaceDefinition,\n  ObjectTypeDefinition,\n  Osdk,\n  PrimaryKeyType,\n  PropertyKeys,\n  WhereClause,\n} from \"@osdk/api\";\nimport type { ActionSignatureFromDef } from \"../actions/applyAction.js\";\nimport type { Client } from \"../Client.js\";\nimport type { Canonical } from \"./internal/Canonical.js\";\nimport { ObservableClientImpl } from \"./internal/ObservableClientImpl.js\";\nimport { Store } from \"./internal/Store.js\";\nimport type { OptimisticBuilder } from \"./OptimisticBuilder.js\";\n\nexport type Status = \"init\" | \"loading\" | \"loaded\" | \"error\";\n\nexport interface Observer<T> {\n  next: (value: T) => void;\n  error: (err: any) => void;\n  complete: () => void;\n}\n\nexport namespace ObservableClient {\n  export interface ApplyActionOptions {\n    optimisticUpdate?: (ctx: OptimisticBuilder) => void;\n  }\n}\n\nexport interface CommonObserveOptions {\n  dedupeInterval?: number;\n}\n\nexport interface ObserveOptions {\n  mode?: \"offline\" | \"force\";\n}\n\nexport interface ObserveObjectOptions<\n  T extends ObjectTypeDefinition | InterfaceDefinition,\n> extends ObserveOptions {\n  select?: PropertyKeys<T>[];\n}\n\nexport type OrderBy<Q extends ObjectTypeDefinition | InterfaceDefinition> = {\n  [K in PropertyKeys<Q>]?: \"asc\" | \"desc\" | undefined;\n};\n\nexport interface ObserveListOptions<\n  Q extends ObjectTypeDefinition | InterfaceDefinition,\n> extends CommonObserveOptions, ObserveOptions {\n  type: Pick<Q, \"apiName\" | \"type\">;\n  where?: WhereClause<Q>;\n  pageSize?: number;\n  orderBy?: OrderBy<Q>;\n  invalidationMode?: \"in-place\" | \"wait\" | \"reset\";\n  expectedLength?: number;\n  streamUpdates?: boolean;\n}\n\nexport interface ObserveObjectArgs<T extends ObjectTypeDefinition> {\n  object: Osdk.Instance<T> | undefined;\n  isOptimistic: boolean;\n  status: Status;\n  lastUpdated: number;\n}\n\nexport interface ObserveObjectsArgs<\n  T extends ObjectTypeDefinition | InterfaceDefinition,\n> {\n  resolvedList: Array<Osdk.Instance<T>>;\n  isOptimistic: boolean;\n  lastUpdated: number;\n  fetchMore: () => Promise<unknown>;\n  hasMore: boolean;\n  status: Status;\n}\n\nexport interface ObservableClient {\n  observeObject<T extends ObjectTypeDefinition>(\n    apiName: T[\"apiName\"] | T,\n    pk: PrimaryKeyType<T>,\n    options: ObserveOptions,\n    subFn: Observer<ObserveObjectArgs<T>>,\n  ): Unsubscribable;\n\n  observeList<T extends ObjectTypeDefinition | InterfaceDefinition>(\n    options: ObserveListOptions<T>,\n    subFn: Observer<ObserveObjectsArgs<T>>,\n  ): Unsubscribable;\n\n  applyAction: <Q extends ActionDefinition<any>>(\n    action: Q,\n    args: Parameters<ActionSignatureFromDef<Q>[\"applyAction\"]>[0],\n    opts?: ObservableClient.ApplyActionOptions,\n  ) => Promise<unknown>;\n\n  canonicalizeWhereClause: <\n    T extends ObjectTypeDefinition | InterfaceDefinition,\n  >(\n    where: WhereClause<T>,\n  ) => Canonical<WhereClause<T>>;\n}\n\nexport function createObservableClient(client: Client): ObservableClient {\n  return new ObservableClientImpl(new Store(client));\n}\n\nexport interface Unsubscribable {\n  unsubscribe: () => void;\n}\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAcA,SAASA,oBAAoB,QAAQ,oCAAoC;AACzE,SAASC,KAAK,QAAQ,qBAAqB;AAAC,WAW3BC,gBAAgB;AAgFjC,OAAO,SAASC,sBAAsBA,CAACC,MAAc,EAAoB;EACvE,OAAO,IAAIJ,oBAAoB,CAAC,IAAIC,KAAK,CAACG,MAAM,CAAC,CAAC;AACpD","ignoreList":[]}

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

@@ -14,19 +14,22 @@
  * limitations under the License.
  */
 
-import { delay } from "msw";
-import { createChangedObjects } from "./ChangedObjects.js";
+import delay from "delay";
+import { createChangedObjects } from "./Changes.js";
 import { runOptimisticJob } from "./OptimisticJob.js";
 const ACTION_DELAY = process.env.NODE_ENV === "production" ? 0 : 1000;
 export class ActionApplication {
   constructor(store) {
     this.store = store;
   }
-  applyAction = (action, args, {
+  applyAction = async (action, args, {
     optimisticUpdate
   } = {}) => {
+    const logger = process.env.NODE_ENV !== "production" ? this.store.logger?.child({
+      methodName: "applyAction"
+    }) : this.store.logger;
     const removeOptimisticResult = runOptimisticJob(this.store, optimisticUpdate);
-    return (async () => {
+    return await (async () => {
       try {
         // The types for client get confused when we dynamically applyAction so we
         // have to deal with the `any` here and force cast it to what it should be.
@@ -35,18 +38,18 @@ export class ActionApplication {
         const actionResults = await this.store.client(action).applyAction(args, {
           $returnEdits: true
         });
-        if (ACTION_DELAY > 0) {
-          // eslint-disable-next-line no-console
-          console.log("action done, pausing");
-          await delay(ACTION_DELAY);
-          // eslint-disable-next-line no-console
-          console.log("action done, pausing done");
+        if (process.env.NODE_ENV !== "production") {
+          if (ACTION_DELAY > 0) {
+            logger?.debug("action done, pausing", actionResults);
+            await delay(ACTION_DELAY);
+            logger?.debug("action done, pausing done");
+          }
         }
         await this.#invalidateActionEditResponse(actionResults);
         return actionResults;
       } finally {
         if (process.env.NODE_ENV !== "production") {
-          this.store.logger?.debug("optimistic action complete; remove the results");
+          logger?.debug("optimistic action complete; remove the results");
         }
         // make sure this happens even if the action fails
         await removeOptimisticResult();
@@ -69,12 +72,24 @@ export class ActionApplication {
       await Promise.all(promisesToWait);
 
       // the action invocation just gives back object ids,
-      // so we don't want to build the changes object
-      // until we have up to date values.
-      changes = this.#changesFromActionEditResponse(value);
-
-      // updates `changes` in place
-      await this.store.maybeRevalidateLists(changes);
+      // but the invalidateObject calls above should have put the
+      // actual objects in the cache
+      const changes = createChangedObjects();
+      for (const changeType of ["addedObjects", "modifiedObjects"]) {
+        for (const {
+          objectType,
+          primaryKey
+        } of value[changeType] ?? []) {
+          const cacheKey = this.store.getCacheKey("object", objectType, primaryKey);
+          // N.B. this probably isn't right. `getValue`() will give you the "top"
+          // value but I think we want the "truth" guaranteed.
+          const obj = this.store.getValue(cacheKey);
+          if (obj && obj.value) {
+            changes[changeType].set(objectType, obj.value);
+            (changeType === "addedObjects" ? changes.added : changes.modified).add(cacheKey);
+          }
+        }
+      }
     } else {
       for (const apiName of value.editedObjectTypes) {
         typesToInvalidate.add(apiName.toString());
@@ -83,20 +98,5 @@ export class ActionApplication {
     }
     return value;
   };
-  #changesFromActionEditResponse = value => {
-    const changes = createChangedObjects();
-    for (const changeType of ["addedObjects", "modifiedObjects"]) {
-      for (const {
-        objectType,
-        primaryKey
-      } of value[changeType] ?? []) {
-        const obj = this.store.getObject(objectType, primaryKey);
-        if (obj) {
-          changes[changeType].set(objectType, obj);
-        }
-      }
-    }
-    return changes;
-  };
 }
 //# sourceMappingURL=ActionApplication.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"ActionApplication.js","names":["delay","createChangedObjects","runOptimisticJob","ACTION_DELAY","process","env","NODE_ENV","ActionApplication","constructor","store","applyAction","action","args","optimisticUpdate","removeOptimisticResult","actionResults","client","$returnEdits","console","log","invalidateActionEditResponse","logger","debug","value","typesToInvalidate","Set","changes","type","promisesToWait","obj","modifiedObjects","push","invalidateObject","objectType","primaryKey","addedObjects","add","Promise","all","changesFromActionEditResponse","maybeRevalidateLists","apiName","editedObjectTypes","toString","invalidateObjectType","changeType","getObject","set"],"sources":["ActionApplication.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 { ActionDefinition, ActionEditResponse } from \"@osdk/api\";\nimport { delay } from \"msw\";\nimport type { ActionSignatureFromDef } from \"../../actions/applyAction.js\";\n\nimport { type Changes, createChangedObjects } from \"./ChangedObjects.js\";\nimport { runOptimisticJob } from \"./OptimisticJob.js\";\nimport type { Store } from \"./Store.js\";\n\nconst ACTION_DELAY = process.env.NODE_ENV === \"production\" ? 0 : 1000;\n\nexport class ActionApplication {\n  constructor(private store: Store) {}\n\n  applyAction: <Q extends ActionDefinition<any>>(\n    action: Q,\n    args: Parameters<ActionSignatureFromDef<Q>[\"applyAction\"]>[0],\n    opts?: Store.ApplyActionOptions,\n  ) => Promise<unknown> = (action, args, { optimisticUpdate } = {}) => {\n    const removeOptimisticResult = runOptimisticJob(\n      this.store,\n      optimisticUpdate,\n    );\n    return (async () => {\n      try {\n        // The types for client get confused when we dynamically applyAction so we\n        // have to deal with the `any` here and force cast it to what it should be.\n        // TODO: Update the types so this doesn't happen!\n\n        const actionResults: ActionEditResponse = await this.store.client(\n          action,\n        ).applyAction(args as any, { $returnEdits: true });\n\n        if (ACTION_DELAY > 0) {\n          // eslint-disable-next-line no-console\n          console.log(\"action done, pausing\");\n          await delay(ACTION_DELAY);\n          // eslint-disable-next-line no-console\n          console.log(\"action done, pausing done\");\n        }\n        await this.#invalidateActionEditResponse(actionResults);\n        return actionResults;\n      } finally {\n        if (process.env.NODE_ENV !== \"production\") {\n          this.store.logger?.debug(\n            \"optimistic action complete; remove the results\",\n          );\n        }\n        // make sure this happens even if the action fails\n        await removeOptimisticResult();\n      }\n    })();\n  };\n\n  #invalidateActionEditResponse = async (\n    value: ActionEditResponse,\n  ): Promise<ActionEditResponse> => {\n    const typesToInvalidate = new Set<string>();\n\n    let changes: Changes | undefined;\n    if (value.type === \"edits\") {\n      const promisesToWait: Promise<any>[] = [];\n      // TODO we need an backend update for deletes\n      for (const obj of value.modifiedObjects) {\n        promisesToWait.push(\n          this.store.invalidateObject(obj.objectType, obj.primaryKey),\n        );\n      }\n\n      for (const obj of value.addedObjects) {\n        promisesToWait.push(\n          this.store.invalidateObject(obj.objectType, obj.primaryKey),\n        );\n\n        typesToInvalidate.add(obj.objectType);\n      }\n\n      await Promise.all(promisesToWait);\n\n      // the action invocation just gives back object ids,\n      // so we don't want to build the changes object\n      // until we have up to date values.\n      changes = this.#changesFromActionEditResponse(value);\n\n      // updates `changes` in place\n      await this.store.maybeRevalidateLists(changes);\n    } else {\n      for (const apiName of value.editedObjectTypes) {\n        typesToInvalidate.add(apiName.toString());\n        await this.store.invalidateObjectType(apiName as string, changes);\n      }\n    }\n\n    return value;\n  };\n\n  #changesFromActionEditResponse = (value: ActionEditResponse) => {\n    const changes = createChangedObjects();\n    for (const changeType of [\"addedObjects\", \"modifiedObjects\"] as const) {\n      for (const { objectType, primaryKey } of (value[changeType] ?? [])) {\n        const obj = this.store.getObject(objectType, primaryKey);\n        if (obj) {\n          changes[changeType].set(objectType, obj);\n        }\n      }\n    }\n    return changes;\n  };\n}\n"],"mappings":"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","ignoreList":[]}
+{"version":3,"file":"ActionApplication.js","names":["delay","createChangedObjects","runOptimisticJob","ACTION_DELAY","process","env","NODE_ENV","ActionApplication","constructor","store","applyAction","action","args","optimisticUpdate","logger","child","methodName","removeOptimisticResult","actionResults","client","$returnEdits","debug","invalidateActionEditResponse","value","typesToInvalidate","Set","changes","type","promisesToWait","obj","modifiedObjects","push","invalidateObject","objectType","primaryKey","addedObjects","add","Promise","all","changeType","cacheKey","getCacheKey","getValue","set","added","modified","apiName","editedObjectTypes","toString","invalidateObjectType"],"sources":["ActionApplication.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 { ActionDefinition, ActionEditResponse } from \"@osdk/api\";\nimport delay from \"delay\";\nimport type { ActionSignatureFromDef } from \"../../actions/applyAction.js\";\nimport { type Changes, createChangedObjects } from \"./Changes.js\";\nimport type { ObjectCacheKey } from \"./ObjectQuery.js\";\nimport { runOptimisticJob } from \"./OptimisticJob.js\";\nimport type { Store } from \"./Store.js\";\n\nconst ACTION_DELAY = process.env.NODE_ENV === \"production\" ? 0 : 1000;\n\nexport class ActionApplication {\n  constructor(private store: Store) {}\n\n  applyAction: <Q extends ActionDefinition<any>>(\n    action: Q,\n    args: Parameters<ActionSignatureFromDef<Q>[\"applyAction\"]>[0],\n    opts?: Store.ApplyActionOptions,\n  ) => Promise<ActionEditResponse> = async (\n    action,\n    args,\n    { optimisticUpdate } = {},\n  ) => {\n    const logger = process.env.NODE_ENV !== \"production\"\n      ? this.store.logger?.child({ methodName: \"applyAction\" })\n      : this.store.logger;\n    const removeOptimisticResult = runOptimisticJob(\n      this.store,\n      optimisticUpdate,\n    );\n\n    return await (async () => {\n      try {\n        // The types for client get confused when we dynamically applyAction so we\n        // have to deal with the `any` here and force cast it to what it should be.\n        // TODO: Update the types so this doesn't happen!\n\n        const actionResults: ActionEditResponse = await this.store.client(\n          action,\n        ).applyAction(args as any, { $returnEdits: true });\n\n        if (process.env.NODE_ENV !== \"production\") {\n          if (ACTION_DELAY > 0) {\n            logger?.debug(\"action done, pausing\", actionResults);\n            await delay(ACTION_DELAY);\n            logger?.debug(\"action done, pausing done\");\n          }\n        }\n        await this.#invalidateActionEditResponse(actionResults);\n        return actionResults;\n      } finally {\n        if (process.env.NODE_ENV !== \"production\") {\n          logger?.debug(\n            \"optimistic action complete; remove the results\",\n          );\n        }\n        // make sure this happens even if the action fails\n        await removeOptimisticResult();\n      }\n    })();\n  };\n\n  #invalidateActionEditResponse = async (\n    value: ActionEditResponse,\n  ): Promise<ActionEditResponse> => {\n    const typesToInvalidate = new Set<string>();\n\n    let changes: Changes | undefined;\n    if (value.type === \"edits\") {\n      const promisesToWait: Promise<any>[] = [];\n      // TODO we need an backend update for deletes\n      for (const obj of value.modifiedObjects) {\n        promisesToWait.push(\n          this.store.invalidateObject(obj.objectType, obj.primaryKey),\n        );\n      }\n\n      for (const obj of value.addedObjects) {\n        promisesToWait.push(\n          this.store.invalidateObject(obj.objectType, obj.primaryKey),\n        );\n\n        typesToInvalidate.add(obj.objectType);\n      }\n\n      await Promise.all(promisesToWait);\n\n      // the action invocation just gives back object ids,\n      // but the invalidateObject calls above should have put the\n      // actual objects in the cache\n      const changes = createChangedObjects();\n      for (const changeType of [\"addedObjects\", \"modifiedObjects\"] as const) {\n        for (const { objectType, primaryKey } of (value[changeType] ?? [])) {\n          const cacheKey = this.store.getCacheKey<ObjectCacheKey>(\n            \"object\",\n            objectType,\n            primaryKey,\n          );\n          // N.B. this probably isn't right. `getValue`() will give you the \"top\"\n          // value but I think we want the \"truth\" guaranteed.\n          const obj = this.store.getValue(cacheKey);\n          if (obj && obj.value) {\n            changes[changeType].set(objectType, obj.value);\n            (changeType === \"addedObjects\" ? changes.added : changes.modified)\n              .add(cacheKey);\n          }\n        }\n      }\n    } else {\n      for (const apiName of value.editedObjectTypes) {\n        typesToInvalidate.add(apiName.toString());\n        await this.store.invalidateObjectType(apiName as string, changes);\n      }\n    }\n\n    return value;\n  };\n}\n"],"mappings":"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","ignoreList":[]}

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

@@ -0,0 +1,93 @@
+/*
+ * 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 { PalantirApiError } from "@osdk/shared.net.errors";
+import { DefaultMap, DefaultWeakMap } from "mnemonist";
+import pDefer from "p-defer";
+import { additionalContext } from "../../Client.js";
+const weakCache = new DefaultWeakMap(c => new BulkObjectLoader(c));
+export function getBulkObjectLoader(client) {
+  return weakCache.get(client);
+}
+export class BulkObjectLoader {
+  #client;
+  #m = new DefaultMap(() => ({
+    data: [],
+    timer: undefined
+  }));
+  #logger;
+  #maxWait;
+  #maxEntries;
+  constructor(client, maxWait = 25, maxEntries = 100) {
+    this.#client = client;
+    this.#logger = client[additionalContext].logger;
+    this.#maxWait = maxWait;
+    this.#maxEntries = maxEntries;
+  }
+  fetch(apiName, primaryKey) {
+    const deferred = pDefer();
+    const entry = this.#m.get(apiName);
+    entry.data.push({
+      primaryKey: primaryKey,
+      deferred
+    });
+    if (!entry.timer) {
+      entry.timer = setTimeout(() => {
+        this.#loadObjects(apiName, entry.data);
+      }, this.#maxWait);
+    }
+    if (entry.data.length >= this.#maxEntries) {
+      clearTimeout(entry.timer);
+      this.#loadObjects(apiName, entry.data);
+    }
+    return deferred.promise;
+  }
+  #loadObjects(apiName, arr) {
+    this.#m.delete(apiName);
+    this.#reallyLoadObjects(apiName, arr).catch(e => {
+      this.#logger?.error("Unhandled exception", e);
+    });
+  }
+  async #reallyLoadObjects(apiName, arr) {
+    const miniDef = {
+      type: "object",
+      apiName
+    };
+    const objMetadata = await this.#client.fetchMetadata(miniDef);
+    const pks = arr.map(x => x.primaryKey);
+    const {
+      data
+    } = await this.#client(miniDef).where({
+      [objMetadata.primaryKeyApiName]: {
+        $in: pks
+      }
+    }).fetchPage({
+      $pageSize: pks.length
+    });
+    for (const {
+      primaryKey,
+      deferred
+    } of arr) {
+      const object = data.find(x => x.$primaryKey === primaryKey);
+      if (object) {
+        deferred.resolve(object);
+      } else {
+        deferred.reject(new PalantirApiError("Object not found"));
+      }
+    }
+  }
+}
+//# sourceMappingURL=BulkObjectLoader.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"BulkObjectLoader.js","names":["PalantirApiError","DefaultMap","DefaultWeakMap","pDefer","additionalContext","weakCache","c","BulkObjectLoader","getBulkObjectLoader","client","get","m","data","timer","undefined","logger","maxWait","maxEntries","constructor","fetch","apiName","primaryKey","deferred","entry","push","setTimeout","loadObjects","length","clearTimeout","promise","#loadObjects","arr","delete","reallyLoadObjects","catch","e","error","#reallyLoadObjects","miniDef","type","objMetadata","fetchMetadata","pks","map","x","where","primaryKeyApiName","$in","fetchPage","$pageSize","object","find","$primaryKey","resolve","reject"],"sources":["BulkObjectLoader.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 { Logger, ObjectTypeDefinition } from \"@osdk/api\";\nimport { PalantirApiError } from \"@osdk/shared.net.errors\";\nimport { DefaultMap, DefaultWeakMap } from \"mnemonist\";\nimport type { DeferredPromise } from \"p-defer\";\nimport pDefer from \"p-defer\";\nimport { additionalContext, type Client } from \"../../Client.js\";\nimport type {\n  ObjectHolder,\n} from \"../../object/convertWireToOsdkObjects/ObjectHolder.js\";\n\ninterface InternalValue {\n  primaryKey: string;\n  deferred: DeferredPromise<ObjectHolder>;\n}\n\ninterface Accumulator {\n  data: InternalValue[];\n  timer?: ReturnType<typeof setTimeout>;\n}\n\nconst weakCache = new DefaultWeakMap<Client, BulkObjectLoader>(c =>\n  new BulkObjectLoader(c)\n);\n\nexport function getBulkObjectLoader(client: Client): BulkObjectLoader {\n  return weakCache.get(client);\n}\n\nexport class BulkObjectLoader {\n  #client: Client;\n\n  #m = new DefaultMap<string, Accumulator>(() => ({\n    data: [],\n    timer: undefined,\n  }));\n  #logger: Logger | undefined;\n  #maxWait: number;\n  #maxEntries: number;\n\n  constructor(client: Client, maxWait = 25, maxEntries = 100) {\n    this.#client = client;\n    this.#logger = client[additionalContext].logger;\n    this.#maxWait = maxWait;\n    this.#maxEntries = maxEntries;\n  }\n\n  public fetch(\n    apiName: string,\n    primaryKey: string | number | boolean,\n  ): Promise<ObjectHolder> {\n    const deferred = pDefer<ObjectHolder>();\n\n    const entry = this.#m.get(apiName);\n    entry.data.push({\n      primaryKey: primaryKey as string,\n      deferred,\n    });\n\n    if (!entry.timer) {\n      entry.timer = setTimeout(() => {\n        this.#loadObjects(apiName, entry.data);\n      }, this.#maxWait);\n    }\n\n    if (entry.data.length >= this.#maxEntries) {\n      clearTimeout(entry.timer);\n      this.#loadObjects(apiName, entry.data);\n    }\n\n    return deferred.promise;\n  }\n\n  #loadObjects(apiName: string, arr: InternalValue[]) {\n    this.#m.delete(apiName);\n\n    this.#reallyLoadObjects(apiName, arr).catch((e: unknown) => {\n      this.#logger?.error(\"Unhandled exception\", e);\n    });\n  }\n\n  async #reallyLoadObjects(apiName: string, arr: InternalValue[]) {\n    const miniDef = { type: \"object\", apiName } as ObjectTypeDefinition;\n    const objMetadata = await this.#client.fetchMetadata(miniDef);\n\n    const pks = arr.map(x => x.primaryKey);\n\n    const { data } = await this.#client(miniDef)\n      .where({\n        [objMetadata.primaryKeyApiName]: { $in: pks },\n      }).fetchPage({\n        $pageSize: pks.length,\n      });\n\n    for (const { primaryKey, deferred } of arr) {\n      const object = data.find(x => x.$primaryKey === primaryKey) as\n        | ObjectHolder\n        | undefined;\n      if (object) {\n        deferred.resolve(object);\n      } else {\n        deferred.reject(new PalantirApiError(\"Object not found\"));\n      }\n    }\n  }\n}\n"],"mappings":"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","ignoreList":[]}

package/build/esm/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/esm/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/esm/observable/internal/CacheKey.js

@@ -31,7 +31,7 @@ export function DEBUG_ONLY__cacheKeyToString(x) {
  */
 export function DEBUG_ONLY__cacheKeysToString(x) {
   if (process.env.NODE_ENV !== "production") {
-    return JSON.stringify(x.map(DEBUG_ONLY__cacheKeyToString), null, 2);
+    return "\n  - " + x.map(DEBUG_ONLY__cacheKeyToString).join("\n  - ");
   } else {
     throw new Error("not implemented");
   }

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

@@ -1 +1 @@
-{"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 JSON.stringify(x.map(DEBUG_ONLY__cacheKeyToString), null, 2);\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,OAAOK,IAAI,CAACC,SAAS,CAACT,CAAC,CAACM,GAAG,CAACP,4BAA4B,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;EACrE,CAAC,MAAM;IACL,MAAM,IAAIa,KAAK,CAAC,iBAAiB,CAAC;EACpC;AACF","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/esm/observable/internal/CacheKeys.js

@@ -37,12 +37,12 @@ export class CacheKeys {
       }
       return this.#cacheKeys.lookupArray(["object", apiName, pk]);
     });
-    this.#registerCacheKeyFactory("list", (apiName, where, orderBy) => {
+    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)}, ${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), orderByCanonicalizer.canonicalize(orderBy)]);
+      return this.#cacheKeys.lookupArray(["list", type, apiName, whereCanonicalizer.canonicalize(where), orderByCanonicalizer.canonicalize(orderBy)]);
     });
   }
   #registerCacheKeyFactory(type, factory) {

package/build/esm/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","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 \"./Store.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      (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          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":[]}
+{"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/esm/observable/internal/{ChangedObjects.js → Changes.js}

@@ -16,21 +16,32 @@
 
 import { MultiMap } from "mnemonist";
 import { DEBUG_ONLY__cacheKeyToString } from "./CacheKey.js";
-export function createChangedObjects() {
-  return {
-    modifiedObjects: new MultiMap(),
-    addedObjects: new MultiMap(),
-    addedLists: new Set(),
-    modifiedLists: new Set()
+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),
-      addedLists: listHelper(changes.addedLists),
-      modifiedLists: listHelper(changes.modifiedLists)
+      added: listHelper(changes.added),
+      modified: listHelper(changes.modified)
     }, null, 2);
   } else {
     throw new Error("not implemented");
@@ -44,4 +55,4 @@ function multimapHelper(multimap) {
     return [type, objects.map(o => o.$primaryKey)];
   }));
 }
-//# sourceMappingURL=ChangedObjects.js.map
+//# sourceMappingURL=Changes.js.map

package/build/esm/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/esm/observable/internal/Layer.js

@@ -58,6 +58,9 @@ export class Layer {
   entries() {
     return this.#cache.entries();
   }
+  keys() {
+    return this.#cache.keys();
+  }
   get(cacheKey) {
     return this.#cache.get(cacheKey) ?? this.#parent?.get(cacheKey);
   }

package/build/esm/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\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  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;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,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":[]}
+{"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":[]}