@sanity/sdk 2.3.0 → 2.4.0

package/dist/index.js

@@ -1,8 +1,8 @@
-import { createClient, CorsOriginError } from "@sanity/client";
 import { Observable, share, map, distinctUntilChanged, skip, filter, exhaustMap, from, timer, switchMap, takeWhile, firstValueFrom, fromEvent, EMPTY, defer, asapScheduler, combineLatest, of, concatMap, withLatestFrom, concat, throwError, first as first$1, Subject, takeUntil, partition, merge, shareReplay, tap as tap$1, catchError as catchError$1, startWith as startWith$1, pairwise as pairwise$1, groupBy as groupBy$1, mergeMap as mergeMap$1, throttle, race, NEVER, Subscription, retry, debounceTime as debounceTime$1 } from "rxjs";
+import { createClient, CorsOriginError } from "@sanity/client";
+import { pick, omit, isEqual, isObject } from "lodash-es";
 import { devtools } from "zustand/middleware";
 import { createStore } from "zustand/vanilla";
-import { pick, omit, isEqual, isObject } from "lodash-es";
 import { first, switchMap as switchMap$1, groupBy, mergeMap, startWith, pairwise, filter as filter$1, map as map$1, delay, tap, catchError, scan, share as share$1, take, debounceTime } from "rxjs/operators";
 import { createController, createNode } from "@sanity/comlink";
 import { createSelector } from "reselect";
@@ -17,7 +17,16 @@ import { isKeySegment, isKeyedObject } from "@sanity/types";
 import { createDocumentLoaderFromClient } from "@sanity/mutate/_unstable_store";
 import { SDK_CHANNEL_NAME, SDK_NODE_NAME } from "@sanity/message-protocol";
 import { fromUrl } from "@sanity/bifur-client";
-var AuthStateType = /* @__PURE__ */ ((AuthStateType2) => (AuthStateType2.LOGGED_IN = "logged-in", AuthStateType2.LOGGING_IN = "logging-in", AuthStateType2.ERROR = "error", AuthStateType2.LOGGED_OUT = "logged-out", AuthStateType2))(AuthStateType || {});
+const SOURCE_ID = "__sanity_internal_sourceId";
+function datasetSource(projectId, dataset) {
+  return { [SOURCE_ID]: { projectId, dataset } };
+}
+function mediaLibrarySource(id) {
+  return { [SOURCE_ID]: ["media-library", id] };
+}
+function canvasSource(id) {
+  return { [SOURCE_ID]: ["canvas", id] };
+}
 function getPublishedId(id) {
   const draftsPrefix = "drafts.";
   return id.startsWith(draftsPrefix) ? id.slice(draftsPrefix.length) : id;
@@ -105,7 +114,7 @@ function createActionBinder(keyFn) {
   const instanceRegistry = /* @__PURE__ */ new Map(), storeRegistry = /* @__PURE__ */ new Map();
   return function(storeDefinition, action) {
     return function(instance, ...params) {
-      const keySuffix = keyFn(instance.config), compositeKey = storeDefinition.name + (keySuffix ? `:${keySuffix}` : "");
+      const keySuffix = keyFn(instance.config, ...params), compositeKey = storeDefinition.name + (keySuffix ? `:${keySuffix}` : "");
       let instances = instanceRegistry.get(compositeKey);
       instances || (instances = /* @__PURE__ */ new Set(), instanceRegistry.set(compositeKey, instances)), instances.has(instance.instanceId) || (instances.add(instance.instanceId), instance.onDispose(() => {
         instances.delete(instance.instanceId), instances.size === 0 && (storeRegistry.get(compositeKey)?.dispose(), storeRegistry.delete(compositeKey), instanceRegistry.delete(compositeKey));
@@ -119,7 +128,18 @@ const bindActionByDataset = createActionBinder(({ projectId, dataset }) => {
   if (!projectId || !dataset)
     throw new Error("This API requires a project ID and dataset configured.");
   return `${projectId}.${dataset}`;
-}), bindActionGlobally = createActionBinder(() => "global");
+}), bindActionBySource = createActionBinder(
+  ({ projectId, dataset }, { source }) => {
+    if (source) {
+      const id = source[SOURCE_ID];
+      if (!id) throw new Error("Invalid source (missing ID information)");
+      return Array.isArray(id) ? id.join(":") : `${id.projectId}.${id.dataset}`;
+    }
+    if (!projectId || !dataset)
+      throw new Error("This API requires a project ID and dataset configured.");
+    return `${projectId}.${dataset}`;
+  }
+), bindActionGlobally = createActionBinder(() => "global");
 function createStateSourceAction(options) {
   const selector = typeof options == "function" ? options : options.selector, subscribeHandler = options && "onSubscribe" in options ? options.onSubscribe : void 0, isEqual2 = options && "isEqual" in options ? options.isEqual ?? Object.is : Object.is, selectorContextCache = /* @__PURE__ */ new WeakMap();
   function stateSourceAction(context, ...params) {
@@ -167,6 +187,7 @@ function createStateSourceAction(options) {
   }
   return stateSourceAction;
 }
+var AuthStateType = /* @__PURE__ */ ((AuthStateType2) => (AuthStateType2.LOGGED_IN = "logged-in", AuthStateType2.LOGGING_IN = "logging-in", AuthStateType2.ERROR = "error", AuthStateType2.LOGGED_OUT = "logged-out", AuthStateType2))(AuthStateType || {});
 const DEFAULT_BASE = "http://localhost", AUTH_CODE_PARAM = "sid", DEFAULT_API_VERSION$1 = "2021-06-07", REQUEST_TAG_PREFIX = "sanity.sdk.auth", REFRESH_INTERVAL = 12 * 60 * 60 * 1e3, LOCK_NAME = "sanity-token-refresh-lock";
 function getLastRefreshTime(storageArea, storageKey) {
   try {
@@ -389,6 +410,21 @@ function getCleanedUrl(locationUrl) {
   }
   return loc.searchParams.delete("sid"), loc.searchParams.delete("url"), loc.toString();
 }
+function getClientErrorApiBody(error) {
+  const body = error.response?.body;
+  return body && typeof body == "object" ? body : void 0;
+}
+function getClientErrorApiType(error) {
+  const body = getClientErrorApiBody(error);
+  return body?.error?.type ?? body?.type;
+}
+function getClientErrorApiDescription(error) {
+  const body = getClientErrorApiBody(error);
+  return body?.error?.description ?? body?.description;
+}
+function isProjectUserNotFoundClientError(error) {
+  return getClientErrorApiType(error) === "projectUserNotFoundError";
+}
 async function checkForCookieAuth(projectId, clientFactory) {
   if (!projectId) return !1;
   try {
@@ -404,31 +440,34 @@ async function checkForCookieAuth(projectId, clientFactory) {
     return !1;
   }
 }
-function getStudioTokenFromLocalStorage(storageArea, projectId) {
-  if (!storageArea || !projectId) return null;
-  const studioStorageKey = `__studio_auth_token_${projectId}`;
-  return getTokenFromStorage(storageArea, studioStorageKey) || null;
+function getStudioTokenFromLocalStorage(storageArea, storageKey) {
+  return !storageArea || !storageKey ? null : getTokenFromStorage(storageArea, storageKey) || null;
 }
 const subscribeToStateAndFetchCurrentUser = ({
-  state
+  state,
+  instance
 }) => {
-  const { clientFactory, apiHost } = state.get().options;
+  const { clientFactory, apiHost } = state.get().options, useProjectHostname = !!instance.config.studioMode?.enabled, projectId = instance.config.projectId;
   return state.observable.pipe(
-    map(({ authState }) => authState),
+    map(({ authState, options }) => ({ authState, authMethod: options.authMethod })),
     filter(
-      (authState) => authState.type === AuthStateType.LOGGED_IN && !authState.currentUser
+      (value) => value.authState.type === AuthStateType.LOGGED_IN && !value.authState.currentUser
     ),
-    map((authState) => authState.token),
-    distinctUntilChanged()
+    map((value) => ({ token: value.authState.token, authMethod: value.authMethod })),
+    distinctUntilChanged(
+      (prev, curr) => prev.token === curr.token && prev.authMethod === curr.authMethod
+    )
   ).pipe(
     map(
-      (token) => clientFactory({
+      ({ token, authMethod }) => clientFactory({
         apiVersion: DEFAULT_API_VERSION$1,
         requestTagPrefix: REQUEST_TAG_PREFIX,
-        token,
+        token: authMethod === "cookie" ? void 0 : token,
         ignoreBrowserTokenWarning: !0,
-        useProjectHostname: !1,
+        useProjectHostname,
         useCdn: !1,
+        ...authMethod === "cookie" ? { withCredentials: !0 } : {},
+        ...useProjectHostname && projectId ? { projectId } : {},
         ...apiHost && { apiHost }
       })
     ),
@@ -473,8 +512,8 @@ const authStore = {
       clientFactory = createClient,
       initialLocationHref = getDefaultLocation()
     } = instance.config.auth ?? {};
-    let storageArea = instance.config.auth?.storageArea;
-    const storageKey = "__sanity_auth_token";
+    let storageArea = instance.config.auth?.storageArea, storageKey = "__sanity_auth_token";
+    const studioModeEnabled = instance.config.studioMode?.enabled;
     let loginDomain = "https://www.sanity.io";
     try {
       apiHost && new URL(apiHost).hostname.endsWith(".sanity.work") && (loginDomain = "https://www.sanity.work");
@@ -492,13 +531,15 @@ const authStore = {
     } catch (err) {
       console.error("Failed to parse dashboard context from initial location:", err);
     }
-    isInDashboard || (storageArea = storageArea ?? getDefaultStorage());
+    (!isInDashboard || studioModeEnabled) && (storageArea = storageArea ?? getDefaultStorage());
     let token, authMethod;
-    instance.config.studioMode?.enabled ? (token = getStudioTokenFromLocalStorage(storageArea, instance.config.projectId), token ? authMethod = "localstorage" : checkForCookieAuth(instance.config.projectId, clientFactory).then((isCookieAuthEnabled) => {
-      isCookieAuthEnabled && (authMethod = "cookie");
-    })) : (token = getTokenFromStorage(storageArea, storageKey), token && (authMethod = "localstorage"));
+    if (studioModeEnabled) {
+      const studioStorageKey = `__studio_auth_token_${instance.config.projectId ?? ""}`;
+      storageKey = studioStorageKey, token = getStudioTokenFromLocalStorage(storageArea, studioStorageKey), token && (authMethod = "localstorage");
+    } else
+      token = getTokenFromStorage(storageArea, storageKey), token && (authMethod = "localstorage");
     let authState;
-    return providedToken ? authState = { type: AuthStateType.LOGGED_IN, token: providedToken, currentUser: null } : getAuthCode(callbackUrl, initialLocationHref) || getTokenFromLocation(initialLocationHref) ? authState = { type: AuthStateType.LOGGING_IN, isExchangingToken: !1 } : token && !isInDashboard ? authState = { type: AuthStateType.LOGGED_IN, token, currentUser: null } : authState = { type: AuthStateType.LOGGED_OUT, isDestroyingSession: !1 }, {
+    return providedToken ? authState = { type: AuthStateType.LOGGED_IN, token: providedToken, currentUser: null } : token && studioModeEnabled ? authState = { type: AuthStateType.LOGGED_IN, token: token ?? "", currentUser: null } : getAuthCode(callbackUrl, initialLocationHref) || getTokenFromLocation(initialLocationHref) ? authState = { type: AuthStateType.LOGGING_IN, isExchangingToken: !1 } : token && !isInDashboard && !studioModeEnabled ? authState = { type: AuthStateType.LOGGED_IN, token, currentUser: null } : authState = { type: AuthStateType.LOGGED_OUT, isDestroyingSession: !1 }, {
       authState,
       dashboardContext,
       options: {
@@ -517,7 +558,21 @@ const authStore = {
   },
   initialize(context) {
     const subscriptions = [];
-    return subscriptions.push(subscribeToStateAndFetchCurrentUser(context)), context.state.get().options?.storageArea && subscriptions.push(subscribeToStorageEventsAndSetToken(context)), tokenRefresherRunning || (tokenRefresherRunning = !0, subscriptions.push(refreshStampedToken(context))), () => {
+    subscriptions.push(subscribeToStateAndFetchCurrentUser(context)), context.state.get().options?.storageArea && subscriptions.push(subscribeToStorageEventsAndSetToken(context));
+    try {
+      const { instance, state } = context, studioModeEnabled = !!instance.config.studioMode?.enabled, token = state.get().authState?.type === AuthStateType.LOGGED_IN ? state.get().authState.token : null;
+      if (studioModeEnabled && !token) {
+        const projectId = instance.config.projectId, clientFactory = state.get().options.clientFactory;
+        checkForCookieAuth(projectId, clientFactory).then((isCookieAuthEnabled) => {
+          isCookieAuthEnabled && state.set("enableCookieAuth", (prev) => ({
+            options: { ...prev.options, authMethod: "cookie" },
+            authState: prev.authState.type === AuthStateType.LOGGED_IN ? prev.authState : { type: AuthStateType.LOGGED_IN, token: "", currentUser: null }
+          }));
+        });
+      }
+    } catch {
+    }
+    return tokenRefresherRunning || (tokenRefresherRunning = !0, subscriptions.push(refreshStampedToken(context))), () => {
       for (const subscription of subscriptions)
         subscription.unsubscribe();
     };
@@ -565,13 +620,7 @@ const authStore = {
   }) : currentAuthState.type !== AuthStateType.LOGGED_OUT && state.set("setToken", {
     authState: { type: AuthStateType.LOGGED_OUT, isDestroyingSession: !1 }
   });
-});
-function compareProjectOrganization(projectId, projectOrganizationId, currentDashboardOrgId) {
-  return projectOrganizationId !== currentDashboardOrgId ? {
-    error: `Project ${projectId} belongs to Organization ${projectOrganizationId ?? "unknown"}, but the Dashboard has Organization ${currentDashboardOrgId} selected`
-  } : { error: null };
-}
-const DEFAULT_API_VERSION = "2024-11-12", DEFAULT_REQUEST_TAG_PREFIX = "sanity.sdk", allowedKeys = Object.keys({
+}), DEFAULT_API_VERSION = "2024-11-12", DEFAULT_REQUEST_TAG_PREFIX = "sanity.sdk", allowedKeys = Object.keys({
   apiHost: null,
   useCdn: null,
   token: null,
@@ -586,7 +635,8 @@ const DEFAULT_API_VERSION = "2024-11-12", DEFAULT_REQUEST_TAG_PREFIX = "sanity.s
   apiVersion: null,
   requestTagPrefix: null,
   useProjectHostname: null,
-  "~experimental_resource": null
+  "~experimental_resource": null,
+  source: null
 }), DEFAULT_CLIENT_CONFIG = {
   apiVersion: DEFAULT_API_VERSION,
   useCdn: !1,
@@ -612,6 +662,10 @@ const DEFAULT_API_VERSION = "2024-11-12", DEFAULT_REQUEST_TAG_PREFIX = "sanity.s
 }), getClientConfigKey = (options) => JSON.stringify(pick(options, ...allowedKeys)), getClient = bindActionGlobally(
   clientStore,
   ({ state, instance }, options) => {
+    if (!options || typeof options != "object")
+      throw new Error(
+        'getClient() requires a configuration object with at least an "apiVersion" property. Example: getClient(instance, { apiVersion: "2024-11-12" })'
+      );
     const disallowedKeys = Object.keys(options).filter((key2) => !allowedKeys.includes(key2));
     if (disallowedKeys.length > 0) {
       const listFormatter = new Intl.ListFormat("en", { style: "long", type: "conjunction" });
@@ -619,16 +673,22 @@ const DEFAULT_API_VERSION = "2024-11-12", DEFAULT_REQUEST_TAG_PREFIX = "sanity.s
         `The client options provided contains unsupported properties: ${listFormatter.format(disallowedKeys)}. Allowed keys are: ${listFormatter.format(allowedKeys)}.`
       );
     }
-    const tokenFromState = state.get().token, { clients, authMethod } = state.get(), projectId = options.projectId ?? instance.config.projectId, dataset = options.dataset ?? instance.config.dataset, apiHost = options.apiHost ?? instance.config.auth?.apiHost, effectiveOptions = {
+    const tokenFromState = state.get().token, { clients, authMethod } = state.get(), hasSource = !!options.source;
+    let sourceId = options.source?.[SOURCE_ID], resource;
+    Array.isArray(sourceId) && (resource = { type: sourceId[0], id: sourceId[1] }, sourceId = void 0);
+    const projectId = options.projectId ?? instance.config.projectId, dataset = options.dataset ?? instance.config.dataset, apiHost = options.apiHost ?? instance.config.auth?.apiHost, effectiveOptions = {
       ...DEFAULT_CLIENT_CONFIG,
-      ...(options.scope === "global" || !projectId) && { useProjectHostname: !1 },
+      ...(options.scope === "global" || !projectId || hasSource) && { useProjectHostname: !1 },
       token: authMethod === "cookie" ? void 0 : tokenFromState ?? void 0,
       ...options,
       ...projectId && { projectId },
       ...dataset && { dataset },
-      ...apiHost && { apiHost }
+      ...apiHost && { apiHost },
+      ...resource && { "~experimental_resource": resource }
     };
-    effectiveOptions.token === null || typeof effectiveOptions.token > "u" ? (delete effectiveOptions.token, authMethod === "cookie" && (effectiveOptions.withCredentials = !0)) : delete effectiveOptions.withCredentials;
+    hasSource && ((options.projectId || options.dataset) && console.warn(
+      "Both source and explicit projectId/dataset are provided. The source will be used and projectId/dataset will be ignored."
+    ), delete effectiveOptions.projectId, delete effectiveOptions.dataset), effectiveOptions.token === null || typeof effectiveOptions.token > "u" ? (delete effectiveOptions.token, authMethod === "cookie" && (effectiveOptions.withCredentials = !0)) : delete effectiveOptions.withCredentials;
     const key = getClientConfigKey(effectiveOptions);
     if (clients[key]) return clients[key];
     const client = createClient(effectiveOptions);
@@ -637,7 +697,47 @@ const DEFAULT_API_VERSION = "2024-11-12", DEFAULT_REQUEST_TAG_PREFIX = "sanity.s
 ), getClientState = bindActionGlobally(
   clientStore,
   createStateSourceAction(({ instance }, options) => getClient(instance, options))
-);
+), API_VERSION$6 = "vX";
+function agentGenerate(instance, options) {
+  return getClientState(instance, {
+    apiVersion: API_VERSION$6,
+    projectId: instance.config.projectId,
+    dataset: instance.config.dataset
+  }).observable.pipe(switchMap((client) => client.observable.agent.action.generate(options)));
+}
+function agentTransform(instance, options) {
+  return getClientState(instance, {
+    apiVersion: API_VERSION$6,
+    projectId: instance.config.projectId,
+    dataset: instance.config.dataset
+  }).observable.pipe(switchMap((client) => client.observable.agent.action.transform(options)));
+}
+function agentTranslate(instance, options) {
+  return getClientState(instance, {
+    apiVersion: API_VERSION$6,
+    projectId: instance.config.projectId,
+    dataset: instance.config.dataset
+  }).observable.pipe(switchMap((client) => client.observable.agent.action.translate(options)));
+}
+function agentPrompt(instance, options) {
+  return getClientState(instance, {
+    apiVersion: API_VERSION$6,
+    projectId: instance.config.projectId,
+    dataset: instance.config.dataset
+  }).observable.pipe(switchMap((client) => from(client.agent.action.prompt(options))));
+}
+function agentPatch(instance, options) {
+  return getClientState(instance, {
+    apiVersion: API_VERSION$6,
+    projectId: instance.config.projectId,
+    dataset: instance.config.dataset
+  }).observable.pipe(switchMap((client) => from(client.agent.action.patch(options))));
+}
+function compareProjectOrganization(projectId, projectOrganizationId, currentDashboardOrgId) {
+  return projectOrganizationId !== currentDashboardOrgId ? {
+    error: `Project ${projectId} belongs to Organization ${projectOrganizationId ?? "unknown"}, but the Dashboard has Organization ${currentDashboardOrgId} selected`
+  } : { error: null };
+}
 function createFetcherStore({
   name,
   fetcher: getObservable,
@@ -1059,11 +1159,12 @@ const API_VERSION$4 = "v2025-02-19", datasets = createFetcherStore({
     useProjectHostname: !0
   }).observable.pipe(switchMap((client) => client.observable.datasets.list()))
 }), getDatasetsState = datasets.getState, resolveDatasets = datasets.resolveState, isSanityMutatePatch = (value) => !(typeof value != "object" || !value || !("type" in value) || typeof value.type != "string" || value.type !== "patch" || !("id" in value) || typeof value.id != "string" || !("patches" in value) || !Array.isArray(value.patches));
-function createDocument(doc) {
+function createDocument(doc, initialValue) {
   return {
     type: "document.create",
     ...doc,
-    ...doc.documentId && { documentId: getPublishedId(doc.documentId) }
+    ...doc.documentId && { documentId: getPublishedId(doc.documentId) },
+    ...initialValue && { initialValue }
   };
 }
 function deleteDocument(doc) {
@@ -1772,7 +1873,17 @@ function processActions({
             transactionId,
             message: "A draft version of this document already exists. Please use or discard the existing draft before creating a new one."
           });
-        const newDocBase = { ...base[publishedId], _type: action.documentType, _id: draftId }, newDocWorking = { ...working[publishedId], _type: action.documentType, _id: draftId }, mutations = [{ create: newDocWorking }];
+        const newDocBase = {
+          ...base[publishedId],
+          _type: action.documentType,
+          _id: draftId,
+          ...action.initialValue
+        }, newDocWorking = {
+          ...working[publishedId],
+          _type: action.documentType,
+          _id: draftId,
+          ...action.initialValue
+        }, mutations = [{ create: newDocWorking }];
         if (base = processMutations({
           documents: base,
           transactionId,
@@ -3233,6 +3344,7 @@ const queryStore = {
           projectId,
           dataset,
           tag,
+          source,
           perspective: perspectiveFromOptions,
           ...restOptions
         } = parseQueryKey(group$.key), perspective$ = getPerspectiveState(instance, {
@@ -3240,7 +3352,8 @@ const queryStore = {
         }).observable.pipe(filter(Boolean)), client$ = getClientState(instance, {
           apiVersion: QUERY_STORE_API_VERSION,
           projectId,
-          dataset
+          dataset,
+          source
         }).observable;
         return combineLatest([lastLiveEventId$, client$, perspective$]).pipe(
           switchMap(
@@ -3303,7 +3416,7 @@ const queryStore = {
 function getQueryState(...args) {
   return _getQueryState(...args);
 }
-const _getQueryState = bindActionByDataset(
+const _getQueryState = bindActionBySource(
   queryStore,
   createStateSourceAction({
     selector: ({ state, instance }, options) => {
@@ -3326,7 +3439,7 @@ const _getQueryState = bindActionByDataset(
 function resolveQuery(...args) {
   return _resolveQuery(...args);
 }
-const _resolveQuery = bindActionByDataset(
+const _resolveQuery = bindActionBySource(
   queryStore,
   ({ state, instance }, { signal, ...options }) => {
     const normalized = normalizeOptionsWithPerspective(instance, options), { getCurrent } = getQueryState(instance, normalized), key = getQueryKey(normalized), aborted$ = signal ? new Observable((observer) => {
@@ -3883,12 +3996,18 @@ function getCorsErrorProjectId(error) {
   const projMatch = (error.message || "").match(/manage\/project\/([^/?#]+)/);
   return projMatch ? projMatch[1] : null;
 }
-var version = "2.3.0";
+var version = "2.4.0";
 const CORE_SDK_VERSION = getEnv("PKG_VERSION") || `${version}-development`;
 export {
   AuthStateType,
   CORE_SDK_VERSION,
+  agentGenerate,
+  agentPatch,
+  agentPrompt,
+  agentTransform,
+  agentTranslate,
   applyDocumentActions,
+  canvasSource,
   createDatasetHandle,
   createDocument,
   createDocumentHandle,
@@ -3896,6 +4015,7 @@ export {
   createGroqSearchFilter,
   createProjectHandle,
   createSanityInstance,
+  datasetSource,
   defineIntent,
   deleteDocument,
   destroyController,
@@ -3904,6 +4024,9 @@ export {
   getActiveReleasesState,
   getAuthState,
   getClient,
+  getClientErrorApiBody,
+  getClientErrorApiDescription,
+  getClientErrorApiType,
   getClientState,
   getCorsErrorProjectId,
   getCurrentUserState,
@@ -3934,10 +4057,12 @@ export {
   getUsersKey,
   getUsersState,
   handleAuthCallback,
+  isProjectUserNotFoundClientError,
   joinPaths,
   jsonMatch2 as jsonMatch,
   loadMoreUsers,
   logout,
+  mediaLibrarySource,
   observeOrganizationVerificationState,
   parseQueryKey,
   parseUsersKey,