@owlmeans/client-entrypoint 0.1.18-rc.45 → 0.1.18-rc.47

package/build/utils/handler.js

@@ -1,131 +1,137 @@
 import { DEFAULT_KEY } from '@owlmeans/client-config';
 import { EntrypointOutcome, provideResponse, transportAlias } from '@owlmeans/entrypoint';
 import { validate } from './entrypoint.js';
-import { extractParams } from '@owlmeans/client-route';
+import { clientRouteHelper } from '@owlmeans/client-route';
 import { PARAM, RouteMethod, RouteProtocols } from '@owlmeans/route';
 import { stringify } from 'qs';
-import { assertContext } from '@owlmeans/context';
+import { assertContext, memoHelper } from '@owlmeans/context';
 import { makeSecurityHelper } from '@owlmeans/config';
-import { ENTRYPOINT_FAILURE_SERVICE } from '../failure.js';
+import { ENTRYPOINT_FAILURE_SERVICE } from '../consts.js';
 import { logger } from '@owlmeans/log';
 const log = logger('client-entrypoint');
-export const apiHandler = (ref) => async (req, res) => {
-    const location = `client-entrypoint:api-handler:${ref.ref?.alias}`;
-    const context = assertContext(ref.ref?.ctx, location);
-    if (context.cfg.webService == null) {
-        throw new SyntaxError('No webService provided');
-    }
-    const ep = context.entrypoint(req.alias);
-    // A route names the protocol it answers on. Whatever is bound under that protocol takes the
-    // call, so a consumer writes `ep.call(...)` without learning which transport ran.
-    const transport = transportAlias(ep.route.route.protocol);
-    if (context.hasService(transport)) {
+export const makeApiCallHelper = (ref) => {
+    const apiHandler = async (req, res) => {
+        const location = `client-entrypoint:api-handler:${ref.ref?.alias}`;
+        const context = assertContext(ref.ref?.ctx, location);
+        if (context.cfg.webService == null) {
+            throw new SyntaxError('No webService provided');
+        }
+        const ep = context.entrypoint(req.alias);
+        // A route names the protocol it answers on. Whatever is bound under that protocol takes the
+        // call, so a consumer writes `ep.call(...)` without learning which transport ran.
+        const transport = transportAlias(ep.route.route.protocol);
+        if (context.hasService(transport)) {
+            req.path = ep.path();
+            return context.service(transport).handle(req, res);
+        }
+        // Which web client carries this call is decided by the service the route answers on — the one it
+        // names, or the one the context picks for its app type when it names none.
+        const route = ep.service();
+        const alias = typeof context.cfg.webService === 'string'
+            ? context.cfg.webService
+            : context.cfg.webService[route.service] ?? context.cfg.webService[DEFAULT_KEY];
+        if (alias == null) {
+            throw new SyntaxError(`Can't cast web service alias for ${ep.alias} entrypoint`);
+        }
+        const service = context.service(alias);
         req.path = ep.path();
-        return context.service(transport).handle(req, res);
-    }
-    // Which web client carries this call is decided by the service the route answers on — the one it
-    // names, or the one the context picks for its app type when it names none.
-    const route = ep.service();
-    const alias = typeof context.cfg.webService === 'string'
-        ? context.cfg.webService
-        : context.cfg.webService[route.service] ?? context.cfg.webService[DEFAULT_KEY];
-    if (alias == null) {
-        throw new SyntaxError(`Can't cast web service alias for ${ep.alias} entrypoint`);
-    }
-    const service = context.service(alias);
-    req.path = ep.path();
-    return service.handler(req, res);
-};
-export const apiInvoke = (ref, opts) => (async (req) => {
-    const ep = ref.ref;
-    if (ep == null) {
-        throw new SyntaxError('Try to make API call before the entrypoint is created');
-    }
-    const ctx = ep.ctx;
-    if (ctx == null) {
-        throw new SyntaxError(`No context provided in apiCall for ${ep.alias} entrypoint`);
-    }
-    if (req?.canceled) {
-        return { value: null, outcome: EntrypointOutcome.Ok };
-    }
-    const request = {
-        alias: ep.alias,
-        params: req?.params ?? {},
-        // JSON transports must send a body for mutation methods even when the contract has no
-        // payload.  Keeping that rule here makes every typed caller use `call({ params })`, never
-        // an SDK-specific `{ body: {} }` workaround.
-        body: req?.body ?? ([RouteMethod.POST, RouteMethod.PUT, RouteMethod.PATCH]
-            .includes(ep.route.route.method ?? RouteMethod.GET) ? {} : undefined),
-        headers: req?.headers ?? {},
-        query: req?.query ?? {},
-        host: req?.host,
-        base: req?.base,
-        path: ep.path(),
-        timeout: req?.timeout,
-        signal: req?.signal,
+        return service.handler(req, res);
     };
-    if (req?.cancel != null) {
-        const cancel = req.cancel;
-        req.cancel = () => {
-            cancel();
-            request.canceled = true;
+    const apiInvoke = (opts) => (async (req) => {
+        const ep = ref.ref;
+        if (ep == null) {
+            throw new SyntaxError('Try to make API call before the entrypoint is created');
+        }
+        const ctx = ep.ctx;
+        if (ctx == null) {
+            throw new SyntaxError(`No context provided in apiCall for ${ep.alias} entrypoint`);
+        }
+        if (req?.canceled) {
+            return { value: null, outcome: EntrypointOutcome.Ok };
+        }
+        const request = {
+            alias: ep.alias,
+            params: req?.params ?? {},
+            // JSON transports must send a body for mutation methods even when the contract has no
+            // payload.  Keeping that rule here makes every typed caller use `call({ params })`, never
+            // an SDK-specific `{ body: {} }` workaround.
+            body: req?.body ?? ([RouteMethod.POST, RouteMethod.PUT, RouteMethod.PATCH]
+                .includes(ep.route.route.method ?? RouteMethod.GET) ? {} : undefined),
+            headers: req?.headers ?? {},
+            query: req?.query ?? {},
+            host: req?.host,
+            base: req?.base,
+            path: ep.path(),
+            timeout: req?.timeout,
+            signal: req?.signal,
         };
-    }
-    if (opts?.validateOnCall) {
+        if (req?.cancel != null) {
+            const cancel = req.cancel;
+            req.cancel = () => {
+                cancel();
+                request.canceled = true;
+            };
+        }
+        if (opts?.validateOnCall) {
+            try {
+                await validate(ref)(request);
+            }
+            catch (e) {
+                log.error('Request validation failed', { alias: ep.alias, error: e });
+                throw e;
+            }
+        }
+        const reply = provideResponse();
+        if (ctx == null && ep.ctx == null) {
+            throw new SyntaxError(`Use entrypoint ${ep.alias} without context`);
+        }
         try {
-            await validate(ref)(request);
+            await apiHandler(request, reply);
+            if (reply.error != null)
+                throw reply.error;
         }
-        catch (e) {
-            log.error('Request validation failed', { alias: ep.alias, error: e });
-            throw e;
+        catch (error) {
+            if (ctx.hasService(ENTRYPOINT_FAILURE_SERVICE)) {
+                await ctx.service(ENTRYPOINT_FAILURE_SERVICE)
+                    .notify({ alias: ep.alias, request, error });
+            }
+            throw error;
         }
-    }
-    const reply = provideResponse();
-    if (ctx == null && ep.ctx == null) {
-        throw new SyntaxError(`Use entrypoint ${ep.alias} without context`);
-    }
-    try {
-        await apiHandler(ref)(request, reply);
-        if (reply.error != null)
-            throw reply.error;
-    }
-    catch (error) {
-        if (ctx.hasService(ENTRYPOINT_FAILURE_SERVICE)) {
-            await ctx.service(ENTRYPOINT_FAILURE_SERVICE)
-                .notify({ alias: ep.alias, request, error });
+        return { value: reply.value ?? null, outcome: reply.outcome ?? EntrypointOutcome.Ok };
+    });
+    const entrypointUrl = async (req, opts) => {
+        const ep = ref.ref;
+        if (ep == null) {
+            throw new SyntaxError('Try to make URL before the entrypoint is created');
         }
-        throw error;
-    }
-    return { value: reply.value ?? null, outcome: reply.outcome ?? EntrypointOutcome.Ok };
-});
-export const entrypointUrl = async (ref, req, opts) => {
-    const ep = ref.ref;
-    if (ep == null) {
-        throw new SyntaxError('Try to make URL before the entrypoint is created');
-    }
-    const ctx = ep.ctx;
-    if (ctx == null) {
-        throw new SyntaxError(`No context provided in entrypointUrl for ${ep.alias} entrypoint`);
-    }
-    // The base is left off here: an in-service URL is addressed relative to it, and the absolute
-    // branch below has `makeUrl` prepend it.
-    const epPath = ep.path();
-    const pathParams = extractParams(epPath);
-    let path = pathParams.reduce((p, param) => {
-        return p.replace(`${PARAM}${param}`, `${req?.params?.[param]}`);
-    }, epPath) + (req?.query != null ? `?${stringify(req?.query)}` : '');
-    // A socket address is always absolute, whoever owns the route. `new WebSocket(path)` resolves a
-    // relative value against the PAGE's origin, which in a split deployment is the web host and not
-    // the service that answers the upgrade — so the handshake goes somewhere that never speaks it
-    // and dies on a gateway timeout. Only a same-origin HTTP route benefits from staying relative.
-    const socket = ep.route.route.protocol === RouteProtocols.SOCKET;
-    // Locality is a question about the RESOLVED service, not about what the declaration happens to
-    // name: a route that names no service belongs to the asking context, and addressing it absolutely
-    // would turn in-app navigation into a full page load.
-    if (socket || !ep.isLocal() || opts?.absolute === true) {
-        const helper = makeSecurityHelper(ctx);
-        path = helper.makeUrl(ep.address(), path, { host: req?.host, base: req?.base, forceUnsecure: req?.unsecure });
-    }
-    return path;
+        const ctx = ep.ctx;
+        if (ctx == null) {
+            throw new SyntaxError(`No context provided in entrypointUrl for ${ep.alias} entrypoint`);
+        }
+        // The base is left off here: an in-service URL is addressed relative to it, and the absolute
+        // branch below has `makeUrl` prepend it.
+        const epPath = ep.path();
+        const pathParams = clientRouteHelper.extractParams(epPath);
+        let path = pathParams.reduce((p, param) => {
+            return p.replace(`${PARAM}${param}`, `${req?.params?.[param]}`);
+        }, epPath) + (req?.query != null ? `?${stringify(req?.query)}` : '');
+        // A socket address is always absolute, whoever owns the route. `new WebSocket(path)` resolves a
+        // relative value against the PAGE's origin, which in a split deployment is the web host and not
+        // the service that answers the upgrade — so the handshake goes somewhere that never speaks it
+        // and dies on a gateway timeout. Only a same-origin HTTP route benefits from staying relative.
+        const socket = ep.route.route.protocol === RouteProtocols.SOCKET;
+        // Locality is a question about the RESOLVED service, not about what the declaration happens to
+        // name: a route that names no service belongs to the asking context, and addressing it absolutely
+        // would turn in-app navigation into a full page load.
+        if (socket || !ep.isLocal() || opts?.absolute === true) {
+            const helper = makeSecurityHelper(ctx);
+            path = helper.makeUrl(ep.address(), path, { host: req?.host, base: req?.base, forceUnsecure: req?.unsecure });
+        }
+        return path;
+    };
+    return { apiHandler, apiInvoke, entrypointUrl };
 };
+export const apiCallOf = memoHelper.oncePer(makeApiCallHelper);
+/** @deprecated compat:factory-refactor — use `makeApiCallHelper(ref).entrypointUrl(…)` */
+export const entrypointUrl = (ref, req, opts) => makeApiCallHelper(ref).entrypointUrl(req, opts);
 //# sourceMappingURL=handler.js.map

package/build/utils/handler.js.map

@@ -1 +1 @@
-{"version":3,"file":"handler.js","sourceRoot":"","sources":["../../src/utils/handler.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"handler.js","sourceRoot":"","sources":["../../src/utils/handler.ts"],"names":[],"mappings":"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"}

package/build/utils/index.d.ts

@@ -1,3 +1,4 @@
+export type * from './handler/types.js';
 export * from './entrypoint.js';
 export * from './handler.js';
 //# sourceMappingURL=index.d.ts.map

package/build/utils/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AACA,cAAc,iBAAiB,CAAA;AAC/B,cAAc,cAAc,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AACA,mBAAmB,oBAAoB,CAAA;AACvC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,cAAc,CAAA"}

package/build/utils/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AACA,cAAc,iBAAiB,CAAA;AAC/B,cAAc,cAAc,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAEA,cAAc,iBAAiB,CAAA;AAC/B,cAAc,cAAc,CAAA"}

package/build/utils/types.local.d.ts

@@ -0,0 +1,5 @@
+import type { ClientConfig, ClientContext } from '@owlmeans/client-context';
+export type Config = ClientConfig;
+export interface Context<C extends Config = Config> extends ClientContext<C> {
+}
+//# sourceMappingURL=types.local.d.ts.map

package/build/utils/types.local.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.local.d.ts","sourceRoot":"","sources":["../../src/utils/types.local.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAA;AAE3E,MAAM,MAAM,MAAM,GAAG,YAAY,CAAA;AAEjC,MAAM,WAAW,OAAO,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,CAAE,SAAQ,aAAa,CAAC,CAAC,CAAC;CAAI"}

package/build/utils/types.local.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.local.js.map

package/build/utils/types.local.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.local.js","sourceRoot":"","sources":["../../src/utils/types.local.ts"],"names":[],"mappings":""}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@owlmeans/client-entrypoint",
-  "version": "0.1.18-rc.45",
+  "version": "0.1.18-rc.47",
   "license": "MIT",
   "type": "module",
   "scripts": {
@@ -28,25 +28,25 @@
     }
   },
   "dependencies": {
-    "@owlmeans/api": "^0.1.18-rc.45",
-    "@owlmeans/client-config": "^0.1.18-rc.42",
-    "@owlmeans/client-context": "^0.1.18-rc.46",
-    "@owlmeans/client-route": "^0.1.18-rc.46",
-    "@owlmeans/config": "^0.1.18-rc.42",
-    "@owlmeans/context": "^0.1.18-rc.32",
-    "@owlmeans/entrypoint": "^0.1.18-rc.39",
-    "@owlmeans/error": "^0.1.18-rc.36",
-    "@owlmeans/log": "^0.1.18-rc.0",
-    "@owlmeans/route": "^0.1.18-rc.33",
+    "@owlmeans/api": "^0.1.18-rc.47",
+    "@owlmeans/client-config": "^0.1.18-rc.44",
+    "@owlmeans/client-context": "^0.1.18-rc.48",
+    "@owlmeans/client-route": "^0.1.18-rc.48",
+    "@owlmeans/config": "^0.1.18-rc.44",
+    "@owlmeans/context": "^0.1.18-rc.34",
+    "@owlmeans/entrypoint": "^0.1.18-rc.41",
+    "@owlmeans/error": "^0.1.18-rc.38",
+    "@owlmeans/log": "^0.1.18-rc.2",
+    "@owlmeans/route": "^0.1.18-rc.35",
     "ajv-formats": "^3.0.1",
-    "qs": "^6.13.0"
+    "qs": "^6.16.0"
   },
   "peerDependencies": {
     "ajv": "*"
   },
   "devDependencies": {
     "@owlmeans/dep-config": "workspace:*",
-    "@types/qs": "^6.9.16",
+    "@types/qs": "^6.15.1",
     "nodemon": "^3.1.14",
     "typescript": "^7.0.2"
   },

package/src/consts.ts

@@ -0,0 +1 @@
+export const ENTRYPOINT_FAILURE_SERVICE = 'client-entrypoint:failure'

package/src/entrypoint.ts

@@ -2,9 +2,9 @@ import type { ClientEntrypoint, ClientEntrypointOptions, EntrypointRef, RefedEnt
 import type { AbstractRequest, CommonEntrypoint } from '@owlmeans/entrypoint'
 import { validate } from './utils/entrypoint.js'
 import { route } from '@owlmeans/client-route'
-import { apiInvoke, apiHandler, entrypointUrl } from './utils/handler.js'
+import { apiCallOf } from './utils/handler.js'
 import { AppType } from '@owlmeans/context'
-import { provideRequest } from './helper.js'
+import { clientRequestHelper } from './helper.js'
 
 /** Attach client behaviour to an entrypoint already materialized from a protocol. */
 export const bindMaterializedEntrypoint = <T, R extends AbstractRequest = AbstractRequest>(
@@ -16,6 +16,7 @@ export const bindMaterializedEntrypoint = <T, R extends AbstractRequest = Abstra
 
   let _entrypoint: ClientEntrypoint<T, R>
 
+  const apiHandler: RefedEntrypointHandler<T, R> = ref => apiCallOf(ref).apiHandler
   const _handler = handler ?? (arg.route.route.type === AppType.Backend ? apiHandler : undefined)
 
   assertExplicitHandler(arg.route.route.type, handler)
@@ -29,7 +30,7 @@ export const bindMaterializedEntrypoint = <T, R extends AbstractRequest = Abstra
   _entrypoint.gateParams = opts?.gateParams ?? arg.gateParams
 
   _entrypoint.url = ((req?: Partial<R>, urlOpts?: { absolute?: boolean }) =>
-    entrypointUrl<T, R>(entrypointHandle, req as never, urlOpts)) as ClientEntrypoint<T, R>['url']
+    apiCallOf(entrypointHandle).entrypointUrl(req as never, urlOpts)) as ClientEntrypoint<T, R>['url']
 
   // An entrypoint carrying a renderer IS a screen: it is addressed by URL, never called over the
   // wire. Saying so here turns what used to be a URL-shaped answer from `call()` into a report.
@@ -39,7 +40,7 @@ export const bindMaterializedEntrypoint = <T, R extends AbstractRequest = Abstra
         `Entrypoint ${_entrypoint.alias} renders a screen - address it with url() instead of call()/invoke()`
       )
     })
-    : apiInvoke<T, R>(entrypointHandle, opts)) as ClientEntrypoint<T, R>['invoke']
+    : apiCallOf(entrypointHandle).apiInvoke(opts)) as ClientEntrypoint<T, R>['invoke']
 
   _entrypoint.call = (async (req?: Partial<R>) =>
     (await _entrypoint.invoke(req)).value) as ClientEntrypoint<T, R>['call']
@@ -48,7 +49,7 @@ export const bindMaterializedEntrypoint = <T, R extends AbstractRequest = Abstra
     if (entrypointHandle.ref == null) {
       throw SyntaxError(`Try to request uninitialized entrypoint ${JSON.stringify(arg)}`)
     }
-    const _request = provideRequest(entrypointHandle.ref.alias, entrypointHandle.ref.path()) as R
+    const _request = clientRequestHelper.provideRequest(entrypointHandle.ref.alias, entrypointHandle.ref.path()) as R
 
     request != null && Object.entries(request).forEach(([key, value]) => {
       _request[key as keyof R] = value

package/src/failure.ts

@@ -1,28 +1,10 @@
-import { createLazyService } from '@owlmeans/context'
-import type { BasicContext, LazyService } from '@owlmeans/context'
-import type { AbstractRequest } from '@owlmeans/entrypoint'
+import { createLazyService, type BasicContext } from '@owlmeans/context'
 import { logger } from '@owlmeans/log'
+import { ENTRYPOINT_FAILURE_SERVICE } from './consts.js'
+import type { EntrypointFailurePlugin, EntrypointFailureService } from './types.js'
 
 const log = logger('client-entrypoint')
 
-export const ENTRYPOINT_FAILURE_SERVICE = 'client-entrypoint:failure'
-
-export interface EntrypointFailure {
-  alias: string
-  request: AbstractRequest
-  error: unknown
-}
-
-export interface EntrypointFailurePlugin {
-  alias: string
-  onFailure: (failure: EntrypointFailure) => void | Promise<void>
-}
-
-export interface EntrypointFailureService extends LazyService {
-  registerPlugin: (plugin: EntrypointFailurePlugin) => void
-  notify: (failure: EntrypointFailure) => Promise<void>
-}
-
 /** Context-local observers for rejected client calls; observers never replace the thrown error. */
 export const ensureEntrypointFailureService = (ctx: BasicContext<any>): EntrypointFailureService => {
   if (ctx.hasService(ENTRYPOINT_FAILURE_SERVICE)) {

package/src/helper/types.ts

@@ -0,0 +1,10 @@
+import type { AbstractRequest } from '@owlmeans/entrypoint'
+import type { JSONSchemaType } from 'ajv'
+
+/** Builds and shapes the requests a client sends. */
+export interface ClientRequestHelper {
+  /** A minimal cancellable `AbstractRequest` for an entrypoint alias at a path. */
+  provideRequest: <T extends {} = {}>(alias: string, path: string) => AbstractRequest<T>
+  /** Keeps only the non-null keys of `object` the AJV schema declares. */
+  pickPerSchema: <T, R>(object: T, schema: JSONSchemaType<R>) => Partial<R>
+}

package/src/helper.ts

@@ -1,31 +1,36 @@
-import type { RefedEntrypointHandler } from './types.js'
 import type { AbstractRequest } from '@owlmeans/entrypoint'
 import type { JSONSchemaType } from "ajv"
+import type { ClientRequestHelper } from './helper/types.js'
 
-export const stab: RefedEntrypointHandler<{}> = () => () => {
-  return void 0 as any
-}
+export const createClientRequestHelper = (): ClientRequestHelper => {
+  const provideRequest = <T extends {} = {}>(alias: string, path: string): AbstractRequest<T> => {
+    const request = {
+      alias,
+      params: {},
+      headers: {},
+      query: {},
+      path,
+      canceled: false,
+      cancel: () => request.canceled = true
+    }
 
-export const provideRequest = <T extends {} = {}>(alias: string, path: string): AbstractRequest<T> => {
-  const request = {
-    alias,
-    params: {},
-    headers: {},
-    query: {},
-    path,
-    canceled: false,
-    cancel: () => request.canceled = true
+    return request
   }
 
-  return request
+  const pickPerSchema = <T, R>(object: T, schema: JSONSchemaType<R>): Partial<R> =>
+    Object.keys(schema.properties).reduce(
+      (acc, key) => {
+        if (object[key as keyof T] != null) {
+          acc[key as keyof R] = object[key as keyof T] as unknown as R[keyof R]
+        }
+        return acc
+      }, {} as Partial<R>
+    )
+
+  return { provideRequest, pickPerSchema }
 }
 
-export const pickPerSchema = <T, R>(object: T, schema: JSONSchemaType<R>): Partial<R> =>
-  Object.keys(schema.properties).reduce(
-    (acc, key) => {
-      if (object[key as keyof T] != null) {
-        acc[key as keyof R] = object[key as keyof T] as unknown as R[keyof R]
-      }
-      return acc
-    }, {} as Partial<R>
-  )
+export const clientRequestHelper = createClientRequestHelper()
+
+/** @deprecated compat:factory-refactor — use `clientRequestHelper.provideRequest(…)` */
+export const provideRequest = <T extends {} = {}>(alias: string, path: string): AbstractRequest<T> => clientRequestHelper.provideRequest<T>(alias, path)

package/src/index.ts

@@ -1,6 +1,9 @@
 
 export type * from './types.js'
+export type * from './helper/types.js'
 export * from './errors.js'
 export * from './failure.js'
+export * from './consts.js'
 export * from './protocol.js'
-export { pickPerSchema, provideRequest, stab } from './helper.js'
+export { clientRequestHelper, createClientRequestHelper, provideRequest } from './helper.js'
+export { stab } from './stab.js'

package/src/stab.ts

@@ -0,0 +1,6 @@
+import type { RefedEntrypointHandler } from './types.js'
+
+/** The no-op handler of a URL-only frontend binding. */
+export const stab: RefedEntrypointHandler<{}> = () => () => {
+  return void 0 as any
+}

package/src/types.ts

@@ -3,6 +3,7 @@ import type {
   AbstractRequest, CommonEntrypoint, CommonEntrypointOptions, EntrypointHandler,
   EntrypointOutcome, EntrypointProtocolDeclaration, RegisteredEntrypoint, RequestOf,
 } from '@owlmeans/entrypoint'
+import type { LazyService } from '@owlmeans/context'
 
 export interface ClientEntrypoint<T = {}, R extends ClientRequest = ClientRequest> extends CommonEntrypoint {
   route: ClientRouteModel
@@ -30,12 +31,7 @@ export interface ClientEntrypoint<T = {}, R extends ClientRequest = ClientReques
  * its request and reply types are read directly from the declaration and cannot be replaced at a
  * call site.
  */
-export type ClientProtocolEntrypoint<Protocol extends EntrypointProtocolDeclaration> =
-  Omit<ClientEntrypoint, 'call' | 'invoke' | 'url' | 'validate' | 'request'>
-  & RegisteredEntrypoint<RequestOf<Protocol>, import('@owlmeans/entrypoint').ResponseOf<Protocol>>
-  & {
-    readonly protocol: Protocol
-  }
+export interface ClientProtocolEntrypoint<Protocol extends EntrypointProtocolDeclaration> extends Omit<ClientEntrypoint, 'call' | 'invoke' | 'url' | 'validate' | 'request'>, RegisteredEntrypoint<RequestOf<Protocol>, import('@owlmeans/entrypoint').ResponseOf<Protocol>> { readonly protocol: Protocol }
 
 export interface EntrypointCall<T, Req extends ClientRequest = ClientRequest> {
   <Type extends T, R extends Req = Req>(req?: Partial<R>): Promise<Type>
@@ -78,3 +74,19 @@ export interface EntrypointRef<T, R extends AbstractRequest = AbstractRequest> {
 export interface RefedEntrypointHandler<T = {}, R extends AbstractRequest = AbstractRequest> {
   (ref: EntrypointRef<T, R>): EntrypointHandler
 }
+
+export interface EntrypointFailure {
+  alias: string
+  request: AbstractRequest
+  error: unknown
+}
+
+export interface EntrypointFailurePlugin {
+  alias: string
+  onFailure: (failure: EntrypointFailure) => void | Promise<void>
+}
+
+export interface EntrypointFailureService extends LazyService {
+  registerPlugin: (plugin: EntrypointFailurePlugin) => void
+  notify: (failure: EntrypointFailure) => Promise<void>
+}

package/src/utils/handler/types.ts

@@ -0,0 +1,15 @@
+import type { AbstractRequest, EntrypointHandler } from '@owlmeans/entrypoint'
+import type { ClientEntrypointOptions, EntrypointInvoke, EntrypointUrlOptions } from '../../types.js'
+
+/** How a client entrypoint reaches its backend: the handler, the round trip and the address. */
+export interface ApiCallHelper<T, R extends AbstractRequest = AbstractRequest> {
+  /**
+   * The handler that carries the entrypoint's call: the transport service bound to its route's
+   * protocol, else the API client of the web service its route answers on.
+   */
+  apiHandler: EntrypointHandler
+  /** The round trip behind `invoke()`: builds the request, validates it on demand and notifies failure observers. */
+  apiInvoke: (opts?: ClientEntrypointOptions) => EntrypointInvoke<T, R>
+  /** The address behind `url()`: `:params` filled in, the query appended, absolute when the route is not local. */
+  entrypointUrl: (req?: Partial<R>, opts?: EntrypointUrlOptions) => Promise<string>
+}