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

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

@@ -0,0 +1 @@
+{"version":3,"file":"OrderByCanonicalizer.test.js","names":["setFlagsFromString","describe","expect","it","vi","runInNewContext","OrderByCanonicalizer","obc","canon1","canonicalize","a","b","canon2","toBe","toEqual","canonShort","canonLong","c","not","callback","fn","args","console","log","f","FinalizationRegistry","register","undefined","gc","waitFor","toHaveBeenCalledExactlyOnceWith"],"sources":["OrderByCanonicalizer.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 { setFlagsFromString } from \"v8\";\nimport { describe, expect, it, vi } from \"vitest\";\nimport { runInNewContext } from \"vm\";\nimport { OrderByCanonicalizer } from \"./OrderByCanonicalizer.js\";\n\ndescribe(OrderByCanonicalizer, () => {\n  it(\"it canonicalizes\", () => {\n    const obc = new OrderByCanonicalizer();\n    const canon1 = obc.canonicalize({ a: \"asc\", b: \"desc\" });\n    const canon2 = obc.canonicalize({ a: \"asc\", b: \"desc\" });\n\n    // Ref equal\n    expect(canon1).toBe(canon2);\n\n    // Deep equal\n    expect(canon1).toEqual({ a: \"asc\", b: \"desc\" });\n\n    const canonShort = obc.canonicalize({ a: \"asc\" });\n    const canonLong = obc.canonicalize({ a: \"asc\", b: \"desc\", c: \"asc\" });\n\n    expect(canonShort).not.toEqual(canon1);\n    expect(canonLong).not.toEqual(canon1);\n  });\n\n  it(\"cleans up\", async () => {\n    const callback = vi.fn((...args: any[]) => {\n      console.log(\"args\", args);\n    });\n    const f = new FinalizationRegistry(callback);\n    const obc = new OrderByCanonicalizer();\n    {\n      let canon1 = obc.canonicalize({ a: \"asc\" });\n      expect(canon1).toEqual({ a: \"asc\" });\n      f.register(canon1, \"hi\");\n      canon1 = undefined as any;\n    }\n\n    // enabling trace-gc\n    setFlagsFromString(\"--expose_gc\");\n    const gc = runInNewContext(\"gc\");\n\n    await vi.waitFor(() => {\n      gc();\n      expect(callback).toHaveBeenCalledExactlyOnceWith(\"hi\");\n    });\n  });\n});\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA,SAASA,kBAAkB,QAAQ,IAAI;AACvC,SAASC,QAAQ,EAAEC,MAAM,EAAEC,EAAE,EAAEC,EAAE,QAAQ,QAAQ;AACjD,SAASC,eAAe,QAAQ,IAAI;AACpC,SAASC,oBAAoB,QAAQ,2BAA2B;AAEhEL,QAAQ,CAACK,oBAAoB,EAAE,MAAM;EACnCH,EAAE,CAAC,kBAAkB,EAAE,MAAM;IAC3B,MAAMI,GAAG,GAAG,IAAID,oBAAoB,CAAC,CAAC;IACtC,MAAME,MAAM,GAAGD,GAAG,CAACE,YAAY,CAAC;MAAEC,CAAC,EAAE,KAAK;MAAEC,CAAC,EAAE;IAAO,CAAC,CAAC;IACxD,MAAMC,MAAM,GAAGL,GAAG,CAACE,YAAY,CAAC;MAAEC,CAAC,EAAE,KAAK;MAAEC,CAAC,EAAE;IAAO,CAAC,CAAC;;IAExD;IACAT,MAAM,CAACM,MAAM,CAAC,CAACK,IAAI,CAACD,MAAM,CAAC;;IAE3B;IACAV,MAAM,CAACM,MAAM,CAAC,CAACM,OAAO,CAAC;MAAEJ,CAAC,EAAE,KAAK;MAAEC,CAAC,EAAE;IAAO,CAAC,CAAC;IAE/C,MAAMI,UAAU,GAAGR,GAAG,CAACE,YAAY,CAAC;MAAEC,CAAC,EAAE;IAAM,CAAC,CAAC;IACjD,MAAMM,SAAS,GAAGT,GAAG,CAACE,YAAY,CAAC;MAAEC,CAAC,EAAE,KAAK;MAAEC,CAAC,EAAE,MAAM;MAAEM,CAAC,EAAE;IAAM,CAAC,CAAC;IAErEf,MAAM,CAACa,UAAU,CAAC,CAACG,GAAG,CAACJ,OAAO,CAACN,MAAM,CAAC;IACtCN,MAAM,CAACc,SAAS,CAAC,CAACE,GAAG,CAACJ,OAAO,CAACN,MAAM,CAAC;EACvC,CAAC,CAAC;EAEFL,EAAE,CAAC,WAAW,EAAE,YAAY;IAC1B,MAAMgB,QAAQ,GAAGf,EAAE,CAACgB,EAAE,CAAC,CAAC,GAAGC,IAAW,KAAK;MACzCC,OAAO,CAACC,GAAG,CAAC,MAAM,EAAEF,IAAI,CAAC;IAC3B,CAAC,CAAC;IACF,MAAMG,CAAC,GAAG,IAAIC,oBAAoB,CAACN,QAAQ,CAAC;IAC5C,MAAMZ,GAAG,GAAG,IAAID,oBAAoB,CAAC,CAAC;IACtC;MACE,IAAIE,MAAM,GAAGD,GAAG,CAACE,YAAY,CAAC;QAAEC,CAAC,EAAE;MAAM,CAAC,CAAC;MAC3CR,MAAM,CAACM,MAAM,CAAC,CAACM,OAAO,CAAC;QAAEJ,CAAC,EAAE;MAAM,CAAC,CAAC;MACpCc,CAAC,CAACE,QAAQ,CAAClB,MAAM,EAAE,IAAI,CAAC;MACxBA,MAAM,GAAGmB,SAAgB;IAC3B;;IAEA;IACA3B,kBAAkB,CAAC,aAAa,CAAC;IACjC,MAAM4B,EAAE,GAAGvB,eAAe,CAAC,IAAI,CAAC;IAEhC,MAAMD,EAAE,CAACyB,OAAO,CAAC,MAAM;MACrBD,EAAE,CAAC,CAAC;MACJ1B,MAAM,CAACiB,QAAQ,CAAC,CAACW,+BAA+B,CAAC,IAAI,CAAC;IACxD,CAAC,CAAC;EACJ,CAAC,CAAC;AACJ,CAAC,CAAC","ignoreList":[]}

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

@@ -37,62 +37,75 @@ export class Query {
     this.#subscription = this.#connectable.connect();
     return this.#connectable.subscribe(observer);
   }
-  revalidate(force) {
-    if (process.env.NODE_ENV !== "production") {
-      this.logger?.info({
-        methodName: "revalidate"
-      });
-    }
+
+  /**
+   * 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
+   * "stale" or if `force` is true.
+   *
+   * @param force
+   * @returns
+   */
+  async revalidate(force) {
+    const logger = process.env.NODE_ENV !== "production" ? this.logger?.child({
+      methodName: "revalidate"
+    }) : this.logger;
     if (force) {
       this.abortController?.abort();
     }
 
-    // if we are pending the first page we can just ignore this
+    // n.b. I think this isn't quite right since we may require multiple
+    // pages to properly "revalidate" for someone. This only really works if you
+    // have a single page/object. It needs to be redone. FIXME
+
+    // if we are pending the first page/object we can just ignore this
     if (this.pendingFetch) {
-      return this.pendingFetch;
+      if (process.env.NODE_ENV !== "production") {
+        logger?.info("Fetch is already pending, using it");
+      }
+      await this.pendingFetch;
+      return;
     }
     if ((this.options.dedupeInterval ?? 0) > 0 && this.lastFetchStarted != null && Date.now() - this.lastFetchStarted < (this.options.dedupeInterval ?? 0)) {
       if (process.env.NODE_ENV !== "production") {
-        this.logger?.trace({
-          methodName: "revalidate"
-        }, "DEDUPE");
+        logger?.debug("Within dupeInterval, aborting revalidate");
       }
       return Promise.resolve();
     }
+    if (process.env.NODE_ENV !== "production") {
+      logger?.debug("Starting actual revalidate");
+    }
     this.store.batch({}, batch => {
+      // make sure the truth layer knows we are loading
+
+      // this will not trigger an update to `changes` so it cannot trigger an
+      // update of a list either. This may not be the behavior we want.
       this.setStatus("loading", batch);
     });
     this._preFetch();
     this.lastFetchStarted = Date.now();
     if (process.env.NODE_ENV !== "production") {
-      this.logger?.trace({
-        methodName: "revalidate"
-      }, "calling _fetch()");
+      logger?.debug("calling _fetchAndStore()");
     }
-    this.pendingFetch = this._fetch().catch(e => {
-      this.logger?.error({
-        methodName: "revalidate"
-      }, "_fetch() FAILED", e);
-      throw e;
-    }).finally(() => {
-      this.logger?.info({
-        methodName: "revalidate"
-      }, "finally _fetch()");
+    this.pendingFetch = this._fetchAndStore().finally(() => {
+      logger?.info("finally _fetchAndStore()");
       this.pendingFetch = undefined;
     });
-    if (process.env.NODE_ENV !== "production") {
-      this.logger?.info({
-        methodName: "revalidate"
-      }, "Returning");
-    }
-    return this.pendingFetch;
+    await this.pendingFetch;
   }
   _preFetch() {}
+  /**
+   * Sets the status of the query in the store (but does not store that in `changes`).
+   *
+   * @param status
+   * @param batch
+   * @returns
+   */
   setStatus(status, batch) {
     if (process.env.NODE_ENV !== "production") {
-      this.logger?.trace({
+      this.logger?.child({
         methodName: "setStatus"
-      }, status);
+      }).debug(status);
     }
     const existing = batch.read(this.cacheKey);
     if (existing?.status === status) return;
@@ -105,6 +118,26 @@ export class Query {
     this.#subscription?.unsubscribe();
     this._dispose();
   }
+
+  /**
+   * Per query type dispose functionality
+   */
   _dispose() {}
+
+  /**
+   * The purpose of this method is to provide a way for others to write
+   * directly into the store for this query.
+   *
+   * @param data
+   * @param status
+   * @param batch
+   */
+
+  /**
+   * @param changes
+   * @param optimisticId
+   * @returns If revalidation is needed, a promise that resolves after the
+   *          revalidation is complete. Otherwise, undefined.
+   */
 }
 //# sourceMappingURL=Query.js.map

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","info","methodName","abortController","abort","pendingFetch","dedupeInterval","lastFetchStarted","Date","now","trace","Promise","resolve","batch","setStatus","_preFetch","_fetch","catch","e","error","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 {\n  Connectable,\n  Observable,\n  Observer,\n  Subscribable,\n  Subscription,\n} from \"rxjs\";\nimport { additionalContext } from \"../../Client.js\";\nimport type { Logger } from \"../../Logger.js\";\nimport type { CommonObserveOptions, Status } from \"../ObservableClient.js\";\nimport type { CacheKey } from \"./CacheKey.js\";\nimport type { Entry } from \"./Layer.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: Partial<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  revalidate(force?: boolean): Promise<unknown> {\n    if (process.env.NODE_ENV !== \"production\") {\n      this.logger?.info({ methodName: \"revalidate\" });\n    }\n\n    if (force) {\n      this.abortController?.abort();\n    }\n\n    // if we are pending the first page we can just ignore this\n    if (this.pendingFetch) {\n      return this.pendingFetch;\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        this.logger?.trace({ methodName: \"revalidate\" }, \"DEDUPE\");\n      }\n\n      return Promise.resolve();\n    }\n\n    this.store.batch({}, (batch) => {\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      this.logger?.trace({ methodName: \"revalidate\" }, \"calling _fetch()\");\n    }\n    this.pendingFetch = this._fetch()\n      .catch((e) => {\n        this.logger?.error({ methodName: \"revalidate\" }, \"_fetch() FAILED\", e);\n        throw e;\n      })\n      .finally(() => {\n        this.logger?.info({ methodName: \"revalidate\" }, \"finally _fetch()\");\n        this.pendingFetch = undefined;\n      });\n\n    if (process.env.NODE_ENV !== \"production\") {\n      this.logger?.info({ methodName: \"revalidate\" }, \"Returning\");\n    }\n\n    return this.pendingFetch;\n  }\n\n  _preFetch(): void {}\n  abstract _fetch(): Promise<unknown>;\n\n  setStatus(\n    status: Status,\n    batch: BatchContext,\n  ): void {\n    if (process.env.NODE_ENV !== \"production\") {\n      this.logger?.trace({ methodName: \"setStatus\" }, 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  _dispose(): void {}\n\n  abstract writeToStore(\n    data: KEY[\"__cacheKey\"][\"value\"],\n    status: Status,\n    batch: BatchContext,\n  ): Entry<KEY>;\n}\n"],"mappings":"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","ignoreList":[]}
+{"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","info","dedupeInterval","lastFetchStarted","Date","now","debug","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?.info(\"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?.info(\"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":"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","ignoreList":[]}

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

@@ -39,8 +39,13 @@ export class RefCounts {
     }
   }
   release(key) {
-    const count = this.refCounts.get(key) ?? 0;
-    if (count === 1) {
+    const count = this.refCounts.get(key);
+    if (count === undefined) {
+      // TODO we should trace here if this happens because it likely means
+      // someone unsubscribed twice and I don't know if we should treat that as
+      // a potential error or not
+      // throw new Error("RefCounts.release() - key not found", key);
+    } else if (count === 1) {
       this.refCounts.delete(key);
       this.gcMap.set(key, Date.now() + this.keepAlive);
     } else {

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

@@ -1 +1 @@
-{"version":3,"file":"RefCounts.js","names":["DEBUG_REFCOUNTS","RefCounts","refCounts","Map","gcMap","constructor","keepAlive","cleanup","register","key","has","set","Date","now","retain","count","get","delete","release","gc","console","debug","JSON","stringify","deathTime"],"sources":["RefCounts.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 { DEBUG_REFCOUNTS } from \"../DebugFlags.js\";\n\nexport class RefCounts<T extends {}> {\n  private refCounts = new Map<T, number>();\n\n  // keeps our objects around for some extended duration after they are no longer\n  // needed which is good for quick clicks across tabs.\n  private gcMap = new Map<T, number /* death time */>();\n\n  constructor(private keepAlive: number, private cleanup: (key: T) => void) {\n  }\n\n  register<X extends T>(key: X): X {\n    if (!this.refCounts.has(key)) {\n      this.gcMap.set(key, Date.now() + this.keepAlive);\n    }\n\n    return key;\n  }\n\n  retain(key: T): void {\n    const count = this.refCounts.get(key) ?? 0;\n    this.refCounts.set(key, count + 1);\n    if (this.gcMap.has(key)) {\n      this.gcMap.delete(key);\n    }\n  }\n\n  release(key: T): void {\n    const count = this.refCounts.get(key) ?? 0;\n    if (count === 1) {\n      this.refCounts.delete(key);\n      this.gcMap.set(key, Date.now() + this.keepAlive);\n    } else {\n      this.refCounts.set(key, count - 1);\n    }\n  }\n\n  has(key: T): boolean {\n    return this.refCounts.has(key);\n  }\n\n  gc(): void {\n    const now = Date.now();\n\n    if (DEBUG_REFCOUNTS) {\n      for (const [key, count] of this.refCounts) {\n        // eslint-disable-next-line no-console\n        console.debug(\"RefCounts.gc() - counts: \", JSON.stringify(key), count);\n      }\n    }\n\n    for (const [key, deathTime] of this.gcMap) {\n      if (DEBUG_REFCOUNTS && deathTime >= now) {\n        // eslint-disable-next-line no-console\n        console.debug(\n          \"RefCounts.gc() - ttl \",\n          JSON.stringify(key),\n          deathTime - now,\n        );\n      }\n\n      if (deathTime < now) {\n        if (DEBUG_REFCOUNTS) {\n          // eslint-disable-next-line no-console\n          console.debug(\n            \"RefCounts.gc() - registering cleaning up\",\n            JSON.stringify(key),\n          );\n        }\n        this.gcMap.delete(key);\n        this.cleanup(key);\n      }\n    }\n  }\n}\n"],"mappings":"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","ignoreList":[]}
+{"version":3,"file":"RefCounts.js","names":["DEBUG_REFCOUNTS","RefCounts","refCounts","Map","gcMap","constructor","keepAlive","cleanup","register","key","has","set","Date","now","retain","count","get","delete","release","undefined","gc","console","debug","JSON","stringify","deathTime"],"sources":["RefCounts.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 { DEBUG_REFCOUNTS } from \"../DebugFlags.js\";\n\nexport class RefCounts<T extends {}> {\n  private refCounts = new Map<T, number>();\n\n  // keeps our objects around for some extended duration after they are no longer\n  // needed which is good for quick clicks across tabs.\n  private gcMap = new Map<T, number /* death time */>();\n\n  constructor(private keepAlive: number, private cleanup: (key: T) => void) {\n  }\n\n  register<X extends T>(key: X): X {\n    if (!this.refCounts.has(key)) {\n      this.gcMap.set(key, Date.now() + this.keepAlive);\n    }\n\n    return key;\n  }\n\n  retain(key: T): void {\n    const count = this.refCounts.get(key) ?? 0;\n    this.refCounts.set(key, count + 1);\n    if (this.gcMap.has(key)) {\n      this.gcMap.delete(key);\n    }\n  }\n\n  release(key: T): void {\n    const count = this.refCounts.get(key);\n\n    if (count === undefined) {\n      // TODO we should trace here if this happens because it likely means\n      // someone unsubscribed twice and I don't know if we should treat that as\n      // a potential error or not\n      // throw new Error(\"RefCounts.release() - key not found\", key);\n    } else if (count === 1) {\n      this.refCounts.delete(key);\n      this.gcMap.set(key, Date.now() + this.keepAlive);\n    } else {\n      this.refCounts.set(key, count - 1);\n    }\n  }\n\n  has(key: T): boolean {\n    return this.refCounts.has(key);\n  }\n\n  gc(): void {\n    const now = Date.now();\n\n    if (DEBUG_REFCOUNTS) {\n      for (const [key, count] of this.refCounts) {\n        // eslint-disable-next-line no-console\n        console.debug(\"RefCounts.gc() - counts: \", JSON.stringify(key), count);\n      }\n    }\n\n    for (const [key, deathTime] of this.gcMap) {\n      if (DEBUG_REFCOUNTS && deathTime >= now) {\n        // eslint-disable-next-line no-console\n        console.debug(\n          \"RefCounts.gc() - ttl \",\n          JSON.stringify(key),\n          deathTime - now,\n        );\n      }\n\n      if (deathTime < now) {\n        if (DEBUG_REFCOUNTS) {\n          // eslint-disable-next-line no-console\n          console.debug(\n            \"RefCounts.gc() - registering cleaning up\",\n            JSON.stringify(key),\n          );\n        }\n        this.gcMap.delete(key);\n        this.cleanup(key);\n      }\n    }\n  }\n}\n"],"mappings":"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","ignoreList":[]}

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

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=SimpleWhereClause.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SimpleWhereClause.js","names":[],"sources":["SimpleWhereClause.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 { WhereClause } from \"@osdk/api\";\n\nexport type SimpleWhereClause = WhereClause<\n  any\n>;\n"],"mappings":"","ignoreList":[]}