@trackunit/react-core-contexts-test 1.12.65 → 1.14.0

package/index.cjs.js

@@ -25,6 +25,7 @@ exports.TrackunitProvidersMockBuilder = index.TrackunitProvidersMockBuilder;
 exports.doNothing = index.doNothing;
 exports.flushPromises = index.flushPromises;
 exports.flushPromisesInAct = index.flushPromisesInAct;
+exports.mergeDeepVars = index.mergeDeepVars;
 exports.mockAnalyticsContext = index.mockAnalyticsContext;
 exports.mockAssetSortingContext = index.mockAssetSortingContext;
 exports.mockCurrentUserContext = index.mockCurrentUserContext;

package/index.cjs2.js

@@ -13461,6 +13461,11 @@ const mockErrorHandlerContext = {
     setTag: sharedUtils.doNothing,
 };
 
+const mockGeolocationContext = {
+    position: null,
+    getPosition: () => Promise.resolve(null),
+};
+
 const mockModalDialogContext = {
     openModal: doNothing,
     closeModal: doNothing,
@@ -13774,6 +13779,7 @@ class TrackunitProvidersMockBuilder {
         this.selectedOemBrandingContext = mockOemBrandingContext;
         this.selectedUserSubscriptionContext = mockUserSubscriptionContext;
         this.selectedFilterBarValues = mockFilterBarContext;
+        this.selectedGeolocationContext = mockGeolocationContext;
         this.selectedExportDataContext = mockExportDataContextState;
     }
     /**
@@ -13951,6 +13957,16 @@ class TrackunitProvidersMockBuilder {
         this.selectedFilterBarValues = { ...this.selectedFilterBarValues, ...filterBarValues };
         return this;
     }
+    /**
+     * Use this to pass in a different geolocation context.
+     * Defaults to mockGeolocationContext.
+     *
+     * This context is used by the useGeolocation hook from lib "@trackunit/react-core-hooks"
+     */
+    geolocation(geolocationContext) {
+        this.selectedGeolocationContext = { ...mockGeolocationContext, ...geolocationContext };
+        return this;
+    }
     /**
      * Use this to pass in a differerent current user subscription.
      * Defaults to mockUserSubscriptionContext.
@@ -14279,7 +14295,7 @@ class TrackunitProvidersMockBuilder {
      * @param testChildren - the child element being tested.
      */
     getMockedCompositionRoot(testChildren) {
-        return (jsxRuntime.jsx(reactCoreContextsApi.ErrorHandlingContextProvider, { value: this.selectedErrorHandler, children: jsxRuntime.jsx(reactCoreContextsApi.CurrentUserProvider, { value: this.selectedCurrentUserContext, children: jsxRuntime.jsx(reactCoreContextsApi.AnalyticsContext.Provider, { value: this.selectedAnalyticsContext, children: jsxRuntime.jsx(reactCoreContextsApi.UserSubscriptionProvider, { value: this.selectedUserSubscriptionContext, children: jsxRuntime.jsx(reactCoreContextsApi.OemBrandingContextProvider, { value: this.selectedOemBrandingContext, children: jsxRuntime.jsx(reactCoreContextsApi.TokenProvider, { value: this.selectedTokenContext, children: jsxRuntime.jsx(reactCoreContextsApi.ToastProvider, { value: this.selectedToastContext, children: jsxRuntime.jsx(reactCoreContextsApi.ConfirmationDialogProvider, { value: this.selectedConfirmationDialogContext, children: jsxRuntime.jsx(reactCoreContextsApi.FilterBarProvider, { value: this.selectedFilterBarValues, children: jsxRuntime.jsx(reactCoreContextsApi.ExportDataContext.Provider, { value: this.selectedExportDataContext, children: jsxRuntime.jsx(reactCoreContextsApi.AssetSortingProvider, { value: this.selectedAssetSortingContext, children: jsxRuntime.jsx(ApolloMockedProviderWithError, { addTypename: false, mocks: this.selectedApolloMocks, children: jsxRuntime.jsx(reactCoreContextsApi.NavigationContextProvider, { value: this.selectedNavigationContext, children: jsxRuntime.jsx(reactCoreContextsApi.CurrentUserPreferenceProvider, { value: this.selectedCurrentUserPreferenceContext, children: jsxRuntime.jsx(reactCoreContextsApi.EnvironmentContextProvider, { value: this.selectedEnvironmentContext, children: jsxRuntime.jsx(reactCoreContextsApi.ModalDialogContextProvider, { value: this.selectedModalDialogContext, children: jsxRuntime.jsx(reactCoreContextsApi.TimeRangeProvider, { value: this.selectedTimeRangeContext, children: jsxRuntime.jsx(reactCoreContextsApi.WidgetConfigProvider, { value: this.selectedWidgetConfigContext, children: testChildren }) }) }) }) }) }) }) }) }) }) }) }) }) }) }) }) }) }));
+        return (jsxRuntime.jsx(reactCoreContextsApi.ErrorHandlingContextProvider, { value: this.selectedErrorHandler, children: jsxRuntime.jsx(reactCoreContextsApi.CurrentUserProvider, { value: this.selectedCurrentUserContext, children: jsxRuntime.jsx(reactCoreContextsApi.AnalyticsContext.Provider, { value: this.selectedAnalyticsContext, children: jsxRuntime.jsx(reactCoreContextsApi.UserSubscriptionProvider, { value: this.selectedUserSubscriptionContext, children: jsxRuntime.jsx(reactCoreContextsApi.OemBrandingContextProvider, { value: this.selectedOemBrandingContext, children: jsxRuntime.jsx(reactCoreContextsApi.TokenProvider, { value: this.selectedTokenContext, children: jsxRuntime.jsx(reactCoreContextsApi.ToastProvider, { value: this.selectedToastContext, children: jsxRuntime.jsx(reactCoreContextsApi.ConfirmationDialogProvider, { value: this.selectedConfirmationDialogContext, children: jsxRuntime.jsx(reactCoreContextsApi.FilterBarProvider, { value: this.selectedFilterBarValues, children: jsxRuntime.jsx(reactCoreContextsApi.ExportDataContext.Provider, { value: this.selectedExportDataContext, children: jsxRuntime.jsx(reactCoreContextsApi.AssetSortingProvider, { value: this.selectedAssetSortingContext, children: jsxRuntime.jsx(ApolloMockedProviderWithError, { addTypename: false, mocks: this.selectedApolloMocks, children: jsxRuntime.jsx(reactCoreContextsApi.NavigationContextProvider, { value: this.selectedNavigationContext, children: jsxRuntime.jsx(reactCoreContextsApi.CurrentUserPreferenceProvider, { value: this.selectedCurrentUserPreferenceContext, children: jsxRuntime.jsx(reactCoreContextsApi.EnvironmentContextProvider, { value: this.selectedEnvironmentContext, children: jsxRuntime.jsx(reactCoreContextsApi.ModalDialogContextProvider, { value: this.selectedModalDialogContext, children: jsxRuntime.jsx(reactCoreContextsApi.TimeRangeProvider, { value: this.selectedTimeRangeContext, children: jsxRuntime.jsx(reactCoreContextsApi.WidgetConfigProvider, { value: this.selectedWidgetConfigContext, children: jsxRuntime.jsx(reactCoreContextsApi.GeolocationProvider, { value: this.selectedGeolocationContext, children: testChildren }) }) }) }) }) }) }) }) }) }) }) }) }) }) }) }) }) }) }));
     }
     getMockedCompositionRootWithRouter(testChildren) {
         const childrenWithRouter = (jsxRuntime.jsx(RouterContainer, { addTestRootContainer: true, rootRoute: this.selectedRootRoute, selectedRouterProps: this.selectedRouterProps, children: testChildren }));
@@ -14427,6 +14443,35 @@ const safeStringify = (obj) => {
     });
 };
 
+/**
+ * Deep merge for GraphQL mock variables that preserves `undefined` values.
+ *
+ * Unlike Apollo's `mergeDeep` which drops `undefined`, this retains all keys
+ * from the defaults and only overrides keys explicitly present in the source.
+ * This is critical for Apollo MockedProvider's exact variable matching.
+ */
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+const mergeDeepVars = (defaults, overrides) => {
+    if (!overrides)
+        return { ...defaults };
+    const src = overrides;
+    const result = { ...defaults };
+    for (const key of Object.keys(src)) {
+        const overrideVal = src[key];
+        const defaultVal = result[key];
+        const bothObjects = typeof overrideVal === "object" &&
+            overrideVal !== null &&
+            !Array.isArray(overrideVal) &&
+            typeof defaultVal === "object" &&
+            defaultVal !== null &&
+            !Array.isArray(defaultVal);
+        result[key] = bothObjects
+            ? mergeDeepVars(defaultVal, overrideVal)
+            : overrideVal;
+    }
+    return result;
+};
+
 /**
  *
  * @param document Document that represents the specific GQL query / mutation schema.
@@ -14571,6 +14616,7 @@ exports.act = act;
 exports.doNothing = doNothing;
 exports.flushPromises = flushPromises;
 exports.flushPromisesInAct = flushPromisesInAct;
+exports.mergeDeepVars = mergeDeepVars;
 exports.mockAnalyticsContext = mockAnalyticsContext;
 exports.mockAssetSortingContext = mockAssetSortingContext;
 exports.mockCurrentUserContext = mockCurrentUserContext;

package/index.esm.js

@@ -1,4 +1,4 @@
-export { D as Debugger, T as TrackunitProvidersMockBuilder, l as doNothing, f as flushPromises, b as flushPromisesInAct, m as mockAnalyticsContext, c as mockAssetSortingContext, d as mockCurrentUserContext, e as mockEnvironmentContext, g as mockFilterBarContext, h as mockNavigationContext, i as mockOemBrandingContext, j as mockToastContext, k as mockUserSubscriptionContext, q as queryFor, n as queryForHook, t as trackunitProviders, u as useDebugger, v as validateIrisApp } from './index.esm2.js';
+export { D as Debugger, T as TrackunitProvidersMockBuilder, n as doNothing, f as flushPromises, b as flushPromisesInAct, l as mergeDeepVars, m as mockAnalyticsContext, c as mockAssetSortingContext, d as mockCurrentUserContext, e as mockEnvironmentContext, g as mockFilterBarContext, h as mockNavigationContext, i as mockOemBrandingContext, j as mockToastContext, k as mockUserSubscriptionContext, q as queryFor, o as queryForHook, t as trackunitProviders, u as useDebugger, v as validateIrisApp } from './index.esm2.js';
 import '@trackunit/iris-app-runtime-core-api';
 import 'react/jsx-runtime';
 import 'react';

package/index.esm2.js

@@ -5,7 +5,7 @@ import React__default, { createContext, useContext, Children, createElement, isV
 import * as DeprecatedReactTestUtils from 'react-dom/test-utils';
 import ReactDOM from 'react-dom';
 import * as ReactDOMClient from 'react-dom/client';
-import { ErrorHandlingContextProvider, CurrentUserProvider, AnalyticsContext, UserSubscriptionProvider, OemBrandingContextProvider, TokenProvider, ToastProvider, ConfirmationDialogProvider, FilterBarProvider, ExportDataContext, AssetSortingProvider, NavigationContextProvider, CurrentUserPreferenceProvider, EnvironmentContextProvider, ModalDialogContextProvider, TimeRangeProvider, WidgetConfigProvider } from '@trackunit/react-core-contexts-api';
+import { ErrorHandlingContextProvider, CurrentUserProvider, AnalyticsContext, UserSubscriptionProvider, OemBrandingContextProvider, TokenProvider, ToastProvider, ConfirmationDialogProvider, FilterBarProvider, ExportDataContext, AssetSortingProvider, NavigationContextProvider, CurrentUserPreferenceProvider, EnvironmentContextProvider, ModalDialogContextProvider, TimeRangeProvider, WidgetConfigProvider, GeolocationProvider } from '@trackunit/react-core-contexts-api';
 import { omit } from 'es-toolkit';
 import { ApolloLink } from '@apollo/client';
 import { loadDevMessages, loadErrorMessages } from '@apollo/client/dev';
@@ -13439,6 +13439,11 @@ const mockErrorHandlerContext = {
     setTag: doNothing$1,
 };
 
+const mockGeolocationContext = {
+    position: null,
+    getPosition: () => Promise.resolve(null),
+};
+
 const mockModalDialogContext = {
     openModal: doNothing,
     closeModal: doNothing,
@@ -13752,6 +13757,7 @@ class TrackunitProvidersMockBuilder {
         this.selectedOemBrandingContext = mockOemBrandingContext;
         this.selectedUserSubscriptionContext = mockUserSubscriptionContext;
         this.selectedFilterBarValues = mockFilterBarContext;
+        this.selectedGeolocationContext = mockGeolocationContext;
         this.selectedExportDataContext = mockExportDataContextState;
     }
     /**
@@ -13929,6 +13935,16 @@ class TrackunitProvidersMockBuilder {
         this.selectedFilterBarValues = { ...this.selectedFilterBarValues, ...filterBarValues };
         return this;
     }
+    /**
+     * Use this to pass in a different geolocation context.
+     * Defaults to mockGeolocationContext.
+     *
+     * This context is used by the useGeolocation hook from lib "@trackunit/react-core-hooks"
+     */
+    geolocation(geolocationContext) {
+        this.selectedGeolocationContext = { ...mockGeolocationContext, ...geolocationContext };
+        return this;
+    }
     /**
      * Use this to pass in a differerent current user subscription.
      * Defaults to mockUserSubscriptionContext.
@@ -14257,7 +14273,7 @@ class TrackunitProvidersMockBuilder {
      * @param testChildren - the child element being tested.
      */
     getMockedCompositionRoot(testChildren) {
-        return (jsx(ErrorHandlingContextProvider, { value: this.selectedErrorHandler, children: jsx(CurrentUserProvider, { value: this.selectedCurrentUserContext, children: jsx(AnalyticsContext.Provider, { value: this.selectedAnalyticsContext, children: jsx(UserSubscriptionProvider, { value: this.selectedUserSubscriptionContext, children: jsx(OemBrandingContextProvider, { value: this.selectedOemBrandingContext, children: jsx(TokenProvider, { value: this.selectedTokenContext, children: jsx(ToastProvider, { value: this.selectedToastContext, children: jsx(ConfirmationDialogProvider, { value: this.selectedConfirmationDialogContext, children: jsx(FilterBarProvider, { value: this.selectedFilterBarValues, children: jsx(ExportDataContext.Provider, { value: this.selectedExportDataContext, children: jsx(AssetSortingProvider, { value: this.selectedAssetSortingContext, children: jsx(ApolloMockedProviderWithError, { addTypename: false, mocks: this.selectedApolloMocks, children: jsx(NavigationContextProvider, { value: this.selectedNavigationContext, children: jsx(CurrentUserPreferenceProvider, { value: this.selectedCurrentUserPreferenceContext, children: jsx(EnvironmentContextProvider, { value: this.selectedEnvironmentContext, children: jsx(ModalDialogContextProvider, { value: this.selectedModalDialogContext, children: jsx(TimeRangeProvider, { value: this.selectedTimeRangeContext, children: jsx(WidgetConfigProvider, { value: this.selectedWidgetConfigContext, children: testChildren }) }) }) }) }) }) }) }) }) }) }) }) }) }) }) }) }) }));
+        return (jsx(ErrorHandlingContextProvider, { value: this.selectedErrorHandler, children: jsx(CurrentUserProvider, { value: this.selectedCurrentUserContext, children: jsx(AnalyticsContext.Provider, { value: this.selectedAnalyticsContext, children: jsx(UserSubscriptionProvider, { value: this.selectedUserSubscriptionContext, children: jsx(OemBrandingContextProvider, { value: this.selectedOemBrandingContext, children: jsx(TokenProvider, { value: this.selectedTokenContext, children: jsx(ToastProvider, { value: this.selectedToastContext, children: jsx(ConfirmationDialogProvider, { value: this.selectedConfirmationDialogContext, children: jsx(FilterBarProvider, { value: this.selectedFilterBarValues, children: jsx(ExportDataContext.Provider, { value: this.selectedExportDataContext, children: jsx(AssetSortingProvider, { value: this.selectedAssetSortingContext, children: jsx(ApolloMockedProviderWithError, { addTypename: false, mocks: this.selectedApolloMocks, children: jsx(NavigationContextProvider, { value: this.selectedNavigationContext, children: jsx(CurrentUserPreferenceProvider, { value: this.selectedCurrentUserPreferenceContext, children: jsx(EnvironmentContextProvider, { value: this.selectedEnvironmentContext, children: jsx(ModalDialogContextProvider, { value: this.selectedModalDialogContext, children: jsx(TimeRangeProvider, { value: this.selectedTimeRangeContext, children: jsx(WidgetConfigProvider, { value: this.selectedWidgetConfigContext, children: jsx(GeolocationProvider, { value: this.selectedGeolocationContext, children: testChildren }) }) }) }) }) }) }) }) }) }) }) }) }) }) }) }) }) }) }));
     }
     getMockedCompositionRootWithRouter(testChildren) {
         const childrenWithRouter = (jsx(RouterContainer, { addTestRootContainer: true, rootRoute: this.selectedRootRoute, selectedRouterProps: this.selectedRouterProps, children: testChildren }));
@@ -14405,6 +14421,35 @@ const safeStringify = (obj) => {
     });
 };
 
+/**
+ * Deep merge for GraphQL mock variables that preserves `undefined` values.
+ *
+ * Unlike Apollo's `mergeDeep` which drops `undefined`, this retains all keys
+ * from the defaults and only overrides keys explicitly present in the source.
+ * This is critical for Apollo MockedProvider's exact variable matching.
+ */
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+const mergeDeepVars = (defaults, overrides) => {
+    if (!overrides)
+        return { ...defaults };
+    const src = overrides;
+    const result = { ...defaults };
+    for (const key of Object.keys(src)) {
+        const overrideVal = src[key];
+        const defaultVal = result[key];
+        const bothObjects = typeof overrideVal === "object" &&
+            overrideVal !== null &&
+            !Array.isArray(overrideVal) &&
+            typeof defaultVal === "object" &&
+            defaultVal !== null &&
+            !Array.isArray(defaultVal);
+        result[key] = bothObjects
+            ? mergeDeepVars(defaultVal, overrideVal)
+            : overrideVal;
+    }
+    return result;
+};
+
 /**
  *
  * @param document Document that represents the specific GQL query / mutation schema.
@@ -14543,4 +14588,4 @@ const validateIrisApp = async (irisApp) => {
     return null;
 };
 
-export { Debugger as D, TrackunitProvidersMockBuilder as T, act as a, flushPromisesInAct as b, mockAssetSortingContext as c, mockCurrentUserContext as d, mockEnvironmentContext as e, flushPromises as f, mockFilterBarContext as g, mockNavigationContext as h, mockOemBrandingContext as i, mockToastContext as j, mockUserSubscriptionContext as k, doNothing as l, mockAnalyticsContext as m, queryForHook as n, queryFor as q, renderHook as r, trackunitProviders as t, useDebugger as u, validateIrisApp as v };
+export { Debugger as D, TrackunitProvidersMockBuilder as T, act as a, flushPromisesInAct as b, mockAssetSortingContext as c, mockCurrentUserContext as d, mockEnvironmentContext as e, flushPromises as f, mockFilterBarContext as g, mockNavigationContext as h, mockOemBrandingContext as i, mockToastContext as j, mockUserSubscriptionContext as k, mergeDeepVars as l, mockAnalyticsContext as m, doNothing as n, queryForHook as o, queryFor as q, renderHook as r, trackunitProviders as t, useDebugger as u, validateIrisApp as v };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@trackunit/react-core-contexts-test",
-  "version": "1.12.65",
+  "version": "1.14.0",
   "repository": "https://github.com/Trackunit/manager",
   "license": "SEE LICENSE IN LICENSE.txt",
   "engines": {
@@ -13,8 +13,8 @@
     "@trackunit/shared-utils": "1.13.75",
     "graphql": "^16.10.0",
     "@tanstack/router-core": "1.114.29",
-    "@trackunit/iris-app-runtime-core-api": "1.12.58",
-    "@trackunit/react-core-contexts-api": "1.13.59",
+    "@trackunit/iris-app-runtime-core-api": "1.13.0",
+    "@trackunit/react-core-contexts-api": "1.14.0",
     "es-toolkit": "^1.39.10"
   },
   "module": "./index.esm.js",

package/src/TrackunitProvidersMockBuilder.d.ts

@@ -2,7 +2,7 @@ import { MockedResponse } from "@apollo/client/testing";
 import { AnyRoute, RegisteredRouter } from "@tanstack/react-router";
 import { RenderResult } from "@testing-library/react";
 import { AnalyticsRuntimeApiSync, AssetSortingState, ConfirmationDialogRuntimeApi, CurrentUserPreferenceState, CurrentUserState, EnvironmentState, ErrorHandlingContextValue, FilterBarContext, ModalDialogRuntimeApi, NavigationRuntimeApi, OemBrandingRuntimeApi, TimeRangeContext, TokenContext, UserSubscription, WidgetConfigContext } from "@trackunit/iris-app-runtime-core-api";
-import { ExportDataContextState, ToastContextValue } from "@trackunit/react-core-contexts-api";
+import { ExportDataContextState, GeolocationContextValue, ToastContextValue } from "@trackunit/react-core-contexts-api";
 import { ReactElement, ReactNode } from "react";
 import { MemoryRouterProps } from "./utils/routingUtils";
 /**
@@ -34,6 +34,7 @@ export declare class TrackunitProvidersMockBuilder<TRouterTree extends AnyRoute>
     protected selectedOemBrandingContext: OemBrandingRuntimeApi;
     protected selectedUserSubscriptionContext: UserSubscription;
     protected selectedFilterBarValues: FilterBarContext;
+    protected selectedGeolocationContext: GeolocationContextValue;
     protected selectedExportDataContext: ExportDataContextState;
     /**
      * Use this Analytics Context.
@@ -182,6 +183,13 @@ export declare class TrackunitProvidersMockBuilder<TRouterTree extends AnyRoute>
      * @returns { TrackunitProvidersMockBuilder } - The builder.
      */
     filterBarValues(filterBarValues: Partial<FilterBarContext>): this;
+    /**
+     * Use this to pass in a different geolocation context.
+     * Defaults to mockGeolocationContext.
+     *
+     * This context is used by the useGeolocation hook from lib "@trackunit/react-core-hooks"
+     */
+    geolocation(geolocationContext: Partial<GeolocationContextValue>): this;
     /**
      * Use this to pass in a differerent current user subscription.
      * Defaults to mockUserSubscriptionContext.

package/src/index.d.ts

@@ -9,6 +9,7 @@ export * from "./mocks/mockToastContext";
 export * from "./mocks/mockUserSubscriptionContext";
 export * from "./TrackunitProvidersMockBuilder";
 export * from "./useDebugger";
+export * from "./utils/mergeDeepVars";
 export * from "./utils/doNothing";
 export * from "./utils/queryFor";
 export * from "./utils/validateIrisApp";

package/src/mocks/mockGeolocationContext.d.ts

@@ -0,0 +1,2 @@
+import type { GeolocationContextValue } from "@trackunit/react-core-contexts-api";
+export declare const mockGeolocationContext: GeolocationContextValue;

package/src/utils/mergeDeepVars.d.ts

@@ -0,0 +1,9 @@
+import { DeepPartialNullable } from "./queryFor";
+/**
+ * Deep merge for GraphQL mock variables that preserves `undefined` values.
+ *
+ * Unlike Apollo's `mergeDeep` which drops `undefined`, this retains all keys
+ * from the defaults and only overrides keys explicitly present in the source.
+ * This is critical for Apollo MockedProvider's exact variable matching.
+ */
+export declare const mergeDeepVars: <TDefaults extends Record<string, any>>(defaults: TDefaults, overrides?: DeepPartialNullable<NoInfer<TDefaults>> | Partial<NoInfer<TDefaults>>) => TDefaults;

package/src/utils/queryFor.d.ts

@@ -4,6 +4,14 @@ export type DeepPartialNullable<TValue> = TValue extends Array<any> ? DeepPartia
     [KeyProperty in keyof TValue]?: DeepPartialNullable<TValue[KeyProperty]> | null;
 } : TValue | null;
 type DeepPartialNullableArray<TValue> = Array<DeepPartialNullable<TValue>>;
+/**
+ * Like Pick<T, K>, but each picked value is DeepPartialNullable.
+ * The keys themselves stay required so callers must supply them,
+ * while nested fields become optional (filled by generated defaults).
+ */
+export type PickDeepPartialNullable<TValue, TKeys extends keyof TValue> = {
+    [Key in TKeys]: DeepPartialNullable<TValue[Key]>;
+};
 /**
  *
  * @param document Document that represents the specific GQL query / mutation schema.