@buildplease/webkit 1.0.0 → 1.0.2

package/README.md

@@ -0,0 +1,30 @@
+# @buildplease/webkit
+
+WebKit is the BuildPlease application kit for browser applications. It builds on Core and provides shared web application architecture and runtime primitives without depending on a specific frontend framework.
+
+## Installation
+
+```bash
+pnpm add @buildplease/webkit
+```
+
+## Usage
+
+```ts
+import { webkitAssembly } from '@buildplease/webkit';
+
+const assemblies = webkitAssembly();
+```
+
+## Features
+
+- browser application architecture and dependency injection
+- asynchronous operations and remote resources
+- transport-independent HTTP primitives
+- request interception and error handling
+- shared web models and utilities
+- L10n integration
+
+## License
+
+MIT

package/dist/src/index.cjs

@@ -1 +1 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});var e=Object.create,t=Object.defineProperty,n=Object.getOwnPropertyDescriptor,r=Object.getOwnPropertyNames,i=Object.getPrototypeOf,a=Object.prototype.hasOwnProperty,o=(e,i,o,s)=>{if(i&&typeof i==`object`||typeof i==`function`)for(var c=r(i),l=0,u=c.length,d;l<u;l++)d=c[l],!a.call(e,d)&&d!==o&&t(e,d,{get:(e=>i[e]).bind(null,d),enumerable:!(s=n(i,d))||s.enumerable});return e},s=(n,r,s)=>(s=n==null?{}:e(i(n)),o(r||!n||!n.__esModule||!a.call(n,`default`)?t(s,`default`,{value:n,enumerable:!0}):s,n));require("reflect-metadata");let c=require("@buildplease/core"),l=require("axios");l=s(l,1);let u=require("inversify");function d(){return[]}const f={name:`buildplease`,displayName:`BuildPlease`,scope:`@buildplease`};`${f.name}`;const p={DI:{}},m=c.CoreL10nResource;var h=class extends Error{statusCode;code;details;constructor(e){super(e.message),this.name=`HttpError`,this.statusCode=e.statusCode,this.code=e.code,this.details=e.details}},g=class e{order=-10;hash(){return Symbol.for(`${f.scope}.webkit.networking.interceptor.cookie`)}equals(t){return t instanceof e}intercept(e){return{...e,withCredentials:!0}}};function _(e,t){if(typeof Reflect==`object`&&typeof Reflect.metadata==`function`)return Reflect.metadata(e,t)}function v(e,t){return function(n,r){t(n,r,e)}}function y(e,t,n,r){var i=arguments.length,a=i<3?t:r===null?r=Object.getOwnPropertyDescriptor(t,n):r,o;if(typeof Reflect==`object`&&typeof Reflect.decorate==`function`)a=Reflect.decorate(e,t,n,r);else for(var s=e.length-1;s>=0;s--)(o=e[s])&&(a=(i<3?o(a):i>3?o(t,n,a):o(t,n))||a);return i>3&&a&&Object.defineProperty(t,n,a),a}const b=`Unknown Error`;let x=class{endpoint;interceptors=new S;constructor(e){this.endpoint=e,this.use(new g)}use(...e){return this.interceptors.add(...e),this}removeInterceptor(e){return this.interceptors.remove(e),this}clearInterceptors(){return this.interceptors.clear(),this}async execute(e,t){try{let n=await this.convertOrThrow(()=>this.endpoint.convertInput(e)),r={...t};for(let e of this.interceptors.list())r=e.intercept(r);let i=await this.endpoint.makeRequest(n,r);return await this.convertOrThrow(()=>this.endpoint.convertOutput(i))}catch(e){throw this.parseError(e)}}parseError(e){if(e instanceof h||e instanceof c.TimeoutError||e instanceof c.NetworkError||e instanceof c.CanceledError||e instanceof c.ConversionError||e instanceof c.UnknownError)return e;if(l.default.isCancel?.(e)||l.default.isAxiosError(e)&&(e.code===`ERR_CANCELED`||e.message===`canceled`))return new c.CanceledError({cause:e});if(l.default.isAxiosError(e)&&e.code===`ECONNABORTED`)return new c.TimeoutError({cause:e});if(l.default.isAxiosError(e)&&!e.response)return new c.NetworkError({message:e.message,cause:e});if(l.default.isAxiosError(e)&&e.response){let{status:t,data:n}=e.response,r=n;typeof r==`string`&&(r=(0,c.ignoreError)(()=>JSON.parse(r)).orDefault(r));let i=this.isStringArrayRecord(r.details)?r.details:void 0;return new h(this.buildHttpErrorOptions(t,r,i))}let t=e instanceof Error?e.message:b;return new c.UnknownError({message:t,cause:e})}async convertOrThrow(e){try{return await e()}catch(e){throw new c.ConversionError({cause:e})}}isStringArrayRecord(e){return!(0,c.isDefinedAndNotNull)(e)||!(0,c.isPlainObject)(e)?!1:Object.values(e).every(e=>Array.isArray(e)&&e.every(e=>typeof e==`string`))}buildHttpErrorOptions(e,t,n){return{statusCode:e,code:(0,c.isNonEmptyString)(t?.code)?t.code:`UNKNOWN_ERROR`,message:(0,c.isNonEmptyString)(t?.message)?t.message:b,details:n}}};x=y([(0,u.injectable)(),v(0,(0,u.unmanaged)()),_(`design:paramtypes`,[Object])],x);var S=class{map=new Map;add(...e){for(let t of e){let e=t.hash(),n=this.map.get(e);n&&n.equals(t)||this.map.set(e,t)}return this}remove(e){return this.map.delete(e.hash()),this}clear(){return this.map.clear(),this}list(){return[...this.map.values()].sort((e,t)=>e.order-t.order)}};function C(){let e=(0,c.coreAssembly)(),t=d();return[...e,...t]}Object.defineProperty(exports,"BaseRemoteResource",{enumerable:!0,get:function(){return x}}),exports.CookieInterceptor=g,exports.HttpError=h,exports.InterceptorSet=S,exports.WebKitL10nResource=m,exports.WebKitSymbols=p,exports.webkitAssembly=C,Object.keys(c).forEach(function(e){e!=="default"&&!Object.prototype.hasOwnProperty.call(exports,e)&&Object.defineProperty(exports,e,{enumerable:!0,get:function(){return c[e]}})});
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`}),require("reflect-metadata");let e=require("@buildplease/core"),t=require("inversify");function n(){return[]}`${{name:`buildplease`,displayName:`BuildPlease`,scope:`@buildplease`}.name}`;const r={DI:{}},i=e.CoreL10nResource;var a=class{mode;pendingEntries=[];activeEntries=new Set;interruption;isSerialOperationRunning=!1;constructor(e=`parallel`){this.mode=e}execute(t){if(this.interruption)return Promise.reject(new e.CanceledError);let n=this.createEntry(t);return this.mode===`serial`?(this.pendingEntries.push(n),this.startNextSerialOperation()):this.startEntry(n),n.promise}cancelAll(e){let t=this.pendingEntries.splice(0);for(let n of t)this.cancelEntry(n,e);for(let t of this.activeEntries)this.cancelEntry(t,e)}async interrupt(e){if(!this.interruption){let t=Promise.resolve().then(e).finally(()=>{this.interruption===t&&(this.interruption=void 0,this.startNextSerialOperation())});this.interruption=t,this.cancelAll()}await this.interruption}createEntry(e){let t,n;return{operation:e,promise:new Promise((e,r)=>{t=e,n=r}),resolve:e=>t?.(e),reject:e=>n?.(e),canceled:!1,settled:!1}}startEntry(e){if(e.canceled||this.interruption){this.cancelEntry(e);return}this.activeEntries.add(e),this.mode===`serial`&&(this.isSerialOperationRunning=!0),Promise.resolve().then(e.operation).then(t=>{e.canceled||this.resolveEntry(e,t)},t=>{e.canceled||this.rejectEntry(e,t)}).finally(()=>{this.activeEntries.delete(e),this.mode===`serial`&&(this.isSerialOperationRunning=!1,this.startNextSerialOperation())})}startNextSerialOperation(){if(this.mode!==`serial`||this.isSerialOperationRunning||this.interruption)return;let e=this.pendingEntries.shift();e&&this.startEntry(e)}cancelEntry(t,n){t.canceled||(t.canceled=!0,t.settled||this.rejectEntry(t,new e.CanceledError({cause:n})))}resolveEntry(e,t){e.settled||(e.settled=!0,e.resolve(t))}rejectEntry(e,t){e.settled||(e.settled=!0,e.reject(t))}},o=class extends Error{statusCode;code;details;constructor(e){super(e.message),this.name=`HttpError`,this.statusCode=e.statusCode,this.code=e.code,this.details=e.details,e.cause!==void 0&&(this.cause=e.cause)}},s=class{interceptors;constructor(e=[],t){this.interceptors=this.resolveInterceptors(e,t)}async intercept(e){let t=e;for(let e of this.interceptors)t=await e.intercept(t);return t}resolveInterceptors(e,t){let n=new Set,r=[];for(let i of e){if(n.has(i.identity)){t?.(`Duplicate HTTP request interceptor ignored: ${String(i.identity)}`);continue}n.add(i.identity),r.push(i)}return Object.freeze(r)}};const c={credentials:!0,headers:{}};var l=class{requestOptions;interceptorPipeline;asyncQueue;unauthorized;constructor(e={}){this.requestOptions=e.requestOptions??{},this.interceptorPipeline=e.interceptorPipeline??new s,this.asyncQueue=e.asyncQueue??new a,this.unauthorized=e.unauthorized}execute(e,t){return this.asyncQueue.execute(async()=>{let n=await this.makeRequestOptions(e,t);try{let t=this.createClient(n);return await e.execute(t)}catch(e){throw this.handleError(e)}})}handleError(t){return t instanceof o||t instanceof e.NetworkError||t instanceof e.TimeoutError||t instanceof e.CanceledError||t instanceof e.UnknownError?t:new e.UnknownError({message:t instanceof Error?t.message:void 0,cause:t})}async makeRequestOptions(e,t){let n=this.mergeRequestOptions(c,this.requestOptions);return n=await this.interceptorPipeline.intercept(n),n=this.mergeRequestOptions(n,e.options),n=this.mergeRequestOptions(n,t),n}mergeRequestOptions(e,t){return t?{credentials:t.credentials??e.credentials,headers:{...e.headers,...t.headers}}:e}};function u(e,t){if(typeof Reflect==`object`&&typeof Reflect.metadata==`function`)return Reflect.metadata(e,t)}function d(e,t){return function(n,r){t(n,r,e)}}function f(e,t,n,r){var i=arguments.length,a=i<3?t:r===null?r=Object.getOwnPropertyDescriptor(t,n):r,o;if(typeof Reflect==`object`&&typeof Reflect.decorate==`function`)a=Reflect.decorate(e,t,n,r);else for(var s=e.length-1;s>=0;s--)(o=e[s])&&(a=(i<3?o(a):i>3?o(t,n,a):o(t,n))||a);return i>3&&a&&Object.defineProperty(t,n,a),a}let p=class{endpoint;httpClient;constructor(e,t){this.endpoint=e,this.httpClient=t}async execute(e,t){let n=await this.convertOrThrow(()=>this.endpoint.convertInput(e)),r=this.endpoint.makeRequest(n),i=await this.httpClient.execute(r,t);return await this.convertOrThrow(()=>this.endpoint.convertOutput(i))}async convertOrThrow(t){try{return await t()}catch(t){throw new e.ConversionError({cause:t})}}};p=f([(0,t.injectable)(),d(0,(0,t.unmanaged)()),d(1,(0,t.unmanaged)()),u(`design:paramtypes`,[Object,Object])],p);let m=class extends p{constructor(e,t){super(e,t)}};m=f([(0,t.injectable)(),u(`design:paramtypes`,[Object,Object])],m);let h=class extends p{constructor(e,t){super(e,t)}async execute(t,n){try{return await super.execute(t,n)}catch(t){if(!(t instanceof o))throw t;let n=this.httpClient.unauthorized;throw!n||!n.statusCodes.includes(t.statusCode)?t:n.cancelAll?(await this.httpClient.asyncQueue.interrupt(()=>n.handler.handle(t)),new e.CanceledError({cause:t})):(await n.handler.handle(t),t)}}};h=f([(0,t.injectable)(),u(`design:paramtypes`,[Object,Object])],h);function g(){let t=(0,e.coreAssembly)(),r=n();return[...t,...r]}exports.AsyncQueueImpl=a,exports.HttpClient=l,exports.HttpError=o,exports.HttpRequestInterceptorPipeline=s,Object.defineProperty(exports,"PublicRemoteResource",{enumerable:!0,get:function(){return m}}),Object.defineProperty(exports,"RemoteResource",{enumerable:!0,get:function(){return p}}),Object.defineProperty(exports,"SecuredRemoteResource",{enumerable:!0,get:function(){return h}}),exports.WebKitL10nResource=i,exports.WebKitSymbols=r,exports.webkitAssembly=g,Object.keys(e).forEach(function(t){t!=="default"&&!Object.prototype.hasOwnProperty.call(exports,t)&&Object.defineProperty(exports,t,{enumerable:!0,get:function(){return e[t]}})});

package/dist/src/index.d.cts

@@ -1,6 +1,5 @@
 import "reflect-metadata";
-import { Assembly, AsyncOperation, Equatable, Hashable, Identity } from "@buildplease/core";
-import { AxiosRequestConfig } from "axios";
+import { Assembly, AsyncOperation, Identity } from "@buildplease/core";
 export * from "@buildplease/core";
 //#region src/di/symbols.d.ts
 declare const WebKitSymbols: {
@@ -308,62 +307,123 @@ interface TablePaginationModel {
   pageSizeOptions?: number[];
 }
 //#endregion
-//#region src/networking/http-error.d.ts
-interface HttpErrorOptions {
+//#region src/networking/async-queue.d.ts
+/**
+ * Defines how queued operations are processed.
+ *
+ * `parallel` starts each operation immediately without waiting for previous operations to finish.
+ * `serial` starts an operation only after the previous operation has finished.
+ */
+type AsyncQueueMode = 'parallel' | 'serial';
+/**
+ * Executes and coordinates asynchronous operations.
+ */
+interface AsyncQueue {
+  /**
+   * Executes an operation according to the configured queue mode.
+   * Operations submitted during an interruption are canceled without running.
+   */
+  execute<Output>(operation: () => Promise<Output>): Promise<Output>;
+  /**
+   * Cancels all unresolved operations. Pending serial operations are not started and results from
+   * already-running operations are ignored.
+   *
+   * @param cause Optional cancellation cause.
+   */
+  cancelAll(cause?: unknown): void;
+  /**
+   * Cancels all unresolved operations and executes one interruption handler.
+   * Concurrent interruptions wait for the same handler to complete.
+   */
+  interrupt(handler: () => Promise<void>): Promise<void>;
+}
+declare class AsyncQueueImpl implements AsyncQueue {
+  private readonly mode;
+  private readonly pendingEntries;
+  private readonly activeEntries;
+  private interruption?;
+  private isSerialOperationRunning;
+  constructor(mode?: AsyncQueueMode);
+  execute<Output>(operation: () => Promise<Output>): Promise<Output>;
+  cancelAll(cause?: unknown): void;
+  interrupt(handler: () => Promise<void>): Promise<void>;
+  private createEntry;
+  private startEntry;
+  private startNextSerialOperation;
+  private cancelEntry;
+  private resolveEntry;
+  private rejectEntry;
+}
+//#endregion
+//#region src/networking/http-request-options.d.ts
+interface HttpRequestOptions {
   /**
-   * HTTP status code for the error response.
-   * @example 404 // Not Found
-   * @example 500 // Internal Server Error
+   * Whether browser credentials such as cookies should be included with the request,
+   * including cross-origin requests.
+   *
+   * @default true
    */
-  statusCode: number;
+  readonly credentials?: boolean;
   /**
-   * Machine‐readable error code for programmatic handling.
-   * @example "UNAUTHORIZED"
-   * @example "RESOURCE_NOT_FOUND"
+   * Headers included with the request.
+   *
+   * @default {}
    */
-  code: string;
+  readonly headers?: Readonly<Record<string, string>>;
+}
+//#endregion
+//#region src/networking/http-request.d.ts
+interface HttpRequest<Client, Output> {
   /**
-   * Human‐readable error description (localized or raw).
-   * @example "Authentication required"
-   * @example "User profile not found"
+   * Executes the request using the configured client.
    */
-  message: string;
+  readonly execute: (client: Client) => Promise<Output>;
   /**
-   * Optional structured details for debugging.
-   * Each key maps to an array of error messages for that field.
+   * Options applied specifically to this request.
    *
-   * @example
-   * {
-   *   "email": ["must be a valid email address"],
-   *   "password": ["required", "must be at least 8 characters"]
-   * }
+   * @default undefined
    */
-  details?: Record<string, string[]>;
+  readonly options?: HttpRequestOptions;
 }
+//#endregion
+//#region src/networking/http-request-interceptor.d.ts
 /**
- * A specialized `Error` carrying an HTTP status code, machine‐readable code,
- * human‐readable message, and optional debug details.
- *
- * @example
- * // Basic usage
- * throw new HttpError({
- *   statusCode: 404,
- *   code: "NOT_FOUND",
- *   message: "Resource not found"
- * });
- *
- * @example
- * // With structured debug details
- * throw new HttpError({
- *   statusCode: 422,
- *   code: "VALIDATION_ERROR",
- *   message: "One or more fields are invalid",
- *   details: {
- *     "email": ["must be a valid email address"],
- *     "password": ["required", "must be at least 8 characters"]
- *   }
- * });
+ * Modifies HTTP request options before a request is executed.
  */
+interface HttpRequestInterceptor {
+  /** Stable identity used to ignore duplicate interceptors. */
+  readonly identity: Identity;
+  /** Applies this interceptor to the current request options. */
+  intercept(options: HttpRequestOptions): HttpRequestOptions | Promise<HttpRequestOptions>;
+}
+declare class HttpRequestInterceptorPipeline {
+  private readonly interceptors;
+  constructor(interceptors?: readonly HttpRequestInterceptor[], onWarning?: (message: string) => void);
+  intercept(options: HttpRequestOptions): Promise<HttpRequestOptions>;
+  private resolveInterceptors;
+}
+//#endregion
+//#region src/networking/http-error.d.ts
+interface HttpErrorOptions {
+  /** HTTP status code returned by the remote system. */
+  readonly statusCode: number;
+  /** Machine-readable error code for programmatic handling. */
+  readonly code: string;
+  /** Human-readable error description. */
+  readonly message: string;
+  /**
+   * Structured error details.
+   *
+   * @default undefined
+   */
+  readonly details?: Readonly<Record<string, string[]>>;
+  /**
+   * Original transport error.
+   *
+   * @default undefined
+   */
+  readonly cause?: unknown;
+}
 declare class HttpError extends Error {
   readonly statusCode: HttpErrorOptions['statusCode'];
   readonly code: HttpErrorOptions['code'];
@@ -371,53 +431,95 @@ declare class HttpError extends Error {
   constructor(options: HttpErrorOptions);
 }
 //#endregion
-//#region src/networking/cookie-interceptor.d.ts
-declare class CookieInterceptor implements RemoteRequestInterceptor {
-  order: number;
-  hash(): Identity;
-  equals(other: unknown): boolean;
-  intercept(config: RemoteRequestConfig): RemoteRequestConfig;
+//#region src/networking/unauthorized.d.ts
+interface UnauthorizedHandler {
+  handle(error: HttpError): Promise<void>;
+}
+interface UnauthorizedOptions {
+  /** HTTP status codes that trigger unauthorized handling. */
+  readonly statusCodes: readonly number[];
+  /** Whether unauthorized handling cancels all unresolved requests sharing the same HTTP client. */
+  readonly cancelAll: boolean;
+  /** Application-specific unauthorized handler. */
+  readonly handler: UnauthorizedHandler;
+}
+//#endregion
+//#region src/networking/http-client.d.ts
+interface HttpClientOptions {
+  /**
+   * Default options applied to every request before interceptors and request-specific options.
+   *
+   * @default {}
+   */
+  readonly requestOptions?: HttpRequestOptions;
+  /**
+   * Interceptors applied to every request.
+   *
+   * @default Empty `HttpRequestInterceptorPipeline`
+   */
+  readonly interceptorPipeline?: HttpRequestInterceptorPipeline;
+  /**
+   * Queue used to execute requests.
+   *
+   * @default `AsyncQueueImpl` in `parallel` mode
+   */
+  readonly asyncQueue?: AsyncQueue;
+  /**
+   * Unauthorized handling for secured requests.
+   *
+   * @default undefined
+   */
+  readonly unauthorized?: UnauthorizedOptions;
+}
+declare abstract class HttpClient<Client> {
+  private readonly requestOptions;
+  private readonly interceptorPipeline;
+  readonly asyncQueue: AsyncQueue;
+  readonly unauthorized?: UnauthorizedOptions;
+  constructor(options?: HttpClientOptions);
+  execute<Output>(request: HttpRequest<Client, Output>, options?: HttpRequestOptions): Promise<Output>;
+  /** Creates the concrete client for the resolved request options. */
+  protected abstract createClient(options: HttpRequestOptions): Client;
+  /** Maps a transport-specific failure to a BuildPlease error. */
+  protected handleError(error: unknown): Error;
+  private makeRequestOptions;
+  private mergeRequestOptions;
 }
 //#endregion
 //#region src/networking/remote-endpoint.d.ts
-interface RemoteEndpoint<Input, InputDto, Output, OutputDto> {
-  makeRequest(input: InputDto, options?: RemoteRequestConfig): Promise<OutputDto>;
+/**
+ * Defines conversion and request creation for a remote operation.
+ */
+interface RemoteEndpoint<Input, InputDto, Output, OutputDto, Client> {
+  /** Converts operation input to the request DTO. */
   convertInput(input: Input): Promise<InputDto>;
+  /** Creates the HTTP request for the converted input. */
+  makeRequest(input: InputDto): HttpRequest<Client, OutputDto>;
+  /** Converts the response DTO to the operation output. */
   convertOutput(response: OutputDto): Promise<Output>;
 }
 //#endregion
 //#region src/networking/remote-resource.d.ts
-declare abstract class BaseRemoteResource<Input, Output, Endpoint extends RemoteEndpoint<Input, unknown, Output, unknown>> implements AsyncOperation<Input, Output> {
-  protected readonly endpoint: Endpoint;
-  protected readonly interceptors: InterceptorSet;
-  constructor(endpoint: Endpoint);
-  protected use(...items: RemoteRequestInterceptor[]): this;
-  protected removeInterceptor(item: RemoteRequestInterceptor): this;
-  protected clearInterceptors(): this;
-  execute(input: Input, options?: RemoteRequestConfig): Promise<Output>;
-  protected parseError(error: unknown): Error;
-  protected convertOrThrow<T>(fn: () => Promise<T>): Promise<T>;
-  private isStringArrayRecord;
-  private buildHttpErrorOptions;
+declare abstract class RemoteResource<Input, Output, Client> implements AsyncOperation<Input, Output, HttpRequestOptions> {
+  protected readonly endpoint: RemoteEndpoint<Input, unknown, Output, unknown, Client>;
+  protected readonly httpClient: HttpClient<Client>;
+  protected constructor(endpoint: RemoteEndpoint<Input, unknown, Output, unknown, Client>, httpClient: HttpClient<Client>);
+  execute(input: Input, options?: HttpRequestOptions): Promise<Output>;
+  private convertOrThrow;
 }
 //#endregion
-//#region src/networking/remote-request-config.d.ts
-type RemoteRequestConfig = AxiosRequestConfig;
-//#endregion
-//#region src/networking/remote-request-interceptor.d.ts
-interface RemoteRequestInterceptor extends Equatable, Hashable {
-  order: number;
-  intercept(config: RemoteRequestConfig): RemoteRequestConfig;
+//#region src/networking/public-remote-resource.d.ts
+declare class PublicRemoteResource<Input, Output, Client> extends RemoteResource<Input, Output, Client> {
+  constructor(endpoint: RemoteEndpoint<Input, unknown, Output, unknown, Client>, httpClient: HttpClient<Client>);
 }
-declare class InterceptorSet {
-  private map;
-  add(...items: RemoteRequestInterceptor[]): this;
-  remove(item: RemoteRequestInterceptor): this;
-  clear(): this;
-  list(): RemoteRequestInterceptor[];
+//#endregion
+//#region src/networking/secured-remote-resource.d.ts
+declare class SecuredRemoteResource<Input, Output, Client> extends RemoteResource<Input, Output, Client> {
+  constructor(endpoint: RemoteEndpoint<Input, unknown, Output, unknown, Client>, httpClient: HttpClient<Client>);
+  execute(input: Input, options?: HttpRequestOptions): Promise<Output>;
 }
 //#endregion
 //#region src/index.d.ts
 declare function webkitAssembly(): Assembly[];
 //#endregion
-export { BaseRemoteResource, CookieInterceptor, HttpError, HttpErrorOptions, InterceptorSet, RemoteEndpoint, RemoteRequestConfig, RemoteRequestInterceptor, TableDataModel, TablePaginationModel, WebKitL10nResource, WebKitSymbols, webkitAssembly };
+export { AsyncQueue, AsyncQueueImpl, AsyncQueueMode, HttpClient, HttpClientOptions, HttpError, HttpErrorOptions, HttpRequest, HttpRequestInterceptor, HttpRequestInterceptorPipeline, HttpRequestOptions, PublicRemoteResource, RemoteEndpoint, RemoteResource, SecuredRemoteResource, TableDataModel, TablePaginationModel, UnauthorizedHandler, UnauthorizedOptions, WebKitL10nResource, WebKitSymbols, webkitAssembly };

package/dist/src/index.d.ts

@@ -1,6 +1,5 @@
 import "reflect-metadata";
-import { Assembly, AsyncOperation, Equatable, Hashable, Identity } from "@buildplease/core";
-import { AxiosRequestConfig } from "axios";
+import { Assembly, AsyncOperation, Identity } from "@buildplease/core";
 export * from "@buildplease/core";
 //#region src/di/symbols.d.ts
 declare const WebKitSymbols: {
@@ -308,62 +307,123 @@ interface TablePaginationModel {
   pageSizeOptions?: number[];
 }
 //#endregion
-//#region src/networking/http-error.d.ts
-interface HttpErrorOptions {
+//#region src/networking/async-queue.d.ts
+/**
+ * Defines how queued operations are processed.
+ *
+ * `parallel` starts each operation immediately without waiting for previous operations to finish.
+ * `serial` starts an operation only after the previous operation has finished.
+ */
+type AsyncQueueMode = 'parallel' | 'serial';
+/**
+ * Executes and coordinates asynchronous operations.
+ */
+interface AsyncQueue {
+  /**
+   * Executes an operation according to the configured queue mode.
+   * Operations submitted during an interruption are canceled without running.
+   */
+  execute<Output>(operation: () => Promise<Output>): Promise<Output>;
+  /**
+   * Cancels all unresolved operations. Pending serial operations are not started and results from
+   * already-running operations are ignored.
+   *
+   * @param cause Optional cancellation cause.
+   */
+  cancelAll(cause?: unknown): void;
+  /**
+   * Cancels all unresolved operations and executes one interruption handler.
+   * Concurrent interruptions wait for the same handler to complete.
+   */
+  interrupt(handler: () => Promise<void>): Promise<void>;
+}
+declare class AsyncQueueImpl implements AsyncQueue {
+  private readonly mode;
+  private readonly pendingEntries;
+  private readonly activeEntries;
+  private interruption?;
+  private isSerialOperationRunning;
+  constructor(mode?: AsyncQueueMode);
+  execute<Output>(operation: () => Promise<Output>): Promise<Output>;
+  cancelAll(cause?: unknown): void;
+  interrupt(handler: () => Promise<void>): Promise<void>;
+  private createEntry;
+  private startEntry;
+  private startNextSerialOperation;
+  private cancelEntry;
+  private resolveEntry;
+  private rejectEntry;
+}
+//#endregion
+//#region src/networking/http-request-options.d.ts
+interface HttpRequestOptions {
   /**
-   * HTTP status code for the error response.
-   * @example 404 // Not Found
-   * @example 500 // Internal Server Error
+   * Whether browser credentials such as cookies should be included with the request,
+   * including cross-origin requests.
+   *
+   * @default true
    */
-  statusCode: number;
+  readonly credentials?: boolean;
   /**
-   * Machine‐readable error code for programmatic handling.
-   * @example "UNAUTHORIZED"
-   * @example "RESOURCE_NOT_FOUND"
+   * Headers included with the request.
+   *
+   * @default {}
    */
-  code: string;
+  readonly headers?: Readonly<Record<string, string>>;
+}
+//#endregion
+//#region src/networking/http-request.d.ts
+interface HttpRequest<Client, Output> {
   /**
-   * Human‐readable error description (localized or raw).
-   * @example "Authentication required"
-   * @example "User profile not found"
+   * Executes the request using the configured client.
    */
-  message: string;
+  readonly execute: (client: Client) => Promise<Output>;
   /**
-   * Optional structured details for debugging.
-   * Each key maps to an array of error messages for that field.
+   * Options applied specifically to this request.
    *
-   * @example
-   * {
-   *   "email": ["must be a valid email address"],
-   *   "password": ["required", "must be at least 8 characters"]
-   * }
+   * @default undefined
    */
-  details?: Record<string, string[]>;
+  readonly options?: HttpRequestOptions;
 }
+//#endregion
+//#region src/networking/http-request-interceptor.d.ts
 /**
- * A specialized `Error` carrying an HTTP status code, machine‐readable code,
- * human‐readable message, and optional debug details.
- *
- * @example
- * // Basic usage
- * throw new HttpError({
- *   statusCode: 404,
- *   code: "NOT_FOUND",
- *   message: "Resource not found"
- * });
- *
- * @example
- * // With structured debug details
- * throw new HttpError({
- *   statusCode: 422,
- *   code: "VALIDATION_ERROR",
- *   message: "One or more fields are invalid",
- *   details: {
- *     "email": ["must be a valid email address"],
- *     "password": ["required", "must be at least 8 characters"]
- *   }
- * });
+ * Modifies HTTP request options before a request is executed.
  */
+interface HttpRequestInterceptor {
+  /** Stable identity used to ignore duplicate interceptors. */
+  readonly identity: Identity;
+  /** Applies this interceptor to the current request options. */
+  intercept(options: HttpRequestOptions): HttpRequestOptions | Promise<HttpRequestOptions>;
+}
+declare class HttpRequestInterceptorPipeline {
+  private readonly interceptors;
+  constructor(interceptors?: readonly HttpRequestInterceptor[], onWarning?: (message: string) => void);
+  intercept(options: HttpRequestOptions): Promise<HttpRequestOptions>;
+  private resolveInterceptors;
+}
+//#endregion
+//#region src/networking/http-error.d.ts
+interface HttpErrorOptions {
+  /** HTTP status code returned by the remote system. */
+  readonly statusCode: number;
+  /** Machine-readable error code for programmatic handling. */
+  readonly code: string;
+  /** Human-readable error description. */
+  readonly message: string;
+  /**
+   * Structured error details.
+   *
+   * @default undefined
+   */
+  readonly details?: Readonly<Record<string, string[]>>;
+  /**
+   * Original transport error.
+   *
+   * @default undefined
+   */
+  readonly cause?: unknown;
+}
 declare class HttpError extends Error {
   readonly statusCode: HttpErrorOptions['statusCode'];
   readonly code: HttpErrorOptions['code'];
@@ -371,53 +431,95 @@ declare class HttpError extends Error {
   constructor(options: HttpErrorOptions);
 }
 //#endregion
-//#region src/networking/cookie-interceptor.d.ts
-declare class CookieInterceptor implements RemoteRequestInterceptor {
-  order: number;
-  hash(): Identity;
-  equals(other: unknown): boolean;
-  intercept(config: RemoteRequestConfig): RemoteRequestConfig;
+//#region src/networking/unauthorized.d.ts
+interface UnauthorizedHandler {
+  handle(error: HttpError): Promise<void>;
+}
+interface UnauthorizedOptions {
+  /** HTTP status codes that trigger unauthorized handling. */
+  readonly statusCodes: readonly number[];
+  /** Whether unauthorized handling cancels all unresolved requests sharing the same HTTP client. */
+  readonly cancelAll: boolean;
+  /** Application-specific unauthorized handler. */
+  readonly handler: UnauthorizedHandler;
+}
+//#endregion
+//#region src/networking/http-client.d.ts
+interface HttpClientOptions {
+  /**
+   * Default options applied to every request before interceptors and request-specific options.
+   *
+   * @default {}
+   */
+  readonly requestOptions?: HttpRequestOptions;
+  /**
+   * Interceptors applied to every request.
+   *
+   * @default Empty `HttpRequestInterceptorPipeline`
+   */
+  readonly interceptorPipeline?: HttpRequestInterceptorPipeline;
+  /**
+   * Queue used to execute requests.
+   *
+   * @default `AsyncQueueImpl` in `parallel` mode
+   */
+  readonly asyncQueue?: AsyncQueue;
+  /**
+   * Unauthorized handling for secured requests.
+   *
+   * @default undefined
+   */
+  readonly unauthorized?: UnauthorizedOptions;
+}
+declare abstract class HttpClient<Client> {
+  private readonly requestOptions;
+  private readonly interceptorPipeline;
+  readonly asyncQueue: AsyncQueue;
+  readonly unauthorized?: UnauthorizedOptions;
+  constructor(options?: HttpClientOptions);
+  execute<Output>(request: HttpRequest<Client, Output>, options?: HttpRequestOptions): Promise<Output>;
+  /** Creates the concrete client for the resolved request options. */
+  protected abstract createClient(options: HttpRequestOptions): Client;
+  /** Maps a transport-specific failure to a BuildPlease error. */
+  protected handleError(error: unknown): Error;
+  private makeRequestOptions;
+  private mergeRequestOptions;
 }
 //#endregion
 //#region src/networking/remote-endpoint.d.ts
-interface RemoteEndpoint<Input, InputDto, Output, OutputDto> {
-  makeRequest(input: InputDto, options?: RemoteRequestConfig): Promise<OutputDto>;
+/**
+ * Defines conversion and request creation for a remote operation.
+ */
+interface RemoteEndpoint<Input, InputDto, Output, OutputDto, Client> {
+  /** Converts operation input to the request DTO. */
   convertInput(input: Input): Promise<InputDto>;
+  /** Creates the HTTP request for the converted input. */
+  makeRequest(input: InputDto): HttpRequest<Client, OutputDto>;
+  /** Converts the response DTO to the operation output. */
   convertOutput(response: OutputDto): Promise<Output>;
 }
 //#endregion
 //#region src/networking/remote-resource.d.ts
-declare abstract class BaseRemoteResource<Input, Output, Endpoint extends RemoteEndpoint<Input, unknown, Output, unknown>> implements AsyncOperation<Input, Output> {
-  protected readonly endpoint: Endpoint;
-  protected readonly interceptors: InterceptorSet;
-  constructor(endpoint: Endpoint);
-  protected use(...items: RemoteRequestInterceptor[]): this;
-  protected removeInterceptor(item: RemoteRequestInterceptor): this;
-  protected clearInterceptors(): this;
-  execute(input: Input, options?: RemoteRequestConfig): Promise<Output>;
-  protected parseError(error: unknown): Error;
-  protected convertOrThrow<T>(fn: () => Promise<T>): Promise<T>;
-  private isStringArrayRecord;
-  private buildHttpErrorOptions;
+declare abstract class RemoteResource<Input, Output, Client> implements AsyncOperation<Input, Output, HttpRequestOptions> {
+  protected readonly endpoint: RemoteEndpoint<Input, unknown, Output, unknown, Client>;
+  protected readonly httpClient: HttpClient<Client>;
+  protected constructor(endpoint: RemoteEndpoint<Input, unknown, Output, unknown, Client>, httpClient: HttpClient<Client>);
+  execute(input: Input, options?: HttpRequestOptions): Promise<Output>;
+  private convertOrThrow;
 }
 //#endregion
-//#region src/networking/remote-request-config.d.ts
-type RemoteRequestConfig = AxiosRequestConfig;
-//#endregion
-//#region src/networking/remote-request-interceptor.d.ts
-interface RemoteRequestInterceptor extends Equatable, Hashable {
-  order: number;
-  intercept(config: RemoteRequestConfig): RemoteRequestConfig;
+//#region src/networking/public-remote-resource.d.ts
+declare class PublicRemoteResource<Input, Output, Client> extends RemoteResource<Input, Output, Client> {
+  constructor(endpoint: RemoteEndpoint<Input, unknown, Output, unknown, Client>, httpClient: HttpClient<Client>);
 }
-declare class InterceptorSet {
-  private map;
-  add(...items: RemoteRequestInterceptor[]): this;
-  remove(item: RemoteRequestInterceptor): this;
-  clear(): this;
-  list(): RemoteRequestInterceptor[];
+//#endregion
+//#region src/networking/secured-remote-resource.d.ts
+declare class SecuredRemoteResource<Input, Output, Client> extends RemoteResource<Input, Output, Client> {
+  constructor(endpoint: RemoteEndpoint<Input, unknown, Output, unknown, Client>, httpClient: HttpClient<Client>);
+  execute(input: Input, options?: HttpRequestOptions): Promise<Output>;
 }
 //#endregion
 //#region src/index.d.ts
 declare function webkitAssembly(): Assembly[];
 //#endregion
-export { BaseRemoteResource, CookieInterceptor, HttpError, HttpErrorOptions, InterceptorSet, RemoteEndpoint, RemoteRequestConfig, RemoteRequestInterceptor, TableDataModel, TablePaginationModel, WebKitL10nResource, WebKitSymbols, webkitAssembly };
+export { AsyncQueue, AsyncQueueImpl, AsyncQueueMode, HttpClient, HttpClientOptions, HttpError, HttpErrorOptions, HttpRequest, HttpRequestInterceptor, HttpRequestInterceptorPipeline, HttpRequestOptions, PublicRemoteResource, RemoteEndpoint, RemoteResource, SecuredRemoteResource, TableDataModel, TablePaginationModel, UnauthorizedHandler, UnauthorizedOptions, WebKitL10nResource, WebKitSymbols, webkitAssembly };

package/dist/src/index.js

@@ -1 +1 @@
-import"reflect-metadata";import{CanceledError as e,ConversionError as t,CoreL10nResource as n,NetworkError as r,TimeoutError as i,UnknownError as a,coreAssembly as o,ignoreError as s,isDefinedAndNotNull as c,isNonEmptyString as l,isPlainObject as u}from"@buildplease/core";import d from"axios";import{injectable as f,unmanaged as p}from"inversify";export*from"@buildplease/core";function m(){return[]}const h={name:`buildplease`,displayName:`BuildPlease`,scope:`@buildplease`};`${h.name}`;const g={DI:{}},_=n;var v=class extends Error{statusCode;code;details;constructor(e){super(e.message),this.name=`HttpError`,this.statusCode=e.statusCode,this.code=e.code,this.details=e.details}},y=class e{order=-10;hash(){return Symbol.for(`${h.scope}.webkit.networking.interceptor.cookie`)}equals(t){return t instanceof e}intercept(e){return{...e,withCredentials:!0}}};function b(e,t){if(typeof Reflect==`object`&&typeof Reflect.metadata==`function`)return Reflect.metadata(e,t)}function x(e,t){return function(n,r){t(n,r,e)}}function S(e,t,n,r){var i=arguments.length,a=i<3?t:r===null?r=Object.getOwnPropertyDescriptor(t,n):r,o;if(typeof Reflect==`object`&&typeof Reflect.decorate==`function`)a=Reflect.decorate(e,t,n,r);else for(var s=e.length-1;s>=0;s--)(o=e[s])&&(a=(i<3?o(a):i>3?o(t,n,a):o(t,n))||a);return i>3&&a&&Object.defineProperty(t,n,a),a}const C=`Unknown Error`;let w=class{endpoint;interceptors=new T;constructor(e){this.endpoint=e,this.use(new y)}use(...e){return this.interceptors.add(...e),this}removeInterceptor(e){return this.interceptors.remove(e),this}clearInterceptors(){return this.interceptors.clear(),this}async execute(e,t){try{let n=await this.convertOrThrow(()=>this.endpoint.convertInput(e)),r={...t};for(let e of this.interceptors.list())r=e.intercept(r);let i=await this.endpoint.makeRequest(n,r);return await this.convertOrThrow(()=>this.endpoint.convertOutput(i))}catch(e){throw this.parseError(e)}}parseError(n){if(n instanceof v||n instanceof i||n instanceof r||n instanceof e||n instanceof t||n instanceof a)return n;if(d.isCancel?.(n)||d.isAxiosError(n)&&(n.code===`ERR_CANCELED`||n.message===`canceled`))return new e({cause:n});if(d.isAxiosError(n)&&n.code===`ECONNABORTED`)return new i({cause:n});if(d.isAxiosError(n)&&!n.response)return new r({message:n.message,cause:n});if(d.isAxiosError(n)&&n.response){let{status:e,data:t}=n.response,r=t;typeof r==`string`&&(r=s(()=>JSON.parse(r)).orDefault(r));let i=this.isStringArrayRecord(r.details)?r.details:void 0;return new v(this.buildHttpErrorOptions(e,r,i))}let o=n instanceof Error?n.message:C;return new a({message:o,cause:n})}async convertOrThrow(e){try{return await e()}catch(e){throw new t({cause:e})}}isStringArrayRecord(e){return!c(e)||!u(e)?!1:Object.values(e).every(e=>Array.isArray(e)&&e.every(e=>typeof e==`string`))}buildHttpErrorOptions(e,t,n){return{statusCode:e,code:l(t?.code)?t.code:`UNKNOWN_ERROR`,message:l(t?.message)?t.message:C,details:n}}};w=S([f(),x(0,p()),b(`design:paramtypes`,[Object])],w);var T=class{map=new Map;add(...e){for(let t of e){let e=t.hash(),n=this.map.get(e);n&&n.equals(t)||this.map.set(e,t)}return this}remove(e){return this.map.delete(e.hash()),this}clear(){return this.map.clear(),this}list(){return[...this.map.values()].sort((e,t)=>e.order-t.order)}};function E(){let e=o(),t=m();return[...e,...t]}export{w as BaseRemoteResource,y as CookieInterceptor,v as HttpError,T as InterceptorSet,_ as WebKitL10nResource,g as WebKitSymbols,E as webkitAssembly};
+import"reflect-metadata";import{CanceledError as e,ConversionError as t,CoreL10nResource as n,NetworkError as r,TimeoutError as i,UnknownError as a,coreAssembly as o}from"@buildplease/core";import{injectable as s,unmanaged as c}from"inversify";export*from"@buildplease/core";function l(){return[]}`${{name:`buildplease`,displayName:`BuildPlease`,scope:`@buildplease`}.name}`;const u={DI:{}},d=n;var f=class{mode;pendingEntries=[];activeEntries=new Set;interruption;isSerialOperationRunning=!1;constructor(e=`parallel`){this.mode=e}execute(t){if(this.interruption)return Promise.reject(new e);let n=this.createEntry(t);return this.mode===`serial`?(this.pendingEntries.push(n),this.startNextSerialOperation()):this.startEntry(n),n.promise}cancelAll(e){let t=this.pendingEntries.splice(0);for(let n of t)this.cancelEntry(n,e);for(let t of this.activeEntries)this.cancelEntry(t,e)}async interrupt(e){if(!this.interruption){let t=Promise.resolve().then(e).finally(()=>{this.interruption===t&&(this.interruption=void 0,this.startNextSerialOperation())});this.interruption=t,this.cancelAll()}await this.interruption}createEntry(e){let t,n;return{operation:e,promise:new Promise((e,r)=>{t=e,n=r}),resolve:e=>t?.(e),reject:e=>n?.(e),canceled:!1,settled:!1}}startEntry(e){if(e.canceled||this.interruption){this.cancelEntry(e);return}this.activeEntries.add(e),this.mode===`serial`&&(this.isSerialOperationRunning=!0),Promise.resolve().then(e.operation).then(t=>{e.canceled||this.resolveEntry(e,t)},t=>{e.canceled||this.rejectEntry(e,t)}).finally(()=>{this.activeEntries.delete(e),this.mode===`serial`&&(this.isSerialOperationRunning=!1,this.startNextSerialOperation())})}startNextSerialOperation(){if(this.mode!==`serial`||this.isSerialOperationRunning||this.interruption)return;let e=this.pendingEntries.shift();e&&this.startEntry(e)}cancelEntry(t,n){t.canceled||(t.canceled=!0,t.settled||this.rejectEntry(t,new e({cause:n})))}resolveEntry(e,t){e.settled||(e.settled=!0,e.resolve(t))}rejectEntry(e,t){e.settled||(e.settled=!0,e.reject(t))}},p=class extends Error{statusCode;code;details;constructor(e){super(e.message),this.name=`HttpError`,this.statusCode=e.statusCode,this.code=e.code,this.details=e.details,e.cause!==void 0&&(this.cause=e.cause)}},m=class{interceptors;constructor(e=[],t){this.interceptors=this.resolveInterceptors(e,t)}async intercept(e){let t=e;for(let e of this.interceptors)t=await e.intercept(t);return t}resolveInterceptors(e,t){let n=new Set,r=[];for(let i of e){if(n.has(i.identity)){t?.(`Duplicate HTTP request interceptor ignored: ${String(i.identity)}`);continue}n.add(i.identity),r.push(i)}return Object.freeze(r)}};const h={credentials:!0,headers:{}};var g=class{requestOptions;interceptorPipeline;asyncQueue;unauthorized;constructor(e={}){this.requestOptions=e.requestOptions??{},this.interceptorPipeline=e.interceptorPipeline??new m,this.asyncQueue=e.asyncQueue??new f,this.unauthorized=e.unauthorized}execute(e,t){return this.asyncQueue.execute(async()=>{let n=await this.makeRequestOptions(e,t);try{let t=this.createClient(n);return await e.execute(t)}catch(e){throw this.handleError(e)}})}handleError(t){return t instanceof p||t instanceof r||t instanceof i||t instanceof e||t instanceof a?t:new a({message:t instanceof Error?t.message:void 0,cause:t})}async makeRequestOptions(e,t){let n=this.mergeRequestOptions(h,this.requestOptions);return n=await this.interceptorPipeline.intercept(n),n=this.mergeRequestOptions(n,e.options),n=this.mergeRequestOptions(n,t),n}mergeRequestOptions(e,t){return t?{credentials:t.credentials??e.credentials,headers:{...e.headers,...t.headers}}:e}};function _(e,t){if(typeof Reflect==`object`&&typeof Reflect.metadata==`function`)return Reflect.metadata(e,t)}function v(e,t){return function(n,r){t(n,r,e)}}function y(e,t,n,r){var i=arguments.length,a=i<3?t:r===null?r=Object.getOwnPropertyDescriptor(t,n):r,o;if(typeof Reflect==`object`&&typeof Reflect.decorate==`function`)a=Reflect.decorate(e,t,n,r);else for(var s=e.length-1;s>=0;s--)(o=e[s])&&(a=(i<3?o(a):i>3?o(t,n,a):o(t,n))||a);return i>3&&a&&Object.defineProperty(t,n,a),a}let b=class{endpoint;httpClient;constructor(e,t){this.endpoint=e,this.httpClient=t}async execute(e,t){let n=await this.convertOrThrow(()=>this.endpoint.convertInput(e)),r=this.endpoint.makeRequest(n),i=await this.httpClient.execute(r,t);return await this.convertOrThrow(()=>this.endpoint.convertOutput(i))}async convertOrThrow(e){try{return await e()}catch(e){throw new t({cause:e})}}};b=y([s(),v(0,c()),v(1,c()),_(`design:paramtypes`,[Object,Object])],b);let x=class extends b{constructor(e,t){super(e,t)}};x=y([s(),_(`design:paramtypes`,[Object,Object])],x);let S=class extends b{constructor(e,t){super(e,t)}async execute(t,n){try{return await super.execute(t,n)}catch(t){if(!(t instanceof p))throw t;let n=this.httpClient.unauthorized;throw!n||!n.statusCodes.includes(t.statusCode)?t:n.cancelAll?(await this.httpClient.asyncQueue.interrupt(()=>n.handler.handle(t)),new e({cause:t})):(await n.handler.handle(t),t)}}};S=y([s(),_(`design:paramtypes`,[Object,Object])],S);function C(){let e=o(),t=l();return[...e,...t]}export{f as AsyncQueueImpl,g as HttpClient,p as HttpError,m as HttpRequestInterceptorPipeline,x as PublicRemoteResource,b as RemoteResource,S as SecuredRemoteResource,d as WebKitL10nResource,u as WebKitSymbols,C as webkitAssembly};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@buildplease/webkit",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "keywords": [],
   "repository": {
     "type": "git",
@@ -37,8 +37,7 @@
     "resources"
   ],
   "dependencies": {
-    "axios": "1.19.0",
-    "@buildplease/core": "1.0.0"
+    "@buildplease/core": "1.0.2"
   },
   "devDependencies": {
     "@buildplease/identity": "1.0.0"