@warp-drive/core 5.7.0-alpha.3 → 5.7.0-alpha.31

package/dist/request.js

@@ -1 +1 @@
-export { c as createDeferred, g as getPromiseResult, s as setPromiseResult } from "./context-COmAnXUQ.js";
+export { c as createDeferred, g as getPromiseResult, s as setPromiseResult } from "./context-Bh-MA_tH.js";

package/dist/store/-private.js

@@ -1,3 +1,2 @@
-export { C as CollectionRecordArray, D as DISPOSE, I as LiveArray, M as MUTATE, R as RecordArrayManager, l as RelatedCollection, d as SOURCE, B as Signals, S as Store, j as StoreMap, _ as _clearCaches, n as _deprecatingNormalize, b as coerceId, c as constructResource, H as consumeInternalSignal, t as createRequestSubscription, z as defineGate, A as defineNonEnumerableSignal, y as defineSignal, e as ensureStringId, x as entangleSignal, f as fastPush, w as gate, J as getOrCreateInternalSignal, q as getPromiseState, u as getRequestState, a as isDocumentIdentifier, i as isStableIdentifier, m as log, o as logGroup, v as memoized, G as notifyInternalSignal, p as peekCache, E as peekInternalSignal, r as recordIdentifierFor, g as removeRecordDataFor, k as setCacheFor, h as setRecordIdentifier, s as storeFor, F as withSignalStore } from "../request-state-CejVJgdj.js";
-export { C as CacheHandler } from "../handler-D2jjnIA-.js";
-export { A as ARRAY_SIGNAL, O as OBJECT_SIGNAL, c as createMemo, w as waitFor } from "../configure-B48bFHOl.js";
+export { C as CacheHandler, D as DISPOSE, R as RecordArrayManager, E as Signals, S as Store, k as StoreMap, _ as _clearCaches, n as _deprecatingNormalize, h as assertPrivateCapabilities, d as assertPrivateStore, b as coerceId, c as constructResource, J as consumeInternalSignal, G as createInternalMemo, l as createLegacyManyArray, q as createRequestSubscription, A as defineGate, B as defineNonEnumerableSignal, z as defineSignal, e as ensureStringId, y as entangleInitiallyStaleSignal, x as entangleSignal, f as fastPush, w as gate, K as getOrCreateInternalSignal, p as getPromiseState, t as getRequestState, g as isPrivateStore, a as isRequestKey, i as isResourceKey, m as log, o as logGroup, v as memoized, I as notifyInternalSignal, F as peekInternalSignal, r as recordIdentifierFor, j as setRecordIdentifier, u as signal, s as storeFor, H as withSignalStore } from "../request-state-DGyt5EV8.js";
+export { A as ARRAY_SIGNAL, O as OBJECT_SIGNAL, w as waitFor } from "../configure-C3x8YXzL.js";

package/dist/store.js

@@ -94,7 +94,7 @@ function parseCacheControlValue(stringToParse) {
   }
   return parsedValue;
 }
-function isExpired(identifier, request, config) {
+function isExpired(cacheKey, request, config) {
   const {
     constraints
   } = config;
@@ -104,7 +104,7 @@ function isExpired(identifier, request, config) {
       if (macroCondition(getGlobalConfig().WarpDrive.activeLogging.LOG_CACHE_POLICY)) {
         if (getGlobalConfig().WarpDrive.debug.LOG_CACHE_POLICY || globalThis.getWarpDriveRuntimeConfig().debug.LOG_CACHE_POLICY) {
           // eslint-disable-next-line no-console
-          console.log(`CachePolicy: ${identifier.lid} is ${result ? 'EXPIRED' : 'NOT expired'} because constraints.isExpired returned ${result}`);
+          console.log(`CachePolicy: ${cacheKey.lid} is ${result ? 'EXPIRED' : 'NOT expired'} because constraints.isExpired returned ${result}`);
         }
       }
       return result;
@@ -117,7 +117,7 @@ function isExpired(identifier, request, config) {
     if (macroCondition(getGlobalConfig().WarpDrive.activeLogging.LOG_CACHE_POLICY)) {
       if (getGlobalConfig().WarpDrive.debug.LOG_CACHE_POLICY || globalThis.getWarpDriveRuntimeConfig().debug.LOG_CACHE_POLICY) {
         // eslint-disable-next-line no-console
-        console.log(`CachePolicy: ${identifier.lid} is EXPIRED because no headers were provided`);
+        console.log(`CachePolicy: ${cacheKey.lid} is EXPIRED because no headers were provided`);
       }
     }
 
@@ -138,7 +138,7 @@ function isExpired(identifier, request, config) {
         if (macroCondition(getGlobalConfig().WarpDrive.activeLogging.LOG_CACHE_POLICY)) {
           if (getGlobalConfig().WarpDrive.debug.LOG_CACHE_POLICY || globalThis.getWarpDriveRuntimeConfig().debug.LOG_CACHE_POLICY) {
             // eslint-disable-next-line no-console
-            console.log(`CachePolicy: ${identifier.lid} is ${result ? 'EXPIRED' : 'NOT expired'} because the time set by X-WarpDrive-Expires header is ${result ? 'in the past' : 'in the future'}`);
+            console.log(`CachePolicy: ${cacheKey.lid} is ${result ? 'EXPIRED' : 'NOT expired'} because the time set by X-WarpDrive-Expires header is ${result ? 'in the past' : 'in the future'}`);
           }
         }
         return result;
@@ -174,7 +174,7 @@ function isExpired(identifier, request, config) {
             if (macroCondition(getGlobalConfig().WarpDrive.activeLogging.LOG_CACHE_POLICY)) {
               if (getGlobalConfig().WarpDrive.debug.LOG_CACHE_POLICY || globalThis.getWarpDriveRuntimeConfig().debug.LOG_CACHE_POLICY) {
                 // eslint-disable-next-line no-console
-                console.log(`CachePolicy: ${identifier.lid} is ${result ? 'EXPIRED' : 'NOT expired'} because the time set by Cache-Control header is ${result ? 'in the past' : 'in the future'}`);
+                console.log(`CachePolicy: ${cacheKey.lid} is ${result ? 'EXPIRED' : 'NOT expired'} because the time set by Cache-Control header is ${result ? 'in the past' : 'in the future'}`);
               }
             }
             return result;
@@ -192,7 +192,7 @@ function isExpired(identifier, request, config) {
         if (macroCondition(getGlobalConfig().WarpDrive.activeLogging.LOG_CACHE_POLICY)) {
           if (getGlobalConfig().WarpDrive.debug.LOG_CACHE_POLICY || globalThis.getWarpDriveRuntimeConfig().debug.LOG_CACHE_POLICY) {
             // eslint-disable-next-line no-console
-            console.log(`CachePolicy: ${identifier.lid} is ${result ? 'EXPIRED' : 'NOT expired'} because the time set by Expires header is ${result ? 'in the past' : 'in the future'}`);
+            console.log(`CachePolicy: ${cacheKey.lid} is ${result ? 'EXPIRED' : 'NOT expired'} because the time set by Expires header is ${result ? 'in the past' : 'in the future'}`);
           }
         }
         return result;
@@ -205,7 +205,7 @@ function isExpired(identifier, request, config) {
     if (macroCondition(getGlobalConfig().WarpDrive.activeLogging.LOG_CACHE_POLICY)) {
       if (getGlobalConfig().WarpDrive.debug.LOG_CACHE_POLICY || globalThis.getWarpDriveRuntimeConfig().debug.LOG_CACHE_POLICY) {
         // eslint-disable-next-line no-console
-        console.log(`CachePolicy: ${identifier.lid} is EXPIRED because no Date header was provided`);
+        console.log(`CachePolicy: ${cacheKey.lid} is EXPIRED because no Date header was provided`);
       }
     }
     return true;
@@ -222,7 +222,7 @@ function isExpired(identifier, request, config) {
   if (macroCondition(getGlobalConfig().WarpDrive.activeLogging.LOG_CACHE_POLICY)) {
     if (getGlobalConfig().WarpDrive.debug.LOG_CACHE_POLICY || globalThis.getWarpDriveRuntimeConfig().debug.LOG_CACHE_POLICY) {
       // eslint-disable-next-line no-console
-      console.log(`CachePolicy: ${identifier.lid} is ${result ? 'EXPIRED' : 'NOT expired'} because the apiCacheHardExpires time since the response's Date header is ${result ? 'in the past' : 'in the future'}`);
+      console.log(`CachePolicy: ${cacheKey.lid} is ${result ? 'EXPIRED' : 'NOT expired'} because the apiCacheHardExpires time since the response's Date header is ${result ? 'in the past' : 'in the future'}`);
     }
   }
   return result;
@@ -263,7 +263,7 @@ function isExpired(identifier, request, config) {
  * request for that type is successful.
  *
  * For this to work, the `createRecord` request must include the `cacheOptions.types` array
- * with the types that should be invalidated, or its request should specify the identifiers
+ * with the types that should be invalidated, or its request should specify the ResourceKeys
  * of the records that are being created via `records`. Providing both is valid.
  *
  * > [!NOTE]
@@ -352,22 +352,20 @@ class DefaultCachePolicy {
   }
 
   /**
-   * Invalidate a request by its identifier for a given store instance.
+   * Invalidate a request by its CacheKey for the given store instance.
    *
    * While the store argument may seem redundant, the CachePolicy
    * is designed to be shared across multiple stores / forks
    * of the store.
    *
    * ```ts
-   * store.lifetimes.invalidateRequest(store, identifier);
+   * store.lifetimes.invalidateRequest(store, cacheKey);
    * ```
    *
    * @public
-   * @param {StableDocumentIdentifier} identifier
-   * @param {Store} store
    */
-  invalidateRequest(identifier, store) {
-    this._getStore(store).invalidated.add(identifier);
+  invalidateRequest(cacheKey, store) {
+    this._getStore(store).invalidated.add(cacheKey);
   }
 
   /**
@@ -386,8 +384,6 @@ class DefaultCachePolicy {
    * ```
    *
    * @public
-   * @param {String} type
-   * @param {Store} store
    */
   invalidateRequestsForType(type, store) {
     const storeCache = this._getStore(store);
@@ -397,7 +393,8 @@ class DefaultCachePolicy {
       // TODO batch notifications
       set.forEach(id => {
         storeCache.invalidated.add(id);
-        notifications.notify(id, 'invalidated');
+        // @ts-expect-error
+        notifications.notify(id, 'invalidated', null);
       });
     }
   }
@@ -413,13 +410,8 @@ class DefaultCachePolicy {
    * This method should not be invoked directly by consumers.
    *
    * @public
-   * @param {ImmutableRequestInfo} request
-   * @param {ImmutableResponse} response
-   * @param {Store} store
-   * @param {StableDocumentIdentifier | null} identifier
-   * @return {void}
    */
-  didRequest(request, response, identifier, store) {
+  didRequest(request, response, cacheKey, store) {
     // if this is a successful createRecord request, invalidate the cacheKey for the type
     if (request.op === 'createRecord') {
       const statusNumber = response?.status ?? 0;
@@ -436,15 +428,15 @@ class DefaultCachePolicy {
 
       // add this document's cacheKey to a map for all associated types
       // it is recommended to only use this for queries
-    } else if (identifier && request.cacheOptions?.types?.length) {
+    } else if (cacheKey && request.cacheOptions?.types?.length) {
       const storeCache = this._getStore(store);
       request.cacheOptions?.types.forEach(type => {
         const set = storeCache.types.get(type);
         if (set) {
-          set.add(identifier);
-          storeCache.invalidated.delete(identifier);
+          set.add(cacheKey);
+          storeCache.invalidated.delete(cacheKey);
         } else {
-          storeCache.types.set(type, new Set([identifier]));
+          storeCache.types.set(type, new Set([cacheKey]));
         }
       });
     }
@@ -462,28 +454,26 @@ class DefaultCachePolicy {
    * and the cache will be updated before returning the response.
    *
    * @public
-   * @param {StableDocumentIdentifier} identifier
-   * @param {Store} store
-   * @return {Boolean} true if the request is considered hard expired
+   * @return true if the request is considered hard expired
    */
-  isHardExpired(identifier, store) {
+  isHardExpired(cacheKey, store) {
     // if we are explicitly invalidated, we are hard expired
     const storeCache = this._getStore(store);
-    if (storeCache.invalidated.has(identifier)) {
+    if (storeCache.invalidated.has(cacheKey)) {
       return true;
     }
     const cache = store.cache;
-    const cached = cache.peekRequest(identifier);
+    const cached = cache.peekRequest(cacheKey);
     if (!cached?.response) {
       if (macroCondition(getGlobalConfig().WarpDrive.activeLogging.LOG_CACHE_POLICY)) {
         if (getGlobalConfig().WarpDrive.debug.LOG_CACHE_POLICY || globalThis.getWarpDriveRuntimeConfig().debug.LOG_CACHE_POLICY) {
           // eslint-disable-next-line no-console
-          console.log(`CachePolicy: ${identifier.lid} is EXPIRED because no cache entry was found`);
+          console.log(`CachePolicy: ${cacheKey.lid} is EXPIRED because no cache entry was found`);
         }
       }
       return true;
     }
-    return isExpired(identifier, cached, this.config);
+    return isExpired(cacheKey, cached, this.config);
   }
 
   /**
@@ -497,25 +487,23 @@ class DefaultCachePolicy {
    * request is made to update the cache via the configured request handlers.
    *
    * @public
-   * @param {StableDocumentIdentifier} identifier
-   * @param {Store} store
-   * @return {Boolean} true if the request is considered soft expired
+   * @return true if the request is considered soft expired
    */
-  isSoftExpired(identifier, store) {
+  isSoftExpired(cacheKey, store) {
     if (macroCondition(getGlobalConfig().WarpDrive.env.TESTING)) {
       if (!this.config.disableTestOptimization) {
         return false;
       }
     }
     const cache = store.cache;
-    const cached = cache.peekRequest(identifier);
+    const cached = cache.peekRequest(cacheKey);
     if (cached?.response) {
       const date = cached.response.headers.get('date');
       if (!date) {
         if (macroCondition(getGlobalConfig().WarpDrive.activeLogging.LOG_CACHE_POLICY)) {
           if (getGlobalConfig().WarpDrive.debug.LOG_CACHE_POLICY || globalThis.getWarpDriveRuntimeConfig().debug.LOG_CACHE_POLICY) {
             // eslint-disable-next-line no-console
-            console.log(`CachePolicy: ${identifier.lid} is STALE because no date header was found`);
+            console.log(`CachePolicy: ${cacheKey.lid} is STALE because no date header was found`);
           }
         }
         return true;
@@ -527,7 +515,7 @@ class DefaultCachePolicy {
         if (macroCondition(getGlobalConfig().WarpDrive.activeLogging.LOG_CACHE_POLICY)) {
           if (getGlobalConfig().WarpDrive.debug.LOG_CACHE_POLICY || globalThis.getWarpDriveRuntimeConfig().debug.LOG_CACHE_POLICY) {
             // eslint-disable-next-line no-console
-            console.log(`CachePolicy: ${identifier.lid} is ${result ? 'STALE' : 'NOT stale'}. Expiration time: ${deadline}, now: ${now}`);
+            console.log(`CachePolicy: ${cacheKey.lid} is ${result ? 'STALE' : 'NOT stale'}. Expiration time: ${deadline}, now: ${now}`);
           }
         }
         return result;
@@ -536,7 +524,7 @@ class DefaultCachePolicy {
     if (macroCondition(getGlobalConfig().WarpDrive.activeLogging.LOG_CACHE_POLICY)) {
       if (getGlobalConfig().WarpDrive.debug.LOG_CACHE_POLICY || globalThis.getWarpDriveRuntimeConfig().debug.LOG_CACHE_POLICY) {
         // eslint-disable-next-line no-console
-        console.log(`CachePolicy: ${identifier.lid} is STALE because no cache entry was found`);
+        console.log(`CachePolicy: ${cacheKey.lid} is STALE because no cache entry was found`);
       }
     }
     return true;

package/dist/{symbols-SIstXMLI.js → symbols-sql1_mdx.js}

@@ -32,13 +32,8 @@ import { getOrSetGlobal } from './types/-private.js';
 // debugging DX and as a safe way to provide an intimate contract on public objects.
 
 const SOURCE = getOrSetGlobal('SOURCE', Symbol('#source'));
-getOrSetGlobal('MUTATE', Symbol('#update'));
 const Destroy = getOrSetGlobal('Destroy', Symbol.dispose || Symbol.for('Dispose'));
-const Identifier = getOrSetGlobal('Identifier', Symbol('Identifier'));
-const Editable = getOrSetGlobal('Editable', Symbol('Editable'));
-const Parent = getOrSetGlobal('Parent', Symbol('Parent'));
 const Checkout = getOrSetGlobal('Checkout', Symbol('Checkout'));
-const Legacy = getOrSetGlobal('Legacy', Symbol('Legacy'));
-const EmbeddedPath = getOrSetGlobal('EmbeddedPath', Symbol('EmbeddedPath'));
-const EmbeddedField = getOrSetGlobal('EmbeddedField', Symbol('EmbeddedField'));
-export { Checkout as C, Destroy as D, Editable as E, Identifier as I, Legacy as L, Parent as P, SOURCE as S, EmbeddedPath as a, EmbeddedField as b };
+const Commit = getOrSetGlobal('Commit', Symbol('Commit'));
+const Context = getOrSetGlobal('Context', Symbol('Context'));
+export { Context as C, Destroy as D, SOURCE as S, Checkout as a, Commit as b };

package/dist/types/-private.js

@@ -1,6 +1,6 @@
 import { macroCondition, getGlobalConfig } from '@embroider/macros';
 const name = "@warp-drive/core";
-const version = "5.7.0-alpha.3";
+const version = "5.7.0-alpha.31";
 
 // 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/identifier.js

@@ -2,7 +2,7 @@ import { macroCondition, getGlobalConfig } from '@embroider/macros';
 
 // provided for additional debuggability
 const DEBUG_CLIENT_ORIGINATED = Symbol('record-originated-on-client');
-const DEBUG_IDENTIFIER_BUCKET = Symbol('identifier-bucket');
+const DEBUG_KEY_TYPE = Symbol('key-type');
 const DEBUG_STALE_CACHE_OWNER = Symbol('warpDriveStaleCache');
 function ProdSymbol(str, debugStr) {
   return macroCondition(getGlobalConfig().WarpDrive.env.DEBUG) ? Symbol(debugStr) : str;
@@ -12,78 +12,52 @@ function ProdSymbol(str, debugStr) {
 const CACHE_OWNER = ProdSymbol('__$co', 'CACHE_OWNER');
 
 /**
- * An Identifier specific to a record which may or may not
- * be present in the cache.
+ * A referentially stable object with a unique string (lid) that can be used
+ * as a reference to request data in the cache.
  *
- * The absence of an `id` DOES NOT indicate that this
- * Identifier is for a new client-created record as it
- * may also indicate that it was generated for a secondary
- * index and the primary `id` index is not yet known.
+ * Only requests that are assigned a RequestKey are retrievable/replayable from
+ * the cache, though requests without RequestKeys may still update cache state.
  *
- * @internal
+ * @public
  */
 
+/** @deprecated use {@link RequestKey} */
+
 /**
- * Used when an Identifier is known to be the stable version
- *
- * @internal
+ * Used when an ResourceKey is known to be the stable version
  */
 
 /**
- * Used when a StableRecordIdentifier was not created locally as part
+ * Used when a ResourceKey was not created locally as part
  * of a call to store.createRecord
  *
- * Distinguishing between this Identifier and one for a client created
- * record that was created with an ID is generally speaking not possible
+ * Distinguishing between this ResourceKey and one for a client created
+ * resource that was created with an ID is generally speaking not possible
  * at runtime, so anything with an ID typically narrows to this.
- *
- * @internal
  */
 
+/** @deprecated use {@link PersistedResourceKey} */
+
 /**
- * Used when a StableRecordIdentifier was created locally
+ * Used when a ResourceKey was created locally
  * (by a call to store.createRecord).
  *
- * It is possible in rare circumstances to have a StableRecordIdentifier
+ * It is possible in rare circumstances to have a ResourceKey
  * that is not for a new record but does not have an ID. This would
  * happen if a user intentionally created one for use with a secondary-index
  * prior to the record having been fully loaded.
- *
- * @internal
  */
 
 /**
  * A referentially stable object with a unique string (lid) that can be used
  * as a reference to data in the cache.
  *
- * Every record instance has a unique identifier, and identifiers may refer
+ * Every resource has a unique ResourceKey, and ResourceKeys may refer
  * to data that has never been loaded (for instance, in an async relationship).
  *
- * @class StableRecordIdentifier
  * @public
  */
 
-/**
- * A string representing a unique identity.
- *
- * @property lid
- * @type {String}
- * @public
- */
-/**
- * the primary resource `type` or `modelName` this identity belongs to.
- *
- * @property type
- * @type {String}
- * @public
- */
-/**
- * the primary id for the record this identity belongs to. `null`
- * if not yet assigned an id.
- *
- * @property id
- * @type {String | null}
- * @public
- */
+/** @deprecated use {@link ResourceKey} */
 
-export { CACHE_OWNER, DEBUG_CLIENT_ORIGINATED, DEBUG_IDENTIFIER_BUCKET, DEBUG_STALE_CACHE_OWNER };
+export { CACHE_OWNER, DEBUG_CLIENT_ORIGINATED, DEBUG_KEY_TYPE, DEBUG_STALE_CACHE_OWNER };

package/dist/types/request.js

@@ -1,4 +1,7 @@
 import { getOrSetUniversal, getOrSetGlobal } from './-private.js';
+
+// eslint-disable-next-line @typescript-eslint/no-unused-vars
+
 const SkipCache = getOrSetUniversal('SkipCache', Symbol.for('wd:skip-cache'));
 const EnableHydration = getOrSetUniversal('EnableHydration', Symbol.for('wd:enable-hydration'));
 const IS_FUTURE = getOrSetGlobal('IS_FUTURE', Symbol('IS_FUTURE'));
@@ -10,16 +13,55 @@ const STRUCTURED = getOrSetGlobal('DOC', Symbol('DOC'));
  */
 
 /**
- * JavaScript's native Request class.
+ * When a handler chain resolves, it returns an object
+ * containing the original request, the response set by the handler
+ * chain (if any), and the processed content.
+ */
+
+/**
+ * When a handler chain rejects, it throws an Error that maintains the
+ * `{ request, response, content }` shape but is also an Error instance
+ * itself.
+ *
+ * If using the error originates from the {@link Fetch | Fetch Handler}
+ * the error will be a {@link FetchError}
+ */
+
+/**
+ * A union of the resolve/reject data types for a request.
+ *
+ * See the docs for:
+ *
+ * - {@link StructuredDataDocument} (resolved/successful requests)
+ * - {@link StructuredErrorDocument} (rejected/failed requests)
+ */
+
+/**
+ * The {@link RequestInit} interface accepted by the native {@link fetch} API.
  *
  * WarpDrive provides our own typings due to incompleteness in the native typings.
  *
+ * @privateRemarks
+ * - [MDN Reference (fetch)](https://developer.mozilla.org/docs/Web/API/Window/fetch)
+ * - [MDN Reference (RequestInit)](https://developer.mozilla.org/en-US/docs/Web/API/RequestInit)
+ * - [MDN Reference (Request)](https://developer.mozilla.org/docs/Web/API/Request)
+ *
  */
 
 /**
- * Extends JavaScript's native {@link Request} object with additional
- * properties specific to the RequestManager's capabilities.
+ * Extends JavaScript's native {@link fetch} {@link NativeRequestInit | RequestInit} with additional
+ * properties specific to the {@link RequestManager | RequestManager's} capabilities.
+ *
+ * This interface is used to define the shape of a request that can be made via
+ * either the {@link RequestManager.request} or {@link Store.request} methods.
+ *
+ * @privateRemarks
+ * - [MDN Reference (fetch)](https://developer.mozilla.org/docs/Web/API/Window/fetch)
+ * - [MDN Reference (RequestInit)](https://developer.mozilla.org/en-US/docs/Web/API/RequestInit)
+ * - [MDN Reference (Request)](https://developer.mozilla.org/docs/Web/API/Request)
  *
+ * @public
+ * @since 4.12
  */
 
 /**

package/dist/types/schema/fields.js

@@ -1,3 +1,11 @@
+// eslint-disable-next-line @typescript-eslint/no-unused-vars
+
+// eslint-disable-next-line @typescript-eslint/no-unused-vars
+
+/**
+ * Options signature for Legacy Attributes.
+ */
+
 /**
  * A generic "field" that can be used to define
  * primitive value fields.
@@ -132,7 +140,7 @@
  * perform those itself.
  *
  * A schema-array can declare its "key" value to be `@hash` if
- * a schema-object has such a field.
+ * the schema-objects it contains have such a field.
  *
  * Only one hash field is permittable per schema-object, and
  * it should be placed in the `ResourceSchema`'s `@id` field
@@ -186,11 +194,13 @@
 /**
  * Represents a field whose value is an object
  * with a well-defined structure described by
- * a non-resource schema.
+ * a schema-object (a non-resource schema).
  *
  * If the object's structure is not well-defined,
  * use 'object' instead.
  *
+ * By default, a SchemaObject within
+ *
  * @public
  */
 
@@ -374,6 +384,17 @@
  * @public
  */
 
+/**
+ * A union of all possible LegacyMode and PolarisMode
+ * field schemas that represent data that could be in
+ * the cache.
+ *
+ * In other words this will not include types like alias
+ * fields, local fields, or derived fields.
+ *
+ * @public
+ */
+
 /**
  * A union of all possible field schemas that can be
  * used in an ObjectSchema.

package/dist/utils/string.js

@@ -19,7 +19,7 @@ const DEFAULT_MAX_CACHE_SIZE = 10_000;
  * and by `@warp-drive/utilities/string`. It is not intended
  * for use outside of these modules at this time.
  *
- * @internal
+ * @private
  */
 class LRUCache {
   // debug stats
@@ -84,7 +84,7 @@ const STRING_DASHERIZE_CACHE = new LRUCache(key => key.replace(STRING_DECAMELIZE
  * This version is only in this location to support a deprecated
  * behavior in the core package and will be removed in a future.
  *
- * @internal
+ * @private
  */
 function dasherize(str) {
   return STRING_DASHERIZE_CACHE.get(str);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@warp-drive/core",
-  "version": "5.7.0-alpha.3",
+  "version": "5.7.0-alpha.31",
   "description": "Core package for WarpDrive | All the Universal Basics",
   "keywords": [
     "ember-addon"
@@ -36,19 +36,19 @@
     }
   },
   "dependencies": {
-    "@embroider/macros": "^1.16.12",
-    "@warp-drive/build-config": "5.7.0-alpha.3"
+    "@embroider/macros": "^1.18.1",
+    "@warp-drive/build-config": "5.7.0-alpha.31"
   },
   "devDependencies": {
-    "@babel/core": "^7.26.10",
-    "@babel/plugin-transform-typescript": "^7.27.0",
-    "@babel/preset-typescript": "^7.27.0",
-    "@warp-drive/internal-config": "5.7.0-alpha.3",
+    "@babel/core": "^7.28.0",
+    "@babel/plugin-transform-typescript": "^7.28.0",
+    "@babel/preset-typescript": "^7.27.1",
+    "@warp-drive/internal-config": "5.7.0-alpha.31",
     "decorator-transforms": "^2.3.0",
-    "ember-source": "~6.3.0",
+    "ember-source": "~6.6.0",
     "expect-type": "^1.2.1",
-    "typescript": "^5.8.3",
-    "vite": "^7.0.0"
+    "typescript": "^5.9.2",
+    "vite": "^7.1.2"
   },
   "volta": {
     "extends": "../../package.json"

package/declarations/reactive/-private/fields/compute.d.ts

@@ -1,43 +0,0 @@
-import type { Store, StoreRequestInput } from "../../../index.js";
-import type { Future } from "../../../request.js";
-import { RelatedCollection as ManyArray } from "../../../store/-private.js";
-import type { Cache } from "../../../types/cache.js";
-import type { StableRecordIdentifier } from "../../../types/identifier.js";
-import type { ArrayField, DerivedField, FieldSchema, GenericField, LegacyHasManyField, LocalField, ObjectField, SchemaArrayField, SchemaObjectField } from "../../../types/schema/fields.js";
-import type { Links } from "../../../types/spec/json-api-raw.js";
-import { RecordStore } from "../../../types/symbols.js";
-import { ReactiveResource } from "../record.js";
-import type { SchemaService } from "../schema.js";
-import { Parent } from "../symbols.js";
-import { ManagedArray } from "./managed-array.js";
-import { ManagedObject } from "./managed-object.js";
-export declare const ManagedArrayMap: Map<ReactiveResource, Map<string, ManagedArray | ManyArray>>;
-export declare const ManagedObjectMap: Map<ReactiveResource, Map<string, ManagedObject | ReactiveResource>>;
-export declare function computeLocal(record: typeof Proxy<ReactiveResource>, field: LocalField, prop: string): unknown;
-export declare function peekManagedArray(record: ReactiveResource, field: FieldSchema): ManyArray | ManagedArray | undefined;
-export declare function peekManagedObject(record: ReactiveResource, field: ObjectField): ManagedObject | undefined;
-export declare function peekManagedObject(record: ReactiveResource, field: SchemaObjectField): ReactiveResource | undefined;
-export declare function computeField(schema: SchemaService, cache: Cache, record: ReactiveResource, identifier: StableRecordIdentifier, field: GenericField, prop: string | string[], editable: boolean): unknown;
-export declare function computeArray(store: Store, schema: SchemaService, cache: Cache, record: ReactiveResource, identifier: StableRecordIdentifier, field: ArrayField | SchemaArrayField, path: string[], editable: boolean, legacy: boolean): ManagedArray | null;
-export declare function computeObject(schema: SchemaService, cache: Cache, record: ReactiveResource, identifier: StableRecordIdentifier, field: ObjectField, path: string[], editable: boolean, legacy: boolean): ManagedObject | null;
-export declare function computeSchemaObject(store: Store, cache: Cache, record: ReactiveResource, identifier: StableRecordIdentifier, field: SchemaObjectField, path: string[], legacy: boolean, editable: boolean): ReactiveResource | null;
-export declare function computeAttribute(cache: Cache, identifier: StableRecordIdentifier, prop: string, editable: boolean): unknown;
-export declare function computeDerivation(schema: SchemaService, record: ReactiveResource, identifier: StableRecordIdentifier, field: DerivedField, prop: string): unknown;
-interface ResourceRelationship<T extends ReactiveResource = ReactiveResource> {
-	lid: string;
-	[Parent]: ReactiveResource;
-	[RecordStore]: Store;
-	name: string;
-	data: T | null;
-	links: Links;
-	meta: Record<string, unknown>;
-}
-// TODO probably this should just be a Document
-// but its separate until we work out the lid situation
-declare class ResourceRelationship<T extends ReactiveResource = ReactiveResource> {
-	constructor(store: Store, cache: Cache, parent: ReactiveResource, identifier: StableRecordIdentifier, field: FieldSchema, name: string, editable: boolean);
-	fetch(options?: StoreRequestInput<T, T>): Future<T>;
-}
-export declare function computeResource<T extends ReactiveResource>(store: Store, cache: Cache, parent: ReactiveResource, identifier: StableRecordIdentifier, field: FieldSchema, prop: string, editable: boolean): ResourceRelationship<T>;
-export declare function computeHasMany(store: Store, schema: SchemaService, cache: Cache, record: ReactiveResource, identifier: StableRecordIdentifier, field: LegacyHasManyField, path: string[], editable: boolean, legacy: boolean): ManyArray | null;
-export {};

package/declarations/store/-private/caches/cache-utils.d.ts

@@ -1,12 +0,0 @@
-import type { Cache } from "../../../types/cache.js";
-import type { StableRecordIdentifier } from "../../../types/identifier.js";
-import type { OpaqueRecordInstance } from "../../-types/q/record-instance.js";
-/*
-* Returns the Cache instance associated with a given
-* Model or Identifier
-*/
-export declare const CacheForIdentifierCache: Map<unknown, Cache>;
-export declare function setCacheFor(identifier: StableRecordIdentifier | OpaqueRecordInstance, cache: Cache): void;
-export declare function removeRecordDataFor(identifier: StableRecordIdentifier | OpaqueRecordInstance): void;
-export declare function peekCache(instance: StableRecordIdentifier): Cache | null;
-export declare function peekCache(instance: OpaqueRecordInstance): Cache;