@warp-drive-mirror/core 5.9.0-alpha.17 → 5.9.0-alpha.18

package/declarations/graph/-private/-state.d.ts

@@ -1,5 +1,6 @@
 export interface RelationshipState {
 	hasReceivedData: boolean;
+	hasReceivedRemoteData: boolean;
 	isEmpty: boolean;
 	isStale: boolean;
 	hasFailedLoadAttempt: boolean;

package/declarations/reactive/-private/default-mode.d.ts

@@ -1,8 +1,6 @@
-import type { SignalStore } from "../../signals/-private.js";
 import type { Store } from "../../store/-private.js";
 import type { ResourceKey } from "../../types.js";
 import type { FieldSchema, HashField, IdentityField, SchemaArrayField, SchemaObjectField } from "../../types/schema/fields.js";
-import type { ReactiveResource } from "./record.js";
 export type PathLike = string | symbol | Array<string | symbol>;
 export type ModeName = "polaris" | "legacy";
 export interface ModeInfo {
@@ -11,10 +9,32 @@ export interface ModeInfo {
 	editable: boolean;
 }
 export interface BaseContext {
+	/**
+	* The {@link Store} instance that owns
+	* the reactive context we are within.
+	*/
 	store: Store;
+	/**
+	* The {@link ResourceKey} of the resource that
+	* the reactive context we are within is for.
+	*/
 	resourceKey: ResourceKey;
+	/**
+	* The name of the {@link ModeName | mode} that the
+	* reactive context we are within is operating in.
+	*/
 	modeName: ModeName;
+	/**
+	* Whether we are in legacy {@link ModeName | mode}
+	* or not.
+	*/
 	legacy: boolean;
+	/**
+	* Whether the ReactiveResource instance we are operating
+	* in is currently editable or not. This should be true if the
+	* record is currently checked out for editing or is in legacy mode
+	* and false if the record is currently in a read-only state.
+	*/
 	editable: boolean;
 }
 export interface ResourceContext extends BaseContext {
@@ -27,13 +47,6 @@ export interface ObjectContext extends BaseContext {
 	field: SchemaObjectField | SchemaArrayField;
 	value: string;
 }
-export interface KindContext<T extends FieldSchema | IdentityField | HashField> extends BaseContext {
-	path: string[];
-	field: T;
-	value: unknown;
-	record: ReactiveResource;
-	signals: SignalStore;
-}
 export interface KindImpl<T extends FieldSchema | IdentityField | HashField> {
 	/**
 	* A function which produces the value for the field when invoked.

package/declarations/reactive/-private/kind/belongs-to-field.d.ts

@@ -1,4 +1,7 @@
+import type { ResourceKey } from "../../../types.js";
 import type { LegacyBelongsToField } from "../../../types/schema/fields.js";
 import type { KindContext } from "../default-mode.js";
+import type { ReactiveResource } from "../record.js";
 export declare function getBelongsToField(context: KindContext<LegacyBelongsToField>): unknown;
 export declare function setBelongsToField(context: KindContext<LegacyBelongsToField>): boolean;
+export declare function getResourceKey(record: ReactiveResource | null): ResourceKey | null;

package/declarations/types/runtime.d.ts

@@ -1,6 +1,7 @@
 import type { LOG_CONFIG } from "@warp-drive-mirror/build-config/-private/utils/logging";
 declare const RuntimeConfig: {
 	debug: Partial<LOG_CONFIG>;
+	mirage?: boolean;
 };
 export declare function getRuntimeConfig(): typeof RuntimeConfig;
 /**
@@ -11,4 +12,19 @@ export declare function getRuntimeConfig(): typeof RuntimeConfig;
 *
 */
 export declare function setLogging(config: Partial<LOG_CONFIG>): void;
+/**
+* Explicitly declares whether requests may be served by Mirage (or another
+* Pretender-based fetch mock) instead of a native `fetch` implementation.
+*
+* The `Fetch` request handler otherwise infers this via a heuristic (the
+* presence of `window.server.pretender`, or `window.fetch` appearing to be
+* patched), which can be wrong in either direction: some Mirage setups don't
+* expose `window.server`, while some unrelated tools (APM agents, browser
+* extensions) also patch `fetch`. Call this to override that heuristic:
+* `true` to force Mirage-compatible behavior on, `false` to force it off.
+*
+* globalThis.setWarpDriveIsMaybeMirage(true);
+*
+*/
+export declare function setIsMaybeMirage(value: boolean): void;
 export {};

package/declarations/types/schema/fields.d.ts

@@ -1315,9 +1315,16 @@ export interface LegacyBelongsToField {
 		* adapters and serializers.
 		*
 		* When true, none of the legacy support will be utilized. Sync relationships
-		* will be expected to already have all their data. When reloading a sync relationship
-		* you would be expected to have a `related link` available from a prior relationship
-		* payload e.g.
+		* (`async: false`, currently the only supported combination) must satisfy
+		* one of the following whenever pushed to the cache:
+		*
+		* - a `links.related` link is present, **or**
+		* - the relationship is fully linked: `data` is `null`, or `data` points
+		*   to a resource present in the document's `included` array
+		*
+		* A related link lets you omit the related resource from `included`; a
+		* `data` key that is missing entirely, or explicitly `undefined`, is never
+		* valid unless a `links.related` link is present.
 		*
 		* ```ts
 		* {
@@ -1468,9 +1475,16 @@ export interface LinksModeBelongsToField {
 		* MUST be true for PolarisMode + LinksMode
 		*
 		* When true, none of the legacy support will be utilized. Sync relationships
-		* will be expected to already have all their data. When reloading a sync relationship
-		* you would be expected to have a `related link` available from a prior relationship
-		* payload e.g.
+		* (`async: false`, currently the only supported combination) must satisfy
+		* one of the following whenever pushed to the cache:
+		*
+		* - a `links.related` link is present, **or**
+		* - the relationship is fully linked: `data` is `null`, or `data` points
+		*   to a resource present in the document's `included` array
+		*
+		* A related link lets you omit the related resource from `included`; a
+		* `data` key that is missing entirely, or explicitly `undefined`, is never
+		* valid unless a `links.related` link is present.
 		*
 		* ```ts
 		* {
@@ -1640,9 +1654,16 @@ export interface LegacyHasManyField {
 		* from @warp-drive-mirror/legacy/model and the LegacyNetworkMiddleware for adapters and serializers.
 		*
 		* When true, none of the legacy support will be utilized. Sync relationships
-		* will be expected to already have all their data. When reloading a sync relationship
-		* you would be expected to have a `related link` available from a prior relationship
-		* payload e.g.
+		* (`async: false`, currently the only supported combination) must satisfy
+		* one of the following whenever pushed to the cache:
+		*
+		* - a `links.related` link is present, **or**
+		* - the relationship is fully linked: `data` is `[]`, or every resource
+		*   identifier in `data` is present in the document's `included` array
+		*
+		* A related link lets you omit the related resources from `included`; a
+		* `data` key that is missing entirely, or explicitly `undefined`, is never
+		* valid unless a `links.related` link is present.
 		*
 		* ```ts
 		* {
@@ -1818,9 +1839,16 @@ export interface LinksModeHasManyField {
 		* MUST be true for PolarisMode + LinksMode
 		*
 		* When true, none of the legacy support will be utilized. Sync relationships
-		* will be expected to already have all their data. When reloading a sync relationship
-		* you would be expected to have a `related link` available from a prior relationship
-		* payload e.g.
+		* (`async: false`, currently the only supported combination) must satisfy
+		* one of the following whenever pushed to the cache:
+		*
+		* - a `links.related` link is present, **or**
+		* - the relationship is fully linked: `data` is `[]`, or every resource
+		*   identifier in `data` is present in the document's `included` array
+		*
+		* A related link lets you omit the related resources from `included`; a
+		* `data` key that is missing entirely, or explicitly `undefined`, is never
+		* valid unless a `links.related` link is present.
 		*
 		* ```ts
 		* {

package/dist/graph/-private.js

@@ -67,9 +67,14 @@ function assertValidRelationshipPayload(graph, op) {
     kind
   } = definition;
   if (payload.links) {
-    warn(`You pushed a record of type '${type}' with a relationship '${field}' configured as 'async: false'. You've included a link but no primary data, this may be an error in your payload. WarpDrive will treat this relationship as known-to-be-empty.`, isAsync || payload.data === null || !!payload.data || state.hasReceivedData, {
-      id: 'ds.store.push-link-for-sync-relationship'
-    });
+    // once JSON_API_CACHE_VALIDATION_ERRORS is active, this warning is instead
+    // the responsibility of the new document validator (see validateResourceRelationships
+    // in warp-drive-packages/json-api/src/-private/validator/1.1/7.2_resource-objects.ts)
+    if (macroCondition(!getGlobalConfig().WarpDriveMirror.features.JSON_API_CACHE_VALIDATION_ERRORS)) {
+      warn(`You pushed a record of type '${type}' with a relationship '${field}' configured as 'async: false'. You've included a link but no primary data, this may be an error in your payload. WarpDrive will treat this relationship as known-to-be-empty.`, isAsync || payload.data === null || !!payload.data || state.hasReceivedData, {
+        id: 'ds.store.push-link-for-sync-relationship'
+      });
+    }
   } else if (payload.data) {
     if (kind === 'belongsTo') {
       macroCondition(getGlobalConfig().WarpDriveMirror.env.DEBUG) ? (test => {
@@ -1414,8 +1419,10 @@ function replaceRelatedRecord(graph, op, isRemote = false) {
   if (op.value === existingState) {
     // if we were empty before but now know we are empty this needs to be true
     state.hasReceivedData = true;
+
     // if this is a remote update we still sync
     if (isRemote) {
+      state.hasReceivedRemoteData = true;
       const {
         localState
       } = relationship;
@@ -1455,6 +1462,15 @@ function replaceRelatedRecord(graph, op, isRemote = false) {
   // update value to the new value
   relationship[prop] = op.value;
   state.hasReceivedData = true;
+  /**
+   * Local mutations never give us additional information about
+   * whether the relationship has received *remote* data. This is
+   * what `getRemoteRelationship` relies on to avoid reflecting
+   * local-only edits.
+   */
+  if (isRemote) {
+    state.hasReceivedRemoteData = true;
+  }
   state.isEmpty = op.value === null;
   state.isStale = false;
   state.hasFailedLoadAttempt = false;
@@ -2133,8 +2149,30 @@ function rollbackRelationship(graph, key, field, relationship) {
   }
 }
 function createState() {
+  if (macroCondition(getGlobalConfig().WarpDriveMirror.env.DEBUG)) {
+    if (macroCondition(getGlobalConfig().WarpDriveMirror.activeLogging.LOG_GRAPH)) {
+      if (getGlobalConfig().WarpDriveMirror.debug.LOG_GRAPH || globalThis.getWarpDriveRuntimeConfig().debug.LOG_GRAPH) {
+        let hasReceivedData = false;
+        return {
+          get hasReceivedData() {
+            return hasReceivedData;
+          },
+          set hasReceivedData(value) {
+            hasReceivedData = value;
+          },
+          hasReceivedRemoteData: false,
+          isEmpty: true,
+          isStale: false,
+          hasFailedLoadAttempt: false,
+          shouldForceReload: false,
+          hasDematerializedInverse: false
+        };
+      }
+    }
+  }
   return {
     hasReceivedData: false,
+    hasReceivedRemoteData: false,
     isEmpty: true,
     isStale: false,
     hasFailedLoadAttempt: false,
@@ -2239,13 +2277,10 @@ function legacyGetResourceRelationshipData(source, getRemoteState) {
   source.accessed = true;
   let data;
   const payload = {};
-  if (getRemoteState && source.remoteState) {
-    data = source.remoteState;
-  } else if (!getRemoteState && source.localState) {
-    data = source.localState;
-  }
-  if ((getRemoteState && source.remoteState === null || source.localState === null) && source.state.hasReceivedData) {
-    data = null;
+  if (getRemoteState && (source.remoteState || source.state.hasReceivedRemoteData)) {
+    data = source.remoteState ?? null;
+  } else if (!getRemoteState && (source.localState || source.state.hasReceivedData)) {
+    data = source.localState ?? null;
   }
   if (source.links) {
     payload.links = source.links;
@@ -2459,7 +2494,6 @@ function updateRelationshipOperation(graph, op) {
   })(isHasMany(relationship) || isBelongsTo(relationship)) : {};
   const {
     definition,
-    state,
     identifier
   } = relationship;
   const {
@@ -2499,23 +2533,6 @@ function updateRelationshipOperation(graph, op) {
         value: payload.data ? graph.store.cacheKeyManager.upgradeIdentifier(payload.data) : null
       }, true);
     }
-  } else if (definition.isAsync === false && !state.hasReceivedData) {
-    hasRelationshipDataProperty = true;
-    if (isCollection) {
-      graph.update({
-        op: 'replaceRelatedRecords',
-        record: identifier,
-        field: op.field,
-        value: []
-      }, true);
-    } else {
-      graph.update({
-        op: 'replaceRelatedRecord',
-        record: identifier,
-        field: op.field,
-        value: null
-      }, true);
-    }
   }
   if (payload.links) {
     const originalLinks = relationship.links;
@@ -2525,9 +2542,10 @@ function updateRelationshipOperation(graph, op) {
       const currentLink = originalLinks && originalLinks.related ? _normalizeLink(originalLinks.related) : null;
       const currentLinkHref = currentLink ? currentLink.href : null;
       if (relatedLink && relatedLink.href && relatedLink.href !== currentLinkHref) {
-        warn(`You pushed a record of type '${identifier.type}' with a relationship '${definition.key}' configured as 'async: false'. You've included a link but no primary data, this may be an error in your payload. WarpDrive will treat this relationship as known-to-be-empty.`, definition.isAsync || state.hasReceivedData, {
-          id: 'ds.store.push-link-for-sync-relationship'
-        });
+        // Note: the equivalent warning for this case is issued eagerly (and with a more
+        // complete condition, since it also accounts for `payload.data` being present) by
+        // `assertValidRelationshipPayload` in `-utils.ts`, which always runs immediately
+        // before this operation in DEBUG builds. Warning here too would double-warn.
         macroCondition(getGlobalConfig().WarpDriveMirror.env.DEBUG) ? (test => {
           if (!test) {
             throw new Error(`You have pushed a record of type '${identifier.type}' with '${definition.key}' as a link, but the value of that link is not a string.`);
@@ -2558,6 +2576,7 @@ function updateRelationshipOperation(graph, op) {
     // we don't need to notify here as the update op we pushed in above will notify once
     // membership is in the correct state.
     relationship.state.hasReceivedData = true;
+    relationship.state.hasReceivedRemoteData = true;
     relationship.state.isStale = false;
     relationship.state.hasDematerializedInverse = false;
     relationship.state.isEmpty = relationshipIsEmpty;

package/dist/{index-CFwnjldF.js → index-BoY6aNE5.js}

@@ -4,13 +4,13 @@ import { EnableHydration, SkipCache, STRUCTURED } from './types/request.js';
 import { macroCondition, getGlobalConfig, dependencySatisfies, importSync } from '@embroider/macros';
 import { D as Destroy, a as Context, S as SOURCE, C as Checkout, b as Commit } from "./symbols-3C1OkYtZ.js";
 import { isResourceSchema } from './types/schema/fields.js';
+import { setLogging, getRuntimeConfig, setIsMaybeMirage } from './types/runtime.js';
 import { a as cloneResponseProperties, I as IS_CACHE_HANDLER, b as assertValidRequest, e as executeNextHandler, d as getRequestResult, u as upgradePromise, s as setPromiseResult, f as clearRequestResult } from "./future-CPfkKOvf.js";
 import { getOrSetGlobal, peekTransient, setTransient, peekUniversalTransient, setUniversalTransient } from './types/-private.js';
 import { D as DefaultCachePolicy } from "./default-cache-policy-D7_u4YRH.js";
 import { withBrand } from './request.js';
 import { CACHE_OWNER, DEBUG_STALE_CACHE_OWNER, DEBUG_KEY_TYPE, DEBUG_CLIENT_ORIGINATED } from './types/identifier.js';
 import { dasherize } from './utils/string.js';
-import { setLogging, getRuntimeConfig } from './types/runtime.js';
 import { RecordStore, Type } from './types/symbols.js';
 function urlFromLink(link) {
   if (typeof link === 'string') return link;
@@ -7281,11 +7281,32 @@ function getBelongsToField(context) {
 }
 function setBelongsToField(context) {
   const {
+    field,
+    resourceKey,
     store
   } = context;
   const {
-    schema
+    schema,
+    cache
   } = store;
+
+  /**
+   * We currently only allow editing sync belongsTo relationships
+   * in PolarisMode
+   */
+  const isValidPolarisConfig = field.options.linksMode && !field.options.async;
+  if (!context.legacy && isValidPolarisConfig) {
+    const name = context.path.at(-1);
+    cache.mutate({
+      op: 'replaceRelatedRecord',
+      record: resourceKey,
+      field: name,
+      value: getResourceKey(context.value)
+    },
+    // @ts-expect-error
+    true);
+    return true;
+  }
   macroCondition(getGlobalConfig().WarpDriveMirror.env.DEBUG) ? (test => {
     if (!test) {
       throw new Error(`Can only mutate belongsTo fields when the resource is in legacy mode`);
@@ -7294,6 +7315,12 @@ function setBelongsToField(context) {
   schema._kind('@legacy', 'belongsTo').set(store, context.record, context.resourceKey, context.field, context.value);
   return true;
 }
+function getResourceKey(record) {
+  if (!record) {
+    return null;
+  }
+  return recordIdentifierFor(record);
+}
 function getCollectionField(context) {
   entangleSignal(context.signals, context.record, context.path.at(-1), null);
   macroCondition(getGlobalConfig().WarpDriveMirror.env.DEBUG) ? (test => {
@@ -8029,6 +8056,17 @@ function setSchemaObjectField(context) {
   // }
   return true;
 }
+
+/**
+ * A ReactiveResource context object passed to
+ * the get/set functions of a field kind implementation.
+ *
+ * This provides all the necessary information for
+ * the field kind to perform its operations.
+ *
+ * @internal
+ */
+
 const DefaultMode = {
   '@hash': {
     get: getHashField,
@@ -8822,6 +8860,14 @@ const TypeField = {
     key: 'type'
   }
 };
+const IdentifierField = {
+  type: '@identity',
+  name: '$key',
+  kind: 'derived',
+  options: {
+    key: '^'
+  }
+};
 const DefaultIdentityField = {
   name: 'id',
   kind: '@id'
@@ -9010,6 +9056,7 @@ function withDefaults(schema) {
   // we add TypeField to the beginning so that it will
   // appear right next to the identity field
   schema.fields.unshift(TypeField);
+  schema.fields.unshift(IdentifierField);
   schema.fields.push(ConstructorField);
   return schema;
 }
@@ -9556,9 +9603,33 @@ function cloneResponse(response, overrides) {
   const props = cloneResponseProperties(response);
   return new Response(response.body, Object.assign(props, overrides));
 }
+function withDateHeader(response) {
+  const headers = new Headers(response.headers);
+  headers.set('date', new Date().toUTCString());
+  return cloneResponse(response, {
+    headers
+  });
+}
+
+// Detects Mirage (or another Pretender-based fetch mock), whose `Response`
+// may (unlike a spec-compliant `fetch()`, whose Response headers are always
+// immutable) allow header mutation and may not support streaming reads.
+//
+// This is inherently a heuristic - many legitimate tools (APM/monitoring
+// agents, browser extensions, polyfills) also patch `window.fetch`, and can
+// produce false positives. `setWarpDriveIsMaybeMirage(value)` lets an app
+// declare the answer explicitly (`true` or `false`), overriding the
+// heuristic in either direction; leave it unset to keep the default
+// detection. See https://github.com/warp-drive-data/warp-drive/issues/10535
 let IS_MAYBE_MIRAGE = () => false;
 if (macroCondition(getGlobalConfig().WarpDriveMirror.env.DEBUG)) {
-  IS_MAYBE_MIRAGE = () => Boolean(typeof window !== 'undefined' && (window.server?.pretender || window.fetch.toString().replace(/\s+/g, '') !== 'function fetch() { [native code] }'.replace(/\s+/g, '')));
+  IS_MAYBE_MIRAGE = () => {
+    const override = getRuntimeConfig().mirage;
+    if (override !== undefined) {
+      return override;
+    }
+    return Boolean(typeof window !== 'undefined' && (window.server?.pretender || window.fetch.toString().replace(/\s+/g, '') !== 'function fetch() { [native code] }'.replace(/\s+/g, '')));
+  };
 }
 const MUTATION_OPS = new Set(['updateRecord', 'createRecord', 'deleteRecord']);
 const ERROR_STATUS_CODE_FOR = new Map([[400, 'Bad Request'], [401, 'Unauthorized'], [402, 'Payment Required'], [403, 'Forbidden'], [404, 'Not Found'], [405, 'Method Not Allowed'], [406, 'Not Acceptable'], [407, 'Proxy Authentication Required'], [408, 'Request Timeout'], [409, 'Conflict'], [410, 'Gone'], [411, 'Length Required'], [412, 'Precondition Failed'], [413, 'Payload Too Large'], [414, 'URI Too Long'], [415, 'Unsupported Media Type'], [416, 'Range Not Satisfiable'], [417, 'Expectation Failed'], [419, 'Page Expired'], [420, 'Enhance Your Calm'], [421, 'Misdirected Request'], [422, 'Unprocessable Entity'], [423, 'Locked'], [424, 'Failed Dependency'], [425, 'Too Early'], [426, 'Upgrade Required'], [428, 'Precondition Required'], [429, 'Too Many Requests'], [430, 'Request Header Fields Too Large'], [431, 'Request Header Fields Too Large'], [450, 'Blocked By Windows Parental Controls'], [451, 'Unavailable For Legal Reasons'], [500, 'Internal Server Error'], [501, 'Not Implemented'], [502, 'Bad Gateway'], [503, 'Service Unavailable'], [504, 'Gateway Timeout'], [505, 'HTTP Version Not Supported'], [506, 'Variant Also Negotiates'], [507, 'Insufficient Storage'], [508, 'Loop Detected'], [509, 'Bandwidth Limit Exceeded'], [510, 'Not Extended'], [511, 'Network Authentication Required']]);
@@ -9610,13 +9681,15 @@ const Fetch = {
     const isMutationOp = Boolean(op && MUTATION_OPS.has(op));
     if (!isError && !isMutationOp && response.status !== 204 && !response.headers.has('date')) {
       if (IS_MAYBE_MIRAGE()) {
-        response.headers.set('date', new Date().toUTCString());
+        try {
+          response.headers.set('date', new Date().toUTCString());
+        } catch {
+          // IS_MAYBE_MIRAGE() was a false positive, or the mock's headers
+          // are (correctly) immutable - fall back to cloning.
+          response = withDateHeader(response);
+        }
       } else {
-        const headers = new Headers(response.headers);
-        headers.set('date', new Date().toUTCString());
-        response = cloneResponse(response, {
-          headers
-        });
+        response = withDateHeader(response);
       }
     }
     context.setResponse(response);
@@ -9920,6 +9993,12 @@ if (macroCondition(getGlobalConfig().WarpDriveMirror.env.TESTING)) {
   globalThis.getWarpDriveRuntimeConfig = getRuntimeConfig;
 }
 
+// Mirage (or another Pretender-based fetch mock) may be used outside of a
+// `TESTING` build (e.g. `ember serve` in dev mode), so this override is
+// exposed unconditionally rather than gated to the `TESTING` env.
+// @ts-expect-error adding to globalThis
+globalThis.setWarpDriveIsMaybeMirage = setIsMaybeMirage;
+
 /**
  * Options for setting up a Store instance with `useRecommendedStore`.
  */

package/dist/index.js

@@ -1,4 +1,4 @@
-export { C as CacheHandler, F as Fetch, z as RequestManager, S as Store, r as cacheKeyFor, r as recordIdentifierFor, E as setIdentifierForgetMethod, B as setIdentifierGenerationMethod, G as setIdentifierResetMethod, D as setIdentifierUpdateMethod, H as setKeyInfoForResource, s as storeFor, A as useRecommendedStore } from "./index-CFwnjldF.js";
+export { C as CacheHandler, F as Fetch, z as RequestManager, S as Store, r as cacheKeyFor, r as recordIdentifierFor, E as setIdentifierForgetMethod, B as setIdentifierGenerationMethod, G as setIdentifierResetMethod, D as setIdentifierUpdateMethod, H as setKeyInfoForResource, s as storeFor, A as useRecommendedStore } from "./index-BoY6aNE5.js";
 import "./symbols-3C1OkYtZ.js";
 import "./configure-BMxnD2RJ.js";
 import '@embroider/macros';

package/dist/reactive.js

@@ -1,4 +1,4 @@
-export { u as SchemaService, p as checkout, y as commit, v as fromIdentity, q as instantiateRecord, x as registerDerivations, t as teardownRecord, w as withDefaults } from "./index-CFwnjldF.js";
+export { u as SchemaService, p as checkout, y as commit, v as fromIdentity, q as instantiateRecord, x as registerDerivations, t as teardownRecord, w as withDefaults } from "./index-BoY6aNE5.js";
 export { C as Checkout } from "./symbols-3C1OkYtZ.js";
 export { h as createRequestSubscription, j as getPromiseState, i as getRequestState } from "./configure-BMxnD2RJ.js";
 import '@embroider/macros';

package/dist/store/-private.js

@@ -1 +1 @@
-export { C as CacheHandler, R as RecordArrayManager, S as Store, k as StoreMap, _ as _clearCaches, n as _deprecatingNormalize, h as assertPrivateCapabilities, d as assertPrivateStore, b as coerceId, c as constructResource, l as createLegacyManyArray, e as ensureStringId, f as fastPush, g as isPrivateStore, a as isRequestKey, i as isResourceKey, m as log, o as logGroup, r as recordIdentifierFor, j as setRecordIdentifier, s as storeFor } from "../index-CFwnjldF.js";
+export { C as CacheHandler, R as RecordArrayManager, S as Store, k as StoreMap, _ as _clearCaches, n as _deprecatingNormalize, h as assertPrivateCapabilities, d as assertPrivateStore, b as coerceId, c as constructResource, l as createLegacyManyArray, e as ensureStringId, f as fastPush, g as isPrivateStore, a as isRequestKey, i as isResourceKey, m as log, o as logGroup, r as recordIdentifierFor, j as setRecordIdentifier, s as storeFor } from "../index-BoY6aNE5.js";

package/dist/types/-private.js

@@ -1,6 +1,6 @@
 import { macroCondition, getGlobalConfig } from '@embroider/macros';
 const name = "@warp-drive-mirror/core";
-const version = "5.9.0-alpha.17";
+const version = "5.9.0-alpha.18";
 
 // in testing mode, we utilize globals to ensure only one copy exists of
 // these maps, due to bugs in ember-auto-import

package/dist/types/runtime.js

@@ -31,4 +31,23 @@ function setLogging(config) {
   Object.assign(RuntimeConfig.debug, config);
   storage?.setItem('WarpDriveRuntimeConfig', JSON.stringify(RuntimeConfig));
 }
-export { getRuntimeConfig, setLogging };
+
+/**
+ * Explicitly declares whether requests may be served by Mirage (or another
+ * Pretender-based fetch mock) instead of a native `fetch` implementation.
+ *
+ * The `Fetch` request handler otherwise infers this via a heuristic (the
+ * presence of `window.server.pretender`, or `window.fetch` appearing to be
+ * patched), which can be wrong in either direction: some Mirage setups don't
+ * expose `window.server`, while some unrelated tools (APM agents, browser
+ * extensions) also patch `fetch`. Call this to override that heuristic:
+ * `true` to force Mirage-compatible behavior on, `false` to force it off.
+ *
+ * globalThis.setWarpDriveIsMaybeMirage(true);
+ *
+ */
+function setIsMaybeMirage(value) {
+  RuntimeConfig.mirage = value;
+  storage?.setItem('WarpDriveRuntimeConfig', JSON.stringify(RuntimeConfig));
+}
+export { getRuntimeConfig, setIsMaybeMirage, setLogging };