@osdk/client 2.4.2 → 2.5.0-beta.10

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

@@ -0,0 +1 @@
+{"version":3,"file":"KnownCacheKey.js","names":[],"sources":["KnownCacheKey.ts"],"sourcesContent":["/*\n * Copyright 2025 Palantir Technologies, Inc. All rights reserved.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport type { SpecificLinkCacheKey } from \"./links/SpecificLinkCacheKey.js\";\nimport type { ListCacheKey } from \"./list/ListCacheKey.js\";\nimport type { ObjectCacheKey } from \"./object/ObjectCacheKey.js\";\n\nexport type KnownCacheKey =\n  | ObjectCacheKey\n  | SpecificLinkCacheKey\n  | ListCacheKey;\n"],"mappings":"","ignoreList":[]}

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

@@ -68,12 +68,4 @@ export class Layer {
     this.#cache.set(cacheKey, value);
   }
 }
-export class Entry {
-  constructor(cacheKey, value, lastUpdated, status = "init") {
-    this.cacheKey = cacheKey;
-    this.value = value;
-    this.lastUpdated = lastUpdated;
-    this.status = status;
-  }
-}
 //# sourceMappingURL=Layer.js.map

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","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":[]}
+{"version":3,"file":"Layer.js","names":["WeakMapWithEntries","Layer","parent","cache","layerId","constructor","parentLayer","addLayer","removeLayer","entries","keys","get","cacheKey","set","value"],"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 { KnownCacheKey } from \"./KnownCacheKey.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<KnownCacheKey, 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<[KnownCacheKey, Entry<any>]> {\n    return this.#cache.entries();\n  }\n\n  keys(): IterableIterator<KnownCacheKey> {\n    return this.#cache.keys();\n  }\n\n  public get<K extends KnownCacheKey>(\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 KnownCacheKey>(\n    cacheKey: K,\n    value: Entry<K>,\n  ): void {\n    this.#cache.set(cacheKey, value);\n  }\n}\n\nexport interface Entry<K extends KnownCacheKey> {\n  readonly cacheKey: K;\n  value: K[\"__cacheKey\"][\"value\"] | undefined;\n  lastUpdated: number;\n  status: \"init\" | \"loading\" | \"loaded\" | \"error\";\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,CAA4B,CAAC;EAC5D,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,EAAkD;IACvD,OAAO,IAAI,CAAC,CAACN,KAAK,CAACM,OAAO,CAAC,CAAC;EAC9B;EAEAC,IAAIA,CAAA,EAAoC;IACtC,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","ignoreList":[]}

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

@@ -0,0 +1,151 @@
+/*
+ * 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 invariant from "tiny-invariant";
+import { createInitEntry } from "./createInitEntry.js";
+import { Layer } from "./Layer.js";
+import { Subjects } from "./Subjects.js";
+import { tombstone } from "./tombstone.js";
+export class Layers {
+  #truthLayer = new Layer(undefined, undefined);
+  #topLayer;
+  #onRevalidate;
+  constructor({
+    logger,
+    onRevalidate
+  }) {
+    this.logger = logger;
+    this.#topLayer = this.#truthLayer;
+    this.subjects = new Subjects({
+      logger,
+      layers: this
+    });
+    this.#onRevalidate = onRevalidate;
+  }
+  get top() {
+    return this.#topLayer;
+  }
+  get truth() {
+    return this.#truthLayer;
+  }
+  remove(layerId) {
+    !(layerId != null) ? process.env.NODE_ENV !== "production" ? invariant(false, "undefined is the reserved layerId for the truth layer") : invariant(false) : void 0;
+    // 1. collect all cache keys for a given layerId
+    let currentLayer = this.#topLayer;
+    const cacheKeys = new Map();
+    while (currentLayer != null && currentLayer.parentLayer != null) {
+      if (currentLayer.layerId === layerId) {
+        for (const [k, v] of currentLayer.entries()) {
+          if (cacheKeys.has(k)) continue;
+          cacheKeys.set(k, v);
+        }
+      }
+      currentLayer = currentLayer.parentLayer;
+    }
+
+    // 2. remove the layers from the chain
+    this.#topLayer = this.#topLayer.removeLayer(layerId);
+
+    // 3. check each cache key to see if it is different in the new chain
+    for (const [k, oldEntry] of cacheKeys) {
+      const currentEntry = this.#topLayer.get(k);
+
+      // 4. if different, update the subject
+      if (oldEntry !== currentEntry) {
+        const newEntry = currentEntry ?? createInitEntry(k);
+        // We are going to be pretty lazy here and just re-emit the value.
+        // In the future it may benefit us to deep equal check her but I think
+        // the subjects are effectively doing this anyway.
+        this.subjects.peek(k)?.next({
+          ...newEntry,
+          isOptimistic: currentEntry?.value !== this.#truthLayer.get(k)?.value
+        });
+      }
+    }
+  }
+  batch({
+    optimisticId,
+    changes
+  }, batchFn) {
+    !(optimisticId === undefined || !!optimisticId) ? process.env.NODE_ENV !== "production" ? invariant(false, "optimistic must be undefined or not falsy") : invariant(false) : void 0;
+    const batchContext = this.#createBatchContext({
+      optimisticId,
+      changes
+    });
+    const retVal = batchFn(batchContext);
+    this.#onRevalidate(changes, optimisticId).catch(e => {
+      // we don't want batch() to return a promise,
+      // so we settle for logging an error here instead of
+      // dropping it on the floor.
+      if (this.logger) {
+        this.logger.error("Unhandled error in batch", e);
+      } else {
+        // eslint-disable-next-line no-console
+        console.error("Unhandled error in batch", e);
+        throw e;
+      }
+    });
+    return {
+      batchResult: batchContext,
+      retVal: retVal,
+      changes: batchContext.changes
+    };
+  }
+  #createBatchContext({
+    optimisticId,
+    changes
+  }) {
+    let needsLayer = optimisticId !== undefined;
+    const batchContext = {
+      changes,
+      createLayerIfNeeded: () => {
+        if (needsLayer) {
+          this.#topLayer = this.#topLayer.addLayer(optimisticId);
+          needsLayer = false;
+        }
+      },
+      optimisticWrite: !!optimisticId,
+      write: (cacheKey, value, status) => {
+        const oldTopValue = this.#topLayer.get(cacheKey);
+        if (optimisticId) batchContext.createLayerIfNeeded();
+        const writeLayer = optimisticId ? this.#topLayer : this.#truthLayer;
+        const newValue = {
+          cacheKey,
+          value,
+          lastUpdated: Date.now(),
+          status
+        };
+        writeLayer.set(cacheKey, newValue);
+        const newTopValue = this.#topLayer.get(cacheKey);
+        if (oldTopValue !== newTopValue) {
+          this.subjects.get(cacheKey)?.next({
+            ...newValue,
+            isOptimistic: newTopValue?.value !== this.#truthLayer.get(cacheKey)?.value
+          });
+        }
+        return newValue;
+      },
+      delete: (cacheKey, status) => {
+        return batchContext.write(cacheKey, tombstone, status);
+      },
+      read: cacheKey => {
+        return optimisticId ? this.#topLayer.get(cacheKey) : this.#truthLayer.get(cacheKey);
+      }
+    };
+    return batchContext;
+  }
+}
+//# sourceMappingURL=Layers.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Layers.js","names":["invariant","createInitEntry","Layer","Subjects","tombstone","Layers","truthLayer","undefined","topLayer","onRevalidate","constructor","logger","subjects","layers","top","truth","remove","layerId","process","env","NODE_ENV","currentLayer","cacheKeys","Map","parentLayer","k","v","entries","has","set","removeLayer","oldEntry","currentEntry","get","newEntry","peek","next","isOptimistic","value","batch","optimisticId","changes","batchFn","batchContext","createBatchContext","retVal","catch","e","error","console","batchResult","#createBatchContext","needsLayer","createLayerIfNeeded","addLayer","optimisticWrite","write","cacheKey","status","oldTopValue","writeLayer","newValue","lastUpdated","Date","now","newTopValue","delete","read"],"sources":["Layers.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 } from \"@osdk/api\";\nimport invariant from \"tiny-invariant\";\nimport type { BatchContext } from \"./BatchContext.js\";\nimport { type Changes } from \"./Changes.js\";\nimport { createInitEntry } from \"./createInitEntry.js\";\nimport type { KnownCacheKey } from \"./KnownCacheKey.js\";\nimport type { Entry } from \"./Layer.js\";\nimport { Layer } from \"./Layer.js\";\nimport type { OptimisticId } from \"./OptimisticId.js\";\nimport { Subjects } from \"./Subjects.js\";\nimport { tombstone } from \"./tombstone.js\";\n\nexport class Layers {\n  #truthLayer: Layer = new Layer(undefined, undefined);\n  #topLayer: Layer;\n  #onRevalidate: (\n    changes: Changes,\n    optimisticId?: OptimisticId,\n  ) => Promise<void>;\n\n  logger?: Logger;\n\n  readonly subjects: Subjects;\n\n  constructor(\n    { logger, onRevalidate }: {\n      logger?: Logger;\n      onRevalidate: (\n        changes: Changes,\n        optimisticId?: OptimisticId,\n      ) => Promise<void>;\n    },\n  ) {\n    this.logger = logger;\n    this.#topLayer = this.#truthLayer;\n    this.subjects = new Subjects({ logger, layers: this });\n    this.#onRevalidate = onRevalidate;\n  }\n\n  get top(): Layer {\n    return this.#topLayer;\n  }\n\n  get truth(): Layer {\n    return this.#truthLayer;\n  }\n\n  remove(layerId: OptimisticId): void {\n    invariant(\n      layerId != null,\n      \"undefined is the reserved layerId for the truth layer\",\n    );\n    // 1. collect all cache keys for a given layerId\n    let currentLayer: Layer | undefined = this.#topLayer;\n    const cacheKeys = new Map<KnownCacheKey, Entry<any>>();\n    while (currentLayer != null && currentLayer.parentLayer != null) {\n      if (currentLayer.layerId === layerId) {\n        for (const [k, v] of currentLayer.entries()) {\n          if (cacheKeys.has(k)) continue;\n          cacheKeys.set(k, v);\n        }\n      }\n\n      currentLayer = currentLayer.parentLayer;\n    }\n\n    // 2. remove the layers from the chain\n    this.#topLayer = this.#topLayer.removeLayer(layerId);\n\n    // 3. check each cache key to see if it is different in the new chain\n    for (const [k, oldEntry] of cacheKeys) {\n      const currentEntry = this.#topLayer.get(k);\n\n      // 4. if different, update the subject\n      if (oldEntry !== currentEntry) {\n        const newEntry = currentEntry ?? createInitEntry(k);\n        // We are going to be pretty lazy here and just re-emit the value.\n        // In the future it may benefit us to deep equal check her but I think\n        // the subjects are effectively doing this anyway.\n        this.subjects.peek(k)?.next(\n          {\n            ...newEntry,\n            isOptimistic:\n              currentEntry?.value !== this.#truthLayer.get(k)?.value,\n          },\n        );\n      }\n    }\n  }\n\n  public batch<X>(\n    { optimisticId, changes }: {\n      optimisticId?: OptimisticId;\n      changes: Changes;\n    },\n    batchFn: (batchContext: BatchContext) => X,\n  ): {\n    batchResult: BatchContext;\n    retVal: X;\n    changes: Changes;\n  } {\n    invariant(\n      optimisticId === undefined || !!optimisticId,\n      \"optimistic must be undefined or not falsy\",\n    );\n\n    const batchContext: BatchContext = this.#createBatchContext({\n      optimisticId,\n      changes,\n    });\n\n    const retVal = batchFn(batchContext);\n\n    this.#onRevalidate(changes, optimisticId).catch(e => {\n      // we don't want batch() to return a promise,\n      // so we settle for logging an error here instead of\n      // dropping it on the floor.\n      if (this.logger) {\n        this.logger.error(\"Unhandled error in batch\", e);\n      } else {\n        // eslint-disable-next-line no-console\n        console.error(\"Unhandled error in batch\", e);\n        throw e;\n      }\n    });\n\n    return {\n      batchResult: batchContext,\n      retVal: retVal,\n      changes: batchContext.changes,\n    };\n  }\n\n  #createBatchContext(\n    { optimisticId, changes }: {\n      optimisticId?: OptimisticId;\n      changes: Changes;\n    },\n  ): BatchContext {\n    let needsLayer = optimisticId !== undefined;\n\n    const batchContext: BatchContext = {\n      changes,\n      createLayerIfNeeded: () => {\n        if (needsLayer) {\n          this.#topLayer = this.#topLayer.addLayer(optimisticId);\n          needsLayer = false;\n        }\n      },\n      optimisticWrite: !!optimisticId,\n      write: (cacheKey, value, status) => {\n        const oldTopValue = this.#topLayer.get(cacheKey);\n\n        if (optimisticId) batchContext.createLayerIfNeeded();\n\n        const writeLayer = optimisticId\n          ? this.#topLayer\n          : this.#truthLayer;\n        const newValue: Entry<typeof cacheKey> = {\n          cacheKey,\n          value,\n          lastUpdated: Date.now(),\n          status,\n        };\n\n        writeLayer.set(cacheKey, newValue);\n\n        const newTopValue = this.#topLayer.get(cacheKey);\n\n        if (oldTopValue !== newTopValue) {\n          this.subjects.get(cacheKey)?.next({\n            ...newValue,\n            isOptimistic:\n              newTopValue?.value !== this.#truthLayer.get(cacheKey)?.value,\n          });\n        }\n\n        return newValue;\n      },\n      delete: (cacheKey, status) => {\n        return batchContext.write(cacheKey, tombstone, status);\n      },\n      read: (cacheKey) => {\n        return optimisticId\n          ? this.#topLayer.get(cacheKey)\n          : this.#truthLayer.get(cacheKey);\n      },\n    };\n\n    return batchContext;\n  }\n}\n"],"mappings":"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","ignoreList":[]}

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

@@ -14,17 +14,68 @@
  * limitations under the License.
  */
 
+import { Subscription } from "rxjs";
+import { UnsubscribableWrapper } from "./UnsubscribableWrapper.js";
+
 /**
+ * Implementation of the public ObservableClient interface.
+ * - Delegates all operations to the Store for consistency
+ * - Serves as the entry point for reactive data management
+ * - Ensures proper method binding and API exposure
+ *
  * @internal
  */
 export class ObservableClientImpl {
   constructor(store) {
     this.__experimentalStore = store;
-    this.observeObject = store.observeObject.bind(store);
-    this.observeList = store.observeList.bind(store);
     this.applyAction = store.applyAction.bind(store);
     this.validateAction = store.validateAction.bind(store);
-    this.canonicalizeWhereClause = store.canonicalizeWhereClause.bind(store);
+  }
+  observeObject = (apiName, pk, options, subFn) => {
+    return this.__experimentalStore.objects.observe({
+      ...options,
+      apiName,
+      pk
+    },
+    // cast to cross typed to untyped barrier
+    subFn);
+  };
+  observeList = (options, subFn) => {
+    return this.__experimentalStore.lists.observe(options,
+    // cast to cross typed to untyped barrier
+    subFn);
+  };
+  observeLinks = (objects, linkName, options, subFn) => {
+    // Convert to array if single object provided
+    const objectsArray = Array.isArray(objects) ? objects : [objects];
+    const parentSub = new Subscription();
+    for (const obj of objectsArray) {
+      const querySubscription = this.__experimentalStore.links.observe({
+        ...options,
+        srcType: {
+          type: "object",
+          apiName: obj.$apiName
+        },
+        linkName,
+        pk: obj.$primaryKey
+      },
+      // cast to cross typed to untyped barrier
+      subFn);
+      parentSub.add(querySubscription);
+    }
+    return new UnsubscribableWrapper(parentSub);
+  };
+  invalidateAll() {
+    return this.__experimentalStore.invalidateAll();
+  }
+  invalidateObjects(objects) {
+    return this.__experimentalStore.invalidateObjects(objects);
+  }
+  invalidateObjectType(type) {
+    return this.__experimentalStore.invalidateObjectType(type, undefined);
+  }
+  canonicalizeWhereClause(where) {
+    return this.__experimentalStore.whereCanonicalizer.canonicalize(where);
   }
 }
 //# sourceMappingURL=ObservableClientImpl.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"ObservableClientImpl.js","names":["ObservableClientImpl","constructor","store","__experimentalStore","observeObject","bind","observeList","applyAction","validateAction","canonicalizeWhereClause"],"sources":["ObservableClientImpl.ts"],"sourcesContent":["/*\n * Copyright 2025 Palantir Technologies, Inc. All rights reserved.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport type {\n  ActionDefinition,\n  ActionValidationResponse,\n  InterfaceDefinition,\n  ObjectTypeDefinition,\n  PrimaryKeyType,\n  WhereClause,\n} from \"@osdk/api\";\nimport type { ActionSignatureFromDef } from \"../../actions/applyAction.js\";\nimport type {\n  ObservableClient,\n  ObserveListOptions,\n  ObserveObjectArgs,\n  ObserveObjectOptions,\n  ObserveObjectsArgs,\n  Observer,\n  Unsubscribable,\n} from \"../ObservableClient.js\";\nimport type { Canonical } from \"./Canonical.js\";\nimport type { Store } from \"./Store.js\";\n\n/**\n * @internal\n */\nexport class ObservableClientImpl implements ObservableClient {\n  __experimentalStore: Store;\n\n  constructor(store: Store) {\n    this.__experimentalStore = store;\n\n    this.observeObject = store.observeObject.bind(\n      store,\n    ) as typeof this.observeObject;\n    this.observeList = store.observeList.bind(store) as typeof this.observeList;\n    this.applyAction = store.applyAction.bind(store);\n    this.validateAction = store.validateAction.bind(store);\n    this.canonicalizeWhereClause = store.canonicalizeWhereClause.bind(\n      store,\n    ) as typeof this.canonicalizeWhereClause;\n  }\n\n  public observeObject: <T extends ObjectTypeDefinition>(\n    apiName: T[\"apiName\"] | T,\n    pk: PrimaryKeyType<T>,\n    options: ObserveObjectOptions<T>,\n    subFn: Observer<ObserveObjectArgs<T>>,\n  ) => Unsubscribable;\n\n  public observeList: <T extends ObjectTypeDefinition | InterfaceDefinition>(\n    options: ObserveListOptions<T>,\n    subFn: Observer<ObserveObjectsArgs<T>>,\n  ) => Unsubscribable;\n\n  public applyAction: <Q extends ActionDefinition<any>>(\n    action: Q,\n    args: Parameters<ActionSignatureFromDef<Q>[\"applyAction\"]>[0],\n    opts?: ObservableClient.ApplyActionOptions,\n  ) => Promise<unknown>;\n\n  public validateAction: <Q extends ActionDefinition<any>>(\n    action: Q,\n    args: Parameters<ActionSignatureFromDef<Q>[\"applyAction\"]>[0],\n  ) => Promise<ActionValidationResponse>;\n\n  public canonicalizeWhereClause: <\n    T extends ObjectTypeDefinition | InterfaceDefinition,\n  >(\n    where: WhereClause<T>,\n  ) => Canonical<WhereClause<T>>;\n}\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAuBA;AACA;AACA;AACA,OAAO,MAAMA,oBAAoB,CAA6B;EAG5DC,WAAWA,CAACC,KAAY,EAAE;IACxB,IAAI,CAACC,mBAAmB,GAAGD,KAAK;IAEhC,IAAI,CAACE,aAAa,GAAGF,KAAK,CAACE,aAAa,CAACC,IAAI,CAC3CH,KACF,CAA8B;IAC9B,IAAI,CAACI,WAAW,GAAGJ,KAAK,CAACI,WAAW,CAACD,IAAI,CAACH,KAAK,CAA4B;IAC3E,IAAI,CAACK,WAAW,GAAGL,KAAK,CAACK,WAAW,CAACF,IAAI,CAACH,KAAK,CAAC;IAChD,IAAI,CAACM,cAAc,GAAGN,KAAK,CAACM,cAAc,CAACH,IAAI,CAACH,KAAK,CAAC;IACtD,IAAI,CAACO,uBAAuB,GAAGP,KAAK,CAACO,uBAAuB,CAACJ,IAAI,CAC/DH,KACF,CAAwC;EAC1C;AA8BF","ignoreList":[]}
+{"version":3,"file":"ObservableClientImpl.js","names":["Subscription","UnsubscribableWrapper","ObservableClientImpl","constructor","store","__experimentalStore","applyAction","bind","validateAction","observeObject","apiName","pk","options","subFn","objects","observe","observeList","lists","observeLinks","linkName","objectsArray","Array","isArray","parentSub","obj","querySubscription","links","srcType","type","$apiName","$primaryKey","add","invalidateAll","invalidateObjects","invalidateObjectType","undefined","canonicalizeWhereClause","where","whereCanonicalizer","canonicalize"],"sources":["ObservableClientImpl.ts"],"sourcesContent":["/*\n * Copyright 2025 Palantir Technologies, Inc. All rights reserved.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport type {\n  ActionDefinition,\n  ActionValidationResponse,\n  CompileTimeMetadata,\n  InterfaceDefinition,\n  ObjectTypeDefinition,\n  Osdk,\n  PrimaryKeyType,\n  WhereClause,\n} from \"@osdk/api\";\nimport { Subscription } from \"rxjs\";\nimport type { ActionSignatureFromDef } from \"../../actions/applyAction.js\";\nimport type { SpecificLinkPayload } from \"../LinkPayload.js\";\nimport type { ListPayload } from \"../ListPayload.js\";\nimport type { ObjectPayload } from \"../ObjectPayload.js\";\nimport type {\n  ObservableClient,\n  ObserveListOptions,\n  ObserveObjectArgs,\n  ObserveObjectOptions,\n  ObserveObjectsArgs,\n  Unsubscribable,\n} from \"../ObservableClient.js\";\nimport type { Observer } from \"../ObservableClient/common.js\";\nimport type { ObserveLinks } from \"../ObservableClient/ObserveLink.js\";\nimport type { Canonical } from \"./Canonical.js\";\nimport type { Store } from \"./Store.js\";\nimport { UnsubscribableWrapper } from \"./UnsubscribableWrapper.js\";\n\n/**\n * Implementation of the public ObservableClient interface.\n * - Delegates all operations to the Store for consistency\n * - Serves as the entry point for reactive data management\n * - Ensures proper method binding and API exposure\n *\n * @internal\n */\nexport class ObservableClientImpl implements ObservableClient {\n  __experimentalStore: Store;\n\n  constructor(store: Store) {\n    this.__experimentalStore = store;\n\n    this.applyAction = store.applyAction.bind(store);\n    this.validateAction = store.validateAction.bind(store);\n  }\n\n  public observeObject: <T extends ObjectTypeDefinition>(\n    apiName: T[\"apiName\"] | T,\n    pk: PrimaryKeyType<T>,\n    options: Omit<ObserveObjectOptions<T>, \"apiName\" | \"pk\">,\n    subFn: Observer<ObserveObjectArgs<T>>,\n  ) => Unsubscribable = (apiName, pk, options, subFn) => {\n    return this.__experimentalStore.objects.observe(\n      {\n        ...options,\n        apiName,\n        pk,\n      },\n      // cast to cross typed to untyped barrier\n      subFn as unknown as Observer<ObjectPayload>,\n    );\n  };\n\n  public observeList: <T extends ObjectTypeDefinition | InterfaceDefinition>(\n    options: ObserveListOptions<T>,\n    subFn: Observer<ObserveObjectsArgs<T>>,\n  ) => Unsubscribable = (options, subFn) => {\n    return this.__experimentalStore.lists.observe(\n      options,\n      // cast to cross typed to untyped barrier\n      subFn as unknown as Observer<ListPayload>,\n    );\n  };\n\n  public observeLinks: <\n    T extends ObjectTypeDefinition | InterfaceDefinition,\n    L extends keyof CompileTimeMetadata<T>[\"links\"] & string,\n  >(\n    objects: Osdk.Instance<T> | Array<Osdk.Instance<T>>,\n    linkName: L,\n    options: ObserveLinks.Options<T, L>,\n    subFn: Observer<\n      ObserveLinks.CallbackArgs<\n        CompileTimeMetadata<T>[\"links\"][L][\"targetType\"]\n      >\n    >,\n  ) => Unsubscribable = (objects, linkName, options, subFn) => {\n    // Convert to array if single object provided\n    const objectsArray = Array.isArray(objects) ? objects : [objects];\n\n    const parentSub = new Subscription();\n\n    for (const obj of objectsArray) {\n      const querySubscription = this.__experimentalStore.links\n        .observe(\n          {\n            ...options,\n            srcType: {\n              type: \"object\",\n              apiName: obj.$apiName,\n            },\n            linkName,\n            pk: obj.$primaryKey,\n          },\n          // cast to cross typed to untyped barrier\n          subFn as unknown as Observer<SpecificLinkPayload>,\n        );\n\n      parentSub.add(querySubscription);\n    }\n\n    return new UnsubscribableWrapper(parentSub);\n  };\n\n  public applyAction: <Q extends ActionDefinition<any>>(\n    action: Q,\n    args: Parameters<ActionSignatureFromDef<Q>[\"applyAction\"]>[0],\n    opts?: ObservableClient.ApplyActionOptions,\n  ) => Promise<unknown>;\n\n  public validateAction: <Q extends ActionDefinition<any>>(\n    action: Q,\n    args: Parameters<ActionSignatureFromDef<Q>[\"applyAction\"]>[0],\n  ) => Promise<ActionValidationResponse>;\n\n  public invalidateAll(): Promise<void> {\n    return this.__experimentalStore.invalidateAll();\n  }\n\n  public invalidateObjects(\n    objects:\n      | Osdk.Instance<ObjectTypeDefinition>\n      | ReadonlyArray<Osdk.Instance<ObjectTypeDefinition>>,\n  ): Promise<void> {\n    return this.__experimentalStore.invalidateObjects(objects);\n  }\n\n  public invalidateObjectType<T extends ObjectTypeDefinition>(\n    type: T | T[\"apiName\"],\n  ): Promise<void> {\n    return this.__experimentalStore.invalidateObjectType(type, undefined);\n  }\n\n  public canonicalizeWhereClause<\n    T extends ObjectTypeDefinition | InterfaceDefinition,\n  >(where: WhereClause<T>): Canonical<WhereClause<T>> {\n    return this.__experimentalStore.whereCanonicalizer\n      .canonicalize(where) as Canonical<WhereClause<T>>;\n  }\n}\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAYA,SAASA,YAAY,QAAQ,MAAM;AAiBnC,SAASC,qBAAqB,QAAQ,4BAA4B;;AAElE;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMC,oBAAoB,CAA6B;EAG5DC,WAAWA,CAACC,KAAY,EAAE;IACxB,IAAI,CAACC,mBAAmB,GAAGD,KAAK;IAEhC,IAAI,CAACE,WAAW,GAAGF,KAAK,CAACE,WAAW,CAACC,IAAI,CAACH,KAAK,CAAC;IAChD,IAAI,CAACI,cAAc,GAAGJ,KAAK,CAACI,cAAc,CAACD,IAAI,CAACH,KAAK,CAAC;EACxD;EAEOK,aAAa,GAKEA,CAACC,OAAO,EAAEC,EAAE,EAAEC,OAAO,EAAEC,KAAK,KAAK;IACrD,OAAO,IAAI,CAACR,mBAAmB,CAACS,OAAO,CAACC,OAAO,CAC7C;MACE,GAAGH,OAAO;MACVF,OAAO;MACPC;IACF,CAAC;IACD;IACAE,KACF,CAAC;EACH,CAAC;EAEMG,WAAW,GAGIA,CAACJ,OAAO,EAAEC,KAAK,KAAK;IACxC,OAAO,IAAI,CAACR,mBAAmB,CAACY,KAAK,CAACF,OAAO,CAC3CH,OAAO;IACP;IACAC,KACF,CAAC;EACH,CAAC;EAEMK,YAAY,GAYGA,CAACJ,OAAO,EAAEK,QAAQ,EAAEP,OAAO,EAAEC,KAAK,KAAK;IAC3D;IACA,MAAMO,YAAY,GAAGC,KAAK,CAACC,OAAO,CAACR,OAAO,CAAC,GAAGA,OAAO,GAAG,CAACA,OAAO,CAAC;IAEjE,MAAMS,SAAS,GAAG,IAAIvB,YAAY,CAAC,CAAC;IAEpC,KAAK,MAAMwB,GAAG,IAAIJ,YAAY,EAAE;MAC9B,MAAMK,iBAAiB,GAAG,IAAI,CAACpB,mBAAmB,CAACqB,KAAK,CACrDX,OAAO,CACN;QACE,GAAGH,OAAO;QACVe,OAAO,EAAE;UACPC,IAAI,EAAE,QAAQ;UACdlB,OAAO,EAAEc,GAAG,CAACK;QACf,CAAC;QACDV,QAAQ;QACRR,EAAE,EAAEa,GAAG,CAACM;MACV,CAAC;MACD;MACAjB,KACF,CAAC;MAEHU,SAAS,CAACQ,GAAG,CAACN,iBAAiB,CAAC;IAClC;IAEA,OAAO,IAAIxB,qBAAqB,CAACsB,SAAS,CAAC;EAC7C,CAAC;EAaMS,aAAaA,CAAA,EAAkB;IACpC,OAAO,IAAI,CAAC3B,mBAAmB,CAAC2B,aAAa,CAAC,CAAC;EACjD;EAEOC,iBAAiBA,CACtBnB,OAEsD,EACvC;IACf,OAAO,IAAI,CAACT,mBAAmB,CAAC4B,iBAAiB,CAACnB,OAAO,CAAC;EAC5D;EAEOoB,oBAAoBA,CACzBN,IAAsB,EACP;IACf,OAAO,IAAI,CAACvB,mBAAmB,CAAC6B,oBAAoB,CAACN,IAAI,EAAEO,SAAS,CAAC;EACvE;EAEOC,uBAAuBA,CAE5BC,KAAqB,EAA6B;IAClD,OAAO,IAAI,CAAChC,mBAAmB,CAACiC,kBAAkB,CAC/CC,YAAY,CAACF,KAAK,CAAC;EACxB;AACF","ignoreList":[]}

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

@@ -14,43 +14,7 @@
  * limitations under the License.
  */
 
-import { Trie } from "@wry/trie";
-const defaultMakeData = () => Object.create(null);
-export class WeakRefTrie {
-  #finalizer = new FinalizationRegistry(orderBy => {
-    this.#trie.removeArray(Object.entries(orderBy).flat());
-  });
-  #trie;
-  constructor(makeData = defaultMakeData) {
-    this.#trie = new Trie(false, array => {
-      const data = makeData(array);
-      this.#finalizer.register(data, array);
-      return new WeakRef(data);
-    });
-  }
-  lookupArray(array) {
-    const maybe = this.#trie.lookupArray(array);
-    let ret = maybe.deref();
-    if (maybe && !ret) {
-      // in case finalizer hasn't run
-      this.#trie.removeArray(array);
-      ret = this.#trie.lookupArray(array).deref();
-    }
-    return ret;
-  }
-  peekArray(array) {
-    const maybe = this.#trie.peekArray(array);
-    const ret = maybe?.deref();
-    if (maybe && !ret) {
-      // in case finalizer hasn't run
-      this.#trie.removeArray(array);
-    }
-    return ret;
-  }
-  removeArray(array) {
-    return this.#trie.removeArray(array)?.deref();
-  }
-}
+import { WeakRefTrie } from "./WeakRefTrie.js";
 export class OrderByCanonicalizer {
   #trie = new WeakRefTrie(array => {
     const pairs = array.reduce(function (result, _, index, array) {

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

@@ -1 +1 @@
-{"version":3,"file":"OrderByCanonicalizer.js","names":["Trie","defaultMakeData","Object","create","WeakRefTrie","finalizer","FinalizationRegistry","orderBy","trie","removeArray","entries","flat","constructor","makeData","array","data","register","WeakRef","lookupArray","maybe","ret","deref","peekArray","OrderByCanonicalizer","pairs","reduce","result","_","index","push","slice","fromEntries","process","env","NODE_ENV","freeze","canonicalize","strings"],"sources":["OrderByCanonicalizer.ts"],"sourcesContent":["/*\n * Copyright 2025 Palantir Technologies, Inc. All rights reserved.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport type { ObjectTypeDefinition } from \"@osdk/api\";\nimport { Trie } from \"@wry/trie\";\nimport type { OrderBy } from \"../ObservableClient.js\";\nimport type { Canonical } from \"./Canonical.js\";\n\nconst defaultMakeData = () => Object.create(null);\n\nexport class WeakRefTrie<X extends object> {\n  #finalizer = new FinalizationRegistry<\n    Array<string>\n  >((orderBy) => {\n    this.#trie.removeArray(\n      Object.entries(orderBy).flat(),\n    );\n  });\n\n  #trie: Trie<WeakRef<X>>;\n\n  constructor(makeData: (array: any[]) => X = defaultMakeData) {\n    this.#trie = new Trie<WeakRef<X>>(\n      false,\n      (array) => {\n        const data = makeData(array);\n        this.#finalizer.register(data, array);\n        return new WeakRef(data);\n      },\n    );\n  }\n\n  lookupArray<T extends IArguments | any[]>(array: T): X {\n    const maybe = this.#trie.lookupArray(array);\n    let ret = maybe.deref();\n    if (maybe && !ret) {\n      // in case finalizer hasn't run\n      this.#trie.removeArray(array);\n      ret = this.#trie.lookupArray(array).deref();\n    }\n    return ret!;\n  }\n\n  peekArray<T extends IArguments | any[]>(array: T): X | undefined {\n    const maybe = this.#trie.peekArray(array);\n    const ret = maybe?.deref();\n    if (maybe && !ret) {\n      // in case finalizer hasn't run\n      this.#trie.removeArray(array);\n    }\n    return ret;\n  }\n\n  removeArray<T extends IArguments | any[]>(array: T): X | undefined {\n    return this.#trie.removeArray(array)?.deref();\n  }\n}\n\nexport class OrderByCanonicalizer {\n  #trie = new WeakRefTrie(\n    (array: Array<string>) => {\n      const pairs = array.reduce<Array<[string, \"asc\" | \"desc\"]>>(\n        function(result, _, index, array) {\n          if (index % 2 === 0 && array[index] != null) {\n            result.push(\n              array.slice(index, index + 2) as [string, \"asc\" | \"desc\"],\n            );\n          }\n          return result;\n        },\n        [],\n      );\n      let data = Object.fromEntries(pairs) satisfies Record<\n        string,\n        \"asc\" | \"desc\"\n      > as Canonical<OrderBy<ObjectTypeDefinition>>;\n\n      if (process.env.NODE_ENV !== \"production\") {\n        data = Object.freeze(data);\n      }\n      return data;\n    },\n  );\n\n  canonicalize: (\n    orderBy: Record<string, \"asc\" | \"desc\" | undefined>,\n  ) => Canonical<Record<string, \"asc\" | \"desc\" | undefined>> = (\n    orderBy,\n  ) => {\n    const strings = Object.entries(orderBy).flat();\n    return this.#trie.lookupArray(strings);\n  };\n}\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAGA,SAASA,IAAI,QAAQ,WAAW;AAIhC,MAAMC,eAAe,GAAGA,CAAA,KAAMC,MAAM,CAACC,MAAM,CAAC,IAAI,CAAC;AAEjD,OAAO,MAAMC,WAAW,CAAmB;EACzC,CAACC,SAAS,GAAG,IAAIC,oBAAoB,CAElCC,OAAO,IAAK;IACb,IAAI,CAAC,CAACC,IAAI,CAACC,WAAW,CACpBP,MAAM,CAACQ,OAAO,CAACH,OAAO,CAAC,CAACI,IAAI,CAAC,CAC/B,CAAC;EACH,CAAC,CAAC;EAEF,CAACH,IAAI;EAELI,WAAWA,CAACC,QAA6B,GAAGZ,eAAe,EAAE;IAC3D,IAAI,CAAC,CAACO,IAAI,GAAG,IAAIR,IAAI,CACnB,KAAK,EACJc,KAAK,IAAK;MACT,MAAMC,IAAI,GAAGF,QAAQ,CAACC,KAAK,CAAC;MAC5B,IAAI,CAAC,CAACT,SAAS,CAACW,QAAQ,CAACD,IAAI,EAAED,KAAK,CAAC;MACrC,OAAO,IAAIG,OAAO,CAACF,IAAI,CAAC;IAC1B,CACF,CAAC;EACH;EAEAG,WAAWA,CAA+BJ,KAAQ,EAAK;IACrD,MAAMK,KAAK,GAAG,IAAI,CAAC,CAACX,IAAI,CAACU,WAAW,CAACJ,KAAK,CAAC;IAC3C,IAAIM,GAAG,GAAGD,KAAK,CAACE,KAAK,CAAC,CAAC;IACvB,IAAIF,KAAK,IAAI,CAACC,GAAG,EAAE;MACjB;MACA,IAAI,CAAC,CAACZ,IAAI,CAACC,WAAW,CAACK,KAAK,CAAC;MAC7BM,GAAG,GAAG,IAAI,CAAC,CAACZ,IAAI,CAACU,WAAW,CAACJ,KAAK,CAAC,CAACO,KAAK,CAAC,CAAC;IAC7C;IACA,OAAOD,GAAG;EACZ;EAEAE,SAASA,CAA+BR,KAAQ,EAAiB;IAC/D,MAAMK,KAAK,GAAG,IAAI,CAAC,CAACX,IAAI,CAACc,SAAS,CAACR,KAAK,CAAC;IACzC,MAAMM,GAAG,GAAGD,KAAK,EAAEE,KAAK,CAAC,CAAC;IAC1B,IAAIF,KAAK,IAAI,CAACC,GAAG,EAAE;MACjB;MACA,IAAI,CAAC,CAACZ,IAAI,CAACC,WAAW,CAACK,KAAK,CAAC;IAC/B;IACA,OAAOM,GAAG;EACZ;EAEAX,WAAWA,CAA+BK,KAAQ,EAAiB;IACjE,OAAO,IAAI,CAAC,CAACN,IAAI,CAACC,WAAW,CAACK,KAAK,CAAC,EAAEO,KAAK,CAAC,CAAC;EAC/C;AACF;AAEA,OAAO,MAAME,oBAAoB,CAAC;EAChC,CAACf,IAAI,GAAG,IAAIJ,WAAW,CACpBU,KAAoB,IAAK;IACxB,MAAMU,KAAK,GAAGV,KAAK,CAACW,MAAM,CACxB,UAASC,MAAM,EAAEC,CAAC,EAAEC,KAAK,EAAEd,KAAK,EAAE;MAChC,IAAIc,KAAK,GAAG,CAAC,KAAK,CAAC,IAAId,KAAK,CAACc,KAAK,CAAC,IAAI,IAAI,EAAE;QAC3CF,MAAM,CAACG,IAAI,CACTf,KAAK,CAACgB,KAAK,CAACF,KAAK,EAAEA,KAAK,GAAG,CAAC,CAC9B,CAAC;MACH;MACA,OAAOF,MAAM;IACf,CAAC,EACD,EACF,CAAC;IACD,IAAIX,IAAI,GAAGb,MAAM,CAAC6B,WAAW,CAACP,KAAK,CAGU;IAE7C,IAAIQ,OAAO,CAACC,GAAG,CAACC,QAAQ,KAAK,YAAY,EAAE;MACzCnB,IAAI,GAAGb,MAAM,CAACiC,MAAM,CAACpB,IAAI,CAAC;IAC5B;IACA,OAAOA,IAAI;EACb,CACF,CAAC;EAEDqB,YAAY,GAGV7B,OAAO,IACJ;IACH,MAAM8B,OAAO,GAAGnC,MAAM,CAACQ,OAAO,CAACH,OAAO,CAAC,CAACI,IAAI,CAAC,CAAC;IAC9C,OAAO,IAAI,CAAC,CAACH,IAAI,CAACU,WAAW,CAACmB,OAAO,CAAC;EACxC,CAAC;AACH","ignoreList":[]}
+{"version":3,"file":"OrderByCanonicalizer.js","names":["WeakRefTrie","OrderByCanonicalizer","trie","array","pairs","reduce","result","_","index","push","slice","data","Object","fromEntries","process","env","NODE_ENV","freeze","canonicalize","orderBy","strings","entries","flat","lookupArray"],"sources":["OrderByCanonicalizer.ts"],"sourcesContent":["/*\n * Copyright 2025 Palantir Technologies, Inc. All rights reserved.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport type { ObjectTypeDefinition } from \"@osdk/api\";\nimport type { OrderBy } from \"../ObservableClient.js\";\nimport type { Canonical } from \"./Canonical.js\";\nimport { WeakRefTrie } from \"./WeakRefTrie.js\";\n\nexport class OrderByCanonicalizer {\n  #trie = new WeakRefTrie(\n    (array: Array<string>) => {\n      const pairs = array.reduce<Array<[string, \"asc\" | \"desc\"]>>(\n        function(result, _, index, array) {\n          if (index % 2 === 0 && array[index] != null) {\n            result.push(\n              array.slice(index, index + 2) as [string, \"asc\" | \"desc\"],\n            );\n          }\n          return result;\n        },\n        [],\n      );\n      let data = Object.fromEntries(pairs) satisfies Record<\n        string,\n        \"asc\" | \"desc\"\n      > as Canonical<OrderBy<ObjectTypeDefinition>>;\n\n      if (process.env.NODE_ENV !== \"production\") {\n        data = Object.freeze(data);\n      }\n      return data;\n    },\n  );\n\n  canonicalize: (\n    orderBy: Record<string, \"asc\" | \"desc\" | undefined>,\n  ) => Canonical<Record<string, \"asc\" | \"desc\" | undefined>> = (\n    orderBy,\n  ) => {\n    const strings = Object.entries(orderBy).flat();\n    return this.#trie.lookupArray(strings);\n  };\n}\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAKA,SAASA,WAAW,QAAQ,kBAAkB;AAE9C,OAAO,MAAMC,oBAAoB,CAAC;EAChC,CAACC,IAAI,GAAG,IAAIF,WAAW,CACpBG,KAAoB,IAAK;IACxB,MAAMC,KAAK,GAAGD,KAAK,CAACE,MAAM,CACxB,UAASC,MAAM,EAAEC,CAAC,EAAEC,KAAK,EAAEL,KAAK,EAAE;MAChC,IAAIK,KAAK,GAAG,CAAC,KAAK,CAAC,IAAIL,KAAK,CAACK,KAAK,CAAC,IAAI,IAAI,EAAE;QAC3CF,MAAM,CAACG,IAAI,CACTN,KAAK,CAACO,KAAK,CAACF,KAAK,EAAEA,KAAK,GAAG,CAAC,CAC9B,CAAC;MACH;MACA,OAAOF,MAAM;IACf,CAAC,EACD,EACF,CAAC;IACD,IAAIK,IAAI,GAAGC,MAAM,CAACC,WAAW,CAACT,KAAK,CAGU;IAE7C,IAAIU,OAAO,CAACC,GAAG,CAACC,QAAQ,KAAK,YAAY,EAAE;MACzCL,IAAI,GAAGC,MAAM,CAACK,MAAM,CAACN,IAAI,CAAC;IAC5B;IACA,OAAOA,IAAI;EACb,CACF,CAAC;EAEDO,YAAY,GAGVC,OAAO,IACJ;IACH,MAAMC,OAAO,GAAGR,MAAM,CAACS,OAAO,CAACF,OAAO,CAAC,CAACG,IAAI,CAAC,CAAC;IAC9C,OAAO,IAAI,CAAC,CAACpB,IAAI,CAACqB,WAAW,CAACH,OAAO,CAAC;EACxC,CAAC;AACH","ignoreList":[]}

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

@@ -0,0 +1,40 @@
+/*
+ * Copyright 2025 Palantir Technologies, Inc. All rights reserved.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+export class Queries {
+  // we can use a regular Map here because the refCounting will
+  // handle cleanup.
+  map = new Map();
+  peek(cacheKey) {
+    return this.map.get(cacheKey);
+  }
+  get(cacheKey, createQuery) {
+    let query = this.peek(cacheKey);
+    if (!query) {
+      query = createQuery();
+      this.map.set(cacheKey, query);
+    }
+    return query;
+  }
+  keys() {
+    return this.map.keys();
+  }
+  delete(cacheKey) {
+    this.map.get(cacheKey)?.dispose();
+    this.map.delete(cacheKey);
+  }
+}
+//# sourceMappingURL=Queries.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Queries.js","names":["Queries","map","Map","peek","cacheKey","get","createQuery","query","set","keys","delete","dispose"],"sources":["Queries.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 { KnownCacheKey } from \"./KnownCacheKey.js\";\nimport type { Query } from \"./Query.js\";\n\nexport class Queries {\n  // we can use a regular Map here because the refCounting will\n  // handle cleanup.\n  map: Map<\n    KnownCacheKey,\n    Query<any, any, any>\n  > = new Map();\n\n  peek<K extends KnownCacheKey>(\n    cacheKey: K,\n  ): K[\"__cacheKey\"][\"query\"] | undefined {\n    return this.map.get(cacheKey) as K[\"__cacheKey\"][\"query\"] | undefined;\n  }\n\n  get<K extends KnownCacheKey>(\n    cacheKey: K,\n    createQuery: () => K[\"__cacheKey\"][\"query\"],\n  ): K[\"__cacheKey\"][\"query\"] {\n    let query = this.peek(cacheKey);\n    if (!query) {\n      query = createQuery();\n      this.map.set(cacheKey, query);\n    }\n    return query;\n  }\n\n  keys(): IterableIterator<KnownCacheKey> {\n    return this.map.keys();\n  }\n\n  delete<K extends KnownCacheKey>(cacheKey: K): void {\n    this.map.get(cacheKey)?.dispose();\n    this.map.delete(cacheKey);\n  }\n}\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAKA,OAAO,MAAMA,OAAO,CAAC;EACnB;EACA;EACAC,GAAG,GAGC,IAAIC,GAAG,CAAC,CAAC;EAEbC,IAAIA,CACFC,QAAW,EAC2B;IACtC,OAAO,IAAI,CAACH,GAAG,CAACI,GAAG,CAACD,QAAQ,CAAC;EAC/B;EAEAC,GAAGA,CACDD,QAAW,EACXE,WAA2C,EACjB;IAC1B,IAAIC,KAAK,GAAG,IAAI,CAACJ,IAAI,CAACC,QAAQ,CAAC;IAC/B,IAAI,CAACG,KAAK,EAAE;MACVA,KAAK,GAAGD,WAAW,CAAC,CAAC;MACrB,IAAI,CAACL,GAAG,CAACO,GAAG,CAACJ,QAAQ,EAAEG,KAAK,CAAC;IAC/B;IACA,OAAOA,KAAK;EACd;EAEAE,IAAIA,CAAA,EAAoC;IACtC,OAAO,IAAI,CAACR,GAAG,CAACQ,IAAI,CAAC,CAAC;EACxB;EAEAC,MAAMA,CAA0BN,QAAW,EAAQ;IACjD,IAAI,CAACH,GAAG,CAACI,GAAG,CAACD,QAAQ,CAAC,EAAEO,OAAO,CAAC,CAAC;IACjC,IAAI,CAACV,GAAG,CAACS,MAAM,CAACN,QAAQ,CAAC;EAC3B;AACF","ignoreList":[]}

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

@@ -20,6 +20,7 @@ export class Query {
   #connectable;
   #subscription;
   #subject;
+  #subscriptionDedupeIntervals = new Map();
 
   /** @internal */
 
@@ -27,6 +28,7 @@ export class Query {
     this.options = opts;
     this.cacheKey = cacheKey;
     this.store = store;
+    this.cacheKeys = store.cacheKeys;
     this.#subject = observable;
     this.logger = logger ?? (process.env.NODE_ENV === "production" ? store.client[additionalContext].logger : store.client[additionalContext].logger?.child({}, {
       msgPrefix: process.env.NODE_ENV !== "production" ? `Query<${cacheKey.type}, ${cacheKey.otherKeys.map(x => JSON.stringify(x)).join(", ")}>` : "Query"
@@ -38,6 +40,32 @@ export class Query {
     return this.#connectable.subscribe(observer);
   }
 
+  /**
+   * Register a subscription's dedupeInterval value
+   */
+  registerSubscriptionDedupeInterval(subscriptionId, dedupeInterval) {
+    if (dedupeInterval != null && dedupeInterval > 0) {
+      this.#subscriptionDedupeIntervals.set(subscriptionId, dedupeInterval);
+    }
+  }
+
+  /**
+   * Unregister a subscription's dedupeInterval value
+   */
+  unregisterSubscriptionDedupeInterval(subscriptionId) {
+    this.#subscriptionDedupeIntervals.delete(subscriptionId);
+  }
+
+  /**
+   * Get the minimum dedupeInterval from all active subscriptions
+   */
+  getMinimumDedupeInterval() {
+    if (this.#subscriptionDedupeIntervals.size === 0) {
+      return this.options.dedupeInterval ?? 0;
+    }
+    return Math.min(...this.#subscriptionDedupeIntervals.values());
+  }
+
   /**
    * Causes the query to revalidate. This will cause the query to fetch
    * the latest data from the server and update the store if it is deemed
@@ -66,7 +94,8 @@ export class Query {
       await this.pendingFetch;
       return;
     }
-    if ((this.options.dedupeInterval ?? 0) > 0 && this.lastFetchStarted != null && Date.now() - this.lastFetchStarted < (this.options.dedupeInterval ?? 0)) {
+    const minDedupeInterval = this.getMinimumDedupeInterval();
+    if (minDedupeInterval > 0 && this.lastFetchStarted != null && Date.now() - this.lastFetchStarted < minDedupeInterval) {
       if (process.env.NODE_ENV !== "production") {
         logger?.debug("Within dupeInterval, aborting revalidate");
       }
@@ -88,7 +117,7 @@ export class Query {
       logger?.debug("calling _fetchAndStore()");
     }
     this.pendingFetch = this._fetchAndStore().finally(() => {
-      logger?.debug("finally _fetchAndStore()");
+      logger?.debug("promise's finally for _fetchAndStore()");
       this.pendingFetch = undefined;
     });
     await this.pendingFetch;
@@ -105,10 +134,22 @@ export class Query {
     if (process.env.NODE_ENV !== "production") {
       this.logger?.child({
         methodName: "setStatus"
-      }).debug(status);
+      }).debug(`Attempting to set status to '${status}'`);
     }
     const existing = batch.read(this.cacheKey);
-    if (existing?.status === status) return;
+    if (existing?.status === status) {
+      if (process.env.NODE_ENV !== "production") {
+        this.logger?.child({
+          methodName: "setStatus"
+        }).debug(`Status is already set to '${status}'; aborting`);
+      }
+      return;
+    }
+    if (process.env.NODE_ENV !== "production") {
+      this.logger?.child({
+        methodName: "setStatus"
+      }).debug(`Writing status '${status}' to cache`);
+    }
     batch.write(this.cacheKey, existing?.value, status);
   }
   dispose() {

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

@@ -1 +1 @@
-{"version":3,"file":"Query.js","names":["additionalContext","Query","retainCount","connectable","subscription","subject","constructor","store","observable","opts","cacheKey","logger","options","process","env","NODE_ENV","client","child","msgPrefix","type","otherKeys","map","x","JSON","stringify","join","subscribe","observer","_createConnectable","connect","revalidate","force","methodName","abortController","abort","pendingFetch","debug","dedupeInterval","lastFetchStarted","Date","now","Promise","resolve","batch","setStatus","_preFetch","_fetchAndStore","finally","undefined","status","existing","read","write","value","dispose","unsubscribe","_dispose"],"sources":["Query.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 } from \"@osdk/api\";\nimport type {\n  Connectable,\n  Observable,\n  Observer,\n  Subscribable,\n  Subscription,\n} from \"rxjs\";\nimport { additionalContext } from \"../../Client.js\";\nimport type { CommonObserveOptions, Status } from \"../ObservableClient.js\";\nimport type { CacheKey } from \"./CacheKey.js\";\nimport type { Changes } from \"./Changes.js\";\nimport type { Entry } from \"./Layer.js\";\nimport type { OptimisticId } from \"./OptimisticId.js\";\nimport type { BatchContext, Store, SubjectPayload } from \"./Store.js\";\n\nexport abstract class Query<\n  KEY extends CacheKey,\n  PAYLOAD,\n  O extends CommonObserveOptions,\n> implements Subscribable<PAYLOAD> {\n  lastFetchStarted?: number;\n  pendingFetch?: Promise<unknown>;\n  retainCount: number = 0;\n  options: O;\n  cacheKey: KEY;\n  store: Store;\n  abortController?: AbortController;\n  #connectable?: Connectable<PAYLOAD>;\n  #subscription?: Subscription;\n  #subject: Observable<SubjectPayload<KEY>>;\n\n  /** @internal */\n  protected logger: Logger | undefined;\n\n  constructor(\n    store: Store,\n    observable: Observable<SubjectPayload<KEY>>,\n    opts: O,\n    cacheKey: KEY,\n    logger?: Logger,\n  ) {\n    this.options = opts;\n    this.cacheKey = cacheKey;\n    this.store = store;\n    this.#subject = observable;\n\n    this.logger = logger ?? (\n      process.env.NODE_ENV === \"production\"\n        ? store.client[additionalContext].logger\n        : store.client[additionalContext].logger?.child({}, {\n          msgPrefix: process.env.NODE_ENV !== \"production\"\n            ? (`Query<${cacheKey.type}, ${\n              cacheKey.otherKeys.map(x => JSON.stringify(x)).join(\", \")\n            }>`)\n            : \"Query\",\n        })\n    );\n  }\n\n  protected abstract _createConnectable(\n    subject: Observable<SubjectPayload<KEY>>,\n  ): Connectable<PAYLOAD>;\n\n  public subscribe(\n    observer: Observer<PAYLOAD>,\n  ): Subscription {\n    this.#connectable ??= this._createConnectable(this.#subject);\n    this.#subscription = this.#connectable.connect();\n    return this.#connectable.subscribe(observer);\n  }\n\n  /**\n   * Causes the query to revalidate. This will cause the query to fetch\n   * the latest data from the server and update the store if it is deemed\n   * \"stale\" or if `force` is true.\n   *\n   * @param force\n   * @returns\n   */\n  async revalidate(force?: boolean): Promise<void> {\n    const logger = process.env.NODE_ENV !== \"production\"\n      ? this.logger?.child({ methodName: \"revalidate\" })\n      : this.logger;\n\n    if (force) {\n      this.abortController?.abort();\n    }\n\n    // n.b. I think this isn't quite right since we may require multiple\n    // pages to properly \"revalidate\" for someone. This only really works if you\n    // have a single page/object. It needs to be redone. FIXME\n\n    // if we are pending the first page/object we can just ignore this\n    if (this.pendingFetch) {\n      if (process.env.NODE_ENV !== \"production\") {\n        logger?.debug(\"Fetch is already pending, using it\");\n      }\n      await this.pendingFetch;\n      return;\n    }\n\n    if (\n      (this.options.dedupeInterval ?? 0) > 0 && (\n        this.lastFetchStarted != null\n        && Date.now() - this.lastFetchStarted < (this.options.dedupeInterval\n            ?? 0)\n      )\n    ) {\n      if (process.env.NODE_ENV !== \"production\") {\n        logger?.debug(\"Within dupeInterval, aborting revalidate\");\n      }\n\n      return Promise.resolve();\n    }\n\n    if (process.env.NODE_ENV !== \"production\") {\n      logger?.debug(\"Starting actual revalidate\");\n    }\n\n    this.store.batch({}, (batch) => {\n      // make sure the truth layer knows we are loading\n\n      // this will not trigger an update to `changes` so it cannot trigger an\n      // update of a list either. This may not be the behavior we want.\n      this.setStatus(\"loading\", batch);\n    });\n\n    this._preFetch();\n\n    this.lastFetchStarted = Date.now();\n\n    if (process.env.NODE_ENV !== \"production\") {\n      logger?.debug(\"calling _fetchAndStore()\");\n    }\n    this.pendingFetch = this._fetchAndStore()\n      .finally(() => {\n        logger?.debug(\"finally _fetchAndStore()\");\n        this.pendingFetch = undefined;\n      });\n\n    await this.pendingFetch;\n    return;\n  }\n\n  protected _preFetch(): void {}\n\n  protected abstract _fetchAndStore(): Promise<unknown>;\n\n  /**\n   * Sets the status of the query in the store (but does not store that in `changes`).\n   *\n   * @param status\n   * @param batch\n   * @returns\n   */\n  setStatus(\n    status: Status,\n    batch: BatchContext,\n  ): void {\n    if (process.env.NODE_ENV !== \"production\") {\n      this.logger?.child({ methodName: \"setStatus\" }).debug(status);\n    }\n    const existing = batch.read(this.cacheKey);\n    if (existing?.status === status) return;\n\n    batch.write(this.cacheKey, existing?.value, status);\n  }\n\n  dispose(): void {\n    if (this.abortController) {\n      this.abortController.abort();\n    }\n    this.#subscription?.unsubscribe();\n    this._dispose();\n  }\n\n  /**\n   * Per query type dispose functionality\n   */\n  protected _dispose(): void {}\n\n  /**\n   * The purpose of this method is to provide a way for others to write\n   * directly into the store for this query.\n   *\n   * @param data\n   * @param status\n   * @param batch\n   */\n  abstract writeToStore(\n    data: KEY[\"__cacheKey\"][\"value\"],\n    status: Status,\n    batch: BatchContext,\n  ): Entry<KEY>;\n\n  /**\n   * @param changes\n   * @param optimisticId\n   * @returns If revalidation is needed, a promise that resolves after the\n   *          revalidation is complete. Otherwise, undefined.\n   */\n  maybeUpdateAndRevalidate?: (\n    changes: Changes,\n    optimisticId: OptimisticId | undefined,\n  ) => Promise<void> | undefined;\n}\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAUA,SAASA,iBAAiB,QAAQ,iBAAiB;AAQnD,OAAO,MAAeC,KAAK,CAIQ;EAGjCC,WAAW,GAAW,CAAC;EAKvB,CAACC,WAAW;EACZ,CAACC,YAAY;EACb,CAACC,OAAO;;EAER;;EAGAC,WAAWA,CACTC,KAAY,EACZC,UAA2C,EAC3CC,IAAO,EACPC,QAAa,EACbC,MAAe,EACf;IACA,IAAI,CAACC,OAAO,GAAGH,IAAI;IACnB,IAAI,CAACC,QAAQ,GAAGA,QAAQ;IACxB,IAAI,CAACH,KAAK,GAAGA,KAAK;IAClB,IAAI,CAAC,CAACF,OAAO,GAAGG,UAAU;IAE1B,IAAI,CAACG,MAAM,GAAGA,MAAM,KAClBE,OAAO,CAACC,GAAG,CAACC,QAAQ,KAAK,YAAY,GACjCR,KAAK,CAACS,MAAM,CAAChB,iBAAiB,CAAC,CAACW,MAAM,GACtCJ,KAAK,CAACS,MAAM,CAAChB,iBAAiB,CAAC,CAACW,MAAM,EAAEM,KAAK,CAAC,CAAC,CAAC,EAAE;MAClDC,SAAS,EAAEL,OAAO,CAACC,GAAG,CAACC,QAAQ,KAAK,YAAY,GAC3C,SAASL,QAAQ,CAACS,IAAI,KACvBT,QAAQ,CAACU,SAAS,CAACC,GAAG,CAACC,CAAC,IAAIC,IAAI,CAACC,SAAS,CAACF,CAAC,CAAC,CAAC,CAACG,IAAI,CAAC,IAAI,CAAC,GACxD,GACD;IACN,CAAC,CAAC,CACL;EACH;EAMOC,SAASA,CACdC,QAA2B,EACb;IACd,IAAI,CAAC,CAACxB,WAAW,KAAK,IAAI,CAACyB,kBAAkB,CAAC,IAAI,CAAC,CAACvB,OAAO,CAAC;IAC5D,IAAI,CAAC,CAACD,YAAY,GAAG,IAAI,CAAC,CAACD,WAAW,CAAC0B,OAAO,CAAC,CAAC;IAChD,OAAO,IAAI,CAAC,CAAC1B,WAAW,CAACuB,SAAS,CAACC,QAAQ,CAAC;EAC9C;;EAEA;AACF;AACA;AACA;AACA;AACA;AACA;AACA;EACE,MAAMG,UAAUA,CAACC,KAAe,EAAiB;IAC/C,MAAMpB,MAAM,GAAGE,OAAO,CAACC,GAAG,CAACC,QAAQ,KAAK,YAAY,GAChD,IAAI,CAACJ,MAAM,EAAEM,KAAK,CAAC;MAAEe,UAAU,EAAE;IAAa,CAAC,CAAC,GAChD,IAAI,CAACrB,MAAM;IAEf,IAAIoB,KAAK,EAAE;MACT,IAAI,CAACE,eAAe,EAAEC,KAAK,CAAC,CAAC;IAC/B;;IAEA;IACA;IACA;;IAEA;IACA,IAAI,IAAI,CAACC,YAAY,EAAE;MACrB,IAAItB,OAAO,CAACC,GAAG,CAACC,QAAQ,KAAK,YAAY,EAAE;QACzCJ,MAAM,EAAEyB,KAAK,CAAC,oCAAoC,CAAC;MACrD;MACA,MAAM,IAAI,CAACD,YAAY;MACvB;IACF;IAEA,IACE,CAAC,IAAI,CAACvB,OAAO,CAACyB,cAAc,IAAI,CAAC,IAAI,CAAC,IACpC,IAAI,CAACC,gBAAgB,IAAI,IAAI,IAC1BC,IAAI,CAACC,GAAG,CAAC,CAAC,GAAG,IAAI,CAACF,gBAAgB,IAAI,IAAI,CAAC1B,OAAO,CAACyB,cAAc,IAC7D,CAAC,CACT,EACD;MACA,IAAIxB,OAAO,CAACC,GAAG,CAACC,QAAQ,KAAK,YAAY,EAAE;QACzCJ,MAAM,EAAEyB,KAAK,CAAC,0CAA0C,CAAC;MAC3D;MAEA,OAAOK,OAAO,CAACC,OAAO,CAAC,CAAC;IAC1B;IAEA,IAAI7B,OAAO,CAACC,GAAG,CAACC,QAAQ,KAAK,YAAY,EAAE;MACzCJ,MAAM,EAAEyB,KAAK,CAAC,4BAA4B,CAAC;IAC7C;IAEA,IAAI,CAAC7B,KAAK,CAACoC,KAAK,CAAC,CAAC,CAAC,EAAGA,KAAK,IAAK;MAC9B;;MAEA;MACA;MACA,IAAI,CAACC,SAAS,CAAC,SAAS,EAAED,KAAK,CAAC;IAClC,CAAC,CAAC;IAEF,IAAI,CAACE,SAAS,CAAC,CAAC;IAEhB,IAAI,CAACP,gBAAgB,GAAGC,IAAI,CAACC,GAAG,CAAC,CAAC;IAElC,IAAI3B,OAAO,CAACC,GAAG,CAACC,QAAQ,KAAK,YAAY,EAAE;MACzCJ,MAAM,EAAEyB,KAAK,CAAC,0BAA0B,CAAC;IAC3C;IACA,IAAI,CAACD,YAAY,GAAG,IAAI,CAACW,cAAc,CAAC,CAAC,CACtCC,OAAO,CAAC,MAAM;MACbpC,MAAM,EAAEyB,KAAK,CAAC,0BAA0B,CAAC;MACzC,IAAI,CAACD,YAAY,GAAGa,SAAS;IAC/B,CAAC,CAAC;IAEJ,MAAM,IAAI,CAACb,YAAY;EAEzB;EAEUU,SAASA,CAAA,EAAS,CAAC;EAI7B;AACF;AACA;AACA;AACA;AACA;AACA;EACED,SAASA,CACPK,MAAc,EACdN,KAAmB,EACb;IACN,IAAI9B,OAAO,CAACC,GAAG,CAACC,QAAQ,KAAK,YAAY,EAAE;MACzC,IAAI,CAACJ,MAAM,EAAEM,KAAK,CAAC;QAAEe,UAAU,EAAE;MAAY,CAAC,CAAC,CAACI,KAAK,CAACa,MAAM,CAAC;IAC/D;IACA,MAAMC,QAAQ,GAAGP,KAAK,CAACQ,IAAI,CAAC,IAAI,CAACzC,QAAQ,CAAC;IAC1C,IAAIwC,QAAQ,EAAED,MAAM,KAAKA,MAAM,EAAE;IAEjCN,KAAK,CAACS,KAAK,CAAC,IAAI,CAAC1C,QAAQ,EAAEwC,QAAQ,EAAEG,KAAK,EAAEJ,MAAM,CAAC;EACrD;EAEAK,OAAOA,CAAA,EAAS;IACd,IAAI,IAAI,CAACrB,eAAe,EAAE;MACxB,IAAI,CAACA,eAAe,CAACC,KAAK,CAAC,CAAC;IAC9B;IACA,IAAI,CAAC,CAAC9B,YAAY,EAAEmD,WAAW,CAAC,CAAC;IACjC,IAAI,CAACC,QAAQ,CAAC,CAAC;EACjB;;EAEA;AACF;AACA;EACYA,QAAQA,CAAA,EAAS,CAAC;;EAE5B;AACF;AACA;AACA;AACA;AACA;AACA;AACA;;EAOE;AACF;AACA;AACA;AACA;AACA;AAKA","ignoreList":[]}
+{"version":3,"file":"Query.js","names":["additionalContext","Query","retainCount","connectable","subscription","subject","subscriptionDedupeIntervals","Map","constructor","store","observable","opts","cacheKey","logger","options","cacheKeys","process","env","NODE_ENV","client","child","msgPrefix","type","otherKeys","map","x","JSON","stringify","join","subscribe","observer","_createConnectable","connect","registerSubscriptionDedupeInterval","subscriptionId","dedupeInterval","set","unregisterSubscriptionDedupeInterval","delete","getMinimumDedupeInterval","size","Math","min","values","revalidate","force","methodName","abortController","abort","pendingFetch","debug","minDedupeInterval","lastFetchStarted","Date","now","Promise","resolve","batch","setStatus","_preFetch","_fetchAndStore","finally","undefined","status","existing","read","write","value","dispose","unsubscribe","_dispose"],"sources":["Query.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 } from \"@osdk/api\";\nimport type {\n  Connectable,\n  Observable,\n  Observer,\n  Subscribable,\n  Subscription,\n} from \"rxjs\";\nimport { additionalContext } from \"../../Client.js\";\nimport type {\n  CommonObserveOptions,\n  Status,\n} from \"../ObservableClient/common.js\";\nimport type { BatchContext } from \"./BatchContext.js\";\nimport type { CacheKeys } from \"./CacheKeys.js\";\nimport type { Changes } from \"./Changes.js\";\nimport type { KnownCacheKey } from \"./KnownCacheKey.js\";\nimport type { Entry } from \"./Layer.js\";\nimport type { OptimisticId } from \"./OptimisticId.js\";\nimport type { Store } from \"./Store.js\";\nimport type { SubjectPayload } from \"./SubjectPayload.js\";\n\nexport abstract class Query<\n  KEY extends KnownCacheKey,\n  PAYLOAD,\n  O extends CommonObserveOptions,\n> implements Subscribable<PAYLOAD> {\n  lastFetchStarted?: number;\n  pendingFetch?: Promise<void>;\n  retainCount: number = 0;\n  options: O;\n  cacheKey: KEY;\n  store: Store;\n  abortController?: AbortController;\n  #connectable?: Connectable<PAYLOAD>;\n  #subscription?: Subscription;\n  #subject: Observable<SubjectPayload<KEY>>;\n  #subscriptionDedupeIntervals: Map<string, number> = new Map();\n\n  /** @internal */\n  protected logger: Logger | undefined;\n\n  protected readonly cacheKeys: CacheKeys<KnownCacheKey>;\n\n  constructor(\n    store: Store,\n    observable: Observable<SubjectPayload<KEY>>,\n    opts: O,\n    cacheKey: KEY,\n    logger?: Logger,\n  ) {\n    this.options = opts;\n    this.cacheKey = cacheKey;\n    this.store = store;\n    this.cacheKeys = store.cacheKeys;\n    this.#subject = observable;\n\n    this.logger = logger ?? (\n      process.env.NODE_ENV === \"production\"\n        ? store.client[additionalContext].logger\n        : store.client[additionalContext].logger?.child({}, {\n          msgPrefix: process.env.NODE_ENV !== \"production\"\n            ? (`Query<${cacheKey.type}, ${\n              cacheKey.otherKeys.map(x => JSON.stringify(x)).join(\", \")\n            }>`)\n            : \"Query\",\n        })\n    );\n  }\n\n  protected abstract _createConnectable(\n    subject: Observable<SubjectPayload<KEY>>,\n  ): Connectable<PAYLOAD>;\n\n  public subscribe(\n    observer: Observer<PAYLOAD>,\n  ): Subscription {\n    this.#connectable ??= this._createConnectable(this.#subject);\n    this.#subscription = this.#connectable.connect();\n    return this.#connectable.subscribe(observer);\n  }\n\n  /**\n   * Register a subscription's dedupeInterval value\n   */\n  registerSubscriptionDedupeInterval(\n    subscriptionId: string,\n    dedupeInterval: number | undefined,\n  ): void {\n    if (dedupeInterval != null && dedupeInterval > 0) {\n      this.#subscriptionDedupeIntervals.set(subscriptionId, dedupeInterval);\n    }\n  }\n\n  /**\n   * Unregister a subscription's dedupeInterval value\n   */\n  unregisterSubscriptionDedupeInterval(subscriptionId: string): void {\n    this.#subscriptionDedupeIntervals.delete(subscriptionId);\n  }\n\n  /**\n   * Get the minimum dedupeInterval from all active subscriptions\n   */\n  private getMinimumDedupeInterval(): number {\n    if (this.#subscriptionDedupeIntervals.size === 0) {\n      return this.options.dedupeInterval ?? 0;\n    }\n\n    return Math.min(...this.#subscriptionDedupeIntervals.values());\n  }\n\n  /**\n   * Causes the query to revalidate. This will cause the query to fetch\n   * the latest data from the server and update the store if it is deemed\n   * \"stale\" or if `force` is true.\n   *\n   * @param force\n   * @returns\n   */\n  async revalidate(force?: boolean): Promise<void> {\n    const logger = process.env.NODE_ENV !== \"production\"\n      ? this.logger?.child({ methodName: \"revalidate\" })\n      : this.logger;\n\n    if (force) {\n      this.abortController?.abort();\n    }\n\n    // n.b. I think this isn't quite right since we may require multiple\n    // pages to properly \"revalidate\" for someone. This only really works if you\n    // have a single page/object. It needs to be redone. FIXME\n\n    // if we are pending the first page/object we can just ignore this\n    if (this.pendingFetch) {\n      if (process.env.NODE_ENV !== \"production\") {\n        logger?.debug(\"Fetch is already pending, using it\");\n      }\n      await this.pendingFetch;\n      return;\n    }\n\n    const minDedupeInterval = this.getMinimumDedupeInterval();\n    if (\n      minDedupeInterval > 0 && (\n        this.lastFetchStarted != null\n        && Date.now() - this.lastFetchStarted < minDedupeInterval\n      )\n    ) {\n      if (process.env.NODE_ENV !== \"production\") {\n        logger?.debug(\"Within dupeInterval, aborting revalidate\");\n      }\n\n      return Promise.resolve();\n    }\n\n    if (process.env.NODE_ENV !== \"production\") {\n      logger?.debug(\"Starting actual revalidate\");\n    }\n\n    this.store.batch({}, (batch) => {\n      // make sure the truth layer knows we are loading\n\n      // this will not trigger an update to `changes` so it cannot trigger an\n      // update of a list either. This may not be the behavior we want.\n      this.setStatus(\"loading\", batch);\n    });\n\n    this._preFetch();\n\n    this.lastFetchStarted = Date.now();\n\n    if (process.env.NODE_ENV !== \"production\") {\n      logger?.debug(\"calling _fetchAndStore()\");\n    }\n    this.pendingFetch = this._fetchAndStore()\n      .finally(() => {\n        logger?.debug(\"promise's finally for _fetchAndStore()\");\n        this.pendingFetch = undefined;\n      });\n\n    await this.pendingFetch;\n    return;\n  }\n\n  protected _preFetch(): void {}\n\n  protected abstract _fetchAndStore(): Promise<void>;\n\n  /**\n   * Sets the status of the query in the store (but does not store that in `changes`).\n   *\n   * @param status\n   * @param batch\n   * @returns\n   */\n  setStatus(\n    status: Status,\n    batch: BatchContext,\n  ): void {\n    if (process.env.NODE_ENV !== \"production\") {\n      this.logger?.child({ methodName: \"setStatus\" }).debug(\n        `Attempting to set status to '${status}'`,\n      );\n    }\n    const existing = batch.read(this.cacheKey);\n    if (existing?.status === status) {\n      if (process.env.NODE_ENV !== \"production\") {\n        this.logger?.child({ methodName: \"setStatus\" }).debug(\n          `Status is already set to '${status}'; aborting`,\n        );\n      }\n      return;\n    }\n\n    if (process.env.NODE_ENV !== \"production\") {\n      this.logger?.child({ methodName: \"setStatus\" }).debug(\n        `Writing status '${status}' to cache`,\n      );\n    }\n    batch.write(this.cacheKey, existing?.value, status);\n  }\n\n  dispose(): void {\n    if (this.abortController) {\n      this.abortController.abort();\n    }\n    this.#subscription?.unsubscribe();\n    this._dispose();\n  }\n\n  /**\n   * Per query type dispose functionality\n   */\n  protected _dispose(): void {}\n\n  /**\n   * The purpose of this method is to provide a way for others to write\n   * directly into the store for this query.\n   *\n   * @param data\n   * @param status\n   * @param batch\n   */\n  abstract writeToStore(\n    data: KEY[\"__cacheKey\"][\"value\"],\n    status: Status,\n    batch: BatchContext,\n  ): Entry<KEY>;\n\n  /**\n   * @param changes\n   * @param optimisticId\n   * @returns If revalidation is needed, a promise that resolves after the\n   *          revalidation is complete. Otherwise, undefined.\n   */\n  maybeUpdateAndRevalidate?: (\n    changes: Changes,\n    optimisticId: OptimisticId | undefined,\n  ) => Promise<void> | undefined;\n\n  abstract invalidateObjectType(\n    objectType: string,\n    changes: Changes | undefined,\n  ): Promise<void>;\n}\n"],"mappings":"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","ignoreList":[]}