@warp-drive/core 5.9.0-beta.0 → 5.9.0-beta.2

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

@@ -1,77 +1,146 @@
-import { getOrSetUniversal, getOrSetGlobal } from './-private.js';
-
-// eslint-disable-next-line @typescript-eslint/no-unused-vars
-
-const SkipCache = getOrSetUniversal('SkipCache', Symbol.for('wd:skip-cache'));
-const EnableHydration = getOrSetUniversal('EnableHydration', Symbol.for('wd:enable-hydration'));
-const IS_FUTURE = getOrSetGlobal('IS_FUTURE', Symbol('IS_FUTURE'));
-const STRUCTURED = getOrSetGlobal('DOC', Symbol('DOC'));
+import { n as getOrSetUniversal, t as getOrSetGlobal } from "../-private-D6Tw25AD.js";
 
+//#region src/types/request.ts
 /**
- * Use these options to adjust {@link CacheHandler} behavior for a request
- * via {@link RequestInfo.cacheOptions}.
- *
- */
-
+* 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.
+*/
+const SkipCache = getOrSetUniversal("SkipCache", Symbol.for("wd:skip-cache"));
 /**
- * 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.
- */
-
+* 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.
+*/
+const EnableHydration = getOrSetUniversal("EnableHydration", Symbol.for("wd:enable-hydration"));
 /**
- * When a {@link Future} rejects, it throws either an {@link Error}
- * an {@link AggregateError} or a {@link DOMException} that maintains
- * the `{ request, response, content }` shape but is also an Error instance
- * itself.
- *
- * If using the error originates from the {@link Fetch | Fetch Handler}
- * the error will be a {@link FetchError}
- */
-
+* @private
+*/
+const IS_FUTURE = getOrSetGlobal("IS_FUTURE", Symbol("IS_FUTURE"));
 /**
- * A union of the resolve/reject data types for the {@link Future}
- * returned by {@link Store.request | request}
- *
- * See also the docs for:
- *
- * - {@link Future}
- * - {@link StructuredDataDocument} (resolved/successful requests)
- * - {@link StructuredErrorDocument} (rejected/failed requests)
- */
-
+* @private
+*/
+const STRUCTURED = getOrSetGlobal("DOC", Symbol("DOC"));
 /**
- * The {@link RequestInit} interface accepted by the native {@link fetch} API.
- *
- * WarpDrive provides our own typings due to incompleteness in the native typings.
- *
- * @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)
- * - [MDN Reference (Request)](https://developer.mozilla.org/docs/Web/API/Request)
- *
- */
-
+* The HTTP methods WarpDrive's request layer supports.
+*/
 /**
- * Extends JavaScript's native {@link fetch} {@link NativeRequestInit | RequestInit} with additional
- * properties specific to the {@link RequestManager | RequestManager's} capabilities.
- *
- * 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.
- *
- * @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)
- * - [MDN Reference (Request)](https://developer.mozilla.org/docs/Web/API/Request)
- *
- * @public
- * @since 4.12
- */
-
+* Use these options to adjust {@link CacheHandler} behavior for a request
+* via {@link RequestInfo.cacheOptions}.
+*
+*/
 /**
- * Immutable version of {@link RequestInfo}. This is what is passed to handlers.
- *
- */
-
-export { EnableHydration, IS_FUTURE, STRUCTURED, SkipCache };
+* The request shape produced by the `findRecord` request builders, for
+* use with {@link Store.request}.
+*/
+/**
+* The request shape produced by the `query` request builders, for
+* use with {@link Store.request}.
+*/
+/**
+* The request shape produced by the `postQuery` request builders, for
+* use with {@link Store.request}.
+*/
+/**
+* The request shape produced by the `deleteRecord` request builders, for
+* use with {@link Store.request}.
+*/
+/**
+* The request shape produced by the `updateRecord` request builders, for
+* use with {@link Store.request}.
+*/
+/**
+* The request shape produced by the `createRecord` request builders, for
+* use with {@link Store.request}.
+*/
+/**
+* The immutable, handler-facing form of {@link DeleteRequestOptions}.
+*/
+/**
+* The immutable, handler-facing form of {@link UpdateRequestOptions}.
+*/
+/**
+* The immutable, handler-facing form of {@link CreateRequestOptions}.
+*/
+/**
+* A minimal reference to a resource sufficient to build a URL for it,
+* as accepted by the request builders.
+*/
+/**
+* Options accepted by the request builders for constraining how a
+* request's url is constructed and how the request interacts with the cache.
+*/
+/**
+* Options accepted by the `findRecord` request builders.
+*/
+/**
+* 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.
+*/
+/**
+* When a {@link Future} rejects, it throws either an {@link Error}
+* an {@link AggregateError} or a {@link DOMException} that maintains
+* the `{ request, response, content }` shape but is also an Error instance
+* itself.
+*
+* If using the error originates from the {@link Fetch | Fetch Handler}
+* the error will be a {@link FetchError}
+*/
+/**
+* A union of the resolve/reject data types for the {@link Future}
+* returned by {@link Store.request | request}
+*
+* See also the docs for:
+*
+* - {@link Future}
+* - {@link StructuredDataDocument} (resolved/successful requests)
+* - {@link StructuredErrorDocument} (rejected/failed requests)
+*/
+/**
+* The {@link RequestInit} interface accepted by the native {@link fetch} API.
+*
+* WarpDrive provides our own typings due to incompleteness in the native typings.
+*
+* @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)
+* - [MDN Reference (Request)](https://developer.mozilla.org/docs/Web/API/Request)
+*
+*/
+/**
+* A read-only {@link Headers} instance, as passed to {@link Handler | Handlers}
+* via {@link ImmutableRequestInfo.headers}.
+*/
+/**
+* Extends JavaScript's native {@link fetch} {@link NativeRequestInit | RequestInit} with additional
+* properties specific to the {@link RequestManager | RequestManager's} capabilities.
+*
+* 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.
+*
+* @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)
+* - [MDN Reference (Request)](https://developer.mozilla.org/docs/Web/API/Request)
+*
+* @public
+* @since 4.12
+*/
+/**
+* Immutable version of {@link RequestInfo}. This is what is passed to handlers.
+*
+*/
+/**
+* An immutable, JSON-serializable subset of the native {@link Response}
+* interface.
+*/
+/**
+* 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.
+*/
+//#endregion
+export { EnableHydration, IS_FUTURE, STRUCTURED, SkipCache };
+//# sourceMappingURL=request.js.map

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

@@ -0,0 +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/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"}

package/dist/unpkg/dev-deprecated/types/runtime.js

@@ -1,34 +1,62 @@
-import { getOrSetUniversal } from './-private.js';
-const RuntimeConfig = getOrSetUniversal('WarpDriveRuntimeConfig', {
-  debug: {}
-});
+import { n as getOrSetUniversal } from "../-private-D6Tw25AD.js";
+
+//#region src/types/runtime.ts
+/**
+* the shape of the runtime-configurable debug logging flags, see
+* {@link @warp-drive/core!build-config/debugging | the debugging flags}
+*/
+const RuntimeConfig = getOrSetUniversal("WarpDriveRuntimeConfig", { debug: {} });
 function trySessionStorage() {
-  // This works even when sessionStorage is not available.
-  // See https://github.com/warp-drive-data/warp-drive/issues/9784
-  try {
-    return globalThis.sessionStorage;
-  } catch {
-    return undefined;
-  }
+	try {
+		return globalThis.sessionStorage;
+	} catch {
+		return;
+	}
 }
 const storage = trySessionStorage();
-const settings = storage?.getItem('WarpDriveRuntimeConfig');
-if (settings) {
-  Object.assign(RuntimeConfig, JSON.parse(settings));
-}
+const settings = storage?.getItem("WarpDriveRuntimeConfig");
+if (settings) Object.assign(RuntimeConfig, JSON.parse(settings));
+/**
+* Returns the current WarpDrive runtime configuration.
+*
+* @example
+* ```ts
+* const { debug, mirage } = getRuntimeConfig();
+* ```
+*/
 function getRuntimeConfig() {
-  return RuntimeConfig;
+	return RuntimeConfig;
 }
-
 /**
- * Upserts the specified logging configuration into the runtime
- * config.
- *
- * globalThis.setWarpDriveLogging({ LOG_CACHE: true } });
- *
- */
+* Upserts the specified logging configuration into the runtime
+* config.
+*
+* globalThis.setWarpDriveLogging({ LOG_CACHE: true } });
+*
+*/
 function setLogging(config) {
-  Object.assign(RuntimeConfig.debug, config);
-  storage?.setItem('WarpDriveRuntimeConfig', JSON.stringify(RuntimeConfig));
+	Object.assign(RuntimeConfig.debug, config);
+	storage?.setItem("WarpDriveRuntimeConfig", JSON.stringify(RuntimeConfig));
+}
+/**
+* Explicitly declares whether requests may be served by Mirage (or another
+* Pretender-based fetch mock) instead of a native `fetch` implementation.
+*
+* The `Fetch` request handler otherwise infers this via a heuristic (the
+* presence of `window.server.pretender`, or `window.fetch` appearing to be
+* patched), which can be wrong in either direction: some Mirage setups don't
+* expose `window.server`, while some unrelated tools (APM agents, browser
+* extensions) also patch `fetch`. Call this to override that heuristic:
+* `true` to force Mirage-compatible behavior on, `false` to force it off.
+*
+* globalThis.setWarpDriveIsMaybeMirage(true);
+*
+*/
+function setIsMaybeMirage(value) {
+	RuntimeConfig.mirage = value;
+	storage?.setItem("WarpDriveRuntimeConfig", JSON.stringify(RuntimeConfig));
 }
-export { getRuntimeConfig, setLogging };
+
+//#endregion
+export { getRuntimeConfig, setIsMaybeMirage, setLogging };
+//# sourceMappingURL=runtime.js.map

package/dist/unpkg/dev-deprecated/types/runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.js","names":["getOrSetUniversal","RuntimeConfig","debug","trySessionStorage","globalThis","sessionStorage","undefined","storage","settings","getItem","Object","assign","JSON","parse","getRuntimeConfig","setLogging","config","setItem","stringify","setIsMaybeMirage","value","mirage"],"sources":["../../../../src/types/runtime.ts"],"sourcesContent":["import type * as LOGGING from '@warp-drive/build-config/debugging';\n\nimport { getOrSetUniversal } from './-private.ts';\n\n/**\n * the shape of the runtime-configurable debug logging flags, see\n * {@link @warp-drive/core!build-config/debugging | the debugging flags}\n */\n\ntype LOG_CONFIG_KEY = keyof typeof LOGGING;\ntype LOG_CONFIG = { [key in LOG_CONFIG_KEY]: boolean };\n\nconst RuntimeConfig: {\n  /**\n   * the currently active logging configuration, see\n   * {@link @warp-drive/core!build-config/debugging | the debugging flags}\n   */\n  debug: Partial<LOG_CONFIG>;\n  /**\n   * whether requests should be treated as being served by Mirage,\n   * see {@link setIsMaybeMirage}\n   */\n  mirage?: boolean;\n} = getOrSetUniversal('WarpDriveRuntimeConfig', {\n  debug: {},\n});\n\nfunction trySessionStorage() {\n  // This works even when sessionStorage is not available.\n  // See https://github.com/warp-drive-data/warp-drive/issues/9784\n  try {\n    return globalThis.sessionStorage;\n  } catch {\n    return undefined;\n  }\n}\n\nconst storage = trySessionStorage();\nconst settings = storage?.getItem('WarpDriveRuntimeConfig');\nif (settings) {\n  Object.assign(RuntimeConfig, JSON.parse(settings));\n}\n\n/**\n * Returns the current WarpDrive runtime configuration.\n *\n * @example\n * ```ts\n * const { debug, mirage } = getRuntimeConfig();\n * ```\n */\nexport function getRuntimeConfig(): typeof RuntimeConfig {\n  return RuntimeConfig;\n}\n\n/**\n * Upserts the specified logging configuration into the runtime\n * config.\n *\n * globalThis.setWarpDriveLogging({ LOG_CACHE: true } });\n *\n */\nexport function setLogging(config: Partial<LOG_CONFIG>): void {\n  Object.assign(RuntimeConfig.debug, config);\n  storage?.setItem('WarpDriveRuntimeConfig', JSON.stringify(RuntimeConfig));\n}\n\n/**\n * Explicitly declares whether requests may be served by Mirage (or another\n * Pretender-based fetch mock) instead of a native `fetch` implementation.\n *\n * The `Fetch` request handler otherwise infers this via a heuristic (the\n * presence of `window.server.pretender`, or `window.fetch` appearing to be\n * patched), which can be wrong in either direction: some Mirage setups don't\n * expose `window.server`, while some unrelated tools (APM agents, browser\n * extensions) also patch `fetch`. Call this to override that heuristic:\n * `true` to force Mirage-compatible behavior on, `false` to force it off.\n *\n * globalThis.setWarpDriveIsMaybeMirage(true);\n *\n */\nexport function setIsMaybeMirage(value: boolean): void {\n  RuntimeConfig.mirage = value;\n  storage?.setItem('WarpDriveRuntimeConfig', JSON.stringify(RuntimeConfig));\n}\n"],"mappings":";;;;;;;AAYA,MAAMC,gBAWFD,kBAAkB,0BAA0B,EAC9CE,OAAO,CAAC,EACV,CAAC;AAED,SAASC,oBAAoB;CAG3B,IAAI;EACF,OAAOC,WAAWC;CACpB,QAAQ;EACN;CACF;AACF;AAEA,MAAME,UAAUJ,kBAAkB;AAClC,MAAMK,WAAWD,SAASE,QAAQ,wBAAwB;AAC1D,IAAID,UACFE,OAAOC,OAAOV,eAAeW,KAAKC,MAAML,QAAQ,CAAC;;;;;;;;;AAWnD,SAAgBM,mBAAyC;CACvD,OAAOb;AACT;;;;;;;;AASA,SAAgBc,WAAWC,QAAmC;CAC5DN,OAAOC,OAAOV,cAAcC,OAAOc,MAAM;CACzCT,SAASU,QAAQ,0BAA0BL,KAAKM,UAAUjB,aAAa,CAAC;AAC1E;;;;;;;;;;;;;;;AAgBA,SAAgBkB,iBAAiBC,OAAsB;CACrDnB,cAAcoB,SAASD;CACvBb,SAASU,QAAQ,0BAA0BL,KAAKM,UAAUjB,aAAa,CAAC;AAC1E"}