@warp-drive/core 5.6.0-alpha.18 → 5.6.0-alpha.5

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

@@ -1,91 +1,89 @@
-/* eslint-disable no-irregular-whitespace */
-import type { StableDocumentIdentifier } from "../../types/identifier.js";
-import type { IS_FUTURE, RequestContext, RequestInfo, ResponseInfo, StructuredDataDocument } from "../../types/request.js";
+import type { StableDocumentIdentifier } from '../../types/identifier';
+import type { IS_FUTURE, RequestContext, RequestInfo, ResponseInfo, StructuredDataDocument } from '../../types/request';
 export interface GodContext {
-	controller: AbortController;
-	response: ResponseInfo | null;
-	stream: ReadableStream | Promise<ReadableStream | null> | null;
-	hasRequestedStream: boolean;
-	id: number;
-	identifier: StableDocumentIdentifier | null;
+    controller: AbortController;
+    response: ResponseInfo | null;
+    stream: ReadableStream | Promise<ReadableStream | null> | null;
+    hasRequestedStream: boolean;
+    id: number;
+    identifier: StableDocumentIdentifier | null;
 }
 export type Deferred<T> = {
-	resolve(v: T): void;
-	reject(v: unknown): void;
-	promise: Promise<T>;
+    resolve(v: T): void;
+    reject(v: unknown): void;
+    promise: Promise<T>;
 };
 export type ManagedRequestPriority = {
-	blocking: boolean;
+    blocking: boolean;
 };
 export type DeferredStream = {
-	resolve(v: ReadableStream | null): void;
-	reject(v: unknown): void;
-	promise: Promise<ReadableStream | null> & {
-		sizeHint?: number;
-	};
+    resolve(v: ReadableStream | null): void;
+    reject(v: unknown): void;
+    promise: Promise<ReadableStream | null> & {
+        sizeHint?: number;
+    };
 };
 /**
-* A Future is a {@link Promise} which resolves to a {@link StructuredDataDocument | StructuredDocument}
-* while providing the ability to {@link Future.abort | abort} the underlying request, and
-* {@link Future.getStream | access the response stream} before the outer promise resolves;
-*
-* @public
-*/
+ * A Future is a Promise which resolves to a StructuredDocument
+ * while providing the ability to `abort` the underlying request,
+ * `getStream` the response before the outer promise resolves;
+ *
+ * @class Future
+ * @public
+ */
 export interface Future<T> extends Promise<StructuredDataDocument<T>> {
-	[IS_FUTURE]: true;
-	/**
-	* Cancel this request by firing the {@link AbortController}'s signal.
-	*
-	* @privateRemarks
-	* [MDN Reference](https://developer.mozilla.org/docs/Web/API/AbortController/abort)
-	*
-	* @param reason optional reason for aborting the request
-	* @public
-	*/
-	abort(reason?: string): void;
-	/**
-	* Get the response stream, if any, once made available.
-	*
-	* @public
-	* @return {Promise<ReadableStream | null>}
-	*/
-	getStream(): Promise<ReadableStream | null>;
-	/**
-	*  Run a callback when this request completes. Use sparingly,
-	*  mostly useful for instrumentation and infrastructure.
-	*
-	* @param cb the callback to run
-	* @public
-	* @return {void}
-	*/
-	onFinalize(cb: () => void): void;
-	/**
-	* The identifier of the associated request, if any, as
-	* assigned by the CacheHandler.
-	*
-	* @property lid
-	* @type {StableDocumentIdentifier | null}
-	* @public
-	*/
-	lid: StableDocumentIdentifier | null;
-	/**
-	* The id of the associated request, if any, as assigned
-	* by the RequestManager
-	*
-	* @property id
-	* @type {Number}
-	* @public
-	*/
-	id: number;
+    [IS_FUTURE]: true;
+    /**
+     * Cancel this request by firing the AbortController's signal.
+     *
+     * @param {String} [reason] optional reason for aborting the request
+     * @public
+     * @return {void}
+     */
+    abort(reason?: string): void;
+    /**
+     * Get the response stream, if any, once made available.
+     *
+     * @public
+     * @return {Promise<ReadableStream | null>}
+     */
+    getStream(): Promise<ReadableStream | null>;
+    /**
+     *  Run a callback when this request completes. Use sparingly,
+     *  mostly useful for instrumentation and infrastructure.
+     *
+     * @param cb the callback to run
+     * @public
+     * @return {void}
+     */
+    onFinalize(cb: () => void): void;
+    /**
+     * The identifier of the associated request, if any, as
+     * assigned by the CacheHandler.
+     *
+     * @property lid
+     * @type {StableDocumentIdentifier | null}
+     * @public
+     */
+    lid: StableDocumentIdentifier | null;
+    /**
+     * The id of the associated request, if any, as assigned
+     * by the RequestManager
+     *
+     * @property id
+     * @type {Number}
+     * @public
+     */
+    id: number;
 }
 export type DeferredFuture<T> = {
-	resolve(v: StructuredDataDocument<T>): void;
-	reject(v: unknown): void;
-	promise: Future<T>;
+    resolve(v: StructuredDataDocument<T>): void;
+    reject(v: unknown): void;
+    promise: Future<T>;
 };
 export type NextFn<P = unknown> = (req: RequestInfo) => Future<P>;
 /**
-* Requests are fulfilled by handlers. A handler receives the request context
+ * Requests are fulfilled by handlers. A handler receives the request context
 as well as a `next` function with which to pass along a request to the next
 handler if it so chooses.
 
@@ -99,7 +97,7 @@ that it can then compose how it sees fit with its own response.
 type NextFn<P> = (req: RequestInfo) => Future<P>;
 
 interface Handler {
-async request<T>(context: RequestContext, next: NextFn<P>): T;
+  async request<T>(context: RequestContext, next: NextFn<P>): T;
 }
 ```
 
@@ -107,10 +105,10 @@ async request<T>(context: RequestContext, next: NextFn<P>): T;
 
 ```ts
 interface RequestContext<T> {
-readonly request: RequestInfo;
+  readonly request: RequestInfo;
 
-setStream(stream: ReadableStream | Promise<ReadableStream>): void;
-setResponse(response: Response | ResponseInfo): void;
+  setStream(stream: ReadableStream | Promise<ReadableStream>): void;
+  setResponse(response: Response | ResponseInfo): void;
 }
 ```
 
@@ -123,13 +121,13 @@ response content before passing along the chunk downstream.
 
 ```ts
 const FetchHandler = {
-async request(context) {
-const response = await fetch(context.request);
-context.setResponse(reponse);
-context.setStream(response.clone().body);
+  async request(context) {
+    const response = await fetch(context.request);
+    context.setResponse(reponse);
+    context.setStream(response.clone().body);
 
-return response.json();
-}
+    return response.json();
+  }
 }
 ```
 
@@ -140,13 +138,13 @@ return response.json();
 For context, it helps to understand a few of the use-cases that RequestManager
 is intended to allow.
 
-- to manage and return streaming content (such as video files)
-- to fulfill a request from multiple sources or by splitting one request into multiple requests
-- for instance one API call for a user and another for the user's friends
-- or e.g. fulfilling part of the request from one source (one API, in-memory, localStorage, IndexedDB etc.) and the rest from another source (a different API, a WebWorker, etc.)
-- to coalesce multiple requests
-- to decorate a request with additional info
-- e.g. an Auth handler that ensures the correct tokens or headers or cookies are attached.
+ - to manage and return streaming content (such as video files)
+ - to fulfill a request from multiple sources or by splitting one request into multiple requests
+   - for instance one API call for a user and another for the user's friends
+   - or e.g. fulfilling part of the request from one source (one API, in-memory, localStorage, IndexedDB etc.) and the rest from another source (a different API, a WebWorker, etc.)
+ - to coalesce multiple requests
+ - to decorate a request with additional info
+   - e.g. an Auth handler that ensures the correct tokens or headers or cookies are attached.
 
 ----
 
@@ -186,51 +184,52 @@ Request handlers are registered by configuring the manager via `use`
 
 ```ts
 const manager = new RequestManager()
-.use([Handler1, Handler2]);
+  .use([Handler1, Handler2]);
 ```
 
 Handlers will be invoked in the order they are registered ("fifo", first-in first-out), and may only be registered up until the first request is made. It is recommended but not required to register all handlers at one time in order to ensure explicitly visible handler ordering.
 
 
-@class (Interface) Handler
-@public
+ @class (Interface) Handler
+ @public
 */
 export interface Handler {
-	/**
-	* Method to implement to handle requests. Receives the request
-	* context and a nextFn to call to pass-along the request to
-	* other handlers.
-	*
-	* @public
-	* @param context
-	* @param next
-	*/
-	request<T = unknown>(context: RequestContext, next: NextFn<T>): Promise<T | StructuredDataDocument<T>> | Future<T>;
+    /**
+     * Method to implement to handle requests. Receives the request
+     * context and a nextFn to call to pass-along the request to
+     * other handlers.
+     *
+     * @public
+     * @param context
+     * @param next
+     */
+    request<T = unknown>(context: RequestContext, next: NextFn<T>): Promise<T | StructuredDataDocument<T>> | Future<T>;
 }
 /**
-* The CacheHandler is identical to other handlers ecxept that it
-* is allowed to return a value synchronously. This is useful for
-* features like reducing microtask queueing when de-duping.
-*
-* A RequestManager may only have one CacheHandler, registered via
-* `manager.useCache(CacheHandler)`.
-*
-* @class (Interface) CacheHandler
-* @public
-*/
+ * The CacheHandler is identical to other handlers ecxept that it
+ * is allowed to return a value synchronously. This is useful for
+ * features like reducing microtask queueing when de-duping.
+ *
+ * A RequestManager may only have one CacheHandler, registered via
+ * `manager.useCache(CacheHandler)`.
+ *
+ * @class (Interface) CacheHandler
+ * @public
+ */
 export interface CacheHandler {
-	/**
-	* Method to implement to handle requests. Receives the request
-	* context and a nextFn to call to pass-along the request to
-	* other handlers.
-	*
-	* @public
-	* @param context
-	* @param next
-	*/
-	request<T = unknown>(context: RequestContext, next: NextFn<T>): Promise<T | StructuredDataDocument<T>> | Future<T> | T;
+    /**
+     * Method to implement to handle requests. Receives the request
+     * context and a nextFn to call to pass-along the request to
+     * other handlers.
+     *
+     * @public
+     * @param context
+     * @param next
+     */
+    request<T = unknown>(context: RequestContext, next: NextFn<T>): Promise<T | StructuredDataDocument<T>> | Future<T> | T;
 }
 export interface RequestResponse<T> {
-	result: T;
+    result: T;
 }
 export type GenericCreateArgs = Record<string | symbol, unknown>;
+//# sourceMappingURL=types.d.ts.map

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

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

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

@@ -1,15 +1,16 @@
-import type { RequestInfo, StructuredDataDocument } from "../../types/request.js";
-import { ContextOwner } from "./context.js";
-import type { DeferredFuture, Future, GodContext, Handler } from "./types.js";
+import type { RequestInfo, StructuredDataDocument } from '../../types/request';
+import { ContextOwner } from './context';
+import type { DeferredFuture, Future, GodContext, Handler } from './types';
 export declare const IS_CACHE_HANDLER: "___(unique) Symbol(IS_CACHE_HANDLER)";
 export declare function curryFuture<T>(owner: ContextOwner, inbound: Future<T>, outbound: DeferredFuture<T>): Future<T>;
 export interface HttpErrorProps extends DOMException {
-	code: number;
-	name: string;
-	status: number;
-	statusText: string;
-	isRequestError: boolean;
+    code: number;
+    name: string;
+    status: number;
+    statusText: string;
+    isRequestError: boolean;
 }
 export declare function enhanceReason(reason?: string): DOMException;
 export declare function handleOutcome<T>(owner: ContextOwner, inbound: Promise<T | StructuredDataDocument<T>>, outbound: DeferredFuture<T>): Future<T>;
 export declare function executeNextHandler<T>(wares: Readonly<Handler[]>, request: RequestInfo, i: number, god: GodContext): Future<T>;
+//# sourceMappingURL=utils.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/request/-private/utils.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,WAAW,EACX,sBAAsB,EAGvB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAAW,YAAY,EAAE,MAAM,WAAW,CAAC;AAIlD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAE3E,eAAO,MAAM,gBAAgB,wCAAiE,CAAC;AAC/F,wBAAgB,WAAW,CAAC,CAAC,EAAE,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,cAAc,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAuC9G;AA4BD,MAAM,WAAW,cAAe,SAAQ,YAAY;IAClD,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,OAAO,CAAC;CACzB;AAED,wBAAgB,aAAa,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,YAAY,CAE3D;AAED,wBAAgB,aAAa,CAAC,CAAC,EAC7B,KAAK,EAAE,YAAY,EACnB,OAAO,EAAE,OAAO,CAAC,CAAC,GAAG,sBAAsB,CAAC,CAAC,CAAC,CAAC,EAC/C,QAAQ,EAAE,cAAc,CAAC,CAAC,CAAC,GAC1B,MAAM,CAAC,CAAC,CAAC,CA6CX;AAMD,wBAAgB,kBAAkB,CAAC,CAAC,EAClC,KAAK,EAAE,QAAQ,CAAC,OAAO,EAAE,CAAC,EAC1B,OAAO,EAAE,WAAW,EACpB,CAAC,EAAE,MAAM,EACT,GAAG,EAAE,UAAU,GACd,MAAM,CAAC,CAAC,CAAC,CAmDX"}