@owlmeans/client-entrypoint 0.1.18-rc.5 → 0.1.18-rc.50

package/build/helper.js

@@ -1,37 +1,25 @@
-import { entrypoint } from './entrypoint.js';
-import { isClientRouteModel } from '@owlmeans/client-route';
-import { normalizeHelperParams } from './utils/entrypoint.js';
-export const elevate = (entrypoints, alias, handler, opts) => {
-    [handler, opts] = normalizeHelperParams(handler, opts);
-    const idx = entrypoints.findIndex(({ route }) => route.route.alias === alias);
-    if (idx === -1) {
-        throw new SyntaxError(`Entrypoint with alias ${alias} not present`);
-    }
-    if (isClientRouteModel(entrypoints[idx].route) && opts?.force !== true) {
-        throw new SyntaxError(`Entrypoint with alias ${alias} is already elevated`);
-    }
-    entrypoints[idx] = entrypoint(entrypoints[idx], handler, opts);
-    return entrypoints;
-};
-export const stab = () => () => {
-    return void 0;
-};
-export const provideRequest = (alias, path) => {
-    const request = {
-        alias,
-        params: {},
-        headers: {},
-        query: {},
-        path,
-        canceled: false,
-        cancel: () => request.canceled = true
+export const createClientRequestHelper = () => {
+    const provideRequest = (alias, path) => {
+        const request = {
+            alias,
+            params: {},
+            headers: {},
+            query: {},
+            path,
+            canceled: false,
+            cancel: () => request.canceled = true
+        };
+        return request;
     };
-    return request;
+    const pickPerSchema = (object, schema) => Object.keys(schema.properties).reduce((acc, key) => {
+        if (object[key] != null) {
+            acc[key] = object[key];
+        }
+        return acc;
+    }, {});
+    return { provideRequest, pickPerSchema };
 };
-export const pickPerSchema = (object, schema) => Object.keys(schema.properties).reduce((acc, key) => {
-    if (object[key] != null) {
-        acc[key] = object[key];
-    }
-    return acc;
-}, {});
+export const clientRequestHelper = createClientRequestHelper();
+/** @deprecated compat:factory-refactor — use `clientRequestHelper.provideRequest(…)` */
+export const provideRequest = (alias, path) => clientRequestHelper.provideRequest(alias, path);
 //# sourceMappingURL=helper.js.map

package/build/helper.js.map

@@ -1 +1 @@
-{"version":3,"file":"helper.js","sourceRoot":"","sources":["../src/helper.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAC5C,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAA;AAE3D,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAA;AAG7D,MAAM,CAAC,MAAM,OAAO,GAAG,CACrB,WAA0D,EAC1D,KAAa,EACb,OAA0E,EAC1E,IAAwC,EACd,EAAE;IAC5B,CAAC,OAAO,EAAE,IAAI,CAAC,GAAG,qBAAqB,CAAC,OAAO,EAAE,IAAI,CAAC,CAAA;IAEtD,MAAM,GAAG,GAAG,WAAW,CAAC,SAAS,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,KAAK,KAAK,CAAC,CAAA;IAC7E,IAAI,GAAG,KAAK,CAAC,CAAC,EAAE,CAAC;QACf,MAAM,IAAI,WAAW,CAAC,yBAAyB,KAAK,cAAc,CAAC,CAAA;IACrE,CAAC;IACD,IAAI,kBAAkB,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,IAAI,IAAI,EAAE,KAAK,KAAK,IAAI,EAAE,CAAC;QACvE,MAAM,IAAI,WAAW,CAAC,yBAAyB,KAAK,sBAAsB,CAAC,CAAA;IAC7E,CAAC;IAED,WAAW,CAAC,GAAG,CAAC,GAAG,UAAU,CAAC,WAAW,CAAC,GAAG,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,CAAA;IAE9D,OAAO,WAAuC,CAAA;AAChD,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,IAAI,GAA+B,GAAG,EAAE,CAAC,GAAG,EAAE;IACzD,OAAO,KAAK,CAAQ,CAAA;AACtB,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,cAAc,GAAG,CAAoB,KAAa,EAAE,IAAY,EAAsB,EAAE;IACnG,MAAM,OAAO,GAAG;QACd,KAAK;QACL,MAAM,EAAE,EAAE;QACV,OAAO,EAAE,EAAE;QACX,KAAK,EAAE,EAAE;QACT,IAAI;QACJ,QAAQ,EAAE,KAAK;QACf,MAAM,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,QAAQ,GAAG,IAAI;KACtC,CAAA;IAED,OAAO,OAAO,CAAA;AAChB,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,aAAa,GAAG,CAAO,MAAS,EAAE,MAAyB,EAAc,EAAE,CACtF,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,MAAM,CACnC,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE;IACX,IAAI,MAAM,CAAC,GAAc,CAAC,IAAI,IAAI,EAAE,CAAC;QACnC,GAAG,CAAC,GAAc,CAAC,GAAG,MAAM,CAAC,GAAc,CAA0B,CAAA;IACvE,CAAC;IACD,OAAO,GAAG,CAAA;AACZ,CAAC,EAAE,EAAgB,CACpB,CAAA"}
+{"version":3,"file":"helper.js","sourceRoot":"","sources":["../src/helper.ts"],"names":[],"mappings":"AAIA,MAAM,CAAC,MAAM,yBAAyB,GAAG,GAAwB,EAAE;IACjE,MAAM,cAAc,GAAG,CAAoB,KAAa,EAAE,IAAY,EAAsB,EAAE;QAC5F,MAAM,OAAO,GAAG;YACd,KAAK;YACL,MAAM,EAAE,EAAE;YACV,OAAO,EAAE,EAAE;YACX,KAAK,EAAE,EAAE;YACT,IAAI;YACJ,QAAQ,EAAE,KAAK;YACf,MAAM,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,QAAQ,GAAG,IAAI;SACtC,CAAA;QAED,OAAO,OAAO,CAAA;IAChB,CAAC,CAAA;IAED,MAAM,aAAa,GAAG,CAAO,MAAS,EAAE,MAAyB,EAAc,EAAE,CAC/E,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,MAAM,CACnC,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE;QACX,IAAI,MAAM,CAAC,GAAc,CAAC,IAAI,IAAI,EAAE,CAAC;YACnC,GAAG,CAAC,GAAc,CAAC,GAAG,MAAM,CAAC,GAAc,CAA0B,CAAA;QACvE,CAAC;QACD,OAAO,GAAG,CAAA;IACZ,CAAC,EAAE,EAAgB,CACpB,CAAA;IAEH,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,CAAA;AAC1C,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,mBAAmB,GAAG,yBAAyB,EAAE,CAAA;AAE9D,wFAAwF;AACxF,MAAM,CAAC,MAAM,cAAc,GAAG,CAAoB,KAAa,EAAE,IAAY,EAAsB,EAAE,CAAC,mBAAmB,CAAC,cAAc,CAAI,KAAK,EAAE,IAAI,CAAC,CAAA"}

package/build/index.d.ts

@@ -1,5 +1,9 @@
-export * from './helper.js';
 export type * from './types.js';
-export * from './entrypoint.js';
+export type * from './helper/types.js';
 export * from './errors.js';
+export * from './failure.js';
+export * from './consts.js';
+export * from './protocol.js';
+export { clientRequestHelper, createClientRequestHelper, provideRequest } from './helper.js';
+export { stab } from './stab.js';
 //# sourceMappingURL=index.d.ts.map

package/build/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,aAAa,CAAA;AAC3B,mBAAmB,YAAY,CAAA;AAC/B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,aAAa,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,mBAAmB,YAAY,CAAA;AAC/B,mBAAmB,mBAAmB,CAAA;AACtC,cAAc,aAAa,CAAA;AAC3B,cAAc,cAAc,CAAA;AAC5B,cAAc,aAAa,CAAA;AAC3B,cAAc,eAAe,CAAA;AAC7B,OAAO,EAAE,mBAAmB,EAAE,yBAAyB,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAC5F,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA"}

package/build/index.js

@@ -1,4 +1,7 @@
-export * from './helper.js';
-export * from './entrypoint.js';
 export * from './errors.js';
+export * from './failure.js';
+export * from './consts.js';
+export * from './protocol.js';
+export { clientRequestHelper, createClientRequestHelper, provideRequest } from './helper.js';
+export { stab } from './stab.js';
 //# sourceMappingURL=index.js.map

package/build/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,aAAa,CAAA;AAE3B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,aAAa,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,cAAc,aAAa,CAAA;AAC3B,cAAc,cAAc,CAAA;AAC5B,cAAc,aAAa,CAAA;AAC3B,cAAc,eAAe,CAAA;AAC7B,OAAO,EAAE,mBAAmB,EAAE,yBAAyB,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAC5F,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA"}

package/build/protocol.d.ts

@@ -0,0 +1,9 @@
+import type { EntrypointProtocolDeclaration, EntrypointTree } from '@owlmeans/entrypoint';
+import type { ClientEntrypointOptions, ClientProtocolEntrypoint, RefedEntrypointHandler } from './types.js';
+/** Bind a shared protocol to the client context without changing the declaration itself. */
+export declare const bind: <Protocol extends EntrypointProtocolDeclaration>(protocol: Protocol, options?: ClientEntrypointOptions) => ClientProtocolEntrypoint<Protocol>;
+/** Materialize every protocol in an exported declaration tree for a browser context. */
+export declare const bindAll: (tree: EntrypointTree) => ClientProtocolEntrypoint<EntrypointProtocolDeclaration>[];
+/** Bind a frontend protocol to the component that renders it. */
+export declare const bindScreen: <Protocol extends EntrypointProtocolDeclaration>(protocol: Protocol, handler: RefedEntrypointHandler, options?: ClientEntrypointOptions) => ClientProtocolEntrypoint<Protocol>;
+//# sourceMappingURL=protocol.d.ts.map

package/build/protocol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.d.ts","sourceRoot":"","sources":["../src/protocol.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,6BAA6B,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAEzF,OAAO,KAAK,EACV,uBAAuB,EAAE,wBAAwB,EAAE,sBAAsB,EAC1E,MAAM,YAAY,CAAA;AAEnB,4FAA4F;AAC5F,eAAO,MAAM,IAAI,GAAI,QAAQ,SAAS,6BAA6B,YACvD,QAAQ,YACR,uBAAuB,KAChC,wBAAwB,CAAC,QAAQ,CAQnC,CAAA;AAED,wFAAwF;AACxF,eAAO,MAAM,OAAO,SAAU,cAAc,KAAG,wBAAwB,CAAC,6BAA6B,CAAC,EACrD,CAAA;AAEjD,iEAAiE;AACjE,eAAO,MAAM,UAAU,GAAI,QAAQ,SAAS,6BAA6B,YAC7D,QAAQ,WACT,sBAAsB,YACrB,uBAAuB,KAChC,wBAAwB,CAAC,QAAQ,CAQnC,CAAA"}

package/build/protocol.js

@@ -0,0 +1,15 @@
+import { materializeEntrypoint, protocols } from '@owlmeans/entrypoint';
+import { bindMaterializedEntrypoint } from './entrypoint.js';
+/** Bind a shared protocol to the client context without changing the declaration itself. */
+export const bind = (protocol, options) => {
+    const bound = Object.assign(bindMaterializedEntrypoint(materializeEntrypoint(protocol), undefined, options), { protocol });
+    return bound;
+};
+/** Materialize every protocol in an exported declaration tree for a browser context. */
+export const bindAll = (tree) => protocols(tree).map(protocol => bind(protocol));
+/** Bind a frontend protocol to the component that renders it. */
+export const bindScreen = (protocol, handler, options) => {
+    const bound = Object.assign(bindMaterializedEntrypoint(materializeEntrypoint(protocol), handler, options), { protocol });
+    return bound;
+};
+//# sourceMappingURL=protocol.js.map

package/build/protocol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.js","sourceRoot":"","sources":["../src/protocol.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAA;AAEvE,OAAO,EAAE,0BAA0B,EAAE,MAAM,iBAAiB,CAAA;AAK5D,4FAA4F;AAC5F,MAAM,CAAC,MAAM,IAAI,GAAG,CAClB,QAAkB,EAClB,OAAiC,EACG,EAAE;IACtC,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,0BAA0B,CACpD,qBAAqB,CAAC,QAAQ,CAAC,EAC/B,SAAS,EACT,OAAO,CACR,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAA;IAEhB,OAAO,KAA2C,CAAA;AACpD,CAAC,CAAA;AAED,wFAAwF;AACxF,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,IAAoB,EAA6D,EAAE,CACzG,SAAS,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAA;AAEjD,iEAAiE;AACjE,MAAM,CAAC,MAAM,UAAU,GAAG,CACxB,QAAkB,EAClB,OAA+B,EAC/B,OAAiC,EACG,EAAE;IACtC,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,0BAA0B,CACpD,qBAAqB,CAAC,QAAQ,CAAC,EAC/B,OAAO,EACP,OAAO,CACR,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAA;IAEhB,OAAO,KAA2C,CAAA;AACpD,CAAC,CAAA"}

package/build/stab.d.ts

@@ -0,0 +1,4 @@
+import type { RefedEntrypointHandler } from './types.js';
+/** The no-op handler of a URL-only frontend binding. */
+export declare const stab: RefedEntrypointHandler<{}>;
+//# sourceMappingURL=stab.d.ts.map

package/build/stab.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stab.d.ts","sourceRoot":"","sources":["../src/stab.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAA;AAExD,wDAAwD;AACxD,eAAO,MAAM,IAAI,EAAE,sBAAsB,CAAC,EAAE,CAE3C,CAAA"}

package/build/stab.js

@@ -0,0 +1,5 @@
+/** The no-op handler of a URL-only frontend binding. */
+export const stab = () => () => {
+    return void 0;
+};
+//# sourceMappingURL=stab.js.map

package/build/stab.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stab.js","sourceRoot":"","sources":["../src/stab.ts"],"names":[],"mappings":"AAEA,wDAAwD;AACxD,MAAM,CAAC,MAAM,IAAI,GAA+B,GAAG,EAAE,CAAC,GAAG,EAAE;IACzD,OAAO,KAAK,CAAQ,CAAA;AACtB,CAAC,CAAA"}

package/build/types.d.ts

@@ -1,33 +1,77 @@
 import type { ClientRouteModel, ClientRouteOptions } from '@owlmeans/client-route';
-import type { AbstractRequest, AbstractResponse, CommonEntrypoint, CommonEntrypointOptions, EntrypointHandler, EntrypointOutcome } from '@owlmeans/entrypoint';
+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;
+    /**
+     * Address the entrypoint and resolve to what it answered. The reply's error is thrown, so a
+     * caller that only needs the value never inspects an outcome.
+     */
     call: EntrypointCall<T, R>;
+    /**
+     * The same round trip as {@link ClientEntrypoint.call}, resolving to the value AND the outcome.
+     * Use it only where the outcome decides what happens next.
+     */
+    invoke: EntrypointInvoke<T, R>;
+    /**
+     * Build the URL this entrypoint addresses, with `:params` filled in and the query appended.
+     * Absolute when the route belongs to another service, or when `absolute` is asked for.
+     */
+    url: EntrypointUrl<R>;
     validate: EntrypointFilter<R>;
-    getPath: (partial?: boolean) => string;
     request: (request?: Partial<R>) => R;
 }
+/**
+ * The context-bound client view of a protocol.  Unlike the legacy `ClientEntrypoint` generic,
+ * its request and reply types are read directly from the declaration and cannot be replaced at a
+ * call site.
+ */
+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, P extends AbstractResponse<Type> = AbstractResponse<Type>>(req?: Partial<R>, res?: P): Promise<[Type, EntrypointOutcome]>;
+    <Type extends T, R extends Req = Req>(req?: Partial<R>): Promise<Type>;
+}
+export interface EntrypointInvoke<T, Req extends ClientRequest = ClientRequest> {
+    <Type extends T, R extends Req = Req>(req?: Partial<R>): Promise<EntrypointReply<Type>>;
+}
+export interface EntrypointReply<T> {
+    value: T;
+    outcome: EntrypointOutcome;
+}
+export interface EntrypointUrl<Req extends ClientRequest = ClientRequest> {
+    <R extends Req = Req>(req?: Partial<R>, opts?: EntrypointUrlOptions): Promise<string>;
+}
+export interface EntrypointUrlOptions {
+    /** Force a fully qualified URL even when the route belongs to the current service. */
+    absolute?: boolean;
 }
 export interface EntrypointFilter<Req extends AbstractRequest = AbstractRequest> {
     <R extends Req>(req?: Partial<R>): Promise<boolean>;
 }
 export interface ClientRequest<T extends {} = {}> extends AbstractRequest<T> {
-    full?: boolean;
 }
 export interface ClientEntrypointOptions extends CommonEntrypointOptions {
-    /**
-     * Force entrypoint to be elevated even if it is already elevated
-     */
-    force?: boolean;
     routeOptions?: ClientRouteOptions;
     validateOnCall?: boolean;
 }
 export interface EntrypointRef<T, R extends AbstractRequest = AbstractRequest> {
     ref?: ClientEntrypoint<T, R>;
 }
-export interface RefedEntrypointHandler<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>;
+}
 //# sourceMappingURL=types.d.ts.map

package/build/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAA;AAClF,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAA;AAE9J,MAAM,WAAW,gBAAgB,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,SAAS,aAAa,GAAG,aAAa,CAAE,SAAQ,gBAAgB;IACzG,KAAK,EAAE,gBAAgB,CAAA;IACvB,IAAI,EAAE,cAAc,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;IAC1B,QAAQ,EAAE,gBAAgB,CAAC,CAAC,CAAC,CAAA;IAC7B,OAAO,EAAE,CAAC,OAAO,CAAC,EAAE,OAAO,KAAK,MAAM,CAAA;IACtC,OAAO,EAAE,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAA;CACrC;AAED,MAAM,WAAW,cAAc,CAAC,CAAC,EAAE,GAAG,SAAS,aAAa,GAAG,aAAa;IAC1E,CACE,IAAI,SAAS,CAAC,EAAE,CAAC,SAAS,GAAG,GAAG,GAAG,EAAE,CAAC,SAAS,gBAAgB,CAAC,IAAI,CAAC,GAAG,gBAAgB,CAAC,IAAI,CAAC,EAC9F,GAAG,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,CAAC,IAAI,EAAE,iBAAiB,CAAC,CAAC,CAAA;CACjE;AAED,MAAM,WAAW,gBAAgB,CAAC,GAAG,SAAS,eAAe,GAAG,eAAe;IAC7E,CAAC,CAAC,SAAS,GAAG,EAAE,GAAG,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;CACpD;AAED,MAAM,WAAW,aAAa,CAAC,CAAC,SAAS,EAAE,GAAG,EAAE,CAAE,SAAQ,eAAe,CAAC,CAAC,CAAC;IAC1E,IAAI,CAAC,EAAE,OAAO,CAAA;CACf;AAED,MAAM,WAAW,uBAAwB,SAAQ,uBAAuB;IACtE;;OAEG;IACH,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,YAAY,CAAC,EAAE,kBAAkB,CAAA;IACjC,cAAc,CAAC,EAAE,OAAO,CAAA;CACzB;AAED,MAAM,WAAW,aAAa,CAAC,CAAC,EAAE,CAAC,SAAS,eAAe,GAAG,eAAe;IAC3E,GAAG,CAAC,EAAE,gBAAgB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;CAC7B;AAED,MAAM,WAAW,sBAAsB,CAAC,CAAC,EAAE,CAAC,SAAS,eAAe,GAAG,eAAe;IACpF,CAAC,GAAG,EAAE,aAAa,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,iBAAiB,CAAA;CAC9C"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/build/utils/entrypoint.d.ts

@@ -1,12 +1,10 @@
-import type { EntrypointFilter, ClientEntrypointOptions } from '../types.js';
+import type { EntrypointFilter } from '../types.js';
 import type { AbstractRequest } from '@owlmeans/entrypoint';
-import type { EntrypointRef, RefedEntrypointHandler } from '../types.js';
-export { entrypoint as makeBasicEntrypoint } from '@owlmeans/entrypoint';
+import type { EntrypointRef } from '../types.js';
 export { isEntrypoint } from '@owlmeans/entrypoint/utils';
 /**
  * @throws {SyntaxError} if data shape doesn't match validation
  * @throws {ClientValidationError} if request is not valid
  */
 export declare const validate: <T, R extends AbstractRequest = AbstractRequest>(ref: EntrypointRef<T, R>) => EntrypointFilter;
-export declare const normalizeHelperParams: <T, R extends AbstractRequest = AbstractRequest>(handler?: RefedEntrypointHandler<T, R> | ClientEntrypointOptions | boolean, opts?: ClientEntrypointOptions | boolean) => [RefedEntrypointHandler<T, R> | undefined, ClientEntrypointOptions | undefined];
 //# sourceMappingURL=entrypoint.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"entrypoint.d.ts","sourceRoot":"","sources":["../../src/utils/entrypoint.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAA;AAE5E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA;AAC3D,OAAO,KAAK,EAAE,aAAa,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAA;AAGxE,OAAO,EAAE,UAAU,IAAI,mBAAmB,EAAE,MAAM,sBAAsB,CAAA;AACxE,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAA;AAKzD;;;GAGG;AACH,eAAO,MAAM,QAAQ,EAAE,CAAC,CAAC,EAAE,CAAC,SAAS,eAAe,GAAG,eAAe,EAAE,GAAG,EAAE,aAAa,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,gBAiClG,CAAA;AAEH,eAAO,MAAM,qBAAqB,GAAI,CAAC,EAAE,CAAC,SAAS,eAAe,GAAG,eAAe,YACxE,sBAAsB,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,uBAAuB,GAAG,OAAO,SACnE,uBAAuB,GAAG,OAAO,KACvC,CAAC,sBAAsB,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,SAAS,EAAE,uBAAuB,GAAG,SAAS,CAShF,CAAA"}
+{"version":3,"file":"entrypoint.d.ts","sourceRoot":"","sources":["../../src/utils/entrypoint.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAEnD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA;AAC3D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAGhD,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAA;AAKzD;;;GAGG;AACH,eAAO,MAAM,QAAQ,EAAE,CAAC,CAAC,EAAE,CAAC,SAAS,eAAe,GAAG,eAAe,EAAE,GAAG,EAAE,aAAa,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,gBAiClG,CAAA"}

package/build/utils/entrypoint.js

@@ -1,7 +1,6 @@
 import Ajv from 'ajv';
 import { ClientValidationError } from '../errors.js';
 import formatsPlugin from 'ajv-formats';
-export { entrypoint as makeBasicEntrypoint } from '@owlmeans/entrypoint';
 export { isEntrypoint } from '@owlmeans/entrypoint/utils';
 const ajv = new Ajv({ strict: false });
 formatsPlugin(ajv);
@@ -40,12 +39,4 @@ export const validate = (ref) => async (req) => {
     }
     return true;
 };
-export const normalizeHelperParams = (handler, opts) => {
-    if (typeof handler !== 'function' && handler != null) {
-        opts = handler;
-        handler = undefined;
-    }
-    opts = typeof opts === 'boolean' ? { validateOnCall: opts } : opts;
-    return [handler, opts];
-};
 //# sourceMappingURL=entrypoint.js.map

package/build/utils/entrypoint.js.map

@@ -1 +1 @@
-{"version":3,"file":"entrypoint.js","sourceRoot":"","sources":["../../src/utils/entrypoint.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"entrypoint.js","sourceRoot":"","sources":["../../src/utils/entrypoint.ts"],"names":[],"mappings":"AAAA,OAAO,GAAG,MAAM,KAAK,CAAA;AAGrB,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAA;AAGpD,OAAO,aAAa,MAAM,aAAa,CAAA;AAEvC,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAA;AAEzD,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAA;AACtC,aAAa,CAAC,GAAU,CAAC,CAAA;AAEzB;;;GAGG;AACH,MAAM,CAAC,MAAM,QAAQ,GACnB,CAAC,GAAG,EAAE,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;IACrB,MAAM,EAAE,GAAG,GAAG,CAAC,GAAG,CAAA;IAClB,IAAI,EAAE,IAAI,IAAI,EAAE,CAAC;QACf,MAAM,IAAI,WAAW,CAAC,gDAAgD,CAAC,CAAA;IACzE,CAAC;IACD,IAAI,GAAG,EAAE,KAAK,IAAI,IAAI,EAAE,CAAC;QACvB,MAAM,IAAI,WAAW,CAAC,gEAAgE,CAAC,CAAA;IACzF,CAAC;IACD,IAAI,EAAE,CAAC,MAAM,IAAI,IAAI,EAAE,CAAC;QACtB,MAAM,IAAI,WAAW,CAAC,cAAc,GAAG,CAAC,KAAK,oCAAoC,CAAC,CAAA;IACpF,CAAC;IACD,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;SAClH,GAAG,CAAC,KAAK,EAAE,CAAC,GAAG,EAAE,MAAM,CAAC,EAAE,EAAE;QAC3B,IAAI,GAAG,CAAC,GAAuB,CAAC,IAAI,IAAI,EAAE,CAAC;YACzC,MAAM,IAAI,WAAW,CAAC,mCAAmC,GAAG,EAAE,CAAC,CAAA;QACjE,CAAC;QAED,MAAM,UAAU,GAAG,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,CAAA;QACtC,UAAU,CAAC,GAAG,CAAC,GAAuB,CAAC,CAAC,CAAA;QACxC,IAAI,UAAU,CAAC,MAAM,IAAI,IAAI,EAAE,CAAC;YAC9B,OAAO,IAAI,CAAA;QACb,CAAC;aAAM,CAAC;YACN,OAAO,UAAU,CAAC,MAAM,CAAA;QAC1B,CAAC;IACH,CAAC,CAAC,CAAC,CAAA;IACL,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,KAAK,IAAI,CAAC,EAAE,CAAC;QAC9C,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,KAAK,IAAI,IAAI,MAAM,IAAI,IAAI,CAAmB,CAAA;QAE1F,MAAM,IAAI,qBAAqB,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,YAAY,IAAI,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAA;IACnF,CAAC;IAED,OAAO,IAAI,CAAA;AACb,CAAC,CAAA"}

package/build/utils/handler/types.d.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>;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/utils/handler/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAA;AAC9E,OAAO,KAAK,EAAE,uBAAuB,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAA;AAErG,gGAAgG;AAChG,MAAM,WAAW,aAAa,CAAC,CAAC,EAAE,CAAC,SAAS,eAAe,GAAG,eAAe;IAC3E;;;OAGG;IACH,UAAU,EAAE,iBAAiB,CAAA;IAC7B,mHAAmH;IACnH,SAAS,EAAE,CAAC,IAAI,CAAC,EAAE,uBAAuB,KAAK,gBAAgB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;IACrE,iHAAiH;IACjH,aAAa,EAAE,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,EAAE,oBAAoB,KAAK,OAAO,CAAC,MAAM,CAAC,CAAA;CAClF"}

package/build/utils/handler/types.js

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

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

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

package/build/utils/handler.d.ts

@@ -1,6 +1,8 @@
-import type { AbstractRequest, EntrypointHandler } from '@owlmeans/entrypoint';
-import type { EntrypointCall, ClientEntrypointOptions, EntrypointRef, ClientRequest } from '../types.js';
-export declare const apiHandler: <T, R extends AbstractRequest = AbstractRequest>(ref: EntrypointRef<T, R>) => EntrypointHandler;
-export declare const apiCall: <T, R extends AbstractRequest = AbstractRequest>(ref: EntrypointRef<T, R>, opts?: ClientEntrypointOptions) => EntrypointCall<T, R>;
-export declare const urlCall: <T, R extends ClientRequest = ClientRequest>(ref: EntrypointRef<T, R>, opts?: ClientEntrypointOptions) => EntrypointCall<T, R>;
+import { type AbstractRequest } from '@owlmeans/entrypoint';
+import type { EntrypointUrlOptions, EntrypointRef, ClientRequest } from '../types.js';
+import type { ApiCallHelper } from './handler/types.js';
+export declare const makeApiCallHelper: <T, R extends AbstractRequest = AbstractRequest>(ref: EntrypointRef<T, R>) => ApiCallHelper<T, R>;
+export declare const apiCallOf: <T, R extends AbstractRequest = AbstractRequest<{}>>(target: EntrypointRef<T, R>) => ApiCallHelper<T, R>;
+/** @deprecated compat:factory-refactor — use `makeApiCallHelper(ref).entrypointUrl(…)` */
+export declare const entrypointUrl: <T, R extends ClientRequest = ClientRequest>(ref: EntrypointRef<T, R>, req?: Partial<R>, opts?: EntrypointUrlOptions) => Promise<string>;
 //# sourceMappingURL=handler.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"handler.d.ts","sourceRoot":"","sources":["../../src/utils/handler.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAA;AAE9E,OAAO,KAAK,EAAoB,cAAc,EAAE,uBAAuB,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAW1H,eAAO,MAAM,UAAU,EAAE,CACvB,CAAC,EAAE,CAAC,SAAS,eAAe,GAAG,eAAe,EAC9C,GAAG,EAAE,aAAa,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,iBA0B9B,CAAA;AAED,eAAO,MAAM,OAAO,EAAE,CACpB,CAAC,EAAE,CAAC,SAAS,eAAe,GAAG,eAAe,EAC9C,GAAG,EAAE,aAAa,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,IAAI,CAAC,EAAE,uBAAuB,KAAK,cAAc,CAAC,CAAC,EAAE,CAAC,CAyDvD,CAAA;AAE3B,eAAO,MAAM,OAAO,EAAE,CACpB,CAAC,EAAE,CAAC,SAAS,aAAa,GAAG,aAAa,EAC1C,GAAG,EAAE,aAAa,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,IAAI,CAAC,EAAE,uBAAuB,KAAK,cAAc,CAAC,CAAC,EAAE,CAAC,CA4BjF,CAAA"}
+{"version":3,"file":"handler.d.ts","sourceRoot":"","sources":["../../src/utils/handler.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,eAAe,EAAwG,MAAM,sBAAsB,CAAA;AACjK,OAAO,KAAK,EAAsC,oBAAoB,EAA2B,aAAa,EAAE,aAAa,EAA4B,MAAM,aAAa,CAAA;AAU5K,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAIvD,eAAO,MAAM,iBAAiB,GAAI,CAAC,EAAE,CAAC,SAAS,eAAe,GAAG,eAAe,OACzE,aAAa,CAAC,CAAC,EAAE,CAAC,CAAC,KACvB,aAAa,CAAC,CAAC,EAAE,CAAC,CA4IpB,CAAA;AAED,eAAO,MAAM,SAAS,GAhJY,CAAC,EAAE,CAAC,SAAS,eAAe,2EAgJA,CAAA;AAE9D,0FAA0F;AAC1F,eAAO,MAAM,aAAa,GAAI,CAAC,EAAE,CAAC,SAAS,aAAa,GAAG,aAAa,OACjE,aAAa,CAAC,CAAC,EAAE,CAAC,CAAC,QAAQ,OAAO,CAAC,CAAC,CAAC,SAAS,oBAAoB,KACtE,OAAO,CAAC,MAAM,CAAoD,CAAA"}

package/build/utils/handler.js

@@ -1,106 +1,137 @@
 import { DEFAULT_KEY } from '@owlmeans/client-config';
-import { EntrypointOutcome, provideResponse } from '@owlmeans/entrypoint';
+import { EntrypointOutcome, provideResponse, transportAlias } from '@owlmeans/entrypoint';
 import { validate } from './entrypoint.js';
-import { extractParams } from '@owlmeans/client-route';
-import { PARAM } from '@owlmeans/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';
-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);
-    const route = await ep.route.resolve(context);
-    let alias = typeof context.cfg.webService === 'string'
-        ? context.cfg.webService
-        : (route.service != null
-            ? context.cfg.webService[route.service] ?? context.cfg.webService[DEFAULT_KEY]
-            : 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.getPath();
-    return service.handler(req, res);
-};
-export const apiCall = (ref, opts) => (async (req, res) => {
-    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`);
-    }
-    await ep.route.resolve(ctx);
-    if (req?.canceled) {
-        return;
-    }
-    const request = {
-        alias: ep.alias,
-        params: req?.params ?? {},
-        body: req?.body,
-        headers: req?.headers ?? {},
-        query: req?.query ?? {},
-        host: req?.host,
-        base: req?.base,
-        path: ep.getPath(),
-        timeout: req?.timeout,
-        signal: req?.signal,
+import { ENTRYPOINT_FAILURE_SERVICE } from '../consts.js';
+import { logger } from '@owlmeans/log';
+const log = logger('client-entrypoint');
+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 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 (error) {
+            if (ctx.hasService(ENTRYPOINT_FAILURE_SERVICE)) {
+                await ctx.service(ENTRYPOINT_FAILURE_SERVICE)
+                    .notify({ alias: ep.alias, request, error });
+            }
+            throw error;
         }
-        catch (e) {
-            console.error(e);
-            throw e;
+        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');
         }
-    }
-    if (res != null) {
-        await apiHandler(ref)(request, res);
-        return;
-    }
-    const reply = provideResponse();
-    if (ctx == null && ep.ctx == null) {
-        throw new SyntaxError(`Use entrypoint ${ep.alias} without context`);
-    }
-    await apiHandler(ref)(request, reply);
-    if (reply.error != null) {
-        throw reply.error;
-    }
-    return [reply.value ?? null, reply.outcome ?? EntrypointOutcome.Ok];
-});
-export const urlCall = ref => async (req, res) => {
-    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 urlCall for ${ep.alias} entrypoint`);
-    }
-    await ep.route.resolve(ctx);
-    const pathParams = extractParams(ep.getPath());
-    let path = pathParams.reduce((p, param) => {
-        return p.replace(`${PARAM}${param}`, `${req?.params?.[param]}`);
-    }, ep.getPath()) + (req?.query != null ? `?${stringify(req?.query)}` : '');
-    if (ep.route.route.service !== null && (ctx.cfg.service !== ep.route.route.service
-        || req?.full === true)) {
-        const helper = makeSecurityHelper(ctx);
-        path = helper.makeUrl(ep.route.route, path, { host: req?.host, base: req?.base, forceUnsecure: req?.unsecure });
-    }
-    res?.resolve(path, EntrypointOutcome.Ok);
-    return [path, EntrypointOutcome.Ok];
+        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