@osdk/client 2.4.2 → 2.5.0-beta.10

package/build/esm/objectSet/createObjectSet.js.map

@@ -1 +1 @@
-{"version":3,"file":"createObjectSet.js","names":["createWithPropertiesObjectSet","modernToLegacyWhereClause","aggregate","fetchPageInternal","fetchPageWithErrorsInternal","fetchSingle","fetchSingleWithErrors","augmentRequestContext","resolveBaseObjectSetType","isWireObjectSet","ObjectSetListenerWebsocket","isObjectTypeDefinition","def","type","isObjectSet","o","objectSetDefinitions","get","getWireObjectSet","objectSet","WeakMap","createObjectSet","objectType","clientCtx","base","bind","globalThis","finalMethodCall","fetchPage","fetchPageWithErrors","where","clause","objectSetFactory","pivotTo","createSearchAround","union","objectSets","map","os","intersect","subtract","nearestNeighbors","query","numNeighbors","property","nearestNeighborsQuery","isTextQuery","propertyIdentifier","apiName","asyncIter","args","$nextPageToken","undefined","result","$pageSize","nextPageToken","obj","data","fetchOne","primaryKey","options","createWithPk","fetchOneWithErrors","subscribe","listener","opts","pendingSubscribe","getInstance","properties","unsubscribe","withProperties","definitionMap","Map","derivedProperties","key","Object","keys","derivedPropertyDefinition","$objectSetInternals","link","interfaceLink","set","objDef","ontologyProvider","getObjectDefinition","withPk","field","primaryKeyApiName","value"],"sources":["createObjectSet.ts"],"sourcesContent":["/*\n * Copyright 2023 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  AsyncIterArgs,\n  Augments,\n  FetchPageResult,\n  LinkedType,\n  LinkNames,\n  NullabilityAdherence,\n  ObjectOrInterfaceDefinition,\n  ObjectSet,\n  ObjectTypeDefinition,\n  Osdk,\n  PrimaryKeyType,\n  PropertyKeys,\n  Result,\n  SelectArg,\n  SingleOsdkResult,\n} from \"@osdk/api\";\nimport type { MinimalObjectSet } from \"@osdk/api/unstable\";\nimport type {\n  DerivedPropertyDefinition,\n  ObjectSet as WireObjectSet,\n  PropertyApiName,\n} from \"@osdk/foundry.ontologies\";\nimport { createWithPropertiesObjectSet } from \"../derivedProperties/createWithPropertiesObjectSet.js\";\nimport { modernToLegacyWhereClause } from \"../internal/conversions/modernToLegacyWhereClause.js\";\nimport type { MinimalClient } from \"../MinimalClientContext.js\";\nimport { aggregate } from \"../object/aggregate.js\";\nimport {\n  fetchPageInternal,\n  fetchPageWithErrorsInternal,\n} from \"../object/fetchPage.js\";\nimport { fetchSingle, fetchSingleWithErrors } from \"../object/fetchSingle.js\";\nimport { augmentRequestContext } from \"../util/augmentRequestContext.js\";\nimport { resolveBaseObjectSetType } from \"../util/objectSetUtils.js\";\nimport { isWireObjectSet } from \"../util/WireObjectSet.js\";\nimport { ObjectSetListenerWebsocket } from \"./ObjectSetListenerWebsocket.js\";\n\nfunction isObjectTypeDefinition(\n  def: ObjectOrInterfaceDefinition,\n): def is ObjectTypeDefinition {\n  return def.type === \"object\";\n}\n\n/* @internal */\nexport function isObjectSet(o: any): o is ObjectSet<any> {\n  return o != null && typeof o === \"object\"\n    && isWireObjectSet(objectSetDefinitions.get(o));\n}\n\n/** @internal */\nexport function getWireObjectSet(\n  objectSet: ObjectSet<any> | MinimalObjectSet<any>,\n): WireObjectSet {\n  return objectSetDefinitions.get(objectSet)!;\n}\n\nconst objectSetDefinitions = new WeakMap<\n  any,\n  WireObjectSet\n>();\n\n/** @internal */\nexport function createObjectSet<Q extends ObjectOrInterfaceDefinition>(\n  objectType: Q,\n  clientCtx: MinimalClient,\n  objectSet: WireObjectSet = resolveBaseObjectSetType(objectType),\n): ObjectSet<Q> {\n  const base: ObjectSet<Q> = {\n    aggregate: (aggregate<Q, any>).bind(\n      globalThis,\n      augmentRequestContext(clientCtx, _ => ({ finalMethodCall: \"aggregate\" })),\n      objectType,\n      objectSet,\n    ) as ObjectSet<Q>[\"aggregate\"],\n\n    fetchPage: fetchPageInternal.bind(\n      globalThis,\n      augmentRequestContext(clientCtx, _ => ({ finalMethodCall: \"fetchPage\" })),\n      objectType,\n      objectSet,\n    ) as ObjectSet<Q>[\"fetchPage\"],\n\n    fetchPageWithErrors: fetchPageWithErrorsInternal.bind(\n      globalThis,\n      augmentRequestContext(\n        clientCtx,\n        _ => ({ finalMethodCall: \"fetchPageWithErrors\" }),\n      ),\n      objectType,\n      objectSet,\n    ) as ObjectSet<Q>[\"fetchPageWithErrors\"],\n\n    where: (clause) => {\n      return clientCtx.objectSetFactory(objectType, clientCtx, {\n        type: \"filter\",\n        objectSet: objectSet,\n        where: modernToLegacyWhereClause(clause, objectType),\n      });\n    },\n\n    pivotTo: function<L extends LinkNames<Q>>(\n      type: L,\n    ): ObjectSet<LinkedType<Q, L>> {\n      return createSearchAround(type)();\n    },\n\n    union: (...objectSets) => {\n      return clientCtx.objectSetFactory(objectType, clientCtx, {\n        type: \"union\",\n        objectSets: [\n          objectSet,\n          ...objectSets.map(os => objectSetDefinitions.get(os)!),\n        ],\n      });\n    },\n\n    intersect: (...objectSets) => {\n      return clientCtx.objectSetFactory(objectType, clientCtx, {\n        type: \"intersect\",\n        objectSets: [\n          objectSet,\n          ...objectSets.map(os => objectSetDefinitions.get(os)!),\n        ],\n      });\n    },\n\n    subtract: (...objectSets) => {\n      return clientCtx.objectSetFactory(objectType, clientCtx, {\n        type: \"subtract\",\n        objectSets: [\n          objectSet,\n          ...objectSets.map(os => objectSetDefinitions.get(os)!),\n        ],\n      });\n    },\n\n    nearestNeighbors: (query, numNeighbors, property) => {\n      const nearestNeighborsQuery = isTextQuery(query)\n        ? { \"type\": \"text\" as const, \"value\": query }\n        : { \"type\": \"vector\" as const, \"value\": query };\n      return clientCtx.objectSetFactory(\n        objectType,\n        clientCtx,\n        {\n          type: \"nearestNeighbors\",\n          objectSet,\n          propertyIdentifier: {\n            type: \"property\",\n            apiName: property as PropertyApiName,\n          },\n          numNeighbors,\n          query: nearestNeighborsQuery,\n        },\n      ) as ObjectSet<Q>;\n    },\n\n    asyncIter: async function*<\n      L extends PropertyKeys<Q>,\n      R extends boolean,\n      const A extends Augments,\n      S extends NullabilityAdherence = NullabilityAdherence.Default,\n      T extends boolean = false,\n    >(\n      args?: AsyncIterArgs<Q, L, R, A, S, T>,\n    ): AsyncIterableIterator<SingleOsdkResult<Q, L, R, S, {}, T>> {\n      let $nextPageToken: string | undefined = undefined;\n      do {\n        const result: FetchPageResult<\n          Q,\n          L,\n          R,\n          S,\n          T\n        > = await fetchPageInternal(\n          augmentRequestContext(\n            clientCtx,\n            _ => ({ finalMethodCall: \"asyncIter\" }),\n          ),\n          objectType,\n          objectSet,\n          { ...args, $pageSize: 10000, $nextPageToken },\n          true,\n        );\n        $nextPageToken = result.nextPageToken;\n\n        for (const obj of result.data) {\n          yield obj as SingleOsdkResult<Q, L, R, S, {}, T>;\n        }\n      } while ($nextPageToken != null);\n    },\n\n    fetchOne: (isObjectTypeDefinition(objectType)\n      ? async <A extends SelectArg<Q>>(\n        primaryKey: PrimaryKeyType<Q>,\n        options: A,\n      ) => {\n        return await fetchSingle(\n          augmentRequestContext(\n            clientCtx,\n            _ => ({ finalMethodCall: \"fetchOne\" }),\n          ),\n          objectType,\n          options,\n          await createWithPk(\n            clientCtx,\n            objectType,\n            objectSet,\n            primaryKey,\n          ),\n        ) as Osdk<Q>;\n      }\n      : undefined) as ObjectSet<Q>[\"fetchOne\"],\n\n    fetchOneWithErrors: (isObjectTypeDefinition(objectType)\n      ? async <A extends SelectArg<Q>>(\n        primaryKey: Q extends ObjectTypeDefinition ? PrimaryKeyType<Q>\n          : never,\n        options: A,\n      ) => {\n        return await fetchSingleWithErrors(\n          augmentRequestContext(\n            clientCtx,\n            _ => ({ finalMethodCall: \"fetchOneWithErrors\" }),\n          ),\n          objectType,\n          options,\n          await createWithPk(\n            clientCtx,\n            objectType,\n            objectSet,\n            primaryKey,\n          ),\n        ) as Result<Osdk<Q>>;\n      }\n      : undefined) as ObjectSet<Q>[\"fetchOneWithErrors\"],\n\n    subscribe: (\n      listener,\n      opts,\n    ) => {\n      const pendingSubscribe = ObjectSetListenerWebsocket.getInstance(\n        clientCtx,\n      ).subscribe(\n        objectType,\n        objectSet,\n        listener,\n        opts?.properties,\n      );\n\n      return { unsubscribe: async () => (await pendingSubscribe)() };\n    },\n\n    withProperties: (clause) => {\n      const definitionMap = new Map<any, DerivedPropertyDefinition>();\n\n      const derivedProperties: Record<string, DerivedPropertyDefinition> = {};\n      for (const key of Object.keys(clause)) {\n        const derivedPropertyDefinition = clause\n          [key](createWithPropertiesObjectSet(\n            objectType,\n            { type: \"methodInput\" },\n            definitionMap,\n            true,\n          ));\n        derivedProperties[key] = definitionMap.get(\n          derivedPropertyDefinition,\n        )!;\n      }\n\n      return clientCtx.objectSetFactory(\n        objectType,\n        clientCtx,\n        {\n          type: \"withProperties\",\n          derivedProperties: derivedProperties,\n          objectSet: objectSet,\n        },\n      );\n    },\n\n    $objectSetInternals: {\n      def: objectType,\n    },\n  };\n\n  function createSearchAround<L extends LinkNames<Q>>(link: L) {\n    return () => {\n      return clientCtx.objectSetFactory(\n        objectType,\n        clientCtx,\n        objectType.type === \"object\"\n          ? {\n            type: \"searchAround\",\n            objectSet,\n            link,\n          }\n          : {\n            type: \"interfaceLinkSearchAround\",\n            objectSet,\n            interfaceLink: link,\n          },\n      );\n    };\n  }\n\n  objectSetDefinitions.set(base, objectSet);\n\n  // we are using a type assertion because the marker symbol defined in BaseObjectSet isn't actually used\n  // at runtime.\n  return base as ObjectSet<Q>;\n}\n\nasync function createWithPk(\n  clientCtx: MinimalClient,\n  objectType: ObjectTypeDefinition,\n  objectSet: WireObjectSet,\n  primaryKey: PrimaryKeyType<ObjectTypeDefinition>,\n) {\n  const objDef = await clientCtx.ontologyProvider.getObjectDefinition(\n    objectType.apiName,\n  );\n\n  const withPk: WireObjectSet = {\n    type: \"filter\",\n    objectSet: objectSet,\n    where: {\n      type: \"eq\",\n      field: objDef.primaryKeyApiName,\n      value: primaryKey,\n    },\n  };\n  return withPk;\n}\n\nfunction isTextQuery(query: string | number[]): query is string {\n  return typeof query === \"string\";\n}\n"],"mappings":"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","ignoreList":[]}
+{"version":3,"file":"createObjectSet.js","names":["createWithPropertiesObjectSet","modernToLegacyWhereClause","aggregate","fetchPageInternal","fetchPageWithErrorsInternal","fetchSingle","fetchSingleWithErrors","augmentRequestContext","resolveBaseObjectSetType","isWireObjectSet","ObjectSetListenerWebsocket","isObjectTypeDefinition","def","type","isObjectSet","o","objectSetDefinitions","get","getWireObjectSet","objectSet","WeakMap","createObjectSet","objectType","clientCtx","base","bind","globalThis","finalMethodCall","fetchPage","fetchPageWithErrors","where","clause","objectSetFactory","pivotTo","createSearchAround","union","objectSets","map","os","intersect","subtract","nearestNeighbors","query","numNeighbors","property","nearestNeighborsQuery","isTextQuery","propertyIdentifier","apiName","asyncIter","args","$nextPageToken","undefined","result","$pageSize","nextPageToken","obj","data","fetchOne","primaryKey","options","createWithPk","fetchOneWithErrors","subscribe","listener","opts","pendingSubscribe","getInstance","properties","unsubscribe","withProperties","definitionMap","Map","derivedProperties","key","Object","keys","derivedPropertyDefinition","$objectSetInternals","link","interfaceLink","set","objDef","ontologyProvider","getObjectDefinition","withPk","field","primaryKeyApiName","value"],"sources":["createObjectSet.ts"],"sourcesContent":["/*\n * Copyright 2023 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  AsyncIterArgs,\n  Augments,\n  FetchPageResult,\n  LinkedType,\n  LinkNames,\n  NullabilityAdherence,\n  ObjectOrInterfaceDefinition,\n  ObjectSet,\n  ObjectSetArgs,\n  ObjectTypeDefinition,\n  Osdk,\n  PrimaryKeyType,\n  PropertyKeys,\n  Result,\n  SelectArg,\n  SingleOsdkResult,\n} from \"@osdk/api\";\nimport type { MinimalObjectSet } from \"@osdk/api/unstable\";\nimport type {\n  DerivedPropertyDefinition,\n  ObjectSet as WireObjectSet,\n  PropertyApiName,\n} from \"@osdk/foundry.ontologies\";\nimport { createWithPropertiesObjectSet } from \"../derivedProperties/createWithPropertiesObjectSet.js\";\nimport { modernToLegacyWhereClause } from \"../internal/conversions/modernToLegacyWhereClause.js\";\nimport type { MinimalClient } from \"../MinimalClientContext.js\";\nimport { aggregate } from \"../object/aggregate.js\";\nimport {\n  fetchPageInternal,\n  fetchPageWithErrorsInternal,\n} from \"../object/fetchPage.js\";\nimport { fetchSingle, fetchSingleWithErrors } from \"../object/fetchSingle.js\";\nimport { augmentRequestContext } from \"../util/augmentRequestContext.js\";\nimport { resolveBaseObjectSetType } from \"../util/objectSetUtils.js\";\nimport { isWireObjectSet } from \"../util/WireObjectSet.js\";\nimport { ObjectSetListenerWebsocket } from \"./ObjectSetListenerWebsocket.js\";\n\nfunction isObjectTypeDefinition(\n  def: ObjectOrInterfaceDefinition,\n): def is ObjectTypeDefinition {\n  return def.type === \"object\";\n}\n\n/* @internal */\nexport function isObjectSet(o: any): o is ObjectSet<any> {\n  return o != null && typeof o === \"object\"\n    && isWireObjectSet(objectSetDefinitions.get(o));\n}\n\n/** @internal */\nexport function getWireObjectSet(\n  objectSet: ObjectSet<any> | MinimalObjectSet<any>,\n): WireObjectSet {\n  return objectSetDefinitions.get(objectSet)!;\n}\n\n/** @internal exported for internal use only */\nexport const objectSetDefinitions = new WeakMap<\n  any,\n  WireObjectSet\n>();\n\n/** @internal */\nexport function createObjectSet<Q extends ObjectOrInterfaceDefinition>(\n  objectType: Q,\n  clientCtx: MinimalClient,\n  objectSet: WireObjectSet = resolveBaseObjectSetType(objectType),\n): ObjectSet<Q> {\n  const base: ObjectSet<Q> = {\n    aggregate: (aggregate<Q, any>).bind(\n      globalThis,\n      augmentRequestContext(clientCtx, _ => ({ finalMethodCall: \"aggregate\" })),\n      objectType,\n      objectSet,\n    ) as ObjectSet<Q>[\"aggregate\"],\n\n    fetchPage: fetchPageInternal.bind(\n      globalThis,\n      augmentRequestContext(clientCtx, _ => ({ finalMethodCall: \"fetchPage\" })),\n      objectType,\n      objectSet,\n    ) as ObjectSet<Q>[\"fetchPage\"],\n\n    fetchPageWithErrors: fetchPageWithErrorsInternal.bind(\n      globalThis,\n      augmentRequestContext(\n        clientCtx,\n        _ => ({ finalMethodCall: \"fetchPageWithErrors\" }),\n      ),\n      objectType,\n      objectSet,\n    ) as ObjectSet<Q>[\"fetchPageWithErrors\"],\n\n    where: (clause) => {\n      return clientCtx.objectSetFactory(objectType, clientCtx, {\n        type: \"filter\",\n        objectSet: objectSet,\n        where: modernToLegacyWhereClause(clause, objectType),\n      });\n    },\n\n    pivotTo: function<L extends LinkNames<Q>>(\n      type: L,\n    ): ObjectSet<LinkedType<Q, L>> {\n      return createSearchAround(type)();\n    },\n\n    union: (...objectSets) => {\n      return clientCtx.objectSetFactory(objectType, clientCtx, {\n        type: \"union\",\n        objectSets: [\n          objectSet,\n          ...objectSets.map(os => objectSetDefinitions.get(os)!),\n        ],\n      });\n    },\n\n    intersect: (...objectSets) => {\n      return clientCtx.objectSetFactory(objectType, clientCtx, {\n        type: \"intersect\",\n        objectSets: [\n          objectSet,\n          ...objectSets.map(os => objectSetDefinitions.get(os)!),\n        ],\n      });\n    },\n\n    subtract: (...objectSets) => {\n      return clientCtx.objectSetFactory(objectType, clientCtx, {\n        type: \"subtract\",\n        objectSets: [\n          objectSet,\n          ...objectSets.map(os => objectSetDefinitions.get(os)!),\n        ],\n      });\n    },\n\n    nearestNeighbors: (query, numNeighbors, property) => {\n      const nearestNeighborsQuery = isTextQuery(query)\n        ? { \"type\": \"text\" as const, \"value\": query }\n        : { \"type\": \"vector\" as const, \"value\": query };\n      return clientCtx.objectSetFactory(\n        objectType,\n        clientCtx,\n        {\n          type: \"nearestNeighbors\",\n          objectSet,\n          propertyIdentifier: {\n            type: \"property\",\n            apiName: property as PropertyApiName,\n          },\n          numNeighbors,\n          query: nearestNeighborsQuery,\n        },\n      ) as ObjectSet<Q>;\n    },\n\n    asyncIter: async function*<\n      L extends PropertyKeys<Q>,\n      R extends boolean,\n      const A extends Augments,\n      S extends NullabilityAdherence = NullabilityAdherence.Default,\n      T extends boolean = false,\n      ORDER_BY_OPTIONS extends ObjectSetArgs.OrderByOptions<L> = never,\n    >(\n      args?: AsyncIterArgs<Q, L, R, A, S, T, never, ORDER_BY_OPTIONS>,\n    ): AsyncIterableIterator<\n      SingleOsdkResult<Q, L, R, S, {}, T, ORDER_BY_OPTIONS>\n    > {\n      let $nextPageToken: string | undefined = undefined;\n      do {\n        const result: FetchPageResult<\n          Q,\n          L,\n          R,\n          S,\n          T,\n          ORDER_BY_OPTIONS\n        > = await fetchPageInternal(\n          augmentRequestContext(\n            clientCtx,\n            _ => ({ finalMethodCall: \"asyncIter\" }),\n          ),\n          objectType,\n          objectSet,\n          { ...args, $pageSize: 10000, $nextPageToken },\n          true,\n        );\n        $nextPageToken = result.nextPageToken;\n\n        for (const obj of result.data) {\n          yield obj as SingleOsdkResult<Q, L, R, S, {}, T, ORDER_BY_OPTIONS>;\n        }\n      } while ($nextPageToken != null);\n    },\n\n    fetchOne: (isObjectTypeDefinition(objectType)\n      ? async <A extends SelectArg<Q>>(\n        primaryKey: PrimaryKeyType<Q>,\n        options: A,\n      ) => {\n        return await fetchSingle(\n          augmentRequestContext(\n            clientCtx,\n            _ => ({ finalMethodCall: \"fetchOne\" }),\n          ),\n          objectType,\n          options,\n          await createWithPk(\n            clientCtx,\n            objectType,\n            objectSet,\n            primaryKey,\n          ),\n        ) as Osdk<Q>;\n      }\n      : undefined) as ObjectSet<Q>[\"fetchOne\"],\n\n    fetchOneWithErrors: (isObjectTypeDefinition(objectType)\n      ? async <A extends SelectArg<Q>>(\n        primaryKey: Q extends ObjectTypeDefinition ? PrimaryKeyType<Q>\n          : never,\n        options: A,\n      ) => {\n        return await fetchSingleWithErrors(\n          augmentRequestContext(\n            clientCtx,\n            _ => ({ finalMethodCall: \"fetchOneWithErrors\" }),\n          ),\n          objectType,\n          options,\n          await createWithPk(\n            clientCtx,\n            objectType,\n            objectSet,\n            primaryKey,\n          ),\n        ) as Result<Osdk<Q>>;\n      }\n      : undefined) as ObjectSet<Q>[\"fetchOneWithErrors\"],\n\n    subscribe: (\n      listener,\n      opts,\n    ) => {\n      const pendingSubscribe = ObjectSetListenerWebsocket.getInstance(\n        clientCtx,\n      ).subscribe(\n        objectType,\n        objectSet,\n        listener,\n        opts?.properties,\n      );\n\n      return { unsubscribe: async () => (await pendingSubscribe)() };\n    },\n\n    withProperties: (clause) => {\n      const definitionMap = new Map<any, DerivedPropertyDefinition>();\n\n      const derivedProperties: Record<string, DerivedPropertyDefinition> = {};\n      for (const key of Object.keys(clause)) {\n        const derivedPropertyDefinition = clause\n          [key](createWithPropertiesObjectSet(\n            objectType,\n            { type: \"methodInput\" },\n            definitionMap,\n            true,\n          ));\n        derivedProperties[key] = definitionMap.get(\n          derivedPropertyDefinition,\n        )!;\n      }\n\n      return clientCtx.objectSetFactory(\n        objectType,\n        clientCtx,\n        {\n          type: \"withProperties\",\n          derivedProperties: derivedProperties,\n          objectSet: objectSet,\n        },\n      );\n    },\n\n    $objectSetInternals: {\n      def: objectType,\n    },\n  };\n\n  function createSearchAround<L extends LinkNames<Q>>(link: L) {\n    return () => {\n      return clientCtx.objectSetFactory(\n        objectType,\n        clientCtx,\n        objectType.type === \"object\"\n          ? {\n            type: \"searchAround\",\n            objectSet,\n            link,\n          }\n          : {\n            type: \"interfaceLinkSearchAround\",\n            objectSet,\n            interfaceLink: link,\n          },\n      );\n    };\n  }\n\n  objectSetDefinitions.set(base, objectSet);\n\n  // we are using a type assertion because the marker symbol defined in BaseObjectSet isn't actually used\n  // at runtime.\n  return base as ObjectSet<Q>;\n}\n\nasync function createWithPk(\n  clientCtx: MinimalClient,\n  objectType: ObjectTypeDefinition,\n  objectSet: WireObjectSet,\n  primaryKey: PrimaryKeyType<ObjectTypeDefinition>,\n) {\n  const objDef = await clientCtx.ontologyProvider.getObjectDefinition(\n    objectType.apiName,\n  );\n\n  const withPk: WireObjectSet = {\n    type: \"filter\",\n    objectSet: objectSet,\n    where: {\n      type: \"eq\",\n      field: objDef.primaryKeyApiName,\n      value: primaryKey,\n    },\n  };\n  return withPk;\n}\n\nfunction isTextQuery(query: string | number[]): query is string {\n  return typeof query === \"string\";\n}\n"],"mappings":"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","ignoreList":[]}

package/build/esm/observable/LinkPayload.js

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"LinkPayload.js","names":[],"sources":["LinkPayload.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 { InterfaceHolder } from \"../object/convertWireToOsdkObjects/InterfaceHolder.js\";\nimport type { ObjectHolder } from \"../object/convertWireToOsdkObjects/ObjectHolder.js\";\nimport type { ObserveLinkCallbackArgs } from \"./ObservableClient.js\";\n\n/**\n * Internal type to keep the generic insanity down internal to the observable code\n */\nexport interface SpecificLinkPayload\n  extends Omit<ObserveLinkCallbackArgs<any>, \"resolvedList\">\n{\n  resolvedList: Array<ObjectHolder | InterfaceHolder>;\n}\n"],"mappings":"","ignoreList":[]}

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

@@ -1 +1 @@
-{"version":3,"file":"ObjectPayload.js","names":[],"sources":["ObjectPayload.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 { ObjectHolder } from \"../object/convertWireToOsdkObjects/ObjectHolder.js\";\nimport type { ObserveObjectArgs } from \"./ObservableClient.js\";\n\nexport interface ObjectPayload extends Omit<ObserveObjectArgs<any>, \"object\"> {\n  object: ObjectHolder | undefined;\n}\n"],"mappings":"","ignoreList":[]}
+{"version":3,"file":"ObjectPayload.js","names":[],"sources":["ObjectPayload.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, Osdk } from \"@osdk/api\";\nimport type { ObjectHolder } from \"../object/convertWireToOsdkObjects/ObjectHolder.js\";\nimport type { ObserveObjectArgs } from \"./ObservableClient.js\";\n\nexport interface ObjectPayload extends Omit<ObserveObjectArgs<any>, \"object\"> {\n  object: ObjectHolder | undefined;\n}\n\nexport interface TypedObjectPayload<T extends ObjectTypeDefinition>\n  extends ObjectPayload\n{\n  object: ObjectHolder<Osdk.Instance<T>> & Osdk.Instance<T> | undefined;\n}\n"],"mappings":"","ignoreList":[]}

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

@@ -0,0 +1,17 @@
+/*
+ * 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 let ObserveLinks;
+//# sourceMappingURL=ObserveLink.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ObserveLink.js","names":["ObserveLinks"],"sources":["ObserveLink.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  CompileTimeMetadata,\n  InterfaceDefinition,\n  ObjectTypeDefinition,\n  Osdk,\n  PrimaryKeyType,\n  WhereClause,\n} from \"@osdk/api\";\nimport type { Unsubscribable } from \"../Unsubscribable.js\";\nimport type {\n  CommonObserveOptions,\n  InvalidationMode,\n  ObserveOptions,\n  Observer,\n  OrderBy,\n  Status,\n} from \"./common.js\";\n\nexport namespace ObserveLinks {\n  export interface Options<\n    Q extends ObjectTypeDefinition | InterfaceDefinition,\n    L extends keyof CompileTimeMetadata<Q>[\"links\"] & string,\n  > extends CommonObserveOptions, ObserveOptions {\n    srcType: Pick<Q, \"type\" | \"apiName\">;\n    pk: PrimaryKeyType<Q>;\n    linkName: L;\n    where?: WhereClause<CompileTimeMetadata<Q>[\"links\"][L][\"targetType\"]>;\n    pageSize?: number;\n    orderBy?: OrderBy<CompileTimeMetadata<Q>[\"links\"][L][\"targetType\"]>;\n    invalidationMode?: InvalidationMode;\n    expectedLength?: number;\n  }\n\n  export interface CallbackArgs<\n    T extends ObjectTypeDefinition | InterfaceDefinition,\n  > {\n    resolvedList: Osdk.Instance<T>[];\n    isOptimistic: boolean;\n    lastUpdated: number;\n    fetchMore: () => Promise<void>;\n    hasMore: boolean;\n    status: Status;\n  }\n}\n\nexport interface ObserveLinks {\n  observeLinks<\n    T extends ObjectTypeDefinition | InterfaceDefinition,\n    L extends keyof CompileTimeMetadata<T>[\"links\"] & string,\n  >(\n    objects: Osdk.Instance<T> | ReadonlyArray<Osdk.Instance<T>>,\n    linkName: L,\n    options: Omit<ObserveLinks.Options<T, L>, \"srcType\" | \"pk\">,\n    subFn: Observer<\n      ObserveLinks.CallbackArgs<\n        CompileTimeMetadata<T>[\"links\"][L][\"targetType\"]\n      >\n    >,\n  ): Unsubscribable;\n}\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AAdA,WAkCiBA,YAAY","ignoreList":[]}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"common.js","names":[],"sources":["common.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  InterfaceDefinition,\n  ObjectTypeDefinition,\n  PropertyKeys,\n} from \"@osdk/api\";\n\n/**\n * Represents the current state of an observation.\n *\n * - init: Initial state before any data fetch attempt\n * - loading: Request is in progress\n * - loaded: Data successfully retrieved\n * - error: Request failed\n */\nexport type Status = \"init\" | \"loading\" | \"loaded\" | \"error\";\n\n/**\n * Standard observer pattern interface for reactive data flow.\n *\n * @template T Type of data being observed\n *\n * Callbacks:\n * - next: Called with updated values when data changes\n * - error: Called when an error occurs\n * - complete: Called when observation completes (rarely used)\n */\nexport interface Observer<T> {\n  next: (value: T) => void;\n  error: (err: any) => void;\n  complete: () => void;\n}\n\n/**\n * Common options shared by all observation methods.\n *\n * @property dedupeInterval - Time in milliseconds to deduplicate identical emissions\n *   Used to prevent rapid UI updates when multiple changes occur\n */\nexport interface CommonObserveOptions extends ObserveOptions {\n  dedupeInterval?: number;\n}\n\n/**\n * Options for object observation.\n *\n * @property mode - Data fetch strategy:\n *   - offline: Use only cached data, no network request\n *   - force: Always fetch from server, ignore cache\n *   - undefined (default): Use cache if available, fetch if missing\n */\nexport interface ObserveOptions {\n  mode?: \"offline\" | \"force\";\n}\n\n/**\n * Specifies sort order for collection queries.\n *\n * @template Q Object or interface type whose properties can be sorted\n *\n * Values:\n * - \"asc\": Sort in ascending order\n * - \"desc\": Sort in descending order\n * - undefined: Don't sort by this property\n *\n * Example: `{ name: \"asc\", created: \"desc\" }`\n */\nexport type OrderBy<Q extends ObjectTypeDefinition | InterfaceDefinition> = {\n  [K in PropertyKeys<Q>]?: \"asc\" | \"desc\" | undefined;\n};\n\n/**\n * Defines how data should be handled during invalidation.\n *\n * Values:\n * - \"in-place\": Update data without resetting the collection\n * - \"wait\": Wait for the server response before updating\n * - \"reset\": Clear existing data and refetch entirely\n */\nexport type InvalidationMode = \"in-place\" | \"wait\" | \"reset\";\n"],"mappings":"","ignoreList":[]}

package/build/esm/observable/ObservableClient.js

@@ -21,6 +21,26 @@ import { OBSERVABLE_USER_AGENT } from "../util/UserAgent.js";
 import { ObservableClientImpl } from "./internal/ObservableClientImpl.js";
 import { Store } from "./internal/Store.js";
 export let ObservableClient;
+// TODO: Rename this from `ObserveObjectArgs` => `ObserveObjectCallbackArgs`. Not doing it now to reduce churn
+// in repo.
+
+// TODO: Rename this from `ObserveObjectsArgs` => `ObserveObjectsCallbackArgs`. Not doing it now to reduce churn
+
+/**
+ * User facing callback args for `observeLink`
+ */
+
+/**
+ * Public interface for reactive data management with automatic updates.
+ *
+ * The ObservableClient provides a reactive data layer with:
+ * - Real-time object and collection observation
+ * - Automatic cache updates when data changes
+ * - Optimistic updates for immediate UI feedback
+ * - Pagination support for large collections
+ * - Link traversal for relationship navigation
+ */
+
 export function createObservableClient(client) {
   // First we need a modified client that adds an extra header so we know its
   // an observable client

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

@@ -1 +1 @@
-{"version":3,"file":"ObservableClient.js","names":["createFetchHeaderMutator","additionalContext","createClientFromContext","OBSERVABLE_USER_AGENT","ObservableClientImpl","Store","ObservableClient","createObservableClient","client","tweakedClient","fetch","headers","set","get","filter","x","length","join"],"sources":["ObservableClient.ts"],"sourcesContent":["/*\n * Copyright 2025 Palantir Technologies, Inc. All rights reserved.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport type {\n  ActionDefinition,\n  ActionValidationResponse,\n  InterfaceDefinition,\n  ObjectTypeDefinition,\n  Osdk,\n  PrimaryKeyType,\n  PropertyKeys,\n  WhereClause,\n} from \"@osdk/api\";\nimport { createFetchHeaderMutator } from \"@osdk/shared.net.fetch\";\nimport type { ActionSignatureFromDef } from \"../actions/applyAction.js\";\nimport { additionalContext, type Client } from \"../Client.js\";\nimport { createClientFromContext } from \"../createClient.js\";\nimport { OBSERVABLE_USER_AGENT } from \"../util/UserAgent.js\";\nimport type { Canonical } from \"./internal/Canonical.js\";\nimport { ObservableClientImpl } from \"./internal/ObservableClientImpl.js\";\nimport { Store } from \"./internal/Store.js\";\nimport type { OptimisticBuilder } from \"./OptimisticBuilder.js\";\n\nexport type Status = \"init\" | \"loading\" | \"loaded\" | \"error\";\n\nexport interface Observer<T> {\n  next: (value: T) => void;\n  error: (err: any) => void;\n  complete: () => void;\n}\n\nexport namespace ObservableClient {\n  export interface ApplyActionOptions {\n    optimisticUpdate?: (ctx: OptimisticBuilder) => void;\n  }\n}\n\nexport interface CommonObserveOptions {\n  dedupeInterval?: number;\n}\n\nexport interface ObserveOptions {\n  mode?: \"offline\" | \"force\";\n}\n\nexport interface ObserveObjectOptions<\n  T extends ObjectTypeDefinition | InterfaceDefinition,\n> extends ObserveOptions {\n  select?: PropertyKeys<T>[];\n}\n\nexport type OrderBy<Q extends ObjectTypeDefinition | InterfaceDefinition> = {\n  [K in PropertyKeys<Q>]?: \"asc\" | \"desc\" | undefined;\n};\n\nexport interface ObserveListOptions<\n  Q extends ObjectTypeDefinition | InterfaceDefinition,\n> extends CommonObserveOptions, ObserveOptions {\n  type: Pick<Q, \"apiName\" | \"type\">;\n  where?: WhereClause<Q>;\n  pageSize?: number;\n  orderBy?: OrderBy<Q>;\n  invalidationMode?: \"in-place\" | \"wait\" | \"reset\";\n  expectedLength?: number;\n  streamUpdates?: boolean;\n}\n\nexport interface ObserveObjectArgs<T extends ObjectTypeDefinition> {\n  object: Osdk.Instance<T> | undefined;\n  isOptimistic: boolean;\n  status: Status;\n  lastUpdated: number;\n}\n\nexport interface ObserveObjectsArgs<\n  T extends ObjectTypeDefinition | InterfaceDefinition,\n> {\n  resolvedList: Array<Osdk.Instance<T>>;\n  isOptimistic: boolean;\n  lastUpdated: number;\n  fetchMore: () => Promise<unknown>;\n  hasMore: boolean;\n  status: Status;\n}\n\nexport interface ObservableClient {\n  observeObject<T extends ObjectTypeDefinition>(\n    apiName: T[\"apiName\"] | T,\n    pk: PrimaryKeyType<T>,\n    options: ObserveOptions,\n    subFn: Observer<ObserveObjectArgs<T>>,\n  ): Unsubscribable;\n\n  observeList<T extends ObjectTypeDefinition | InterfaceDefinition>(\n    options: ObserveListOptions<T>,\n    subFn: Observer<ObserveObjectsArgs<T>>,\n  ): Unsubscribable;\n\n  applyAction: <Q extends ActionDefinition<any>>(\n    action: Q,\n    args:\n      | Parameters<ActionSignatureFromDef<Q>[\"applyAction\"]>[0]\n      | Array<Parameters<ActionSignatureFromDef<Q>[\"applyAction\"]>[0]>,\n    opts?: ObservableClient.ApplyActionOptions,\n  ) => Promise<unknown>;\n\n  validateAction: <Q extends ActionDefinition<any>>(\n    action: Q,\n    args: Parameters<ActionSignatureFromDef<Q>[\"applyAction\"]>[0],\n  ) => Promise<ActionValidationResponse>;\n\n  canonicalizeWhereClause: <\n    T extends ObjectTypeDefinition | InterfaceDefinition,\n  >(\n    where: WhereClause<T>,\n  ) => Canonical<WhereClause<T>>;\n}\n\nexport function createObservableClient(client: Client): ObservableClient {\n  // First we need a modified client that adds an extra header so we know its\n  // an observable client\n  const tweakedClient = createClientFromContext({\n    ...client[additionalContext],\n\n    fetch: createFetchHeaderMutator(\n      client[additionalContext].fetch,\n      (headers) => {\n        headers.set(\n          \"Fetch-User-Agent\",\n          [\n            headers.get(\"Fetch-User-Agent\"),\n            OBSERVABLE_USER_AGENT,\n          ].filter(x => x && x?.length > 0).join(\" \"),\n        );\n        return headers;\n      },\n    ),\n  });\n\n  // Then we use that client instead. Because the `client` does not hold\n  // any real state, this whole thing works.\n  return new ObservableClientImpl(new Store(tweakedClient));\n}\n\nexport interface Unsubscribable {\n  unsubscribe: () => void;\n}\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAYA,SAASA,wBAAwB,QAAQ,wBAAwB;AAEjE,SAASC,iBAAiB,QAAqB,cAAc;AAC7D,SAASC,uBAAuB,QAAQ,oBAAoB;AAC5D,SAASC,qBAAqB,QAAQ,sBAAsB;AAE5D,SAASC,oBAAoB,QAAQ,oCAAoC;AACzE,SAASC,KAAK,QAAQ,qBAAqB;AAAC,WAW3BC,gBAAgB;AAuFjC,OAAO,SAASC,sBAAsBA,CAACC,MAAc,EAAoB;EACvE;EACA;EACA,MAAMC,aAAa,GAAGP,uBAAuB,CAAC;IAC5C,GAAGM,MAAM,CAACP,iBAAiB,CAAC;IAE5BS,KAAK,EAAEV,wBAAwB,CAC7BQ,MAAM,CAACP,iBAAiB,CAAC,CAACS,KAAK,EAC9BC,OAAO,IAAK;MACXA,OAAO,CAACC,GAAG,CACT,kBAAkB,EAClB,CACED,OAAO,CAACE,GAAG,CAAC,kBAAkB,CAAC,EAC/BV,qBAAqB,CACtB,CAACW,MAAM,CAACC,CAAC,IAAIA,CAAC,IAAIA,CAAC,EAAEC,MAAM,GAAG,CAAC,CAAC,CAACC,IAAI,CAAC,GAAG,CAC5C,CAAC;MACD,OAAON,OAAO;IAChB,CACF;EACF,CAAC,CAAC;;EAEF;EACA;EACA,OAAO,IAAIP,oBAAoB,CAAC,IAAIC,KAAK,CAACI,aAAa,CAAC,CAAC;AAC3D","ignoreList":[]}
+{"version":3,"file":"ObservableClient.js","names":["createFetchHeaderMutator","additionalContext","createClientFromContext","OBSERVABLE_USER_AGENT","ObservableClientImpl","Store","ObservableClient","createObservableClient","client","tweakedClient","fetch","headers","set","get","filter","x","length","join"],"sources":["ObservableClient.ts"],"sourcesContent":["/*\n * Copyright 2025 Palantir Technologies, Inc. All rights reserved.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport type {\n  ActionDefinition,\n  ActionValidationResponse,\n  InterfaceDefinition,\n  ObjectTypeDefinition,\n  Osdk,\n  PrimaryKeyType,\n  PropertyKeys,\n  WhereClause,\n} from \"@osdk/api\";\nimport { createFetchHeaderMutator } from \"@osdk/shared.net.fetch\";\nimport type { ActionSignatureFromDef } from \"../actions/applyAction.js\";\nimport { additionalContext, type Client } from \"../Client.js\";\nimport { createClientFromContext } from \"../createClient.js\";\nimport { OBSERVABLE_USER_AGENT } from \"../util/UserAgent.js\";\nimport type { Canonical } from \"./internal/Canonical.js\";\nimport { ObservableClientImpl } from \"./internal/ObservableClientImpl.js\";\nimport { Store } from \"./internal/Store.js\";\nimport type {\n  CommonObserveOptions,\n  InvalidationMode,\n  ObserveOptions,\n  Observer,\n  Status,\n} from \"./ObservableClient/common.js\";\nimport type { ObserveLinks } from \"./ObservableClient/ObserveLink.js\";\nimport type { OptimisticBuilder } from \"./OptimisticBuilder.js\";\n\nexport namespace ObservableClient {\n  export interface ApplyActionOptions {\n    optimisticUpdate?: (ctx: OptimisticBuilder) => void;\n  }\n}\n\nexport interface ObserveObjectOptions<\n  T extends ObjectTypeDefinition | InterfaceDefinition,\n> extends ObserveOptions {\n  apiName: T[\"apiName\"] | T;\n  pk: PrimaryKeyType<T>;\n  select?: PropertyKeys<T>[];\n}\n\nexport type OrderBy<Q extends ObjectTypeDefinition | InterfaceDefinition> = {\n  [K in PropertyKeys<Q>]?: \"asc\" | \"desc\" | undefined;\n};\n\nexport interface ObserveListOptions<\n  Q extends ObjectTypeDefinition | InterfaceDefinition,\n> extends CommonObserveOptions, ObserveOptions {\n  type: Pick<Q, \"apiName\" | \"type\">;\n  where?: WhereClause<Q>;\n  pageSize?: number;\n  orderBy?: OrderBy<Q>;\n  invalidationMode?: InvalidationMode;\n  expectedLength?: number;\n  streamUpdates?: boolean;\n}\n\n// TODO: Rename this from `ObserveObjectArgs` => `ObserveObjectCallbackArgs`. Not doing it now to reduce churn\n// in repo.\nexport interface ObserveObjectArgs<T extends ObjectTypeDefinition> {\n  object: Osdk.Instance<T> | undefined;\n  isOptimistic: boolean;\n  status: Status;\n  lastUpdated: number;\n}\n\n// TODO: Rename this from `ObserveObjectsArgs` => `ObserveObjectsCallbackArgs`. Not doing it now to reduce churn\nexport interface ObserveObjectsArgs<\n  T extends ObjectTypeDefinition | InterfaceDefinition,\n> {\n  resolvedList: Array<Osdk.Instance<T>>;\n  isOptimistic: boolean;\n  lastUpdated: number;\n  fetchMore: () => Promise<void>;\n  hasMore: boolean;\n  status: Status;\n}\n\n/**\n * User facing callback args for `observeLink`\n */\nexport interface ObserveLinkCallbackArgs<\n  T extends ObjectTypeDefinition | InterfaceDefinition,\n> {\n  resolvedList: Osdk.Instance<T>[];\n  isOptimistic: boolean;\n  lastUpdated: number;\n  fetchMore: () => Promise<void>;\n  hasMore: boolean;\n  status: Status;\n}\n\n/**\n * Public interface for reactive data management with automatic updates.\n *\n * The ObservableClient provides a reactive data layer with:\n * - Real-time object and collection observation\n * - Automatic cache updates when data changes\n * - Optimistic updates for immediate UI feedback\n * - Pagination support for large collections\n * - Link traversal for relationship navigation\n */\nexport interface ObservableClient extends ObserveLinks {\n  /**\n   * Observe a single object with automatic updates when it changes.\n   *\n   * @param apiName - The object type definition or name\n   * @param pk - The object's primary key\n   * @param options - Observation options including deduplication interval\n   * @param subFn - Observer that receives object state updates\n   * @returns Subscription that can be unsubscribed to stop updates\n   *\n   * The observer will receive:\n   * - Initial loading state if data not cached\n   * - Loaded state with the object data\n   * - Updates when the object changes\n   * - Error state if fetch fails\n   */\n  observeObject<T extends ObjectTypeDefinition>(\n    apiName: T[\"apiName\"] | T,\n    pk: PrimaryKeyType<T>,\n    options: ObserveOptions,\n    subFn: Observer<ObserveObjectArgs<T>>,\n  ): Unsubscribable;\n\n  /**\n   * Observe a filtered and sorted collection of objects.\n   *\n   * @param options - Filter, sort, and pagination options\n   * @param subFn - Observer that receives collection state updates\n   * @returns Subscription that can be unsubscribed to stop updates\n   *\n   * Supports:\n   * - Filtering with where clauses\n   * - Sorting with orderBy\n   * - Pagination via fetchMore() in the payload\n   * - Automatic updates when any matching object changes\n   */\n  observeList<T extends ObjectTypeDefinition | InterfaceDefinition>(\n    options: ObserveListOptions<T>,\n    subFn: Observer<ObserveObjectsArgs<T>>,\n  ): Unsubscribable;\n\n  /**\n   * Execute an action with optional optimistic updates.\n   *\n   * @param action - Action definition to execute\n   * @param args - Arguments for the action\n   * @param opts - Options including optimistic updates\n   * @returns Promise that resolves when the action completes\n   *\n   * When providing optimistic updates:\n   * - Changes appear immediately in the UI\n   * - Server request still happens in background\n   * - On success, server data replaces optimistic data\n   * - On failure, optimistic changes automatically roll back\n   */\n  applyAction: <Q extends ActionDefinition<any>>(\n    action: Q,\n    args:\n      | Parameters<ActionSignatureFromDef<Q>[\"applyAction\"]>[0]\n      | Array<Parameters<ActionSignatureFromDef<Q>[\"applyAction\"]>[0]>,\n    opts?: ObservableClient.ApplyActionOptions,\n  ) => Promise<unknown>;\n\n  /**\n   * Validate action parameters without executing the action.\n   *\n   * @param action - Action definition to validate\n   * @param args - Arguments to validate\n   * @returns Promise with validation result\n   *\n   * Use this to:\n   * - Pre-validate forms before submission\n   * - Display warnings or errors in the UI\n   * - Enable/disable action buttons based on validity\n   */\n  validateAction: <Q extends ActionDefinition<any>>(\n    action: Q,\n    args: Parameters<ActionSignatureFromDef<Q>[\"applyAction\"]>[0],\n  ) => Promise<ActionValidationResponse>;\n\n  /**\n   * Invalidates the entire cache, forcing all queries to refetch.\n   * Use sparingly as this can cause significant network traffic.\n   */\n  invalidateAll(): Promise<void>;\n\n  /**\n   * Invalidates specific objects in the cache.\n   * @param objects - Single object or array of objects to invalidate\n   */\n  invalidateObjects(\n    objects:\n      | Osdk.Instance<ObjectTypeDefinition>\n      | ReadonlyArray<Osdk.Instance<ObjectTypeDefinition>>,\n  ): Promise<void>;\n\n  /**\n   * Invalidates all cached data for a specific object type.\n   * This includes:\n   * - All objects of the specified type\n   * - All lists containing objects of this type\n   * - All links where the source is of this type\n   *\n   * @param type - Object type definition or API name string\n   * @returns Promise that resolves when invalidation is complete\n   */\n  invalidateObjectType<T extends ObjectTypeDefinition>(\n    type: T | T[\"apiName\"],\n  ): Promise<void>;\n\n  canonicalizeWhereClause: <\n    T extends ObjectTypeDefinition | InterfaceDefinition,\n  >(\n    where: WhereClause<T>,\n  ) => Canonical<WhereClause<T>>;\n}\n\nexport function createObservableClient(client: Client): ObservableClient {\n  // First we need a modified client that adds an extra header so we know its\n  // an observable client\n  const tweakedClient = createClientFromContext({\n    ...client[additionalContext],\n\n    fetch: createFetchHeaderMutator(\n      client[additionalContext].fetch,\n      (headers) => {\n        headers.set(\n          \"Fetch-User-Agent\",\n          [\n            headers.get(\"Fetch-User-Agent\"),\n            OBSERVABLE_USER_AGENT,\n          ].filter(x => x && x?.length > 0).join(\" \"),\n        );\n        return headers;\n      },\n    ),\n  });\n\n  // Then we use that client instead. Because the `client` does not hold\n  // any real state, this whole thing works.\n  return new ObservableClientImpl(new Store(tweakedClient));\n}\n\nexport interface Unsubscribable {\n  unsubscribe: () => void;\n}\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAYA,SAASA,wBAAwB,QAAQ,wBAAwB;AAEjE,SAASC,iBAAiB,QAAqB,cAAc;AAC7D,SAASC,uBAAuB,QAAQ,oBAAoB;AAC5D,SAASC,qBAAqB,QAAQ,sBAAsB;AAE5D,SAASC,oBAAoB,QAAQ,oCAAoC;AACzE,SAASC,KAAK,QAAQ,qBAAqB;AAAC,WAW3BC,gBAAgB;AA8BjC;AACA;;AAQA;;AAYA;AACA;AACA;;AAYA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAsHA,OAAO,SAASC,sBAAsBA,CAACC,MAAc,EAAoB;EACvE;EACA;EACA,MAAMC,aAAa,GAAGP,uBAAuB,CAAC;IAC5C,GAAGM,MAAM,CAACP,iBAAiB,CAAC;IAE5BS,KAAK,EAAEV,wBAAwB,CAC7BQ,MAAM,CAACP,iBAAiB,CAAC,CAACS,KAAK,EAC9BC,OAAO,IAAK;MACXA,OAAO,CAACC,GAAG,CACT,kBAAkB,EAClB,CACED,OAAO,CAACE,GAAG,CAAC,kBAAkB,CAAC,EAC/BV,qBAAqB,CACtB,CAACW,MAAM,CAACC,CAAC,IAAIA,CAAC,IAAIA,CAAC,EAAEC,MAAM,GAAG,CAAC,CAAC,CAACC,IAAI,CAAC,GAAG,CAC5C,CAAC;MACD,OAAON,OAAO;IAChB,CACF;EACF,CAAC,CAAC;;EAEF;EACA;EACA,OAAO,IAAIP,oBAAoB,CAAC,IAAIC,KAAK,CAACI,aAAa,CAAC,CAAC;AAC3D","ignoreList":[]}

package/build/esm/observable/Unsubscribable.js

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"Unsubscribable.js","names":[],"sources":["Unsubscribable.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\nexport interface Unsubscribable {\n  unsubscribe: () => void;\n}\n"],"mappings":"","ignoreList":[]}

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

@@ -0,0 +1,54 @@
+/*
+ * 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 { QuerySubscription } from "./QuerySubscription.js";
+export class AbstractHelper {
+  constructor(store, cacheKeys) {
+    this.store = store;
+    this.cacheKeys = cacheKeys;
+  }
+  observe(options, subFn) {
+    const query = this.getQuery(options);
+    return this._subscribe(query, options, subFn);
+  }
+  _subscribe(query, options, subFn) {
+    // the ListQuery represents the shared state of the list
+    this.store.cacheKeys.retain(query.cacheKey);
+    if (options.mode !== "offline") {
+      query.revalidate(options.mode === "force").catch(e => {
+        subFn.error(e);
+
+        // we don't want observeObject() to return a promise,
+        // so we settle for logging an error here instead of
+        // dropping it on the floor.
+        if (this.store.logger) {
+          this.store.logger.error("Unhandled error in observeObject", e);
+        } else {
+          throw e;
+        }
+      });
+    }
+    const sub = query.subscribe(subFn);
+    const querySub = new QuerySubscription(query, sub);
+    query.registerSubscriptionDedupeInterval(querySub.subscriptionId, options.dedupeInterval);
+    sub.add(() => {
+      query.unregisterSubscriptionDedupeInterval(querySub.subscriptionId);
+      this.store.cacheKeys.release(query.cacheKey);
+    });
+    return querySub;
+  }
+}
+//# sourceMappingURL=AbstractHelper.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"AbstractHelper.js","names":["QuerySubscription","AbstractHelper","constructor","store","cacheKeys","observe","options","subFn","query","getQuery","_subscribe","retain","cacheKey","mode","revalidate","catch","e","error","logger","sub","subscribe","querySub","registerSubscriptionDedupeInterval","subscriptionId","dedupeInterval","add","unregisterSubscriptionDedupeInterval","release"],"sources":["AbstractHelper.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  CommonObserveOptions,\n  Observer,\n} from \"../ObservableClient/common.js\";\nimport type { CacheKeys } from \"./CacheKeys.js\";\nimport type { KnownCacheKey } from \"./KnownCacheKey.js\";\nimport type { Query } from \"./Query.js\";\nimport { QuerySubscription } from \"./QuerySubscription.js\";\nimport type { Store } from \"./Store.js\";\n\nexport abstract class AbstractHelper<\n  TQuery extends Query<KnownCacheKey, any, CommonObserveOptions>,\n  TObserveOptions extends CommonObserveOptions,\n> {\n  protected readonly store: Store;\n  protected readonly cacheKeys: CacheKeys<KnownCacheKey>;\n\n  constructor(store: Store, cacheKeys: CacheKeys<KnownCacheKey>) {\n    this.store = store;\n    this.cacheKeys = cacheKeys;\n  }\n\n  observe(\n    options: TObserveOptions,\n    subFn: Observer<\n      TQuery extends Query<any, infer PAYLOAD, any> ? PAYLOAD : never\n    >,\n  ): QuerySubscription<TQuery> {\n    const query = this.getQuery(options);\n    return this._subscribe(query, options, subFn);\n  }\n\n  abstract getQuery(options: TObserveOptions): TQuery;\n\n  protected _subscribe(\n    query: TQuery,\n    options: TObserveOptions,\n    subFn: Observer<\n      TQuery extends Query<any, infer PAYLOAD, any> ? PAYLOAD : never\n    >,\n  ): QuerySubscription<TQuery> {\n    // the ListQuery represents the shared state of the list\n    this.store.cacheKeys.retain(query.cacheKey);\n\n    if (options.mode !== \"offline\") {\n      query.revalidate(options.mode === \"force\").catch((e: unknown) => {\n        subFn.error(e);\n\n        // we don't want observeObject() to return a promise,\n        // so we settle for logging an error here instead of\n        // dropping it on the floor.\n        if (this.store.logger) {\n          this.store.logger.error(\"Unhandled error in observeObject\", e);\n        } else {\n          throw e;\n        }\n      });\n    }\n\n    const sub = query.subscribe(subFn);\n    const querySub = new QuerySubscription(query, sub);\n\n    query.registerSubscriptionDedupeInterval(\n      querySub.subscriptionId,\n      (options as CommonObserveOptions).dedupeInterval,\n    );\n\n    sub.add(() => {\n      query.unregisterSubscriptionDedupeInterval(querySub.subscriptionId);\n      this.store.cacheKeys.release(query.cacheKey);\n    });\n\n    return querySub;\n  }\n}\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AASA,SAASA,iBAAiB,QAAQ,wBAAwB;AAG1D,OAAO,MAAeC,cAAc,CAGlC;EAIAC,WAAWA,CAACC,KAAY,EAAEC,SAAmC,EAAE;IAC7D,IAAI,CAACD,KAAK,GAAGA,KAAK;IAClB,IAAI,CAACC,SAAS,GAAGA,SAAS;EAC5B;EAEAC,OAAOA,CACLC,OAAwB,EACxBC,KAEC,EAC0B;IAC3B,MAAMC,KAAK,GAAG,IAAI,CAACC,QAAQ,CAACH,OAAO,CAAC;IACpC,OAAO,IAAI,CAACI,UAAU,CAACF,KAAK,EAAEF,OAAO,EAAEC,KAAK,CAAC;EAC/C;EAIUG,UAAUA,CAClBF,KAAa,EACbF,OAAwB,EACxBC,KAEC,EAC0B;IAC3B;IACA,IAAI,CAACJ,KAAK,CAACC,SAAS,CAACO,MAAM,CAACH,KAAK,CAACI,QAAQ,CAAC;IAE3C,IAAIN,OAAO,CAACO,IAAI,KAAK,SAAS,EAAE;MAC9BL,KAAK,CAACM,UAAU,CAACR,OAAO,CAACO,IAAI,KAAK,OAAO,CAAC,CAACE,KAAK,CAAEC,CAAU,IAAK;QAC/DT,KAAK,CAACU,KAAK,CAACD,CAAC,CAAC;;QAEd;QACA;QACA;QACA,IAAI,IAAI,CAACb,KAAK,CAACe,MAAM,EAAE;UACrB,IAAI,CAACf,KAAK,CAACe,MAAM,CAACD,KAAK,CAAC,kCAAkC,EAAED,CAAC,CAAC;QAChE,CAAC,MAAM;UACL,MAAMA,CAAC;QACT;MACF,CAAC,CAAC;IACJ;IAEA,MAAMG,GAAG,GAAGX,KAAK,CAACY,SAAS,CAACb,KAAK,CAAC;IAClC,MAAMc,QAAQ,GAAG,IAAIrB,iBAAiB,CAACQ,KAAK,EAAEW,GAAG,CAAC;IAElDX,KAAK,CAACc,kCAAkC,CACtCD,QAAQ,CAACE,cAAc,EACtBjB,OAAO,CAA0BkB,cACpC,CAAC;IAEDL,GAAG,CAACM,GAAG,CAAC,MAAM;MACZjB,KAAK,CAACkB,oCAAoC,CAACL,QAAQ,CAACE,cAAc,CAAC;MACnE,IAAI,CAACpB,KAAK,CAACC,SAAS,CAACuB,OAAO,CAACnB,KAAK,CAACI,QAAQ,CAAC;IAC9C,CAAC,CAAC;IAEF,OAAOS,QAAQ;EACjB;AACF","ignoreList":[]}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"BatchContext.js","names":[],"sources":["BatchContext.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 { Changes } from \"./Changes.js\";\nimport type { KnownCacheKey } from \"./KnownCacheKey.js\";\nimport type { Entry } from \"./Layer.js\";\n\nexport interface BatchContext {\n  changes: Changes;\n  createLayerIfNeeded: () => void;\n  optimisticWrite: boolean;\n\n  write: <K extends KnownCacheKey>(\n    k: K,\n    v: Entry<K>[\"value\"],\n    status: Entry<K>[\"status\"],\n  ) => Entry<K>;\n\n  read: <K extends KnownCacheKey>(\n    k: K,\n  ) => Entry<K> | undefined;\n\n  delete: <K extends KnownCacheKey>(\n    k: K,\n    status: Entry<K>[\"status\"],\n  ) => Entry<K>;\n}\n"],"mappings":"","ignoreList":[]}

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

@@ -37,7 +37,7 @@ export class BulkObjectLoader {
     this.#maxWait = maxWait;
     this.#maxEntries = maxEntries;
   }
-  fetch(apiName, primaryKey) {
+  async fetch(apiName, primaryKey) {
     const deferred = pDefer();
     const entry = this.#m.get(apiName);
     entry.data.push({
@@ -53,7 +53,7 @@ export class BulkObjectLoader {
       clearTimeout(entry.timer);
       this.#loadObjects(apiName, entry.data);
     }
-    return deferred.promise;
+    return await deferred.promise;
   }
   #loadObjects(apiName, arr) {
     this.#m.delete(apiName);
@@ -85,7 +85,7 @@ export class BulkObjectLoader {
       if (object) {
         deferred.resolve(object);
       } else {
-        deferred.reject(new PalantirApiError("Object not found"));
+        deferred.reject(new PalantirApiError(`Object not found: ${primaryKey}`));
       }
     }
   }

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

@@ -1 +1 @@
-{"version":3,"file":"BulkObjectLoader.js","names":["PalantirApiError","DefaultMap","DefaultWeakMap","pDefer","additionalContext","weakCache","c","BulkObjectLoader","getBulkObjectLoader","client","get","m","data","timer","undefined","logger","maxWait","maxEntries","constructor","fetch","apiName","primaryKey","deferred","entry","push","setTimeout","loadObjects","length","clearTimeout","promise","#loadObjects","arr","delete","reallyLoadObjects","catch","e","error","#reallyLoadObjects","miniDef","type","objMetadata","fetchMetadata","pks","map","x","where","primaryKeyApiName","$in","fetchPage","$pageSize","object","find","$primaryKey","resolve","reject"],"sources":["BulkObjectLoader.ts"],"sourcesContent":["/*\n * Copyright 2025 Palantir Technologies, Inc. All rights reserved.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport type { Logger, ObjectTypeDefinition } from \"@osdk/api\";\nimport { PalantirApiError } from \"@osdk/shared.net.errors\";\nimport { DefaultMap, DefaultWeakMap } from \"mnemonist\";\nimport type { DeferredPromise } from \"p-defer\";\nimport pDefer from \"p-defer\";\nimport { additionalContext, type Client } from \"../../Client.js\";\nimport type {\n  ObjectHolder,\n} from \"../../object/convertWireToOsdkObjects/ObjectHolder.js\";\n\ninterface InternalValue {\n  primaryKey: string;\n  deferred: DeferredPromise<ObjectHolder>;\n}\n\ninterface Accumulator {\n  data: InternalValue[];\n  timer?: ReturnType<typeof setTimeout>;\n}\n\nconst weakCache = new DefaultWeakMap<Client, BulkObjectLoader>(c =>\n  new BulkObjectLoader(c)\n);\n\nexport function getBulkObjectLoader(client: Client): BulkObjectLoader {\n  return weakCache.get(client);\n}\n\nexport class BulkObjectLoader {\n  #client: Client;\n\n  #m = new DefaultMap<string, Accumulator>(() => ({\n    data: [],\n    timer: undefined,\n  }));\n  #logger: Logger | undefined;\n  #maxWait: number;\n  #maxEntries: number;\n\n  constructor(client: Client, maxWait = 25, maxEntries = 100) {\n    this.#client = client;\n    this.#logger = client[additionalContext].logger;\n    this.#maxWait = maxWait;\n    this.#maxEntries = maxEntries;\n  }\n\n  public fetch(\n    apiName: string,\n    primaryKey: string | number | boolean,\n  ): Promise<ObjectHolder> {\n    const deferred = pDefer<ObjectHolder>();\n\n    const entry = this.#m.get(apiName);\n    entry.data.push({\n      primaryKey: primaryKey as string,\n      deferred,\n    });\n\n    if (!entry.timer) {\n      entry.timer = setTimeout(() => {\n        this.#loadObjects(apiName, entry.data);\n      }, this.#maxWait);\n    }\n\n    if (entry.data.length >= this.#maxEntries) {\n      clearTimeout(entry.timer);\n      this.#loadObjects(apiName, entry.data);\n    }\n\n    return deferred.promise;\n  }\n\n  #loadObjects(apiName: string, arr: InternalValue[]) {\n    this.#m.delete(apiName);\n\n    this.#reallyLoadObjects(apiName, arr).catch((e: unknown) => {\n      this.#logger?.error(\"Unhandled exception\", e);\n    });\n  }\n\n  async #reallyLoadObjects(apiName: string, arr: InternalValue[]) {\n    const miniDef = { type: \"object\", apiName } as ObjectTypeDefinition;\n    const objMetadata = await this.#client.fetchMetadata(miniDef);\n\n    const pks = arr.map(x => x.primaryKey);\n\n    const { data } = await this.#client(miniDef)\n      .where({\n        [objMetadata.primaryKeyApiName]: { $in: pks },\n      }).fetchPage({\n        $pageSize: pks.length,\n      });\n\n    for (const { primaryKey, deferred } of arr) {\n      const object = data.find(x => x.$primaryKey === primaryKey) as\n        | ObjectHolder\n        | undefined;\n      if (object) {\n        deferred.resolve(object);\n      } else {\n        deferred.reject(new PalantirApiError(\"Object not found\"));\n      }\n    }\n  }\n}\n"],"mappings":"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","ignoreList":[]}
+{"version":3,"file":"BulkObjectLoader.js","names":["PalantirApiError","DefaultMap","DefaultWeakMap","pDefer","additionalContext","weakCache","c","BulkObjectLoader","getBulkObjectLoader","client","get","m","data","timer","undefined","logger","maxWait","maxEntries","constructor","fetch","apiName","primaryKey","deferred","entry","push","setTimeout","loadObjects","length","clearTimeout","promise","#loadObjects","arr","delete","reallyLoadObjects","catch","e","error","#reallyLoadObjects","miniDef","type","objMetadata","fetchMetadata","pks","map","x","where","primaryKeyApiName","$in","fetchPage","$pageSize","object","find","$primaryKey","resolve","reject"],"sources":["BulkObjectLoader.ts"],"sourcesContent":["/*\n * Copyright 2025 Palantir Technologies, Inc. All rights reserved.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport type { Logger, ObjectTypeDefinition } from \"@osdk/api\";\nimport { PalantirApiError } from \"@osdk/shared.net.errors\";\nimport { DefaultMap, DefaultWeakMap } from \"mnemonist\";\nimport type { DeferredPromise } from \"p-defer\";\nimport pDefer from \"p-defer\";\nimport { additionalContext, type Client } from \"../../Client.js\";\nimport type {\n  ObjectHolder,\n} from \"../../object/convertWireToOsdkObjects/ObjectHolder.js\";\n\ninterface InternalValue {\n  primaryKey: string;\n  deferred: DeferredPromise<ObjectHolder>;\n}\n\ninterface Accumulator {\n  data: InternalValue[];\n  timer?: ReturnType<typeof setTimeout>;\n}\n\nconst weakCache = new DefaultWeakMap<Client, BulkObjectLoader>(c =>\n  new BulkObjectLoader(c)\n);\n\nexport function getBulkObjectLoader(client: Client): BulkObjectLoader {\n  return weakCache.get(client);\n}\n\nexport class BulkObjectLoader {\n  #client: Client;\n\n  #m = new DefaultMap<string, Accumulator>(() => ({\n    data: [],\n    timer: undefined,\n  }));\n  #logger: Logger | undefined;\n  #maxWait: number;\n  #maxEntries: number;\n\n  constructor(client: Client, maxWait = 25, maxEntries = 100) {\n    this.#client = client;\n    this.#logger = client[additionalContext].logger;\n    this.#maxWait = maxWait;\n    this.#maxEntries = maxEntries;\n  }\n\n  public async fetch(\n    apiName: string,\n    primaryKey: string | number | boolean,\n  ): Promise<ObjectHolder> {\n    const deferred = pDefer<ObjectHolder>();\n\n    const entry = this.#m.get(apiName);\n    entry.data.push({\n      primaryKey: primaryKey as string,\n      deferred,\n    });\n\n    if (!entry.timer) {\n      entry.timer = setTimeout(() => {\n        this.#loadObjects(apiName, entry.data);\n      }, this.#maxWait);\n    }\n\n    if (entry.data.length >= this.#maxEntries) {\n      clearTimeout(entry.timer);\n      this.#loadObjects(apiName, entry.data);\n    }\n\n    return await deferred.promise;\n  }\n\n  #loadObjects(apiName: string, arr: InternalValue[]) {\n    this.#m.delete(apiName);\n\n    this.#reallyLoadObjects(apiName, arr).catch((e: unknown) => {\n      this.#logger?.error(\"Unhandled exception\", e);\n    });\n  }\n\n  async #reallyLoadObjects(apiName: string, arr: InternalValue[]) {\n    const miniDef = { type: \"object\", apiName } as ObjectTypeDefinition;\n    const objMetadata = await this.#client.fetchMetadata(miniDef);\n\n    const pks = arr.map(x => x.primaryKey);\n\n    const { data } = await this.#client(miniDef)\n      .where({\n        [objMetadata.primaryKeyApiName]: { $in: pks },\n      }).fetchPage({\n        $pageSize: pks.length,\n      });\n\n    for (const { primaryKey, deferred } of arr) {\n      const object = data.find(x => x.$primaryKey === primaryKey) as\n        | ObjectHolder\n        | undefined;\n      if (object) {\n        deferred.resolve(object);\n      } else {\n        deferred.reject(\n          new PalantirApiError(`Object not found: ${primaryKey}`),\n        );\n      }\n    }\n  }\n}\n"],"mappings":"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","ignoreList":[]}

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

@@ -15,46 +15,86 @@
  */
 
 import { Trie } from "@wry/trie";
-import invariant from "tiny-invariant";
-import { DEBUG_CACHE_KEYS } from "../DebugFlags.js";
+import { DEBUG_CACHE_KEYS, DEBUG_REFCOUNTS } from "../DebugFlags.js";
+import { RefCounts } from "./RefCounts.js";
+
+/**
+ * Cache key management with canonicalization.
+ * - Uses Trie structure for efficient storage and lookup
+ */
 export class CacheKeys {
   #cacheKeys = new Trie(false, keys => {
-    const ret = {
+    const cacheKey = {
       type: keys[0],
       otherKeys: keys.slice(1)
     };
-    this.#onCreate(ret);
-    return ret;
+    this.#onCreate?.(cacheKey);
+    if (DEBUG_REFCOUNTS) {
+      // eslint-disable-next-line no-console
+      console.log(`CacheKeys.onCreate(${cacheKey.type}, ${JSON.stringify(cacheKey.otherKeys)})`);
+      this.#finalizationRegistry.register(cacheKey, () => {
+        // eslint-disable-next-line no-console
+        console.log(`CacheKey Finalization(${cacheKey.type}, ${JSON.stringify(cacheKey.otherKeys)})`);
+      });
+    }
+    return cacheKey;
   });
-  #cacheKeyFactories = new Map();
+  #refCounts = new RefCounts(DEBUG_REFCOUNTS ? 15_000 : 60_000, k => this.#cleanupCacheKey(k));
+
+  // we are currently only using this for debug logging and should just remove it in the future if that
+  // continues to be true
+  #finalizationRegistry;
   #onCreate;
-  constructor(whereCanonicalizer, orderByCanonicalizer, onCreate) {
+  #onDestroy;
+  constructor({
+    onCreate,
+    onDestroy
+  }) {
     this.#onCreate = onCreate;
-    this.#registerCacheKeyFactory("object", (apiName, pk) => {
-      if (process.env.NODE_ENV !== "production" && DEBUG_CACHE_KEYS) {
-        // eslint-disable-next-line no-console
-        console.debug(`CacheKeys.get([object, ${apiName}, ${pk}]) -- already exists? `, this.#cacheKeys.peekArray(["object", apiName, pk]) != null);
-      }
-      return this.#cacheKeys.lookupArray(["object", apiName, pk]);
-    });
-    this.#registerCacheKeyFactory("list", (type, apiName, where, orderBy) => {
-      if (process.env.NODE_ENV !== "production" && DEBUG_CACHE_KEYS) {
+    this.#onDestroy = onDestroy;
+    setInterval(() => {
+      this.#refCounts.gc();
+    }, 1000);
+    this.#finalizationRegistry = new FinalizationRegistry(cleanupCallback => {
+      try {
+        cleanupCallback();
+      } catch (e) {
         // eslint-disable-next-line no-console
-        console.debug(`CacheKeys.get([list, ${apiName}, ${JSON.stringify(where)}, ${JSON.stringify(orderBy)}]) -- already exists? `, this.#cacheKeys.peekArray(["list", apiName, whereCanonicalizer.canonicalize(where), orderByCanonicalizer.canonicalize(orderBy)]) != null);
+        console.error("Caught an error while running a finalization callback", e);
       }
-      return this.#cacheKeys.lookupArray(["list", type, apiName, whereCanonicalizer.canonicalize(where), orderByCanonicalizer.canonicalize(orderBy)]);
     });
   }
-  #registerCacheKeyFactory(type, factory) {
-    this.#cacheKeyFactories.set(type, factory);
-  }
   get(type, ...args) {
-    const factory = this.#cacheKeyFactories.get(type);
-    !factory ? process.env.NODE_ENV !== "production" ? invariant(false, `no cache key factory for type "${type}"`) : invariant(false) : void 0;
-    return factory(...args);
+    const cacheKeyArgs = [type, ...args];
+    if (process.env.NODE_ENV !== "production" && DEBUG_CACHE_KEYS) {
+      // eslint-disable-next-line no-console
+      console.debug(`CacheKeys.get([${type}, 
+        ${args.map(x => JSON.stringify(x)).join(", ")}]) - already exists? `, this.#cacheKeys.peekArray(cacheKeyArgs) != null);
+    }
+    const cacheKey = this.#cacheKeys.lookupArray(cacheKeyArgs);
+
+    // This is an idempotent call that ensures the cache key is registered for
+    // cleanup. If already registered, this does nothing.
+    this.#refCounts.register(cacheKey);
+    return cacheKey;
   }
-  remove(cacheKey) {
+  retain(cacheKey) {
+    this.#refCounts.retain(cacheKey);
+  }
+  release(cacheKey) {
+    this.#refCounts.release(cacheKey);
+  }
+  #remove(cacheKey) {
     this.#cacheKeys.remove(cacheKey.type, ...cacheKey.otherKeys);
   }
+
+  /**
+   * Called after a key is no longer retained and the timeout has elapsed
+   * @param key
+   */
+  #cleanupCacheKey = key => {
+    this.#onDestroy?.(key);
+    this.#remove(key);
+  };
 }
 //# sourceMappingURL=CacheKeys.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"CacheKeys.js","names":["Trie","invariant","DEBUG_CACHE_KEYS","CacheKeys","cacheKeys","keys","ret","type","otherKeys","slice","onCreate","cacheKeyFactories","Map","constructor","whereCanonicalizer","orderByCanonicalizer","registerCacheKeyFactory","apiName","pk","process","env","NODE_ENV","console","debug","peekArray","lookupArray","where","orderBy","JSON","stringify","canonicalize","#registerCacheKeyFactory","factory","set","get","args","remove","cacheKey"],"sources":["CacheKeys.ts"],"sourcesContent":["/*\n * Copyright 2025 Palantir Technologies, Inc. All rights reserved.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { Trie } from \"@wry/trie\";\nimport invariant from \"tiny-invariant\";\nimport { DEBUG_CACHE_KEYS } from \"../DebugFlags.js\";\nimport type { CacheKey } from \"./CacheKey.js\";\nimport type { ListCacheKey } from \"./ListQuery.js\";\nimport type { ObjectCacheKey } from \"./ObjectQuery.js\";\nimport type { OrderByCanonicalizer } from \"./OrderByCanonicalizer.js\";\nimport type { WhereClauseCanonicalizer } from \"./WhereClauseCanonicalizer.js\";\n\ntype CacheKeyArgs<K extends CacheKey> = [K[\"type\"], ...K[\"otherKeys\"]];\n\nexport class CacheKeys {\n  #cacheKeys = new Trie<CacheKey<string, any, any>>(false, (keys) => {\n    const ret = {\n      type: keys[0],\n      otherKeys: keys.slice(1),\n    } as unknown as CacheKey<\n      string,\n      any,\n      any\n    >;\n    this.#onCreate(ret);\n    return ret;\n  });\n  #cacheKeyFactories = new Map<string, (...args: any[]) => CacheKey>();\n  #onCreate: (cacheKey: CacheKey) => void;\n\n  constructor(\n    whereCanonicalizer: WhereClauseCanonicalizer,\n    orderByCanonicalizer: OrderByCanonicalizer,\n    onCreate: (cacheKey: CacheKey) => void,\n  ) {\n    this.#onCreate = onCreate;\n    this.#registerCacheKeyFactory<ObjectCacheKey>(\n      \"object\",\n      (apiName, pk) => {\n        if (process.env.NODE_ENV !== \"production\" && DEBUG_CACHE_KEYS) {\n          // eslint-disable-next-line no-console\n          console.debug(\n            `CacheKeys.get([object, ${apiName}, ${pk}]) -- already exists? `,\n            this.#cacheKeys.peekArray([\n              \"object\",\n              apiName,\n              pk,\n            ]) != null,\n          );\n        }\n        return this.#cacheKeys.lookupArray([\n          \"object\",\n          apiName,\n          pk,\n        ]) as ObjectCacheKey;\n      },\n    );\n    this.#registerCacheKeyFactory<ListCacheKey>(\n      \"list\",\n      (type, apiName, where, orderBy) => {\n        if (process.env.NODE_ENV !== \"production\" && DEBUG_CACHE_KEYS) {\n          // eslint-disable-next-line no-console\n          console.debug(\n            `CacheKeys.get([list, ${apiName}, ${JSON.stringify(where)}, ${\n              JSON.stringify(orderBy)\n            }]) -- already exists? `,\n            this.#cacheKeys.peekArray([\n              \"list\",\n              apiName,\n              whereCanonicalizer.canonicalize(where),\n              orderByCanonicalizer.canonicalize(orderBy),\n            ]) != null,\n          );\n        }\n        return this.#cacheKeys.lookupArray<\n          CacheKeyArgs<ListCacheKey>\n        >([\n          \"list\",\n          type,\n          apiName,\n          whereCanonicalizer.canonicalize(where),\n          orderByCanonicalizer.canonicalize(orderBy),\n        ]) as ListCacheKey;\n      },\n    );\n  }\n\n  #registerCacheKeyFactory<K extends CacheKey>(\n    type: K[\"type\"],\n    factory: (...args: K[\"__cacheKey\"][\"args\"]) => K,\n  ): void {\n    this.#cacheKeyFactories.set(type, factory);\n  }\n\n  get<K extends CacheKey<string, any, any>>(\n    type: K[\"type\"],\n    ...args: K[\"__cacheKey\"][\"args\"]\n  ): K {\n    const factory = this.#cacheKeyFactories.get(type);\n    invariant(factory, `no cache key factory for type \"${type}\"`);\n    return factory(...args) as K;\n  }\n\n  remove<K extends CacheKey<string, any, any>>(\n    cacheKey: K,\n  ): void {\n    this.#cacheKeys.remove(cacheKey.type, ...cacheKey.otherKeys);\n  }\n}\n"],"mappings":"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","ignoreList":[]}
+{"version":3,"file":"CacheKeys.js","names":["Trie","DEBUG_CACHE_KEYS","DEBUG_REFCOUNTS","RefCounts","CacheKeys","cacheKeys","keys","cacheKey","type","otherKeys","slice","onCreate","console","log","JSON","stringify","finalizationRegistry","register","refCounts","k","cleanupCacheKey","onDestroy","constructor","setInterval","gc","FinalizationRegistry","cleanupCallback","e","error","get","args","cacheKeyArgs","process","env","NODE_ENV","debug","map","x","join","peekArray","lookupArray","retain","release","remove","#remove","key"],"sources":["CacheKeys.ts"],"sourcesContent":["/*\n * Copyright 2025 Palantir Technologies, Inc. All rights reserved.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { Trie } from \"@wry/trie\";\nimport { DEBUG_CACHE_KEYS, DEBUG_REFCOUNTS } from \"../DebugFlags.js\";\nimport type { CacheKey } from \"./CacheKey.js\";\nimport { RefCounts } from \"./RefCounts.js\";\n\n/**\n * Cache key management with canonicalization.\n * - Uses Trie structure for efficient storage and lookup\n */\nexport class CacheKeys<TCacheKey extends CacheKey> {\n  #cacheKeys = new Trie<TCacheKey>(false, (keys) => {\n    const cacheKey = {\n      type: keys[0],\n      otherKeys: keys.slice(1),\n    } as unknown as TCacheKey;\n    this.#onCreate?.(cacheKey);\n\n    if (DEBUG_REFCOUNTS) {\n      // eslint-disable-next-line no-console\n      console.log(\n        `CacheKeys.onCreate(${cacheKey.type}, ${\n          JSON.stringify(cacheKey.otherKeys)\n        })`,\n      );\n\n      this.#finalizationRegistry.register(cacheKey, () => {\n        // eslint-disable-next-line no-console\n        console.log(\n          `CacheKey Finalization(${cacheKey.type}, ${\n            JSON.stringify(cacheKey.otherKeys)\n          })`,\n        );\n      });\n    }\n    return cacheKey;\n  });\n\n  #refCounts = new RefCounts<TCacheKey>(\n    DEBUG_REFCOUNTS ? 15_000 : 60_000,\n    (k) => this.#cleanupCacheKey(k),\n  );\n\n  // we are currently only using this for debug logging and should just remove it in the future if that\n  // continues to be true\n  #finalizationRegistry: FinalizationRegistry<() => void>;\n\n  #onCreate?: (cacheKey: TCacheKey) => void;\n  #onDestroy?: (cacheKey: TCacheKey) => void;\n\n  constructor(\n    { onCreate, onDestroy }: {\n      onCreate?: (cacheKey: TCacheKey) => void;\n      onDestroy?: (cacheKey: TCacheKey) => void;\n    },\n  ) {\n    this.#onCreate = onCreate;\n    this.#onDestroy = onDestroy;\n\n    setInterval(() => {\n      this.#refCounts.gc();\n    }, 1000);\n\n    this.#finalizationRegistry = new FinalizationRegistry<() => void>(\n      (cleanupCallback) => {\n        try {\n          cleanupCallback();\n        } catch (e) {\n          // eslint-disable-next-line no-console\n          console.error(\n            \"Caught an error while running a finalization callback\",\n            e,\n          );\n        }\n      },\n    );\n  }\n\n  get<K extends TCacheKey>(\n    type: K[\"type\"],\n    ...args: K[\"__cacheKey\"][\"args\"]\n  ): K {\n    const cacheKeyArgs = [type, ...args];\n    if (process.env.NODE_ENV !== \"production\" && DEBUG_CACHE_KEYS) {\n      // eslint-disable-next-line no-console\n      console.debug(\n        `CacheKeys.get([${type}, \n        ${args.map(x => JSON.stringify(x)).join(\", \")}]) - already exists? `,\n        this.#cacheKeys.peekArray(cacheKeyArgs) != null,\n      );\n    }\n\n    const cacheKey = this.#cacheKeys.lookupArray(\n      cacheKeyArgs,\n    ) as K;\n\n    // This is an idempotent call that ensures the cache key is registered for\n    // cleanup. If already registered, this does nothing.\n    this.#refCounts.register(cacheKey);\n\n    return cacheKey;\n  }\n\n  retain(cacheKey: TCacheKey): void {\n    this.#refCounts.retain(cacheKey);\n  }\n\n  release(cacheKey: TCacheKey): void {\n    this.#refCounts.release(cacheKey);\n  }\n\n  #remove<K extends TCacheKey>(cacheKey: K): void {\n    this.#cacheKeys.remove(cacheKey.type, ...cacheKey.otherKeys);\n  }\n\n  /**\n   * Called after a key is no longer retained and the timeout has elapsed\n   * @param key\n   */\n  #cleanupCacheKey = (key: TCacheKey) => {\n    this.#onDestroy?.(key);\n    this.#remove(key);\n  };\n}\n"],"mappings":"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","ignoreList":[]}

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

@@ -32,6 +32,12 @@ export class Changes {
   registerList = key => {
     this.modified.add(key);
   };
+  registerLink = cacheKey => {
+    this.modified.add(cacheKey);
+  };
+  deleteLink = cacheKey => {
+    this.deleted.add(cacheKey);
+  };
   isEmpty() {
     return this.modifiedObjects.size === 0 && this.addedObjects.size === 0 && this.added.size === 0 && this.modified.size === 0 && this.deleted.size === 0;
   }

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

@@ -1 +1 @@
-{"version":3,"file":"Changes.js","names":["MultiMap","DEBUG_ONLY__cacheKeyToString","Changes","modifiedObjects","addedObjects","added","Set","modified","deleted","registerObject","cacheKey","data","isNew","set","$apiName","add","deleteObject","registerList","key","isEmpty","size","createChangedObjects","DEBUG_ONLY__changesToString","changes","process","env","NODE_ENV","JSON","stringify","multimapHelper","listHelper","Error","Array","from","map","multimap","Object","fromEntries","associations","type","objects","o","$primaryKey"],"sources":["Changes.ts"],"sourcesContent":["/*\n * Copyright 2025 Palantir Technologies, Inc. All rights reserved.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { MultiMap } from \"mnemonist\";\nimport type { ObjectHolder } from \"../../object/convertWireToOsdkObjects/ObjectHolder.js\";\nimport type { CacheKey } from \"./CacheKey.js\";\nimport { DEBUG_ONLY__cacheKeyToString } from \"./CacheKey.js\";\nimport type { ListCacheKey } from \"./ListQuery.js\";\nimport type { ObjectCacheKey } from \"./ObjectQuery.js\";\n\nexport class Changes {\n  modifiedObjects: MultiMap<string, ObjectHolder> = new MultiMap();\n  addedObjects: MultiMap<string, ObjectHolder> = new MultiMap();\n\n  added: Set<ListCacheKey | ObjectCacheKey> = new Set();\n  modified: Set<ListCacheKey | ObjectCacheKey> = new Set();\n  deleted: Set<ListCacheKey | ObjectCacheKey> = new Set();\n\n  registerObject = (\n    cacheKey: ObjectCacheKey,\n    data: ObjectHolder,\n    isNew: boolean,\n  ): void => {\n    this[isNew ? \"addedObjects\" : \"modifiedObjects\"].set(data.$apiName, data);\n    this[isNew ? \"added\" : \"modified\"].add(cacheKey);\n  };\n\n  deleteObject = (cacheKey: ObjectCacheKey): void => {\n    this.deleted.add(cacheKey);\n  };\n\n  registerList = (key: ListCacheKey): void => {\n    this.modified.add(key);\n  };\n\n  isEmpty(): boolean {\n    return (\n      this.modifiedObjects.size === 0\n      && this.addedObjects.size === 0\n      && this.added.size === 0\n      && this.modified.size === 0\n      && this.deleted.size === 0\n    );\n  }\n}\n\nexport function createChangedObjects(): Changes {\n  return new Changes();\n}\n\nexport function DEBUG_ONLY__changesToString(changes: Changes): string {\n  if (process.env.NODE_ENV !== \"production\") {\n    return JSON.stringify(\n      {\n        modifiedObjects: multimapHelper(changes.modifiedObjects),\n        addedObjects: multimapHelper(changes.addedObjects),\n        added: listHelper(changes.added),\n        modified: listHelper(changes.modified),\n      },\n      null,\n      2,\n    );\n  } else {\n    throw new Error(\"not implemented\");\n  }\n}\n\nfunction listHelper(set: Set<CacheKey>) {\n  return Array.from(set).map(DEBUG_ONLY__cacheKeyToString);\n}\n\nfunction multimapHelper(\n  multimap: MultiMap<string, ObjectHolder>,\n) {\n  return Object.fromEntries(\n    Array.from(multimap.associations()).map(\n      ([type, objects]) => {\n        return [type, objects.map(o => o.$primaryKey)];\n      },\n    ),\n  );\n}\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA,SAASA,QAAQ,QAAQ,WAAW;AAGpC,SAASC,4BAA4B,QAAQ,eAAe;AAI5D,OAAO,MAAMC,OAAO,CAAC;EACnBC,eAAe,GAAmC,IAAIH,QAAQ,CAAC,CAAC;EAChEI,YAAY,GAAmC,IAAIJ,QAAQ,CAAC,CAAC;EAE7DK,KAAK,GAAuC,IAAIC,GAAG,CAAC,CAAC;EACrDC,QAAQ,GAAuC,IAAID,GAAG,CAAC,CAAC;EACxDE,OAAO,GAAuC,IAAIF,GAAG,CAAC,CAAC;EAEvDG,cAAc,GAAGA,CACfC,QAAwB,EACxBC,IAAkB,EAClBC,KAAc,KACL;IACT,IAAI,CAACA,KAAK,GAAG,cAAc,GAAG,iBAAiB,CAAC,CAACC,GAAG,CAACF,IAAI,CAACG,QAAQ,EAAEH,IAAI,CAAC;IACzE,IAAI,CAACC,KAAK,GAAG,OAAO,GAAG,UAAU,CAAC,CAACG,GAAG,CAACL,QAAQ,CAAC;EAClD,CAAC;EAEDM,YAAY,GAAIN,QAAwB,IAAW;IACjD,IAAI,CAACF,OAAO,CAACO,GAAG,CAACL,QAAQ,CAAC;EAC5B,CAAC;EAEDO,YAAY,GAAIC,GAAiB,IAAW;IAC1C,IAAI,CAACX,QAAQ,CAACQ,GAAG,CAACG,GAAG,CAAC;EACxB,CAAC;EAEDC,OAAOA,CAAA,EAAY;IACjB,OACE,IAAI,CAAChB,eAAe,CAACiB,IAAI,KAAK,CAAC,IAC5B,IAAI,CAAChB,YAAY,CAACgB,IAAI,KAAK,CAAC,IAC5B,IAAI,CAACf,KAAK,CAACe,IAAI,KAAK,CAAC,IACrB,IAAI,CAACb,QAAQ,CAACa,IAAI,KAAK,CAAC,IACxB,IAAI,CAACZ,OAAO,CAACY,IAAI,KAAK,CAAC;EAE9B;AACF;AAEA,OAAO,SAASC,oBAAoBA,CAAA,EAAY;EAC9C,OAAO,IAAInB,OAAO,CAAC,CAAC;AACtB;AAEA,OAAO,SAASoB,2BAA2BA,CAACC,OAAgB,EAAU;EACpE,IAAIC,OAAO,CAACC,GAAG,CAACC,QAAQ,KAAK,YAAY,EAAE;IACzC,OAAOC,IAAI,CAACC,SAAS,CACnB;MACEzB,eAAe,EAAE0B,cAAc,CAACN,OAAO,CAACpB,eAAe,CAAC;MACxDC,YAAY,EAAEyB,cAAc,CAACN,OAAO,CAACnB,YAAY,CAAC;MAClDC,KAAK,EAAEyB,UAAU,CAACP,OAAO,CAAClB,KAAK,CAAC;MAChCE,QAAQ,EAAEuB,UAAU,CAACP,OAAO,CAAChB,QAAQ;IACvC,CAAC,EACD,IAAI,EACJ,CACF,CAAC;EACH,CAAC,MAAM;IACL,MAAM,IAAIwB,KAAK,CAAC,iBAAiB,CAAC;EACpC;AACF;AAEA,SAASD,UAAUA,CAACjB,GAAkB,EAAE;EACtC,OAAOmB,KAAK,CAACC,IAAI,CAACpB,GAAG,CAAC,CAACqB,GAAG,CAACjC,4BAA4B,CAAC;AAC1D;AAEA,SAAS4B,cAAcA,CACrBM,QAAwC,EACxC;EACA,OAAOC,MAAM,CAACC,WAAW,CACvBL,KAAK,CAACC,IAAI,CAACE,QAAQ,CAACG,YAAY,CAAC,CAAC,CAAC,CAACJ,GAAG,CACrC,CAAC,CAACK,IAAI,EAAEC,OAAO,CAAC,KAAK;IACnB,OAAO,CAACD,IAAI,EAAEC,OAAO,CAACN,GAAG,CAACO,CAAC,IAAIA,CAAC,CAACC,WAAW,CAAC,CAAC;EAChD,CACF,CACF,CAAC;AACH","ignoreList":[]}
+{"version":3,"file":"Changes.js","names":["MultiMap","DEBUG_ONLY__cacheKeyToString","Changes","modifiedObjects","addedObjects","added","Set","modified","deleted","registerObject","cacheKey","data","isNew","set","$apiName","add","deleteObject","registerList","key","registerLink","deleteLink","isEmpty","size","createChangedObjects","DEBUG_ONLY__changesToString","changes","process","env","NODE_ENV","JSON","stringify","multimapHelper","listHelper","Error","Array","from","map","multimap","Object","fromEntries","associations","type","objects","o","$primaryKey"],"sources":["Changes.ts"],"sourcesContent":["/*\n * Copyright 2025 Palantir Technologies, Inc. All rights reserved.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { MultiMap } from \"mnemonist\";\nimport type { ObjectHolder } from \"../../object/convertWireToOsdkObjects/ObjectHolder.js\";\nimport type { CacheKey } from \"./CacheKey.js\";\nimport { DEBUG_ONLY__cacheKeyToString } from \"./CacheKey.js\";\nimport type { SpecificLinkCacheKey } from \"./links/SpecificLinkCacheKey.js\";\nimport type { ListCacheKey } from \"./list/ListCacheKey.js\";\nimport type { ObjectCacheKey } from \"./object/ObjectCacheKey.js\";\n\nexport class Changes {\n  modifiedObjects: MultiMap<string, ObjectHolder> = new MultiMap();\n  addedObjects: MultiMap<string, ObjectHolder> = new MultiMap();\n\n  added: Set<ListCacheKey | ObjectCacheKey | SpecificLinkCacheKey> = new Set();\n  modified: Set<ListCacheKey | ObjectCacheKey | SpecificLinkCacheKey> =\n    new Set();\n  deleted: Set<ListCacheKey | ObjectCacheKey | SpecificLinkCacheKey> =\n    new Set();\n\n  registerObject = (\n    cacheKey: ObjectCacheKey,\n    data: ObjectHolder,\n    isNew: boolean,\n  ): void => {\n    this[isNew ? \"addedObjects\" : \"modifiedObjects\"].set(data.$apiName, data);\n    this[isNew ? \"added\" : \"modified\"].add(cacheKey);\n  };\n\n  deleteObject = (cacheKey: ObjectCacheKey): void => {\n    this.deleted.add(cacheKey);\n  };\n\n  registerList = (key: ListCacheKey): void => {\n    this.modified.add(key);\n  };\n\n  registerLink = (cacheKey: SpecificLinkCacheKey): void => {\n    this.modified.add(cacheKey);\n  };\n\n  deleteLink = (cacheKey: SpecificLinkCacheKey): void => {\n    this.deleted.add(cacheKey);\n  };\n\n  isEmpty(): boolean {\n    return (\n      this.modifiedObjects.size === 0\n      && this.addedObjects.size === 0\n      && this.added.size === 0\n      && this.modified.size === 0\n      && this.deleted.size === 0\n    );\n  }\n}\n\nexport function createChangedObjects(): Changes {\n  return new Changes();\n}\n\nexport function DEBUG_ONLY__changesToString(changes: Changes): string {\n  if (process.env.NODE_ENV !== \"production\") {\n    return JSON.stringify(\n      {\n        modifiedObjects: multimapHelper(changes.modifiedObjects),\n        addedObjects: multimapHelper(changes.addedObjects),\n        added: listHelper(changes.added),\n        modified: listHelper(changes.modified),\n      },\n      null,\n      2,\n    );\n  } else {\n    throw new Error(\"not implemented\");\n  }\n}\n\nfunction listHelper(set: Set<CacheKey>) {\n  return Array.from(set).map(DEBUG_ONLY__cacheKeyToString);\n}\n\nfunction multimapHelper(\n  multimap: MultiMap<string, ObjectHolder>,\n) {\n  return Object.fromEntries(\n    Array.from(multimap.associations()).map(\n      ([type, objects]) => {\n        return [type, objects.map(o => o.$primaryKey)];\n      },\n    ),\n  );\n}\n"],"mappings":"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","ignoreList":[]}

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

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