@warp-drive/core 5.7.0-alpha.9 → 5.7.0-beta.0

package/declarations/types/spec/json-api-raw.d.ts

@@ -23,7 +23,8 @@ export interface PaginationLinks extends Links {
 * to address data that may not be available synchronously.
 *
 * [JSON:API Spec](https://jsonapi.org/format/#document-resource-identifier-objects)
-* @internal
+*
+* @private
 */
 export interface ExistingResourceIdentifierObject<T extends string = string> {
 	id: string;
@@ -42,7 +43,7 @@ export interface ExistingResourceIdentifierObject<T extends string = string> {
 	* is `lid` considered optional.
 	*
 	* [Identifiers RFC](https://github.com/emberjs/rfcs/blob/main/text/0403-ember-data-identifiers.md#ember-data--identifiers)
-	* @internal
+	*
 	*/
 	lid?: string;
 	/**
@@ -50,7 +51,7 @@ export interface ExistingResourceIdentifierObject<T extends string = string> {
 	* `ember-data` ignores `meta` on `ResourceIdentifierObjects`
 	*
 	* @ignored this property goes un-utilized and will be lost
-	* @internal
+	* @private
 	*/
 	meta?: Meta;
 }
@@ -58,7 +59,7 @@ export interface ExistingResourceIdentifierObject<T extends string = string> {
 * Serves as a reference to a resource created on the client
 * but not yet persisted.
 *
-* @internal
+* @private
 */
 export interface NewResourceIdentifierObject<T extends string = string> {
 	/**
@@ -68,14 +69,12 @@ export interface NewResourceIdentifierObject<T extends string = string> {
 	*
 	* `id` will be `null` in this case.
 	*
-	* @internal
 	*/
 	id: string | null;
 	type: T;
 	/**
 	* Resources newly created on the client _will always_
 	* have an `lid` assigned immediately and available.
-	* @internal
 	*/
 	lid: string;
 }
@@ -83,7 +82,6 @@ export interface ResourceIdentifier {
 	lid: string;
 }
 export type ResourceIdentifierObject<T extends string = string> = ResourceIdentifier | ExistingResourceIdentifierObject<T> | NewResourceIdentifierObject<T>;
-// TODO disallow NewResource, make narrowable
 export interface SingleResourceRelationship<T = ExistingResourceIdentifierObject | NewResourceIdentifierObject> {
 	data?: T | null;
 	meta?: Meta;
@@ -98,7 +96,6 @@ export type InnerRelationshipDocument<T = ExistingResourceIdentifierObject | New
 export type ResourceRelationshipsObject<T = ExistingResourceIdentifierObject | NewResourceIdentifierObject> = Record<string, InnerRelationshipDocument<T>>;
 /**
 * Contains the data for an existing resource in JSON:API format
-* @internal
 */
 export interface ExistingResourceObject<T extends string = string> extends ExistingResourceIdentifierObject<T> {
 	meta?: Meta;
@@ -136,7 +133,7 @@ export type CollectionResourceDocument<T extends string = string> = Document & {
 * These documents should follow the JSON:API spec but do not
 * have the same level of guarantees as their `spec` counterparts.
 *
-* @internal
+* @private
 */
 export type JsonApiDocument<T extends string = string> = EmptyResourceDocument | SingleResourceDocument<T> | CollectionResourceDocument<T>;
 export {};

package/declarations/types.d.ts

@@ -6,7 +6,6 @@
 */
 export type { StableRecordIdentifier, ResourceKey } from "./types/identifier.js";
 export type { CacheCapabilitiesManager } from "./store/-types/q/cache-capabilities-manager.js";
-// FIXME this should come from somewhere more intelligent
 export type { ModelSchema } from "./store/deprecated/-private.js";
 export type { SchemaService } from "./store/-types/q/schema-service.js";
 export type { BaseFinderOptions, FindRecordOptions, LegacyResourceQuery, QueryOptions, FindAllOptions } from "./store/-types/q/store.js";

package/declarations/utils/string.d.ts

@@ -16,7 +16,7 @@
 * and by `@warp-drive/utilities/string`. It is not intended
 * for use outside of these modules at this time.
 *
-* @internal
+* @private
 */
 export declare class LRUCache<
 	T,
@@ -25,7 +25,6 @@ export declare class LRUCache<
 	size: number;
 	state: Map<T, V>;
 	doWork: (k: T) => V;
-	// debug stats
 	_hits: number;
 	_misses: number;
 	_ejected: number;
@@ -43,6 +42,6 @@ export declare const STRING_DASHERIZE_CACHE: LRUCache<string, string>;
 * 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
 */
 export declare function dasherize(str: string): string;

package/dist/{configure-B48bFHOl.js → configure-C3x8YXzL.js}

@@ -39,7 +39,7 @@ const OBJECT_SIGNAL = getOrSetGlobal('#{}', Symbol('#{}'));
  *
  * It may be an array of signals or a single signal.
  *
- * @internal
+ * @private
  */
 
 /**
@@ -112,7 +112,7 @@ function setupSignals(buildConfig) {
 /**
  * Internal method for consuming the configured `createSignal` hook
  *
- * @internal
+ * @private
  */
 function createSignal(obj, key) {
   const signalHooks = peekTransient('signalHooks');
@@ -127,7 +127,7 @@ function createSignal(obj, key) {
 /**
  * Internal method for consuming the configured `consumeSignal` hook
  *
- * @internal
+ * @private
  */
 function consumeSignal(signal) {
   const signalHooks = peekTransient('signalHooks');
@@ -142,7 +142,7 @@ function consumeSignal(signal) {
 /**
  * Internal method for consuming the configured `notifySignal` hook
  *
- * @internal
+ * @private
  */
 function notifySignal(signal) {
   const signalHooks = peekTransient('signalHooks');
@@ -178,4 +178,4 @@ function waitFor(promise) {
   }
   return promise;
 }
-export { ARRAY_SIGNAL as A, OBJECT_SIGNAL as O, createSignal as a, consumeSignal as b, createMemo as c, willSyncFlushWatchers as d, notifySignal as n, setupSignals as s, waitFor as w };
+export { ARRAY_SIGNAL as A, OBJECT_SIGNAL as O, consumeSignal as a, createMemo as b, createSignal as c, willSyncFlushWatchers as d, notifySignal as n, setupSignals as s, waitFor as w };

package/dist/configure.js

@@ -1 +1 @@
-export { s as setupSignals } from "./configure-B48bFHOl.js";
+export { s as setupSignals } from "./configure-C3x8YXzL.js";

package/dist/{context-COmAnXUQ.js → context-C_7OLieY.js}

@@ -306,6 +306,19 @@ function ensureDoc(owner, content, isError) {
     content: content
   };
 }
+
+/**
+ * Additional properties exposed on errors thrown by the
+ * {@link Fetch | Fetch Handler}.
+ *
+ * In the case of an Abort or system/browser level issue,
+ * this extends {@link DOMException}.
+ *
+ * Else it extends from {@link AggregateError} if the
+ * response includes an array of errors, falling back
+ * to {@link Error} as its base.
+ */
+
 function enhanceReason(reason) {
   return new DOMException(reason || 'The user aborted a request.', 'AbortError');
 }
@@ -437,6 +450,17 @@ function upgradePromise(promise, future) {
   promise.onFinalize = future.onFinalize;
   promise.id = future.id;
   promise.lid = future.lid;
+  promise.requester = future.requester;
+  if (macroCondition(getGlobalConfig().WarpDrive.env.DEBUG)) {
+    // @ts-expect-error
+    promise.toJSON = () => {
+      const id = 'Future<' + promise.id + '>';
+      if (promise.lid) {
+        return `${id} (${promise.lid.lid})`;
+      }
+      return id;
+    };
+  }
   return promise;
 }
 function createFuture(owner) {
@@ -464,6 +488,17 @@ function createFuture(owner) {
   };
   promise.id = owner.requestId;
   promise.lid = owner.god.identifier;
+  promise.requester = owner.god.requester;
+  if (macroCondition(getGlobalConfig().WarpDrive.env.DEBUG)) {
+    // @ts-expect-error
+    promise.toJSON = () => {
+      const id = 'Future<' + promise.id + '>';
+      if (promise.lid) {
+        return `${id} (${promise.lid.lid})`;
+      }
+      return id;
+    };
+  }
   deferred.promise = promise;
   return deferred;
 }
@@ -604,19 +639,24 @@ class ContextOwner {
   }
 }
 class Context {
-  #owner;
+  /** @internal */
+
+  /** @internal */
+
+  /** @internal */
+
   constructor(owner, isCacheHandler) {
     this.id = owner.requestId;
-    this.#owner = owner;
+    this.___owner = owner;
     this.request = owner.enhancedRequest;
     this._isCacheHandler = isCacheHandler;
     this._finalized = false;
   }
   setStream(stream) {
-    this.#owner.setStream(stream);
+    this.___owner.setStream(stream);
   }
   setResponse(response) {
-    this.#owner.setResponse(response);
+    this.___owner.setResponse(response);
   }
   setIdentifier(identifier) {
     macroCondition(getGlobalConfig().WarpDrive.env.DEBUG) ? (test => {
@@ -624,11 +664,13 @@ class Context {
         throw new Error(`setIdentifier may only be used synchronously from a CacheHandler`);
       }
     })(identifier && this._isCacheHandler && !this._finalized) : {};
-    this.#owner.god.identifier = identifier;
+    this.___owner.god.identifier = identifier;
   }
   get hasRequestedStream() {
-    return this.#owner.hasRequestedStream;
+    return this.___owner.hasRequestedStream;
   }
+
+  /** @private */
   _finalize() {
     this._finalized = true;
   }