@warp-drive-mirror/json-api 5.7.0-alpha.27 → 5.7.0-alpha.29

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

@@ -1,34 +1,15 @@
-import type { Graph } from "@warp-drive-mirror/core/graph/-private";
 import type { CacheCapabilitiesManager } from "@warp-drive-mirror/core/types";
 import type { Cache, ChangedAttributesHash, RelationshipDiff } from "@warp-drive-mirror/core/types/cache";
 import type { Change } from "@warp-drive-mirror/core/types/cache/change";
 import type { Operation } from "@warp-drive-mirror/core/types/cache/operations";
 import type { CollectionRelationship, ResourceRelationship } from "@warp-drive-mirror/core/types/cache/relationship";
 import type { LocalRelationshipOperation } from "@warp-drive-mirror/core/types/graph";
-import type { PersistedResourceKey, RequestKey, ResourceKey } from "@warp-drive-mirror/core/types/identifier";
+import type { RequestKey, ResourceKey } from "@warp-drive-mirror/core/types/identifier";
 import type { Value } from "@warp-drive-mirror/core/types/json/raw";
 import type { RequestContext, StructuredDataDocument, StructuredDocument, StructuredErrorDocument } from "@warp-drive-mirror/core/types/request";
 import type { CollectionResourceDataDocument, ResourceDocument, ResourceErrorDocument, ResourceMetaDocument, SingleResourceDataDocument } from "@warp-drive-mirror/core/types/spec/document";
 import type { ApiError } from "@warp-drive-mirror/core/types/spec/error";
 import type { CollectionResourceDocument, ExistingResourceObject, ResourceObject, SingleResourceDocument } from "@warp-drive-mirror/core/types/spec/json-api-raw";
-interface CachedResource {
-	id: string | null;
-	remoteAttrs: Record<string, Value | undefined> | null;
-	localAttrs: Record<string, Value | undefined> | null;
-	defaultAttrs: Record<string, Value | undefined> | null;
-	inflightAttrs: Record<string, Value | undefined> | null;
-	changes: Record<string, [Value | undefined, Value]> | null;
-	errors: ApiError[] | null;
-	isNew: boolean;
-	isDeleted: boolean;
-	isDeletionCommitted: boolean;
-	/**
-	* debugging only
-	*
-	* @internal
-	*/
-	inflightRelationships?: Record<string, unknown> | null;
-}
 /**
 * ### JSONAPICache
 *
@@ -128,16 +109,6 @@ export declare class JSONAPICache implements Cache {
 	* @public
 	*/
 	version: "2";
-	/** @internal */
-	_capabilities: CacheCapabilitiesManager;
-	/** @internal */
-	__cache: Map<ResourceKey, CachedResource>;
-	/** @internal */
-	__destroyedCache: Map<ResourceKey, CachedResource>;
-	/** @internal */
-	__documents: Map<string, StructuredDocument<ResourceDocument>>;
-	/** @internal */
-	__graph: Graph;
 	constructor(capabilities: CacheCapabilitiesManager);
 	////////// ================ //////////
 	////////// Cache Management //////////
@@ -183,11 +154,6 @@ export declare class JSONAPICache implements Cache {
 	put<T extends CollectionResourceDocument>(doc: StructuredDataDocument<T>): CollectionResourceDataDocument;
 	put<T extends ResourceErrorDocument>(doc: StructuredErrorDocument<T>): ResourceErrorDocument;
 	put<T extends ResourceMetaDocument>(doc: StructuredDataDocument<T>): ResourceMetaDocument;
-	/** @internal */
-	_putDocument<T extends ResourceErrorDocument>(doc: StructuredErrorDocument<T>, data: undefined, included: undefined): ResourceErrorDocument;
-	_putDocument<T extends ResourceMetaDocument>(doc: StructuredDataDocument<T>, data: undefined, included: undefined): ResourceMetaDocument;
-	_putDocument<T extends SingleResourceDocument>(doc: StructuredDataDocument<T>, data: PersistedResourceKey | null, included: PersistedResourceKey[] | undefined): SingleResourceDataDocument;
-	_putDocument<T extends CollectionResourceDocument>(doc: StructuredDataDocument<T>, data: PersistedResourceKey[], included: PersistedResourceKey[] | undefined): CollectionResourceDataDocument;
 	/**
 	* Update the "remote" or "canonical" (persisted) state of the Cache
 	* by merging new information into the existing state.
@@ -275,7 +241,7 @@ export declare class JSONAPICache implements Cache {
 	* utilize this method to fork the cache.
 	*
 	* @category Cache Forking
-	* @internal
+	* @private
 	*/
 	fork(): Promise<Cache>;
 	/**
@@ -286,7 +252,7 @@ export declare class JSONAPICache implements Cache {
 	* utilize this method to merge the caches.
 	*
 	* @category Cache Forking
-	* @internal
+	* @private
 	*/
 	merge(_cache: Cache): Promise<void>;
 	/**
@@ -320,7 +286,7 @@ export declare class JSONAPICache implements Cache {
 	* ```
 	*
 	* @category Cache Forking
-	* @internal
+	* @private
 	*/
 	diff(): Promise<Change[]>;
 	////////// =========== //////////
@@ -332,7 +298,7 @@ export declare class JSONAPICache implements Cache {
 	* via `cache.hydrate`.
 	*
 	* @category SSR Support
-	* @internal
+	* @private
 	*/
 	dump(): Promise<ReadableStream<unknown>>;
 	/**
@@ -348,7 +314,7 @@ export declare class JSONAPICache implements Cache {
 	* via data-only SSR modes.
 	*
 	* @category SSR Support
-	* @internal
+	* @private
 	*/
 	hydrate(stream: ReadableStream<unknown>): Promise<void>;
 	////////// ================== //////////
@@ -562,25 +528,4 @@ export declare class JSONAPICache implements Cache {
 	* @public
 	*/
 	isDeletionCommitted(identifier: ResourceKey): boolean;
-	/**
-	* Private method used to populate an entry for the identifier
-	*
-	* @internal
-	*/
-	_createCache(identifier: ResourceKey): CachedResource;
-	/**
-	* Peek whether we have cached resource data matching the identifier
-	* without asserting if the resource data is missing.
-	*
-	* @internal
-	*/
-	__safePeek(identifier: ResourceKey, allowDestroyed: boolean): CachedResource | undefined;
-	/**
-	* Peek whether we have cached resource data matching the identifier
-	* Asserts if the resource data is missing.
-	*
-	* @internal
-	*/
-	__peek(identifier: ResourceKey, allowDestroyed: boolean): CachedResource;
 }
-export {};

package/declarations/-private/validator/1.1/7.1_top-level-document-members.d.ts

@@ -1,12 +1 @@
-import type { ResourceDocument } from "@warp-drive-mirror/core/types/spec/document";
-import { type Reporter } from "../utils.js";
-/**
-* Reports issues which violate the JSON:API spec for top-level members.
-*
-* Version: 1.1
-* Section: 7.1
-* Link: https://jsonapi.org/format/#document-top-level
-*
-* @internal
-*/
-export declare function validateTopLevelDocumentMembers(reporter: Reporter, doc: ResourceDocument): void;
+export {};

package/declarations/-private/validator/1.1/7.2_resource-objects.d.ts

@@ -1,13 +1 @@
-import type { ResourceDocument } from "@warp-drive-mirror/core/types/spec/document";
-import { type Reporter } from "../utils.js";
-/**
-* Validates the resource objects in either the `data` or `included` members of
-* JSON:API document.
-*
-* Version: 1.1
-* Section: 7.2
-* Link: https://jsonapi.org/format/#document-resource-objects
-*
-* @internal
-*/
-export declare function validateDocumentResources(reporter: Reporter, doc: ResourceDocument): void;
+export {};

package/declarations/-private/validator/1.1/links.d.ts

@@ -1,23 +1 @@
-import type { ResourceDocument } from "@warp-drive-mirror/core/types/spec/document";
-import type { CollectionResourceRelationship, ResourceObject, SingleResourceRelationship } from "@warp-drive-mirror/core/types/spec/json-api-raw";
-import { type PathLike, type Reporter } from "../utils.js";
-/**
-* Validates the links object in a top-level JSON API document or resource object
-*
-* Version: 1.1
-*
-* Section: 7.1 Top Level
-* Link: https://jsonapi.org/format/#document-top-level
-*
-* Section: 7.2.3 Resource Objects
-* Link: https://jsonapi.org/format/#document-resource-object-links
-*
-* Section: 7.2.2.2 Resource Relationships
-* Link: https://jsonapi.org/format/#document-resource-object-relationships
-*
-* Section: 7.6 Document Links
-* Link: https://jsonapi.org/format/#document-links
-*
-* @internal
-*/
-export declare function validateLinks(reporter: Reporter, doc: ResourceDocument | ResourceObject | SingleResourceRelationship | CollectionResourceRelationship, type: "collection-document" | "resource-document" | "resource" | "resource-relationship" | "collection-relationship", path?: PathLike): void;
+export {};

package/dist/index.js

@@ -1,5 +1,5 @@
 import { graphFor, peekGraph, isBelongsTo } from '@warp-drive-mirror/core/graph/-private';
-import { logGroup, isResourceKey, isRequestKey } from '@warp-drive-mirror/core/store/-private';
+import { logGroup, isResourceKey, assertPrivateCapabilities, isRequestKey } from '@warp-drive-mirror/core/store/-private';
 import Fuse from 'fuse.js';
 import jsonToAst from 'json-to-ast';
 import { macroCondition, getGlobalConfig } from '@embroider/macros';
@@ -927,7 +927,6 @@ function validateResourceDocument(reporter, doc) {
 function isImplicit(relationship) {
   return relationship.definition.isImplicit;
 }
-function upgradeCapabilities(obj) {}
 const EMPTY_ITERATOR = {
   iterator() {
     return {
@@ -1201,6 +1200,13 @@ class JSONAPICache {
 
   /** @internal */
 
+  /** @internal */
+
+  /** @internal */
+
+  /** @internal */
+
+  /** @internal */
   _putDocument(doc, data, included) {
     // @ts-expect-error narrowing within is just horrible  in TS :/
     const resourceDocument = isErrorDocument(doc) ? fromStructuredError(doc) : fromBaseDocument(doc);
@@ -1271,7 +1277,7 @@ class JSONAPICache {
           logGroup('cache', 'patch', '<BATCH>', String(op.length) + ' operations', '', '');
         }
       }
-      upgradeCapabilities(this._capabilities);
+      assertPrivateCapabilities(this._capabilities);
       this._capabilities._store._join(() => {
         for (const operation of op) {
           patchCache(this, operation);
@@ -1372,7 +1378,7 @@ class JSONAPICache {
           }
         });
       }
-      upgradeCapabilities(this._capabilities);
+      assertPrivateCapabilities(this._capabilities);
       const store = this._capabilities._store;
       const attrs = getCacheFields(this, identifier);
       attrs.forEach((attr, key) => {
@@ -1430,7 +1436,7 @@ class JSONAPICache {
           }
         });
       }
-      upgradeCapabilities(this._capabilities);
+      assertPrivateCapabilities(this._capabilities);
       const store = this._capabilities._store;
       const attrs = getCacheFields(this, identifier);
       attrs.forEach((attr, key) => {
@@ -1480,7 +1486,7 @@ class JSONAPICache {
    * @return if `calculateChanges` is true then calculated key changes should be returned
    */
   upsert(identifier, data, calculateChanges) {
-    upgradeCapabilities(this._capabilities);
+    assertPrivateCapabilities(this._capabilities);
     const store = this._capabilities._store;
     if (!store._cbs) {
       let result = undefined;
@@ -1504,7 +1510,7 @@ class JSONAPICache {
    * utilize this method to fork the cache.
    *
    * @category Cache Forking
-   * @internal
+   * @private
    */
   fork() {
     throw new Error(`Not Implemented`);
@@ -1518,7 +1524,7 @@ class JSONAPICache {
    * utilize this method to merge the caches.
    *
    * @category Cache Forking
-   * @internal
+   * @private
    */
   merge(_cache) {
     throw new Error(`Not Implemented`);
@@ -1555,7 +1561,7 @@ class JSONAPICache {
    * ```
    *
    * @category Cache Forking
-   * @internal
+   * @private
    */
   diff() {
     throw new Error(`Not Implemented`);
@@ -1571,7 +1577,7 @@ class JSONAPICache {
    * via `cache.hydrate`.
    *
    * @category SSR Support
-   * @internal
+   * @private
    */
   dump() {
     throw new Error(`Not Implemented`);
@@ -1590,7 +1596,7 @@ class JSONAPICache {
    * via data-only SSR modes.
    *
    * @category SSR Support
-   * @internal
+   * @private
    */
   hydrate(stream) {
     throw new Error('Not Implemented');
@@ -1994,7 +2000,7 @@ class JSONAPICache {
         return cached.defaultAttrs[attribute];
       } else {
         const attrSchema = getCacheFields(this, identifier).get(attribute);
-        upgradeCapabilities(this._capabilities);
+        assertPrivateCapabilities(this._capabilities);
         const defaultValue = getDefaultValue(attrSchema, identifier, this._capabilities._store);
         if (schemaHasLegacyDefaultValueFn(attrSchema)) {
           cached.defaultAttrs = cached.defaultAttrs || Object.create(null);
@@ -2061,7 +2067,7 @@ class JSONAPICache {
         return cached.defaultAttrs[attribute];
       } else {
         const attrSchema = getCacheFields(this, identifier).get(attribute);
-        upgradeCapabilities(this._capabilities);
+        assertPrivateCapabilities(this._capabilities);
         const defaultValue = getDefaultValue(attrSchema, identifier, this._capabilities._store);
         if (schemaHasLegacyDefaultValueFn(attrSchema)) {
           cached.defaultAttrs = cached.defaultAttrs || Object.create(null);
@@ -2323,7 +2329,7 @@ class JSONAPICache {
    * @return the names of relationships that were restored
    */
   rollbackRelationships(identifier) {
-    upgradeCapabilities(this._capabilities);
+    assertPrivateCapabilities(this._capabilities);
     let result;
     this._capabilities._store._join(() => {
       result = this.__graph.rollback(identifier);
@@ -2821,6 +2827,7 @@ function recordIsLoaded(cached, filterDeleted = false) {
   return filterDeleted && cached.isDeletionCommitted ? false : !isEmpty;
 }
 function _isLoading(peeked, capabilities, identifier) {
+  assertPrivateCapabilities(capabilities);
   // TODO refactor things such that the cache is not required to know
   // about isLoading
   const req = capabilities._store.getRequestStateService();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@warp-drive-mirror/json-api",
-  "version": "5.7.0-alpha.27",
+  "version": "5.7.0-alpha.29",
   "description": "A {JSON:API} Cache Implementation for WarpDrive",
   "keywords": [
     "ember-addon"
@@ -32,7 +32,7 @@
     }
   },
   "peerDependencies": {
-    "@warp-drive-mirror/core": "5.7.0-alpha.27"
+    "@warp-drive-mirror/core": "5.7.0-alpha.29"
   },
   "dependencies": {
     "@embroider/macros": "^1.16.12",
@@ -44,8 +44,8 @@
     "@babel/plugin-transform-typescript": "^7.27.0",
     "@babel/preset-typescript": "^7.27.0",
     "@types/json-to-ast": "^2.1.4",
-    "@warp-drive/internal-config": "5.7.0-alpha.27",
-    "@warp-drive-mirror/core": "5.7.0-alpha.27",
+    "@warp-drive/internal-config": "5.7.0-alpha.29",
+    "@warp-drive-mirror/core": "5.7.0-alpha.29",
     "decorator-transforms": "^2.3.0",
     "expect-type": "^1.2.1",
     "typescript": "^5.8.3",