@warp-drive/core 5.8.0-alpha.37 → 5.8.0-alpha.40

package/dist/unpkg/prod-deprecated/store.js

@@ -1 +1,437 @@
-export { D as DefaultCachePolicy, p as parseCacheControl } from "./default-cache-policy-D7_u4YRH.js";
+import { LRUCache } from './utils/string.js';
+
+// eslint-disable-next-line @typescript-eslint/no-unused-vars
+
+/**
+ * Interface of a parsed Cache-Control header value.
+ *
+ * - [MDN Cache-Control Reference](https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Headers/Cache-Control)
+ */
+
+const NUMERIC_KEYS = new Set(['max-age', 's-maxage', 'stale-if-error', 'stale-while-revalidate']);
+
+/**
+ *  Parses a string Cache-Control header value into an object with the following structure:
+ *
+ * ```ts
+ * interface CacheControlValue {
+ *   immutable?: boolean;
+ *   'max-age'?: number;
+ *   'must-revalidate'?: boolean;
+ *   'must-understand'?: boolean;
+ *   'no-cache'?: boolean;
+ *   'no-store'?: boolean;
+ *   'no-transform'?: boolean;
+ *   'only-if-cached'?: boolean;
+ *   private?: boolean;
+ *   'proxy-revalidate'?: boolean;
+ *   public?: boolean;
+ *   's-maxage'?: number;
+ *   'stale-if-error'?: number;
+ *   'stale-while-revalidate'?: number;
+ * }
+ * ```
+ *
+ * See also {@link CacheControlValue} and [Response Directives](https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Headers/Cache-Control#response_directives)
+ *
+ * @public
+ */
+function parseCacheControl(header) {
+  return CACHE_CONTROL_CACHE.get(header);
+}
+const CACHE_CONTROL_CACHE = new LRUCache(header => {
+  let key = '';
+  let value = '';
+  let isParsingKey = true;
+  const cacheControlValue = {};
+  for (let i = 0; i < header.length; i++) {
+    const char = header.charAt(i);
+    if (char === ',') {
+      isParsingKey = true;
+      // @ts-expect-error TS incorrectly thinks that optional keys must have a type that includes undefined
+      cacheControlValue[key] = NUMERIC_KEYS.has(key) ? parseCacheControlValue(value) : true;
+      key = '';
+      value = '';
+      continue;
+    } else if (char === '=') {
+      isParsingKey = false;
+    } else if (char === ' ' || char === `\t` || char === `\n`) {
+      continue;
+    } else if (isParsingKey) {
+      key += char;
+    } else {
+      value += char;
+    }
+    if (i === header.length - 1) {
+      // @ts-expect-error TS incorrectly thinks that optional keys must have a type that includes undefined
+      cacheControlValue[key] = NUMERIC_KEYS.has(key) ? parseCacheControlValue(value) : true;
+    }
+  }
+  return cacheControlValue;
+}, 200);
+function parseCacheControlValue(stringToParse) {
+  const parsedValue = Number.parseInt(stringToParse);
+  if (Number.isNaN(parsedValue) || parsedValue < 0) {
+    return 0;
+  }
+  return parsedValue;
+}
+function isExpired(cacheKey, request, config) {
+  const {
+    constraints
+  } = config;
+  if (constraints?.isExpired) {
+    const result = constraints.isExpired(request);
+    if (result !== null) {
+      return result;
+    }
+  }
+  const {
+    headers
+  } = request.response;
+  if (!headers) {
+    // if we have no headers then both the headers based expiration
+    // and the time based expiration will be considered expired
+    return true;
+  }
+
+  // check for X-WarpDrive-Expires
+  const now = Date.now();
+  const date = headers.get('Date');
+  if (constraints?.headers) {
+    if (constraints.headers['X-WarpDrive-Expires']) {
+      const xWarpDriveExpires = headers.get('X-WarpDrive-Expires');
+      if (xWarpDriveExpires) {
+        const expirationTime = new Date(xWarpDriveExpires).getTime();
+        const result = now >= expirationTime;
+        return result;
+      }
+    }
+
+    // check for Cache-Control
+    if (constraints.headers['Cache-Control']) {
+      const cacheControl = headers.get('Cache-Control');
+      const age = headers.get('Age');
+      if (cacheControl && age && date) {
+        const cacheControlValue = parseCacheControl(cacheControl);
+
+        // max-age and s-maxage are stored in
+        const maxAge = cacheControlValue['max-age'] || cacheControlValue['s-maxage'];
+        if (maxAge) {
+          // age is stored in seconds
+          const ageValue = parseInt(age, 10);
+          if (!Number.isNaN(ageValue) && ageValue >= 0) {
+            const dateValue = new Date(date).getTime();
+            const expirationTime = dateValue + (maxAge - ageValue) * 1000;
+            const result = now >= expirationTime;
+            return result;
+          }
+        }
+      }
+    }
+
+    // check for Expires
+    if (constraints.headers.Expires) {
+      const expires = headers.get('Expires');
+      if (expires) {
+        const expirationTime = new Date(expires).getTime();
+        const result = now >= expirationTime;
+        return result;
+      }
+    }
+  }
+
+  // check for Date
+  if (!date) {
+    return true;
+  }
+  let expirationTime = config.apiCacheHardExpires;
+  const time = new Date(date).getTime();
+  const deadline = time + expirationTime;
+  const result = now >= deadline;
+  return result;
+}
+
+/**
+ * The constraint options for {@link PolicyConfig.constraints}
+ */
+
+/**
+ * The configuration options for the {@link DefaultCachePolicy}
+ *
+ * ```ts [app/services/store.ts]
+ * import { Store } from '@warp-drive/core';
+ * import { DefaultCachePolicy } from '@warp-drive/core/store'; // [!code focus]
+ *
+ * export default class AppStore extends Store {
+ *   lifetimes = new DefaultCachePolicy({ // [!code focus:3]
+ *     // ... PolicyConfig Settings ... //
+ *   });
+ * }
+ * ```
+ *
+ */
+
+/**
+ * A basic {@link CachePolicy} that can be added to the Store service.
+ *
+ * ```ts [app/services/store.ts]
+ * import { Store } from '@warp-drive/core';
+ * import { DefaultCachePolicy } from '@warp-drive/core/store'; // [!code focus]
+ *
+ * export default class AppStore extends Store {
+ *   lifetimes = new DefaultCachePolicy({ // [!code focus:5]
+ *     apiCacheSoftExpires: 30_000,
+ *     apiCacheHardExpires: 60_000,
+ *     // ... Other PolicyConfig Settings ... //
+ *   });
+ * }
+ * ```
+ *
+ * :::tip 💡 TIP
+ * Date headers do not have millisecond precision, so expiration times should
+ * generally be larger than 1000ms.
+ * :::
+ *
+ * See also {@link PolicyConfig} for configuration options.
+ *
+ * ### The Mechanics
+ *
+ * This policy determines staleness based on various configurable constraints falling back to a simple
+ * check of the time elapsed since the request was last received from the API using the `date` header
+ * from the last response.
+ *
+ * :::tip 💡 TIP
+ * The {@link Fetch} handler provided by `@warp-drive/core` will automatically
+ * add the `date` header to responses if it is not present.
+ * :::
+ *
+ * - For manual override of reload see {@link CacheOptions.reload | cacheOptions.reload}
+ * - For manual override of background reload see {@link CacheOptions.backgroundReload | cacheOptions.backgroundReload}
+ *
+ * In order expiration is determined by:
+ *
+ * ```md
+ * Is explicitly invalidated by `cacheOptions.reload`
+ *   ↳ (if falsey) if the request has been explicitly invalidated
+ *      since the last request (see Automatic Invalidation below)
+ *   ↳ (if false) (If Active) isExpired function
+ *   ↳ (if null) (If Active) X-WarpDrive-Expires header
+ *   ↳ (if null) (If Active) Cache-Control header
+ *   ↳ (if null) (If Active) Expires header
+ *   ↳ (if null) Date header + apiCacheHardExpires < current time
+ *
+ *   -- <if above is false, a background request is issued if> --
+ *
+ *   ↳ is invalidated by `cacheOptions.backgroundReload`
+ *   ↳ (if falsey) Date header + apiCacheSoftExpires < current time
+ * ```
+ *
+ * ### Automatic Invalidation / Entanglement
+ *
+ * It also invalidates any request with an {@link RequestInfo.op | OpCode} of `"query"`
+ * for which {@link CacheOptions.types | cacheOptions.types} was provided
+ * when a request with an `OpCode` of `"createRecord"` is successful and also includes
+ * a matching type in its own `cacheOptions.types` array.
+
+ * :::tip 💡 TIP
+ * Abstracting this behavior via builders is recommended to ensure consistency.
+ * :::
+ *
+ * ### Testing
+ *
+ * In Testing environments:
+ *
+ * - `apiCacheSoftExpires` will always be `false`
+ * - `apiCacheHardExpires` will use the `apiCacheSoftExpires` value.
+ *
+ * This helps reduce flakiness and produce predictably rendered results in test suites.
+ *
+ * Requests that specifically set `cacheOptions.backgroundReload = true` will
+ * still be background reloaded in tests.
+ *
+ * This behavior can be opted out of by setting `disableTestOptimization = true`
+ * in the policy config.
+ *
+ * @public
+ */
+class DefaultCachePolicy {
+  /**
+   * @internal
+   */
+
+  /**
+   * @internal
+   */
+
+  /**
+   * @internal
+   */
+  _getStore(store) {
+    let set = this._stores.get(store);
+    if (!set) {
+      set = {
+        invalidated: new Set(),
+        types: new Map()
+      };
+      this._stores.set(store, set);
+    }
+    return set;
+  }
+  constructor(config) {
+    this._stores = new WeakMap();
+    const _config = arguments.length === 1 ? config : arguments[1];
+    this.config = _config;
+  }
+
+  /**
+   * 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, cacheKey);
+   * ```
+   *
+   * @public
+   */
+  invalidateRequest(cacheKey, store) {
+    this._getStore(store).invalidated.add(cacheKey);
+  }
+
+  /**
+   * Invalidate all requests associated to a specific type
+   * for a given store instance.
+   *
+   * While the store argument may seem redundant, the CachePolicy
+   * is designed to be shared across multiple stores / forks
+   * of the store.
+   *
+   * This invalidation is done automatically when using this service
+   * for both the {@link CacheHandler} and the [NetworkHandler](/api/@warp-drive/legacy/compat/variables/LegacyNetworkHandler).
+   *
+   * ```ts
+   * store.lifetimes.invalidateRequestsForType(store, 'person');
+   * ```
+   *
+   * @public
+   */
+  invalidateRequestsForType(type, store) {
+    const storeCache = this._getStore(store);
+    const set = storeCache.types.get(type);
+    const notifications = store.notifications;
+    if (set) {
+      // TODO batch notifications
+      set.forEach(id => {
+        storeCache.invalidated.add(id);
+        // @ts-expect-error
+        notifications.notify(id, 'invalidated', null);
+      });
+    }
+  }
+
+  /**
+   * Invoked when a request has been fulfilled from the configured request handlers.
+   * This is invoked by the CacheHandler for both foreground and background requests
+   * once the cache has been updated.
+   *
+   * Note, this is invoked by the {@link CacheHandler} regardless of whether
+   * the request has a cache-key.
+   *
+   * This method should not be invoked directly by consumers.
+   *
+   * @public
+   */
+  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;
+      if (statusNumber >= 200 && statusNumber < 400) {
+        const types = new Set(request.records?.map(r => r.type));
+        const additionalTypes = request.cacheOptions?.types;
+        additionalTypes?.forEach(type => {
+          types.add(type);
+        });
+        types.forEach(type => {
+          this.invalidateRequestsForType(type, store);
+        });
+      }
+
+      // add this document's cacheKey to a map for all associated types
+      // it is recommended to only use this for queries
+    } 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(cacheKey);
+          storeCache.invalidated.delete(cacheKey);
+        } else {
+          storeCache.types.set(type, new Set([cacheKey]));
+        }
+      });
+    }
+  }
+
+  /**
+   * Invoked to determine if the request may be fulfilled from cache
+   * if possible.
+   *
+   * Note, this is only invoked by the {@link CacheHandler} if the request has
+   * a cache-key.
+   *
+   * If no cache entry is found or the entry is hard expired,
+   * the request will be fulfilled from the configured request handlers
+   * and the cache will be updated before returning the response.
+   *
+   * @public
+   * @return true if the request is considered hard expired
+   */
+  isHardExpired(cacheKey, store) {
+    // if we are explicitly invalidated, we are hard expired
+    const storeCache = this._getStore(store);
+    if (storeCache.invalidated.has(cacheKey)) {
+      return true;
+    }
+    const cache = store.cache;
+    const cached = cache.peekRequest(cacheKey);
+    if (!cached?.response) {
+      return true;
+    }
+    return isExpired(cacheKey, cached, this.config);
+  }
+
+  /**
+   * Invoked if `isHardExpired` is false to determine if the request
+   * should be update behind the scenes if cache data is already available.
+   *
+   * Note, this is only invoked by the {@link CacheHandler} if the request has
+   * a cache-key.
+   *
+   * If true, the request will be fulfilled from cache while a backgrounded
+   * request is made to update the cache via the configured request handlers.
+   *
+   * @public
+   * @return true if the request is considered soft expired
+   */
+  isSoftExpired(cacheKey, store) {
+    const cache = store.cache;
+    const cached = cache.peekRequest(cacheKey);
+    if (cached?.response) {
+      const date = cached.response.headers.get('date');
+      if (!date) {
+        return true;
+      } else {
+        const time = new Date(date).getTime();
+        const now = Date.now();
+        const deadline = time + this.config.apiCacheSoftExpires;
+        const result = now >= deadline;
+        return result;
+      }
+    }
+    return true;
+  }
+}
+export { DefaultCachePolicy, parseCacheControl };

package/dist/unpkg/prod-deprecated/types/-private.js

@@ -1,6 +1,5 @@
-import { macroCondition, getGlobalConfig } from '@embroider/macros';
 const name = "@warp-drive/core";
-const version = "5.8.0-alpha.37";
+const version = "5.8.0-alpha.40";
 
 // in testing mode, we utilize globals to ensure only one copy exists of
 // these maps, due to bugs in ember-auto-import
@@ -14,37 +13,15 @@ GlobalRef[name] = GlobalRef[name] ?? {
   __version: version
 };
 const GlobalSink = GlobalRef[name];
-if (macroCondition(getGlobalConfig().WarpDrive.env.DEBUG)) {
-  if (GlobalSink.__version !== version) {
-    throw new Error('Multiple versions of WarpDrive detected, the application will malfunction.');
-  }
-}
 const ModuleScopedCaches = GlobalSink.__warpDrive_ModuleScopedCaches ?? {};
-if (macroCondition(getGlobalConfig().WarpDrive.env.TESTING)) {
-  if (!GlobalSink.__warpDrive_ModuleScopedCaches) {
-    GlobalSink.__warpDrive_ModuleScopedCaches = ModuleScopedCaches;
-  } else {
-    // eslint-disable-next-line no-console
-    console.warn(`
-Multiple copies of WarpDrive have been detected. This may be due to a bug in ember-auto-import
-  in which test assets get their own copy of some v2-addons. This can cause the application to
-  malfunction as each copy will maintain its own separate state.`);
-  }
-} else {
+{
   if (GlobalSink.__warpDrive_hasOtherCopy) {
     throw new Error('Multiple copies of WarpDrive detected, the application will malfunction.');
   }
   GlobalSink.__warpDrive_hasOtherCopy = true;
 }
 function getOrSetGlobal(key, value) {
-  if (macroCondition(getGlobalConfig().WarpDrive.env.TESTING)) {
-    const existing = ModuleScopedCaches[key];
-    if (existing === undefined) {
-      return ModuleScopedCaches[key] = value;
-    } else {
-      return existing;
-    }
-  } else {
+  {
     return value;
   }
 }
@@ -57,14 +34,7 @@ function setTransient(key, value) {
   return ModuleScopedCaches[globalKey] = value;
 }
 function getOrSetUniversal(key, value) {
-  if (macroCondition(getGlobalConfig().WarpDrive.env.TESTING)) {
-    const existing = UniversalCache[key];
-    if (existing === undefined) {
-      return UniversalCache[key] = value;
-    } else {
-      return existing;
-    }
-  } else {
+  {
     return value;
   }
 }

package/dist/unpkg/prod-deprecated/types/identifier.js

@@ -1,15 +1,13 @@
-import { macroCondition, getGlobalConfig } from '@embroider/macros';
-
 // provided for additional debuggability
 const DEBUG_CLIENT_ORIGINATED = Symbol('record-originated-on-client');
 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;
+  return str;
 }
 
 // also present in production
-const CACHE_OWNER = ProdSymbol('__$co', 'CACHE_OWNER');
+const CACHE_OWNER = ProdSymbol('__$co');
 
 /**
  * A referentially stable object with a unique string (lid) that can be used

package/dist/unpkg/prod-deprecated/utils/string.js

@@ -1,4 +1,3 @@
-import { macroCondition, getGlobalConfig } from '@embroider/macros';
 const DEFAULT_MAX_CACHE_SIZE = 10_000;
 
 /**
@@ -28,25 +27,14 @@ class LRUCache {
     this.size = size || DEFAULT_MAX_CACHE_SIZE;
     this.state = new Map();
     this.doWork = doWork;
-    if (macroCondition(getGlobalConfig().WarpDrive.env.DEBUG)) {
-      this._hits = 0;
-      this._misses = 0;
-      this._ejected = 0;
-    }
   }
   get(key) {
     const value = this.state.get(key);
     if (value) {
-      if (macroCondition(getGlobalConfig().WarpDrive.env.DEBUG)) {
-        this._hits++;
-      }
       this.state.delete(key);
       this.state.set(key, value);
       return value;
     }
-    if (macroCondition(getGlobalConfig().WarpDrive.env.DEBUG)) {
-      this._misses++;
-    }
     const newValue = this.doWork(key);
     this.set(key, newValue);
     return newValue;
@@ -54,9 +42,6 @@ class LRUCache {
   set(key, value) {
     if (this.state.size === this.size) {
       for (const [k] of this.state) {
-        if (macroCondition(getGlobalConfig().WarpDrive.env.DEBUG)) {
-          this._ejected++;
-        }
         this.state.delete(k);
         break;
       }
@@ -65,11 +50,6 @@ class LRUCache {
   }
   clear() {
     this.state.clear();
-    if (macroCondition(getGlobalConfig().WarpDrive.env.DEBUG)) {
-      this._hits = 0;
-      this._misses = 0;
-      this._ejected = 0;
-    }
   }
 }
 const STRING_DASHERIZE_REGEXP = /[ _]/g;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@warp-drive/core",
-  "version": "5.8.0-alpha.37",
+  "version": "5.8.0-alpha.40",
   "description": "Core package for WarpDrive | All the Universal Basics",
   "keywords": [
     "ember-addon"
@@ -24,14 +24,10 @@
   ],
   "exports": {
     ".": {
-      "unpkg": {
-        "development": {
-          "deprecations": "./dist/unpkg/dev-deprecated/index.js",
-          "default": "./dist/unpkg/dev/index.js"
-        },
-        "deprecations": "./dist/unpkg/prod-deprecated/index.js",
-        "default": "./dist/unpkg/prod/index.js"
-      },
+      "unpkg-dev-deprecated": "./dist/unpkg/dev-deprecated/index.js",
+      "unpkg-dev": "./dist/unpkg/dev/index.js",
+      "unpkg-deprecated": "./dist/unpkg/prod-deprecated/index.js",
+      "unpkg": "./dist/unpkg/prod/index.js",
       "types": "./declarations/index.d.ts",
       "default": "./dist/index.js"
     },
@@ -39,27 +35,23 @@
       "default": "./cjs-dist/*.cjs"
     },
     "./*": {
-      "unpkg": {
-        "development": {
-          "deprecations": "./dist/unpkg/dev-deprecated/*.js",
-          "default": "./dist/unpkg/dev/*.js"
-        },
-        "deprecations": "./dist/unpkg/prod-deprecated/*.js",
-        "default": "./dist/unpkg/prod/*.js"
-      },
+      "unpkg-dev-deprecated": "./dist/unpkg/dev-deprecated/*.js",
+      "unpkg-dev": "./dist/unpkg/dev/*.js",
+      "unpkg-deprecated": "./dist/unpkg/prod-deprecated/*.js",
+      "unpkg": "./dist/unpkg/prod/*.js",
       "types": "./declarations/*.d.ts",
       "default": "./dist/*.js"
     }
   },
   "dependencies": {
     "@embroider/macros": "^1.18.1",
-    "@warp-drive/build-config": "5.8.0-alpha.37"
+    "@warp-drive/build-config": "5.8.0-alpha.40"
   },
   "devDependencies": {
     "@babel/core": "^7.28.3",
     "@babel/plugin-transform-typescript": "^7.28.0",
     "@babel/preset-typescript": "^7.27.1",
-    "@warp-drive/internal-config": "5.8.0-alpha.37",
+    "@warp-drive/internal-config": "5.8.0-alpha.40",
     "decorator-transforms": "^2.3.0",
     "ember-source": "~6.6.0",
     "expect-type": "^1.2.2",

package/dist/unpkg/dev/declarations/build-config/babel-macros.d.ts

@@ -1 +0,0 @@
-export { macros } from "@warp-drive/build-config/babel-macros";

package/dist/unpkg/dev/declarations/build-config/canary-features.d.ts

@@ -1 +0,0 @@
-export * from "@warp-drive/build-config/canary-features";

package/dist/unpkg/dev/declarations/build-config/debugging.d.ts

@@ -1 +0,0 @@
-export * from "@warp-drive/build-config/debugging";

package/dist/unpkg/dev/declarations/build-config/deprecations.d.ts

@@ -1 +0,0 @@
-export * from "@warp-drive/build-config/deprecations";

package/dist/unpkg/dev/declarations/build-config/env.d.ts

@@ -1 +0,0 @@
-export { DEBUG, PRODUCTION, IS_CI, IS_RECORDING, SHOULD_RECORD, TESTING } from "@warp-drive/build-config/env";

package/dist/unpkg/dev/declarations/build-config/macros.d.ts

@@ -1 +0,0 @@
-export { assert } from "@warp-drive/build-config/macros";

package/dist/unpkg/dev/declarations/build-config.d.ts

@@ -1,18 +0,0 @@
-/**
-* This module provides a build-plugin that enables configuration of deprecations,
-* optional features, development/testing support and debug logging.
-*
-* Available settings include:
-*
-* - {@link LOGGING | debugging}
-* - {@link DEPRECATIONS | deprecations}
-* - {@link FEATURES | features}
-* - {@link WarpDriveConfig.polyfillUUID | polyfillUUID}
-* - {@link WarpDriveConfig.includeDataAdapterInProduction | includeDataAdapterInProduction}
-* - {@link WarpDriveConfig.compatWith | compatWith}
-*
-* @module
-*/
-import type { WarpDriveConfig } from "@warp-drive/build-config";
-export { setConfig, babelPlugin } from "@warp-drive/build-config";
-export type { WarpDriveConfig };

package/dist/unpkg/dev/declarations/configure.d.ts

@@ -1,7 +0,0 @@
-/**
-* Provides a configuration API for the reactivity system
-* that WarpDrive should use.
-*
-* @module
-*/
-export { setupSignals, type HooksOptions, type SignalHooks } from "./store/-private/new-core-tmp/reactivity/configure.js";