@osdk/client 2.7.1 → 2.7.2

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

@@ -63,24 +63,9 @@ export class ObservableClientImpl {
     }, subFn);
   };
   observeLinks = (objects, linkName, options, subFn) => {
-    // Convert to array if single object provided
     const objectsArray = Array.isArray(objects) ? objects : [objects];
-    const parentSub = new Subscription();
-    for (const obj of objectsArray) {
-      const querySubscription = this.__experimentalStore.links.observe({
-        ...options,
-        srcType: {
-          type: "object",
-          apiName: obj.$objectType ?? obj.$apiName
-        },
-        linkName,
-        pk: obj.$primaryKey
-      },
-      // cast to cross typed to untyped barrier
-      subFn);
-      parentSub.add(querySubscription);
-    }
-    return new UnsubscribableWrapper(parentSub);
+    const observer = subFn;
+    return objectsArray.length <= 1 ? observeSingleLink(this.__experimentalStore, objectsArray, linkName, options, observer) : observeMultiLinks(this.__experimentalStore, objectsArray, linkName, options, observer);
   };
   observeObjectSet(baseObjectSet, options, subFn) {
     return this.__experimentalStore.objectSets.observe({
@@ -109,4 +94,106 @@ export class ObservableClientImpl {
     return this.__experimentalStore.whereCanonicalizer.canonicalize(where);
   }
 }
+function observeSingleLink(store, objectsArray, linkName, options, observer) {
+  if (objectsArray.length === 0) {
+    observer.next({
+      resolvedList: [],
+      isOptimistic: false,
+      lastUpdated: 0,
+      fetchMore: () => Promise.resolve(),
+      hasMore: false,
+      status: "loaded",
+      totalCount: "0"
+    });
+    return new UnsubscribableWrapper(new Subscription());
+  }
+  const parentSub = new Subscription();
+  for (const obj of objectsArray) {
+    parentSub.add(store.links.observe({
+      ...options,
+      srcType: {
+        type: "object",
+        apiName: obj.$objectType ?? obj.$apiName
+      },
+      linkName,
+      pk: obj.$primaryKey
+    }, observer));
+  }
+  return new UnsubscribableWrapper(parentSub);
+}
+function observeMultiLinks(store, objectsArray, linkName, options, observer) {
+  const parentSub = new Subscription();
+  const totalExpected = objectsArray.length;
+  const perObjectResults = new Map();
+  let errored = false;
+  function mergeAndEmit() {
+    if (errored) {
+      return;
+    }
+    const seen = new Map();
+    const fetchMores = [];
+    let latestUpdated = 0;
+    let hasMore = false;
+    let isOptimistic = false;
+    for (const payload of perObjectResults.values()) {
+      for (const obj of payload.resolvedList) {
+        seen.set(`${obj.$objectType}:${obj.$primaryKey}`, obj);
+      }
+      if (payload.lastUpdated > latestUpdated) {
+        latestUpdated = payload.lastUpdated;
+      }
+      if (payload.isOptimistic) {
+        isOptimistic = true;
+      }
+      if (payload.hasMore) {
+        hasMore = true;
+        fetchMores.push(payload.fetchMore);
+      }
+    }
+    const payloads = [...perObjectResults.values()];
+    const loading = perObjectResults.size < totalExpected || payloads.some(p => p.status === "init" || p.status === "loading");
+    observer.next({
+      resolvedList: Array.from(seen.values()),
+      isOptimistic,
+      lastUpdated: latestUpdated,
+      fetchMore: hasMore ? () => Promise.all(fetchMores.map(fn => fn())).then(() => {}) : () => Promise.resolve(),
+      hasMore,
+      status: loading ? "loading" : payloads.some(p => p.status === "error") ? "error" : "loaded",
+      ...(!hasMore ? {
+        totalCount: String(seen.size)
+      } : {})
+    });
+  }
+  for (const obj of objectsArray) {
+    const objKey = `${obj.$objectType ?? obj.$apiName}:${obj.$primaryKey}`;
+    parentSub.add(store.links.observe({
+      ...options,
+      srcType: {
+        type: "object",
+        apiName: obj.$objectType ?? obj.$apiName
+      },
+      linkName,
+      pk: obj.$primaryKey
+    }, {
+      next: payload => {
+        if (errored) {
+          return;
+        }
+        perObjectResults.set(objKey, payload);
+        mergeAndEmit();
+      },
+      error: err => {
+        if (errored) {
+          return;
+        }
+        errored = true;
+        parentSub.unsubscribe();
+        observer.error(err);
+      },
+      // store link queries are long-lived and do not complete
+      complete: () => {}
+    }));
+  }
+  return new UnsubscribableWrapper(parentSub);
+}
 //# sourceMappingURL=ObservableClientImpl.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"ObservableClientImpl.js","names":["Subscription","UnsubscribableWrapper","ObservableClientImpl","constructor","store","__experimentalStore","applyAction","bind","validateAction","observeObject","apiName","pk","options","subFn","objects","observe","observeList","lists","observeAggregation","aggregations","observeFunction","queryDef","params","dependsOn","map","dep","dependsOnObjects","obj","$apiName","$objectType","$primaryKey","functions","observeLinks","linkName","objectsArray","Array","isArray","parentSub","querySubscription","links","srcType","type","add","observeObjectSet","baseObjectSet","objectSets","invalidateAll","invalidateObjects","invalidateObjectType","undefined","invalidateFunction","invalidateFunctionsByObject","primaryKey","canonicalizeWhereClause","where","whereCanonicalizer","canonicalize"],"sources":["ObservableClientImpl.ts"],"sourcesContent":["/*\n * Copyright 2025 Palantir Technologies, Inc. All rights reserved.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport type {\n  ActionDefinition,\n  ActionEditResponse,\n  ActionValidationResponse,\n  AggregateOpts,\n  CompileTimeMetadata,\n  InterfaceDefinition,\n  ObjectOrInterfaceDefinition,\n  ObjectSet,\n  ObjectTypeDefinition,\n  Osdk,\n  PrimaryKeyType,\n  QueryDefinition,\n  SimplePropertyDef,\n  WhereClause,\n  WirePropertyTypes,\n} from \"@osdk/api\";\nimport { Subscription } from \"rxjs\";\nimport type { ActionSignatureFromDef } from \"../../actions/applyAction.js\";\nimport type { FunctionPayload } from \"../FunctionPayload.js\";\nimport type { SpecificLinkPayload } from \"../LinkPayload.js\";\nimport type { ListPayload } from \"../ListPayload.js\";\nimport type { ObjectPayload } from \"../ObjectPayload.js\";\nimport type { ObjectSetPayload } from \"../ObjectSetPayload.js\";\nimport type {\n  ObservableClient,\n  ObserveAggregationArgs,\n  ObserveAggregationOptions,\n  ObserveFunctionCallbackArgs,\n  ObserveFunctionOptions,\n  ObserveListOptions,\n  ObserveObjectCallbackArgs,\n  ObserveObjectOptions,\n  ObserveObjectsCallbackArgs,\n  ObserveObjectSetArgs,\n  Unsubscribable,\n} from \"../ObservableClient.js\";\nimport type { Observer } from \"../ObservableClient/common.js\";\nimport type { ObserveLinks } from \"../ObservableClient/ObserveLink.js\";\nimport type { AggregationPayloadBase } from \"./aggregation/AggregationQuery.js\";\nimport type { Canonical } from \"./Canonical.js\";\nimport type { ObserveObjectSetOptions } from \"./objectset/ObjectSetQueryOptions.js\";\nimport type { Store } from \"./Store.js\";\nimport { UnsubscribableWrapper } from \"./UnsubscribableWrapper.js\";\n\n/**\n * Implementation of the public ObservableClient interface.\n * - Delegates all operations to the Store for consistency\n * - Serves as the entry point for reactive data management\n * - Ensures proper method binding and API exposure\n *\n * @internal\n */\nexport class ObservableClientImpl implements ObservableClient {\n  __experimentalStore: Store;\n\n  constructor(store: Store) {\n    this.__experimentalStore = store;\n\n    this.applyAction = store.applyAction.bind(store);\n    this.validateAction = store.validateAction.bind(store);\n  }\n\n  public observeObject: <T extends ObjectTypeDefinition>(\n    apiName: T[\"apiName\"] | T,\n    pk: PrimaryKeyType<T>,\n    options: Omit<ObserveObjectOptions<T>, \"apiName\" | \"pk\">,\n    subFn: Observer<ObserveObjectCallbackArgs<T>>,\n  ) => Unsubscribable = (apiName, pk, options, subFn) => {\n    return this.__experimentalStore.objects.observe(\n      {\n        ...options,\n        apiName,\n        pk,\n      },\n      // cast to cross typed to untyped barrier\n      subFn as unknown as Observer<ObjectPayload>,\n    );\n  };\n\n  public observeList: <\n    T extends ObjectTypeDefinition | InterfaceDefinition,\n    RDPs extends Record<string, SimplePropertyDef> = {},\n  >(\n    options: ObserveListOptions<T, RDPs>,\n    subFn: Observer<ObserveObjectsCallbackArgs<T, RDPs>>,\n  ) => Unsubscribable = (options, subFn) => {\n    return this.__experimentalStore.lists.observe(\n      options,\n      // cast to cross typed to untyped barrier\n      subFn as unknown as Observer<ListPayload>,\n    );\n  };\n\n  public observeAggregation: <\n    T extends ObjectOrInterfaceDefinition,\n    A extends AggregateOpts<T>,\n    RDPs extends Record<string, SimplePropertyDef> = {},\n  >(\n    options: ObserveAggregationOptions<T, A, RDPs>,\n    subFn: Observer<ObserveAggregationArgs<T, A>>,\n  ) => Unsubscribable = <\n    T extends ObjectOrInterfaceDefinition,\n    A extends AggregateOpts<T>,\n    RDPs extends Record<string, SimplePropertyDef> = {},\n  >(\n    options: ObserveAggregationOptions<T, A, RDPs>,\n    subFn: Observer<ObserveAggregationArgs<T, A>>,\n  ) => {\n    return this.__experimentalStore.aggregations.observe(\n      options,\n      subFn as Observer<AggregationPayloadBase>,\n    );\n  };\n\n  public observeFunction: <Q extends QueryDefinition<unknown>>(\n    queryDef: Q,\n    params: Record<string, unknown> | undefined,\n    options: ObserveFunctionOptions,\n    subFn: Observer<ObserveFunctionCallbackArgs<Q>>,\n  ) => Unsubscribable = (queryDef, params, options, subFn) => {\n    const dependsOn = options.dependsOn?.map(dep =>\n      typeof dep === \"string\" ? dep : dep.apiName\n    );\n    const dependsOnObjects = options.dependsOnObjects?.map(obj => ({\n      $apiName: obj.$objectType ?? obj.$apiName,\n      $primaryKey: obj.$primaryKey,\n    }));\n\n    return this.__experimentalStore.functions.observe(\n      {\n        ...options,\n        queryDef,\n        params,\n        dependsOn,\n        dependsOnObjects,\n      },\n      subFn as unknown as Observer<FunctionPayload>,\n    );\n  };\n\n  public observeLinks: <\n    T extends ObjectTypeDefinition | InterfaceDefinition,\n    L extends keyof CompileTimeMetadata<T>[\"links\"] & string,\n  >(\n    objects: Osdk.Instance<T> | Array<Osdk.Instance<T>>,\n    linkName: L,\n    options: ObserveLinks.Options<T, L>,\n    subFn: Observer<\n      ObserveLinks.CallbackArgs<\n        CompileTimeMetadata<T>[\"links\"][L][\"targetType\"]\n      >\n    >,\n  ) => Unsubscribable = (objects, linkName, options, subFn) => {\n    // Convert to array if single object provided\n    const objectsArray = Array.isArray(objects) ? objects : [objects];\n\n    const parentSub = new Subscription();\n\n    for (const obj of objectsArray) {\n      const querySubscription = this.__experimentalStore.links\n        .observe(\n          {\n            ...options,\n            srcType: {\n              type: \"object\",\n              apiName: obj.$objectType ?? obj.$apiName,\n            },\n            linkName,\n            pk: obj.$primaryKey,\n          },\n          // cast to cross typed to untyped barrier\n          subFn as unknown as Observer<SpecificLinkPayload>,\n        );\n\n      parentSub.add(querySubscription);\n    }\n\n    return new UnsubscribableWrapper(parentSub);\n  };\n\n  public applyAction: <Q extends ActionDefinition<any>>(\n    action: Q,\n    args: Parameters<ActionSignatureFromDef<Q>[\"applyAction\"]>[0],\n    opts?: ObservableClient.ApplyActionOptions,\n  ) => Promise<ActionEditResponse>;\n\n  public validateAction: <Q extends ActionDefinition<any>>(\n    action: Q,\n    args: Parameters<ActionSignatureFromDef<Q>[\"applyAction\"]>[0],\n  ) => Promise<ActionValidationResponse>;\n\n  public observeObjectSet<\n    T extends ObjectTypeDefinition,\n    RDPs extends Record<\n      string,\n      WirePropertyTypes | undefined | Array<WirePropertyTypes>\n    > = {},\n  >(\n    baseObjectSet: ObjectSet<T>,\n    options: ObserveObjectSetOptions<T, RDPs>,\n    subFn: Observer<ObserveObjectSetArgs<T, RDPs>>,\n  ): Unsubscribable {\n    return this.__experimentalStore.objectSets.observe(\n      { baseObjectSet, ...options },\n      // cast to cross typed to untyped barrier\n      subFn as unknown as Observer<ObjectSetPayload>,\n    );\n  }\n\n  public invalidateAll(): Promise<void> {\n    return this.__experimentalStore.invalidateAll();\n  }\n\n  public invalidateObjects(\n    objects:\n      | Osdk.Instance<ObjectTypeDefinition>\n      | ReadonlyArray<Osdk.Instance<ObjectTypeDefinition>>,\n  ): Promise<void> {\n    return this.__experimentalStore.invalidateObjects(objects);\n  }\n\n  public invalidateObjectType<T extends ObjectTypeDefinition>(\n    type: T | T[\"apiName\"],\n  ): Promise<void> {\n    return this.__experimentalStore.invalidateObjectType(type, undefined);\n  }\n\n  public invalidateFunction(\n    apiName: string | QueryDefinition<unknown>,\n    params?: Record<string, unknown>,\n  ): Promise<void> {\n    return this.__experimentalStore.invalidateFunction(apiName, params);\n  }\n\n  public invalidateFunctionsByObject(\n    apiName: string,\n    primaryKey: string | number,\n  ): Promise<void> {\n    return this.__experimentalStore.invalidateFunctionsByObject(\n      apiName,\n      primaryKey,\n    );\n  }\n\n  public canonicalizeWhereClause<\n    T extends ObjectTypeDefinition | InterfaceDefinition,\n    RDPs extends Record<string, SimplePropertyDef> = {},\n  >(where: WhereClause<T, RDPs>): Canonical<WhereClause<T, RDPs>> {\n    return this.__experimentalStore.whereCanonicalizer\n      .canonicalize(where) as Canonical<WhereClause<T, RDPs>>;\n  }\n}\n"],"mappings":"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","ignoreList":[]}
+{"version":3,"file":"ObservableClientImpl.js","names":["Subscription","UnsubscribableWrapper","ObservableClientImpl","constructor","store","__experimentalStore","applyAction","bind","validateAction","observeObject","apiName","pk","options","subFn","objects","observe","observeList","lists","observeAggregation","aggregations","observeFunction","queryDef","params","dependsOn","map","dep","dependsOnObjects","obj","$apiName","$objectType","$primaryKey","functions","observeLinks","linkName","objectsArray","Array","isArray","observer","length","observeSingleLink","observeMultiLinks","observeObjectSet","baseObjectSet","objectSets","invalidateAll","invalidateObjects","invalidateObjectType","type","undefined","invalidateFunction","invalidateFunctionsByObject","primaryKey","canonicalizeWhereClause","where","whereCanonicalizer","canonicalize","next","resolvedList","isOptimistic","lastUpdated","fetchMore","Promise","resolve","hasMore","status","totalCount","parentSub","add","links","srcType","totalExpected","perObjectResults","Map","errored","mergeAndEmit","seen","fetchMores","latestUpdated","payload","values","set","push","payloads","loading","size","some","p","from","all","fn","then","String","objKey","error","err","unsubscribe","complete"],"sources":["ObservableClientImpl.ts"],"sourcesContent":["/*\n * Copyright 2025 Palantir Technologies, Inc. All rights reserved.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport type {\n  ActionDefinition,\n  ActionEditResponse,\n  ActionValidationResponse,\n  AggregateOpts,\n  CompileTimeMetadata,\n  InterfaceDefinition,\n  ObjectOrInterfaceDefinition,\n  ObjectSet,\n  ObjectTypeDefinition,\n  Osdk,\n  PrimaryKeyType,\n  QueryDefinition,\n  SimplePropertyDef,\n  WhereClause,\n  WirePropertyTypes,\n} from \"@osdk/api\";\nimport { Subscription } from \"rxjs\";\nimport type { ActionSignatureFromDef } from \"../../actions/applyAction.js\";\nimport type { FunctionPayload } from \"../FunctionPayload.js\";\nimport type { SpecificLinkPayload } from \"../LinkPayload.js\";\nimport type { ListPayload } from \"../ListPayload.js\";\nimport type { ObjectPayload } from \"../ObjectPayload.js\";\nimport type { ObjectSetPayload } from \"../ObjectSetPayload.js\";\nimport type {\n  ObservableClient,\n  ObserveAggregationArgs,\n  ObserveAggregationOptions,\n  ObserveFunctionCallbackArgs,\n  ObserveFunctionOptions,\n  ObserveListOptions,\n  ObserveObjectCallbackArgs,\n  ObserveObjectOptions,\n  ObserveObjectsCallbackArgs,\n  ObserveObjectSetArgs,\n  Unsubscribable,\n} from \"../ObservableClient.js\";\nimport type { Observer } from \"../ObservableClient/common.js\";\nimport type { ObserveLinks } from \"../ObservableClient/ObserveLink.js\";\nimport type { AggregationPayloadBase } from \"./aggregation/AggregationQuery.js\";\nimport type { Canonical } from \"./Canonical.js\";\nimport type { ObserveObjectSetOptions } from \"./objectset/ObjectSetQueryOptions.js\";\nimport type { Store } from \"./Store.js\";\nimport { UnsubscribableWrapper } from \"./UnsubscribableWrapper.js\";\n\n/**\n * Implementation of the public ObservableClient interface.\n * - Delegates all operations to the Store for consistency\n * - Serves as the entry point for reactive data management\n * - Ensures proper method binding and API exposure\n *\n * @internal\n */\nexport class ObservableClientImpl implements ObservableClient {\n  __experimentalStore: Store;\n\n  constructor(store: Store) {\n    this.__experimentalStore = store;\n\n    this.applyAction = store.applyAction.bind(store);\n    this.validateAction = store.validateAction.bind(store);\n  }\n\n  public observeObject: <T extends ObjectOrInterfaceDefinition>(\n    apiName: T[\"apiName\"] | T,\n    pk: PrimaryKeyType<T>,\n    options: Omit<ObserveObjectOptions<T>, \"apiName\" | \"pk\">,\n    subFn: Observer<ObserveObjectCallbackArgs<T>>,\n  ) => Unsubscribable = (apiName, pk, options, subFn) => {\n    return this.__experimentalStore.objects.observe(\n      {\n        ...options,\n        apiName,\n        pk,\n      },\n      // cast to cross typed to untyped barrier\n      subFn as unknown as Observer<ObjectPayload>,\n    );\n  };\n\n  public observeList: <\n    T extends ObjectTypeDefinition | InterfaceDefinition,\n    RDPs extends Record<string, SimplePropertyDef> = {},\n  >(\n    options: ObserveListOptions<T, RDPs>,\n    subFn: Observer<ObserveObjectsCallbackArgs<T, RDPs>>,\n  ) => Unsubscribable = (options, subFn) => {\n    return this.__experimentalStore.lists.observe(\n      options,\n      // cast to cross typed to untyped barrier\n      subFn as unknown as Observer<ListPayload>,\n    );\n  };\n\n  public observeAggregation: <\n    T extends ObjectOrInterfaceDefinition,\n    A extends AggregateOpts<T>,\n    RDPs extends Record<string, SimplePropertyDef> = {},\n  >(\n    options: ObserveAggregationOptions<T, A, RDPs>,\n    subFn: Observer<ObserveAggregationArgs<T, A>>,\n  ) => Unsubscribable = <\n    T extends ObjectOrInterfaceDefinition,\n    A extends AggregateOpts<T>,\n    RDPs extends Record<string, SimplePropertyDef> = {},\n  >(\n    options: ObserveAggregationOptions<T, A, RDPs>,\n    subFn: Observer<ObserveAggregationArgs<T, A>>,\n  ) => {\n    return this.__experimentalStore.aggregations.observe(\n      options,\n      subFn as Observer<AggregationPayloadBase>,\n    );\n  };\n\n  public observeFunction: <Q extends QueryDefinition<unknown>>(\n    queryDef: Q,\n    params: Record<string, unknown> | undefined,\n    options: ObserveFunctionOptions,\n    subFn: Observer<ObserveFunctionCallbackArgs<Q>>,\n  ) => Unsubscribable = (queryDef, params, options, subFn) => {\n    const dependsOn = options.dependsOn?.map(dep =>\n      typeof dep === \"string\" ? dep : dep.apiName\n    );\n    const dependsOnObjects = options.dependsOnObjects?.map(obj => ({\n      $apiName: obj.$objectType ?? obj.$apiName,\n      $primaryKey: obj.$primaryKey,\n    }));\n\n    return this.__experimentalStore.functions.observe(\n      {\n        ...options,\n        queryDef,\n        params,\n        dependsOn,\n        dependsOnObjects,\n      },\n      subFn as unknown as Observer<FunctionPayload>,\n    );\n  };\n\n  public observeLinks: <\n    T extends ObjectOrInterfaceDefinition,\n    L extends keyof CompileTimeMetadata<T>[\"links\"] & string,\n  >(\n    objects: Osdk.Instance<T> | Array<Osdk.Instance<T>>,\n    linkName: L,\n    options: ObserveLinks.Options<T, L>,\n    subFn: Observer<\n      ObserveLinks.CallbackArgs<\n        CompileTimeMetadata<T>[\"links\"][L][\"targetType\"]\n      >\n    >,\n  ) => Unsubscribable = (objects, linkName, options, subFn) => {\n    const objectsArray = Array.isArray(objects) ? objects : [objects];\n    const observer = subFn as unknown as Observer<SpecificLinkPayload>;\n\n    return objectsArray.length <= 1\n      ? observeSingleLink(\n        this.__experimentalStore,\n        objectsArray,\n        linkName,\n        options,\n        observer,\n      )\n      : observeMultiLinks(\n        this.__experimentalStore,\n        objectsArray,\n        linkName,\n        options,\n        observer,\n      );\n  };\n\n  public applyAction: <Q extends ActionDefinition<any>>(\n    action: Q,\n    args: Parameters<ActionSignatureFromDef<Q>[\"applyAction\"]>[0],\n    opts?: ObservableClient.ApplyActionOptions,\n  ) => Promise<ActionEditResponse>;\n\n  public validateAction: <Q extends ActionDefinition<any>>(\n    action: Q,\n    args: Parameters<ActionSignatureFromDef<Q>[\"applyAction\"]>[0],\n  ) => Promise<ActionValidationResponse>;\n\n  public observeObjectSet<\n    T extends ObjectTypeDefinition,\n    RDPs extends Record<\n      string,\n      WirePropertyTypes | undefined | Array<WirePropertyTypes>\n    > = {},\n  >(\n    baseObjectSet: ObjectSet<T>,\n    options: ObserveObjectSetOptions<T, RDPs>,\n    subFn: Observer<ObserveObjectSetArgs<T, RDPs>>,\n  ): Unsubscribable {\n    return this.__experimentalStore.objectSets.observe(\n      { baseObjectSet, ...options },\n      // cast to cross typed to untyped barrier\n      subFn as unknown as Observer<ObjectSetPayload>,\n    );\n  }\n\n  public invalidateAll(): Promise<void> {\n    return this.__experimentalStore.invalidateAll();\n  }\n\n  public invalidateObjects(\n    objects:\n      | Osdk.Instance<ObjectTypeDefinition>\n      | ReadonlyArray<Osdk.Instance<ObjectTypeDefinition>>,\n  ): Promise<void> {\n    return this.__experimentalStore.invalidateObjects(objects);\n  }\n\n  public invalidateObjectType<T extends ObjectTypeDefinition>(\n    type: T | T[\"apiName\"],\n  ): Promise<void> {\n    return this.__experimentalStore.invalidateObjectType(type, undefined);\n  }\n\n  public invalidateFunction(\n    apiName: string | QueryDefinition<unknown>,\n    params?: Record<string, unknown>,\n  ): Promise<void> {\n    return this.__experimentalStore.invalidateFunction(apiName, params);\n  }\n\n  public invalidateFunctionsByObject(\n    apiName: string,\n    primaryKey: string | number,\n  ): Promise<void> {\n    return this.__experimentalStore.invalidateFunctionsByObject(\n      apiName,\n      primaryKey,\n    );\n  }\n\n  public canonicalizeWhereClause<\n    T extends ObjectTypeDefinition | InterfaceDefinition,\n    RDPs extends Record<string, SimplePropertyDef> = {},\n  >(where: WhereClause<T, RDPs>): Canonical<WhereClause<T, RDPs>> {\n    return this.__experimentalStore.whereCanonicalizer\n      .canonicalize(where) as Canonical<WhereClause<T, RDPs>>;\n  }\n}\n\nfunction observeSingleLink(\n  store: Store,\n  objectsArray: ReadonlyArray<Osdk.Instance<ObjectOrInterfaceDefinition>>,\n  linkName: string,\n  options: ObserveLinks.Options<ObjectOrInterfaceDefinition, string>,\n  observer: Observer<SpecificLinkPayload>,\n): Unsubscribable {\n  if (objectsArray.length === 0) {\n    observer.next({\n      resolvedList: [],\n      isOptimistic: false,\n      lastUpdated: 0,\n      fetchMore: () => Promise.resolve(),\n      hasMore: false,\n      status: \"loaded\",\n      totalCount: \"0\",\n    });\n    return new UnsubscribableWrapper(new Subscription());\n  }\n\n  const parentSub = new Subscription();\n\n  for (const obj of objectsArray) {\n    parentSub.add(\n      store.links.observe(\n        {\n          ...options,\n          srcType: {\n            type: \"object\",\n            apiName: obj.$objectType ?? obj.$apiName,\n          },\n          linkName,\n          pk: obj.$primaryKey,\n        },\n        observer,\n      ),\n    );\n  }\n\n  return new UnsubscribableWrapper(parentSub);\n}\n\nfunction observeMultiLinks(\n  store: Store,\n  objectsArray: ReadonlyArray<Osdk.Instance<ObjectOrInterfaceDefinition>>,\n  linkName: string,\n  options: ObserveLinks.Options<ObjectOrInterfaceDefinition, string>,\n  observer: Observer<SpecificLinkPayload>,\n): Unsubscribable {\n  const parentSub = new Subscription();\n  const totalExpected = objectsArray.length;\n  const perObjectResults = new Map<string, SpecificLinkPayload>();\n  let errored = false;\n\n  function mergeAndEmit() {\n    if (errored) {\n      return;\n    }\n\n    const seen = new Map<string, SpecificLinkPayload[\"resolvedList\"][number]>();\n    const fetchMores: Array<() => Promise<void>> = [];\n    let latestUpdated = 0;\n    let hasMore = false;\n    let isOptimistic = false;\n\n    for (const payload of perObjectResults.values()) {\n      for (const obj of payload.resolvedList) {\n        seen.set(`${obj.$objectType}:${obj.$primaryKey}`, obj);\n      }\n      if (payload.lastUpdated > latestUpdated) {\n        latestUpdated = payload.lastUpdated;\n      }\n      if (payload.isOptimistic) {\n        isOptimistic = true;\n      }\n      if (payload.hasMore) {\n        hasMore = true;\n        fetchMores.push(payload.fetchMore);\n      }\n    }\n\n    const payloads = [...perObjectResults.values()];\n    const loading = perObjectResults.size < totalExpected\n      || payloads.some(p => p.status === \"init\" || p.status === \"loading\");\n\n    observer.next({\n      resolvedList: Array.from(seen.values()),\n      isOptimistic,\n      lastUpdated: latestUpdated,\n      fetchMore: hasMore\n        ? () => Promise.all(fetchMores.map(fn => fn())).then(() => {})\n        : () => Promise.resolve(),\n      hasMore,\n      status: loading\n        ? \"loading\"\n        : payloads.some(p => p.status === \"error\")\n        ? \"error\"\n        : \"loaded\",\n      ...(!hasMore ? { totalCount: String(seen.size) } : {}),\n    });\n  }\n\n  for (const obj of objectsArray) {\n    const objKey = `${obj.$objectType ?? obj.$apiName}:${obj.$primaryKey}`;\n\n    parentSub.add(\n      store.links.observe(\n        {\n          ...options,\n          srcType: {\n            type: \"object\",\n            apiName: obj.$objectType ?? obj.$apiName,\n          },\n          linkName,\n          pk: obj.$primaryKey,\n        },\n        {\n          next: (payload: SpecificLinkPayload) => {\n            if (errored) {\n              return;\n            }\n            perObjectResults.set(objKey, payload);\n            mergeAndEmit();\n          },\n          error: (err: unknown) => {\n            if (errored) {\n              return;\n            }\n            errored = true;\n            parentSub.unsubscribe();\n            observer.error(err);\n          },\n          // store link queries are long-lived and do not complete\n          complete: () => {},\n        },\n      ),\n    );\n  }\n\n  return new UnsubscribableWrapper(parentSub);\n}\n"],"mappings":"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","ignoreList":[]}

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

@@ -16,14 +16,14 @@
 
 export class PivotCanonicalizer {
   #cache = new Map();
-  canonicalize(sourceType, linkName) {
-    const key = `${sourceType}::${linkName}`;
+  canonicalize(sourceType, sourceTypeKind, linkName) {
+    const key = `${sourceTypeKind}:${sourceType}::${linkName}`;
     let canonical = this.#cache.get(key);
     if (!canonical) {
       canonical = {
         sourceType,
-        linkName,
-        targetType: "<targetType>"
+        sourceTypeKind,
+        linkName
       };
       this.#cache.set(key, canonical);
     }

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

@@ -1 +1 @@
-{"version":3,"file":"PivotCanonicalizer.js","names":["PivotCanonicalizer","cache","Map","canonicalize","sourceType","linkName","key","canonical","get","targetType","set"],"sources":["PivotCanonicalizer.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 { Canonical } from \"./Canonical.js\";\n\nexport interface PivotInfo {\n  sourceType: string;\n  linkName: string;\n  targetType: string;\n}\n\nexport class PivotCanonicalizer {\n  #cache = new Map<string, Canonical<PivotInfo>>();\n\n  canonicalize(sourceType: string, linkName: string): Canonical<PivotInfo> {\n    const key = `${sourceType}::${linkName}`;\n\n    let canonical = this.#cache.get(key);\n\n    if (!canonical) {\n      canonical = {\n        sourceType,\n        linkName,\n        targetType: \"<targetType>\",\n      } as Canonical<PivotInfo>;\n      this.#cache.set(key, canonical);\n    }\n\n    return canonical;\n  }\n}\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAUA,OAAO,MAAMA,kBAAkB,CAAC;EAC9B,CAACC,KAAK,GAAG,IAAIC,GAAG,CAA+B,CAAC;EAEhDC,YAAYA,CAACC,UAAkB,EAAEC,QAAgB,EAAwB;IACvE,MAAMC,GAAG,GAAG,GAAGF,UAAU,KAAKC,QAAQ,EAAE;IAExC,IAAIE,SAAS,GAAG,IAAI,CAAC,CAACN,KAAK,CAACO,GAAG,CAACF,GAAG,CAAC;IAEpC,IAAI,CAACC,SAAS,EAAE;MACdA,SAAS,GAAG;QACVH,UAAU;QACVC,QAAQ;QACRI,UAAU,EAAE;MACd,CAAyB;MACzB,IAAI,CAAC,CAACR,KAAK,CAACS,GAAG,CAACJ,GAAG,EAAEC,SAAS,CAAC;IACjC;IAEA,OAAOA,SAAS;EAClB;AACF","ignoreList":[]}
+{"version":3,"file":"PivotCanonicalizer.js","names":["PivotCanonicalizer","cache","Map","canonicalize","sourceType","sourceTypeKind","linkName","key","canonical","get","set"],"sources":["PivotCanonicalizer.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 { Canonical } from \"./Canonical.js\";\n\nexport interface PivotInfo {\n  sourceType: string;\n  sourceTypeKind: \"object\" | \"interface\";\n  linkName: string;\n}\n\nexport class PivotCanonicalizer {\n  #cache = new Map<string, Canonical<PivotInfo>>();\n\n  canonicalize(\n    sourceType: string,\n    sourceTypeKind: \"object\" | \"interface\",\n    linkName: string,\n  ): Canonical<PivotInfo> {\n    const key = `${sourceTypeKind}:${sourceType}::${linkName}`;\n\n    let canonical = this.#cache.get(key);\n\n    if (!canonical) {\n      canonical = {\n        sourceType,\n        sourceTypeKind,\n        linkName,\n      } as Canonical<PivotInfo>;\n      this.#cache.set(key, canonical);\n    }\n\n    return canonical;\n  }\n}\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAUA,OAAO,MAAMA,kBAAkB,CAAC;EAC9B,CAACC,KAAK,GAAG,IAAIC,GAAG,CAA+B,CAAC;EAEhDC,YAAYA,CACVC,UAAkB,EAClBC,cAAsC,EACtCC,QAAgB,EACM;IACtB,MAAMC,GAAG,GAAG,GAAGF,cAAc,IAAID,UAAU,KAAKE,QAAQ,EAAE;IAE1D,IAAIE,SAAS,GAAG,IAAI,CAAC,CAACP,KAAK,CAACQ,GAAG,CAACF,GAAG,CAAC;IAEpC,IAAI,CAACC,SAAS,EAAE;MACdA,SAAS,GAAG;QACVJ,UAAU;QACVC,cAAc;QACdC;MACF,CAAyB;MACzB,IAAI,CAAC,CAACL,KAAK,CAACS,GAAG,CAACH,GAAG,EAAEC,SAAS,CAAC;IACjC;IAEA,OAAOA,SAAS;EAClB;AACF","ignoreList":[]}

package/build/esm/observable/internal/Store.test.js

@@ -24,9 +24,10 @@ import { ActionValidationError } from "../../actions/ActionValidationError.js";
 import { createClient } from "../../createClient.js";
 import { TestLogger } from "../../logger/TestLogger.js";
 import { runOptimisticJob } from "./actions/OptimisticJob.js";
+import { ObservableClientImpl } from "./ObservableClientImpl.js";
 import { createOptimisticId } from "./OptimisticId.js";
 import { Store } from "./Store.js";
-import { applyCustomMatchers, createClientMockHelper, createDefer, expectNoMoreCalls, expectSingleLinkCallAndClear, expectSingleListCallAndClear, expectSingleObjectCallAndClear, getObject, mockListSubCallback, mockObserver, mockSingleSubCallback, objectPayloadContaining, updateList, updateObject, waitForCall } from "./testUtils.js";
+import { applyCustomMatchers, createClientMockHelper, createDefer, expectNoMoreCalls, expectSingleLinkCallAndClear, expectSingleListCallAndClear, expectSingleObjectCallAndClear, getObject, mockLinkSubCallback, mockListSubCallback, mockObserver, mockSingleSubCallback, objectPayloadContaining, updateList, updateObject, waitForCall } from "./testUtils.js";
 import { invalidateList } from "./testUtils/invalidateList.js";
 import { expectStandardObserveLink } from "./testUtils/observeLink/expectStandardObserveLink.js";
 import { expectStandardObserveObject } from "./testUtils/observeObject/expectStandardObserveObject.js";
@@ -300,6 +301,189 @@ describe(Store, () => {
       expect(empSubFn.next).not.toHaveBeenCalled();
       expect(officeSubFn.next).not.toHaveBeenCalled();
     });
+    describe("multi-object observeLinks", () => {
+      function getLastPayload(subFn) {
+        const calls = subFn.next.mock.calls;
+        return calls[calls.length - 1][0];
+      }
+      async function waitForLoaded(subFn) {
+        await vi.waitFor(() => {
+          expect(getLastPayload(subFn)?.status).toBe("loaded");
+        }, {
+          interval: 0
+        });
+      }
+      it("returns linked objects from all source objects", async () => {
+        const observableClient = new ObservableClientImpl(cache);
+        const {
+          payload: emp1Payload
+        } = await expectStandardObserveObject({
+          cache,
+          type: Employee,
+          primaryKey: 1
+        });
+        const emp1 = emp1Payload?.object;
+        !emp1 ? process.env.NODE_ENV !== "production" ? invariant(false) : invariant(false) : void 0;
+        const {
+          payload: emp2Payload
+        } = await expectStandardObserveObject({
+          cache,
+          type: Employee,
+          primaryKey: 2
+        });
+        const emp2 = emp2Payload?.object;
+        !emp2 ? process.env.NODE_ENV !== "production" ? invariant(false) : invariant(false) : void 0;
+        const linkSubFn = mockLinkSubCallback();
+        defer(observableClient.observeLinks([emp1, emp2], "officeLink", {
+          linkName: "officeLink"
+        },
+        // @ts-expect-error crossing typed/untyped barrier for test
+        linkSubFn));
+        await waitForLoaded(linkSubFn);
+        const lastPayload = getLastPayload(linkSubFn);
+        expect(lastPayload.resolvedList).toHaveLength(2);
+        expect(lastPayload.resolvedList).toEqual(expect.arrayContaining([expect.objectContaining({
+          $primaryKey: "101"
+        }), expect.objectContaining({
+          $primaryKey: "102"
+        })]));
+        expect(lastPayload.totalCount).toBe("2");
+      });
+      it("deduplicates when multiple sources link to the same target", async () => {
+        const dataStore = fauxFoundry.getDefaultDataStore();
+
+        // emp1 already links to office1; add emp3 -> office1 too
+        dataStore.registerLink({
+          __apiName: "Employee",
+          __primaryKey: 3
+        }, "officeLink", {
+          __apiName: "Office",
+          __primaryKey: "101"
+        }, "occupants");
+        try {
+          const observableClient = new ObservableClientImpl(cache);
+          const {
+            payload: emp1Payload
+          } = await expectStandardObserveObject({
+            cache,
+            type: Employee,
+            primaryKey: 1
+          });
+          const emp1 = emp1Payload?.object;
+          !emp1 ? process.env.NODE_ENV !== "production" ? invariant(false) : invariant(false) : void 0;
+          const {
+            payload: emp3Payload
+          } = await expectStandardObserveObject({
+            cache,
+            type: Employee,
+            primaryKey: 3
+          });
+          const emp3 = emp3Payload?.object;
+          !emp3 ? process.env.NODE_ENV !== "production" ? invariant(false) : invariant(false) : void 0;
+          const linkSubFn = mockLinkSubCallback();
+          defer(observableClient.observeLinks([emp1, emp3], "officeLink", {
+            linkName: "officeLink"
+          },
+          // @ts-expect-error crossing typed/untyped barrier for test
+          linkSubFn));
+          await waitForLoaded(linkSubFn);
+          const lastPayload = getLastPayload(linkSubFn);
+          expect(lastPayload.resolvedList).toHaveLength(1);
+          expect(lastPayload.resolvedList[0].$primaryKey).toBe("101");
+          expect(lastPayload.totalCount).toBe("1");
+        } finally {
+          dataStore.unregisterLink({
+            __apiName: "Employee",
+            __primaryKey: 3
+          }, "officeLink", {
+            __apiName: "Office",
+            __primaryKey: "101"
+          }, "occupants");
+        }
+      });
+      it("leaves totalCount undefined when sub-queries are still paginating", async () => {
+        const dataStore = fauxFoundry.getDefaultDataStore();
+
+        // Ensure emp1 has at least 2 peeps links (MANY cardinality).
+        // Prior tests may have removed the original johnDoe peep,
+        // so we register two fresh links to guarantee pagination with pageSize=1.
+        dataStore.registerLink({
+          __apiName: "Employee",
+          __primaryKey: 1
+        }, "peeps", {
+          __apiName: "Employee",
+          __primaryKey: 3
+        }, "lead");
+        dataStore.registerLink({
+          __apiName: "Employee",
+          __primaryKey: 1
+        }, "peeps", {
+          __apiName: "Employee",
+          __primaryKey: 4
+        }, "lead");
+        const observableClient = new ObservableClientImpl(cache);
+        const {
+          payload: emp1Payload
+        } = await expectStandardObserveObject({
+          cache,
+          type: Employee,
+          primaryKey: 1
+        });
+        const emp1 = emp1Payload?.object;
+        !emp1 ? process.env.NODE_ENV !== "production" ? invariant(false) : invariant(false) : void 0;
+        const {
+          payload: emp2Payload
+        } = await expectStandardObserveObject({
+          cache,
+          type: Employee,
+          primaryKey: 2
+        });
+        const emp2 = emp2Payload?.object;
+        !emp2 ? process.env.NODE_ENV !== "production" ? invariant(false) : invariant(false) : void 0;
+        const linkSubFn = mockLinkSubCallback();
+
+        // emp1 has 2 peeps but pageSize=1, so emp1's query has hasMore=true.
+        // emp2 has 0 peeps, so its query finishes immediately.
+        defer(observableClient.observeLinks([emp1, emp2], "peeps", {
+          linkName: "peeps",
+          pageSize: 1
+        },
+        // @ts-expect-error crossing typed/untyped barrier for test
+        linkSubFn));
+        await waitForLoaded(linkSubFn);
+        const lastPayload = getLastPayload(linkSubFn);
+        expect(lastPayload.hasMore).toBe(true);
+        expect(lastPayload.totalCount).toBeUndefined();
+      });
+      it("single object fast path still works", async () => {
+        const observableClient = new ObservableClientImpl(cache);
+        const {
+          payload: emp1Payload
+        } = await expectStandardObserveObject({
+          cache,
+          type: Employee,
+          primaryKey: 1
+        });
+        const emp1 = emp1Payload?.object;
+        !emp1 ? process.env.NODE_ENV !== "production" ? invariant(false) : invariant(false) : void 0;
+        const linkSubFn = mockLinkSubCallback();
+        defer(observableClient.observeLinks(emp1, "officeLink", {
+          linkName: "officeLink"
+        },
+        // @ts-expect-error crossing typed/untyped barrier for test
+        linkSubFn));
+        await waitForCall(linkSubFn);
+        expectSingleLinkCallAndClear(linkSubFn, [], {
+          status: "loading"
+        });
+        await waitForCall(linkSubFn);
+        expectSingleLinkCallAndClear(linkSubFn, [expect.objectContaining({
+          $primaryKey: "101"
+        })], {
+          status: "loaded"
+        });
+      });
+    });
   });
   describe("with mock server", () => {
     let client;