@warp-drive/core 5.7.0-alpha.27 → 5.7.0-alpha.29

package/dist/{request-state-DAjbHWcs.js → request-state-B908BvPK.js}

@@ -6,7 +6,7 @@ import { getOrSetGlobal, peekTransient, setTransient } from './types/-private.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 { S as SOURCE, C as Context, D as Destroy, a as Checkout, b as Commit } from "./symbols-sql1_mdx.js";
-import { a as createSignal, b as consumeSignal, n as notifySignal, c as createMemo, A as ARRAY_SIGNAL, O as OBJECT_SIGNAL, d as willSyncFlushWatchers } from "./configure-B48bFHOl.js";
+import { a as createSignal, b as consumeSignal, n as notifySignal, c as createMemo, A as ARRAY_SIGNAL, O as OBJECT_SIGNAL, d as willSyncFlushWatchers } from "./configure-CiFDHArV.js";
 import { g as getPromiseResult, s as setPromiseResult } from "./context-Bh-MA_tH.js";
 import { RecordStore } from './types/symbols.js';
 const INITIALIZER_PROTO = {
@@ -49,7 +49,7 @@ function isInitializer(obj) {
  * - the "key" or "name" of the signal
  * - the "object identity" or "context" to which the signal is attached
  *
- * @internal
+ * @private
  */
 
 /**
@@ -68,7 +68,7 @@ function isInitializer(obj) {
  * initializeSignalStore(obj);
  * ```
  *
- * @internal
+ * @private
  */
 const Signals = getOrSetGlobal('Signals', Symbol('Signals'));
 
@@ -77,7 +77,7 @@ const Signals = getOrSetGlobal('Signals', Symbol('Signals'));
  * if it does not already exist and returns the associated
  * signal store.
  *
- * @internal
+ * @private
  */
 function withSignalStore(obj) {
   if (!obj[Signals]) {
@@ -93,7 +93,7 @@ function withSignalStore(obj) {
  * Useful for pre-warming the shape of an object to ensure
  * a key-transition to add it is not required later.
  *
- * @internal
+ * @private
  */
 function initializeSignalStore(obj) {
   macroCondition(getGlobalConfig().WarpDrive.env.DEBUG) ? (test => {
@@ -168,7 +168,7 @@ function createSignalDescriptor(key, intialValue) {
  * The signal will be lazily created when accessed and scoped to the
  * instance of the object.
  *
- * @internal
+ * @private
  */
 function defineSignal(obj, key, v) {
   Object.defineProperty(obj, key, createSignalDescriptor(key, v));
@@ -177,7 +177,7 @@ function defineSignal(obj, key, v) {
 /**
  * Define a non-enumerable signal property.
  *
- * @internal
+ * @private
  */
 function defineNonEnumerableSignal(obj, key, v) {
   const desc = createSignalDescriptor(key, v);
@@ -239,6 +239,8 @@ function memoized(target, key, descriptor) {
 
 /**
  * Decorator version of creating a gate.
+ *
+ * @private
  */
 function gate(_target, key, desc) {
   // eslint-disable-next-line @typescript-eslint/unbound-method
@@ -3198,6 +3200,20 @@ if (macroCondition(getGlobalConfig().WarpDrive.env.DEBUG)) {
  * @public
  */
 class CacheKeyManager {
+  /** @internal */
+  _cache;
+  /** @internal */
+
+  /** @internal */
+
+  /** @internal */
+
+  /** @internal */
+
+  /** @internal */
+
+  /** @internal */
+
   /** @internal */
 
   constructor() {
@@ -3224,7 +3240,7 @@ class CacheKeyManager {
    * we allow late binding of this private internal merge so that
    * the cache can insert itself here to handle elimination of duplicates
    *
-   * @private
+   * @internal
    */
   __configureMerge(method) {
     this._merge = method || defaultMergeMethod;
@@ -3235,10 +3251,13 @@ class CacheKeyManager {
     return this._getRecordIdentifier(resource, 2);
   }
 
-  /**
-   * @private
-   */
+  /** @internal */
+
+  /** @internal */
+
+  /** @internal */
 
+  /** @internal */
   _getRecordIdentifier(resource, shouldGenerate) {
     if (macroCondition(getGlobalConfig().WarpDrive.activeLogging.LOG_IDENTIFIERS)) {
       if (getGlobalConfig().WarpDrive.debug.LOG_IDENTIFIERS || globalThis.getWarpDriveRuntimeConfig().debug.LOG_IDENTIFIERS) {
@@ -3481,7 +3500,7 @@ class CacheKeyManager {
   }
 
   /**
-   * @private
+   * @internal
    */
   _mergeRecordIdentifiers(keyInfo, identifier, existingIdentifier, data) {
     macroCondition(getGlobalConfig().WarpDrive.env.DEBUG) ? (test => {
@@ -3570,6 +3589,15 @@ class CacheKeyManager {
     this._reset();
   }
 }
+
+/**
+ * This type exists for internal use only for
+ * where intimate contracts still exist either for
+ * the Test Suite or for Legacy code.
+ *
+ * @private
+ */
+
 function makeResourceKey(recordIdentifier, bucket, clientOriginated) {
   if (macroCondition(getGlobalConfig().WarpDrive.env.DEBUG)) {
     // we enforce immutability in dev
@@ -3734,6 +3762,12 @@ function addResourceToCache(cache, identifier) {
   }
 }
 class CacheCapabilitiesManager {
+  /** @internal */
+
+  /** @internal */
+
+  /** @internal */
+
   constructor(_store) {
     this._store = _store;
     this._willNotify = false;
@@ -3747,6 +3781,8 @@ class CacheCapabilitiesManager {
   get identifierCache() {
     return this.cacheKeyManager;
   }
+
+  /** @internal */
   _scheduleNotification(identifier, key) {
     let pending = this._pendingNotifies.get(identifier);
     if (!pending) {
@@ -3768,6 +3804,8 @@ class CacheCapabilitiesManager {
       this._flushNotifications();
     }
   }
+
+  /** @internal */
   _flushNotifications() {
     if (this._willNotify === false) {
       return;
@@ -3821,12 +3859,22 @@ class CacheCapabilitiesManager {
     this._pendingNotifies.delete(identifier);
   }
 }
+
+/**
+ * This type exists for internal use only for
+ * where intimate contracts still exist either for
+ * the Test Suite or for Legacy code.
+ *
+ * @private
+ */
+
 if (macroCondition(getGlobalConfig().WarpDrive.deprecations.ENABLE_LEGACY_SCHEMA_SERVICE)) {
   CacheCapabilitiesManager.prototype.getSchemaDefinitionService = function () {
     // FIXME add deprecation for this
-    return this._store.schema;
+    return this.schema;
   };
 }
+function assertPrivateCapabilities(manager) {}
 function isDestroyable(record) {
   return Boolean(record && typeof record === 'object' && typeof record.destroy === 'function');
 }
@@ -3891,7 +3939,7 @@ const StoreMap = getOrSetGlobal('StoreMap', new Map());
 
 /**
  * We may eventually make this public, but its likely better for this to be killed off
- * @internal
+ * @private
  */
 function storeFor(record, ignoreMissing) {
   const store = StoreMap.get(record);
@@ -4935,6 +4983,15 @@ class NotificationManager {
     this._cache.clear();
   }
 }
+
+/**
+ * This type exists for internal use only for
+ * where intimate contracts still exist either for
+ * the Test Suite or for Legacy code.
+ *
+ * @private
+ */
+
 function _flushNotification(cache, cacheKey, value, key) {
   if (macroCondition(getGlobalConfig().WarpDrive.activeLogging.LOG_NOTIFICATIONS)) {
     if (getGlobalConfig().WarpDrive.debug.LOG_NOTIFICATIONS || globalThis.getWarpDriveRuntimeConfig().debug.LOG_NOTIFICATIONS) {
@@ -5409,7 +5466,7 @@ function createRequestCollection(config) {
 /**
  * The options for {@link createLegacyLiveArray}
  *
- * @internal
+ * @private
  */
 /**
  * Creates a {@link LegacyLiveArray}
@@ -5564,7 +5621,7 @@ const SLICE_BATCH_SIZE = 4761;
  * Sincerely,
  *   - runspired (Chris Thoburn) 08/21/2022
  *
- * @internal
+ * @private
  * @param target the array to push into
  * @param source the items to push into target
  */
@@ -5577,32 +5634,40 @@ function fastPush(target, source) {
   target.push(...source);
 }
 /**
-  @class RecordArrayManager
-  @internal
+  @hideconstructor
+  @private
 */
 class RecordArrayManager {
-  /**
-   *
-   */
+  /** @internal */
+
+  /** @internal */
+
+  /** @internal */
+
+  /** @internal */
 
   /**
    * LiveArray (peekAll/findAll) array instances
    * keyed by their ResourceType.
-   */
-
-  /**
    *
+   * @internal
    */
 
+  /** @internal */
+
   /**
    * Buffered changes to apply keyed by the array to
    * which to apply them to.
+   *
+   * @internal
    */
 
   /**
    * An inverse map from ResourceKey to the list
    * of arrays it can be found in, useful for fast updates
    * when state changes to a resource occur.
+   *
+   * @internal
    */
 
   /**
@@ -5612,10 +5677,17 @@ class RecordArrayManager {
    *
    * It's possible that using a Set and only storing additions instead of
    * additions and deletes would be more efficient.
+   *
+   * @internal
    */
 
+  /** @internal */
+
+  /** @internal */
+
   /**
    * KeyedArrays are arrays associated to a specific RequestKey.
+   * @internal
    */
 
   /**
@@ -5627,6 +5699,7 @@ class RecordArrayManager {
    * reduce its size by instead migrating to it functioning as
    * an exclusion list. Any entry not in the list would be considered
    * visible.
+   * @internal
    */
 
   constructor(options) {
@@ -5649,6 +5722,8 @@ class RecordArrayManager {
     });
     this._subscribeToResourceChanges();
   }
+
+  /** @internal */
   _subscribeToResourceChanges() {
     this._subscription = this.store.notifications.subscribe('resource', (identifier, type) => {
       const schema = this.store.schema.resource?.(identifier);
@@ -5671,6 +5746,8 @@ class RecordArrayManager {
       }
     });
   }
+
+  /** @internal */
   _syncArray(array) {
     const pending = this._pending.get(array);
     const isLegacyQuery = isLegacyQueryArray(array);
@@ -5714,9 +5791,7 @@ class RecordArrayManager {
   /**
     Get the `RecordArray` for a modelName, which contains all loaded records of
     given modelName.
-     @internal
-    @param {String} modelName
-    @return {RecordArray}
+     @private
   */
   liveArrayFor(type) {
     let array = this._live.get(type);
@@ -5800,6 +5875,8 @@ class RecordArrayManager {
       signal.value = shouldSyncFromCache ? 'cache-sync' : 'patch';
     }
   }
+
+  /** @internal */
   _getPendingFor(identifier, includeManaged, isRemove) {
     if (this.isDestroying || this.isDestroyed) {
       return;
@@ -5848,6 +5925,10 @@ class RecordArrayManager {
     }
     return pending;
   }
+
+  /**
+   * @private
+   */
   populateManagedArray(array, identifiers, payload) {
     this._pending.delete(array);
     const source = array[Context].source;
@@ -5869,6 +5950,8 @@ class RecordArrayManager {
     disassociate(this._identifiers, array, old);
     associate(this._identifiers, array, identifiers);
   }
+
+  /** @internal */
   identifierAdded(identifier) {
     const changeSets = this._getPendingFor(identifier, false);
     if (changeSets) {
@@ -5883,6 +5966,8 @@ class RecordArrayManager {
       });
     }
   }
+
+  /** @internal */
   identifierRemoved(identifier) {
     const changeSets = this._getPendingFor(identifier, true, true);
     if (changeSets) {
@@ -5897,6 +5982,8 @@ class RecordArrayManager {
       });
     }
   }
+
+  /** @internal */
   identifierChanged(identifier) {
     const newState = this.store._instanceCache.recordIsLoaded(identifier, true);
 
@@ -5917,6 +6004,10 @@ class RecordArrayManager {
   resume() {
     this._subscribeToResourceChanges();
   }
+
+  /**
+   * @internal
+   */
   clear(isClear = true) {
     for (const array of this._live.values()) {
       array.destroy(isClear);
@@ -5941,6 +6032,15 @@ class RecordArrayManager {
     this.isDestroyed = true;
   }
 }
+
+/**
+ * This type exists for internal use only for
+ * where intimate contracts still exist either for
+ * the Test Suite or for Legacy code.
+ *
+ * @private
+ */
+
 function associate(ArraysCache, array, identifiers) {
   for (let i = 0; i < identifiers.length; i++) {
     const identifier = identifiers[i];
@@ -6035,9 +6135,13 @@ function hasRecordIdentifier(op) {
 class RequestStateService {
   /** @internal */
   _pending = new Map();
+  /** @internal */
   _done = new Map();
+  /** @internal */
   _subscriptions = new Map();
+  /** @internal */
   _toFlush = [];
+  /** @internal */
   _store;
   constructor(store) {
     this._store = store;
@@ -6100,6 +6204,8 @@ class RequestStateService {
       }
     })() : {};
   }
+
+  /** @internal */
   _triggerSubscriptions(req) {
     if (req.state === 'pending') {
       this._flushRequest(req);
@@ -6112,6 +6218,8 @@ class RequestStateService {
       });
     }
   }
+
+  /** @internal */
   _flush() {
     this._toFlush.forEach(req => {
       this._flushRequest(req);
@@ -6217,6 +6325,14 @@ class RequestStateService {
   }
 }
 
+/**
+ * This type exists for internal use only for
+ * where intimate contracts still exist either for
+ * the Test Suite or for Legacy code.
+ *
+ * @private
+ */
+
 // this import location is deprecated but breaks in 4.8 and older
 // @ts-expect-error adding to globalThis
 globalThis.setWarpDriveLogging = setLogging;
@@ -6519,14 +6635,16 @@ class Store extends BaseClass {
    * @internal
    */
 
-  // DEBUG-only properties
-  /** @internal */
+  /**
+   * Available in DEBUG Only
+   * @internal
+   */
 
   /** @internal */
 
   /** @internal */
 
-  /** @internal */
+  /** @private */
   get isDestroying() {
     return this._isDestroying;
   }
@@ -6534,7 +6652,7 @@ class Store extends BaseClass {
   set isDestroying(value) {
     this._isDestroying = value;
   }
-  /** @internal */
+  /** @private */
   get isDestroyed() {
     return this._isDestroyed;
   }
@@ -7281,7 +7399,7 @@ class Store extends BaseClass {
     return cache;
   }
 
-  /** @internal */
+  /** @private */
   destroy() {
     if (this.isDestroyed) {
       // @ember/test-helpers will call destroy multiple times
@@ -7306,6 +7424,31 @@ class Store extends BaseClass {
     return new this(args);
   }
 }
+
+/**
+ * This type exists for internal use only for
+ * where intimate contracts still exist either for
+ * the Test Suite or for Legacy code.
+ *
+ * @private
+ */
+
+/**
+ * Upgrade the type for Store to PrivateStore, which will also
+ * upgrade any associated types to their private equivalents.
+ *
+ * @private
+ */
+function assertPrivateStore(store) {}
+/**
+ * Upgrade the type for Store to PrivateStore, which will also
+ * upgrade any associated types to their private equivalents.
+ *
+ * @private
+ */
+function isPrivateStore(store) {
+  return store;
+}
 if (macroCondition(getGlobalConfig().WarpDrive.deprecations.ENABLE_LEGACY_SCHEMA_SERVICE)) {
   Store.prototype.getSchemaDefinitionService = function () {
     macroCondition(getGlobalConfig().WarpDrive.env.DEBUG) ? (test => {
@@ -8527,12 +8670,12 @@ function constructResource(type, id, lid) {
 /**
  * The options for {@link createLegacyManyArray}
  *
- * @internal
+ * @private
  */
 /**
  * Creates a {@link LegacyManyArray}
  *
- * @internal
+ * @private
  */
 function createLegacyManyArray(options) {
   const extensions = options.store.schema.CAUTION_MEGA_DANGER_ZONE_arrayExtensions ? options.store.schema.CAUTION_MEGA_DANGER_ZONE_arrayExtensions(options.field) : null;
@@ -9186,7 +9329,10 @@ class RequestSubscription {
 
   /** @internal */
 
-  /** @internal */
+  /**
+   * The Store this subscription subscribes to or the RequestManager
+   * which issues this request.
+   */
 
   constructor(store, args) {
     this._args = args;
@@ -10130,4 +10276,4 @@ function getRequestState(future) {
   }
   return state;
 }
-export { withSignalStore as A, notifyInternalSignal as B, CacheHandler as C, DISPOSE as D, consumeInternalSignal as E, getOrCreateInternalSignal as F, ReactiveResource as G, isNonIdentityCacheableField as H, getFieldCacheKeyStrict as I, checkout as J, commit as K, setIdentifierGenerationMethod as L, setIdentifierUpdateMethod as M, setIdentifierForgetMethod as N, setIdentifierResetMethod as O, setKeyInfoForResource as P, RecordArrayManager as R, Store as S, _clearCaches as _, isRequestKey as a, coerceId as b, constructResource as c, setRecordIdentifier as d, ensureStringId as e, fastPush as f, StoreMap as g, createLegacyManyArray as h, isResourceKey as i, logGroup as j, getPromiseState as k, log as l, createRequestSubscription as m, normalizeModelName as n, getRequestState as o, signal as p, memoized as q, recordIdentifierFor as r, storeFor as s, gate as t, entangleSignal as u, defineSignal as v, defineGate as w, defineNonEnumerableSignal as x, Signals as y, peekInternalSignal as z };
+export { defineNonEnumerableSignal as A, Signals as B, CacheHandler as C, DISPOSE as D, peekInternalSignal as E, withSignalStore as F, notifyInternalSignal as G, consumeInternalSignal as H, getOrCreateInternalSignal as I, ReactiveResource as J, isNonIdentityCacheableField as K, getFieldCacheKeyStrict as L, checkout as M, commit as N, setIdentifierGenerationMethod as O, setIdentifierUpdateMethod as P, setIdentifierForgetMethod as Q, RecordArrayManager as R, Store as S, setIdentifierResetMethod as T, setKeyInfoForResource as U, _clearCaches as _, isRequestKey as a, coerceId as b, constructResource as c, assertPrivateStore as d, ensureStringId as e, fastPush as f, isPrivateStore as g, assertPrivateCapabilities as h, isResourceKey as i, setRecordIdentifier as j, StoreMap as k, createLegacyManyArray as l, log as m, normalizeModelName as n, logGroup as o, getPromiseState as p, createRequestSubscription as q, recordIdentifierFor as r, storeFor as s, getRequestState as t, signal as u, memoized as v, gate as w, entangleSignal as x, defineSignal as y, defineGate as z };

package/dist/store/-private.js

@@ -1,2 +1,2 @@
-export { C as CacheHandler, D as DISPOSE, R as RecordArrayManager, y as Signals, S as Store, g as StoreMap, _ as _clearCaches, n as _deprecatingNormalize, b as coerceId, c as constructResource, E as consumeInternalSignal, h as createLegacyManyArray, m as createRequestSubscription, w as defineGate, x as defineNonEnumerableSignal, v as defineSignal, e as ensureStringId, u as entangleSignal, f as fastPush, t as gate, F as getOrCreateInternalSignal, k as getPromiseState, o as getRequestState, a as isRequestKey, i as isResourceKey, l as log, j as logGroup, q as memoized, B as notifyInternalSignal, z as peekInternalSignal, r as recordIdentifierFor, d as setRecordIdentifier, p as signal, s as storeFor, A as withSignalStore } from "../request-state-DAjbHWcs.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, B 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, H as consumeInternalSignal, l as createLegacyManyArray, q as createRequestSubscription, z as defineGate, A as defineNonEnumerableSignal, y as defineSignal, e as ensureStringId, x as entangleSignal, f as fastPush, w as gate, I 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, G as notifyInternalSignal, E as peekInternalSignal, r as recordIdentifierFor, j as setRecordIdentifier, u as signal, s as storeFor, F as withSignalStore } from "../request-state-B908BvPK.js";
+export { A as ARRAY_SIGNAL, O as OBJECT_SIGNAL, c as createMemo, w as waitFor } from "../configure-CiFDHArV.js";

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.27";
+const version = "5.7.0-alpha.29";
 
 // in testing mode, we utilize globals to ensure only one copy exists of
 // these maps, due to bugs in ember-auto-import

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.27",
+  "version": "5.7.0-alpha.29",
   "description": "Core package for WarpDrive | All the Universal Basics",
   "keywords": [
     "ember-addon"
@@ -37,13 +37,13 @@
   },
   "dependencies": {
     "@embroider/macros": "^1.16.12",
-    "@warp-drive/build-config": "5.7.0-alpha.27"
+    "@warp-drive/build-config": "5.7.0-alpha.29"
   },
   "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.27",
+    "@warp-drive/internal-config": "5.7.0-alpha.29",
     "decorator-transforms": "^2.3.0",
     "ember-source": "~6.3.0",
     "expect-type": "^1.2.1",