@warp-drive-mirror/core 5.10.0-alpha.12 → 5.10.0-alpha.13

package/dist/unpkg/dev/types/request.js

@@ -2,15 +2,26 @@ import { getOrSetGlobal, getOrSetUniversal } from "./-private.js";
 
 //#region src/types/request.ts
 /**
+* @module
+* @summary Types for requests and responses: `RequestInfo`, the request shapes builders return, cache options, the
+* handler context and the documents a request's `Future` settles with.
+*/
+/**
 * A {@link RequestInfo.cacheOptions | cacheOptions} flag which, when set,
 * signals that a request should never be handled by the cache-manager and
 * thus will never resolve from cache nor update the cache.
+*
+* @summary Symbol key for a request's `cacheOptions` that, when true, makes the request bypass the CacheHandler so it
+* neither resolves from nor updates the cache.
 */
 const SkipCache = getOrSetUniversal("SkipCache", Symbol.for("wd:skip-cache"));
 /**
 * A {@link RequestInfo} flag which, when set, signals to the store's
 * `instantiateRecord` hook that the resolved content should be hydrated
 * into reactive records rather than returned as raw data.
+*
+* @summary Symbol flag on a request that makes the CacheHandler return reactive records instead of raw cache
+* documents; `store.request` sets it automatically.
 */
 const EnableHydration = getOrSetUniversal("EnableHydration", Symbol.for("wd:enable-hydration"));
 /**
@@ -23,61 +34,104 @@ const IS_FUTURE = getOrSetGlobal("IS_FUTURE", Symbol("IS_FUTURE"));
 const STRUCTURED = getOrSetGlobal("DOC", Symbol("DOC"));
 /**
 * The HTTP methods WarpDrive's request layer supports.
+*
+* @summary Union of the HTTP method strings, including `QUERY`, that a WarpDrive request's `method` may be set to.
 */
 /**
 * Use these options to adjust {@link CacheHandler} behavior for a request
 * via {@link RequestInfo.cacheOptions}.
 *
+* @summary Per-request settings on `cacheOptions` that control the cache key, forced or background reloads,
+* invalidation by resource type, and cache bypass.
 */
 /**
 * The request shape produced by the `findRecord` request builders, for
 * use with {@link Store.request}.
+*
+* @summary Shape of the `GET` request object that `findRecord` builders return for `store.request`, carrying the url,
+* headers, and requested resource identifier.
 */
 /**
 * The request shape produced by the `query` request builders, for
 * use with {@link Store.request}.
+*
+* @summary Shape of the `GET` request object that `query` builders return for `store.request`, carrying the url,
+* headers, and cache options.
 */
 /**
 * The request shape produced by the `postQuery` request builders, for
 * use with {@link Store.request}.
+*
+* @summary Shape of the `POST` or `QUERY` request object that `postQuery` builders return, with a body and a required
+* cache key since the url cannot serve as one.
 */
 /**
 * The request shape produced by the `deleteRecord` request builders, for
 * use with {@link Store.request}.
+*
+* @summary Shape of the `DELETE` request object that `deleteRecord` builders return for `store.request`, identifying
+* the resource being deleted.
 */
 /**
 * The request shape produced by the `updateRecord` request builders, for
 * use with {@link Store.request}.
+*
+* @summary Shape of the `PATCH` or `PUT` request object that `updateRecord` builders return for `store.request`,
+* identifying the resource being saved.
 */
 /**
 * The request shape produced by the `createRecord` request builders, for
 * use with {@link Store.request}.
+*
+* @summary Shape of the `POST` request object that `createRecord` builders return for `store.request`, identifying the
+* new resource being saved.
 */
 /**
 * The immutable, handler-facing form of {@link DeleteRequestOptions}.
+*
+* @summary Read-only view of a `deleteRecord` request as a handler receives it, with immutable headers and `records`
+* as resource keys.
 */
 /**
 * The immutable, handler-facing form of {@link UpdateRequestOptions}.
+*
+* @summary Read-only view of an `updateRecord` request as a handler receives it, with immutable headers and `records`
+* as resource keys.
 */
 /**
 * The immutable, handler-facing form of {@link CreateRequestOptions}.
+*
+* @summary Read-only view of a `createRecord` request as a handler receives it, with immutable headers and `records`
+* as resource keys.
 */
 /**
 * A minimal reference to a resource sufficient to build a URL for it,
 * as accepted by the request builders.
+*
+* @summary A resource reference with a persisted `id` and `type` and an optional `lid`, which is enough for request
+* builders to construct its url.
 */
 /**
 * Options accepted by the request builders for constraining how a
 * request's url is constructed and how the request interacts with the cache.
+*
+* @summary Options the request builders accept to set reload behavior and override the url's host, namespace, resource
+* path, and query param serialization.
 */
 /**
 * Options accepted by the `findRecord` request builders.
+*
+* @summary Options the `findRecord` request builders accept: the shared url and reload options plus the relationship
+* paths to `include`.
 */
 /**
 * When a {@link Future} resolves, it returns an object
 * containing the original {@link RequestInfo | request},
 * the {@link Response | response} set by the handler chain (if any), and
 * the processed content.
+*
+* @summary The `{ request, response, content }` object that a request's `Future` resolves with when the request
+* succeeds.
 */
 /**
 * When a {@link Future} rejects, it throws either an {@link Error}
@@ -87,16 +141,24 @@ const STRUCTURED = getOrSetGlobal("DOC", Symbol("DOC"));
 *
 * If using the error originates from the {@link Fetch | Fetch Handler}
 * the error will be a {@link FetchError}
+*
+* @summary The Error a request's `Future` rejects with when the request fails, carrying the `request`, `response`,
+* `error`, and any `content` received.
 */
 /**
 * A union of the resolve/reject data types for the {@link Future}
 * returned by {@link Store.request | request}
 *
+* The [Using The Response](/guides/the-manual/requests/using-the-response) guide shows
+* how to read one.
+*
 * See also the docs for:
 *
 * - {@link Future}
 * - {@link StructuredDataDocument} (resolved/successful requests)
 * - {@link StructuredErrorDocument} (rejected/failed requests)
+*
+* @summary Union of the success and error documents that a request's `Future` resolves or rejects with.
 */
 /**
 * The {@link RequestInit} interface accepted by the native {@link fetch} API.
@@ -112,6 +174,9 @@ const STRUCTURED = getOrSetGlobal("DOC", Symbol("DOC"));
 /**
 * A read-only {@link Headers} instance, as passed to {@link Handler | Handlers}
 * via {@link ImmutableRequestInfo.headers}.
+*
+* @summary Read-only `Headers` that handlers see on a request, adding `toJSON` to serialize them as `[key, value]`
+* pairs and an optional mutable `clone`.
 */
 /**
 * Extends JavaScript's native {@link fetch} {@link NativeRequestInit | RequestInit} with additional
@@ -120,6 +185,11 @@ const STRUCTURED = getOrSetGlobal("DOC", Symbol("DOC"));
 * This interface is used to define the shape of a request that can be made via
 * either the {@link RequestManager.request} or {@link Store.request} methods.
 *
+* The [Making Requests](/guides/the-manual/requests/#request-options) guide explains
+* its options.
+*
+* @summary Describes a request for `store.request` or `RequestManager.request`: native fetch options plus cache
+* options, operation name, records, data, and the store.
 * @privateRemarks
 * - [MDN Reference (fetch)](https://developer.mozilla.org/docs/Web/API/Window/fetch)
 * - [MDN Reference (RequestInit)](https://developer.mozilla.org/en-US/docs/Web/API/RequestInit)
@@ -131,15 +201,25 @@ const STRUCTURED = getOrSetGlobal("DOC", Symbol("DOC"));
 /**
 * Immutable version of {@link RequestInfo}. This is what is passed to handlers.
 *
+* @summary Read-only form of a request as handlers receive it, with frozen headers, data, options, and cache options
+* and no `controller`.
 */
 /**
 * An immutable, JSON-serializable subset of the native {@link Response}
 * interface.
+*
+* @summary Immutable, JSON-serializable snapshot of a fetch `Response`'s headers, status, url, and type, usable in
+* place of a `Response` in request results.
 */
 /**
 * The object a {@link Handler} uses to fulfill a request: it provides a
 * readonly view of the {@link RequestContext.request | request} and methods
 * for supplying the {@link Future}'s stream and final response.
+*
+* The [Handlers](/guides/the-manual/requests/handlers) guide shows a handler using it.
+*
+* @summary Object passed to each request handler with the immutable request, a request id, and methods for setting the
+* response stream and the response.
 */
 //#endregion
 export { EnableHydration, IS_FUTURE, STRUCTURED, SkipCache };

package/dist/unpkg/dev/types/request.js.map

@@ -1 +1 @@
-{"version":3,"file":"request.js","names":["getOrSetGlobal","getOrSetUniversal","SkipCache","Symbol","for","EnableHydration","IS_FUTURE","STRUCTURED"],"sources":["../../../../src/types/request.ts"],"sourcesContent":["// oxlint-disable-next-line no-unused-vars\nimport type { Future, Handler } from '../request.ts';\n// oxlint-disable-next-line no-unused-vars\nimport type { Fetch } from '../request/-private/fetch.ts';\n// oxlint-disable-next-line no-unused-vars\nimport type { RequestManager } from '../request/-private/manager.ts';\nimport type { FetchError } from '../request/-private/utils.ts';\n// oxlint-disable-next-line no-unused-vars\nimport type { RequestLoadingState } from '../signals/request-state.ts';\nimport type { Store } from '../store/-private.ts';\nimport { getOrSetGlobal, getOrSetUniversal } from './-private.ts';\nimport type { ResourceKey } from './identifier.ts';\nimport type { QueryParamsSerializationOptions } from './params.ts';\nimport type {\n  // oxlint-disable-next-line no-unused-vars\n  Includes,\n  TypeFromInstanceOrString,\n} from './record.ts';\nimport type { ResourceIdentifierObject } from './spec/json-api-raw.ts';\nimport type { RequestSignature } from './symbols.ts';\n\n/**\n * A {@link RequestInfo.cacheOptions | cacheOptions} flag which, when set,\n * signals that a request should never be handled by the cache-manager and\n * thus will never resolve from cache nor update the cache.\n */\nexport const SkipCache: '___(unique) Symbol(SkipCache)' = getOrSetUniversal('SkipCache', Symbol.for('wd:skip-cache'));\n/**\n * A {@link RequestInfo} flag which, when set, signals to the store's\n * `instantiateRecord` hook that the resolved content should be hydrated\n * into reactive records rather than returned as raw data.\n */\nexport const EnableHydration: '___(unique) Symbol(EnableHydration)' = getOrSetUniversal(\n  'EnableHydration',\n  Symbol.for('wd:enable-hydration')\n);\n/**\n * @private\n */\nexport const IS_FUTURE: '___(unique) Symbol(IS_FUTURE)' = getOrSetGlobal('IS_FUTURE', Symbol('IS_FUTURE'));\n/**\n * @private\n */\nexport const STRUCTURED: '___(unique) Symbol(DOC)' = getOrSetGlobal('DOC', Symbol('DOC'));\n\nexport type { FetchError };\n\n/**\n * The HTTP methods WarpDrive's request layer supports.\n */\nexport type HTTPMethod =\n  | 'QUERY'\n  | 'GET'\n  | 'OPTIONS'\n  | 'POST'\n  | 'PUT'\n  | 'PATCH'\n  | 'DELETE'\n  | 'HEAD'\n  | 'CONNECT'\n  | 'TRACE';\n\n/**\n * Use these options to adjust {@link CacheHandler} behavior for a request\n * via {@link RequestInfo.cacheOptions}.\n *\n */\nexport interface CacheOptions {\n  /**\n   * A key that uniquely identifies this request. If not present, the url wil be used\n   * as the key for any GET request, while all other requests will not be cached.\n   *\n   */\n  key?: string;\n  /**\n   * If true, the request will be made even if a cached response is present\n   * and not expired.\n   *\n   */\n  reload?: boolean;\n  /**\n   * If true, and a cached response is present and not expired, the request\n   * will be made in the background and the cached response will be returned.\n   *\n   */\n  backgroundReload?: boolean;\n  /**\n   * Useful for metadata around when to invalidate the cache. Typically used\n   * by strategies that invalidate requests by resource type when a new resource\n   * of that type has been created. See the CachePolicy implementation\n   * provided by `@ember-data-mirror/request-utils` for an example.\n   *\n   * It is recommended to only use this for query/queryRecord requests where\n   * new records created later would affect the results, though using it for\n   * findRecord requests is also supported if desired where it may be useful\n   * when a create may affect the result of a sideloaded relationship.\n   *\n   * Generally it is better to patch the cache directly for relationship updates\n   * than to invalidate findRecord requests for one.\n   *\n   */\n  // TODO: Ideally this would be T extends TypedRecordInstance ? ExtractSuggestedCacheTypes<T>[] : string[];\n  // but that leads to `Type instantiation is excessively deep and possibly infinite.`\n  // issues when `T` has many properties.\n  types?: string[];\n\n  /**\n   * If true, the request will never be handled by the cache-manager and thus\n   * will never resolve from cache nor update the cache.\n   *\n   * Generally this is only used for legacy request that manage resource cache\n   * updates in a non-standard way via the LegacyNetworkHandler.\n   *\n   */\n  [SkipCache]?: boolean;\n}\n/**\n * The request shape produced by the `findRecord` request builders, for\n * use with {@link Store.request}.\n */\nexport type FindRecordRequestOptions<RT = unknown, T = unknown> = {\n  /**\n   * the url to request\n   */\n  url: string;\n  /**\n   * the HTTP method to use\n   */\n  method: 'GET';\n  /**\n   * the headers to send with the request\n   */\n  headers: Headers;\n  /**\n   * see {@link CacheOptions}\n   */\n  cacheOptions?: CacheOptions;\n  /**\n   * the name of the request operation\n   */\n  op: 'findRecord';\n  /**\n   * the resource being requested\n   */\n  records: [ResourceIdentifierObject<TypeFromInstanceOrString<T>>];\n  /**\n   * @private used only to carry the response type for type inference purposes\n   */\n  [RequestSignature]?: RT;\n};\n\n/**\n * The request shape produced by the `query` request builders, for\n * use with {@link Store.request}.\n */\nexport type QueryRequestOptions<RT = unknown> = {\n  /**\n   * the url to request\n   */\n  url: string;\n  /**\n   * the HTTP method to use\n   */\n  method: 'GET';\n  /**\n   * the headers to send with the request\n   */\n  headers: Headers;\n  /**\n   * see {@link CacheOptions}\n   */\n  cacheOptions?: CacheOptions;\n  /**\n   * the name of the request operation\n   */\n  op: 'query';\n  /**\n   * @private used only to carry the response type for type inference purposes\n   */\n  [RequestSignature]?: RT;\n};\n\n/**\n * The request shape produced by the `postQuery` request builders, for\n * use with {@link Store.request}.\n */\nexport type PostQueryRequestOptions<RT = unknown> = {\n  /**\n   * the url to request\n   */\n  url: string;\n  /**\n   * the HTTP method to use\n   */\n  method: 'POST' | 'QUERY';\n  /**\n   * the headers to send with the request\n   */\n  headers: Headers;\n  /**\n   * the body to send with the request\n   */\n  body?: string | BodyInit | FormData;\n  /**\n   * see {@link CacheOptions}. A `key` is required since `POST`/`QUERY`\n   * requests otherwise have no cache-safe way to derive one from the url.\n   */\n  cacheOptions: CacheOptions & {\n    /**\n     * a key that uniquely identifies this request\n     */\n    key: string;\n  };\n  /**\n   * the name of the request operation\n   */\n  op: 'query';\n  /**\n   * @private used only to carry the response type for type inference purposes\n   */\n  [RequestSignature]?: RT;\n};\n\n/**\n * The request shape produced by the `deleteRecord` request builders, for\n * use with {@link Store.request}.\n */\nexport type DeleteRequestOptions<RT = unknown, T = unknown> = {\n  /**\n   * the url to request\n   */\n  url: string;\n  /**\n   * the HTTP method to use\n   */\n  method: 'DELETE';\n  /**\n   * the headers to send with the request\n   */\n  headers: Headers;\n  /**\n   * the name of the request operation\n   */\n  op: 'deleteRecord';\n  /**\n   * the body to send with the request\n   */\n  body?: string | BodyInit | FormData;\n  /**\n   * data for handlers to convert into the request body\n   */\n  data: {\n    /**\n     * the resource being deleted\n     */\n    record: ResourceKey<TypeFromInstanceOrString<T>>;\n  };\n  /**\n   * the resource being deleted\n   */\n  records: [ResourceIdentifierObject<TypeFromInstanceOrString<T>>];\n  /**\n   * @private used only to carry the response type for type inference purposes\n   */\n  [RequestSignature]?: RT;\n};\n\ntype ImmutableRequest<T> = Readonly<T> & {\n  readonly headers: ImmutableHeaders;\n  readonly records: [ResourceKey];\n};\n\n/**\n * The request shape produced by the `updateRecord` request builders, for\n * use with {@link Store.request}.\n */\nexport type UpdateRequestOptions<RT = unknown, T = unknown> = {\n  /**\n   * the url to request\n   */\n  url: string;\n  /**\n   * the HTTP method to use\n   */\n  method: 'PATCH' | 'PUT';\n  /**\n   * the headers to send with the request\n   */\n  headers: Headers;\n  /**\n   * the name of the request operation\n   */\n  op: 'updateRecord';\n  /**\n   * the body to send with the request\n   */\n  body?: string | BodyInit | FormData;\n  /**\n   * data for handlers to convert into the request body\n   */\n  data: {\n    /**\n     * the resource being updated\n     */\n    record: ResourceKey<TypeFromInstanceOrString<T>>;\n  };\n  /**\n   * the resource being updated\n   */\n  records: [ResourceIdentifierObject<TypeFromInstanceOrString<T>>];\n  /**\n   * @private used only to carry the response type for type inference purposes\n   */\n  [RequestSignature]?: RT;\n};\n\n/**\n * The request shape produced by the `createRecord` request builders, for\n * use with {@link Store.request}.\n */\nexport type CreateRequestOptions<RT = unknown, T = unknown> = {\n  /**\n   * the url to request\n   */\n  url: string;\n  /**\n   * the HTTP method to use\n   */\n  method: 'POST';\n  /**\n   * the headers to send with the request\n   */\n  headers: Headers;\n  /**\n   * the name of the request operation\n   */\n  op: 'createRecord';\n  /**\n   * the body to send with the request\n   */\n  body?: string | BodyInit | FormData;\n  /**\n   * data for handlers to convert into the request body\n   */\n  data: {\n    /**\n     * the resource being created\n     */\n    record: ResourceKey<TypeFromInstanceOrString<T>>;\n  };\n  /**\n   * the resource being created\n   */\n  records: [ResourceIdentifierObject<TypeFromInstanceOrString<T>>];\n  /**\n   * @private used only to carry the response type for type inference purposes\n   */\n  [RequestSignature]?: RT;\n};\n\n/**\n * The immutable, handler-facing form of {@link DeleteRequestOptions}.\n */\nexport type ImmutableDeleteRequestOptions = ImmutableRequest<DeleteRequestOptions>;\n/**\n * The immutable, handler-facing form of {@link UpdateRequestOptions}.\n */\nexport type ImmutableUpdateRequestOptions = ImmutableRequest<UpdateRequestOptions>;\n/**\n * The immutable, handler-facing form of {@link CreateRequestOptions}.\n */\nexport type ImmutableCreateRequestOptions = ImmutableRequest<CreateRequestOptions>;\n\n/**\n * A minimal reference to a resource sufficient to build a URL for it,\n * as accepted by the request builders.\n */\nexport type RemotelyAccessibleIdentifier<T extends string = string> = {\n  /**\n   * the resource's persisted id\n   */\n  id: string;\n  /**\n   * the resource's type\n   */\n  type: T;\n  /**\n   * the local identifier WarpDrive has assigned to the resource, if known\n   */\n  lid?: string;\n};\n\n/**\n * Options accepted by the request builders for constraining how a\n * request's url is constructed and how the request interacts with the cache.\n */\nexport interface ConstrainedRequestOptions {\n  /**\n   * If true, the request will be made even if a cached response is present\n   * and not expired.\n   */\n  reload?: boolean;\n  /**\n   * If true, and a cached response is present and not expired, the request\n   * will be made in the background and the cached response will be returned.\n   */\n  backgroundReload?: boolean;\n  /**\n   * The host to use when constructing the request's url, overriding any\n   * host configured via `setBuildURLConfig`.\n   */\n  host?: string;\n  /**\n   * The namespace to use when constructing the request's url, overriding\n   * any namespace configured via `setBuildURLConfig`.\n   */\n  namespace?: string;\n  /**\n   * The resource path to use when constructing the request's url,\n   * overriding the default of pluralizing the resource's type.\n   */\n  resourcePath?: string;\n  /**\n   * Options for how to serialize the request's query params, see {@link QueryParamsSerializationOptions}.\n   */\n  urlParamsSettings?: QueryParamsSerializationOptions;\n}\n\n/**\n * Options accepted by the `findRecord` request builders.\n */\nexport interface FindRecordOptions extends ConstrainedRequestOptions {\n  /**\n   * the relationship paths to sideload, see {@link Includes}\n   */\n  include?: string | string[];\n}\n\n/**\n * When a {@link Future} resolves, it returns an object\n * containing the original {@link RequestInfo | request},\n * the {@link Response | response} set by the handler chain (if any), and\n * the processed content.\n */\nexport interface StructuredDataDocument<T> {\n  /**\n   * @private\n   */\n  [STRUCTURED]?: true;\n  /**\n   * @see {@link ImmutableRequestInfo}\n   */\n  request: ImmutableRequestInfo;\n  /**\n   * the response set by the handler chain, if any\n   */\n  response: Response | ResponseInfo | null;\n  /**\n   * the processed content of the response\n   */\n  content: T;\n}\n\n/**\n * When a {@link Future} rejects, it throws either an {@link Error}\n * an {@link AggregateError} or a {@link DOMException} that maintains\n * the `{ request, response, content }` shape but is also an Error instance\n * itself.\n *\n * If using the error originates from the {@link Fetch | Fetch Handler}\n * the error will be a {@link FetchError}\n */\nexport interface StructuredErrorDocument<T = unknown> extends Error {\n  /**\n   * @private\n   */\n  [STRUCTURED]?: true;\n  /**\n   * @see {@link ImmutableRequestInfo}\n   */\n  request: ImmutableRequestInfo;\n  /**\n   * the response set by the handler chain, if any\n   */\n  response: Response | ResponseInfo | null;\n  /**\n   * the error that caused the request to fail\n   */\n  error: string | object;\n  /**\n   * the processed content of the response, if any was received before the failure\n   */\n  content?: T;\n}\n\n/**\n * A union of the resolve/reject data types for the {@link Future}\n * returned by {@link Store.request | request}\n *\n * See also the docs for:\n *\n * - {@link Future}\n * - {@link StructuredDataDocument} (resolved/successful requests)\n * - {@link StructuredErrorDocument} (rejected/failed requests)\n */\nexport type StructuredDocument<T> = StructuredDataDocument<T> | StructuredErrorDocument<T>;\n\n/**\n * The {@link RequestInit} interface accepted by the native {@link fetch} API.\n *\n * WarpDrive provides our own typings due to incompleteness in the native typings.\n *\n * @privateRemarks\n * - [MDN Reference (fetch)](https://developer.mozilla.org/docs/Web/API/Window/fetch)\n * - [MDN Reference (RequestInit)](https://developer.mozilla.org/en-US/docs/Web/API/RequestInit)\n * - [MDN Reference (Request)](https://developer.mozilla.org/docs/Web/API/Request)\n *\n */\ninterface NativeRequestInit {\n  /** Returns the cache mode associated with request, which is a string indicating how the request will interact with the browser's cache when fetching.\n   */\n  cache?: RequestCache;\n  /** Returns the credentials mode associated with request, which is a string indicating whether credentials will be sent with the request always, never, or only when sent to a same-origin URL.\n   */\n  credentials?: RequestCredentials;\n  /** Returns the kind of resource requested by request, e.g., \"document\" or \"script\".\n   */\n  destination?: RequestDestination;\n  /** Returns a Headers object consisting of the headers associated with request. Note that headers added in the network layer by the user agent will not be accounted for in this object, e.g., the \"Host\" header.\n   */\n  headers?: Headers;\n  /** Returns request's subresource integrity metadata, which is a cryptographic hash of the resource being fetched. Its value consists of multiple hashes separated by whitespace. [SRI]\n   */\n  integrity?: string;\n  /** Returns a boolean indicating whether or not request can outlive the global in which it was created.\n   */\n  keepalive?: boolean;\n  /** Returns request's HTTP method, which is \"GET\" by default.\n   */\n  method?: HTTPMethod;\n  /** Returns the mode associated with request, which is a string indicating whether the request will use CORS, or will be restricted to same-origin URLs.\n   *\n   * `no-cors` is not allowed for streaming request bodies.\n   *\n   */\n  mode?: RequestMode;\n  /**\n   * provides an explicit priority hint for the request.\n   */\n  priority?: RequestPriority;\n  /** Returns the redirect mode associated with request, which is a string indicating how redirects for the request will be handled during fetching. A request will follow redirects by default.\n   */\n  redirect?: RequestRedirect;\n  /** Returns the referrer of request. Its value can be a same-origin URL if explicitly set in init, the empty string to indicate no referrer, and \"about:client\" when defaulting to the global's default. This is used during fetching to determine the value of the `Referer` header of the request being made.\n   */\n  referrer?: string;\n  /** Returns the referrer policy associated with request. This is used during fetching to compute the value of the request's referrer.\n   */\n  referrerPolicy?: ReferrerPolicy;\n  /** Returns the signal associated with request, which is an AbortSignal object indicating whether or not request has been aborted, and its abort event handler.\n   */\n  signal?: AbortSignal;\n  /** Returns the URL of request as a string.\n   */\n  url?: string;\n  /** Any body that you want to add to your request. Note that a GET or HEAD request may not have a body.\n   */\n  body?: BodyInit | null;\n\n  /**\n   * When sending a ReadableStream as the body of a request, 'half' must be\n   * specified.\n   *\n   * [Half Duplex Further Reading](https://developer.chrome.com/docs/capabilities/web-apis/fetch-streaming-requests#half_duplex)\n   *\n   */\n  duplex?: 'half';\n}\n\n/**\n * A read-only {@link Headers} instance, as passed to {@link Handler | Handlers}\n * via {@link ImmutableRequestInfo.headers}.\n */\nexport interface ImmutableHeaders extends Headers {\n  /**\n   * Returns a mutable clone of these headers, if supported by the implementation.\n   */\n  clone?(): Headers;\n  /**\n   * Returns the headers as an array of `[key, value]` pairs.\n   */\n  toJSON(): [string, string][];\n}\n\n/**\n * Extends JavaScript's native {@link fetch} {@link NativeRequestInit | RequestInit} with additional\n * properties specific to the {@link RequestManager | RequestManager's} capabilities.\n *\n * This interface is used to define the shape of a request that can be made via\n * either the {@link RequestManager.request} or {@link Store.request} methods.\n *\n * @privateRemarks\n * - [MDN Reference (fetch)](https://developer.mozilla.org/docs/Web/API/Window/fetch)\n * - [MDN Reference (RequestInit)](https://developer.mozilla.org/en-US/docs/Web/API/RequestInit)\n * - [MDN Reference (Request)](https://developer.mozilla.org/docs/Web/API/Request)\n *\n * @public\n * @since 4.12\n */\nexport interface RequestInfo<RT = unknown> extends NativeRequestInit {\n  /**\n   * If provided, used instead of the AbortController auto-configured for each request by the RequestManager\n   *\n   */\n  controller?: AbortController;\n\n  /**\n   * @see {@link CacheOptions}\n   */\n  cacheOptions?: CacheOptions;\n  /**\n   * The {@link Store} the request was made against, if made via\n   * {@link Store.request} rather than directly against a {@link RequestManager}.\n   *\n   * A {@link Handler} can read this off of {@link RequestContext.request | context.request}\n   * to reach store state (the cache, other services attached to a custom\n   * store subclass, etc.) without needing any Ember DI/`setOwner` wiring at\n   * handler-construction time. This works for a handler of any shape (a\n   * function, plain object, or class) because the store is attached to each\n   * request individually rather than to the handler itself.\n   *\n   * The trade-off is that this is only populated for requests issued via\n   * {@link Store.request | store.request(...)}; a request issued directly\n   * against a {@link RequestManager} will not have it set unless the caller\n   * supplies it explicitly. Handlers that rely on it should treat it as\n   * optional.\n   *\n   * @example\n   * ```ts\n   * const LoggingHandler = {\n   *   request<T>(context: RequestContext, next: NextFn<T>) {\n   *     const store = context.request.store;\n   *     if (store) {\n   *       console.log(`[${store.constructor.name}] ${context.request.url ?? ''}`);\n   *     }\n   *     return next(context.request);\n   *   },\n   * };\n   * ```\n   */\n  store?: Store;\n\n  /**\n   * The name of the request operation, if any (e.g. `'findRecord'`, `'query'`).\n   */\n  op?: string;\n\n  /**\n   * The {@link ResourceKey | ResourceKeys} of the primary resources involved in the request\n   * (if any). This may be used by handlers to perform transactional\n   * operations on the store.\n   *\n   */\n  records?: ResourceKey[];\n\n  /**\n   * If true, this request will not be tracked by test waiters.\n   */\n  disableTestWaiter?: boolean;\n  /**\n   * data that a handler should convert into\n   * the query (GET) or body (POST).\n   *\n   * Note: It is recommended that builders set query params\n   * and body directly in most scenarios.\n   *\n   */\n  data?: Record<string, unknown>;\n  /**\n   * options specifically intended for {@link Handler | Handlers}\n   * to utilize to process the request\n   *\n   */\n  options?: Record<string, unknown>;\n\n  /**\n   * @private used only to carry the response type for type inference purposes\n   */\n  [RequestSignature]?: RT;\n\n  /**\n   * see {@link EnableHydration}\n   */\n  [EnableHydration]?: boolean;\n}\n\n/**\n * Immutable version of {@link RequestInfo}. This is what is passed to handlers.\n *\n */\nexport type ImmutableRequestInfo<RT = unknown> = Readonly<Omit<RequestInfo<RT>, 'controller'>> & {\n  /**\n   * see {@link CacheOptions}\n   */\n  readonly cacheOptions?: Readonly<CacheOptions>;\n  /**\n   * see {@link ImmutableHeaders}\n   */\n  readonly headers?: ImmutableHeaders;\n  /**\n   * see {@link RequestInfo.data}\n   */\n  readonly data?: Readonly<Record<string, unknown>>;\n  /**\n   * see {@link RequestInfo.options}\n   */\n  readonly options?: Readonly<Record<string, unknown>>;\n\n  /** Whether the request body has been read.\n   */\n  readonly bodyUsed?: boolean;\n};\n\n/**\n * An immutable, JSON-serializable subset of the native {@link Response}\n * interface.\n */\nexport interface ResponseInfo {\n  /**\n   * see {@link ImmutableHeaders}\n   */\n  readonly headers: ImmutableHeaders; // to do, maybe not this?\n  /**\n   * whether the response's status code was in the 200-299 range\n   */\n  readonly ok: boolean;\n  /**\n   * whether the response is the result of a redirect\n   */\n  readonly redirected: boolean;\n  /**\n   * the response's HTTP status code\n   */\n  readonly status: number;\n  /**\n   * the status message associated with the response's status code\n   */\n  readonly statusText: string;\n  /**\n   * the type of the response, see [MDN Reference](https://developer.mozilla.org/docs/Web/API/Response/type)\n   */\n  readonly type: ResponseType;\n  /**\n   * the url of the response\n   */\n  readonly url: string;\n}\n\n/**\n * The object a {@link Handler} uses to fulfill a request: it provides a\n * readonly view of the {@link RequestContext.request | request} and methods\n * for supplying the {@link Future}'s stream and final response.\n */\nexport interface RequestContext {\n  /**\n   * @see {@link ImmutableRequestInfo}\n   */\n  request: ImmutableRequestInfo;\n  /**\n   * a unique id for this request\n   */\n  id: number;\n\n  /**\n   * Supplies the stream of the response's content, if available, enabling\n   * consumers to monitor download progress via {@link RequestLoadingState}.\n   */\n  setStream(stream: ReadableStream | Promise<ReadableStream | null>): void;\n  /**\n   * Supplies the response for the request.\n   */\n  setResponse(response: Response | ResponseInfo | null): void;\n}\n"],"mappings":";;;;;;;;AA0BA,MAAaE,YAA6CD,kBAAkB,aAAaE,OAAOC,IAAI,eAAe,CAAC;;;;;;AAMpH,MAAaC,kBAAyDJ,kBACpE,mBACAE,OAAOC,IAAI,qBAAqB,CAClC;;;;AAIA,MAAaE,YAA6CN,eAAe,aAAaG,OAAO,WAAW,CAAC;;;;AAIzG,MAAaI,aAAwCP,eAAe,OAAOG,OAAO,KAAK,CAAC"}
+{"version":3,"file":"request.js","names":["getOrSetGlobal","getOrSetUniversal","SkipCache","Symbol","for","EnableHydration","IS_FUTURE","STRUCTURED"],"sources":["../../../../src/types/request.ts"],"sourcesContent":["/**\n * @module\n * @summary Types for requests and responses: `RequestInfo`, the request shapes builders return, cache options, the\n * handler context and the documents a request's `Future` settles with.\n */\n\n// oxlint-disable-next-line no-unused-vars\nimport type { Future, Handler } from '../request.ts';\n// oxlint-disable-next-line no-unused-vars\nimport type { Fetch } from '../request/-private/fetch.ts';\n// oxlint-disable-next-line no-unused-vars\nimport type { RequestManager } from '../request/-private/manager.ts';\nimport type { FetchError } from '../request/-private/utils.ts';\n// oxlint-disable-next-line no-unused-vars\nimport type { RequestLoadingState } from '../signals/request-state.ts';\nimport type { Store } from '../store/-private.ts';\nimport { getOrSetGlobal, getOrSetUniversal } from './-private.ts';\nimport type { ResourceKey } from './identifier.ts';\nimport type { QueryParamsSerializationOptions } from './params.ts';\nimport type {\n  // oxlint-disable-next-line no-unused-vars\n  Includes,\n  TypeFromInstanceOrString,\n} from './record.ts';\nimport type { ResourceIdentifierObject } from './spec/json-api-raw.ts';\nimport type { RequestSignature } from './symbols.ts';\n\n/**\n * A {@link RequestInfo.cacheOptions | cacheOptions} flag which, when set,\n * signals that a request should never be handled by the cache-manager and\n * thus will never resolve from cache nor update the cache.\n *\n * @summary Symbol key for a request's `cacheOptions` that, when true, makes the request bypass the CacheHandler so it\n * neither resolves from nor updates the cache.\n */\nexport const SkipCache: '___(unique) Symbol(SkipCache)' = getOrSetUniversal('SkipCache', Symbol.for('wd:skip-cache'));\n/**\n * A {@link RequestInfo} flag which, when set, signals to the store's\n * `instantiateRecord` hook that the resolved content should be hydrated\n * into reactive records rather than returned as raw data.\n *\n * @summary Symbol flag on a request that makes the CacheHandler return reactive records instead of raw cache\n * documents; `store.request` sets it automatically.\n */\nexport const EnableHydration: '___(unique) Symbol(EnableHydration)' = getOrSetUniversal(\n  'EnableHydration',\n  Symbol.for('wd:enable-hydration')\n);\n/**\n * @private\n */\nexport const IS_FUTURE: '___(unique) Symbol(IS_FUTURE)' = getOrSetGlobal('IS_FUTURE', Symbol('IS_FUTURE'));\n/**\n * @private\n */\nexport const STRUCTURED: '___(unique) Symbol(DOC)' = getOrSetGlobal('DOC', Symbol('DOC'));\n\nexport type { FetchError };\n\n/**\n * The HTTP methods WarpDrive's request layer supports.\n *\n * @summary Union of the HTTP method strings, including `QUERY`, that a WarpDrive request's `method` may be set to.\n */\nexport type HTTPMethod =\n  | 'QUERY'\n  | 'GET'\n  | 'OPTIONS'\n  | 'POST'\n  | 'PUT'\n  | 'PATCH'\n  | 'DELETE'\n  | 'HEAD'\n  | 'CONNECT'\n  | 'TRACE';\n\n/**\n * Use these options to adjust {@link CacheHandler} behavior for a request\n * via {@link RequestInfo.cacheOptions}.\n *\n * @summary Per-request settings on `cacheOptions` that control the cache key, forced or background reloads,\n * invalidation by resource type, and cache bypass.\n */\nexport interface CacheOptions {\n  /**\n   * A key that uniquely identifies this request. If not present, the url wil be used\n   * as the key for any GET request, while all other requests will not be cached.\n   *\n   */\n  key?: string;\n  /**\n   * If true, the request will be made even if a cached response is present\n   * and not expired.\n   *\n   */\n  reload?: boolean;\n  /**\n   * If true, and a cached response is present and not expired, the request\n   * will be made in the background and the cached response will be returned.\n   *\n   */\n  backgroundReload?: boolean;\n  /**\n   * Useful for metadata around when to invalidate the cache. Typically used\n   * by strategies that invalidate requests by resource type when a new resource\n   * of that type has been created. See the CachePolicy implementation\n   * provided by `@ember-data-mirror/request-utils` for an example.\n   *\n   * It is recommended to only use this for query/queryRecord requests where\n   * new records created later would affect the results, though using it for\n   * findRecord requests is also supported if desired where it may be useful\n   * when a create may affect the result of a sideloaded relationship.\n   *\n   * Generally it is better to patch the cache directly for relationship updates\n   * than to invalidate findRecord requests for one.\n   *\n   */\n  // TODO: Ideally this would be T extends TypedRecordInstance ? ExtractSuggestedCacheTypes<T>[] : string[];\n  // but that leads to `Type instantiation is excessively deep and possibly infinite.`\n  // issues when `T` has many properties.\n  types?: string[];\n\n  /**\n   * If true, the request will never be handled by the cache-manager and thus\n   * will never resolve from cache nor update the cache.\n   *\n   * Generally this is only used for legacy request that manage resource cache\n   * updates in a non-standard way via the LegacyNetworkHandler.\n   *\n   */\n  [SkipCache]?: boolean;\n}\n/**\n * The request shape produced by the `findRecord` request builders, for\n * use with {@link Store.request}.\n *\n * @summary Shape of the `GET` request object that `findRecord` builders return for `store.request`, carrying the url,\n * headers, and requested resource identifier.\n */\nexport type FindRecordRequestOptions<RT = unknown, T = unknown> = {\n  /**\n   * the url to request\n   */\n  url: string;\n  /**\n   * the HTTP method to use\n   */\n  method: 'GET';\n  /**\n   * the headers to send with the request\n   */\n  headers: Headers;\n  /**\n   * see {@link CacheOptions}\n   */\n  cacheOptions?: CacheOptions;\n  /**\n   * the name of the request operation\n   */\n  op: 'findRecord';\n  /**\n   * the resource being requested\n   */\n  records: [ResourceIdentifierObject<TypeFromInstanceOrString<T>>];\n  /**\n   * @private used only to carry the response type for type inference purposes\n   */\n  [RequestSignature]?: RT;\n};\n\n/**\n * The request shape produced by the `query` request builders, for\n * use with {@link Store.request}.\n *\n * @summary Shape of the `GET` request object that `query` builders return for `store.request`, carrying the url,\n * headers, and cache options.\n */\nexport type QueryRequestOptions<RT = unknown> = {\n  /**\n   * the url to request\n   */\n  url: string;\n  /**\n   * the HTTP method to use\n   */\n  method: 'GET';\n  /**\n   * the headers to send with the request\n   */\n  headers: Headers;\n  /**\n   * see {@link CacheOptions}\n   */\n  cacheOptions?: CacheOptions;\n  /**\n   * the name of the request operation\n   */\n  op: 'query';\n  /**\n   * @private used only to carry the response type for type inference purposes\n   */\n  [RequestSignature]?: RT;\n};\n\n/**\n * The request shape produced by the `postQuery` request builders, for\n * use with {@link Store.request}.\n *\n * @summary Shape of the `POST` or `QUERY` request object that `postQuery` builders return, with a body and a required\n * cache key since the url cannot serve as one.\n */\nexport type PostQueryRequestOptions<RT = unknown> = {\n  /**\n   * the url to request\n   */\n  url: string;\n  /**\n   * the HTTP method to use\n   */\n  method: 'POST' | 'QUERY';\n  /**\n   * the headers to send with the request\n   */\n  headers: Headers;\n  /**\n   * the body to send with the request\n   */\n  body?: string | BodyInit | FormData;\n  /**\n   * see {@link CacheOptions}. A `key` is required since `POST`/`QUERY`\n   * requests otherwise have no cache-safe way to derive one from the url.\n   */\n  cacheOptions: CacheOptions & {\n    /**\n     * a key that uniquely identifies this request\n     */\n    key: string;\n  };\n  /**\n   * the name of the request operation\n   */\n  op: 'query';\n  /**\n   * @private used only to carry the response type for type inference purposes\n   */\n  [RequestSignature]?: RT;\n};\n\n/**\n * The request shape produced by the `deleteRecord` request builders, for\n * use with {@link Store.request}.\n *\n * @summary Shape of the `DELETE` request object that `deleteRecord` builders return for `store.request`, identifying\n * the resource being deleted.\n */\nexport type DeleteRequestOptions<RT = unknown, T = unknown> = {\n  /**\n   * the url to request\n   */\n  url: string;\n  /**\n   * the HTTP method to use\n   */\n  method: 'DELETE';\n  /**\n   * the headers to send with the request\n   */\n  headers: Headers;\n  /**\n   * the name of the request operation\n   */\n  op: 'deleteRecord';\n  /**\n   * the body to send with the request\n   */\n  body?: string | BodyInit | FormData;\n  /**\n   * data for handlers to convert into the request body\n   */\n  data: {\n    /**\n     * the resource being deleted\n     */\n    record: ResourceKey<TypeFromInstanceOrString<T>>;\n  };\n  /**\n   * the resource being deleted\n   */\n  records: [ResourceIdentifierObject<TypeFromInstanceOrString<T>>];\n  /**\n   * @private used only to carry the response type for type inference purposes\n   */\n  [RequestSignature]?: RT;\n};\n\ntype ImmutableRequest<T> = Readonly<T> & {\n  readonly headers: ImmutableHeaders;\n  readonly records: [ResourceKey];\n};\n\n/**\n * The request shape produced by the `updateRecord` request builders, for\n * use with {@link Store.request}.\n *\n * @summary Shape of the `PATCH` or `PUT` request object that `updateRecord` builders return for `store.request`,\n * identifying the resource being saved.\n */\nexport type UpdateRequestOptions<RT = unknown, T = unknown> = {\n  /**\n   * the url to request\n   */\n  url: string;\n  /**\n   * the HTTP method to use\n   */\n  method: 'PATCH' | 'PUT';\n  /**\n   * the headers to send with the request\n   */\n  headers: Headers;\n  /**\n   * the name of the request operation\n   */\n  op: 'updateRecord';\n  /**\n   * the body to send with the request\n   */\n  body?: string | BodyInit | FormData;\n  /**\n   * data for handlers to convert into the request body\n   */\n  data: {\n    /**\n     * the resource being updated\n     */\n    record: ResourceKey<TypeFromInstanceOrString<T>>;\n  };\n  /**\n   * the resource being updated\n   */\n  records: [ResourceIdentifierObject<TypeFromInstanceOrString<T>>];\n  /**\n   * @private used only to carry the response type for type inference purposes\n   */\n  [RequestSignature]?: RT;\n};\n\n/**\n * The request shape produced by the `createRecord` request builders, for\n * use with {@link Store.request}.\n *\n * @summary Shape of the `POST` request object that `createRecord` builders return for `store.request`, identifying the\n * new resource being saved.\n */\nexport type CreateRequestOptions<RT = unknown, T = unknown> = {\n  /**\n   * the url to request\n   */\n  url: string;\n  /**\n   * the HTTP method to use\n   */\n  method: 'POST';\n  /**\n   * the headers to send with the request\n   */\n  headers: Headers;\n  /**\n   * the name of the request operation\n   */\n  op: 'createRecord';\n  /**\n   * the body to send with the request\n   */\n  body?: string | BodyInit | FormData;\n  /**\n   * data for handlers to convert into the request body\n   */\n  data: {\n    /**\n     * the resource being created\n     */\n    record: ResourceKey<TypeFromInstanceOrString<T>>;\n  };\n  /**\n   * the resource being created\n   */\n  records: [ResourceIdentifierObject<TypeFromInstanceOrString<T>>];\n  /**\n   * @private used only to carry the response type for type inference purposes\n   */\n  [RequestSignature]?: RT;\n};\n\n/**\n * The immutable, handler-facing form of {@link DeleteRequestOptions}.\n *\n * @summary Read-only view of a `deleteRecord` request as a handler receives it, with immutable headers and `records`\n * as resource keys.\n */\nexport type ImmutableDeleteRequestOptions = ImmutableRequest<DeleteRequestOptions>;\n/**\n * The immutable, handler-facing form of {@link UpdateRequestOptions}.\n *\n * @summary Read-only view of an `updateRecord` request as a handler receives it, with immutable headers and `records`\n * as resource keys.\n */\nexport type ImmutableUpdateRequestOptions = ImmutableRequest<UpdateRequestOptions>;\n/**\n * The immutable, handler-facing form of {@link CreateRequestOptions}.\n *\n * @summary Read-only view of a `createRecord` request as a handler receives it, with immutable headers and `records`\n * as resource keys.\n */\nexport type ImmutableCreateRequestOptions = ImmutableRequest<CreateRequestOptions>;\n\n/**\n * A minimal reference to a resource sufficient to build a URL for it,\n * as accepted by the request builders.\n *\n * @summary A resource reference with a persisted `id` and `type` and an optional `lid`, which is enough for request\n * builders to construct its url.\n */\nexport type RemotelyAccessibleIdentifier<T extends string = string> = {\n  /**\n   * the resource's persisted id\n   */\n  id: string;\n  /**\n   * the resource's type\n   */\n  type: T;\n  /**\n   * the local identifier WarpDrive has assigned to the resource, if known\n   */\n  lid?: string;\n};\n\n/**\n * Options accepted by the request builders for constraining how a\n * request's url is constructed and how the request interacts with the cache.\n *\n * @summary Options the request builders accept to set reload behavior and override the url's host, namespace, resource\n * path, and query param serialization.\n */\nexport interface ConstrainedRequestOptions {\n  /**\n   * If true, the request will be made even if a cached response is present\n   * and not expired.\n   */\n  reload?: boolean;\n  /**\n   * If true, and a cached response is present and not expired, the request\n   * will be made in the background and the cached response will be returned.\n   */\n  backgroundReload?: boolean;\n  /**\n   * The host to use when constructing the request's url, overriding any\n   * host configured via `setBuildURLConfig`.\n   */\n  host?: string;\n  /**\n   * The namespace to use when constructing the request's url, overriding\n   * any namespace configured via `setBuildURLConfig`.\n   */\n  namespace?: string;\n  /**\n   * The resource path to use when constructing the request's url,\n   * overriding the default of pluralizing the resource's type.\n   */\n  resourcePath?: string;\n  /**\n   * Options for how to serialize the request's query params, see {@link QueryParamsSerializationOptions}.\n   */\n  urlParamsSettings?: QueryParamsSerializationOptions;\n}\n\n/**\n * Options accepted by the `findRecord` request builders.\n *\n * @summary Options the `findRecord` request builders accept: the shared url and reload options plus the relationship\n * paths to `include`.\n */\nexport interface FindRecordOptions extends ConstrainedRequestOptions {\n  /**\n   * the relationship paths to sideload, see {@link Includes}\n   */\n  include?: string | string[];\n}\n\n/**\n * When a {@link Future} resolves, it returns an object\n * containing the original {@link RequestInfo | request},\n * the {@link Response | response} set by the handler chain (if any), and\n * the processed content.\n *\n * @summary The `{ request, response, content }` object that a request's `Future` resolves with when the request\n * succeeds.\n */\nexport interface StructuredDataDocument<T> {\n  /**\n   * @private\n   */\n  [STRUCTURED]?: true;\n  /**\n   * @see {@link ImmutableRequestInfo}\n   */\n  request: ImmutableRequestInfo;\n  /**\n   * the response set by the handler chain, if any\n   */\n  response: Response | ResponseInfo | null;\n  /**\n   * the processed content of the response\n   */\n  content: T;\n}\n\n/**\n * When a {@link Future} rejects, it throws either an {@link Error}\n * an {@link AggregateError} or a {@link DOMException} that maintains\n * the `{ request, response, content }` shape but is also an Error instance\n * itself.\n *\n * If using the error originates from the {@link Fetch | Fetch Handler}\n * the error will be a {@link FetchError}\n *\n * @summary The Error a request's `Future` rejects with when the request fails, carrying the `request`, `response`,\n * `error`, and any `content` received.\n */\nexport interface StructuredErrorDocument<T = unknown> extends Error {\n  /**\n   * @private\n   */\n  [STRUCTURED]?: true;\n  /**\n   * @see {@link ImmutableRequestInfo}\n   */\n  request: ImmutableRequestInfo;\n  /**\n   * the response set by the handler chain, if any\n   */\n  response: Response | ResponseInfo | null;\n  /**\n   * the error that caused the request to fail\n   */\n  error: string | object;\n  /**\n   * the processed content of the response, if any was received before the failure\n   */\n  content?: T;\n}\n\n/**\n * A union of the resolve/reject data types for the {@link Future}\n * returned by {@link Store.request | request}\n *\n * The [Using The Response](/guides/the-manual/requests/using-the-response) guide shows\n * how to read one.\n *\n * See also the docs for:\n *\n * - {@link Future}\n * - {@link StructuredDataDocument} (resolved/successful requests)\n * - {@link StructuredErrorDocument} (rejected/failed requests)\n *\n * @summary Union of the success and error documents that a request's `Future` resolves or rejects with.\n */\nexport type StructuredDocument<T> = StructuredDataDocument<T> | StructuredErrorDocument<T>;\n\n/**\n * The {@link RequestInit} interface accepted by the native {@link fetch} API.\n *\n * WarpDrive provides our own typings due to incompleteness in the native typings.\n *\n * @privateRemarks\n * - [MDN Reference (fetch)](https://developer.mozilla.org/docs/Web/API/Window/fetch)\n * - [MDN Reference (RequestInit)](https://developer.mozilla.org/en-US/docs/Web/API/RequestInit)\n * - [MDN Reference (Request)](https://developer.mozilla.org/docs/Web/API/Request)\n *\n */\ninterface NativeRequestInit {\n  /** Returns the cache mode associated with request, which is a string indicating how the request will interact with the browser's cache when fetching.\n   */\n  cache?: RequestCache;\n  /** Returns the credentials mode associated with request, which is a string indicating whether credentials will be sent with the request always, never, or only when sent to a same-origin URL.\n   */\n  credentials?: RequestCredentials;\n  /** Returns the kind of resource requested by request, e.g., \"document\" or \"script\".\n   */\n  destination?: RequestDestination;\n  /** Returns a Headers object consisting of the headers associated with request. Note that headers added in the network layer by the user agent will not be accounted for in this object, e.g., the \"Host\" header.\n   */\n  headers?: Headers;\n  /** Returns request's subresource integrity metadata, which is a cryptographic hash of the resource being fetched. Its value consists of multiple hashes separated by whitespace. [SRI]\n   */\n  integrity?: string;\n  /** Returns a boolean indicating whether or not request can outlive the global in which it was created.\n   */\n  keepalive?: boolean;\n  /** Returns request's HTTP method, which is \"GET\" by default.\n   */\n  method?: HTTPMethod;\n  /** Returns the mode associated with request, which is a string indicating whether the request will use CORS, or will be restricted to same-origin URLs.\n   *\n   * `no-cors` is not allowed for streaming request bodies.\n   *\n   */\n  mode?: RequestMode;\n  /**\n   * provides an explicit priority hint for the request.\n   */\n  priority?: RequestPriority;\n  /** Returns the redirect mode associated with request, which is a string indicating how redirects for the request will be handled during fetching. A request will follow redirects by default.\n   */\n  redirect?: RequestRedirect;\n  /** Returns the referrer of request. Its value can be a same-origin URL if explicitly set in init, the empty string to indicate no referrer, and \"about:client\" when defaulting to the global's default. This is used during fetching to determine the value of the `Referer` header of the request being made.\n   */\n  referrer?: string;\n  /** Returns the referrer policy associated with request. This is used during fetching to compute the value of the request's referrer.\n   */\n  referrerPolicy?: ReferrerPolicy;\n  /** Returns the signal associated with request, which is an AbortSignal object indicating whether or not request has been aborted, and its abort event handler.\n   */\n  signal?: AbortSignal;\n  /** Returns the URL of request as a string.\n   */\n  url?: string;\n  /** Any body that you want to add to your request. Note that a GET or HEAD request may not have a body.\n   */\n  body?: BodyInit | null;\n\n  /**\n   * When sending a ReadableStream as the body of a request, 'half' must be\n   * specified.\n   *\n   * [Half Duplex Further Reading](https://developer.chrome.com/docs/capabilities/web-apis/fetch-streaming-requests#half_duplex)\n   *\n   */\n  duplex?: 'half';\n}\n\n/**\n * A read-only {@link Headers} instance, as passed to {@link Handler | Handlers}\n * via {@link ImmutableRequestInfo.headers}.\n *\n * @summary Read-only `Headers` that handlers see on a request, adding `toJSON` to serialize them as `[key, value]`\n * pairs and an optional mutable `clone`.\n */\nexport interface ImmutableHeaders extends Headers {\n  /**\n   * Returns a mutable clone of these headers, if supported by the implementation.\n   */\n  clone?(): Headers;\n  /**\n   * Returns the headers as an array of `[key, value]` pairs.\n   */\n  toJSON(): [string, string][];\n}\n\n/**\n * Extends JavaScript's native {@link fetch} {@link NativeRequestInit | RequestInit} with additional\n * properties specific to the {@link RequestManager | RequestManager's} capabilities.\n *\n * This interface is used to define the shape of a request that can be made via\n * either the {@link RequestManager.request} or {@link Store.request} methods.\n *\n * The [Making Requests](/guides/the-manual/requests/#request-options) guide explains\n * its options.\n *\n * @summary Describes a request for `store.request` or `RequestManager.request`: native fetch options plus cache\n * options, operation name, records, data, and the store.\n * @privateRemarks\n * - [MDN Reference (fetch)](https://developer.mozilla.org/docs/Web/API/Window/fetch)\n * - [MDN Reference (RequestInit)](https://developer.mozilla.org/en-US/docs/Web/API/RequestInit)\n * - [MDN Reference (Request)](https://developer.mozilla.org/docs/Web/API/Request)\n *\n * @public\n * @since 4.12\n */\nexport interface RequestInfo<RT = unknown> extends NativeRequestInit {\n  /**\n   * If provided, used instead of the AbortController auto-configured for each request by the RequestManager\n   *\n   */\n  controller?: AbortController;\n\n  /**\n   * @see {@link CacheOptions}\n   */\n  cacheOptions?: CacheOptions;\n  /**\n   * The {@link Store} the request was made against, if made via\n   * {@link Store.request} rather than directly against a {@link RequestManager}.\n   *\n   * A {@link Handler} can read this off of {@link RequestContext.request | context.request}\n   * to reach store state (the cache, other services attached to a custom\n   * store subclass, etc.) without needing any Ember DI/`setOwner` wiring at\n   * handler-construction time. This works for a handler of any shape (a\n   * function, plain object, or class) because the store is attached to each\n   * request individually rather than to the handler itself.\n   *\n   * The trade-off is that this is only populated for requests issued via\n   * {@link Store.request | store.request(...)}; a request issued directly\n   * against a {@link RequestManager} will not have it set unless the caller\n   * supplies it explicitly. Handlers that rely on it should treat it as\n   * optional.\n   *\n   * @example\n   * ```ts\n   * const LoggingHandler = {\n   *   request<T>(context: RequestContext, next: NextFn<T>) {\n   *     const store = context.request.store;\n   *     if (store) {\n   *       console.log(`[${store.constructor.name}] ${context.request.url ?? ''}`);\n   *     }\n   *     return next(context.request);\n   *   },\n   * };\n   * ```\n   */\n  store?: Store;\n\n  /**\n   * The name of the request operation, if any (e.g. `'findRecord'`, `'query'`).\n   */\n  op?: string;\n\n  /**\n   * The {@link ResourceKey | ResourceKeys} of the primary resources involved in the request\n   * (if any). This may be used by handlers to perform transactional\n   * operations on the store.\n   *\n   */\n  records?: ResourceKey[];\n\n  /**\n   * If true, this request will not be tracked by test waiters.\n   */\n  disableTestWaiter?: boolean;\n  /**\n   * data that a handler should convert into\n   * the query (GET) or body (POST).\n   *\n   * Note: It is recommended that builders set query params\n   * and body directly in most scenarios.\n   *\n   */\n  data?: Record<string, unknown>;\n  /**\n   * options specifically intended for {@link Handler | Handlers}\n   * to utilize to process the request\n   *\n   */\n  options?: Record<string, unknown>;\n\n  /**\n   * @private used only to carry the response type for type inference purposes\n   */\n  [RequestSignature]?: RT;\n\n  /**\n   * see {@link EnableHydration}\n   */\n  [EnableHydration]?: boolean;\n}\n\n/**\n * Immutable version of {@link RequestInfo}. This is what is passed to handlers.\n *\n * @summary Read-only form of a request as handlers receive it, with frozen headers, data, options, and cache options\n * and no `controller`.\n */\nexport type ImmutableRequestInfo<RT = unknown> = Readonly<Omit<RequestInfo<RT>, 'controller'>> & {\n  /**\n   * see {@link CacheOptions}\n   */\n  readonly cacheOptions?: Readonly<CacheOptions>;\n  /**\n   * see {@link ImmutableHeaders}\n   */\n  readonly headers?: ImmutableHeaders;\n  /**\n   * see {@link RequestInfo.data}\n   */\n  readonly data?: Readonly<Record<string, unknown>>;\n  /**\n   * see {@link RequestInfo.options}\n   */\n  readonly options?: Readonly<Record<string, unknown>>;\n\n  /** Whether the request body has been read.\n   */\n  readonly bodyUsed?: boolean;\n};\n\n/**\n * An immutable, JSON-serializable subset of the native {@link Response}\n * interface.\n *\n * @summary Immutable, JSON-serializable snapshot of a fetch `Response`'s headers, status, url, and type, usable in\n * place of a `Response` in request results.\n */\nexport interface ResponseInfo {\n  /**\n   * see {@link ImmutableHeaders}\n   */\n  readonly headers: ImmutableHeaders; // to do, maybe not this?\n  /**\n   * whether the response's status code was in the 200-299 range\n   */\n  readonly ok: boolean;\n  /**\n   * whether the response is the result of a redirect\n   */\n  readonly redirected: boolean;\n  /**\n   * the response's HTTP status code\n   */\n  readonly status: number;\n  /**\n   * the status message associated with the response's status code\n   */\n  readonly statusText: string;\n  /**\n   * the type of the response, see [MDN Reference](https://developer.mozilla.org/docs/Web/API/Response/type)\n   */\n  readonly type: ResponseType;\n  /**\n   * the url of the response\n   */\n  readonly url: string;\n}\n\n/**\n * The object a {@link Handler} uses to fulfill a request: it provides a\n * readonly view of the {@link RequestContext.request | request} and methods\n * for supplying the {@link Future}'s stream and final response.\n *\n * The [Handlers](/guides/the-manual/requests/handlers) guide shows a handler using it.\n *\n * @summary Object passed to each request handler with the immutable request, a request id, and methods for setting the\n * response stream and the response.\n */\nexport interface RequestContext {\n  /**\n   * @see {@link ImmutableRequestInfo}\n   */\n  request: ImmutableRequestInfo;\n  /**\n   * a unique id for this request\n   */\n  id: number;\n\n  /**\n   * Supplies the stream of the response's content, if available, enabling\n   * consumers to monitor download progress via {@link RequestLoadingState}.\n   */\n  setStream(stream: ReadableStream | Promise<ReadableStream | null>): void;\n  /**\n   * Supplies the response for the request.\n   */\n  setResponse(response: Response | ResponseInfo | null): void;\n}\n"],"mappings":";;;;;;;;;;;;;;;;AAmCA,MAAaE,YAA6CD,kBAAkB,aAAaE,OAAOC,IAAI,eAAe,CAAC;;;;;;;;;AASpH,MAAaC,kBAAyDJ,kBACpE,mBACAE,OAAOC,IAAI,qBAAqB,CAClC;;;;AAIA,MAAaE,YAA6CN,eAAe,aAAaG,OAAO,WAAW,CAAC;;;;AAIzG,MAAaI,aAAwCP,eAAe,OAAOG,OAAO,KAAK,CAAC"}