@ember-data-types/store 5.5.0-alpha.19 → 5.5.0-alpha.20

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ember-data-types/store",
-  "version": "5.5.0-alpha.19",
+  "version": "5.5.0-alpha.20",
   "files": [
     "unstable-preview-types",
     "README.md",

package/unstable-preview-types/-private/network/request-cache.d.ts

@@ -20,7 +20,7 @@ declare module '@ember-data/store/-private/network/request-cache' {
       options?: Record<string, unknown>;
   }
   export type RequestStates = 'pending' | 'fulfilled' | 'rejected';
-  export interface RequestState {
+  export interface RequestCacheRequestState {
       state: RequestStates;
       type: 'query' | 'mutation';
       request: Request;
@@ -29,11 +29,11 @@ declare module '@ember-data/store/-private/network/request-cache' {
   export interface Response {
       data: unknown;
   }
-  interface InternalRequest extends RequestState {
+  interface InternalRequest extends RequestCacheRequestState {
       [Touching]: StableRecordIdentifier[];
       [RequestPromise]?: Promise<unknown>;
   }
-  export type RequestSubscription = (requestState: RequestState) => void;
+  export type RequestSubscription = (requestState: RequestCacheRequestState) => void;
   /**
    * The RequestStateService is used to track the state of requests
    * for fetching or updating known resource identifies that are inflight.
@@ -82,7 +82,7 @@ declare module '@ember-data/store/-private/network/request-cache' {
        * @method subscribeForRecord
        * @public
        * @param {StableRecordIdentifier} identifier
-       * @param {(state: RequestState) => void} callback
+       * @param {(state: RequestCacheRequestState) => void} callback
        */
       subscribeForRecord(identifier: StableRecordIdentifier, callback: RequestSubscription): void;
       /**
@@ -91,18 +91,18 @@ declare module '@ember-data/store/-private/network/request-cache' {
        * @method getPendingRequestsForRecord
        * @public
        * @param {StableRecordIdentifier} identifier
-       * @return {RequestState[]} an array of request states for any pending requests for the given identifier
+       * @return {RequestCacheRequestState[]} an array of request states for any pending requests for the given identifier
        */
-      getPendingRequestsForRecord(identifier: StableRecordIdentifier): RequestState[];
+      getPendingRequestsForRecord(identifier: StableRecordIdentifier): RequestCacheRequestState[];
       /**
        * Retrieve the last completed request for a given resource identity.
        *
        * @method getLastRequestForRecord
        * @public
        * @param {StableRecordIdentifier} identifier
-       * @return {RequestState | null} the state of the most recent request for the given identifier
+       * @return {RequestCacheRequestState | null} the state of the most recent request for the given identifier
        */
-      getLastRequestForRecord(identifier: StableRecordIdentifier): RequestState | null;
+      getLastRequestForRecord(identifier: StableRecordIdentifier): RequestCacheRequestState | null;
   }
   export {};
 }

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

@@ -1 +1 @@
-{"version":3,"file":"request-cache.d.ts","sourceRoot":"","sources":["../../../src/-private/network/request-cache.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,mCAAmC,CAAC;AAEhF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAE9C,QAAA,MAAM,QAAQ,gCAAiD,CAAC;AAChE,eAAO,MAAM,cAAc,sCAAsD,CAAC;AAGlF,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,iBAAiB,GAAG,SAAS,CAAC;IACvC,gBAAgB,EAAE,sBAAsB,CAAC;CAC1C;AAED,MAAM,WAAW,eAAgB,SAAQ,SAAS;IAChD,EAAE,EAAE,YAAY,CAAC;CAClB;AAED,MAAM,WAAW,kBAAmB,SAAQ,SAAS;IACnD,EAAE,EAAE,YAAY,CAAC;CAClB;AAED,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,SAAS,EAAE,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,WAAW,GAAG,UAAU,CAAC;AAEjE,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,aAAa,CAAC;IACrB,IAAI,EAAE,OAAO,GAAG,UAAU,CAAC;IAC3B,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,QAAQ,CAAC;CACrB;AAED,MAAM,WAAW,QAAQ;IAEvB,IAAI,EAAE,OAAO,CAAC;CACf;AAED,UAAU,eAAgB,SAAQ,YAAY;IAC5C,CAAC,QAAQ,CAAC,EAAE,sBAAsB,EAAE,CAAC;IACrC,CAAC,cAAc,CAAC,CAAC,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;CACrC;AAGD,MAAM,MAAM,mBAAmB,GAAG,CAAC,YAAY,EAAE,YAAY,KAAK,IAAI,CAAC;AAMvE;;;;;;GAMG;AACH,qBAAa,mBAAmB;IAC9B,QAAQ,EAAE,GAAG,CAAC,sBAAsB,EAAE,eAAe,EAAE,CAAC,CAAa;IACrE,KAAK,EAAE,GAAG,CAAC,sBAAsB,EAAE,eAAe,EAAE,CAAC,CAAa;IAClE,cAAc,EAAE,GAAG,CAAC,sBAAsB,EAAE,mBAAmB,EAAE,CAAC,CAAa;IAC/E,QAAQ,EAAE,eAAe,EAAE,CAAM;IACjC,MAAM,EAAE,KAAK,CAAC;gBAEF,KAAK,EAAE,KAAK;IAIxB,aAAa,CAAC,UAAU,EAAE,sBAAsB;IAIhD,QAAQ,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC;IAiDnE,qBAAqB,CAAC,GAAG,EAAE,eAAe,GAAG,IAAI;IAcjD,MAAM,IAAI,IAAI;IAOd,aAAa,CAAC,GAAG,EAAE,eAAe,GAAG,IAAI;IASzC,QAAQ,CAAC,UAAU,EAAE,sBAAsB,EAAE,OAAO,EAAE,eAAe;IAQrE,QAAQ,CAAC,OAAO,EAAE,eAAe;IAwBjC;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA4BG;IACH,kBAAkB,CAAC,UAAU,EAAE,sBAAsB,EAAE,QAAQ,EAAE,mBAAmB;IASpF;;;;;;;OAOG;IACH,2BAA2B,CAAC,UAAU,EAAE,sBAAsB,GAAG,YAAY,EAAE;IAI/E;;;;;;;OAOG;IACH,uBAAuB,CAAC,UAAU,EAAE,sBAAsB,GAAG,YAAY,GAAG,IAAI;CAOjF"}
+{"version":3,"file":"request-cache.d.ts","sourceRoot":"","sources":["../../../src/-private/network/request-cache.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,mCAAmC,CAAC;AAEhF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAE9C,QAAA,MAAM,QAAQ,gCAAiD,CAAC;AAChE,eAAO,MAAM,cAAc,sCAAsD,CAAC;AAGlF,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,iBAAiB,GAAG,SAAS,CAAC;IACvC,gBAAgB,EAAE,sBAAsB,CAAC;CAC1C;AAED,MAAM,WAAW,eAAgB,SAAQ,SAAS;IAChD,EAAE,EAAE,YAAY,CAAC;CAClB;AAED,MAAM,WAAW,kBAAmB,SAAQ,SAAS;IACnD,EAAE,EAAE,YAAY,CAAC;CAClB;AAED,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,SAAS,EAAE,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,WAAW,GAAG,UAAU,CAAC;AAEjE,MAAM,WAAW,wBAAwB;IACvC,KAAK,EAAE,aAAa,CAAC;IACrB,IAAI,EAAE,OAAO,GAAG,UAAU,CAAC;IAC3B,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,QAAQ,CAAC;CACrB;AAED,MAAM,WAAW,QAAQ;IAEvB,IAAI,EAAE,OAAO,CAAC;CACf;AAED,UAAU,eAAgB,SAAQ,wBAAwB;IACxD,CAAC,QAAQ,CAAC,EAAE,sBAAsB,EAAE,CAAC;IACrC,CAAC,cAAc,CAAC,CAAC,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;CACrC;AAGD,MAAM,MAAM,mBAAmB,GAAG,CAAC,YAAY,EAAE,wBAAwB,KAAK,IAAI,CAAC;AAMnF;;;;;;GAMG;AACH,qBAAa,mBAAmB;IAC9B,QAAQ,EAAE,GAAG,CAAC,sBAAsB,EAAE,eAAe,EAAE,CAAC,CAAa;IACrE,KAAK,EAAE,GAAG,CAAC,sBAAsB,EAAE,eAAe,EAAE,CAAC,CAAa;IAClE,cAAc,EAAE,GAAG,CAAC,sBAAsB,EAAE,mBAAmB,EAAE,CAAC,CAAa;IAC/E,QAAQ,EAAE,eAAe,EAAE,CAAM;IACjC,MAAM,EAAE,KAAK,CAAC;gBAEF,KAAK,EAAE,KAAK;IAIxB,aAAa,CAAC,UAAU,EAAE,sBAAsB;IAIhD,QAAQ,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC;IAiDnE,qBAAqB,CAAC,GAAG,EAAE,eAAe,GAAG,IAAI;IAcjD,MAAM,IAAI,IAAI;IAOd,aAAa,CAAC,GAAG,EAAE,eAAe,GAAG,IAAI;IASzC,QAAQ,CAAC,UAAU,EAAE,sBAAsB,EAAE,OAAO,EAAE,eAAe;IAQrE,QAAQ,CAAC,OAAO,EAAE,eAAe;IAwBjC;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA4BG;IACH,kBAAkB,CAAC,UAAU,EAAE,sBAAsB,EAAE,QAAQ,EAAE,mBAAmB;IASpF;;;;;;;OAOG;IACH,2BAA2B,CAAC,UAAU,EAAE,sBAAsB,GAAG,wBAAwB,EAAE;IAI3F;;;;;;;OAOG;IACH,uBAAuB,CAAC,UAAU,EAAE,sBAAsB,GAAG,wBAAwB,GAAG,IAAI;CAO7F"}

package/unstable-preview-types/-private/new-core-tmp/promise-state.d.ts

@@ -0,0 +1,289 @@
+declare module '@ember-data/store/-private/new-core-tmp/promise-state' {
+  import type { Awaitable } from '@ember-data/request';
+  /**
+   * The state of a promise in the "pending"
+   * state. This is the default initial state.
+   *
+   * @typedoc
+   */
+  export interface PendingPromise {
+      /**
+       * The status of the promise.
+       *
+       * @typedoc
+       */
+      status: 'pending';
+      /**
+       * Whether the promise is pending.
+       *
+       * @typedoc
+       */
+      isPending: true;
+      /**
+       * Whether the promise is pending.
+       *
+       * @deprecated use `isPending` instead
+       * @typedoc
+       */
+      isLoading: true;
+      /**
+       * Whether the promise has resolved
+       * successfully.
+       *
+       * @typedoc
+       */
+      isSuccess: false;
+      /**
+       * Whether the promise has rejected
+       * with an error.
+       *
+       * @typedoc
+       */
+      isError: false;
+      /**
+       * Once the promise has resolved, this will
+       * be the value the promise resolved to.
+       *
+       * @typedoc
+       */
+      value: null;
+      /**
+       * Once the promise has resolved, this will
+       * be the value the promise resolved to.
+       *
+       * @deprecated use `value` instead
+       * @typedoc
+       */
+      result: null;
+      /**
+       * Once the promise has rejected, this will
+       * be the error the promise rejected with.
+       *
+       *
+       * @deprecated use `reason` instead
+       * @typedoc
+       */
+      error: null;
+      /**
+       * Once the promise has rejected, this will
+       * be the error the promise rejected with.
+       *
+       * @typedoc
+       */
+      reason: null;
+  }
+  /**
+   * The state of a promise in the "fulfilled" state.
+   * This is the state of a promise that has resolved
+   * successfully.
+   *
+   * @typedoc
+   */
+  export interface ResolvedPromise<T> {
+      /**
+       * The status of the promise.
+       *
+       * @typedoc
+       */
+      status: 'fulfilled';
+      /**
+       * Whether the promise is pending.
+       *
+       * @typedoc
+       */
+      isPending: false;
+      /**
+       * Whether the promise is pending.
+       *
+       * @deprecated use `isPending` instead
+       * @typedoc
+       */
+      isLoading: false;
+      /**
+       * Whether the promise has resolved
+       * successfully.
+       *
+       * @typedoc
+       */
+      isSuccess: true;
+      /**
+       * Whether the promise has rejected
+       * with an error.
+       *
+       * @typedoc
+       */
+      isError: false;
+      /**
+       * Once the promise has resolved, this will
+       * be the value the promise resolved to.
+       *
+       * @typedoc
+       */
+      value: T;
+      /**
+       * Once the promise has resolved, this will
+       * be the value the promise resolved to.
+       *
+       * @deprecated use `value` instead
+       * @typedoc
+       */
+      result: T;
+      /**
+       * Once the promise has rejected, this will
+       * be the error the promise rejected with.
+       *
+       *
+       * @deprecated use `reason` instead
+       * @typedoc
+       */
+      error: null;
+      /**
+       * Once the promise has rejected, this will
+       * be the error the promise rejected with.
+       *
+       * @typedoc
+       */
+      reason: null;
+  }
+  /**
+   * The state of a promise in the "rejected" state.
+   * This is the state of a promise that has rejected
+   * with an error.
+   *
+   * @typedoc
+   */
+  export interface RejectedPromise<E> {
+      /**
+       * The status of the promise.
+       *
+       * @typedoc
+       */
+      status: 'rejected';
+      /**
+       * Whether the promise is pending.
+       *
+       * @typedoc
+       */
+      isPending: false;
+      /**
+       * Whether the promise is pending.
+       *
+       * @deprecated use `isPending` instead
+       * @typedoc
+       */
+      isLoading: false;
+      /**
+       * Whether the promise has resolved
+       * successfully.
+       *
+       * @typedoc
+       */
+      isSuccess: false;
+      /**
+       * Whether the promise has rejected
+       * with an error.
+       *
+       * @typedoc
+       */
+      isError: true;
+      /**
+       * Once the promise has resolved, this will
+       * be the value the promise resolved to.
+       *
+       * @typedoc
+       */
+      value: null;
+      /**
+       * Once the promise has resolved, this will
+       * be the value the promise resolved to.
+       *
+       * @deprecated use `value` instead
+       * @typedoc
+       */
+      result: null;
+      /**
+       * Once the promise has rejected, this will
+       * be the error the promise rejected with.
+       *
+       *
+       * @deprecated use `reason` instead
+       * @typedoc
+       */
+      error: E;
+      /**
+       * Once the promise has rejected, this will
+       * be the error the promise rejected with.
+       *
+       * @typedoc
+       */
+      reason: E;
+  }
+  /**
+   * The state of a promise. This is the type that is returned
+   * from `getPromiseState`.
+   *
+   * See also:
+   * - {@link PendingPromise}
+   * - {@link ResolvedPromise}
+   * - {@link RejectedPromise}
+   *
+   * @typedoc
+   */
+  export type PromiseState<T = unknown, E = unknown> = PendingPromise | ResolvedPromise<T> | RejectedPromise<E>;
+  export function createPromiseState<T, E>(promise: Promise<T> | Awaitable<T, E>): Readonly<PromiseState<T, E>>;
+  /**
+   * Returns a reactive state-machine for the provided promise or awaitable.
+   *
+   * Repeat calls to `getPromiseState` with the same promise will return the same state object
+   * making is safe and easy to use in templates and JavaScript code to produce reactive
+   * behaviors around promises.
+   *
+   * `getPromiseState` can be used in both JavaScript and Template contexts.
+   *
+   * ```ts
+   * import { getPromiseState } from '@warp-drive/ember';
+   *
+   * const state = getPromiseState(promise);
+   * ```
+   *
+   * For instance, we could write a getter on a component that updates whenever
+   * the promise state advances or the promise changes, by combining the function
+   * with the use of `@cached`
+   *
+   * ```ts
+   * class Component {
+   *   @cached
+   *   get title() {
+   *     const state = getPromiseState(this.args.request);
+   *     if (state.isPending) {
+   *       return 'loading...';
+   *     }
+   *     if (state.isError) { return null; }
+   *     return state.result.title;
+   *   }
+   * }
+   * ```
+   *
+   * Or in a template as a helper:
+   *
+   * ```gjs
+   * import { getPromiseState } from '@warp-drive/ember';
+   *
+   * <template>
+   *   {{#let (getPromiseState @request) as |state|}}
+   *     {{#if state.isPending}} <Spinner />
+   *     {{else if state.isError}} <ErrorForm @error={{state.error}} />
+   *     {{else}}
+   *       <h1>{{state.result.title}}</h1>
+   *     {{/if}}
+   *   {{/let}}
+   * </template>
+   * ```
+   *
+   * If looking to use in a template, consider also the `<Await />` component.
+   *
+   * @typedoc
+   */
+  export function getPromiseState<T = unknown, E = unknown>(promise: Promise<T> | Awaitable<T, E>): Readonly<PromiseState<T, E>>;
+}
+//# sourceMappingURL=promise-state.d.ts.map

package/unstable-preview-types/-private/new-core-tmp/promise-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"promise-state.d.ts","sourceRoot":"","sources":["../../../src/-private/new-core-tmp/promise-state.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAMrD;;;;;GAKG;AACH,MAAM,WAAW,cAAc;IAC7B;;;;OAIG;IACH,MAAM,EAAE,SAAS,CAAC;IAElB;;;;OAIG;IACH,SAAS,EAAE,IAAI,CAAC;IAEhB;;;;;OAKG;IACH,SAAS,EAAE,IAAI,CAAC;IAEhB;;;;;OAKG;IACH,SAAS,EAAE,KAAK,CAAC;IAEjB;;;;;OAKG;IACH,OAAO,EAAE,KAAK,CAAC;IAEf;;;;;OAKG;IACH,KAAK,EAAE,IAAI,CAAC;IACZ;;;;;;OAMG;IACH,MAAM,EAAE,IAAI,CAAC;IAEb;;;;;;;OAOG;IACH,KAAK,EAAE,IAAI,CAAC;IAEZ;;;;;OAKG;IACH,MAAM,EAAE,IAAI,CAAC;CACd;AAED;;;;;;GAMG;AACH,MAAM,WAAW,eAAe,CAAC,CAAC;IAChC;;;;OAIG;IACH,MAAM,EAAE,WAAW,CAAC;IAEpB;;;;OAIG;IACH,SAAS,EAAE,KAAK,CAAC;IAEjB;;;;;OAKG;IACH,SAAS,EAAE,KAAK,CAAC;IACjB;;;;;OAKG;IACH,SAAS,EAAE,IAAI,CAAC;IAEhB;;;;;OAKG;IACH,OAAO,EAAE,KAAK,CAAC;IAEf;;;;;OAKG;IACH,KAAK,EAAE,CAAC,CAAC;IAET;;;;;;OAMG;IACH,MAAM,EAAE,CAAC,CAAC;IAEV;;;;;;;OAOG;IACH,KAAK,EAAE,IAAI,CAAC;IAEZ;;;;;OAKG;IACH,MAAM,EAAE,IAAI,CAAC;CACd;AAED;;;;;;GAMG;AACH,MAAM,WAAW,eAAe,CAAC,CAAC;IAChC;;;;OAIG;IACH,MAAM,EAAE,UAAU,CAAC;IAEnB;;;;OAIG;IACH,SAAS,EAAE,KAAK,CAAC;IAEjB;;;;;OAKG;IACH,SAAS,EAAE,KAAK,CAAC;IAEjB;;;;;OAKG;IACH,SAAS,EAAE,KAAK,CAAC;IAEjB;;;;;OAKG;IACH,OAAO,EAAE,IAAI,CAAC;IAEd;;;;;OAKG;IACH,KAAK,EAAE,IAAI,CAAC;IAEZ;;;;;;OAMG;IACH,MAAM,EAAE,IAAI,CAAC;IAEb;;;;;;;OAOG;IACH,KAAK,EAAE,CAAC,CAAC;IAET;;;;;OAKG;IACH,MAAM,EAAE,CAAC,CAAC;CACX;AAED;;;;;;;;;;GAUG;AACH,MAAM,MAAM,YAAY,CAAC,CAAC,GAAG,OAAO,EAAE,CAAC,GAAG,OAAO,IAAI,cAAc,GAAG,eAAe,CAAC,CAAC,CAAC,GAAG,eAAe,CAAC,CAAC,CAAC,CAAC;AAgB9G,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,QAAQ,CAAC,YAAY,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CA4C5G;AAaD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoDG;AACH,wBAAgB,eAAe,CAAC,CAAC,GAAG,OAAO,EAAE,CAAC,GAAG,OAAO,EACtD,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,GACpC,QAAQ,CAAC,YAAY,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAU9B"}

package/unstable-preview-types/-private/new-core-tmp/request-state.d.ts

@@ -0,0 +1,276 @@
+declare module '@ember-data/store/-private/new-core-tmp/request-state' {
+  import type { Future, ImmutableRequestInfo, ResponseInfo, StructuredErrorDocument } from '@ember-data/request';
+  import type { PendingPromise, RejectedPromise, ResolvedPromise } from '@ember-data/store/-private/new-core-tmp/promise-state';
+  /**
+   * Lazily consumes the stream of a request, providing a number of
+   * reactive properties that can be used to build UIs that respond
+   * to the progress of a request.
+   *
+   * @typedoc
+   */
+  export class RequestLoadingState {
+      _sizeHint: number;
+      _bytesLoaded: number;
+      _startTime: number;
+      _endTime: number;
+      _lastPacketTime: number;
+      _isPending: boolean;
+      _isStarted: boolean;
+      _isComplete: boolean;
+      _isCancelled: boolean;
+      _isErrored: boolean;
+      _error: Error | null;
+      _stream: TransformStream | null;
+      _future: Future<unknown>;
+      _triggered: boolean;
+      _trigger(): void;
+      promise: Promise<void> | null;
+      get isPending(): boolean;
+      get sizeHint(): number;
+      get stream(): ReadableStream | null;
+      get isStarted(): boolean;
+      get bytesLoaded(): number;
+      get startTime(): number;
+      get endTime(): number;
+      get lastPacketTime(): number;
+      get isComplete(): boolean;
+      get isCancelled(): boolean;
+      get isErrored(): boolean;
+      get error(): Error | null;
+      get elapsedTime(): number;
+      get completedRatio(): number;
+      get remainingRatio(): number;
+      get duration(): number;
+      get speed(): number;
+      constructor(future: Future<unknown>);
+      abort: () => void;
+  }
+  /**
+   * The state of a request in the "pending"
+   * state. This is the default initial state.
+   *
+   * Extends the {@link PendingPromise} interface.
+   *
+   * @typedoc
+   */
+  export interface PendingRequest extends PendingPromise {
+      /**
+       * Whether the request is cancelled.
+       *
+       * @typedoc
+       */
+      isCancelled: false;
+      loadingState: RequestLoadingState;
+      request: null;
+      response: null;
+  }
+  /**
+   * The state of a request in the "fulfilled" state.
+   * This is the state of a request that has resolved
+   * successfully.
+   *
+   * Extends the {@link ResolvedPromise} interface.
+   *
+   * @typedoc
+   */
+  export interface ResolvedRequest<T, RT> extends ResolvedPromise<RT> {
+      /**
+       * Whether the request is cancelled.
+       *
+       * @typedoc
+       */
+      isCancelled: false;
+      loadingState: RequestLoadingState;
+      request: ImmutableRequestInfo<T, RT> | null;
+      response: Response | ResponseInfo | null;
+  }
+  /**
+   * The state of a request in the "rejected" state.
+   * This is the state of a request that has rejected
+   * with an error.
+   *
+   * Extends the {@link RejectedPromise} interface.
+   *
+   * @typedoc
+   */
+  export interface RejectedRequest<T, RT, E extends StructuredErrorDocument = StructuredErrorDocument> extends RejectedPromise<E> {
+      /**
+       * Whether the request is cancelled.
+       *
+       * @typedoc
+       */
+      isCancelled: false;
+      loadingState: RequestLoadingState;
+      request: ImmutableRequestInfo<T, RT> | null;
+      response: Response | ResponseInfo | null;
+  }
+  /**
+   * The state of a request in the "cancelled" state.
+   * This is the state of a promise that has been
+   * cancelled.
+   *
+   * @typedoc
+   */
+  export interface CancelledRequest<T, RT, E extends StructuredErrorDocument = StructuredErrorDocument> {
+      /**
+       * The status of the request.
+       *
+       * @typedoc
+       */
+      status: 'cancelled';
+      /**
+       * Whether the request is pending.
+       *
+       * @typedoc
+       */
+      isPending: false;
+      /**
+       * Whether the request is pending.
+       *
+       * @typedoc
+       */
+      isLoading: false;
+      /**
+       * Whether the request has resolved
+       * successfully.
+       *
+       * @typedoc
+       */
+      isSuccess: false;
+      /**
+       * Whether the request has rejected
+       * with an error.
+       *
+       * @typedoc
+       */
+      isError: true;
+      /**
+       * Once the request has resolved, this will
+       * be the value the request resolved to.
+       *
+       * @typedoc
+       */
+      value: null;
+      /**
+       * Once the request has resolved, this will
+       * be the value the request resolved to.
+       *
+       * @deprecated use `value` instead
+       * @typedoc
+       */
+      result: null;
+      /**
+       * Once the request has rejected, this will
+       * be the error the request rejected with.
+       *
+       *
+       * @deprecated use `reason` instead
+       * @typedoc
+       */
+      error: E;
+      /**
+       * Once the request has rejected, this will
+       * be the error the request rejected with.
+       *
+       * @typedoc
+       */
+      reason: E;
+      /**
+       * Whether the request is cancelled.
+       *
+       * @typedoc
+       */
+      isCancelled: true;
+      loadingState: RequestLoadingState;
+      request: ImmutableRequestInfo<T, RT> | null;
+      response: Response | ResponseInfo | null;
+  }
+  /**
+   * RequestState extends the concept of PromiseState to provide a reactive
+   * wrapper for a request `Future` which allows you write declarative code
+   * around a Future's control flow.
+   *
+   * It is useful in both Template and JavaScript contexts, allowing you
+   * to quickly derive behaviors and data from pending, error and success
+   * states.
+   *
+   * The key difference between a Promise and a Future is that Futures provide
+   * access to a stream of their content, the identity of the request (if any)
+   * as well as the ability to attempt to abort the request.
+   *
+   * ```ts
+   * interface Future<T> extends Promise<T>> {
+   *   getStream(): Promise<ReadableStream>;
+   *   abort(): void;
+   *   lid: StableDocumentIdentifier | null;
+   * }
+   * ```
+   *
+   * These additional APIs allow us to craft even richer state experiences.
+   *
+   * To get the state of a request, use `getRequestState`.
+   *
+   * See also:
+   * - {@link PendingRequest}
+   * - {@link ResolvedRequest}
+   * - {@link RejectedRequest}
+   * - {@link CancelledRequest}
+   *
+   * @typedoc
+   */
+  export type RequestCacheRequestState<T = unknown, RT = unknown, E extends StructuredErrorDocument = StructuredErrorDocument> = PendingRequest | ResolvedRequest<T, RT> | RejectedRequest<T, RT, E> | CancelledRequest<T, RT, E>;
+  export function createRequestState<T, RT, E>(future: Future<RT>): Readonly<RequestCacheRequestState<T, RT, StructuredErrorDocument<E>>>;
+  /**
+   * `getRequestState` can be used in both JavaScript and Template contexts.
+   *
+   * ```ts
+   * import { getRequestState } from '@warp-drive/ember';
+   *
+   * const state = getRequestState(future);
+   * ```
+   *
+   * For instance, we could write a getter on a component that updates whenever
+   * the request state advances or the future changes, by combining the function
+   * with the use of `@cached`
+   *
+   * ```ts
+   * class Component {
+   *   @cached
+   *   get title() {
+   *     const state = getRequestState(this.args.request);
+   *     if (state.isPending) {
+   *       return 'loading...';
+   *     }
+   *     if (state.isError) { return null; }
+   *     return state.result.title;
+   *   }
+   * }
+   * ```
+   *
+   * Or in a template as a helper:
+   *
+   * ```gjs
+   * import { getRequestState } from '@warp-drive/ember';
+   *
+   * <template>
+   *   {{#let (getRequestState @request) as |state|}}
+   *     {{#if state.isPending}}
+   *       <Spinner />
+   *     {{else if state.isError}}
+   *       <ErrorForm @error={{state.error}} />
+   *     {{else}}
+   *       <h1>{{state.result.title}}</h1>
+   *     {{/if}}
+   *   {{/let}}
+   * </template>
+   * ```
+   *
+   * If looking to use in a template, consider also the `<Request />` component
+   * which offers a numbe of additional capabilities for requests *beyond* what
+   * `RequestState` provides.
+   *
+   * @typedoc
+   */
+  export function getRequestState<RT, T, E>(future: Future<RT>): Readonly<RequestCacheRequestState<T, RT, StructuredErrorDocument<E>>>;
+}
+//# sourceMappingURL=request-state.d.ts.map

package/unstable-preview-types/-private/new-core-tmp/request-state.d.ts.map

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

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

@@ -10,7 +10,7 @@ declare module '@ember-data/store/-private' {
   export { constructResource } from '@ember-data/store/-private/utils/construct-resource';
   export type { ReactiveDocument as Document } from '@ember-data/store/-private/document';
   export type { InstanceCache } from '@ember-data/store/-private/caches/instance-cache';
-  export type { FindRecordQuery, Request, SaveRecordMutation, RequestState, RequestStateService, } from '@ember-data/store/-private/network/request-cache';
+  export type { FindRecordQuery, Request, SaveRecordMutation, RequestCacheRequestState, RequestStateService, } from '@ember-data/store/-private/network/request-cache';
   export type { CreateRecordProperties } from '@ember-data/store/-private/store-service';
   export { coerceId, ensureStringId } from '@ember-data/store/-private/utils/coerce-id';
   export type { NativeProxy } from '@ember-data/store/-private/record-arrays/native-proxy-type-fix';
@@ -24,5 +24,7 @@ declare module '@ember-data/store/-private' {
   export type { StoreRequestInput } from '@ember-data/store/-private/cache-handler/handler';
   export { RelatedCollection } from '@ember-data/store/-private/record-arrays/many-array';
   export { log, logGroup } from '@ember-data/store/-private/debug/utils';
+  export { getPromiseState, type PromiseState } from '@ember-data/store/-private/new-core-tmp/promise-state';
+  export { getRequestState, type RequestLoadingState, type RequestCacheRequestState as RequestState, } from '@ember-data/store/-private/new-core-tmp/request-state';
 }
 //# sourceMappingURL=-private.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"-private.d.ts","sourceRoot":"","sources":["../src/-private.ts"],"names":[],"mappings":"AAAA;;EAEE;AAEF,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAE3D,OAAO,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAEvE,OAAO,EAAE,YAAY,EAAE,KAAK,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAC1F,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAElE,OAAO,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,oCAAoC,CAAC;AAE9F,OAAO,EAAE,iBAAiB,EAAE,MAAM,qCAAqC,CAAC;AAExE,YAAY,EAAE,gBAAgB,IAAI,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AACxE,YAAY,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AAEtE,YAAY,EACV,eAAe,EACf,OAAO,EACP,kBAAkB,EAClB,YAAY,EACZ,mBAAmB,GACpB,MAAM,kCAAkC,CAAC;AAE1C,YAAY,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAIvE,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AACtE,YAAY,EAAE,WAAW,EAAE,MAAM,gDAAgD,CAAC;AAClF,OAAO,EACL,eAAe,IAAI,SAAS,EAC5B,UAAU,IAAI,qBAAqB,EACnC,WAAW,EACX,MAAM,EACN,MAAM,EACN,YAAY,GACb,MAAM,2CAA2C,CAAC;AACnD,OAAO,EAAE,kBAAkB,EAAE,QAAQ,EAAE,MAAM,0CAA0C,CAAC;AAGxF,OAAO,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AAChE,OAAO,EAAE,SAAS,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AAG/E,OAAO,EAAE,mBAAmB,EAAE,QAAQ,EAAE,MAAM,kCAAkC,CAAC;AACjF,OAAO,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAC5D,OAAO,EAAE,kBAAkB,IAAI,qBAAqB,EAAE,MAAM,uCAAuC,CAAC;AACpG,YAAY,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AAC1E,OAAO,EAAE,iBAAiB,EAAE,MAAM,qCAAqC,CAAC;AAExE,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC"}
+{"version":3,"file":"-private.d.ts","sourceRoot":"","sources":["../src/-private.ts"],"names":[],"mappings":"AAAA;;EAEE;AAEF,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAE3D,OAAO,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAEvE,OAAO,EAAE,YAAY,EAAE,KAAK,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAC1F,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAElE,OAAO,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,oCAAoC,CAAC;AAE9F,OAAO,EAAE,iBAAiB,EAAE,MAAM,qCAAqC,CAAC;AAExE,YAAY,EAAE,gBAAgB,IAAI,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AACxE,YAAY,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AAEtE,YAAY,EACV,eAAe,EACf,OAAO,EACP,kBAAkB,EAClB,wBAAwB,EACxB,mBAAmB,GACpB,MAAM,kCAAkC,CAAC;AAE1C,YAAY,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAIvE,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AACtE,YAAY,EAAE,WAAW,EAAE,MAAM,gDAAgD,CAAC;AAClF,OAAO,EACL,eAAe,IAAI,SAAS,EAC5B,UAAU,IAAI,qBAAqB,EACnC,WAAW,EACX,MAAM,EACN,MAAM,EACN,YAAY,GACb,MAAM,2CAA2C,CAAC;AACnD,OAAO,EAAE,kBAAkB,EAAE,QAAQ,EAAE,MAAM,0CAA0C,CAAC;AAGxF,OAAO,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AAChE,OAAO,EAAE,SAAS,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AAG/E,OAAO,EAAE,mBAAmB,EAAE,QAAQ,EAAE,MAAM,kCAAkC,CAAC;AACjF,OAAO,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAC5D,OAAO,EAAE,kBAAkB,IAAI,qBAAqB,EAAE,MAAM,uCAAuC,CAAC;AACpG,YAAY,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AAC1E,OAAO,EAAE,iBAAiB,EAAE,MAAM,qCAAqC,CAAC;AAExE,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,EAAE,eAAe,EAAE,KAAK,YAAY,EAAE,MAAM,uCAAuC,CAAC;AAC3F,OAAO,EACL,eAAe,EACf,KAAK,mBAAmB,EACxB,KAAK,wBAAwB,IAAI,YAAY,GAC9C,MAAM,uCAAuC,CAAC"}

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

@@ -20,6 +20,8 @@
 /// <reference path="./-private/cache-handler/utils.d.ts" />
 /// <reference path="./-private/cache-handler/handler.d.ts" />
 /// <reference path="./-private/cache-handler/types.d.ts" />
+/// <reference path="./-private/new-core-tmp/promise-state.d.ts" />
+/// <reference path="./-private/new-core-tmp/request-state.d.ts" />
 /// <reference path="./-private/network/request-cache.d.ts" />
 /// <reference path="./-private/legacy-model-support/record-reference.d.ts" />
 /// <reference path="./-private/legacy-model-support/shim-model-class.d.ts" />