@warp-drive/core 5.7.0-alpha.26 → 5.7.0-alpha.28

package/declarations/store/-private/store-service.d.ts

@@ -1,6 +1,6 @@
 import type { Graph } from "../../graph/-private.js";
 import type { Future } from "../../request.js";
-import type { RequestManager } from "../../request/-private/manager.js";
+import type { PrivateRequestManager, RequestManager } from "../../request/-private/manager.js";
 import type { Cache } from "../../types/cache.js";
 import type { PersistedResourceKey, ResourceKey } from "../../types/identifier.js";
 import type { TypedRecordInstance, TypeFromInstance } from "../../types/record.js";
@@ -12,9 +12,12 @@ import type { SchemaService } from "../-types/q/schema-service.js";
 import type { StoreRequestInput } from "./cache-handler/handler.js";
 import type { CachePolicy } from "./cache-handler/types.js";
 import { InstanceCache, storeFor } from "./caches/instance-cache.js";
+import type { PrivateCacheKeyManager } from "./managers/cache-key-manager.js";
 import { CacheKeyManager } from "./managers/cache-key-manager.js";
+import type { PrivateNotificationManager } from "./managers/notification-manager.js";
 import NotificationManager from "./managers/notification-manager.js";
-import { RecordArrayManager } from "./managers/record-array-manager.js";
+import type { PrivateRecordArrayManager } from "./managers/record-array-manager.js";
+import type { PrivateRequestStateService } from "./network/request-cache.js";
 import { RequestStateService } from "./network/request-cache.js";
 import type { LegacyLiveArray } from "./record-arrays/legacy-live-array.js";
 export { storeFor };
@@ -147,7 +150,6 @@ export interface Store {
 	* be sourced from directly registered schemas, then will fallback
 	* to sourcing a schema from available models if no schema is found.
 	*
-	* @return {SchemaService}
 	* @public
 	*/
 	createSchemaService(): SchemaService;
@@ -292,8 +294,6 @@ export interface Store {
 * @hideconstructor
 */
 export declare class Store extends BaseClass {
-	/** @internal */
-	readonly recordArrayManager: RecordArrayManager;
 	/**
 	* Provides access to the NotificationManager associated
 	* with this Store instance.
@@ -314,8 +314,6 @@ export declare class Store extends BaseClass {
 	* @public
 	*/
 	get schema(): ReturnType<this["createSchemaService"]>;
-	/** @internal */
-	_schema: SchemaService;
 	/**
 	* Provides access to the CacheKeyManager
 	* for this store.
@@ -380,67 +378,16 @@ export declare class Store extends BaseClass {
 	* @public
 	*/
 	lifetimes?: CachePolicy;
-	// Private
-	/** @internal */
-	_graph?: Graph;
-	/** @internal */
-	_requestCache: RequestStateService;
-	/** @internal */
-	_instanceCache: InstanceCache;
-	/** @internal */
-	_cbs: {
-		coalesce?: () => void;
-		sync?: () => void;
-		notify?: () => void;
-	} | null;
-	/** @internal */
-	_forceShim: boolean;
-	/**
-	* Async flush buffers notifications until flushed
-	* by finalization of a future configured by store.request
-	*
-	* This is useful for ensuring that notifications are delivered
-	* prior to the promise resolving but without risk of promise
-	* interleaving.
-	*
-	* @internal
-	*/
-	_enableAsyncFlush: boolean | null;
-	// DEBUG-only properties
-	/** @internal */
-	DISABLE_WAITER?: boolean;
-	/** @internal */
-	_isDestroying: boolean;
-	/** @internal */
-	_isDestroyed: boolean;
-	/** @internal */
+	/** @private */
 	get isDestroying(): boolean;
-	/** @internal */
-	set isDestroying(value: boolean);
-	/** @internal */
+	/** @private */
 	get isDestroyed(): boolean;
-	/** @internal */
-	set isDestroyed(value: boolean);
 	/** @deprecated use {@link Store.cacheKeyManager} */
 	get identifierCache(): CacheKeyManager;
 	/**
 	@private
 	*/
 	constructor(createArgs?: unknown);
-	/** @internal */
-	_run(cb: () => void): void;
-	/**
-	* Executes the callback, ensurng that any work that calls
-	* store._schedule is executed after in the right order.
-	*
-	* When queues already exist, scheduled callbacks will
-	* join the existing queue.
-	*
-	* @internal
-	*/
-	_join(cb: () => void): void;
-	/** @internal */
-	_schedule(name: "coalesce" | "sync" | "notify", cb: () => void): void;
 	/**
 	* Retrieve the RequestStateService instance
 	* associated with this Store.
@@ -452,10 +399,6 @@ export declare class Store extends BaseClass {
 	* @public
 	*/
 	getRequestStateService(): RequestStateService;
-	/** @internal */
-	_getAllPending(): (Promise<unknown[]> & {
-		length: number;
-	}) | void;
 	/**
 	* ::: tip 💡 For a more complete overview see the [Request Guide](/guides/2-requests/1-overview)
 	* :::
@@ -876,7 +819,7 @@ export declare class Store extends BaseClass {
 	* @public
 	*/
 	get cache(): ReturnType<this["createCache"]>;
-	/** @internal */
+	/** @private */
 	destroy(): void;
 	/**
 	* This method
@@ -885,4 +828,73 @@ export declare class Store extends BaseClass {
 	*/
 	static create(args?: Record<string, unknown>): Store;
 }
+/**
+* This type exists for internal use only for
+* where intimate contracts still exist either for
+* the Test Suite or for Legacy code.
+*
+* @private
+*/
+export interface PrivateStore extends Store {
+	readonly recordArrayManager: PrivateRecordArrayManager;
+	notifications: PrivateNotificationManager;
+	requestManager: PrivateRequestManager;
+	cacheKeyManager: PrivateCacheKeyManager;
+	_schema: SchemaService;
+	_graph?: Graph;
+	_requestCache: PrivateRequestStateService;
+	getRequestStateService(): PrivateRequestStateService;
+	_instanceCache: InstanceCache;
+	_cbs: {
+		coalesce?: () => void;
+		sync?: () => void;
+		notify?: () => void;
+	} | null;
+	_forceShim: boolean;
+	/**
+	* Async flush buffers notifications until flushed
+	* by finalization of a future configured by store.request
+	*
+	* This is useful for ensuring that notifications are delivered
+	* prior to the promise resolving but without risk of promise
+	* interleaving.
+	*/
+	_enableAsyncFlush: boolean | null;
+	/**
+	* Available in DEBUG Only
+	*/
+	DISABLE_WAITER?: boolean;
+	_isDestroying: boolean;
+	_isDestroyed: boolean;
+	isDestroying: boolean;
+	isDestroyed: boolean;
+	_run(cb: () => void): void;
+	/**
+	* Executes the callback, ensurng that any work that calls
+	* store._schedule is executed after in the right order.
+	*
+	* When queues already exist, scheduled callbacks will
+	* join the existing queue.
+	*
+	*/
+	_join(cb: () => void): void;
+	_schedule(name: "coalesce" | "sync" | "notify", cb: () => void): void;
+	_getAllPending(): (Promise<unknown[]> & {
+		length: number;
+	}) | void;
+}
+/**
+* Upgrade the type for Store to PrivateStore, which will also
+* upgrade any associated types to their private equivalents.
+*
+* @private
+*/
+export declare function assertPrivateStore(store: unknown): asserts store is PrivateStore;
+/**
+* Upgrade the type for Store to PrivateStore, which will also
+* upgrade any associated types to their private equivalents.
+*
+* @private
+*/
+export declare function isPrivateStore(store: unknown): PrivateStore;
 export declare function isMaybeIdentifier(maybeIdentifier: string | ResourceIdentifierObject): maybeIdentifier is ResourceIdentifierObject;

package/declarations/store/-private.d.ts

@@ -12,10 +12,13 @@ export type { CreateRecordProperties } from "./-private/store-service.js";
 // to also eliminate
 export { coerceId, ensureStringId } from "./-private/utils/coerce-id.js";
 export type { NativeProxy } from "./-private/record-arrays/native-proxy-type-fix.js";
-export { type ReactiveResourceArray } from "./-private/record-arrays/resource-array.js";
+export { type ReactiveResourceArray, type PrivateReactiveResourceArray } from "./-private/record-arrays/resource-array.js";
 export { type LegacyLiveArray, type LegacyLiveArray as LiveArray } from "./-private/record-arrays/legacy-live-array.js";
 export { type LegacyQueryArray, type LegacyQueryArray as CollectionRecordArray } from "./-private/record-arrays/legacy-query.js";
 export { RecordArrayManager, fastPush } from "./-private/managers/record-array-manager.js";
+// leaked for test/legacy use. You will get in trouble for this.
+export { assertPrivateStore, isPrivateStore, type PrivateStore } from "./-private/store-service.js";
+export { assertPrivateCapabilities, type PrivateCacheCapabilitiesManager } from "./-private/managers/cache-capabilities-manager.js";
 // leaked for private use / test use, should investigate removing
 export { _clearCaches } from "./-private/caches/instance-cache.js";
 // @ember-data/model needs these temporarily

package/declarations/store/-types/q/record-instance.d.ts

@@ -18,6 +18,5 @@ also allows WarpDrive to provide typechecking and intellisense for the record
 based on a special symbol prsent on record instances that implement the
 `TypedRecordInstance` interface.
 
-@internal
 */
 export type OpaqueRecordInstance = unknown;

package/declarations/store/deprecated/-private.d.ts

@@ -64,18 +64,7 @@ addon authors to perform meta-operations on a record.
 @public
 */
 export declare class RecordReference {
-	/** @internal */
-	private store;
-	// unsubscribe token given to us by the notification manager
-	/** @internal */
-	private ___token;
-	/** @internal */
-	private ___identifier;
-	/** @internal */
-	private _ref;
 	constructor(store: Store, identifier: ResourceKey);
-	/** @internal */
-	destroy(): void;
 	get type(): string;
 	/**
 	The `id` of the record that this reference refers to.

package/declarations/types/identifier.d.ts

@@ -17,8 +17,6 @@ export type CacheKeyType = "record" | "document";
 export interface RequestKey {
 	lid: string;
 	type: "@document";
-	/** @internal */
-	[CACHE_OWNER]: number | undefined;
 }
 /** @deprecated use {@link RequestKey} */
 export type StableDocumentIdentifier = RequestKey;
@@ -38,12 +36,6 @@ interface ResourceKeyBase<T extends string = string> {
 	* @public
 	*/
 	type: T;
-	/** @internal */
-	[CACHE_OWNER]: number | undefined;
-	/** @internal */
-	[DEBUG_CLIENT_ORIGINATED]?: boolean;
-	/** @internal */
-	[DEBUG_STALE_CACHE_OWNER]?: number | undefined;
 }
 /**
 * Used when a ResourceKey was not created locally as part

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;
 }
@@ -98,7 +97,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 +134,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/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,
@@ -43,6 +43,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-CiFDHArV.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');

package/dist/configure.js

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

package/dist/{context-DbdT1mON.js → context-Bh-MA_tH.js}

@@ -639,19 +639,18 @@ class ContextOwner {
   }
 }
 class Context {
-  #owner;
   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 => {
@@ -659,10 +658,10 @@ 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;
   }
   _finalize() {
     this._finalized = true;

package/dist/graph/-private.js

@@ -337,9 +337,7 @@ function temporaryConvertToLegacy(field) {
  * }
  * ```
  *
- *
- * @class UpgradedMeta
- * @internal
+ * @private
  */
 
 const BOOL_LATER = null;
@@ -2211,8 +2209,7 @@ function createImplicitEdge(definition, identifier) {
 /**
  * Stores the data for one side of a "single" resource relationship.
  *
- * @class ResourceEdge
- * @internal
+ * @private
  */
 
 function createResourceEdge(definition, identifier) {

package/dist/index.js

@@ -1,10 +1,10 @@
 import { setLogging, getRuntimeConfig } 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 "./context-DbdT1mON.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 "./context-Bh-MA_tH.js";
 import { macroCondition, getGlobalConfig } from '@embroider/macros';
-import { w as waitFor } from "./configure-B48bFHOl.js";
+import { w as waitFor } from "./configure-CiFDHArV.js";
 import { peekUniversalTransient, setUniversalTransient } from './types/-private.js';
 import { EnableHydration } from './types/request.js';
-export { C as CacheHandler, S as Store, r as recordIdentifierFor, N as setIdentifierForgetMethod, L as setIdentifierGenerationMethod, O as setIdentifierResetMethod, M as setIdentifierUpdateMethod, P as setKeyInfoForResource, s as storeFor } from "./request-state-CqVrgUM0.js";
+export { C as CacheHandler, S as Store, r as recordIdentifierFor, Q as setIdentifierForgetMethod, O as setIdentifierGenerationMethod, T as setIdentifierResetMethod, P as setIdentifierUpdateMethod, U as setKeyInfoForResource, s as storeFor } from "./request-state-B908BvPK.js";
 import '@ember/debug';
 import './utils/string.js';
 import "./symbols-sql1_mdx.js";
@@ -189,7 +189,7 @@ function isDict(v) {
 }
 class RequestManager {
   /** @internal */
-  #handlers = [];
+
   /** @internal */
 
   /**
@@ -207,6 +207,7 @@ class RequestManager {
     Object.assign(this, options);
     this._pending = new Map();
     this._deduped = new Map();
+    this._handlers = [];
   }
 
   /**
@@ -223,13 +224,13 @@ class RequestManager {
       if (this._hasCacheHandler) {
         throw new Error(`\`RequestManager.useCache(<handler>)\` May only be invoked once.`);
       }
-      if (Object.isFrozen(this.#handlers)) {
+      if (Object.isFrozen(this._handlers)) {
         throw new Error(`\`RequestManager.useCache(<handler>)\` May only be invoked prior to any request having been made.`);
       }
       this._hasCacheHandler = true;
     }
     cacheHandler[IS_CACHE_HANDLER] = true;
-    this.#handlers.unshift(cacheHandler);
+    this._handlers.unshift(cacheHandler);
     return this;
   }
 
@@ -243,7 +244,7 @@ class RequestManager {
    * @public
    */
   use(newHandlers) {
-    const handlers = this.#handlers;
+    const handlers = this._handlers;
     if (macroCondition(getGlobalConfig().WarpDrive.env.DEBUG)) {
       if (Object.isFrozen(handlers)) {
         throw new Error(`Cannot add a Handler to a RequestManager after a request has been made`);
@@ -269,7 +270,7 @@ class RequestManager {
    * @public
    */
   request(request) {
-    const handlers = this.#handlers;
+    const handlers = this._handlers;
     if (macroCondition(getGlobalConfig().WarpDrive.env.DEBUG)) {
       if (!Object.isFrozen(handlers)) {
         Object.freeze(handlers);
@@ -362,6 +363,14 @@ class RequestManager {
   }
 }
 
+/**
+ * This type exists for internal use only for
+ * where intimate contracts still exist either for
+ * the Test Suite or for Legacy code.
+ *
+ * @private
+ */
+
 /**
  * @module
  * @mergeModuleWith <project>

package/dist/reactive.js

@@ -1,5 +1,5 @@
-import { G as ReactiveResource, H as isNonIdentityCacheableField, I as getFieldCacheKeyStrict, r as recordIdentifierFor, A as withSignalStore } from "./request-state-CqVrgUM0.js";
-export { J as checkout, K as commit } from "./request-state-CqVrgUM0.js";
+import { J as ReactiveResource, K as isNonIdentityCacheableField, L as getFieldCacheKeyStrict, r as recordIdentifierFor, F as withSignalStore } from "./request-state-B908BvPK.js";
+export { M as checkout, N as commit } from "./request-state-B908BvPK.js";
 import { isResourceSchema } from './types/schema/fields.js';
 import { D as Destroy, C as Context } from "./symbols-sql1_mdx.js";
 export { a as Checkout } from "./symbols-sql1_mdx.js";
@@ -8,7 +8,7 @@ import { warn, deprecate } from '@ember/debug';
 import './index.js';
 import './types/request.js';
 import './utils/string.js';
-import { c as createMemo } from "./configure-B48bFHOl.js";
+import { c as createMemo } from "./configure-CiFDHArV.js";
 import { getOrSetGlobal } from './types/-private.js';
 import { Type } from './types/symbols.js';
 function instantiateRecord(store, identifier, createArgs) {
@@ -295,7 +295,6 @@ fromIdentity[Type] = '@identity';
  * ```
  *
  * @public
- * @param {SchemaService} schema
  */
 function registerDerivations(schema) {
   schema.registerDerivation(fromIdentity);
@@ -325,7 +324,6 @@ function makeCachedDerivation(derivation) {
 /**
  * A SchemaService designed to work with dynamically registered schemas.
  *
- * @class SchemaService
  * @public
  */
 class SchemaService {
@@ -344,6 +342,8 @@ class SchemaService {
 
   /** @internal */
 
+  /** @internal */
+
   constructor() {
     this._schemas = new Map();
     this._transforms = new Map();