@warp-drive/core 5.6.0-alpha.11

package/declarations/reactive/-private/schema.d.ts

@@ -0,0 +1,180 @@
+import type { Store } from '../../store/-private.ts';
+import type { SchemaService as SchemaServiceInterface } from '../../types.ts';
+import type { StableRecordIdentifier } from '../../types/identifier.ts';
+import type { ObjectValue, Value } from '../../types/json/raw.ts';
+import type { Derivation, HashFn } from '../../types/schema/concepts.ts';
+import { type ArrayField, type DerivedField, type FieldSchema, type GenericField, type HashField, type LegacyAttributeField, type LegacyBelongsToField, type LegacyHasManyField, type LegacyRelationshipField, type ObjectField, type ObjectSchema, type PolarisResourceSchema, type ResourceSchema } from '../../types/schema/fields.ts';
+import { Type } from '../../types/symbols.ts';
+import type { WithPartial } from '../../types/utils.ts';
+import type { ReactiveResource } from './record.ts';
+/**
+ * Utility for constructing a ResourceSchema with the recommended
+ * fields for the PolarisMode experience.
+ *
+ * Using this requires registering the PolarisMode derivations
+ *
+ * ```ts
+ * import { registerDerivations } from '@warp-drive/schema-record';
+ *
+ * registerDerivations(schema);
+ * ```
+ *
+ * @public
+ * @param schema
+ * @return {PolarisResourceSchema}
+ */
+export declare function withDefaults(schema: WithPartial<PolarisResourceSchema, 'identity'>): ResourceSchema;
+/**
+ * A derivation that computes its value from the
+ * record's identity.
+ *
+ * It can be used via a derived field definition like:
+ *
+ * ```ts
+ * {
+ *   kind: 'derived',
+ *   name: 'id',
+ *   type: '@identity',
+ *   options: { key: 'id' }
+ * }
+ * ```
+ *
+ * Valid keys are `'id'`, `'lid'`, `'type'`, and `'^'`.
+ *
+ * `^` returns the entire identifier object.
+ *
+ * @public
+ */
+export declare function fromIdentity(record: ReactiveResource, options: {
+    key: 'lid';
+} | {
+    key: 'type';
+}, key: string): string;
+export declare function fromIdentity(record: ReactiveResource, options: {
+    key: 'id';
+}, key: string): string | null;
+export declare function fromIdentity(record: ReactiveResource, options: {
+    key: '^';
+}, key: string): StableRecordIdentifier;
+export declare function fromIdentity(record: ReactiveResource, options: null, key: string): asserts options;
+export declare namespace fromIdentity { }
+/**
+ * Registers the default derivations for records that want
+ * to use the PolarisMode defaults provided by
+ *
+ * ```ts
+ * import { withDefaults } from '@warp-drive/schema-record';
+ * ```
+ *
+ * @public
+ * @param {SchemaService} schema
+ */
+export declare function registerDerivations(schema: SchemaServiceInterface): void;
+interface InternalSchema {
+    original: ResourceSchema | ObjectSchema;
+    traits: Set<string>;
+    fields: Map<string, FieldSchema>;
+    attributes: Record<string, LegacyAttributeField>;
+    relationships: Record<string, LegacyRelationshipField>;
+}
+export type Transformation<T extends Value = Value, PT = unknown> = {
+    serialize(value: PT, options: Record<string, unknown> | null, record: ReactiveResource): T;
+    hydrate(value: T | undefined, options: Record<string, unknown> | null, record: ReactiveResource): PT;
+    defaultValue?(options: Record<string, unknown> | null, identifier: StableRecordIdentifier): T;
+    [Type]: string;
+};
+interface KindFns {
+    belongsTo: {
+        get: (store: Store, record: object, resourceKey: StableRecordIdentifier, field: LegacyBelongsToField) => unknown;
+        set: (store: Store, record: object, cacheKey: StableRecordIdentifier, field: LegacyBelongsToField, value: unknown) => void;
+    };
+    hasMany: {
+        get: (store: Store, record: object, resourceKey: StableRecordIdentifier, field: LegacyHasManyField) => unknown;
+        set: (store: Store, record: object, cacheKey: StableRecordIdentifier, field: LegacyHasManyField, value: unknown) => void;
+        notify: (store: Store, record: object, cacheKey: StableRecordIdentifier, field: LegacyHasManyField) => boolean;
+    };
+}
+export interface SchemaService {
+    doesTypeExist(type: string): boolean;
+    attributesDefinitionFor(identifier: {
+        type: string;
+    }): InternalSchema['attributes'];
+    relationshipsDefinitionFor(identifier: {
+        type: string;
+    }): InternalSchema['relationships'];
+}
+/**
+ * A SchemaService designed to work with dynamically registered schemas.
+ *
+ * @class SchemaService
+ * @public
+ */
+export declare class SchemaService implements SchemaServiceInterface {
+    /** @internal */
+    _schemas: Map<string, InternalSchema>;
+    /** @internal */
+    _transforms: Map<string, Transformation>;
+    /** @internal */
+    _hashFns: Map<string, HashFn>;
+    /** @internal */
+    _derivations: Map<string, Derivation<any, any, any>>;
+    /** @internal */
+    _traits: Set<string>;
+    /** @internal */
+    _modes: Map<string, KindFns>;
+    constructor();
+    resourceTypes(): Readonly<string[]>;
+    hasTrait(type: string): boolean;
+    resourceHasTrait(resource: StableRecordIdentifier | {
+        type: string;
+    }, trait: string): boolean;
+    transformation(field: GenericField | ObjectField | ArrayField | {
+        type: string;
+    }): Transformation;
+    derivation(field: DerivedField | {
+        type: string;
+    }): Derivation;
+    hashFn(field: HashField | {
+        type: string;
+    }): HashFn;
+    resource(resource: StableRecordIdentifier | {
+        type: string;
+    }): ResourceSchema | ObjectSchema;
+    registerResources(schemas: Array<ResourceSchema | ObjectSchema>): void;
+    registerResource(schema: ResourceSchema | ObjectSchema): void;
+    registerTransformation<T extends Value = string, PT = unknown>(transformation: Transformation<T, PT>): void;
+    registerDerivation<R, T, FM extends ObjectValue | null>(derivation: Derivation<R, T, FM>): void;
+    /**
+     * This is an internal method used to register behaviors for legacy mode.
+     * It is not intended for public use.
+     *
+     * We do think a generalized `kind` registration system would be useful,
+     * but we have not yet designed it.
+     *
+     * See https://github.com/emberjs/data/issues/9534
+     *
+     * @internal
+     */
+    _registerMode(mode: string, kinds: KindFns): void;
+    /**
+     * This is an internal method used to enable legacy behaviors for legacy mode.
+     * It is not intended for public use.
+     *
+     * We do think a generalized `kind` registration system would be useful,
+     * but we have not yet designed it.
+     *
+     * See https://github.com/emberjs/data/issues/9534
+     *
+     * @internal
+     */
+    _kind<T extends keyof KindFns>(mode: string, kind: T): KindFns[T];
+    registerHashFn<T extends object>(hashFn: HashFn<T>): void;
+    fields({ type }: {
+        type: string;
+    }): InternalSchema['fields'];
+    hasResource(resource: {
+        type: string;
+    }): boolean;
+}
+export {};
+//# sourceMappingURL=schema.d.ts.map

package/declarations/reactive/-private/schema.d.ts.map

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

package/declarations/reactive/-private/symbols.d.ts

@@ -0,0 +1,11 @@
+export declare const SOURCE: "___(unique) Symbol(SOURCE)";
+export declare const MUTATE: "___(unique) Symbol(MUTATE)";
+export declare const Destroy: "___(unique) Symbol(Destroy)";
+export declare const Identifier: "___(unique) Symbol(Identifier)";
+export declare const Editable: "___(unique) Symbol(Editable)";
+export declare const Parent: "___(unique) Symbol(Parent)";
+export declare const Checkout: "___(unique) Symbol(Checkout)";
+export declare const Legacy: "___(unique) Symbol(Legacy)";
+export declare const EmbeddedPath: "___(unique) Symbol(EmbeddedPath)";
+export declare const EmbeddedType: "___(unique) Symbol(EmbeddedType)";
+//# sourceMappingURL=symbols.d.ts.map

package/declarations/reactive/-private/symbols.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"symbols.d.ts","sourceRoot":"","sources":["../../../src/reactive/-private/symbols.ts"],"names":[],"mappings":"AAiCA,eAAO,MAAM,MAAM,8BAA8C,CAAC;AAClE,eAAO,MAAM,MAAM,8BAA8C,CAAC;AAElE,eAAO,MAAM,OAAO,+BAA+C,CAAC;AACpE,eAAO,MAAM,UAAU,kCAAqD,CAAC;AAC7E,eAAO,MAAM,QAAQ,gCAAiD,CAAC;AACvE,eAAO,MAAM,MAAM,8BAA6C,CAAC;AACjE,eAAO,MAAM,QAAQ,gCAAiD,CAAC;AACvE,eAAO,MAAM,MAAM,8BAA6C,CAAC;AAEjE,eAAO,MAAM,YAAY,oCAAyD,CAAC;AACnF,eAAO,MAAM,YAAY,oCAAyD,CAAC"}

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

@@ -0,0 +1,2 @@
+export { Editable, Legacy } from './-private/symbols';
+//# sourceMappingURL=-private.d.ts.map

package/declarations/reactive/-private.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"-private.d.ts","sourceRoot":"","sources":["../../src/reactive/-private.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC"}

package/declarations/reactive.d.ts

@@ -0,0 +1,5 @@
+export { instantiateRecord, teardownRecord } from './reactive/-private/hooks';
+export { type Transformation, SchemaService, withDefaults, fromIdentity, registerDerivations, } from './reactive/-private/schema';
+export { type ReactiveResource } from './reactive/-private/record';
+export { Checkout } from './reactive/-private/symbols';
+//# sourceMappingURL=reactive.d.ts.map

package/declarations/reactive.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reactive.d.ts","sourceRoot":"","sources":["../src/reactive.ts"],"names":[],"mappings":"AAsSA,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC9E,OAAO,EACL,KAAK,cAAc,EACnB,aAAa,EACb,YAAY,EACZ,YAAY,EACZ,mBAAmB,GACpB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,KAAK,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAC"}

package/declarations/request/-private/context.d.ts

@@ -0,0 +1,42 @@
+import type { StableDocumentIdentifier } from '../../types/identifier';
+import type { ImmutableHeaders, ImmutableRequestInfo, RequestInfo, ResponseInfo } from '../../types/request';
+import type { DeferredStream, GodContext } from './types';
+export declare function upgradeHeaders(headers: Headers | ImmutableHeaders): ImmutableHeaders;
+export declare function cloneResponseProperties(response: Response): ResponseInfo;
+export declare class ContextOwner {
+    hasSetStream: boolean;
+    hasSetResponse: boolean;
+    hasSubscribers: boolean;
+    stream: DeferredStream;
+    response: ResponseInfo | null;
+    request: ImmutableRequestInfo;
+    enhancedRequest: ImmutableRequestInfo;
+    nextCalled: number;
+    god: GodContext;
+    controller: AbortController;
+    requestId: number;
+    isRoot: boolean;
+    constructor(request: RequestInfo, god: GodContext, isRoot?: boolean);
+    get hasRequestedStream(): boolean;
+    getResponse(): ResponseInfo | null;
+    getStream(): Promise<ReadableStream | null>;
+    abort(reason: DOMException): void;
+    setStream(stream: ReadableStream | Promise<ReadableStream | null> | null): void;
+    resolveStream(): void;
+    setResponse(response: ResponseInfo | Response | null): void;
+}
+export declare class Context {
+    #private;
+    request: ImmutableRequestInfo;
+    id: number;
+    private _isCacheHandler;
+    private _finalized;
+    constructor(owner: ContextOwner, isCacheHandler: boolean);
+    setStream(stream: ReadableStream | Promise<ReadableStream | null>): void;
+    setResponse(response: ResponseInfo | Response | null): void;
+    setIdentifier(identifier: StableDocumentIdentifier): void;
+    get hasRequestedStream(): boolean;
+    _finalize(): void;
+}
+export type HandlerRequestContext = Context;
+//# sourceMappingURL=context.d.ts.map

package/declarations/request/-private/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../../src/request/-private/context.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AACvE,OAAO,KAAK,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAI7G,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAE1D,wBAAgB,cAAc,CAAC,OAAO,EAAE,OAAO,GAAG,gBAAgB,GAAG,gBAAgB,CAQpF;AAED,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,QAAQ,GAAG,YAAY,CAYxE;AAED,qBAAa,YAAY;IACvB,YAAY,UAAS;IACrB,cAAc,UAAS;IACvB,cAAc,UAAS;IACvB,MAAM,EAAE,cAAc,CAA2C;IACjE,QAAQ,EAAE,YAAY,GAAG,IAAI,CAAQ;IAC7B,OAAO,EAAE,oBAAoB,CAAC;IAC9B,eAAe,EAAE,oBAAoB,CAAC;IAC9C,UAAU,SAAK;IACP,GAAG,EAAE,UAAU,CAAC;IAChB,UAAU,EAAE,eAAe,CAAC;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,OAAO,CAAC;gBAEZ,OAAO,EAAE,WAAW,EAAE,GAAG,EAAE,UAAU,EAAE,MAAM,UAAQ;IAuCjE,IAAI,kBAAkB,IAAI,OAAO,CAEhC;IAED,WAAW,IAAI,YAAY,GAAG,IAAI;IASlC,SAAS,IAAI,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IAW3C,KAAK,CAAC,MAAM,EAAE,YAAY;IAI1B,SAAS,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,GAAG,IAAI;IAYxE,aAAa;IAIb,WAAW,CAAC,QAAQ,EAAE,YAAY,GAAG,QAAQ,GAAG,IAAI;CAwBrD;AAED,qBAAa,OAAO;;IAEV,OAAO,EAAE,oBAAoB,CAAC;IAC9B,EAAE,EAAE,MAAM,CAAC;IACnB,QAAgB,eAAe,CAAU;IACzC,QAAgB,UAAU,CAAU;gBAExB,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,OAAO;IAOxD,SAAS,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IAGjE,WAAW,CAAC,QAAQ,EAAE,YAAY,GAAG,QAAQ,GAAG,IAAI;IAIpD,aAAa,CAAC,UAAU,EAAE,wBAAwB;IAQlD,IAAI,kBAAkB,YAErB;IAED,SAAS;CAGV;AACD,MAAM,MAAM,qBAAqB,GAAG,OAAO,CAAC"}

package/declarations/request/-private/debug.d.ts

@@ -0,0 +1,5 @@
+import type { RequestInfo } from '../../types/request';
+import { Context } from './context';
+export declare function deepFreeze<T = unknown>(value: T): T;
+export declare function assertValidRequest(request: RequestInfo | Context, isTopLevel: boolean): asserts request is RequestInfo;
+//# sourceMappingURL=debug.d.ts.map

package/declarations/request/-private/debug.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"debug.d.ts","sourceRoot":"","sources":["../../../src/request/-private/debug.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAoB,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACzE,OAAO,EAAE,OAAO,EAAkB,MAAM,WAAW,CAAC;AAmFpD,wBAAgB,UAAU,CAAC,CAAC,GAAG,OAAO,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC,CAuDnD;AAmJD,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,WAAW,GAAG,OAAO,EAC9B,UAAU,EAAE,OAAO,GAClB,OAAO,CAAC,OAAO,IAAI,WAAW,CA8DhC"}

package/declarations/request/-private/fetch.d.ts

@@ -0,0 +1,40 @@
+/**
+ * A basic Fetch Handler which converts a request into a
+ * `fetch` call presuming the response to be `json`.
+ *
+ * ```ts
+ * import Fetch from '@ember-data/request/fetch';
+ *
+ * manager.use([Fetch]);
+ * ```
+ *
+ * @module
+ */
+import { type Context } from './context';
+interface FastbootRequest extends Request {
+    protocol: string;
+    host: string;
+}
+export interface FastBoot {
+    require(moduleName: string): unknown;
+    isFastBoot: boolean;
+    request: FastbootRequest;
+}
+/**
+ * A basic handler which converts a request into a
+ * `fetch` call presuming the response to be `json`.
+ *
+ * ```ts
+ * import Fetch from '@ember-data/request/fetch';
+ *
+ * manager.use([Fetch]);
+ * ```
+ *
+ * @class Fetch
+ * @public
+ */
+declare const Fetch: {
+    request<T>(context: Context): Promise<T>;
+};
+export { Fetch };
+//# sourceMappingURL=fetch.d.ts.map

package/declarations/request/-private/fetch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch.d.ts","sourceRoot":"","sources":["../../../src/request/-private/fetch.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAKH,OAAO,EAA2B,KAAK,OAAO,EAAE,MAAM,WAAW,CAAC;AAGlE,UAAU,eAAgB,SAAQ,OAAO;IACvC,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;CACd;AACD,MAAM,WAAW,QAAQ;IACvB,OAAO,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC;IACrC,UAAU,EAAE,OAAO,CAAC;IACpB,OAAO,EAAE,eAAe,CAAC;CAC1B;AA6ED;;;;;;;;;;;;GAYG;AACH,QAAA,MAAM,KAAK;YACK,CAAC,WAAW,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC;CAoJ/C,CAAC;AAMF,OAAO,EAAE,KAAK,EAAE,CAAC"}

package/declarations/request/-private/future.d.ts

@@ -0,0 +1,8 @@
+import { type StructuredDocument } from '../../types/request';
+import type { ContextOwner } from './context';
+import type { Deferred, DeferredFuture, Future } from './types';
+export declare function isFuture<T>(maybe: unknown): maybe is Future<T>;
+export declare function createDeferred<T>(): Deferred<T>;
+export declare function upgradePromise<T>(promise: Promise<StructuredDocument<T>>, future: Future<T>): Future<T>;
+export declare function createFuture<T>(owner: ContextOwner): DeferredFuture<T>;
+//# sourceMappingURL=future.d.ts.map

package/declarations/request/-private/future.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"future.d.ts","sourceRoot":"","sources":["../../../src/request/-private/future.ts"],"names":[],"mappings":"AAAA,OAAO,EAAa,KAAK,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAGhE,wBAAgB,QAAQ,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAAC,CAAC,CAAC,CAE9D;AAED,wBAAgB,cAAc,CAAC,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAQ/C;AAED,wBAAgB,cAAc,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAYvG;AAED,wBAAgB,YAAY,CAAC,CAAC,EAAE,KAAK,EAAE,YAAY,GAAG,cAAc,CAAC,CAAC,CAAC,CA0BtE"}

package/declarations/request/-private/manager.d.ts

@@ -0,0 +1,160 @@
+import type { StableDocumentIdentifier } from '../../types/identifier';
+import type { RequestInfo } from '../../types/request';
+import type { CacheHandler, Future, GenericCreateArgs, Handler, ManagedRequestPriority } from './types';
+import { IS_CACHE_HANDLER } from './utils';
+/**
+ * ## Import
+ *
+ * ```js
+ * import { RequestManager } from '@warp-drive/core';
+ * ```
+ *
+ * For complete usage guide see the [RequestManager Documentation](/guides/).
+ *
+ * ## How It Works
+ *
+ * ```ts
+ * interface RequestManager {
+ *   request<T>(req: RequestInfo): Future<T>;
+ * }
+ * ```
+ *
+ * A RequestManager provides a request/response flow in which configured
+ * handlers are successively given the opportunity to handle, modify, or
+ * pass-along a request.
+ *
+ * <img src="/images/handlers-all-labeled.gif" alt="RequestManager Flow Animation" width="100%" />
+ *
+ * For example:
+ *
+ * ::: code-group
+ *
+ * ```ts [Setup.ts]
+ * import { RequestManager, Fetch } from '@warp-drive/core';
+ * import { AutoCompress } from '@warp-drive/utilities/handlers';
+ * import Auth from 'ember-simple-auth/handler';
+ *
+ * // ... create manager
+ * const manager = new RequestManager()
+ *    .use([Auth, new AutoCompress(), Fetch]); // [!code focus]
+ * ```
+ *
+ * ```ts [Usage.ts]
+ * import Config from './config';
+ *
+ * const { apiUrl } = Config;
+ *
+ * // ... execute a request
+ * const response = await manager.request({
+ *   url: `${apiUrl}/users`
+ * });
+ * ```
+ *
+ * :::
+ *
+ * ### Futures
+ *
+ * The return value of `manager.request` is a `Future`, which allows
+ * access to limited information about the request while it is still
+ * pending and fulfills with the final state when the request completes.
+ *
+ * A `Future` is cancellable via `abort`.
+ *
+ * Handlers may optionally expose a `ReadableStream` to the `Future` for
+ * streaming data; however, when doing so the future should not resolve
+ * until the response stream is fully read.
+ *
+ * ```ts
+ * interface Future<T> extends Promise<StructuredDocument<T>> {
+ *   abort(): void;
+ *
+ *   async getStream(): ReadableStream | null;
+ * }
+ * ```
+ *
+ * ### StructuredDocuments
+ *
+ * A Future resolves with a `StructuredDataDocument` or rejects with a `StructuredErrorDocument`.
+ *
+ * ```ts
+ * interface StructuredDataDocument<T> {
+ *   request: ImmutableRequestInfo;
+ *   response: ImmutableResponseInfo;
+ *   content: T;
+ * }
+ * interface StructuredErrorDocument extends Error {
+ *   request: ImmutableRequestInfo;
+ *   response: ImmutableResponseInfo;
+ *   error: string | object;
+ * }
+ * type StructuredDocument<T> = StructuredDataDocument<T> | StructuredErrorDocument;
+ * ```
+ *
+ * @class RequestManager
+ * @public
+ */
+export declare class RequestManager {
+    #private;
+    /** @internal */
+    _hasCacheHandler: boolean;
+    /**
+     * A map of pending requests from request.id to their
+     * associated CacheHandler promise.
+     *
+     * This queue is managed by the CacheHandler
+     *
+     * @internal
+     */
+    _pending: Map<number, Promise<unknown>>;
+    /** @internal */
+    _deduped: Map<StableDocumentIdentifier, {
+        priority: ManagedRequestPriority;
+        promise: Promise<unknown>;
+    }>;
+    constructor(options?: GenericCreateArgs);
+    /**
+     * Register a handler to use for primary cache intercept.
+     *
+     * Only one such handler may exist. If using the same
+     * RequestManager as the Store instance the Store
+     * registers itself as a Cache handler.
+     *
+     * @public
+     */
+    useCache(cacheHandler: CacheHandler & {
+        [IS_CACHE_HANDLER]?: true;
+    }): this;
+    /**
+     * Register handler(s) to use when a request is issued.
+     *
+     * Handlers will be invoked in the order they are registered.
+     * Each Handler is given the opportunity to handle the request,
+     * curry the request, or pass along a modified request.
+     *
+     * @public
+     * @param {Handler[]} newHandlers
+     * @return {ThisType}
+     */
+    use(newHandlers: Handler[]): this;
+    /**
+     * Issue a Request.
+     *
+     * Returns a Future that fulfills with a StructuredDocument
+     *
+     * @public
+     * @param {RequestInfo} request
+     * @return {Future}
+     */
+    request<RT, T = unknown>(request: RequestInfo<RT, T>): Future<RT>;
+    /**
+     * This method exists so that the RequestManager can be created
+     * can be created by container/factory systems that expect to
+     * call a static `create` method to instantiate the class.
+     *
+     * Using `new RequestManager()` directly is preferred.
+     *
+     * @private
+     */
+    static create(options?: GenericCreateArgs): RequestManager;
+}
+//# sourceMappingURL=manager.d.ts.map

package/declarations/request/-private/manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../../src/request/-private/manager.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AACvE,OAAO,KAAK,EAAE,WAAW,EAA2B,MAAM,qBAAqB,CAAC;AAIhF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,EAAE,iBAAiB,EAAE,OAAO,EAAE,sBAAsB,EAAE,MAAM,SAAS,CAAC;AACxG,OAAO,EAAsB,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAE/D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0FG;AACH,qBAAa,cAAc;;IAEzB,gBAAgB;IACR,gBAAgB,EAAE,OAAO,CAAC;IAClC;;;;;;;OAOG;IACK,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC;IAChD,gBAAgB;IACR,QAAQ,EAAE,GAAG,CAAC,wBAAwB,EAAE;QAAE,QAAQ,EAAE,sBAAsB,CAAC;QAAC,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,CAAA;KAAE,CAAC,CAAC;gBAErG,OAAO,CAAC,EAAE,iBAAiB;IAMvC;;;;;;;;OAQG;IACH,QAAQ,CAAC,YAAY,EAAE,YAAY,GAAG;QAAE,CAAC,gBAAgB,CAAC,CAAC,EAAE,IAAI,CAAA;KAAE,GAAG,IAAI;IAiB1E;;;;;;;;;;OAUG;IACH,GAAG,CAAC,WAAW,EAAE,OAAO,EAAE,GAAG,IAAI;IA2BjC;;;;;;;;OAQG;IACH,OAAO,CAAC,EAAE,EAAE,CAAC,GAAG,OAAO,EAAE,OAAO,EAAE,WAAW,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,MAAM,CAAC,EAAE,CAAC;IAuFjE;;;;;;;;OAQG;IACH,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,iBAAiB;CAG1C"}

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

@@ -0,0 +1,20 @@
+export type CacheResult<T = unknown, E = unknown> = {
+    isError: true;
+    result: E;
+} | {
+    isError: false;
+    result: T;
+};
+export type Awaitable<T = unknown, E = unknown> = {
+    then: (onFulfilled: (value: T) => unknown, onRejected: (reason: E) => unknown) => unknown;
+    catch: (onRejected: (reason: E) => unknown) => unknown;
+    finally: (onFinally: () => unknown) => unknown;
+};
+export declare const PromiseCache: WeakMap<Awaitable<unknown, unknown>, CacheResult<unknown, unknown>>;
+export declare const RequestMap: Map<number, CacheResult<unknown, unknown>>;
+export declare function setRequestResult(requestId: number, result: CacheResult): void;
+export declare function clearRequestResult(requestId: number): void;
+export declare function getRequestResult(requestId: number): CacheResult | undefined;
+export declare function setPromiseResult(promise: Promise<unknown> | Awaitable, result: CacheResult): void;
+export declare function getPromiseResult<T, E>(promise: Promise<T> | Awaitable<T, E>): CacheResult<T, E> | undefined;
+//# sourceMappingURL=promise-cache.d.ts.map

package/declarations/request/-private/promise-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"promise-cache.d.ts","sourceRoot":"","sources":["../../../src/request/-private/promise-cache.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,WAAW,CAAC,CAAC,GAAG,OAAO,EAAE,CAAC,GAAG,OAAO,IAAI;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,CAAC,CAAA;CAAE,GAAG;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,CAAC,CAAA;CAAE,CAAC;AAEjH,MAAM,MAAM,SAAS,CAAC,CAAC,GAAG,OAAO,EAAE,CAAC,GAAG,OAAO,IAAI;IAChD,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,OAAO,EAAE,UAAU,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,OAAO,KAAK,OAAO,CAAC;IAC1F,KAAK,EAAE,CAAC,UAAU,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,OAAO,KAAK,OAAO,CAAC;IACvD,OAAO,EAAE,CAAC,SAAS,EAAE,MAAM,OAAO,KAAK,OAAO,CAAC;CAChD,CAAC;AAEF,eAAO,MAAM,YAAY,qEAA2E,CAAC;AACrG,eAAO,MAAM,UAAU,4CAAkE,CAAC;AAE1F,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,QAEtE;AACD,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,QAEnD;AACD,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAE3E;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,GAAG,SAAS,EAAE,MAAM,EAAE,WAAW,QAE1F;AAED,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,WAAW,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,SAAS,CAE3G"}