@ember-data/store 5.4.0-alpha.30 → 5.4.0-alpha.32

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ember-data/store",
-  "version": "5.4.0-alpha.30",
+  "version": "5.4.0-alpha.32",
   "description": "The core of EmberData. Provides the Store service which coordinates the cache with the network and presentation layers.",
   "keywords": [
     "ember-addon"
@@ -13,6 +13,7 @@
   "license": "MIT",
   "author": "Chris Thoburn <runspired@users.noreply.github.com>",
   "files": [
+    "unstable-preview-types",
     "addon-main.js",
     "addon",
     "README.md",
@@ -21,7 +22,7 @@
     "ember-data-logo-light.svg"
   ],
   "dependencies": {
-    "@ember-data/private-build-infra": "5.4.0-alpha.30",
+    "@ember-data/private-build-infra": "5.4.0-alpha.32",
     "@embroider/macros": "^1.13.5",
     "ember-cli-babel": "^8.2.0",
     "pnpm-sync-dependencies-meta-injected": "0.0.10"
@@ -44,10 +45,10 @@
     }
   },
   "peerDependencies": {
-    "@ember-data/request": "5.4.0-alpha.30",
-    "@ember-data/tracking": "5.4.0-alpha.30",
+    "@ember-data/request": "5.4.0-alpha.32",
+    "@ember-data/tracking": "5.4.0-alpha.32",
     "@ember/string": "^3.1.1",
-    "@warp-drive/core-types": "0.0.0-alpha.16"
+    "@warp-drive/core-types": "0.0.0-alpha.18"
   },
   "devDependencies": {
     "@babel/cli": "^7.23.9",
@@ -60,15 +61,15 @@
     "@babel/preset-env": "^7.23.9",
     "@babel/preset-typescript": "^7.23.3",
     "@babel/runtime": "^7.23.9",
-    "@ember-data/request": "5.4.0-alpha.30",
-    "@ember-data/tracking": "5.4.0-alpha.30",
+    "@ember-data/request": "5.4.0-alpha.32",
+    "@ember-data/tracking": "5.4.0-alpha.32",
     "@ember/string": "^3.1.1",
     "@embroider/addon-dev": "^4.1.2",
     "@glimmer/component": "^1.1.2",
     "@rollup/plugin-babel": "^6.0.4",
     "@rollup/plugin-node-resolve": "^15.2.3",
-    "@warp-drive/core-types": "0.0.0-alpha.16",
-    "@warp-drive/internal-config": "5.4.0-alpha.30",
+    "@warp-drive/core-types": "0.0.0-alpha.18",
+    "@warp-drive/internal-config": "5.4.0-alpha.32",
     "ember-source": "~5.6.0",
     "rollup": "^4.9.6",
     "typescript": "^5.3.3",
@@ -93,7 +94,7 @@
   "scripts": {
     "lint": "eslint . --quiet --cache --cache-strategy=content --ext .js,.ts,.mjs,.cjs --report-unused-disable-directives",
     "build:runtime": "rollup --config && babel ./addon --out-dir addon --plugins=../private-build-infra/src/transforms/babel-plugin-transform-ext.js",
-    "build:types": "echo \"Types are private\" && exit 0",
+    "build:types": "tsc --build",
     "_build": "bun run build:runtime && bun run build:types",
     "_syncPnpm": "bun run sync-dependencies-meta-injected"
   }

package/unstable-preview-types/-private/cache-handler.d.ts

@@ -0,0 +1,99 @@
+import type { Handler } from '@ember-data/request/-private/types';
+import type { StableDocumentIdentifier } from '@warp-drive/core-types/identifier';
+import type { ImmutableRequestInfo, RequestContext, ResponseInfo } from '@warp-drive/core-types/request';
+import { EnableHydration } from '@warp-drive/core-types/request';
+import type { ResourceIdentifierObject } from '@warp-drive/core-types/spec/raw';
+import type Store from './store-service';
+/**
+ * A service which an application may provide to the store via
+ * the store's `lifetimes` property to configure the behavior
+ * of the CacheHandler.
+ *
+ * The default behavior for request lifetimes is to never expire
+ * unless manually refreshed via `cacheOptions.reload` or `cacheOptions.backgroundReload`.
+ *
+ * Implementing this service allows you to programatically define
+ * when a request should be considered expired.
+ *
+ * @class <Interface> LifetimesService
+ * @public
+ */
+export interface LifetimesService {
+    /**
+     * Invoked to determine if the request may be fulfilled from cache
+     * if possible.
+     *
+     * Note, this is only invoked 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.
+     *
+     * @method isHardExpired
+     * @public
+     * @param {StableDocumentIdentifier} identifier
+     * @param {Store} store
+     * @return {boolean} true if the request is considered hard expired
+     */
+    isHardExpired(identifier: StableDocumentIdentifier, store: Store): boolean;
+    /**
+     * 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 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.
+     *
+     * @method isSoftExpired
+     * @public
+     * @param {StableDocumentIdentifier} identifier
+     * @param {Store} store
+     * @return {boolean} true if the request is considered soft expired
+     */
+    isSoftExpired(identifier: StableDocumentIdentifier, store: Store): boolean;
+    /**
+     * Invoked when a request will be sent to the configured request handlers.
+     * This is invoked for both foreground and background requests.
+     *
+     * Note, this is invoked regardless of whether the request has a cache-key.
+     *
+     * @method willRequest [Optional]
+     * @public
+     * @param {ImmutableRequestInfo} request
+     * @param {StableDocumentIdentifier | null} identifier
+     * @param {Store} store
+     * @return {void}
+     */
+    willRequest?(request: ImmutableRequestInfo, identifier: StableDocumentIdentifier | null, store: Store): void;
+    /**
+     * Invoked when a request has been fulfilled from the configured request handlers.
+     * This is invoked for both foreground and background requests once the cache has
+     * been updated.
+     *
+     * Note, this is invoked regardless of whether the request has a cache-key.
+     *
+     * @method didRequest [Optional]
+     * @public
+     * @param {ImmutableRequestInfo} request
+     * @param {ImmutableResponse} response
+     * @param {StableDocumentIdentifier | null} identifier
+     * @param {Store} store
+     * @return {void}
+     */
+    didRequest?(request: ImmutableRequestInfo, response: Response | ResponseInfo | null, identifier: StableDocumentIdentifier | null, store: Store): void;
+}
+export type StoreRequestInfo = ImmutableRequestInfo;
+export type LooseStoreRequestInfo = Omit<StoreRequestInfo, 'records' | 'headers'> & {
+    records?: ResourceIdentifierObject[];
+    headers?: Headers;
+};
+export type StoreRequestInput = StoreRequestInfo | LooseStoreRequestInfo;
+export interface StoreRequestContext extends RequestContext {
+    request: StoreRequestInfo & {
+        store: Store;
+        [EnableHydration]?: boolean;
+    };
+}
+export declare const CacheHandler: Handler;
+//# sourceMappingURL=cache-handler.d.ts.map

package/unstable-preview-types/-private/cache-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache-handler.d.ts","sourceRoot":"","sources":["../../src/-private/cache-handler.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAU,OAAO,EAAU,MAAM,oCAAoC,CAAC;AAClF,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,mCAAmC,CAAC;AAClF,OAAO,KAAK,EAGV,oBAAoB,EAEpB,cAAc,EACd,YAAY,EAGb,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAAE,eAAe,EAAa,MAAM,gCAAgC,CAAC;AAO5E,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,iCAAiC,CAAC;AAIhF,OAAO,KAAK,KAAK,MAAM,iBAAiB,CAAC;AAEzC;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;;;;;;;;;;;;;OAeG;IACH,aAAa,CAAC,UAAU,EAAE,wBAAwB,EAAE,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC;IAC3E;;;;;;;;;;;;;;OAcG;IACH,aAAa,CAAC,UAAU,EAAE,wBAAwB,EAAE,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC;IAE3E;;;;;;;;;;;;OAYG;IACH,WAAW,CAAC,CAAC,OAAO,EAAE,oBAAoB,EAAE,UAAU,EAAE,wBAAwB,GAAG,IAAI,EAAE,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IAE7G;;;;;;;;;;;;;;OAcG;IACH,UAAU,CAAC,CACT,OAAO,EAAE,oBAAoB,EAC7B,QAAQ,EAAE,QAAQ,GAAG,YAAY,GAAG,IAAI,EACxC,UAAU,EAAE,wBAAwB,GAAG,IAAI,EAC3C,KAAK,EAAE,KAAK,GACX,IAAI,CAAC;CACT;AAED,MAAM,MAAM,gBAAgB,GAAG,oBAAoB,CAAC;AACpD,MAAM,MAAM,qBAAqB,GAAG,IAAI,CAAC,gBAAgB,EAAE,SAAS,GAAG,SAAS,CAAC,GAAG;IAClF,OAAO,CAAC,EAAE,wBAAwB,EAAE,CAAC;IACrC,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG,gBAAgB,GAAG,qBAAqB,CAAC;AAEzE,MAAM,WAAW,mBAAoB,SAAQ,cAAc;IACzD,OAAO,EAAE,gBAAgB,GAAG;QAAE,KAAK,EAAE,KAAK,CAAC;QAAC,CAAC,eAAe,CAAC,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;CAC3E;AA+RD,eAAO,MAAM,YAAY,EAAE,OAoD1B,CAAC"}

package/unstable-preview-types/-private/caches/cache-utils.d.ts

@@ -0,0 +1,9 @@
+import type { StableRecordIdentifier } from '@warp-drive/core-types/identifier';
+import type { Cache } from '../../-types/q/cache';
+import type { OpaqueRecordInstance } from '../../-types/q/record-instance';
+export declare const CacheForIdentifierCache: Map<unknown, Cache>;
+export declare function setCacheFor(identifier: StableRecordIdentifier | OpaqueRecordInstance, cache: Cache): void;
+export declare function removeRecordDataFor(identifier: StableRecordIdentifier | OpaqueRecordInstance): void;
+export default function peekCache(instance: StableRecordIdentifier): Cache | null;
+export default function peekCache(instance: OpaqueRecordInstance): Cache;
+//# sourceMappingURL=cache-utils.d.ts.map

package/unstable-preview-types/-private/caches/cache-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache-utils.d.ts","sourceRoot":"","sources":["../../../src/-private/caches/cache-utils.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,mCAAmC,CAAC;AAEhF,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,gCAAgC,CAAC;AAO3E,eAAO,MAAM,uBAAuB,qBAAkE,CAAC;AAEvG,wBAAgB,WAAW,CAAC,UAAU,EAAE,sBAAsB,GAAG,oBAAoB,EAAE,KAAK,EAAE,KAAK,GAAG,IAAI,CAMzG;AAED,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,sBAAsB,GAAG,oBAAoB,GAAG,IAAI,CAEnG;AAED,MAAM,CAAC,OAAO,UAAU,SAAS,CAAC,QAAQ,EAAE,sBAAsB,GAAG,KAAK,GAAG,IAAI,CAAC;AAClF,MAAM,CAAC,OAAO,UAAU,SAAS,CAAC,QAAQ,EAAE,oBAAoB,GAAG,KAAK,CAAC"}

package/unstable-preview-types/-private/caches/identifier-cache.d.ts

@@ -0,0 +1,180 @@
+import { type Identifier, type RecordIdentifier, type StableDocumentIdentifier, type StableRecordIdentifier } from '@warp-drive/core-types/identifier';
+import type { ImmutableRequestInfo } from '@warp-drive/core-types/request';
+import type { ResourceIdentifierObject } from '@warp-drive/core-types/spec/raw';
+import type { ForgetMethod, GenerationMethod, ResetMethod, UpdateMethod } from '../../-types/q/identifier';
+export declare function isStableIdentifier(identifier: unknown): identifier is StableRecordIdentifier;
+export declare function isDocumentIdentifier(identifier: unknown): identifier is StableDocumentIdentifier;
+interface KeyOptions {
+    lid: IdentifierMap;
+    id: IdentifierMap;
+}
+type TypeMap = {
+    [key: string]: KeyOptions;
+};
+type IdentifierMap = Map<string, StableRecordIdentifier>;
+type KeyInfo = {
+    id: string | null;
+    type: string;
+};
+type StableCache = {
+    resources: IdentifierMap;
+    documents: Map<string, StableDocumentIdentifier>;
+    resourcesByType: TypeMap;
+    polymorphicLidBackMap: Map<string, string[]>;
+};
+export type KeyInfoMethod = (resource: unknown, known: StableRecordIdentifier | null) => KeyInfo;
+export type MergeMethod = (targetIdentifier: StableRecordIdentifier, matchedIdentifier: StableRecordIdentifier, resourceData: unknown) => StableRecordIdentifier;
+export declare function setIdentifierGenerationMethod(method: GenerationMethod | null): void;
+export declare function setIdentifierUpdateMethod(method: UpdateMethod | null): void;
+export declare function setIdentifierForgetMethod(method: ForgetMethod | null): void;
+export declare function setIdentifierResetMethod(method: ResetMethod | null): void;
+export declare function setKeyInfoForResource(method: KeyInfoMethod | null): void;
+/**
+ * Each instance of {Store} receives a unique instance of a IdentifierCache.
+ *
+ * This cache is responsible for assigning or retrieving the unique identify
+ * for arbitrary resource data encountered by the store. Data representing
+ * a unique resource or record should always be represented by the same
+ * identifier.
+ *
+ * It can be configured by consuming applications.
+ *
+ * @class IdentifierCache
+   @public
+ */
+export declare class IdentifierCache {
+    _cache: StableCache;
+    _generate: GenerationMethod;
+    _update: UpdateMethod;
+    _forget: ForgetMethod;
+    _reset: ResetMethod;
+    _merge: MergeMethod;
+    _keyInfoForResource: KeyInfoMethod;
+    _isDefaultConfig: boolean;
+    _id: number;
+    constructor();
+    /**
+     * Internal hook to allow management of merge conflicts with identifiers.
+     *
+     * we allow late binding of this private internal merge so that
+     * the cache can insert itself here to handle elimination of duplicates
+     *
+     * @method __configureMerge
+     * @private
+     */
+    __configureMerge(method: MergeMethod | null): void;
+    upgradeIdentifier(resource: {
+        type: string;
+        id: string | null;
+        lid?: string;
+    }): StableRecordIdentifier;
+    /**
+     * @method _getRecordIdentifier
+     * @private
+     */
+    _getRecordIdentifier(resource: {
+        type: string;
+        id: string | null;
+        lid?: string;
+    }, shouldGenerate: 2): StableRecordIdentifier;
+    _getRecordIdentifier(resource: unknown, shouldGenerate: 1): StableRecordIdentifier;
+    _getRecordIdentifier(resource: unknown, shouldGenerate: 0): StableRecordIdentifier | undefined;
+    /**
+     * allows us to peek without generating when needed
+     * useful for the "create" case when we need to see if
+     * we are accidentally overwritting something
+     *
+     * @method peekRecordIdentifier
+     * @param resource
+     * @return {StableRecordIdentifier | undefined}
+     * @private
+     */
+    peekRecordIdentifier(resource: ResourceIdentifierObject | Identifier): StableRecordIdentifier | undefined;
+    /**
+      Returns the DocumentIdentifier for the given Request, creates one if it does not yet exist.
+      Returns `null` if the request does not have a `cacheKey` or `url`.
+  
+      @method getOrCreateDocumentIdentifier
+      @param request
+      @return {StableDocumentIdentifier | null}
+      @public
+    */
+    getOrCreateDocumentIdentifier(request: ImmutableRequestInfo): StableDocumentIdentifier | null;
+    /**
+      Returns the Identifier for the given Resource, creates one if it does not yet exist.
+  
+      Specifically this means that we:
+  
+      - validate the `id` `type` and `lid` combo against known identifiers
+      - return an object with an `lid` that is stable (repeated calls with the same
+        `id` + `type` or `lid` will return the same `lid` value)
+      - this referential stability of the object itself is guaranteed
+  
+      @method getOrCreateRecordIdentifier
+      @param resource
+      @return {StableRecordIdentifier}
+      @public
+    */
+    getOrCreateRecordIdentifier(resource: unknown): StableRecordIdentifier;
+    /**
+     Returns a new Identifier for the supplied data. Call this method to generate
+     an identifier when a new resource is being created local to the client and
+     potentially does not have an `id`.
+  
+     Delegates generation to the user supplied `GenerateMethod` if one has been provided
+     with the signature `generateMethod({ type }, 'record')`.
+  
+     @method createIdentifierForNewRecord
+     @param data
+     @return {StableRecordIdentifier}
+     @public
+    */
+    createIdentifierForNewRecord(data: {
+        type: string;
+        id?: string | null;
+    }): StableRecordIdentifier;
+    /**
+     Provides the opportunity to update secondary lookup tables for existing identifiers
+     Called after an identifier created with `createIdentifierForNewRecord` has been
+     committed.
+  
+     Assigned `id` to an `Identifier` if `id` has not previously existed; however,
+     attempting to change the `id` or calling update without providing an `id` when
+     one is missing will throw an error.
+  
+      - sets `id` (if `id` was previously `null`)
+      - `lid` and `type` MUST NOT be altered post creation
+  
+      If a merge occurs, it is possible the returned identifier does not match the originally
+      provided identifier. In this case the abandoned identifier will go through the usual
+      `forgetRecordIdentifier` codepaths.
+  
+      @method updateRecordIdentifier
+      @param identifierObject
+      @param data
+      @return {StableRecordIdentifier}
+      @public
+    */
+    updateRecordIdentifier(identifierObject: RecordIdentifier, data: unknown): StableRecordIdentifier;
+    /**
+     * @method _mergeRecordIdentifiers
+     * @private
+     */
+    _mergeRecordIdentifiers(keyInfo: KeyInfo, identifier: StableRecordIdentifier, existingIdentifier: StableRecordIdentifier, data: unknown): StableRecordIdentifier;
+    /**
+     Provides the opportunity to eliminate an identifier from secondary lookup tables
+     as well as eliminates it from ember-data's own lookup tables and book keeping.
+  
+     Useful when a record has been deleted and the deletion has been persisted and
+     we do not care about the record anymore. Especially useful when an `id` of a
+     deleted record might be reused later for a new record.
+  
+     @method forgetRecordIdentifier
+     @param identifierObject
+     @public
+    */
+    forgetRecordIdentifier(identifierObject: RecordIdentifier): void;
+    destroy(): void;
+}
+export {};
+//# sourceMappingURL=identifier-cache.d.ts.map

package/unstable-preview-types/-private/caches/identifier-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"identifier-cache.d.ts","sourceRoot":"","sources":["../../../src/-private/caches/identifier-cache.ts"],"names":[],"mappings":"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"}

package/unstable-preview-types/-private/caches/instance-cache.d.ts

@@ -0,0 +1,61 @@
+import type { RecordIdentifier, StableRecordIdentifier } from '@warp-drive/core-types/identifier';
+import type { Value } from '@warp-drive/core-types/json/raw';
+import type { TypedRecordInstance, TypeFromInstance } from '@warp-drive/core-types/record';
+import type { Cache } from '../../-types/q/cache';
+import type { OpaqueRecordInstance } from '../../-types/q/record-instance';
+import RecordReference from '../legacy-model-support/record-reference';
+import { CacheCapabilitiesManager } from '../managers/cache-capabilities-manager';
+import type { CacheManager } from '../managers/cache-manager';
+import type { CreateRecordProperties } from '../store-service';
+import type Store from '../store-service';
+export declare function peekRecordIdentifier(record: OpaqueRecordInstance): StableRecordIdentifier | undefined;
+/**
+  Retrieves the unique referentially-stable [RecordIdentifier](/ember-data/release/classes/StableRecordIdentifier)
+  assigned to the given record instance.
+  ```js
+  import { recordIdentifierFor } from "@ember-data/store";
+  // ... gain access to a record, for instance with peekRecord or findRecord
+  const record = store.peekRecord("user", "1");
+  // get the identifier for the record (see docs for StableRecordIdentifier)
+  const identifier = recordIdentifierFor(record);
+  // access the identifier's properties.
+  const { id, type, lid } = identifier;
+  ```
+  @method recordIdentifierFor
+  @public
+  @static
+  @for @ember-data/store
+  @param {Object} record a record instance previously obstained from the store.
+  @return {StableRecordIdentifier}
+ */
+export declare function recordIdentifierFor<T extends TypedRecordInstance>(record: T): StableRecordIdentifier<TypeFromInstance<T>>;
+export declare function recordIdentifierFor(record: OpaqueRecordInstance): StableRecordIdentifier;
+export declare function setRecordIdentifier(record: OpaqueRecordInstance, identifier: StableRecordIdentifier): void;
+export declare const StoreMap: Map<unknown, Store>;
+export declare function storeFor(record: OpaqueRecordInstance): Store | undefined;
+type Caches = {
+    record: Map<StableRecordIdentifier, OpaqueRecordInstance>;
+    reference: WeakMap<StableRecordIdentifier, RecordReference>;
+};
+export declare class InstanceCache {
+    store: Store;
+    cache: Cache;
+    _storeWrapper: CacheCapabilitiesManager;
+    __cacheFor: (resource: RecordIdentifier) => Cache;
+    __cacheManager: CacheManager;
+    __instances: Caches;
+    constructor(store: Store);
+    peek(identifier: StableRecordIdentifier): Cache | OpaqueRecordInstance | undefined;
+    getRecord(identifier: StableRecordIdentifier, properties?: CreateRecordProperties): OpaqueRecordInstance;
+    getReference(identifier: StableRecordIdentifier): RecordReference;
+    recordIsLoaded(identifier: StableRecordIdentifier, filterDeleted?: boolean): boolean;
+    disconnect(identifier: StableRecordIdentifier): void;
+    unloadRecord(identifier: StableRecordIdentifier): void;
+    clear(type?: string): void;
+    setRecordId(identifier: StableRecordIdentifier, id: string): void;
+}
+export declare function resourceIsFullyDeleted(instanceCache: InstanceCache, identifier: StableRecordIdentifier): boolean;
+export declare function preloadData(store: Store, identifier: StableRecordIdentifier, preload: Record<string, Value>): void;
+export declare function _clearCaches(): void;
+export {};
+//# sourceMappingURL=instance-cache.d.ts.map

package/unstable-preview-types/-private/caches/instance-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"instance-cache.d.ts","sourceRoot":"","sources":["../../../src/-private/caches/instance-cache.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,mCAAmC,CAAC;AAClG,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,iCAAiC,CAAC;AAC7D,OAAO,KAAK,EAAE,mBAAmB,EAAE,gBAAgB,EAA4B,MAAM,+BAA+B,CAAC;AAIrH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAElD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,gCAAgC,CAAC;AAC3E,OAAO,eAAe,MAAM,0CAA0C,CAAC;AACvE,OAAO,EAAE,wBAAwB,EAAE,MAAM,wCAAwC,CAAC;AAClF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAC/D,OAAO,KAAK,KAAK,MAAM,kBAAkB,CAAC;AAoB1C,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,oBAAoB,GAAG,sBAAsB,GAAG,SAAS,CAErG;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,SAAS,mBAAmB,EAC/D,MAAM,EAAE,CAAC,GACR,sBAAsB,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,CAAC;AAC/C,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,oBAAoB,GAAG,sBAAsB,CAAC;AAM1F,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,oBAAoB,EAAE,UAAU,EAAE,sBAAsB,GAAG,IAAI,CAgB1G;AAED,eAAO,MAAM,QAAQ,qBAAyC,CAAC;AAE/D,wBAAgB,QAAQ,CAAC,MAAM,EAAE,oBAAoB,GAAG,KAAK,GAAG,SAAS,CAQxE;AAED,KAAK,MAAM,GAAG;IACZ,MAAM,EAAE,GAAG,CAAC,sBAAsB,EAAE,oBAAoB,CAAC,CAAC;IAC1D,SAAS,EAAE,OAAO,CAAC,sBAAsB,EAAE,eAAe,CAAC,CAAC;CAC7D,CAAC;AAEF,qBAAa,aAAa;IAChB,KAAK,EAAE,KAAK,CAAC;IACb,KAAK,EAAE,KAAK,CAAC;IACb,aAAa,EAAE,wBAAwB,CAAC;IACxC,UAAU,EAAE,CAAC,QAAQ,EAAE,gBAAgB,KAAK,KAAK,CAAC;IAElD,cAAc,EAAE,YAAY,CAAC;IACrC,WAAW,EAAE,MAAM,CAGjB;gBAEU,KAAK,EAAE,KAAK;IAkExB,IAAI,CAAC,UAAU,EAAE,sBAAsB,GAAG,KAAK,GAAG,oBAAoB,GAAG,SAAS;IAIlF,SAAS,CAAC,UAAU,EAAE,sBAAsB,EAAE,UAAU,CAAC,EAAE,sBAAsB,GAAG,oBAAoB;IA2BxG,YAAY,CAAC,UAAU,EAAE,sBAAsB;IAW/C,cAAc,CAAC,UAAU,EAAE,sBAAsB,EAAE,aAAa,UAAQ;IAsBxE,UAAU,CAAC,UAAU,EAAE,sBAAsB;IAkB7C,YAAY,CAAC,UAAU,EAAE,sBAAsB;IAuD/C,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM;IAuBnB,WAAW,CAAC,UAAU,EAAE,sBAAsB,EAAE,EAAE,EAAE,MAAM;CA+C3D;AAMD,wBAAgB,sBAAsB,CAAC,aAAa,EAAE,aAAa,EAAE,UAAU,EAAE,sBAAsB,GAAG,OAAO,CAGhH;AAcD,wBAAgB,WAAW,CAAC,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,sBAAsB,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,QAwB3G;AAiCD,wBAAgB,YAAY,SAI3B"}

package/unstable-preview-types/-private/caches/resource-utils.d.ts

@@ -0,0 +1,10 @@
+export declare function hasLid(resource: unknown): resource is {
+    lid: string;
+};
+export declare function hasId(resource: unknown): resource is {
+    id: string;
+};
+export declare function hasType(resource: unknown): resource is {
+    type: string;
+};
+//# sourceMappingURL=resource-utils.d.ts.map

package/unstable-preview-types/-private/caches/resource-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource-utils.d.ts","sourceRoot":"","sources":["../../../src/-private/caches/resource-utils.ts"],"names":[],"mappings":"AAUA,wBAAgB,MAAM,CAAC,QAAQ,EAAE,OAAO,GAAG,QAAQ,IAAI;IAAE,GAAG,EAAE,MAAM,CAAA;CAAE,CAErE;AAED,wBAAgB,KAAK,CAAC,QAAQ,EAAE,OAAO,GAAG,QAAQ,IAAI;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,CAInE;AAED,wBAAgB,OAAO,CAAC,QAAQ,EAAE,OAAO,GAAG,QAAQ,IAAI;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAEvE"}

package/unstable-preview-types/-private/document.d.ts

@@ -0,0 +1,144 @@
+import type { StableDocumentIdentifier } from '@warp-drive/core-types/identifier';
+import type { RequestInfo } from '@warp-drive/core-types/request';
+import type { Meta, PaginationLinks } from '@warp-drive/core-types/spec/raw';
+import type Store from './store-service';
+/**
+ * A Document is a class that wraps the response content from a request to the API
+ * returned by `Cache.put` or `Cache.peek`, converting resource-identifiers into
+ * record instances.
+ *
+ * It is not directly instantiated by the user, and its properties should not
+ * be directly modified. Whether individual properties are mutable or not is
+ * determined by the record instance itself.
+ *
+ * @public
+ * @class Document
+ */
+export declare class Document<T> {
+    #private;
+    /**
+     * The links object for this document, if any
+     *
+     * e.g.
+     *
+     * ```
+     * {
+     *   self: '/articles?page[number]=3',
+     * }
+     * ```
+     *
+     * @property links
+     * @type {object|undefined} - a links object
+     * @public
+     */
+    links?: PaginationLinks;
+    /**
+     * The primary data for this document, if any.
+     *
+     * If this document has no primary data (e.g. because it is an error document)
+     * this property will be `undefined`.
+     *
+     * For collections this will be an array of record instances,
+     * for single resource requests it will be a single record instance or null.
+     *
+     * @property data
+     * @public
+     * @type {object|Array<object>|null|undefined} - a data object
+     */
+    data?: T;
+    /**
+     * The errors returned by the API for this request, if any
+     *
+     * @property errors
+     * @public
+     * @type {object|undefined} - an errors object
+     */
+    errors?: object[];
+    /**
+     * The meta object for this document, if any
+     *
+     * @property meta
+     * @public
+     * @type {object|undefined} - a meta object
+     */
+    meta?: Meta;
+    /**
+     * The identifier associated with this document, if any
+     *
+     * @property identifier
+     * @public
+     * @type {StableDocumentIdentifier|null}
+     */
+    identifier: StableDocumentIdentifier | null;
+    constructor(store: Store, identifier: StableDocumentIdentifier | null);
+    /**
+     * Fetches the related link for this document, returning a promise that resolves
+     * with the document when the request completes. If no related link is present,
+     * will fallback to the self link if present
+     *
+     * @method fetch
+     * @public
+     * @param {object} options
+     * @return Promise<Document>
+     */
+    fetch(options?: Partial<RequestInfo>): Promise<Document<T>>;
+    /**
+     * Fetches the next link for this document, returning a promise that resolves
+     * with the new document when the request completes, or null  if there is no
+     * next link.
+     *
+     * @method next
+     * @public
+     * @param {object} options
+     * @return Promise<Document | null>
+     */
+    next(options?: Partial<RequestInfo>): Promise<Document<T> | null>;
+    /**
+     * Fetches the prev link for this document, returning a promise that resolves
+     * with the new document when the request completes, or null if there is no
+     * prev link.
+     *
+     * @method prev
+     * @public
+     * @param {object} options
+     * @return Promise<Document | null>
+     */
+    prev(options?: Partial<RequestInfo>): Promise<Document<T> | null>;
+    /**
+     * Fetches the first link for this document, returning a promise that resolves
+     * with the new document when the request completes, or null if there is no
+     * first link.
+     *
+     * @method first
+     * @public
+     * @param {object} options
+     * @return Promise<Document | null>
+     */
+    first(options?: Partial<RequestInfo>): Promise<Document<T> | null>;
+    /**
+     * Fetches the last link for this document, returning a promise that resolves
+     * with the new document when the request completes, or null if there is no
+     * last link.
+     *
+     * @method last
+     * @public
+     * @param {object} options
+     * @return Promise<Document | null>
+     */
+    last(options?: Partial<RequestInfo>): Promise<Document<T> | null>;
+    /**
+     * Implemented for `JSON.stringify` support.
+     *
+     * Returns the JSON representation of the document wrapper.
+     *
+     * This is a shallow serialization, it does not deeply serialize
+     * the document's contents, leaving that to the individual record
+     * instances to determine how to do, if at all.
+     *
+     * @method toJSON
+     * @public
+     * @return
+     */
+    toJSON(): object;
+}
+//# sourceMappingURL=document.d.ts.map

package/unstable-preview-types/-private/document.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"document.d.ts","sourceRoot":"","sources":["../../src/-private/document.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,mCAAmC,CAAC;AAClF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAClE,OAAO,KAAK,EAAQ,IAAI,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAEnF,OAAO,KAAK,KAAK,MAAM,iBAAiB,CAAC;AAOzC;;;;;;;;;;;GAWG;AACH,qBAAa,QAAQ,CAAC,CAAC;;IACrB;;;;;;;;;;;;;;OAcG;IACK,KAAK,CAAC,EAAE,eAAe,CAAC;IAChC;;;;;;;;;;;;OAYG;IACK,IAAI,CAAC,EAAE,CAAC,CAAC;IAEjB;;;;;;OAMG;IACK,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAE1B;;;;;;OAMG;IACK,IAAI,CAAC,EAAE,IAAI,CAAC;IAEpB;;;;;;OAMG;IACK,UAAU,EAAE,wBAAwB,GAAG,IAAI,CAAC;gBAGxC,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,wBAAwB,GAAG,IAAI;IAiBrE;;;;;;;;;OASG;IACH,KAAK,CAAC,OAAO,GAAE,OAAO,CAAC,WAAW,CAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;IAO/D;;;;;;;;;OASG;IACH,IAAI,CAAC,OAAO,GAAE,OAAO,CAAC,WAAW,CAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IAIrE;;;;;;;;;OASG;IACH,IAAI,CAAC,OAAO,GAAE,OAAO,CAAC,WAAW,CAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IAIrE;;;;;;;;;OASG;IACH,KAAK,CAAC,OAAO,GAAE,OAAO,CAAC,WAAW,CAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IAItE;;;;;;;;;OASG;IACH,IAAI,CAAC,OAAO,GAAE,OAAO,CAAC,WAAW,CAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IAIrE;;;;;;;;;;;;OAYG;IACH,MAAM,IAAI,MAAM;CAiBjB"}

package/unstable-preview-types/-private/index.d.ts

@@ -0,0 +1,16 @@
+/**
+  @module @ember-data/store
+*/
+export { default as Store, storeFor } from './store-service';
+export { recordIdentifierFor } from './caches/instance-cache';
+export { CacheHandler, type LifetimesService } from './cache-handler';
+export { setIdentifierGenerationMethod, setIdentifierUpdateMethod, setIdentifierForgetMethod, setIdentifierResetMethod, isStableIdentifier, } from './caches/identifier-cache';
+export { default as coerceId } from './utils/coerce-id';
+export { default as RecordArray, default as IdentifierArray, Collection as AdapterPopulatedRecordArray, notifyArray, SOURCE, MUTATE, ARRAY_SIGNAL, } from './record-arrays/identifier-array';
+export { default as RecordArrayManager, fastPush } from './managers/record-array-manager';
+export { _clearCaches } from './caches/instance-cache';
+export { default as peekCache, removeRecordDataFor } from './caches/cache-utils';
+export { setRecordIdentifier, StoreMap } from './caches/instance-cache';
+export { setCacheFor } from './caches/cache-utils';
+export { default as _deprecatingNormalize } from './utils/normalize-model-name';
+//# sourceMappingURL=index.d.ts.map

package/unstable-preview-types/-private/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/-private/index.ts"],"names":[],"mappings":"AAAA;;EAEE;AAEF,OAAO,EAAE,OAAO,IAAI,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAE7D,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAE9D,OAAO,EAAE,YAAY,EAAE,KAAK,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAEtE,OAAO,EACL,6BAA6B,EAC7B,yBAAyB,EACzB,yBAAyB,EACzB,wBAAwB,EACxB,kBAAkB,GACnB,MAAM,2BAA2B,CAAC;AAInC,OAAO,EAAE,OAAO,IAAI,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAExD,OAAO,EACL,OAAO,IAAI,WAAW,EACtB,OAAO,IAAI,eAAe,EAC1B,UAAU,IAAI,2BAA2B,EACzC,WAAW,EACX,MAAM,EACN,MAAM,EACN,YAAY,GACb,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EAAE,OAAO,IAAI,kBAAkB,EAAE,QAAQ,EAAE,MAAM,iCAAiC,CAAC;AAG1F,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAGjF,OAAO,EAAE,mBAAmB,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AACxE,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,EAAE,OAAO,IAAI,qBAAqB,EAAE,MAAM,8BAA8B,CAAC"}