@osdk/client 2.8.0-beta.20 → 2.8.0-beta.21

package/CHANGELOG.md

@@ -1,5 +1,18 @@
 # @osdk/client
 
+## 2.8.0-beta.21
+
+### Minor Changes
+
+- c40444b: Add linkedObjectsBySourcePrimaryKey to link observation responses
+- dda14be: Fix pagination sort shuffling by using declarative update types
+
+### Patch Changes
+
+- @osdk/api@2.8.0-beta.21
+- @osdk/client.unstable@2.8.0-beta.21
+- @osdk/generator-converters@2.8.0-beta.21
+
 ## 2.8.0-beta.20
 
 ### Patch Changes

package/build/browser/object/aggregate.js

@@ -44,6 +44,9 @@ export async function aggregate(clientCtx, objectType, objectSet = resolveBaseOb
     branch: clientCtx.branch,
     transactionId: clientCtx.transactionId
   });
+  if (!result.data || !Array.isArray(result.data)) {
+    throw new Error(`Aggregation request failed: ${JSON.stringify(result)}`);
+  }
   if (!req.$groupBy) {
     !(result.data.length === 1) ? process.env.NODE_ENV !== "production" ? invariant(false, "no group by clause should mean only one data result") : invariant(false) : void 0;
     return {

package/build/browser/object/aggregate.js.map

@@ -1 +1 @@
-{"version":3,"file":"aggregate.js","names":["OntologyObjectSets","invariant","legacyToModernSingleAggregationResult","modernToLegacyAggregationClause","modernToLegacyGroupByClause","addUserAgentAndRequestContextHeaders","resolveBaseObjectSetType","aggregate","clientCtx","objectType","objectSet","req","body","aggregation","$select","groupBy","where","undefined","$groupBy","flushEdits","result","ontologyRid","branch","transactionId","data","length","process","env","NODE_ENV","aggregationToCountResult","ret","map","entry","$group","group","aggregateResult","metrics","name","$count","value"],"sources":["aggregate.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  AggregateOpts,\n  AggregateOptsThatErrorsAndDisallowsOrderingWithMultipleGroupBy,\n  AggregationResultsWithGroups,\n  AggregationsResults,\n  ObjectOrInterfaceDefinition,\n} from \"@osdk/api\";\nimport type {\n  AggregateObjectsRequestV2,\n  AggregateObjectsResponseV2,\n  ObjectSet,\n} from \"@osdk/foundry.ontologies\";\nimport * as OntologyObjectSets from \"@osdk/foundry.ontologies/OntologyObjectSet\";\nimport invariant from \"tiny-invariant\";\nimport { legacyToModernSingleAggregationResult } from \"../internal/conversions/legacyToModernSingleAggregationResult.js\";\nimport { modernToLegacyAggregationClause } from \"../internal/conversions/modernToLegacyAggregationClause.js\";\nimport { modernToLegacyGroupByClause } from \"../internal/conversions/modernToLegacyGroupByClause.js\";\nimport type { MinimalClient } from \"../MinimalClientContext.js\";\nimport { addUserAgentAndRequestContextHeaders } from \"../util/addUserAgentAndRequestContextHeaders.js\";\nimport type { ArrayElement } from \"../util/ArrayElement.js\";\nimport { resolveBaseObjectSetType } from \"../util/objectSetUtils.js\";\n\n/** @internal */\nexport async function aggregate<\n  Q extends ObjectOrInterfaceDefinition,\n  AO extends AggregateOpts<Q>,\n>(\n  clientCtx: MinimalClient,\n  objectType: Q,\n  objectSet: ObjectSet = resolveBaseObjectSetType(objectType),\n  req: AggregateOptsThatErrorsAndDisallowsOrderingWithMultipleGroupBy<Q, AO>,\n): Promise<AggregationsResults<Q, AO>> {\n  const resolvedObjectSet = resolveBaseObjectSetType(objectType);\n  const body: AggregateObjectsRequestV2 = {\n    aggregation: modernToLegacyAggregationClause<AO[\"$select\"]>(\n      req.$select,\n    ),\n    groupBy: [],\n    where: undefined,\n  };\n\n  if (req.$groupBy) {\n    body.groupBy = modernToLegacyGroupByClause(req.$groupBy);\n  }\n\n  if (clientCtx.flushEdits != null) {\n    await clientCtx.flushEdits();\n  }\n\n  const result = await OntologyObjectSets.aggregate(\n    addUserAgentAndRequestContextHeaders(clientCtx, objectType),\n    await clientCtx.ontologyRid,\n    {\n      objectSet,\n      groupBy: body.groupBy,\n      aggregation: body.aggregation,\n    },\n    { branch: clientCtx.branch, transactionId: clientCtx.transactionId },\n  );\n\n  if (!req.$groupBy) {\n    invariant(\n      result.data.length === 1,\n      \"no group by clause should mean only one data result\",\n    );\n\n    return {\n      ...aggregationToCountResult(result.data[0]),\n      ...legacyToModernSingleAggregationResult(\n        result.data[0],\n      ),\n    } as any;\n  }\n\n  const ret: AggregationResultsWithGroups<Q, AO[\"$select\"], any> = result.data\n    .map((entry) => {\n      return {\n        $group: entry.group as any,\n        ...aggregationToCountResult(entry),\n        ...legacyToModernSingleAggregationResult(entry),\n      };\n    }) as any; // fixme\n\n  return ret as any; // FIXME\n}\n\nfunction aggregationToCountResult(\n  entry: ArrayElement<AggregateObjectsResponseV2[\"data\"]>,\n): { $count: number } | undefined {\n  for (const aggregateResult of entry.metrics) {\n    if (aggregateResult.name === \"count\") {\n      return { $count: aggregateResult.value };\n    }\n  }\n}\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAcA,OAAO,KAAKA,kBAAkB,MAAM,4CAA4C;AAChF,OAAOC,SAAS,MAAM,gBAAgB;AACtC,SAASC,qCAAqC,QAAQ,kEAAkE;AACxH,SAASC,+BAA+B,QAAQ,4DAA4D;AAC5G,SAASC,2BAA2B,QAAQ,wDAAwD;AAEpG,SAASC,oCAAoC,QAAQ,iDAAiD;AAEtG,SAASC,wBAAwB,QAAQ,2BAA2B;;AAEpE;AACA,OAAO,eAAeC,SAASA,CAI7BC,SAAwB,EACxBC,UAAa,EACbC,SAAoB,GAAGJ,wBAAwB,CAACG,UAAU,CAAC,EAC3DE,GAA0E,EACrC;EACXL,wBAAwB,CAACG,UAAU,CAAC;EAC9D,MAAMG,IAA+B,GAAG;IACtCC,WAAW,EAAEV,+BAA+B,CAC1CQ,GAAG,CAACG,OACN,CAAC;IACDC,OAAO,EAAE,EAAE;IACXC,KAAK,EAAEC;EACT,CAAC;EAED,IAAIN,GAAG,CAACO,QAAQ,EAAE;IAChBN,IAAI,CAACG,OAAO,GAAGX,2BAA2B,CAACO,GAAG,CAACO,QAAQ,CAAC;EAC1D;EAEA,IAAIV,SAAS,CAACW,UAAU,IAAI,IAAI,EAAE;IAChC,MAAMX,SAAS,CAACW,UAAU,CAAC,CAAC;EAC9B;EAEA,MAAMC,MAAM,GAAG,MAAMpB,kBAAkB,CAACO,SAAS,CAC/CF,oCAAoC,CAACG,SAAS,EAAEC,UAAU,CAAC,EAC3D,MAAMD,SAAS,CAACa,WAAW,EAC3B;IACEX,SAAS;IACTK,OAAO,EAAEH,IAAI,CAACG,OAAO;IACrBF,WAAW,EAAED,IAAI,CAACC;EACpB,CAAC,EACD;IAAES,MAAM,EAAEd,SAAS,CAACc,MAAM;IAAEC,aAAa,EAAEf,SAAS,CAACe;EAAc,CACrE,CAAC;EAED,IAAI,CAACZ,GAAG,CAACO,QAAQ,EAAE;IACjB,EACEE,MAAM,CAACI,IAAI,CAACC,MAAM,KAAK,CAAC,IAAAC,OAAA,CAAAC,GAAA,CAAAC,QAAA,oBAD1B3B,SAAS,QAEP,qDAAqD,IAFvDA,SAAS;IAKT,OAAO;MACL,GAAG4B,wBAAwB,CAACT,MAAM,CAACI,IAAI,CAAC,CAAC,CAAC,CAAC;MAC3C,GAAGtB,qCAAqC,CACtCkB,MAAM,CAACI,IAAI,CAAC,CAAC,CACf;IACF,CAAC;EACH;EAEA,MAAMM,GAAwD,GAAGV,MAAM,CAACI,IAAI,CACzEO,GAAG,CAAEC,KAAK,IAAK;IACd,OAAO;MACLC,MAAM,EAAED,KAAK,CAACE,KAAY;MAC1B,GAAGL,wBAAwB,CAACG,KAAK,CAAC;MAClC,GAAG9B,qCAAqC,CAAC8B,KAAK;IAChD,CAAC;EACH,CAAC,CAAQ,CAAC,CAAC;;EAEb,OAAOF,GAAG,CAAQ,CAAC;AACrB;AAEA,SAASD,wBAAwBA,CAC/BG,KAAuD,EACvB;EAChC,KAAK,MAAMG,eAAe,IAAIH,KAAK,CAACI,OAAO,EAAE;IAC3C,IAAID,eAAe,CAACE,IAAI,KAAK,OAAO,EAAE;MACpC,OAAO;QAAEC,MAAM,EAAEH,eAAe,CAACI;MAAM,CAAC;IAC1C;EACF;AACF","ignoreList":[]}
+{"version":3,"file":"aggregate.js","names":["OntologyObjectSets","invariant","legacyToModernSingleAggregationResult","modernToLegacyAggregationClause","modernToLegacyGroupByClause","addUserAgentAndRequestContextHeaders","resolveBaseObjectSetType","aggregate","clientCtx","objectType","objectSet","req","body","aggregation","$select","groupBy","where","undefined","$groupBy","flushEdits","result","ontologyRid","branch","transactionId","data","Array","isArray","Error","JSON","stringify","length","process","env","NODE_ENV","aggregationToCountResult","ret","map","entry","$group","group","aggregateResult","metrics","name","$count","value"],"sources":["aggregate.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  AggregateOpts,\n  AggregateOptsThatErrorsAndDisallowsOrderingWithMultipleGroupBy,\n  AggregationResultsWithGroups,\n  AggregationsResults,\n  ObjectOrInterfaceDefinition,\n} from \"@osdk/api\";\nimport type {\n  AggregateObjectsRequestV2,\n  AggregateObjectsResponseV2,\n  ObjectSet,\n} from \"@osdk/foundry.ontologies\";\nimport * as OntologyObjectSets from \"@osdk/foundry.ontologies/OntologyObjectSet\";\nimport invariant from \"tiny-invariant\";\nimport { legacyToModernSingleAggregationResult } from \"../internal/conversions/legacyToModernSingleAggregationResult.js\";\nimport { modernToLegacyAggregationClause } from \"../internal/conversions/modernToLegacyAggregationClause.js\";\nimport { modernToLegacyGroupByClause } from \"../internal/conversions/modernToLegacyGroupByClause.js\";\nimport type { MinimalClient } from \"../MinimalClientContext.js\";\nimport { addUserAgentAndRequestContextHeaders } from \"../util/addUserAgentAndRequestContextHeaders.js\";\nimport type { ArrayElement } from \"../util/ArrayElement.js\";\nimport { resolveBaseObjectSetType } from \"../util/objectSetUtils.js\";\n\n/** @internal */\nexport async function aggregate<\n  Q extends ObjectOrInterfaceDefinition,\n  AO extends AggregateOpts<Q>,\n>(\n  clientCtx: MinimalClient,\n  objectType: Q,\n  objectSet: ObjectSet = resolveBaseObjectSetType(objectType),\n  req: AggregateOptsThatErrorsAndDisallowsOrderingWithMultipleGroupBy<Q, AO>,\n): Promise<AggregationsResults<Q, AO>> {\n  const resolvedObjectSet = resolveBaseObjectSetType(objectType);\n  const body: AggregateObjectsRequestV2 = {\n    aggregation: modernToLegacyAggregationClause<AO[\"$select\"]>(\n      req.$select,\n    ),\n    groupBy: [],\n    where: undefined,\n  };\n\n  if (req.$groupBy) {\n    body.groupBy = modernToLegacyGroupByClause(req.$groupBy);\n  }\n\n  if (clientCtx.flushEdits != null) {\n    await clientCtx.flushEdits();\n  }\n\n  const result = await OntologyObjectSets.aggregate(\n    addUserAgentAndRequestContextHeaders(clientCtx, objectType),\n    await clientCtx.ontologyRid,\n    {\n      objectSet,\n      groupBy: body.groupBy,\n      aggregation: body.aggregation,\n    },\n    { branch: clientCtx.branch, transactionId: clientCtx.transactionId },\n  );\n\n  if (!result.data || !Array.isArray(result.data)) {\n    throw new Error(\n      `Aggregation request failed: ${JSON.stringify(result)}`,\n    );\n  }\n\n  if (!req.$groupBy) {\n    invariant(\n      result.data.length === 1,\n      \"no group by clause should mean only one data result\",\n    );\n\n    return {\n      ...aggregationToCountResult(result.data[0]),\n      ...legacyToModernSingleAggregationResult(\n        result.data[0],\n      ),\n    } as any;\n  }\n\n  const ret: AggregationResultsWithGroups<Q, AO[\"$select\"], any> = result.data\n    .map((entry) => {\n      return {\n        $group: entry.group as any,\n        ...aggregationToCountResult(entry),\n        ...legacyToModernSingleAggregationResult(entry),\n      };\n    }) as any; // fixme\n\n  return ret as any; // FIXME\n}\n\nfunction aggregationToCountResult(\n  entry: ArrayElement<AggregateObjectsResponseV2[\"data\"]>,\n): { $count: number } | undefined {\n  for (const aggregateResult of entry.metrics) {\n    if (aggregateResult.name === \"count\") {\n      return { $count: aggregateResult.value };\n    }\n  }\n}\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAcA,OAAO,KAAKA,kBAAkB,MAAM,4CAA4C;AAChF,OAAOC,SAAS,MAAM,gBAAgB;AACtC,SAASC,qCAAqC,QAAQ,kEAAkE;AACxH,SAASC,+BAA+B,QAAQ,4DAA4D;AAC5G,SAASC,2BAA2B,QAAQ,wDAAwD;AAEpG,SAASC,oCAAoC,QAAQ,iDAAiD;AAEtG,SAASC,wBAAwB,QAAQ,2BAA2B;;AAEpE;AACA,OAAO,eAAeC,SAASA,CAI7BC,SAAwB,EACxBC,UAAa,EACbC,SAAoB,GAAGJ,wBAAwB,CAACG,UAAU,CAAC,EAC3DE,GAA0E,EACrC;EACXL,wBAAwB,CAACG,UAAU,CAAC;EAC9D,MAAMG,IAA+B,GAAG;IACtCC,WAAW,EAAEV,+BAA+B,CAC1CQ,GAAG,CAACG,OACN,CAAC;IACDC,OAAO,EAAE,EAAE;IACXC,KAAK,EAAEC;EACT,CAAC;EAED,IAAIN,GAAG,CAACO,QAAQ,EAAE;IAChBN,IAAI,CAACG,OAAO,GAAGX,2BAA2B,CAACO,GAAG,CAACO,QAAQ,CAAC;EAC1D;EAEA,IAAIV,SAAS,CAACW,UAAU,IAAI,IAAI,EAAE;IAChC,MAAMX,SAAS,CAACW,UAAU,CAAC,CAAC;EAC9B;EAEA,MAAMC,MAAM,GAAG,MAAMpB,kBAAkB,CAACO,SAAS,CAC/CF,oCAAoC,CAACG,SAAS,EAAEC,UAAU,CAAC,EAC3D,MAAMD,SAAS,CAACa,WAAW,EAC3B;IACEX,SAAS;IACTK,OAAO,EAAEH,IAAI,CAACG,OAAO;IACrBF,WAAW,EAAED,IAAI,CAACC;EACpB,CAAC,EACD;IAAES,MAAM,EAAEd,SAAS,CAACc,MAAM;IAAEC,aAAa,EAAEf,SAAS,CAACe;EAAc,CACrE,CAAC;EAED,IAAI,CAACH,MAAM,CAACI,IAAI,IAAI,CAACC,KAAK,CAACC,OAAO,CAACN,MAAM,CAACI,IAAI,CAAC,EAAE;IAC/C,MAAM,IAAIG,KAAK,CACb,+BAA+BC,IAAI,CAACC,SAAS,CAACT,MAAM,CAAC,EACvD,CAAC;EACH;EAEA,IAAI,CAACT,GAAG,CAACO,QAAQ,EAAE;IACjB,EACEE,MAAM,CAACI,IAAI,CAACM,MAAM,KAAK,CAAC,IAAAC,OAAA,CAAAC,GAAA,CAAAC,QAAA,oBAD1BhC,SAAS,QAEP,qDAAqD,IAFvDA,SAAS;IAKT,OAAO;MACL,GAAGiC,wBAAwB,CAACd,MAAM,CAACI,IAAI,CAAC,CAAC,CAAC,CAAC;MAC3C,GAAGtB,qCAAqC,CACtCkB,MAAM,CAACI,IAAI,CAAC,CAAC,CACf;IACF,CAAC;EACH;EAEA,MAAMW,GAAwD,GAAGf,MAAM,CAACI,IAAI,CACzEY,GAAG,CAAEC,KAAK,IAAK;IACd,OAAO;MACLC,MAAM,EAAED,KAAK,CAACE,KAAY;MAC1B,GAAGL,wBAAwB,CAACG,KAAK,CAAC;MAClC,GAAGnC,qCAAqC,CAACmC,KAAK;IAChD,CAAC;EACH,CAAC,CAAQ,CAAC,CAAC;;EAEb,OAAOF,GAAG,CAAQ,CAAC;AACrB;AAEA,SAASD,wBAAwBA,CAC/BG,KAAuD,EACvB;EAChC,KAAK,MAAMG,eAAe,IAAIH,KAAK,CAACI,OAAO,EAAE;IAC3C,IAAID,eAAe,CAACE,IAAI,KAAK,OAAO,EAAE;MACpC,OAAO;QAAEC,MAAM,EAAEH,eAAe,CAACI;MAAM,CAAC;IAC1C;EACF;AACF","ignoreList":[]}

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

@@ -1 +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> | undefined;\n}\n"],"mappings":"","ignoreList":[]}
+{"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 extends\n  Omit<\n    ObserveLinkCallbackArgs<any>,\n    \"resolvedList\" | \"linkedObjectsBySourcePrimaryKey\"\n  >\n{\n  resolvedList: Array<ObjectHolder | InterfaceHolder> | undefined;\n  linkedObjectsBySourcePrimaryKey: ReadonlyMap<\n    string | number,\n    ReadonlyArray<ObjectHolder | InterfaceHolder>\n  >;\n}\n"],"mappings":"","ignoreList":[]}

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

@@ -1 +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    sourceUnderlyingObjectType: string;\n    pk: PrimaryKeyType<Q>;\n    linkName: L;\n    where?: WhereClause<CompileTimeMetadata<Q>[\"links\"][L][\"targetType\"]>;\n    select?: readonly string[];\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>[] | undefined;\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<\n      ObserveLinks.Options<T, L>,\n      \"srcType\" | \"pk\" | \"sourceUnderlyingObjectType\"\n    >,\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":[]}
+{"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    sourceUnderlyingObjectType: string;\n    pk: PrimaryKeyType<Q>;\n    linkName: L;\n    where?: WhereClause<CompileTimeMetadata<Q>[\"links\"][L][\"targetType\"]>;\n    select?: readonly string[];\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>[] | undefined;\n    linkedObjectsBySourcePrimaryKey: ReadonlyMap<\n      string | number,\n      ReadonlyArray<Osdk.Instance<T>>\n    >;\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<\n      ObserveLinks.Options<T, L>,\n      \"srcType\" | \"pk\" | \"sourceUnderlyingObjectType\"\n    >,\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/browser/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  ActionEditResponse,\n  ActionValidationResponse,\n  AggregateOpts,\n  AggregationsResults,\n  CompileTimeMetadata,\n  DerivedProperty,\n  ObjectOrInterfaceDefinition,\n  ObjectSet,\n  ObjectTypeDefinition,\n  Osdk,\n  PrimaryKeyType,\n  PropertyKeys,\n  QueryDefinition,\n  SimplePropertyDef,\n  WhereClause,\n  WirePropertyTypes,\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 type { QueryReturnType } from \"../queries/types.js\";\nimport { OBSERVABLE_USER_AGENT } from \"../util/UserAgent.js\";\nimport type { Canonical } from \"./internal/Canonical.js\";\nimport type { ObserveObjectSetOptions } from \"./internal/objectset/ObjectSetQueryOptions.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 ObjectOrInterfaceDefinition,\n> extends ObserveOptions {\n  apiName: T[\"apiName\"] | T;\n  pk: PrimaryKeyType<T>;\n  select?: PropertyKeys<T>[];\n}\n\nexport type OrderBy<Q extends ObjectOrInterfaceDefinition> = {\n  [K in PropertyKeys<Q>]?: \"asc\" | \"desc\" | undefined;\n};\n\nexport interface ObserveListOptions<\n  Q extends ObjectOrInterfaceDefinition,\n  RDPs extends Record<string, SimplePropertyDef> = {},\n> extends CommonObserveOptions, ObserveOptions {\n  type: Pick<Q, \"apiName\" | \"type\">;\n  where?: WhereClause<Q, RDPs>;\n  pageSize?: number;\n  orderBy?: OrderBy<Q>;\n  invalidationMode?: InvalidationMode;\n  expectedLength?: number;\n  streamUpdates?: boolean;\n  withProperties?: DerivedProperty.Clause<Q>;\n\n  /**\n   * Fetch objects by their Resource Identifiers (RIDs).\n   * When provided, starts with a static objectset containing these RIDs.\n   * Can be combined with `where` to filter the RID set, and with `orderBy` to sort results.\n   *\n   * @example\n   * // Fetch specific objects by RID\n   * observeList({ type: Employee, rids: ['ri.foo.123', 'ri.foo.456'] }, observer)\n   *\n   * @example\n   * // Fetch specific objects by RID, filtered by status\n   * observeList({\n   *   type: Employee,\n   *   rids: ['ri.foo.123', 'ri.foo.456', 'ri.foo.789'],\n   *   where: { status: 'active' }\n   * }, observer)\n   */\n  rids?: readonly string[];\n\n  /**\n   * Restrict which properties are returned for each object.\n   * When provided, only the specified properties will be fetched,\n   * reducing payload sizes for list views.\n   */\n  select?: readonly PropertyKeys<Q>[];\n\n  /**\n   * Automatically fetch additional pages on initial load.\n   *\n   * - `true`: Fetch all available pages automatically\n   * - `number`: Fetch pages until at least this many items are loaded\n   * - `undefined` (default): Only fetch the first page, user must call fetchMore()\n   *\n   * @example\n   * // Fetch all todos at once\n   * observeList({ type: Todo, autoFetchMore: true }, observer)\n   *\n   * @example\n   * // Fetch at least 100 todos\n   * observeList({ type: Todo, autoFetchMore: 100, pageSize: 25 }, observer)\n   */\n  autoFetchMore?: boolean | number;\n  intersectWith?: Array<{\n    where: WhereClause<Q, RDPs>;\n  }>;\n  pivotTo?: string;\n}\n\nexport interface ObserveObjectCallbackArgs<\n  T extends ObjectOrInterfaceDefinition,\n> {\n  object: Osdk.Instance<T> | undefined;\n  isOptimistic: boolean;\n  status: Status;\n  lastUpdated: number;\n}\n\nexport interface ObserveObjectsCallbackArgs<\n  T extends ObjectOrInterfaceDefinition,\n  RDPs extends Record<\n    string,\n    WirePropertyTypes | undefined | Array<WirePropertyTypes>\n  > = {},\n> {\n  resolvedList:\n    | Array<\n      Osdk.Instance<T, \"$allBaseProperties\", PropertyKeys<T>, RDPs>\n    >\n    | undefined;\n  isOptimistic: boolean;\n  lastUpdated: number;\n  fetchMore: () => Promise<void>;\n  hasMore: boolean;\n  status: Status;\n  totalCount?: string;\n}\n\nexport interface ObserveObjectSetArgs<\n  T extends ObjectOrInterfaceDefinition,\n  RDPs extends Record<\n    string,\n    WirePropertyTypes | undefined | Array<WirePropertyTypes>\n  > = {},\n> {\n  resolvedList:\n    | Array<\n      Osdk.Instance<T, \"$allBaseProperties\", PropertyKeys<T>, RDPs>\n    >\n    | undefined;\n  isOptimistic: boolean;\n  lastUpdated: number;\n  fetchMore: () => Promise<void>;\n  hasMore: boolean;\n  status: Status;\n  objectSet: ObjectSet<T, RDPs>;\n  totalCount?: string;\n}\n\ninterface ObserveAggregationBaseOptions<\n  T extends ObjectOrInterfaceDefinition,\n  A extends AggregateOpts<T>,\n  RDPs extends Record<string, SimplePropertyDef> = {},\n> extends CommonObserveOptions, ObserveOptions {\n  type: T;\n  where?: WhereClause<T, RDPs>;\n  withProperties?: DerivedProperty.Clause<T>;\n  intersectWith?: Array<{\n    where: WhereClause<T, RDPs>;\n  }>;\n  aggregate: A;\n}\n\n/**\n * Options for observeAggregation without an ObjectSet (synchronous).\n */\nexport interface ObserveAggregationOptions<\n  T extends ObjectOrInterfaceDefinition,\n  A extends AggregateOpts<T>,\n  RDPs extends Record<string, SimplePropertyDef> = {},\n> extends ObserveAggregationBaseOptions<T, A, RDPs> {\n  objectSet?: undefined;\n}\n\n/**\n * Options for observeAggregation with an ObjectSet (asynchronous).\n *\n * When objectSet is provided, the aggregation is performed on that ObjectSet\n * instead of the base type, enabling aggregation on pivoted or filtered sets.\n */\nexport interface ObserveAggregationOptionsWithObjectSet<\n  T extends ObjectOrInterfaceDefinition,\n  A extends AggregateOpts<T>,\n  RDPs extends Record<string, SimplePropertyDef> = {},\n> extends ObserveAggregationBaseOptions<T, A, RDPs> {\n  objectSet: ObjectSet<T>;\n}\n\nexport interface ObserveAggregationArgs<\n  T extends ObjectOrInterfaceDefinition,\n  A extends AggregateOpts<T>,\n> {\n  result: AggregationsResults<T, A> | undefined;\n  status: Status;\n  lastUpdated: number;\n  error?: Error;\n}\n\nexport interface ObserveFunctionOptions extends CommonObserveOptions {\n  /**\n   * Object types this function depends on.\n   * When actions modify these types, the function will refetch.\n   */\n  dependsOn?: Array<ObjectTypeDefinition | string>;\n\n  /**\n   * Specific object instances or ObjectSets this function depends on.\n   * When these objects change, the function will refetch.\n   *\n   * For ObjectSets, the object type is extracted asynchronously and added\n   * to the dependency list. Changes to any object of that type will trigger\n   * a refetch.\n   */\n  dependsOnObjects?: Array<\n    Osdk.Instance<ObjectTypeDefinition> | ObjectSet<ObjectTypeDefinition>\n  >;\n}\n\nexport interface ObserveFunctionCallbackArgs<\n  Q extends QueryDefinition<unknown>,\n> {\n  result: QueryReturnType<CompileTimeMetadata<Q>[\"output\"]> | undefined;\n  status: Status;\n  lastUpdated: number;\n  error?: Error;\n}\n\n/**\n * User facing callback args for `observeLink`\n */\nexport interface ObserveLinkCallbackArgs<\n  T extends ObjectOrInterfaceDefinition,\n> {\n  resolvedList: Osdk.Instance<T>[] | undefined;\n  isOptimistic: boolean;\n  lastUpdated: number;\n  fetchMore: () => Promise<void>;\n  hasMore: boolean;\n  status: Status;\n  totalCount?: string;\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 or interface instance with automatic updates when it changes.\n   *\n   * @param apiName - The object type or interface definition, or its API 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 ObjectOrInterfaceDefinition>(\n    apiName: T[\"apiName\"] | T,\n    pk: PrimaryKeyType<T>,\n    options: ObserveOptions,\n    subFn: Observer<ObserveObjectCallbackArgs<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<\n    T extends ObjectOrInterfaceDefinition,\n    RDPs extends Record<string, SimplePropertyDef> = {},\n  >(\n    options: ObserveListOptions<T, RDPs>,\n    subFn: Observer<ObserveObjectsCallbackArgs<T, RDPs>>,\n  ): Unsubscribable;\n\n  /**\n   * Observe an ObjectSet with automatic updates when matching objects change.\n   *\n   * @param baseObjectSet - The base ObjectSet to observe\n   * @param options - Options for transforming and observing the ObjectSet\n   * @param subFn - Observer that receives ObjectSet state updates\n   * @returns Subscription that can be unsubscribed to stop updates\n   *\n   * Supports all ObjectSet operations:\n   * - Filtering with where clauses\n   * - Derived properties with withProperties\n   * - Set operations (union, intersect, subtract)\n   * - Link traversal with pivotTo\n   * - Sorting and pagination\n   */\n  observeObjectSet<\n    T extends ObjectOrInterfaceDefinition,\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\n  /**\n   * @deprecated Use the async overload with `objectSet` parameter instead.\n   * Pass `objectSet: client(YourType)` to get the base object set.\n   */\n  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\n  /**\n   * Observe an aggregation query on a custom ObjectSet with automatic updates.\n   *\n   * This overload accepts an ObjectSet parameter, enabling aggregation on pivoted,\n   * filtered, or composed ObjectSets. Returns a Promise because invalidation type\n   * computation is async (requires lookups for link targets).\n   *\n   * @param options - Aggregation configuration including objectSet, where, aggregate spec\n   * @param subFn - Observer that receives aggregation result updates\n   * @returns Promise resolving to subscription that can be unsubscribed\n   *\n   * @example\n   * ```typescript\n   * const sub = await observableClient.observeAggregation(\n   *   {\n   *     type: Office,\n   *     objectSet: $(Employee).pivotTo(\"primaryOffice\"),\n   *     aggregate: { $select: { $count: \"unordered\" } }\n   *   },\n   *   observer\n   * );\n   * ```\n   */\n  observeAggregation<\n    T extends ObjectOrInterfaceDefinition,\n    A extends AggregateOpts<T>,\n    RDPs extends Record<string, SimplePropertyDef> = {},\n  >(\n    options: ObserveAggregationOptionsWithObjectSet<T, A, RDPs>,\n    subFn: Observer<ObserveAggregationArgs<T, A>>,\n  ): Promise<Unsubscribable>;\n\n  /**\n   * Observe a function execution with automatic updates.\n   *\n   * @param queryDef - The QueryDefinition to execute\n   * @param params - Parameters to pass to the function (undefined if no params)\n   * @param options - Observation options including invalidation configuration\n   * @param subFn - Observer that receives function result updates\n   * @returns Subscription that can be unsubscribed to stop updates\n   *\n   * Supports:\n   * - Automatic caching and deduplication\n   * - Dependency-based invalidation (dependsOn object types)\n   * - Instance-based invalidation (dependsOnObjects)\n   * - Manual refetch via invalidateFunction()\n   */\n  observeFunction<Q extends QueryDefinition<unknown>>(\n    queryDef: Q,\n    params: Record<string, unknown> | undefined,\n    options: ObserveFunctionOptions,\n    subFn: Observer<ObserveFunctionCallbackArgs<Q>>,\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<ActionEditResponse>;\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  /**\n   * Invalidate function queries.\n   * - If params undefined, invalidates ALL queries for this function\n   * - If params provided, invalidates only the query with exact params match\n   *\n   * @param apiName - Function API name string or QueryDefinition\n   * @param params - Optional params for exact match\n   */\n  invalidateFunction(\n    apiName: string | QueryDefinition<unknown>,\n    params?: Record<string, unknown>,\n  ): Promise<void>;\n\n  /**\n   * Invalidate functions that depend on a specific object instance.\n   *\n   * @param apiName - Object type API name\n   * @param primaryKey - Object primary key\n   */\n  invalidateFunctionsByObject(\n    apiName: string,\n    primaryKey: string | number,\n  ): Promise<void>;\n\n  canonicalizeWhereClause: <\n    T extends ObjectOrInterfaceDefinition,\n    RDPs extends Record<string, SimplePropertyDef> = {},\n  >(\n    where: WhereClause<T, RDPs>,\n  ) => Canonical<WhereClause<T, RDPs>>;\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;;AAqBA,SAASA,wBAAwB,QAAQ,wBAAwB;AAEjE,SAASC,iBAAiB,QAAqB,cAAc;AAC7D,SAASC,uBAAuB,QAAQ,oBAAoB;AAE5D,SAASC,qBAAqB,QAAQ,sBAAsB;AAG5D,SAASC,oBAAoB,QAAQ,oCAAoC;AACzE,SAASC,KAAK,QAAQ,qBAAqB;AAAC,WAW3BC,gBAAgB;AA+IjC;AACA;AACA;;AASA;AACA;AACA;AACA;AACA;AACA;;AAgDA;AACA;AACA;;AAaA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAgPA,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  ActionEditResponse,\n  ActionValidationResponse,\n  AggregateOpts,\n  AggregationsResults,\n  CompileTimeMetadata,\n  DerivedProperty,\n  ObjectOrInterfaceDefinition,\n  ObjectSet,\n  ObjectTypeDefinition,\n  Osdk,\n  PrimaryKeyType,\n  PropertyKeys,\n  QueryDefinition,\n  SimplePropertyDef,\n  WhereClause,\n  WirePropertyTypes,\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 type { QueryReturnType } from \"../queries/types.js\";\nimport { OBSERVABLE_USER_AGENT } from \"../util/UserAgent.js\";\nimport type { Canonical } from \"./internal/Canonical.js\";\nimport type { ObserveObjectSetOptions } from \"./internal/objectset/ObjectSetQueryOptions.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 ObjectOrInterfaceDefinition,\n> extends ObserveOptions {\n  apiName: T[\"apiName\"] | T;\n  pk: PrimaryKeyType<T>;\n  select?: PropertyKeys<T>[];\n}\n\nexport type OrderBy<Q extends ObjectOrInterfaceDefinition> = {\n  [K in PropertyKeys<Q>]?: \"asc\" | \"desc\" | undefined;\n};\n\nexport interface ObserveListOptions<\n  Q extends ObjectOrInterfaceDefinition,\n  RDPs extends Record<string, SimplePropertyDef> = {},\n> extends CommonObserveOptions, ObserveOptions {\n  type: Pick<Q, \"apiName\" | \"type\">;\n  where?: WhereClause<Q, RDPs>;\n  pageSize?: number;\n  orderBy?: OrderBy<Q>;\n  invalidationMode?: InvalidationMode;\n  expectedLength?: number;\n  streamUpdates?: boolean;\n  withProperties?: DerivedProperty.Clause<Q>;\n\n  /**\n   * Fetch objects by their Resource Identifiers (RIDs).\n   * When provided, starts with a static objectset containing these RIDs.\n   * Can be combined with `where` to filter the RID set, and with `orderBy` to sort results.\n   *\n   * @example\n   * // Fetch specific objects by RID\n   * observeList({ type: Employee, rids: ['ri.foo.123', 'ri.foo.456'] }, observer)\n   *\n   * @example\n   * // Fetch specific objects by RID, filtered by status\n   * observeList({\n   *   type: Employee,\n   *   rids: ['ri.foo.123', 'ri.foo.456', 'ri.foo.789'],\n   *   where: { status: 'active' }\n   * }, observer)\n   */\n  rids?: readonly string[];\n\n  /**\n   * Restrict which properties are returned for each object.\n   * When provided, only the specified properties will be fetched,\n   * reducing payload sizes for list views.\n   */\n  select?: readonly PropertyKeys<Q>[];\n\n  /**\n   * Automatically fetch additional pages on initial load.\n   *\n   * - `true`: Fetch all available pages automatically\n   * - `number`: Fetch pages until at least this many items are loaded\n   * - `undefined` (default): Only fetch the first page, user must call fetchMore()\n   *\n   * @example\n   * // Fetch all todos at once\n   * observeList({ type: Todo, autoFetchMore: true }, observer)\n   *\n   * @example\n   * // Fetch at least 100 todos\n   * observeList({ type: Todo, autoFetchMore: 100, pageSize: 25 }, observer)\n   */\n  autoFetchMore?: boolean | number;\n  intersectWith?: Array<{\n    where: WhereClause<Q, RDPs>;\n  }>;\n  pivotTo?: string;\n}\n\nexport interface ObserveObjectCallbackArgs<\n  T extends ObjectOrInterfaceDefinition,\n> {\n  object: Osdk.Instance<T> | undefined;\n  isOptimistic: boolean;\n  status: Status;\n  lastUpdated: number;\n}\n\nexport interface ObserveObjectsCallbackArgs<\n  T extends ObjectOrInterfaceDefinition,\n  RDPs extends Record<\n    string,\n    WirePropertyTypes | undefined | Array<WirePropertyTypes>\n  > = {},\n> {\n  resolvedList:\n    | Array<\n      Osdk.Instance<T, \"$allBaseProperties\", PropertyKeys<T>, RDPs>\n    >\n    | undefined;\n  isOptimistic: boolean;\n  lastUpdated: number;\n  fetchMore: () => Promise<void>;\n  hasMore: boolean;\n  status: Status;\n  totalCount?: string;\n}\n\nexport interface ObserveObjectSetArgs<\n  T extends ObjectOrInterfaceDefinition,\n  RDPs extends Record<\n    string,\n    WirePropertyTypes | undefined | Array<WirePropertyTypes>\n  > = {},\n> {\n  resolvedList:\n    | Array<\n      Osdk.Instance<T, \"$allBaseProperties\", PropertyKeys<T>, RDPs>\n    >\n    | undefined;\n  isOptimistic: boolean;\n  lastUpdated: number;\n  fetchMore: () => Promise<void>;\n  hasMore: boolean;\n  status: Status;\n  objectSet: ObjectSet<T, RDPs>;\n  totalCount?: string;\n}\n\ninterface ObserveAggregationBaseOptions<\n  T extends ObjectOrInterfaceDefinition,\n  A extends AggregateOpts<T>,\n  RDPs extends Record<string, SimplePropertyDef> = {},\n> extends CommonObserveOptions, ObserveOptions {\n  type: T;\n  where?: WhereClause<T, RDPs>;\n  withProperties?: DerivedProperty.Clause<T>;\n  intersectWith?: Array<{\n    where: WhereClause<T, RDPs>;\n  }>;\n  aggregate: A;\n}\n\n/**\n * Options for observeAggregation without an ObjectSet (synchronous).\n */\nexport interface ObserveAggregationOptions<\n  T extends ObjectOrInterfaceDefinition,\n  A extends AggregateOpts<T>,\n  RDPs extends Record<string, SimplePropertyDef> = {},\n> extends ObserveAggregationBaseOptions<T, A, RDPs> {\n  objectSet?: undefined;\n}\n\n/**\n * Options for observeAggregation with an ObjectSet (asynchronous).\n *\n * When objectSet is provided, the aggregation is performed on that ObjectSet\n * instead of the base type, enabling aggregation on pivoted or filtered sets.\n */\nexport interface ObserveAggregationOptionsWithObjectSet<\n  T extends ObjectOrInterfaceDefinition,\n  A extends AggregateOpts<T>,\n  RDPs extends Record<string, SimplePropertyDef> = {},\n> extends ObserveAggregationBaseOptions<T, A, RDPs> {\n  objectSet: ObjectSet<T>;\n}\n\nexport interface ObserveAggregationArgs<\n  T extends ObjectOrInterfaceDefinition,\n  A extends AggregateOpts<T>,\n> {\n  result: AggregationsResults<T, A> | undefined;\n  status: Status;\n  lastUpdated: number;\n  error?: Error;\n}\n\nexport interface ObserveFunctionOptions extends CommonObserveOptions {\n  /**\n   * Object types this function depends on.\n   * When actions modify these types, the function will refetch.\n   */\n  dependsOn?: Array<ObjectTypeDefinition | string>;\n\n  /**\n   * Specific object instances or ObjectSets this function depends on.\n   * When these objects change, the function will refetch.\n   *\n   * For ObjectSets, the object type is extracted asynchronously and added\n   * to the dependency list. Changes to any object of that type will trigger\n   * a refetch.\n   */\n  dependsOnObjects?: Array<\n    Osdk.Instance<ObjectTypeDefinition> | ObjectSet<ObjectTypeDefinition>\n  >;\n}\n\nexport interface ObserveFunctionCallbackArgs<\n  Q extends QueryDefinition<unknown>,\n> {\n  result: QueryReturnType<CompileTimeMetadata<Q>[\"output\"]> | undefined;\n  status: Status;\n  lastUpdated: number;\n  error?: Error;\n}\n\n/**\n * User facing callback args for `observeLink`\n */\nexport interface ObserveLinkCallbackArgs<\n  T extends ObjectOrInterfaceDefinition,\n> {\n  resolvedList: Osdk.Instance<T>[] | undefined;\n  linkedObjectsBySourcePrimaryKey: ReadonlyMap<\n    string | number,\n    ReadonlyArray<Osdk.Instance<T>>\n  >;\n  isOptimistic: boolean;\n  lastUpdated: number;\n  fetchMore: () => Promise<void>;\n  hasMore: boolean;\n  status: Status;\n  totalCount?: string;\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 or interface instance with automatic updates when it changes.\n   *\n   * @param apiName - The object type or interface definition, or its API 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 ObjectOrInterfaceDefinition>(\n    apiName: T[\"apiName\"] | T,\n    pk: PrimaryKeyType<T>,\n    options: ObserveOptions,\n    subFn: Observer<ObserveObjectCallbackArgs<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<\n    T extends ObjectOrInterfaceDefinition,\n    RDPs extends Record<string, SimplePropertyDef> = {},\n  >(\n    options: ObserveListOptions<T, RDPs>,\n    subFn: Observer<ObserveObjectsCallbackArgs<T, RDPs>>,\n  ): Unsubscribable;\n\n  /**\n   * Observe an ObjectSet with automatic updates when matching objects change.\n   *\n   * @param baseObjectSet - The base ObjectSet to observe\n   * @param options - Options for transforming and observing the ObjectSet\n   * @param subFn - Observer that receives ObjectSet state updates\n   * @returns Subscription that can be unsubscribed to stop updates\n   *\n   * Supports all ObjectSet operations:\n   * - Filtering with where clauses\n   * - Derived properties with withProperties\n   * - Set operations (union, intersect, subtract)\n   * - Link traversal with pivotTo\n   * - Sorting and pagination\n   */\n  observeObjectSet<\n    T extends ObjectOrInterfaceDefinition,\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\n  /**\n   * @deprecated Use the async overload with `objectSet` parameter instead.\n   * Pass `objectSet: client(YourType)` to get the base object set.\n   */\n  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\n  /**\n   * Observe an aggregation query on a custom ObjectSet with automatic updates.\n   *\n   * This overload accepts an ObjectSet parameter, enabling aggregation on pivoted,\n   * filtered, or composed ObjectSets. Returns a Promise because invalidation type\n   * computation is async (requires lookups for link targets).\n   *\n   * @param options - Aggregation configuration including objectSet, where, aggregate spec\n   * @param subFn - Observer that receives aggregation result updates\n   * @returns Promise resolving to subscription that can be unsubscribed\n   *\n   * @example\n   * ```typescript\n   * const sub = await observableClient.observeAggregation(\n   *   {\n   *     type: Office,\n   *     objectSet: $(Employee).pivotTo(\"primaryOffice\"),\n   *     aggregate: { $select: { $count: \"unordered\" } }\n   *   },\n   *   observer\n   * );\n   * ```\n   */\n  observeAggregation<\n    T extends ObjectOrInterfaceDefinition,\n    A extends AggregateOpts<T>,\n    RDPs extends Record<string, SimplePropertyDef> = {},\n  >(\n    options: ObserveAggregationOptionsWithObjectSet<T, A, RDPs>,\n    subFn: Observer<ObserveAggregationArgs<T, A>>,\n  ): Promise<Unsubscribable>;\n\n  /**\n   * Observe a function execution with automatic updates.\n   *\n   * @param queryDef - The QueryDefinition to execute\n   * @param params - Parameters to pass to the function (undefined if no params)\n   * @param options - Observation options including invalidation configuration\n   * @param subFn - Observer that receives function result updates\n   * @returns Subscription that can be unsubscribed to stop updates\n   *\n   * Supports:\n   * - Automatic caching and deduplication\n   * - Dependency-based invalidation (dependsOn object types)\n   * - Instance-based invalidation (dependsOnObjects)\n   * - Manual refetch via invalidateFunction()\n   */\n  observeFunction<Q extends QueryDefinition<unknown>>(\n    queryDef: Q,\n    params: Record<string, unknown> | undefined,\n    options: ObserveFunctionOptions,\n    subFn: Observer<ObserveFunctionCallbackArgs<Q>>,\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<ActionEditResponse>;\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  /**\n   * Invalidate function queries.\n   * - If params undefined, invalidates ALL queries for this function\n   * - If params provided, invalidates only the query with exact params match\n   *\n   * @param apiName - Function API name string or QueryDefinition\n   * @param params - Optional params for exact match\n   */\n  invalidateFunction(\n    apiName: string | QueryDefinition<unknown>,\n    params?: Record<string, unknown>,\n  ): Promise<void>;\n\n  /**\n   * Invalidate functions that depend on a specific object instance.\n   *\n   * @param apiName - Object type API name\n   * @param primaryKey - Object primary key\n   */\n  invalidateFunctionsByObject(\n    apiName: string,\n    primaryKey: string | number,\n  ): Promise<void>;\n\n  canonicalizeWhereClause: <\n    T extends ObjectOrInterfaceDefinition,\n    RDPs extends Record<string, SimplePropertyDef> = {},\n  >(\n    where: WhereClause<T, RDPs>,\n  ) => Canonical<WhereClause<T, RDPs>>;\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;;AAqBA,SAASA,wBAAwB,QAAQ,wBAAwB;AAEjE,SAASC,iBAAiB,QAAqB,cAAc;AAC7D,SAASC,uBAAuB,QAAQ,oBAAoB;AAE5D,SAASC,qBAAqB,QAAQ,sBAAsB;AAG5D,SAASC,oBAAoB,QAAQ,oCAAoC;AACzE,SAASC,KAAK,QAAQ,qBAAqB;AAAC,WAW3BC,gBAAgB;AA+IjC;AACA;AACA;;AASA;AACA;AACA;AACA;AACA;AACA;;AAgDA;AACA;AACA;;AAiBA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAgPA,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/browser/observable/internal/ObservableClientImpl.js

@@ -119,6 +119,7 @@ function observeSingleLink(store, objectsArray, linkName, options, observer) {
   if (objectsArray.length === 0) {
     observer.next({
       resolvedList: [],
+      linkedObjectsBySourcePrimaryKey: new Map(),
       isOptimistic: false,
       lastUpdated: 0,
       fetchMore: () => Promise.resolve(),
@@ -130,6 +131,7 @@ function observeSingleLink(store, objectsArray, linkName, options, observer) {
   }
   const parentSub = new Subscription();
   for (const obj of objectsArray) {
+    const pk = obj.$primaryKey;
     const sourceType = obj.$apiName === obj.$objectType ? "object" : "interface";
     parentSub.add(store.links.observe({
       ...options,
@@ -139,7 +141,7 @@ function observeSingleLink(store, objectsArray, linkName, options, observer) {
       },
       sourceUnderlyingObjectType: obj.$objectType,
       linkName,
-      pk: obj.$primaryKey
+      pk
     }, observer));
   }
   return new UnsubscribableWrapper(parentSub);
@@ -147,18 +149,23 @@ function observeSingleLink(store, objectsArray, linkName, options, observer) {
 function observeMultiLinks(store, objectsArray, linkName, options, observer) {
   const parentSub = new Subscription();
   const totalExpected = objectsArray.length;
-  const perObjectResults = new Map();
+  const perObjectData = new Map();
   let errored = false;
   function mergeAndEmit() {
     if (errored) {
       return;
     }
     const seen = new Map();
+    const linkedObjectsBySourcePrimaryKey = new Map();
     const fetchMores = [];
     let latestUpdated = 0;
     let hasMore = false;
     let isOptimistic = false;
-    for (const payload of perObjectResults.values()) {
+    for (const {
+      payload,
+      pk
+    } of perObjectData.values()) {
+      linkedObjectsBySourcePrimaryKey.set(pk, payload.resolvedList ?? []);
       for (const obj of payload.resolvedList ?? []) {
         seen.set(`${obj.$objectType}:${obj.$primaryKey}`, obj);
       }
@@ -173,10 +180,11 @@ function observeMultiLinks(store, objectsArray, linkName, options, observer) {
         fetchMores.push(payload.fetchMore);
       }
     }
-    const payloads = [...perObjectResults.values()];
-    const loading = perObjectResults.size < totalExpected || payloads.some(p => p.status === "init" || p.status === "loading");
+    const payloads = [...perObjectData.values()].map(d => d.payload);
+    const loading = perObjectData.size < totalExpected || payloads.some(p => p.status === "init" || p.status === "loading");
     observer.next({
       resolvedList: Array.from(seen.values()),
+      linkedObjectsBySourcePrimaryKey,
       isOptimistic,
       lastUpdated: latestUpdated,
       fetchMore: hasMore ? () => Promise.all(fetchMores.map(fn => fn())).then(() => {}) : () => Promise.resolve(),
@@ -189,6 +197,7 @@ function observeMultiLinks(store, objectsArray, linkName, options, observer) {
   }
   for (const obj of objectsArray) {
     const objKey = `${obj.$objectType ?? obj.$apiName}:${obj.$primaryKey}`;
+    const pk = obj.$primaryKey;
     const sourceType = obj.$apiName === obj.$objectType ? "object" : "interface";
     parentSub.add(store.links.observe({
       ...options,
@@ -198,13 +207,16 @@ function observeMultiLinks(store, objectsArray, linkName, options, observer) {
       },
       sourceUnderlyingObjectType: obj.$objectType,
       linkName,
-      pk: obj.$primaryKey
+      pk
     }, {
       next: payload => {
         if (errored) {
           return;
         }
-        perObjectResults.set(objKey, payload);
+        perObjectData.set(objKey, {
+          payload,
+          pk
+        });
         mergeAndEmit();
       },
       error: err => {

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

@@ -1 +1 @@
-{"version":3,"file":"ObservableClientImpl.js","names":["Subscription","additionalContext","getWireObjectSet","isObjectSet","extractObjectOrInterfaceType","UnsubscribableWrapper","ObservableClientImpl","constructor","store","__experimentalStore","applyAction","bind","validateAction","observeObject","apiName","pk","options","subFn","objects","observe","observeList","lists","observeAggregation","objectSet","aggregations","observeAsync","observeFunction","queryDef","params","dependsOn","map","dep","instances","objectSetWires","item","dependsOnObjects","push","$apiName","$objectType","$primaryKey","objectSetTypesPromise","length","Promise","all","wire","client","then","types","filter","t","undefined","functions","observeLinks","linkName","objectsArray","Array","isArray","observer","observeSingleLink","observeMultiLinks","observeObjectSet","baseObjectSet","objectSets","invalidateAll","invalidateObjects","invalidateObjectType","type","invalidateFunction","invalidateFunctionsByObject","primaryKey","canonicalizeWhereClause","where","whereCanonicalizer","canonicalize","next","resolvedList","isOptimistic","lastUpdated","fetchMore","resolve","hasMore","status","totalCount","parentSub","obj","sourceType","add","links","srcType","sourceUnderlyingObjectType","totalExpected","perObjectResults","Map","errored","mergeAndEmit","seen","fetchMores","latestUpdated","payload","values","set","payloads","loading","size","some","p","from","fn","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  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 { additionalContext } from \"../../Client.js\";\nimport {\n  getWireObjectSet,\n  isObjectSet,\n} from \"../../objectSet/createObjectSet.js\";\nimport { extractObjectOrInterfaceType } from \"../../util/extractObjectOrInterfaceType.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  ObserveAggregationOptionsWithObjectSet,\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 ObjectOrInterfaceDefinition,\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  public observeAggregation<\n    T extends ObjectOrInterfaceDefinition,\n    A extends AggregateOpts<T>,\n    RDPs extends Record<string, SimplePropertyDef> = {},\n  >(\n    options: ObserveAggregationOptionsWithObjectSet<T, A, RDPs>,\n    subFn: Observer<ObserveAggregationArgs<T, A>>,\n  ): Promise<Unsubscribable>;\n  public observeAggregation<\n    T extends ObjectOrInterfaceDefinition,\n    A extends AggregateOpts<T>,\n    RDPs extends Record<string, SimplePropertyDef> = {},\n  >(\n    options:\n      | ObserveAggregationOptions<T, A, RDPs>\n      | ObserveAggregationOptionsWithObjectSet<T, A, RDPs>,\n    subFn: Observer<ObserveAggregationArgs<T, A>>,\n  ): Unsubscribable | Promise<Unsubscribable> {\n    if (options.objectSet) {\n      return this.__experimentalStore.aggregations.observeAsync(\n        options as ObserveAggregationOptionsWithObjectSet<T, A, RDPs>,\n        subFn as Observer<AggregationPayloadBase>,\n      );\n    }\n    return this.__experimentalStore.aggregations.observe(\n      options as ObserveAggregationOptions<T, A, RDPs>,\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\n    // Partition dependsOnObjects into instances vs ObjectSets\n    type ObjectDependency = { $apiName: string; $primaryKey: string | number };\n    const instances: ObjectDependency[] = [];\n    const objectSetWires: Array<\n      ReturnType<typeof getWireObjectSet>\n    > = [];\n\n    for (const item of options.dependsOnObjects ?? []) {\n      if (isObjectSet(item)) {\n        objectSetWires.push(getWireObjectSet(item));\n      } else {\n        instances.push({\n          $apiName: item.$objectType ?? item.$apiName,\n          $primaryKey: item.$primaryKey,\n        });\n      }\n    }\n\n    // Start async extraction of ObjectSet types\n    const objectSetTypesPromise = objectSetWires.length > 0\n      ? Promise.all(\n        objectSetWires.map(wire =>\n          extractObjectOrInterfaceType(\n            this.__experimentalStore.client[additionalContext],\n            wire,\n          )\n        ),\n      ).then(types =>\n        types\n          .filter((t): t is NonNullable<typeof t> => t != null)\n          .map(t => t.apiName)\n      )\n      : undefined;\n\n    return this.__experimentalStore.functions.observe(\n      {\n        ...options,\n        queryDef,\n        params,\n        dependsOn,\n        dependsOnObjects: instances,\n        objectSetTypesPromise,\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 ObjectOrInterfaceDefinition,\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 ObjectOrInterfaceDefinition,\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    const sourceType: \"object\" | \"interface\" = obj.$apiName === obj.$objectType\n      ? \"object\"\n      : \"interface\";\n\n    parentSub.add(\n      store.links.observe(\n        {\n          ...options,\n          srcType: {\n            type: sourceType,\n            apiName: obj.$apiName,\n          },\n          sourceUnderlyingObjectType: obj.$objectType,\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<\n      string,\n      NonNullable<SpecificLinkPayload[\"resolvedList\"]>[number]\n    >();\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    const sourceType: \"object\" | \"interface\" = obj.$apiName === obj.$objectType\n      ? \"object\"\n      : \"interface\";\n\n    parentSub.add(\n      store.links.observe(\n        {\n          ...options,\n          srcType: {\n            type: sourceType,\n            apiName: obj.$apiName,\n          },\n          sourceUnderlyingObjectType: obj.$objectType,\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":[]}
+{"version":3,"file":"ObservableClientImpl.js","names":["Subscription","additionalContext","getWireObjectSet","isObjectSet","extractObjectOrInterfaceType","UnsubscribableWrapper","ObservableClientImpl","constructor","store","__experimentalStore","applyAction","bind","validateAction","observeObject","apiName","pk","options","subFn","objects","observe","observeList","lists","observeAggregation","objectSet","aggregations","observeAsync","observeFunction","queryDef","params","dependsOn","map","dep","instances","objectSetWires","item","dependsOnObjects","push","$apiName","$objectType","$primaryKey","objectSetTypesPromise","length","Promise","all","wire","client","then","types","filter","t","undefined","functions","observeLinks","linkName","objectsArray","Array","isArray","observer","observeSingleLink","observeMultiLinks","observeObjectSet","baseObjectSet","objectSets","invalidateAll","invalidateObjects","invalidateObjectType","type","invalidateFunction","invalidateFunctionsByObject","primaryKey","canonicalizeWhereClause","where","whereCanonicalizer","canonicalize","next","resolvedList","linkedObjectsBySourcePrimaryKey","Map","isOptimistic","lastUpdated","fetchMore","resolve","hasMore","status","totalCount","parentSub","obj","sourceType","add","links","srcType","sourceUnderlyingObjectType","totalExpected","perObjectData","errored","mergeAndEmit","seen","fetchMores","latestUpdated","payload","values","set","payloads","d","loading","size","some","p","from","fn","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  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 { additionalContext } from \"../../Client.js\";\nimport {\n  getWireObjectSet,\n  isObjectSet,\n} from \"../../objectSet/createObjectSet.js\";\nimport { extractObjectOrInterfaceType } from \"../../util/extractObjectOrInterfaceType.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  ObserveAggregationOptionsWithObjectSet,\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 ObjectOrInterfaceDefinition,\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  public observeAggregation<\n    T extends ObjectOrInterfaceDefinition,\n    A extends AggregateOpts<T>,\n    RDPs extends Record<string, SimplePropertyDef> = {},\n  >(\n    options: ObserveAggregationOptionsWithObjectSet<T, A, RDPs>,\n    subFn: Observer<ObserveAggregationArgs<T, A>>,\n  ): Promise<Unsubscribable>;\n  public observeAggregation<\n    T extends ObjectOrInterfaceDefinition,\n    A extends AggregateOpts<T>,\n    RDPs extends Record<string, SimplePropertyDef> = {},\n  >(\n    options:\n      | ObserveAggregationOptions<T, A, RDPs>\n      | ObserveAggregationOptionsWithObjectSet<T, A, RDPs>,\n    subFn: Observer<ObserveAggregationArgs<T, A>>,\n  ): Unsubscribable | Promise<Unsubscribable> {\n    if (options.objectSet) {\n      return this.__experimentalStore.aggregations.observeAsync(\n        options as ObserveAggregationOptionsWithObjectSet<T, A, RDPs>,\n        subFn as Observer<AggregationPayloadBase>,\n      );\n    }\n    return this.__experimentalStore.aggregations.observe(\n      options as ObserveAggregationOptions<T, A, RDPs>,\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\n    // Partition dependsOnObjects into instances vs ObjectSets\n    type ObjectDependency = { $apiName: string; $primaryKey: string | number };\n    const instances: ObjectDependency[] = [];\n    const objectSetWires: Array<\n      ReturnType<typeof getWireObjectSet>\n    > = [];\n\n    for (const item of options.dependsOnObjects ?? []) {\n      if (isObjectSet(item)) {\n        objectSetWires.push(getWireObjectSet(item));\n      } else {\n        instances.push({\n          $apiName: item.$objectType ?? item.$apiName,\n          $primaryKey: item.$primaryKey,\n        });\n      }\n    }\n\n    // Start async extraction of ObjectSet types\n    const objectSetTypesPromise = objectSetWires.length > 0\n      ? Promise.all(\n        objectSetWires.map(wire =>\n          extractObjectOrInterfaceType(\n            this.__experimentalStore.client[additionalContext],\n            wire,\n          )\n        ),\n      ).then(types =>\n        types\n          .filter((t): t is NonNullable<typeof t> => t != null)\n          .map(t => t.apiName)\n      )\n      : undefined;\n\n    return this.__experimentalStore.functions.observe(\n      {\n        ...options,\n        queryDef,\n        params,\n        dependsOn,\n        dependsOnObjects: instances,\n        objectSetTypesPromise,\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 ObjectOrInterfaceDefinition,\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 ObjectOrInterfaceDefinition,\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      linkedObjectsBySourcePrimaryKey: new Map(),\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    const pk = obj.$primaryKey;\n    const sourceType: \"object\" | \"interface\" = obj.$apiName === obj.$objectType\n      ? \"object\"\n      : \"interface\";\n\n    parentSub.add(\n      store.links.observe(\n        {\n          ...options,\n          srcType: {\n            type: sourceType,\n            apiName: obj.$apiName,\n          },\n          sourceUnderlyingObjectType: obj.$objectType,\n          linkName,\n          pk,\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 perObjectData = new Map<\n    string,\n    { payload: SpecificLinkPayload; pk: string | number }\n  >();\n  let errored = false;\n\n  function mergeAndEmit() {\n    if (errored) {\n      return;\n    }\n\n    const seen = new Map<\n      string,\n      NonNullable<SpecificLinkPayload[\"resolvedList\"]>[number]\n    >();\n    const linkedObjectsBySourcePrimaryKey = new Map<\n      string | number,\n      ReadonlyArray<NonNullable<SpecificLinkPayload[\"resolvedList\"]>[number]>\n    >();\n    const fetchMores: Array<() => Promise<void>> = [];\n    let latestUpdated = 0;\n    let hasMore = false;\n    let isOptimistic = false;\n\n    for (const { payload, pk } of perObjectData.values()) {\n      linkedObjectsBySourcePrimaryKey.set(pk, payload.resolvedList ?? []);\n\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 = [...perObjectData.values()].map(d => d.payload);\n    const loading = perObjectData.size < totalExpected\n      || payloads.some(p => p.status === \"init\" || p.status === \"loading\");\n\n    observer.next({\n      resolvedList: Array.from(seen.values()),\n      linkedObjectsBySourcePrimaryKey,\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    const pk = obj.$primaryKey;\n\n    const sourceType: \"object\" | \"interface\" = obj.$apiName === obj.$objectType\n      ? \"object\"\n      : \"interface\";\n\n    parentSub.add(\n      store.links.observe(\n        {\n          ...options,\n          srcType: {\n            type: sourceType,\n            apiName: obj.$apiName,\n          },\n          sourceUnderlyingObjectType: obj.$objectType,\n          linkName,\n          pk,\n        },\n        {\n          next: (payload: SpecificLinkPayload) => {\n            if (errored) {\n              return;\n            }\n            perObjectData.set(objKey, { payload, pk });\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":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAkBA,SAASA,YAAY,QAAQ,MAAM;AAEnC,SAASC,iBAAiB,QAAQ,iBAAiB;AACnD,SACEC,gBAAgB,EAChBC,WAAW,QACN,oCAAoC;AAC3C,SAASC,4BAA4B,QAAQ,4CAA4C;AA0BzF,SAASC,qBAAqB,QAAQ,4BAA4B;;AAElE;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMC,oBAAoB,CAA6B;EAG5DC,WAAWA,CAACC,KAAY,EAAE;IACxB,IAAI,CAACC,mBAAmB,GAAGD,KAAK;IAEhC,IAAI,CAACE,WAAW,GAAGF,KAAK,CAACE,WAAW,CAACC,IAAI,CAACH,KAAK,CAAC;IAChD,IAAI,CAACI,cAAc,GAAGJ,KAAK,CAACI,cAAc,CAACD,IAAI,CAACH,KAAK,CAAC;EACxD;EAEOK,aAAa,GAKEA,CAACC,OAAO,EAAEC,EAAE,EAAEC,OAAO,EAAEC,KAAK,KAAK;IACrD,OAAO,IAAI,CAACR,mBAAmB,CAACS,OAAO,CAACC,OAAO,CAC7C;MACE,GAAGH,OAAO;MACVF,OAAO;MACPC;IACF,CAAC;IACD;IACAE,KACF,CAAC;EACH,CAAC;EAEMG,WAAW,GAMIA,CAACJ,OAAO,EAAEC,KAAK,KAAK;IACxC,OAAO,IAAI,CAACR,mBAAmB,CAACY,KAAK,CAACF,OAAO,CAC3CH,OAAO;IACP;IACAC,KACF,CAAC;EACH,CAAC;EAkBMK,kBAAkBA,CAKvBN,OAEsD,EACtDC,KAA6C,EACH;IAC1C,IAAID,OAAO,CAACO,SAAS,EAAE;MACrB,OAAO,IAAI,CAACd,mBAAmB,CAACe,YAAY,CAACC,YAAY,CACvDT,OAAO,EACPC,KACF,CAAC;IACH;IACA,OAAO,IAAI,CAACR,mBAAmB,CAACe,YAAY,CAACL,OAAO,CAClDH,OAAO,EACPC,KACF,CAAC;EACH;EAEOS,eAAe,GAKAA,CAACC,QAAQ,EAAEC,MAAM,EAAEZ,OAAO,EAAEC,KAAK,KAAK;IAC1D,MAAMY,SAAS,GAAGb,OAAO,CAACa,SAAS,EAAEC,GAAG,CAACC,GAAG,IAC1C,OAAOA,GAAG,KAAK,QAAQ,GAAGA,GAAG,GAAGA,GAAG,CAACjB,OACtC,CAAC;;IAED;;IAEA,MAAMkB,SAA6B,GAAG,EAAE;IACxC,MAAMC,cAEL,GAAG,EAAE;IAEN,KAAK,MAAMC,IAAI,IAAIlB,OAAO,CAACmB,gBAAgB,IAAI,EAAE,EAAE;MACjD,IAAIhC,WAAW,CAAC+B,IAAI,CAAC,EAAE;QACrBD,cAAc,CAACG,IAAI,CAAClC,gBAAgB,CAACgC,IAAI,CAAC,CAAC;MAC7C,CAAC,MAAM;QACLF,SAAS,CAACI,IAAI,CAAC;UACbC,QAAQ,EAAEH,IAAI,CAACI,WAAW,IAAIJ,IAAI,CAACG,QAAQ;UAC3CE,WAAW,EAAEL,IAAI,CAACK;QACpB,CAAC,CAAC;MACJ;IACF;;IAEA;IACA,MAAMC,qBAAqB,GAAGP,cAAc,CAACQ,MAAM,GAAG,CAAC,GACnDC,OAAO,CAACC,GAAG,CACXV,cAAc,CAACH,GAAG,CAACc,IAAI,IACrBxC,4BAA4B,CAC1B,IAAI,CAACK,mBAAmB,CAACoC,MAAM,CAAC5C,iBAAiB,CAAC,EAClD2C,IACF,CACF,CACF,CAAC,CAACE,IAAI,CAACC,KAAK,IACVA,KAAK,CACFC,MAAM,CAAEC,CAAC,IAAiCA,CAAC,IAAI,IAAI,CAAC,CACpDnB,GAAG,CAACmB,CAAC,IAAIA,CAAC,CAACnC,OAAO,CACvB,CAAC,GACCoC,SAAS;IAEb,OAAO,IAAI,CAACzC,mBAAmB,CAAC0C,SAAS,CAAChC,OAAO,CAC/C;MACE,GAAGH,OAAO;MACVW,QAAQ;MACRC,MAAM;MACNC,SAAS;MACTM,gBAAgB,EAAEH,SAAS;MAC3BQ;IACF,CAAC,EACDvB,KACF,CAAC;EACH,CAAC;EAEMmC,YAAY,GAYGA,CAAClC,OAAO,EAAEmC,QAAQ,EAAErC,OAAO,EAAEC,KAAK,KAAK;IAC3D,MAAMqC,YAAY,GAAGC,KAAK,CAACC,OAAO,CAACtC,OAAO,CAAC,GAAGA,OAAO,GAAG,CAACA,OAAO,CAAC;IACjE,MAAMuC,QAAQ,GAAGxC,KAAiD;IAElE,OAAOqC,YAAY,CAACb,MAAM,IAAI,CAAC,GAC3BiB,iBAAiB,CACjB,IAAI,CAACjD,mBAAmB,EACxB6C,YAAY,EACZD,QAAQ,EACRrC,OAAO,EACPyC,QACF,CAAC,GACCE,iBAAiB,CACjB,IAAI,CAAClD,mBAAmB,EACxB6C,YAAY,EACZD,QAAQ,EACRrC,OAAO,EACPyC,QACF,CAAC;EACL,CAAC;EAaMG,gBAAgBA,CAOrBC,aAA2B,EAC3B7C,OAAyC,EACzCC,KAA8C,EAC9B;IAChB,OAAO,IAAI,CAACR,mBAAmB,CAACqD,UAAU,CAAC3C,OAAO,CAChD;MAAE0C,aAAa;MAAE,GAAG7C;IAAQ,CAAC;IAC7B;IACAC,KACF,CAAC;EACH;EAEO8C,aAAaA,CAAA,EAAkB;IACpC,OAAO,IAAI,CAACtD,mBAAmB,CAACsD,aAAa,CAAC,CAAC;EACjD;EAEOC,iBAAiBA,CACtB9C,OAEsD,EACvC;IACf,OAAO,IAAI,CAACT,mBAAmB,CAACuD,iBAAiB,CAAC9C,OAAO,CAAC;EAC5D;EAEO+C,oBAAoBA,CACzBC,IAAsB,EACP;IACf,OAAO,IAAI,CAACzD,mBAAmB,CAACwD,oBAAoB,CAACC,IAAI,EAAEhB,SAAS,CAAC;EACvE;EAEOiB,kBAAkBA,CACvBrD,OAA0C,EAC1Cc,MAAgC,EACjB;IACf,OAAO,IAAI,CAACnB,mBAAmB,CAAC0D,kBAAkB,CAACrD,OAAO,EAAEc,MAAM,CAAC;EACrE;EAEOwC,2BAA2BA,CAChCtD,OAAe,EACfuD,UAA2B,EACZ;IACf,OAAO,IAAI,CAAC5D,mBAAmB,CAAC2D,2BAA2B,CACzDtD,OAAO,EACPuD,UACF,CAAC;EACH;EAEOC,uBAAuBA,CAG5BC,KAA2B,EAAmC;IAC9D,OAAO,IAAI,CAAC9D,mBAAmB,CAAC+D,kBAAkB,CAC/CC,YAAY,CAACF,KAAK,CAAC;EACxB;AACF;AAEA,SAASb,iBAAiBA,CACxBlD,KAAY,EACZ8C,YAAuE,EACvED,QAAgB,EAChBrC,OAAkE,EAClEyC,QAAuC,EACvB;EAChB,IAAIH,YAAY,CAACb,MAAM,KAAK,CAAC,EAAE;IAC7BgB,QAAQ,CAACiB,IAAI,CAAC;MACZC,YAAY,EAAE,EAAE;MAChBC,+BAA+B,EAAE,IAAIC,GAAG,CAAC,CAAC;MAC1CC,YAAY,EAAE,KAAK;MACnBC,WAAW,EAAE,CAAC;MACdC,SAAS,EAAEA,CAAA,KAAMtC,OAAO,CAACuC,OAAO,CAAC,CAAC;MAClCC,OAAO,EAAE,KAAK;MACdC,MAAM,EAAE,QAAQ;MAChBC,UAAU,EAAE;IACd,CAAC,CAAC;IACF,OAAO,IAAI/E,qBAAqB,CAAC,IAAIL,YAAY,CAAC,CAAC,CAAC;EACtD;EAEA,MAAMqF,SAAS,GAAG,IAAIrF,YAAY,CAAC,CAAC;EAEpC,KAAK,MAAMsF,GAAG,IAAIhC,YAAY,EAAE;IAC9B,MAAMvC,EAAE,GAAGuE,GAAG,CAAC/C,WAAW;IAC1B,MAAMgD,UAAkC,GAAGD,GAAG,CAACjD,QAAQ,KAAKiD,GAAG,CAAChD,WAAW,GACvE,QAAQ,GACR,WAAW;IAEf+C,SAAS,CAACG,GAAG,CACXhF,KAAK,CAACiF,KAAK,CAACtE,OAAO,CACjB;MACE,GAAGH,OAAO;MACV0E,OAAO,EAAE;QACPxB,IAAI,EAAEqB,UAAU;QAChBzE,OAAO,EAAEwE,GAAG,CAACjD;MACf,CAAC;MACDsD,0BAA0B,EAAEL,GAAG,CAAChD,WAAW;MAC3Ce,QAAQ;MACRtC;IACF,CAAC,EACD0C,QACF,CACF,CAAC;EACH;EAEA,OAAO,IAAIpD,qBAAqB,CAACgF,SAAS,CAAC;AAC7C;AAEA,SAAS1B,iBAAiBA,CACxBnD,KAAY,EACZ8C,YAAuE,EACvED,QAAgB,EAChBrC,OAAkE,EAClEyC,QAAuC,EACvB;EAChB,MAAM4B,SAAS,GAAG,IAAIrF,YAAY,CAAC,CAAC;EACpC,MAAM4F,aAAa,GAAGtC,YAAY,CAACb,MAAM;EACzC,MAAMoD,aAAa,GAAG,IAAIhB,GAAG,CAG3B,CAAC;EACH,IAAIiB,OAAO,GAAG,KAAK;EAEnB,SAASC,YAAYA,CAAA,EAAG;IACtB,IAAID,OAAO,EAAE;MACX;IACF;IAEA,MAAME,IAAI,GAAG,IAAInB,GAAG,CAGlB,CAAC;IACH,MAAMD,+BAA+B,GAAG,IAAIC,GAAG,CAG7C,CAAC;IACH,MAAMoB,UAAsC,GAAG,EAAE;IACjD,IAAIC,aAAa,GAAG,CAAC;IACrB,IAAIhB,OAAO,GAAG,KAAK;IACnB,IAAIJ,YAAY,GAAG,KAAK;IAExB,KAAK,MAAM;MAAEqB,OAAO;MAAEpF;IAAG,CAAC,IAAI8E,aAAa,CAACO,MAAM,CAAC,CAAC,EAAE;MACpDxB,+BAA+B,CAACyB,GAAG,CAACtF,EAAE,EAAEoF,OAAO,CAACxB,YAAY,IAAI,EAAE,CAAC;MAEnE,KAAK,MAAMW,GAAG,IAAIa,OAAO,CAACxB,YAAY,IAAI,EAAE,EAAE;QAC5CqB,IAAI,CAACK,GAAG,CAAC,GAAGf,GAAG,CAAChD,WAAW,IAAIgD,GAAG,CAAC/C,WAAW,EAAE,EAAE+C,GAAG,CAAC;MACxD;MACA,IAAIa,OAAO,CAACpB,WAAW,GAAGmB,aAAa,EAAE;QACvCA,aAAa,GAAGC,OAAO,CAACpB,WAAW;MACrC;MACA,IAAIoB,OAAO,CAACrB,YAAY,EAAE;QACxBA,YAAY,GAAG,IAAI;MACrB;MACA,IAAIqB,OAAO,CAACjB,OAAO,EAAE;QACnBA,OAAO,GAAG,IAAI;QACde,UAAU,CAAC7D,IAAI,CAAC+D,OAAO,CAACnB,SAAS,CAAC;MACpC;IACF;IAEA,MAAMsB,QAAQ,GAAG,CAAC,GAAGT,aAAa,CAACO,MAAM,CAAC,CAAC,CAAC,CAACtE,GAAG,CAACyE,CAAC,IAAIA,CAAC,CAACJ,OAAO,CAAC;IAChE,MAAMK,OAAO,GAAGX,aAAa,CAACY,IAAI,GAAGb,aAAa,IAC7CU,QAAQ,CAACI,IAAI,CAACC,CAAC,IAAIA,CAAC,CAACxB,MAAM,KAAK,MAAM,IAAIwB,CAAC,CAACxB,MAAM,KAAK,SAAS,CAAC;IAEtE1B,QAAQ,CAACiB,IAAI,CAAC;MACZC,YAAY,EAAEpB,KAAK,CAACqD,IAAI,CAACZ,IAAI,CAACI,MAAM,CAAC,CAAC,CAAC;MACvCxB,+BAA+B;MAC/BE,YAAY;MACZC,WAAW,EAAEmB,aAAa;MAC1BlB,SAAS,EAAEE,OAAO,GACd,MAAMxC,OAAO,CAACC,GAAG,CAACsD,UAAU,CAACnE,GAAG,CAAC+E,EAAE,IAAIA,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC/D,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,GAC5D,MAAMJ,OAAO,CAACuC,OAAO,CAAC,CAAC;MAC3BC,OAAO;MACPC,MAAM,EAAEqB,OAAO,GACX,SAAS,GACTF,QAAQ,CAACI,IAAI,CAACC,CAAC,IAAIA,CAAC,CAACxB,MAAM,KAAK,OAAO,CAAC,GACxC,OAAO,GACP,QAAQ;MACZ,IAAI,CAACD,OAAO,GAAG;QAAEE,UAAU,EAAE0B,MAAM,CAACd,IAAI,CAACS,IAAI;MAAE,CAAC,GAAG,CAAC,CAAC;IACvD,CAAC,CAAC;EACJ;EAEA,KAAK,MAAMnB,GAAG,IAAIhC,YAAY,EAAE;IAC9B,MAAMyD,MAAM,GAAG,GAAGzB,GAAG,CAAChD,WAAW,IAAIgD,GAAG,CAACjD,QAAQ,IAAIiD,GAAG,CAAC/C,WAAW,EAAE;IACtE,MAAMxB,EAAE,GAAGuE,GAAG,CAAC/C,WAAW;IAE1B,MAAMgD,UAAkC,GAAGD,GAAG,CAACjD,QAAQ,KAAKiD,GAAG,CAAChD,WAAW,GACvE,QAAQ,GACR,WAAW;IAEf+C,SAAS,CAACG,GAAG,CACXhF,KAAK,CAACiF,KAAK,CAACtE,OAAO,CACjB;MACE,GAAGH,OAAO;MACV0E,OAAO,EAAE;QACPxB,IAAI,EAAEqB,UAAU;QAChBzE,OAAO,EAAEwE,GAAG,CAACjD;MACf,CAAC;MACDsD,0BAA0B,EAAEL,GAAG,CAAChD,WAAW;MAC3Ce,QAAQ;MACRtC;IACF,CAAC,EACD;MACE2D,IAAI,EAAGyB,OAA4B,IAAK;QACtC,IAAIL,OAAO,EAAE;UACX;QACF;QACAD,aAAa,CAACQ,GAAG,CAACU,MAAM,EAAE;UAAEZ,OAAO;UAAEpF;QAAG,CAAC,CAAC;QAC1CgF,YAAY,CAAC,CAAC;MAChB,CAAC;MACDiB,KAAK,EAAGC,GAAY,IAAK;QACvB,IAAInB,OAAO,EAAE;UACX;QACF;QACAA,OAAO,GAAG,IAAI;QACdT,SAAS,CAAC6B,WAAW,CAAC,CAAC;QACvBzD,QAAQ,CAACuD,KAAK,CAACC,GAAG,CAAC;MACrB,CAAC;MACD;MACAE,QAAQ,EAAEA,CAAA,KAAM,CAAC;IACnB,CACF,CACF,CAAC;EACH;EAEA,OAAO,IAAI9G,qBAAqB,CAACgF,SAAS,CAAC;AAC7C","ignoreList":[]}

package/build/browser/observable/internal/base-list/BaseListQuery.js

@@ -82,15 +82,17 @@ export class BaseListQuery extends Query {
    * @param items Objects or cache keys to add to the list
    * @param status Status to set for the list
    * @param batch Batch context to use
-   * @param append Whether to append to the existing list or replace it
+   * @param mode Controls ordering responsibility and append behavior
    * @param totalCount Optional total count from API response
    * @returns The updated entry
    */
-  _updateList(items, status, batch, append = false, totalCount) {
+  _updateList(items, status, batch, mode = {
+    type: "clientOrdered"
+  }, totalCount) {
     if (process.env.NODE_ENV !== "production") {
       this.logger?.child({
         methodName: "updateList"
-      }).debug(`{status: ${status}, append: ${append}}`, JSON.stringify(items, null, 2));
+      }).debug(`{status: ${status}, mode: ${JSON.stringify(mode)}}`, JSON.stringify(items, null, 2));
     }
     let objectCacheKeys;
     if (items.length === 0) {
@@ -102,8 +104,11 @@ export class BaseListQuery extends Query {
       // Items are already cache keys
       objectCacheKeys = items;
     }
+    const append = mode.type === "serverOrdered" && mode.append;
     objectCacheKeys = this.#retainReleaseAppend(batch, append, objectCacheKeys);
-    objectCacheKeys = this._sortCacheKeys(objectCacheKeys, batch);
+    if (mode.type === "clientOrdered") {
+      objectCacheKeys = this._sortCacheKeys(objectCacheKeys, batch);
+    }
     objectCacheKeys = removeDuplicates(objectCacheKeys, batch);
     return this.writeToStore({
       data: objectCacheKeys,
@@ -393,7 +398,10 @@ export class BaseListQuery extends Query {
           }
         }
         const objectKeys = this.store.objects.storeOsdkInstances(result.data, batch, this.rdpConfig, this.selectFieldSet);
-        return this._updateList(objectKeys, finalStatus, batch, append, this.currentTotalCount);
+        return this._updateList(objectKeys, finalStatus, batch, {
+          type: "serverOrdered",
+          append
+        }, this.currentTotalCount);
       });
       return retVal;
     } catch (error) {