@osdk/react 0.10.0-beta.1 → 0.10.0-beta.10

package/build/cjs/public/experimental.cjs

@@ -1,412 +1,103 @@
 'use strict';
 
-var chunkV32JHU3O_cjs = require('../chunk-V32JHU3O.cjs');
+var chunkOVBG5VXE_cjs = require('../chunk-OVBG5VXE.cjs');
+var chunkSVVMLSKN_cjs = require('../chunk-SVVMLSKN.cjs');
 var unstableDoNotUse = require('@osdk/client/unstable-do-not-use');
-var React9 = require('react');
+var React4 = require('react');
 var client = require('@osdk/client');
 
 function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
 
-var React9__default = /*#__PURE__*/_interopDefault(React9);
+var React4__default = /*#__PURE__*/_interopDefault(React4);
 
-function fakeClientFn(..._args) {
-  throw new Error("This is not a real client. Did you forget to <OsdkContext.Provider>?");
-}
-var fakeClient = Object.assign(fakeClientFn, {
-  fetchMetadata: fakeClientFn
-});
-var OsdkContext2 = /* @__PURE__ */ React9__default.default.createContext({
-  client: fakeClient,
-  observableClient: void 0
-});
-
-// src/new/OsdkProvider2.tsx
 function OsdkProvider2({
   children,
   client,
   observableClient
 }) {
-  observableClient = React9.useMemo(() => observableClient ?? unstableDoNotUse.createObservableClient(client), [client, observableClient]);
-  return /* @__PURE__ */ React9__default.default.createElement(OsdkContext2.Provider, {
+  observableClient = React4.useMemo(() => observableClient ?? unstableDoNotUse.createObservableClient(client), [client, observableClient]);
+  return /* @__PURE__ */ React4__default.default.createElement(chunkSVVMLSKN_cjs.OsdkContext2.Provider, {
     value: {
       client,
       observableClient
     }
-  }, /* @__PURE__ */ React9__default.default.createElement(chunkV32JHU3O_cjs.OsdkContext.Provider, {
+  }, /* @__PURE__ */ React4__default.default.createElement(chunkOVBG5VXE_cjs.OsdkContext.Provider, {
     value: {
       client
     }
   }, children));
 }
-
-// ../../node_modules/.pnpm/@osdk+shared.client@1.0.1/node_modules/@osdk/shared.client/index.js
-var symbolClientContext = Symbol("ClientContext");
-
-// ../../node_modules/.pnpm/@osdk+shared.client2@1.0.0/node_modules/@osdk/shared.client2/index.js
-var symbolClientContext2 = "__osdkClientContext";
-
-// ../../node_modules/.pnpm/@osdk+shared.net.errors@2.5.0-beta.2/node_modules/@osdk/shared.net.errors/build/esm/PalantirApiError.js
-var PalantirApiError = class extends Error {
-  constructor(message, errorName, errorCode, errorDescription, statusCode, errorInstanceId, parameters) {
-    super(message);
-    this.message = message;
-    this.errorName = errorName;
-    this.errorCode = errorCode;
-    this.errorDescription = errorDescription;
-    this.statusCode = statusCode;
-    this.errorInstanceId = errorInstanceId;
-    this.parameters = parameters;
-  }
-};
-
-// ../../node_modules/.pnpm/@osdk+shared.net.errors@2.5.0-beta.2/node_modules/@osdk/shared.net.errors/build/esm/UnknownError.js
-var UnknownError = class extends PalantirApiError {
-  constructor(message, errorName, originalError, statusCode) {
-    super(message, errorName, void 0, void 0, statusCode);
-    this.originalError = originalError;
-  }
-};
-
-// ../../node_modules/.pnpm/@osdk+shared.net.platformapi@1.6.0/node_modules/@osdk/shared.net.platformapi/build/esm/foundryPlatformFetch.js
-async function foundryPlatformFetch(client, [httpMethodNum, origPath, flags, contentType, responseContentType], ...args) {
-  const path = origPath.replace(/\{([^}]+)\}/g, () => encodeURIComponent(args.shift()));
-  const body = flags & 1 ? args.shift() : void 0;
-  const queryArgs = flags & 2 ? args.shift() : void 0;
-  const headerArgs = flags & 4 ? args.shift() : void 0;
-  const method = ["GET", "POST", "PUT", "DELETE", "PATCH"][httpMethodNum];
-  return await apiFetch(client[symbolClientContext2] ?? client[symbolClientContext] ?? client, method, path, body, queryArgs, headerArgs, contentType, responseContentType);
-}
-async function apiFetch(clientCtx, method, endpointPath, data, queryArguments, headers, requestMediaType, responseMediaType) {
-  const url = parseUrl(clientCtx.baseUrl, endpointPath);
-  for (const [key, value] of Object.entries(queryArguments || {})) {
-    if (value == null) {
-      continue;
-    }
-    if (Array.isArray(value)) {
-      for (const item of value) {
-        url.searchParams.append(key, item);
-      }
-    } else {
-      url.searchParams.append(key, value);
-    }
-  }
-  const headersInit = new Headers();
-  headersInit.set("Content-Type", requestMediaType ?? "application/json");
-  headersInit.set("Accept", responseMediaType ?? "application/json");
-  Object.entries(headers || {}).forEach(([key, value]) => {
-    if (key === "Content-Type" && typeof value === "string") {
-      headersInit.set("Content-Type", value);
-    } else if (key === "Accept" && typeof value === "string") {
-      headersInit.set("Accept", value);
-    } else if (value != null) {
-      headersInit.append(key, value.toString());
-    }
-  });
-  const body = data == null || data instanceof globalThis.Blob ? data : JSON.stringify(data);
-  const response = await clientCtx.fetch(url.toString(), {
-    body,
-    method,
-    headers: headersInit
-  });
-  if (!response.ok) {
-    try {
-      const convertedError = await response.json();
-      return new PalantirApiError(convertedError.message, convertedError.errorName, convertedError.errorCode, convertedError.errorDescription, response.status, convertedError.errorInstanceId, convertedError.parameters);
-    } catch (e) {
-      if (e instanceof Error) {
-        return new UnknownError(e.message, "UNKNOWN");
-      }
-      return new UnknownError("Unable to parse error response", "UNKNOWN");
-    }
-  }
-  if (response.status === 204) {
-    return;
-  }
-  if (responseMediaType == null || responseMediaType === "application/json") {
-    return await response.json();
-  }
-  return response;
-}
-function parseUrl(baseUrl, endpointPath) {
-  baseUrl += baseUrl.endsWith("/") ? "" : "/";
-  return new URL(`api${endpointPath}`, baseUrl);
-}
-
-// ../../node_modules/.pnpm/@osdk+foundry.admin@2.45.0/node_modules/@osdk/foundry.admin/build/esm/public/User.js
-var User_exports = {};
-chunkV32JHU3O_cjs.__export(User_exports, {
-  deleteUser: () => deleteUser,
-  get: () => get,
-  getBatch: () => getBatch,
-  getCurrent: () => getCurrent,
-  getMarkings: () => getMarkings,
-  list: () => list,
-  profilePicture: () => profilePicture,
-  revokeAllTokens: () => revokeAllTokens,
-  search: () => search
-});
-var _deleteUser = [3, "/v2/admin/users/{0}"];
-function deleteUser($ctx, ...args) {
-  return foundryPlatformFetch($ctx, _deleteUser, ...args);
-}
-var _list = [0, "/v2/admin/users", 2];
-function list($ctx, ...args) {
-  return foundryPlatformFetch($ctx, _list, ...args);
-}
-var _get = [0, "/v2/admin/users/{0}", 2];
-function get($ctx, ...args) {
-  return foundryPlatformFetch($ctx, _get, ...args);
-}
-var _getBatch = [1, "/v2/admin/users/getBatch", 1];
-function getBatch($ctx, ...args) {
-  return foundryPlatformFetch($ctx, _getBatch, ...args);
-}
-var _getCurrent = [0, "/v2/admin/users/getCurrent"];
-function getCurrent($ctx, ...args) {
-  return foundryPlatformFetch($ctx, _getCurrent, ...args);
-}
-var _getMarkings = [0, "/v2/admin/users/{0}/getMarkings", 2];
-function getMarkings($ctx, ...args) {
-  return foundryPlatformFetch($ctx, _getMarkings, ...args);
-}
-var _profilePicture = [0, "/v2/admin/users/{0}/profilePicture", , , "application/octet-stream"];
-function profilePicture($ctx, ...args) {
-  return foundryPlatformFetch($ctx, _profilePicture, ...args);
-}
-var _search = [1, "/v2/admin/users/search", 1];
-function search($ctx, ...args) {
-  return foundryPlatformFetch($ctx, _search, ...args);
-}
-var _revokeAllTokens = [1, "/v2/admin/users/{0}/revokeAllTokens", 2];
-function revokeAllTokens($ctx, ...args) {
-  return foundryPlatformFetch($ctx, _revokeAllTokens, ...args);
-}
-
-// src/new/makeExternalStore.ts
-function makeExternalStore(createObservation, _name, initialValue) {
-  let lastResult = initialValue;
-  function getSnapShot() {
-    return lastResult;
-  }
-  function subscribe(notifyUpdate) {
-    const obs = createObservation({
-      next: (payload) => {
-        lastResult = payload;
-        notifyUpdate();
-      },
-      error: (error) => {
-        lastResult = {
-          ...lastResult ?? {},
-          error: error instanceof Error ? error : new Error(String(error))
-        };
-        notifyUpdate();
-      },
-      complete: () => {
-      }
-    });
-    return () => {
-      obs.unsubscribe();
-    };
-  }
-  return {
-    subscribe,
-    getSnapShot
-  };
-}
-
-// src/utils/usePlatformQuery.ts
-function usePlatformQuery({
-  query,
-  queryName,
-  enabled = true
-}) {
-  const observerRef = React9__default.default.useRef();
-  const handleQuery = React9__default.default.useCallback(() => {
-    const observer = observerRef.current;
-    if (observer == null) return;
-    observer.next({
-      status: "loading",
-      data: void 0
-    });
-    query().then((data) => {
-      observer.next({
-        status: "success",
-        data
-      });
-    }).catch((err) => {
-      observer.error(err);
-    });
-  }, [query]);
-  const {
-    subscribe,
-    getSnapShot
-  } = React9__default.default.useMemo(() => {
-    if (!enabled) {
-      return makeExternalStore(() => ({
-        unsubscribe: () => {
-        }
-      }), process.env.NODE_ENV !== "production" ? `${queryName} Query [DISABLED]` : void 0);
-    }
-    return makeExternalStore((observer) => {
-      observerRef.current = observer;
-      handleQuery();
-      return {
-        unsubscribe: () => {
-          observerRef.current = void 0;
-        }
-      };
-    });
-  }, [enabled, queryName, handleQuery]);
-  const payload = React9__default.default.useSyncExternalStore(subscribe, getSnapShot);
-  let error;
-  if (payload && "error" in payload && payload.error != null) {
-    error = payload.error;
-  } else if (payload?.status === "error") {
-    error = new Error(`Failed to query platform API: ${queryName}`);
-  }
-  return {
-    data: payload?.data,
-    isLoading: enabled ? payload?.status === "loading" || !payload : false,
-    error,
-    refetch: handleQuery
-  };
-}
-
-// src/new/platform-apis/admin/useCurrentFoundryUser.ts
-function useCurrentFoundryUser({
-  enabled = true
-} = {}) {
-  const {
-    client
-  } = React9__default.default.useContext(OsdkContext2);
-  const handleQuery = React9__default.default.useCallback(() => User_exports.getCurrent(client), [client]);
-  const query = usePlatformQuery({
-    query: handleQuery,
-    enabled,
-    queryName: "foundry-current-user"
-  });
-  return {
-    currentUser: query.data,
-    isLoading: query.isLoading,
-    error: query.error,
-    refetch: query.refetch
-  };
-}
-function useFoundryUser(userId, {
-  enabled = true,
-  status = "ACTIVE"
-} = {}) {
-  const {
-    client
-  } = React9__default.default.useContext(OsdkContext2);
-  const handleQuery = React9__default.default.useCallback(() => {
-    return User_exports.get(client, userId, {
-      status
-    });
-  }, [client, userId, status]);
-  const query = usePlatformQuery({
-    query: handleQuery,
-    enabled,
-    queryName: "foundry-user"
-  });
-  return {
-    user: query.data,
-    isLoading: query.isLoading,
-    error: query.error,
-    refetch: query.refetch
-  };
-}
-function useFoundryUsersList({
-  enabled = true,
-  include = "ACTIVE",
-  pageSize = 1e3,
-  pageToken
-} = {}) {
-  const {
-    client
-  } = React9__default.default.useContext(OsdkContext2);
-  const handleQuery = React9__default.default.useCallback(() => {
-    return User_exports.list(client, {
-      include,
-      pageSize,
-      pageToken
-    });
-  }, [client, include, pageSize, pageToken]);
-  const query = usePlatformQuery({
-    query: handleQuery,
-    enabled,
-    queryName: "foundry-users-list"
-  });
-  return {
-    users: query.data?.data,
-    nextPageToken: query.data?.nextPageToken,
-    isLoading: query.isLoading,
-    error: query.error,
-    refetch: query.refetch
-  };
-}
 var emptyArray = Object.freeze([]);
+var emptyMap = /* @__PURE__ */ new Map();
 function useLinks(objects, linkName, options = {}) {
   const {
     observableClient
-  } = React9__default.default.useContext(OsdkContext2);
+  } = React4__default.default.useContext(chunkSVVMLSKN_cjs.OsdkContext2);
   const {
     enabled = true,
     ...otherOptions
   } = options;
-  const stableWhere = React9__default.default.useMemo(() => otherOptions.where, [JSON.stringify(otherOptions.where)]);
-  const stableOrderBy = React9__default.default.useMemo(() => otherOptions.orderBy, [JSON.stringify(otherOptions.orderBy)]);
-  const objectsKey = React9__default.default.useMemo(() => {
+  const stableWhere = React4__default.default.useMemo(() => otherOptions.where, [JSON.stringify(otherOptions.where)]);
+  const stableOrderBy = React4__default.default.useMemo(() => otherOptions.orderBy, [JSON.stringify(otherOptions.orderBy)]);
+  const stableSelect = React4__default.default.useMemo(() => otherOptions.$select, [JSON.stringify(otherOptions.$select)]);
+  const objectsKey = React4__default.default.useMemo(() => {
     if (objects === void 0) return "";
     const arr = Array.isArray(objects) ? objects : [objects];
     return arr.map((obj) => `${obj.$apiName}:${obj.$primaryKey}`).join(",");
   }, [objects]);
-  const objectsArray = React9__default.default.useMemo(() => {
+  const objectsArray = React4__default.default.useMemo(() => {
     return objects === void 0 ? emptyArray : Array.isArray(objects) ? objects : [objects];
   }, [objectsKey, objects]);
   const {
     subscribe,
     getSnapShot
-  } = React9__default.default.useMemo(() => {
+  } = React4__default.default.useMemo(() => {
     if (!enabled) {
-      return makeExternalStore(() => ({
+      return chunkSVVMLSKN_cjs.makeExternalStore(() => ({
         unsubscribe: () => {
         }
-      }));
+      }), `links ${linkName} for ${objectsKey} [DISABLED]`);
     }
-    return makeExternalStore((observer) => observableClient.observeLinks(objectsArray, linkName, {
+    return chunkSVVMLSKN_cjs.makeExternalStore((observer) => observableClient.observeLinks(objectsArray, linkName, {
       linkName,
       where: stableWhere,
       pageSize: otherOptions.pageSize,
       orderBy: stableOrderBy,
-      mode: otherOptions.mode
-    }, observer));
-  }, [enabled, observableClient, objectsArray, objectsKey, linkName, stableWhere, otherOptions.pageSize, stableOrderBy, otherOptions.mode]);
-  const payload = React9__default.default.useSyncExternalStore(subscribe, getSnapShot);
-  return {
+      mode: otherOptions.mode,
+      dedupeInterval: otherOptions.dedupeIntervalMs ?? 2e3,
+      ...stableSelect ? {
+        select: stableSelect
+      } : {}
+    }, observer), `links ${linkName} for ${objectsKey}`);
+  }, [enabled, observableClient, objectsArray, objectsKey, linkName, stableWhere, otherOptions.pageSize, stableOrderBy, otherOptions.mode, otherOptions.dedupeIntervalMs, stableSelect]);
+  const payload = React4__default.default.useSyncExternalStore(subscribe, getSnapShot);
+  return React4__default.default.useMemo(() => ({
     links: payload?.resolvedList,
+    linkedObjectsBySourcePrimaryKey: payload?.linkedObjectsBySourcePrimaryKey ?? emptyMap,
     isLoading: enabled ? payload?.status === "loading" || payload?.status === "init" || !payload : false,
     isOptimistic: payload?.isOptimistic ?? false,
     error: payload?.error,
     fetchMore: payload?.hasMore ? payload?.fetchMore : void 0,
     hasMore: payload?.hasMore ?? false
-  };
+  }), [payload, enabled]);
 }
+var OBJECT_TYPE_PLACEHOLDER = "$__OBJECT__TYPE__PLACEHOLDER";
 function useObjectSet(baseObjectSet, options = {}) {
   const {
     observableClient
-  } = React9__default.default.useContext(OsdkContext2);
+  } = React4__default.default.useContext(chunkSVVMLSKN_cjs.OsdkContext2);
   const {
     enabled = true,
     streamUpdates,
     ...otherOptions
   } = options;
-  const objectTypeKey = baseObjectSet.$objectSetInternals.def.apiName;
-  const previousObjectTypeRef = React9__default.default.useRef(objectTypeKey);
-  const previousPayloadRef = React9__default.default.useRef();
+  const objectTypeKey = enabled ? baseObjectSet.$objectSetInternals.def.apiName : OBJECT_TYPE_PLACEHOLDER;
+  const previousObjectTypeRef = React4__default.default.useRef(objectTypeKey);
+  const previousCompletedPayloadRef = React4__default.default.useRef();
   const objectTypeChanged = previousObjectTypeRef.current !== objectTypeKey;
   if (objectTypeChanged) {
     previousObjectTypeRef.current = objectTypeKey;
+    previousCompletedPayloadRef.current = void 0;
   }
   const stableKey = unstableDoNotUse.computeObjectSetCacheKey(baseObjectSet, {
     where: otherOptions.where,
@@ -416,20 +107,21 @@ function useObjectSet(baseObjectSet, options = {}) {
     subtract: otherOptions.subtract,
     pivotTo: otherOptions.pivotTo,
     pageSize: otherOptions.pageSize,
-    orderBy: otherOptions.orderBy
+    orderBy: otherOptions.orderBy,
+    select: otherOptions.$select
   });
   const {
     subscribe,
     getSnapShot
-  } = React9__default.default.useMemo(() => {
+  } = React4__default.default.useMemo(() => {
     if (!enabled) {
-      return makeExternalStore(() => ({
+      return chunkSVVMLSKN_cjs.makeExternalStore(() => ({
         unsubscribe: () => {
         }
       }), process.env.NODE_ENV !== "production" ? `objectSet ${stableKey} [DISABLED]` : void 0);
     }
-    const initialValue = objectTypeChanged ? void 0 : previousPayloadRef.current;
-    return makeExternalStore((observer) => {
+    const initialValue = objectTypeChanged ? void 0 : previousCompletedPayloadRef.current;
+    return chunkSVVMLSKN_cjs.makeExternalStore((observer) => {
       const subscription = observableClient.observeObjectSet(baseObjectSet, {
         where: otherOptions.where,
         withProperties: otherOptions.withProperties,
@@ -441,37 +133,58 @@ function useObjectSet(baseObjectSet, options = {}) {
         orderBy: otherOptions.orderBy,
         dedupeInterval: otherOptions.dedupeIntervalMs ?? 2e3,
         autoFetchMore: otherOptions.autoFetchMore,
-        streamUpdates
+        streamUpdates,
+        select: otherOptions.$select
       }, observer);
       return subscription;
     }, process.env.NODE_ENV !== "production" ? `objectSet ${stableKey}` : void 0, initialValue);
   }, [enabled, observableClient, stableKey, streamUpdates, objectTypeChanged]);
-  const payload = React9__default.default.useSyncExternalStore(subscribe, getSnapShot);
-  React9__default.default.useEffect(() => {
-    if (payload) {
-      previousPayloadRef.current = payload;
-    }
-  }, [payload]);
-  return {
-    data: payload?.resolvedList,
-    isLoading: payload?.status === "loading" || !payload && true || false,
-    error: payload && "error" in payload ? payload.error : void 0,
-    fetchMore: payload?.hasMore ? payload.fetchMore : void 0,
-    objectSet: payload?.objectSet || baseObjectSet,
-    totalCount: payload?.totalCount
-  };
+  const payload = React4__default.default.useSyncExternalStore(subscribe, getSnapShot);
+  if (payload && isPayloadCompleted(payload)) {
+    previousCompletedPayloadRef.current = payload;
+  }
+  return React4__default.default.useMemo(() => {
+    const lastLoaded = isPayloadCompleted(payload) ? payload : previousCompletedPayloadRef.current;
+    return {
+      data: lastLoaded?.resolvedList,
+      isLoading: !isPayloadCompleted(payload),
+      error: lastLoaded && "error" in lastLoaded ? lastLoaded.error : void 0,
+      fetchMore: payload?.hasMore ? payload.fetchMore : void 0,
+      objectSet: payload?.objectSet || baseObjectSet,
+      totalCount: lastLoaded?.totalCount
+    };
+  }, [payload, baseObjectSet]);
+}
+function isPayloadCompleted(payload) {
+  if (payload != null && "error" in payload) {
+    return true;
+  }
+  if (payload?.status == null) {
+    return false;
+  }
+  switch (payload.status) {
+    case "loaded":
+    case "error":
+      return true;
+    case "loading":
+    case "init":
+      return false;
+    default:
+      payload.status;
+      return false;
+  }
 }
 function useOsdkAction(actionDef) {
   const {
     observableClient
-  } = React9__default.default.useContext(OsdkContext2);
-  const [error, setError] = React9__default.default.useState();
-  const [data, setData] = React9__default.default.useState();
-  const [isPending, setPending] = React9__default.default.useState(false);
-  const [isValidating, setValidating] = React9__default.default.useState(false);
-  const [validationResult, setValidationResult] = React9__default.default.useState();
-  const abortControllerRef = React9__default.default.useRef(null);
-  const applyAction = React9__default.default.useCallback(async function applyAction2(hookArgs) {
+  } = React4__default.default.useContext(chunkSVVMLSKN_cjs.OsdkContext2);
+  const [error, setError] = React4__default.default.useState();
+  const [data, setData] = React4__default.default.useState();
+  const [isPending, setPending] = React4__default.default.useState(false);
+  const [isValidating, setValidating] = React4__default.default.useState(false);
+  const [validationResult, setValidationResult] = React4__default.default.useState();
+  const abortControllerRef = React4__default.default.useRef(null);
+  const applyAction = React4__default.default.useCallback(async function applyAction2(hookArgs) {
     try {
       if (isValidating && abortControllerRef.current) {
         abortControllerRef.current.abort();
@@ -525,7 +238,7 @@ function useOsdkAction(actionDef) {
       setPending(false);
     }
   }, [observableClient, actionDef, isValidating]);
-  const validateAction = React9__default.default.useCallback(async function validateAction2(args) {
+  const validateAction = React4__default.default.useCallback(async function validateAction2(args) {
     try {
       if (isPending) {
         return void 0;
@@ -561,14 +274,14 @@ function useOsdkAction(actionDef) {
       setValidating(false);
     }
   }, [observableClient, actionDef, isPending]);
-  React9__default.default.useEffect(() => {
+  React4__default.default.useEffect(() => {
     return () => {
       if (abortControllerRef.current) {
         abortControllerRef.current.abort();
       }
     };
   }, []);
-  return {
+  return React4__default.default.useMemo(() => ({
     applyAction,
     validateAction,
     error,
@@ -576,51 +289,79 @@ function useOsdkAction(actionDef) {
     isPending,
     isValidating,
     validationResult
-  };
+  }), [applyAction, validateAction, error, data, isPending, isValidating, validationResult]);
 }
-function useOsdkAggregation(type, {
-  where = {},
-  withProperties,
-  aggregate,
-  dedupeIntervalMs
-}) {
+var EMPTY_WHERE = {};
+function useOsdkAggregation(type, options) {
+  const {
+    where = EMPTY_WHERE,
+    withProperties,
+    intersectWith,
+    aggregate,
+    dedupeIntervalMs
+  } = options;
+  const objectSet = "objectSet" in options ? options.objectSet : void 0;
   const {
     observableClient
-  } = React9__default.default.useContext(OsdkContext2);
-  const canonWhere = observableClient.canonicalizeWhereClause(where ?? {});
-  const stableWithProperties = React9__default.default.useMemo(() => withProperties, [JSON.stringify(withProperties)]);
-  const stableAggregate = React9__default.default.useMemo(() => aggregate, [JSON.stringify(aggregate)]);
+  } = React4__default.default.useContext(chunkSVVMLSKN_cjs.OsdkContext2);
+  const canonWhere = observableClient.canonicalizeWhereClause(where);
+  const stableCanonWhere = React4__default.default.useMemo(() => canonWhere, [JSON.stringify(canonWhere)]);
+  const objectSetRef = React4__default.default.useRef(objectSet);
+  objectSetRef.current = objectSet;
+  const objectSetKeyString = objectSet ? unstableDoNotUse.computeObjectSetCacheKey(objectSet) : void 0;
+  const stableWithProperties = React4__default.default.useMemo(() => withProperties, [JSON.stringify(withProperties)]);
+  const stableAggregate = React4__default.default.useMemo(() => aggregate, [JSON.stringify(aggregate)]);
+  const stableIntersectWith = React4__default.default.useMemo(() => intersectWith, [JSON.stringify(intersectWith)]);
   const {
     subscribe,
     getSnapShot
-  } = React9__default.default.useMemo(() => makeExternalStore((observer) => observableClient.observeAggregation({
-    type,
-    where: canonWhere,
-    withProperties: stableWithProperties,
-    aggregate: stableAggregate,
-    dedupeInterval: dedupeIntervalMs ?? 2e3
-  }, observer), process.env.NODE_ENV !== "production" ? `aggregation ${type.apiName} ${JSON.stringify(canonWhere)}` : void 0), [observableClient, type.apiName, type.type, canonWhere, stableWithProperties, stableAggregate, dedupeIntervalMs]);
-  const payload = React9__default.default.useSyncExternalStore(subscribe, getSnapShot);
-  let error;
-  if (payload && "error" in payload && payload.error) {
-    error = payload.error;
-  } else if (payload?.status === "error") {
-    error = new Error("Failed to execute aggregation");
-  }
-  const refetch = React9__default.default.useCallback(async () => {
+  } = React4__default.default.useMemo(() => {
+    if (objectSetKeyString && objectSetRef.current) {
+      return chunkSVVMLSKN_cjs.makeExternalStoreAsync((observer) => observableClient.observeAggregation({
+        type,
+        objectSet: objectSetRef.current,
+        where: stableCanonWhere,
+        withProperties: stableWithProperties,
+        intersectWith: stableIntersectWith,
+        aggregate: stableAggregate,
+        dedupeInterval: dedupeIntervalMs ?? 2e3
+      }, observer), process.env.NODE_ENV !== "production" ? `aggregation ${type.apiName} ${objectSetKeyString} ${JSON.stringify(stableCanonWhere)}` : void 0);
+    }
+    return chunkSVVMLSKN_cjs.makeExternalStore((observer) => (
+      // eslint-disable-next-line @typescript-eslint/no-deprecated
+      observableClient.observeAggregation({
+        type,
+        where: stableCanonWhere,
+        withProperties: stableWithProperties,
+        intersectWith: stableIntersectWith,
+        aggregate: stableAggregate,
+        dedupeInterval: dedupeIntervalMs ?? 2e3
+      }, observer)
+    ), process.env.NODE_ENV !== "production" ? `aggregation ${type.apiName} ${JSON.stringify(stableCanonWhere)}` : void 0);
+  }, [observableClient, type.apiName, type.type, objectSetKeyString, stableCanonWhere, stableWithProperties, stableIntersectWith, stableAggregate, dedupeIntervalMs]);
+  const payload = React4__default.default.useSyncExternalStore(subscribe, getSnapShot);
+  const refetch = React4__default.default.useCallback(async () => {
     await observableClient.invalidateObjectType(type.apiName);
   }, [observableClient, type.apiName]);
-  return {
-    data: payload?.result,
-    isLoading: payload?.status === "loading" || payload?.status === "init" || !payload,
-    error,
-    refetch
-  };
+  return React4__default.default.useMemo(() => {
+    let error;
+    if (payload && "error" in payload && payload.error) {
+      error = payload.error;
+    } else if (payload?.status === "error") {
+      error = new Error("Failed to execute aggregation");
+    }
+    return {
+      data: payload?.result,
+      isLoading: payload?.status === "loading" || payload?.status === "init" || !payload,
+      error,
+      refetch
+    };
+  }, [payload, refetch]);
 }
 function useOsdkFunction(queryDef, options = {}) {
   const {
     observableClient
-  } = React9__default.default.useContext(OsdkContext2);
+  } = React4__default.default.useContext(chunkSVVMLSKN_cjs.OsdkContext2);
   const {
     params,
     dependsOn,
@@ -628,86 +369,101 @@ function useOsdkFunction(queryDef, options = {}) {
     dedupeIntervalMs,
     enabled = true
   } = options;
-  const stableParams = React9__default.default.useMemo(() => params, [JSON.stringify(params)]);
-  const stableDependsOn = React9__default.default.useMemo(() => dependsOn, [JSON.stringify(dependsOn?.map((d) => typeof d === "string" ? d : d.apiName))]);
-  const stableDependsOnObjects = React9__default.default.useMemo(() => dependsOnObjects, [JSON.stringify(dependsOnObjects?.map((o) => ({
-    $apiName: o.$apiName,
-    $primaryKey: o.$primaryKey
-  })))]);
+  const stableParams = React4__default.default.useMemo(() => params, [JSON.stringify(params)]);
+  const stableDependsOn = React4__default.default.useMemo(() => dependsOn, [JSON.stringify(dependsOn?.map((d) => typeof d === "string" ? d : d.apiName))]);
+  const stableDependsOnObjects = React4__default.default.useMemo(() => dependsOnObjects, [JSON.stringify(dependsOnObjects?.map((item) => "$apiName" in item ? {
+    $apiName: item.$apiName,
+    $primaryKey: item.$primaryKey
+  } : {
+    __objectSet: unstableDoNotUse.getWireObjectSet(item)
+  }))]);
   const paramsForApi = stableParams;
   const {
     subscribe,
     getSnapShot
-  } = React9__default.default.useMemo(() => {
+  } = React4__default.default.useMemo(() => {
     if (!enabled) {
-      return makeExternalStore(() => ({
+      return chunkSVVMLSKN_cjs.makeExternalStore(() => ({
         unsubscribe: () => {
         }
       }), process.env.NODE_ENV !== "production" ? `function ${queryDef.apiName} ${JSON.stringify(stableParams)} [DISABLED]` : void 0);
     }
-    return makeExternalStore((observer) => observableClient.observeFunction(queryDef, paramsForApi, {
+    return chunkSVVMLSKN_cjs.makeExternalStore((observer) => observableClient.observeFunction(queryDef, paramsForApi, {
       dependsOn: stableDependsOn,
       dependsOnObjects: stableDependsOnObjects,
       dedupeInterval: dedupeIntervalMs ?? 2e3
     }, observer), process.env.NODE_ENV !== "production" ? `function ${queryDef.apiName} ${JSON.stringify(stableParams)}` : void 0);
   }, [observableClient, queryDef.apiName, queryDef.version, paramsForApi, stableDependsOn, stableDependsOnObjects, dedupeIntervalMs, enabled]);
-  const payload = React9__default.default.useSyncExternalStore(subscribe, getSnapShot);
-  const error = payload?.error ?? (payload?.status === "error" ? new Error("Failed to execute function") : void 0);
-  const refetch = React9__default.default.useCallback(() => {
+  const payload = React4__default.default.useSyncExternalStore(subscribe, getSnapShot);
+  const refetch = React4__default.default.useCallback(() => {
     void observableClient.invalidateFunction(queryDef, paramsForApi);
   }, [observableClient, queryDef, paramsForApi]);
-  return {
-    data: payload?.result,
-    isLoading: payload?.status === "loading",
-    error,
-    lastUpdated: payload?.lastUpdated ?? 0,
-    refetch
-  };
+  return React4__default.default.useMemo(() => {
+    const error = payload?.error ?? (payload?.status === "error" ? new Error("Failed to execute function") : void 0);
+    return {
+      data: payload?.result,
+      isLoading: payload?.status === "loading",
+      error,
+      lastUpdated: payload?.lastUpdated ?? 0,
+      refetch
+    };
+  }, [payload, refetch]);
 }
 function useOsdkObject(...args) {
   const {
     observableClient
-  } = React9__default.default.useContext(OsdkContext2);
+  } = React4__default.default.useContext(chunkSVVMLSKN_cjs.OsdkContext2);
   const isInstanceSignature = "$objectType" in args[0];
-  const enabled = isInstanceSignature ? typeof args[1] === "boolean" ? args[1] : true : typeof args[2] === "boolean" ? args[2] : true;
+  const optionsArg = !isInstanceSignature && args[2] != null && typeof args[2] === "object" ? args[2] : void 0;
+  const enabled = isInstanceSignature ? typeof args[1] === "boolean" ? args[1] : true : optionsArg ? optionsArg.enabled ?? true : typeof args[2] === "boolean" ? args[2] : true;
+  const selectArg = optionsArg?.$select;
   const mode = isInstanceSignature ? "offline" : void 0;
-  const objectType = isInstanceSignature ? args[0].$objectType : args[0].apiName;
+  const typeOrApiName = isInstanceSignature ? args[0].$objectType : args[0];
   const primaryKey = isInstanceSignature ? args[0].$primaryKey : args[1];
+  const apiNameString = typeof typeOrApiName === "string" ? typeOrApiName : typeOrApiName.apiName;
+  const stableSelect = React4__default.default.useMemo(() => selectArg, [JSON.stringify(selectArg)]);
   const {
     subscribe,
     getSnapShot
-  } = React9__default.default.useMemo(() => {
+  } = React4__default.default.useMemo(() => {
     if (!enabled) {
-      return makeExternalStore(() => ({
+      return chunkSVVMLSKN_cjs.makeExternalStore(() => ({
         unsubscribe: () => {
         }
-      }));
+      }), `object ${apiNameString} ${primaryKey} [DISABLED]`);
     }
-    return makeExternalStore((observer) => observableClient.observeObject(objectType, primaryKey, {
-      mode
-    }, observer));
-  }, [enabled, observableClient, objectType, primaryKey, mode]);
-  const payload = React9__default.default.useSyncExternalStore(subscribe, getSnapShot);
-  let error;
-  if (payload && "error" in payload && payload.error) {
-    error = payload.error;
-  } else if (payload?.status === "error") {
-    error = new Error("Failed to load object");
-  }
-  return {
-    object: payload?.object,
-    isLoading: enabled ? payload?.status === "loading" || payload?.status === "init" || !payload : false,
-    isOptimistic: !!payload?.isOptimistic,
-    error,
-    forceUpdate: () => {
-      throw new Error("not implemented");
+    return chunkSVVMLSKN_cjs.makeExternalStore((observer) => observableClient.observeObject(typeOrApiName, primaryKey, {
+      mode,
+      ...stableSelect ? {
+        select: stableSelect
+      } : {}
+    }, observer), `object ${apiNameString} ${primaryKey}`);
+  }, [enabled, observableClient, typeOrApiName, apiNameString, primaryKey, mode, stableSelect]);
+  const payload = React4__default.default.useSyncExternalStore(subscribe, getSnapShot);
+  const forceUpdate = React4__default.default.useCallback(() => {
+    throw new Error("not implemented");
+  }, []);
+  return React4__default.default.useMemo(() => {
+    let error;
+    if (payload && "error" in payload && payload.error) {
+      error = payload.error;
+    } else if (payload?.status === "error") {
+      error = new Error("Failed to load object");
     }
-  };
+    return {
+      object: payload?.object,
+      isLoading: enabled ? payload?.status === "loading" || payload?.status === "init" || !payload : false,
+      isOptimistic: !!payload?.isOptimistic,
+      error,
+      forceUpdate
+    };
+  }, [payload, enabled, forceUpdate]);
 }
+var EMPTY_WHERE2 = {};
 function useOsdkObjects(type, options) {
   const {
     observableClient
-  } = React9__default.default.useContext(OsdkContext2);
+  } = React4__default.default.useContext(chunkSVVMLSKN_cjs.OsdkContext2);
   const {
     pageSize,
     dedupeIntervalMs,
@@ -719,27 +475,30 @@ function useOsdkObjects(type, options) {
     streamUpdates,
     autoFetchMore,
     intersectWith,
-    pivotTo
+    pivotTo,
+    $select
   } = options ?? {};
-  const canonWhere = observableClient.canonicalizeWhereClause(where ?? {});
-  const stableRids = React9__default.default.useMemo(() => rids, [JSON.stringify(rids)]);
-  const stableWithProperties = React9__default.default.useMemo(() => withProperties, [JSON.stringify(withProperties)]);
-  const stableIntersectWith = React9__default.default.useMemo(() => intersectWith, [JSON.stringify(intersectWith)]);
-  const stableOrderBy = React9__default.default.useMemo(() => orderBy, [JSON.stringify(orderBy)]);
+  const canonWhere = observableClient.canonicalizeWhereClause(where ?? EMPTY_WHERE2);
+  const stableCanonWhere = React4__default.default.useMemo(() => canonWhere, [JSON.stringify(canonWhere)]);
+  const stableRids = React4__default.default.useMemo(() => rids, [JSON.stringify(rids)]);
+  const stableWithProperties = React4__default.default.useMemo(() => withProperties, [JSON.stringify(withProperties)]);
+  const stableIntersectWith = React4__default.default.useMemo(() => intersectWith, [JSON.stringify(intersectWith)]);
+  const stableOrderBy = React4__default.default.useMemo(() => orderBy, [JSON.stringify(orderBy)]);
+  const stableSelect = React4__default.default.useMemo(() => $select, [JSON.stringify($select)]);
   const {
     subscribe,
     getSnapShot
-  } = React9__default.default.useMemo(() => {
+  } = React4__default.default.useMemo(() => {
     if (!enabled) {
-      return makeExternalStore(() => ({
+      return chunkSVVMLSKN_cjs.makeExternalStore(() => ({
         unsubscribe: () => {
         }
       }), process.env.NODE_ENV !== "production" ? `list ${type.apiName} [DISABLED]` : void 0);
     }
-    return makeExternalStore((observer) => observableClient.observeList({
+    return chunkSVVMLSKN_cjs.makeExternalStore((observer) => observableClient.observeList({
       type,
       rids: stableRids,
-      where: canonWhere,
+      where: stableCanonWhere,
       dedupeInterval: dedupeIntervalMs ?? 2e3,
       pageSize,
       orderBy: stableOrderBy,
@@ -751,51 +510,56 @@ function useOsdkObjects(type, options) {
       } : {},
       ...pivotTo ? {
         pivotTo
+      } : {},
+      ...stableSelect ? {
+        select: stableSelect
       } : {}
-    }, observer), process.env.NODE_ENV !== "production" ? `list ${type.apiName} ${stableRids ? `[${stableRids.length} rids]` : ""} ${JSON.stringify(canonWhere)}` : void 0);
-  }, [enabled, observableClient, type, stableRids, canonWhere, dedupeIntervalMs, pageSize, stableOrderBy, streamUpdates, stableWithProperties, autoFetchMore, stableIntersectWith, pivotTo]);
-  const listPayload = React9__default.default.useSyncExternalStore(subscribe, getSnapShot);
-  let error;
-  if (listPayload && "error" in listPayload && listPayload.error) {
-    error = listPayload.error;
-  } else if (listPayload?.status === "error") {
-    error = new Error("Failed to load objects");
-  }
-  return {
-    fetchMore: listPayload?.hasMore ? listPayload.fetchMore : void 0,
-    error,
-    data: listPayload?.resolvedList,
-    isLoading: enabled ? listPayload?.status === "loading" || listPayload?.status === "init" || !listPayload : false,
-    isOptimistic: listPayload?.isOptimistic ?? false,
-    totalCount: listPayload?.totalCount
-  };
+    }, observer), process.env.NODE_ENV !== "production" ? `list ${type.apiName} ${stableRids ? `[${stableRids.length} rids]` : ""} ${JSON.stringify(stableCanonWhere)}` : void 0);
+  }, [enabled, observableClient, type.apiName, type.type, stableRids, stableCanonWhere, dedupeIntervalMs, pageSize, stableOrderBy, streamUpdates, stableWithProperties, autoFetchMore, stableIntersectWith, pivotTo, stableSelect]);
+  const listPayload = React4__default.default.useSyncExternalStore(subscribe, getSnapShot);
+  return React4__default.default.useMemo(() => {
+    let error;
+    if (listPayload && "error" in listPayload && listPayload.error) {
+      error = listPayload.error;
+    } else if (listPayload?.status === "error") {
+      error = new Error("Failed to load objects");
+    }
+    return {
+      fetchMore: listPayload?.hasMore ? listPayload.fetchMore : void 0,
+      error,
+      data: listPayload?.resolvedList,
+      isLoading: enabled ? listPayload?.status === "loading" || listPayload?.status === "init" || !listPayload : false,
+      isOptimistic: listPayload?.isOptimistic ?? false,
+      totalCount: listPayload?.totalCount
+    };
+  }, [listPayload, enabled]);
 }
 function useDebouncedCallback(callback, delay) {
-  const timeoutRef = React9__default.default.useRef();
-  const callbackRef = React9__default.default.useRef(callback);
-  const lastArgsRef = React9__default.default.useRef();
+  const timeoutRef = React4__default.default.useRef();
+  const callbackRef = React4__default.default.useRef(callback);
+  const lastArgsRef = React4__default.default.useRef();
   callbackRef.current = callback;
-  const cancel = React9__default.default.useCallback(() => {
+  const cancel = React4__default.default.useCallback(() => {
     if (timeoutRef.current) {
       clearTimeout(timeoutRef.current);
       timeoutRef.current = void 0;
     }
   }, []);
-  const flush = React9__default.default.useCallback(() => {
+  const flush = React4__default.default.useCallback(() => {
     if (timeoutRef.current && lastArgsRef.current) {
       clearTimeout(timeoutRef.current);
       timeoutRef.current = void 0;
       void callbackRef.current(...lastArgsRef.current);
     }
   }, []);
-  const debouncedCallback = React9__default.default.useCallback((...args) => {
+  const debouncedCallback = React4__default.default.useCallback((...args) => {
     lastArgsRef.current = args;
     cancel();
     timeoutRef.current = setTimeout(() => {
       void callbackRef.current(...args);
     }, delay);
   }, [delay, cancel]);
-  React9__default.default.useEffect(() => {
+  React4__default.default.useEffect(() => {
     return () => {
       cancel();
     };
@@ -808,17 +572,14 @@ function useDebouncedCallback(callback, delay) {
 
 Object.defineProperty(exports, "useOsdkClient", {
   enumerable: true,
-  get: function () { return chunkV32JHU3O_cjs.useOsdkClient; }
+  get: function () { return chunkOVBG5VXE_cjs.useOsdkClient; }
 });
 Object.defineProperty(exports, "useOsdkMetadata", {
   enumerable: true,
-  get: function () { return chunkV32JHU3O_cjs.useOsdkMetadata; }
+  get: function () { return chunkOVBG5VXE_cjs.useOsdkMetadata; }
 });
 exports.OsdkProvider2 = OsdkProvider2;
-exports.useCurrentFoundryUser = useCurrentFoundryUser;
 exports.useDebouncedCallback = useDebouncedCallback;
-exports.useFoundryUser = useFoundryUser;
-exports.useFoundryUsersList = useFoundryUsersList;
 exports.useLinks = useLinks;
 exports.useObjectSet = useObjectSet;
 exports.useOsdkAction = useOsdkAction;