@owlmeans/client-entrypoint 0.1.3

package/README.md

@@ -0,0 +1,77 @@
+# @owlmeans/client-entrypoint
+
+Client-side entrypoint system: elevates route definitions into API-calling `ClientEntrypoint` instances.
+
+## Overview
+
+- `elevate(entrypoints, alias, handler?, opts?)` — attaches a client handler to an entrypoint (mirrors server `elevate`)
+- `ClientEntrypoint<T>` has a `call(request?)` method that resolves the URL and makes an HTTP/WS request
+- `stab` — no-op handler for entrypoints that only need URL resolution (no logic)
+- `provideRequest(alias, path)` — creates an `AbstractRequest` for programmatic entrypoint calls
+- `pickPerSchema(schema, obj)` — extracts fields from an object matching an AJV schema
+- Re-exported as `celevate` from `@owlmeans/server-app`
+
+## Installation
+
+```bash
+bun add @owlmeans/client-entrypoint
+```
+
+## Usage
+
+Define and elevate a client entrypoint for API calls:
+
+```typescript
+import { elevate, stab } from '@owlmeans/client-entrypoint'
+import type { ClientEntrypoint } from '@owlmeans/client-entrypoint'
+
+const appModules = [
+  entrypoint(route('project-list', '/projects', frontend('base'))),
+  entrypoint(route('project-create', '/projects', backend(RouteMethod.POST))),
+]
+
+// Frontend navigation — just a stub, no network call
+elevate(appModules, 'project-list', stab)
+
+// Backend API call — call() makes a POST request
+elevate(appModules, 'project-create')
+```
+
+Call an entrypoint from a service:
+
+```typescript
+const agentEntrypoint = ctx.entrypoint<ClientEntrypoint<Project>>(agent.project.create)
+const [result] = await agentEntrypoint.call({
+  body: { prompt: payload.prompt, entity: req.auth?.entityId }
+})
+```
+
+## API
+
+### `elevate<T, R>(entrypoints, alias, handler?, opts?): ClientEntrypoint<T, R>[]`
+
+Mutates `entrypoints` in-place and returns the array typed as `ClientEntrypoint`. The `handler` sets how `call()` behaves.
+
+### `stab: RefedEntrypointHandler`
+
+No-op handler for frontend-only entrypoints that just need URL resolution.
+
+### `ClientEntrypoint<T>` (type)
+
+- `call(request?)` — resolves URL, makes HTTP request, returns `[T, EntrypointOutcome]`
+- `validate(request?)` — validates the request against the entrypoint filter schema
+- `getPath(partial?)` — returns the URL path (with or without path params)
+
+### `provideRequest<T>(alias, path): AbstractRequest<T>`
+
+Creates a minimal request object for programmatic `call()` invocations.
+
+### `pickPerSchema<T>(schema, obj): Partial<T>`
+
+Extracts only the keys present in the AJV schema from `obj`.
+
+## Related Packages
+
+- [`@owlmeans/entrypoint`](../entrypoint) — `CommonEntrypoint` base that gets elevated
+- [`@owlmeans/client`](../client) — `useNavigate` uses `ClientEntrypoint.call()`
+- [`@owlmeans/server-app`](../server-app) — re-exports `elevate` as `celevate`

package/build/entrypoint.d.ts

@@ -0,0 +1,6 @@
+import type { ClientRouteModel } from '@owlmeans/client-route';
+import type { ClientEntrypoint, ClientEntrypointOptions, RefedEntrypointHandler } from './types.js';
+import type { AbstractRequest, CommonEntrypoint } from '@owlmeans/entrypoint';
+import type { CommonRouteModel } from '@owlmeans/route';
+export declare const entrypoint: <T, R extends AbstractRequest = AbstractRequest>(arg: CommonEntrypoint | ClientRouteModel | CommonRouteModel, handler?: RefedEntrypointHandler<T, R> | ClientEntrypointOptions | boolean, opts?: ClientEntrypointOptions | boolean) => ClientEntrypoint<T, R>;
+//# sourceMappingURL=entrypoint.d.ts.map

package/build/entrypoint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entrypoint.d.ts","sourceRoot":"","sources":["../src/entrypoint.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAA;AAC9D,OAAO,KAAK,EAAE,gBAAgB,EAAE,uBAAuB,EAAiB,sBAAsB,EAAE,MAAM,YAAY,CAAA;AAClH,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAA;AAO7E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAA;AAGvD,eAAO,MAAM,UAAU,GAAI,CAAC,EAAE,CAAC,SAAS,eAAe,GAAG,eAAe,EACvE,KAAK,gBAAgB,GAAG,gBAAgB,GAAG,gBAAgB,EAC3D,UAAU,sBAAsB,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,uBAAuB,GAAG,OAAO,EAC1E,OAAO,uBAAuB,GAAG,OAAO,KACvC,gBAAgB,CAAC,CAAC,EAAE,CAAC,CA+DvB,CAAA"}

package/build/entrypoint.js

@@ -0,0 +1,62 @@
+import { isEntrypoint, makeBasicEntrypoint, normalizeHelperParams, validate } from './utils/entrypoint.js';
+import { isClientRouteModel, route } from '@owlmeans/client-route';
+import { apiCall, apiHandler, urlCall } from './utils/handler.js';
+import { AppType } from '@owlmeans/context';
+import { normalizePath } from '@owlmeans/route';
+import { provideRequest } from './helper.js';
+export const entrypoint = (arg, handler, opts) => {
+    const entrypointHandle = { ref: undefined };
+    let _entrypoint;
+    [handler, opts] = normalizeHelperParams(handler, opts);
+    const _handler = handler ??
+        (('route' in arg.route ? arg.route.route.type : arg.route.type)
+            === AppType.Backend ? apiHandler : undefined);
+    if (isEntrypoint(arg)) {
+        assertExplicitHandler(arg.route.route.type, handler);
+        const routeModel = route(arg.route, opts?.routeOptions);
+        _entrypoint = arg;
+        _entrypoint.route = routeModel;
+        _entrypoint.guards = opts?.guards ?? arg.guards;
+        _entrypoint.filter = opts?.filter ?? arg.filter;
+        _entrypoint.gate = opts?.gate ?? arg.gate;
+        _entrypoint.gateParams = opts?.gateParams ?? arg.gateParams;
+    }
+    else if (isClientRouteModel(arg)) {
+        assertExplicitHandler(arg.route.type, handler);
+        _entrypoint = makeBasicEntrypoint(arg, { ...opts });
+        _entrypoint.route = arg;
+    }
+    else {
+        assertExplicitHandler(arg.route.type, handler);
+        const _route = route(arg, opts?.routeOptions);
+        _entrypoint = makeBasicEntrypoint(_route, { ...opts });
+        _entrypoint.route = _route;
+    }
+    _entrypoint.getPath = (partial) => partial === true ? normalizePath(_entrypoint.route.route.partialPath) : _entrypoint.route.route.path;
+    _entrypoint.call = handler != null ? urlCall(entrypointHandle, opts) : apiCall(entrypointHandle, opts);
+    _entrypoint.request = ((request) => {
+        if (entrypointHandle.ref == null) {
+            throw SyntaxError(`Try to request uninitialized entrypoint ${JSON.stringify(arg)}`);
+        }
+        const _request = provideRequest(entrypointHandle.ref.getAlias(), entrypointHandle.ref.getPath());
+        request != null && Object.entries(request).forEach(([key, value]) => {
+            _request[key] = value;
+        });
+        return _request;
+    });
+    _entrypoint.handle = _handler?.(entrypointHandle);
+    _entrypoint.validate = validate(entrypointHandle);
+    _entrypoint.reinitializeContext = (context) => {
+        const newEntrypoint = entrypoint(_entrypoint.route, handler, opts);
+        newEntrypoint.ctx = context;
+        return newEntrypoint;
+    };
+    entrypointHandle.ref = _entrypoint;
+    return _entrypoint;
+};
+const assertExplicitHandler = (type, handler) => {
+    if (type === AppType.Backend && handler != null) {
+        throw new SyntaxError('We can\'t provide explicit handler to backend client entrypoint');
+    }
+};
+//# sourceMappingURL=entrypoint.js.map

package/build/entrypoint.js.map

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

package/build/errors.d.ts

@@ -0,0 +1,10 @@
+import { ResilientError } from '@owlmeans/error';
+export declare class ClientEntrypointError extends ResilientError {
+    static typeName: string;
+    constructor(message: string);
+}
+export declare class ClientValidationError extends ClientEntrypointError {
+    static typeName: string;
+    constructor(message: string);
+}
+//# sourceMappingURL=errors.d.ts.map

package/build/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AAEhD,qBAAa,qBAAsB,SAAQ,cAAc;IACvD,OAAuB,QAAQ,SAAsB;gBAEzC,OAAO,EAAE,MAAM;CAG5B;AAED,qBAAa,qBAAsB,SAAQ,qBAAqB;IAC9D,OAAuB,QAAQ,SAAgD;gBAEnE,OAAO,EAAE,MAAM;CAI5B"}

package/build/errors.js

@@ -0,0 +1,17 @@
+import { ResilientError } from '@owlmeans/error';
+export class ClientEntrypointError extends ResilientError {
+    static typeName = 'ClientModuleError';
+    constructor(message) {
+        super(ClientEntrypointError.typeName, `clinet-module:${message}`);
+    }
+}
+export class ClientValidationError extends ClientEntrypointError {
+    static typeName = `${ClientEntrypointError.typeName}Validation`;
+    constructor(message) {
+        super(`validation:${message}`);
+        this.type = ClientValidationError.typeName;
+    }
+}
+ResilientError.registerErrorClass(ClientEntrypointError);
+ResilientError.registerErrorClass(ClientValidationError);
+//# sourceMappingURL=errors.js.map

package/build/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AAEhD,MAAM,OAAO,qBAAsB,SAAQ,cAAc;IAChD,MAAM,CAAU,QAAQ,GAAG,mBAAmB,CAAA;IAErD,YAAY,OAAe;QACzB,KAAK,CAAC,qBAAqB,CAAC,QAAQ,EAAE,iBAAiB,OAAO,EAAE,CAAC,CAAA;IACnE,CAAC;;AAGH,MAAM,OAAO,qBAAsB,SAAQ,qBAAqB;IACvD,MAAM,CAAU,QAAQ,GAAG,GAAG,qBAAqB,CAAC,QAAQ,YAAY,CAAA;IAE/E,YAAY,OAAe;QACzB,KAAK,CAAC,cAAc,OAAO,EAAE,CAAC,CAAA;QAC9B,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC,QAAQ,CAAA;IAC5C,CAAC;;AAIH,cAAc,CAAC,kBAAkB,CAAC,qBAAqB,CAAC,CAAA;AACxD,cAAc,CAAC,kBAAkB,CAAC,qBAAqB,CAAC,CAAA"}

package/build/helper.d.ts

@@ -0,0 +1,8 @@
+import type { ClientEntrypoint, ClientEntrypointOptions, RefedEntrypointHandler } from './types.js';
+import type { AbstractRequest, CommonEntrypoint } from '@owlmeans/entrypoint';
+import type { JSONSchemaType } from "ajv";
+export declare const elevate: <T = {}, R extends AbstractRequest = AbstractRequest>(entrypoints: (CommonEntrypoint | ClientEntrypoint<T, R>)[], alias: string, handler?: RefedEntrypointHandler<T, R> | ClientEntrypointOptions | boolean, opts?: ClientEntrypointOptions | boolean) => ClientEntrypoint<T, R>[];
+export declare const stab: RefedEntrypointHandler<{}>;
+export declare const provideRequest: <T extends {} = {}>(alias: string, path: string) => AbstractRequest<T>;
+export declare const pickPerSchema: <T, R>(object: T, schema: JSONSchemaType<R>) => Partial<R>;
+//# sourceMappingURL=helper.d.ts.map

package/build/helper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helper.d.ts","sourceRoot":"","sources":["../src/helper.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAA;AAGnG,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAA;AAE7E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,KAAK,CAAA;AAEzC,eAAO,MAAM,OAAO,GAAI,CAAC,GAAG,EAAE,EAAE,CAAC,SAAS,eAAe,GAAG,eAAe,EACzE,aAAa,CAAC,gBAAgB,GAAG,gBAAgB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAC1D,OAAO,MAAM,EACb,UAAU,sBAAsB,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,uBAAuB,GAAG,OAAO,EAC1E,OAAO,uBAAuB,GAAG,OAAO,KACvC,gBAAgB,CAAC,CAAC,EAAE,CAAC,CAAC,EAcxB,CAAA;AAED,eAAO,MAAM,IAAI,EAAE,sBAAsB,CAAC,EAAE,CAE3C,CAAA;AAED,eAAO,MAAM,cAAc,GAAI,CAAC,SAAS,EAAE,GAAG,EAAE,EAAE,OAAO,MAAM,EAAE,MAAM,MAAM,KAAG,eAAe,CAAC,CAAC,CAYhG,CAAA;AAED,eAAO,MAAM,aAAa,GAAI,CAAC,EAAE,CAAC,EAAE,QAAQ,CAAC,EAAE,QAAQ,cAAc,CAAC,CAAC,CAAC,KAAG,OAAO,CAAC,CAAC,CAQjF,CAAA"}

package/build/helper.js

@@ -0,0 +1,37 @@
+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
+    };
+    return request;
+};
+export const pickPerSchema = (object, schema) => Object.keys(schema.properties).reduce((acc, key) => {
+    if (object[key] != null) {
+        acc[key] = object[key];
+    }
+    return acc;
+}, {});
+//# sourceMappingURL=helper.js.map

package/build/helper.js.map

@@ -0,0 +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"}

package/build/index.d.ts

@@ -0,0 +1,5 @@
+export * from './helper.js';
+export type * from './types.js';
+export * from './entrypoint.js';
+export * from './errors.js';
+//# sourceMappingURL=index.d.ts.map

package/build/index.d.ts.map

@@ -0,0 +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"}

package/build/index.js

@@ -0,0 +1,4 @@
+export * from './helper.js';
+export * from './entrypoint.js';
+export * from './errors.js';
+//# sourceMappingURL=index.js.map

package/build/index.js.map

@@ -0,0 +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"}

package/build/types.d.ts

@@ -0,0 +1,33 @@
+import type { ClientRouteModel, ClientRouteOptions } from '@owlmeans/client-route';
+import type { AbstractRequest, AbstractResponse, CommonEntrypoint, CommonEntrypointOptions, EntrypointHandler, EntrypointOutcome } from '@owlmeans/entrypoint';
+export interface ClientEntrypoint<T = {}, R extends ClientRequest = ClientRequest> extends CommonEntrypoint {
+    route: ClientRouteModel;
+    call: EntrypointCall<T, R>;
+    validate: EntrypointFilter<R>;
+    getPath: (partial?: boolean) => string;
+    request: (request?: Partial<R>) => R;
+}
+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]>;
+}
+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> {
+    (ref: EntrypointRef<T, R>): EntrypointHandler;
+}
+//# sourceMappingURL=types.d.ts.map

package/build/types.d.ts.map

@@ -0,0 +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"}

package/build/types.js

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

package/build/types.js.map

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

package/build/utils/entrypoint.d.ts

@@ -0,0 +1,12 @@
+import type { EntrypointFilter, ClientEntrypointOptions } from '../types.js';
+import type { AbstractRequest } from '@owlmeans/entrypoint';
+import type { EntrypointRef, RefedEntrypointHandler } from '../types.js';
+export { entrypoint as makeBasicEntrypoint } from '@owlmeans/entrypoint';
+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

@@ -0,0 +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,EAClF,UAAU,sBAAsB,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,uBAAuB,GAAG,OAAO,EAC1E,OAAO,uBAAuB,GAAG,OAAO,KACvC,CAAC,sBAAsB,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,SAAS,EAAE,uBAAuB,GAAG,SAAS,CAShF,CAAA"}

package/build/utils/entrypoint.js

@@ -0,0 +1,51 @@
+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);
+/**
+ * @throws {SyntaxError} if data shape doesn't match validation
+ * @throws {ClientValidationError} if request is not valid
+ */
+export const validate = (ref) => async (req) => {
+    const ep = ref.ref;
+    if (ep == null) {
+        throw new SyntaxError('Try to make API call before without entrypoint');
+    }
+    if (req?.alias == null) {
+        throw new SyntaxError(`Can't validate for unknown entrypoint (request.alias required)`);
+    }
+    if (ep.filter == null) {
+        throw new SyntaxError(`Entrypoint ${req.alias} has no filter to validate against`);
+    }
+    const results = await Promise.all(Object.entries(ep.filter).filter(([key]) => !['headers', 'response'].includes(key))
+        .map(async ([key, filter]) => {
+        if (req[key] == null) {
+            throw new SyntaxError(`Request has no required section ${key}`);
+        }
+        const validateFn = ajv.compile(filter);
+        validateFn(req[key]);
+        if (validateFn.errors == null) {
+            return true;
+        }
+        else {
+            return validateFn.errors;
+        }
+    }));
+    if (results.some((result) => result !== true)) {
+        const errors = results.find(result => result !== true && result != null);
+        throw new ClientValidationError(`${errors[0].instancePath}|${errors[0].message}`);
+    }
+    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

@@ -0,0 +1 @@
+{"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,UAAU,IAAI,mBAAmB,EAAE,MAAM,sBAAsB,CAAA;AACxE,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;AAEH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CACnC,OAA0E,EAC1E,IAAwC,EACyC,EAAE;IACnF,IAAI,OAAO,OAAO,KAAK,UAAU,IAAI,OAAO,IAAI,IAAI,EAAE,CAAC;QACrD,IAAI,GAAG,OAA4C,CAAA;QACnD,OAAO,GAAG,SAAS,CAAA;IACrB,CAAC;IAED,IAAI,GAAG,OAAO,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAA;IAElE,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,CAAA;AACxB,CAAC,CAAA"}

package/build/utils/handler.d.ts

@@ -0,0 +1,6 @@
+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>;
+//# sourceMappingURL=handler.d.ts.map

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

@@ -0,0 +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,CAuDvD,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"}

package/build/utils/handler.js

@@ -0,0 +1,104 @@
+import { DEFAULT_KEY } from '@owlmeans/client-config';
+import { EntrypointOutcome, provideResponse } from '@owlmeans/entrypoint';
+import { validate } from './entrypoint.js';
+import { extractParams } from '@owlmeans/client-route';
+import { PARAM } from '@owlmeans/route';
+import { stringify } from 'qs';
+import { assertContext } 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(),
+    };
+    if (req?.cancel != null) {
+        const cancel = req.cancel;
+        req.cancel = () => {
+            cancel();
+            request.canceled = true;
+        };
+    }
+    if (opts?.validateOnCall) {
+        try {
+            await validate(ref)(request);
+        }
+        catch (e) {
+            console.error(e);
+            throw e;
+        }
+    }
+    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];
+};
+//# sourceMappingURL=handler.js.map

package/build/utils/handler.js.map

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

package/build/utils/index.d.ts

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

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

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

package/build/utils/index.js

@@ -0,0 +1,3 @@
+export * from './entrypoint.js';
+export * from './handler.js';
+//# sourceMappingURL=index.js.map

package/build/utils/index.js.map

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

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "@owlmeans/client-entrypoint",
+  "version": "0.1.3",
+  "license": "MIT",
+  "type": "module",
+  "scripts": {
+    "build": "tsc -b",
+    "dev": "sleep 102 && nodemon -e ts,tsx,json --watch src --exec \"tsc -p ./tsconfig.json\"",
+    "watch": "tsc -b -w --preserveWatchOutput --pretty"
+  },
+  "main": "build/index.js",
+  "module": "build/index.js",
+  "types": "build/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./build/index.js",
+      "require": "./build/index.js",
+      "default": "./build/index.js",
+      "module": "./build/index.js",
+      "types": "./build/index.d.ts"
+    },
+    "./utils": {
+      "import": "./build/utils/index.js",
+      "require": "./build/utils/index.js",
+      "default": "./build/utils/index.js",
+      "module": "./build/utils/index.js",
+      "types": "./build/utils/index.d.ts"
+    }
+  },
+  "dependencies": {
+    "@owlmeans/api": "^0.1.3",
+    "@owlmeans/client-config": "^0.1.3",
+    "@owlmeans/client-context": "^0.1.3",
+    "@owlmeans/client-route": "^0.1.3",
+    "@owlmeans/config": "^0.1.3",
+    "@owlmeans/context": "^0.1.3",
+    "@owlmeans/entrypoint": "^0.1.3",
+    "@owlmeans/error": "^0.1.3",
+    "@owlmeans/route": "^0.1.3",
+    "ajv-formats": "^3.0.1",
+    "qs": "^6.13.0"
+  },
+  "peerDependencies": {
+    "ajv": "*"
+  },
+  "devDependencies": {
+    "@owlmeans/dep-config": "workspace:*",
+    "@types/qs": "^6.9.16",
+    "nodemon": "^3.1.11",
+    "npm-check": "^6.0.1",
+    "typescript": "^6.0.2"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/src/entrypoint.ts

@@ -0,0 +1,88 @@
+import type { ClientRouteModel } from '@owlmeans/client-route'
+import type { ClientEntrypoint, ClientEntrypointOptions, EntrypointRef, RefedEntrypointHandler } from './types.js'
+import type { AbstractRequest, CommonEntrypoint } from '@owlmeans/entrypoint'
+import { isEntrypoint, makeBasicEntrypoint, normalizeHelperParams, validate } from './utils/entrypoint.js'
+import { isClientRouteModel, route } from '@owlmeans/client-route'
+import { apiCall, apiHandler, urlCall } from './utils/handler.js'
+import { AppType } from '@owlmeans/context'
+import type { BasicContext } from '@owlmeans/context'
+import { normalizePath } from '@owlmeans/route'
+import type { CommonRouteModel } from '@owlmeans/route'
+import { provideRequest } from './helper.js'
+
+export const entrypoint = <T, R extends AbstractRequest = AbstractRequest>(
+  arg: CommonEntrypoint | ClientRouteModel | CommonRouteModel,
+  handler?: RefedEntrypointHandler<T, R> | ClientEntrypointOptions | boolean,
+  opts?: ClientEntrypointOptions | boolean
+): ClientEntrypoint<T, R> => {
+  const entrypointHandle: EntrypointRef<T, R> = { ref: undefined }
+
+  let _entrypoint: ClientEntrypoint<T, R>
+
+  ;[handler, opts] = normalizeHelperParams(handler, opts)
+
+  const _handler = handler as RefedEntrypointHandler<T, R> | undefined ??
+    (('route' in arg.route ? arg.route.route.type : arg.route.type)
+      === AppType.Backend ? apiHandler : undefined)
+
+  if (isEntrypoint(arg)) {
+    assertExplicitHandler(arg.route.route.type, handler as RefedEntrypointHandler<T, R>)
+    const routeModel = route(arg.route, opts?.routeOptions)
+    _entrypoint = arg as ClientEntrypoint<T, R>
+    _entrypoint.route = routeModel
+    _entrypoint.guards = opts?.guards ?? arg.guards
+    _entrypoint.filter = opts?.filter ?? arg.filter
+    _entrypoint.gate = opts?.gate ?? arg.gate
+    _entrypoint.gateParams = opts?.gateParams ?? arg.gateParams
+  } else if (isClientRouteModel(arg)) {
+    assertExplicitHandler(arg.route.type, handler as RefedEntrypointHandler<T, R>)
+    _entrypoint = makeBasicEntrypoint(arg, { ...opts }) as ClientEntrypoint<T, R>
+    _entrypoint.route = arg
+  } else {
+    assertExplicitHandler(arg.route.type, handler as RefedEntrypointHandler<T, R>)
+    const _route = route(arg, opts?.routeOptions)
+    _entrypoint = makeBasicEntrypoint(_route, { ...opts }) as ClientEntrypoint<T, R>
+    _entrypoint.route = _route
+  }
+
+  _entrypoint.getPath = (partial?: boolean) =>
+    partial === true ? normalizePath(_entrypoint.route.route.partialPath) : _entrypoint.route.route.path
+
+  _entrypoint.call = handler != null ? urlCall<T, R>(entrypointHandle, opts) : apiCall<T, R>(entrypointHandle, opts)
+
+  _entrypoint.request = ((request: R): R => {
+    if (entrypointHandle.ref == null) {
+      throw SyntaxError(`Try to request uninitialized entrypoint ${JSON.stringify(arg)}`)
+    }
+    const _request = provideRequest(entrypointHandle.ref.getAlias(), entrypointHandle.ref.getPath()) as R
+
+    request != null && Object.entries(request).forEach(([key, value]) => {
+      _request[key as keyof R] = value
+    })
+
+    return _request
+  }) as any
+
+  _entrypoint.handle = _handler?.(entrypointHandle)
+
+  _entrypoint.validate = validate(entrypointHandle)
+
+  _entrypoint.reinitializeContext = <T>(context: BasicContext<any>) => {
+    const newEntrypoint = entrypoint(_entrypoint.route, handler, opts)
+    newEntrypoint.ctx = context
+
+    return newEntrypoint as T
+  }
+
+  entrypointHandle.ref = _entrypoint
+
+  return _entrypoint
+}
+
+const assertExplicitHandler = <T, R extends AbstractRequest = AbstractRequest>(
+  type: AppType, handler: RefedEntrypointHandler<T, R> | undefined
+) => {
+  if (type === AppType.Backend && handler != null) {
+    throw new SyntaxError('We can\'t provide explicit handler to backend client entrypoint')
+  }
+}

package/src/errors.ts

@@ -0,0 +1,23 @@
+
+import { ResilientError } from '@owlmeans/error'
+
+export class ClientEntrypointError extends ResilientError {
+  public static override typeName = 'ClientModuleError'
+
+  constructor(message: string) {
+    super(ClientEntrypointError.typeName, `clinet-module:${message}`)
+  }
+}
+
+export class ClientValidationError extends ClientEntrypointError {
+  public static override typeName = `${ClientEntrypointError.typeName}Validation`
+
+  constructor(message: string) {
+    super(`validation:${message}`)
+    this.type = ClientValidationError.typeName
+  }
+}
+
+
+ResilientError.registerErrorClass(ClientEntrypointError)
+ResilientError.registerErrorClass(ClientValidationError)

package/src/helper.ts

@@ -0,0 +1,55 @@
+import type { ClientEntrypoint, ClientEntrypointOptions, RefedEntrypointHandler } from './types.js'
+import { entrypoint } from './entrypoint.js'
+import { isClientRouteModel } from '@owlmeans/client-route'
+import type { AbstractRequest, CommonEntrypoint } from '@owlmeans/entrypoint'
+import { normalizeHelperParams } from './utils/entrypoint.js'
+import type { JSONSchemaType } from "ajv"
+
+export const elevate = <T = {}, R extends AbstractRequest = AbstractRequest>(
+  entrypoints: (CommonEntrypoint | ClientEntrypoint<T, R>)[],
+  alias: string,
+  handler?: RefedEntrypointHandler<T, R> | ClientEntrypointOptions | boolean,
+  opts?: ClientEntrypointOptions | boolean
+): ClientEntrypoint<T, R>[] => {
+  [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 as ClientEntrypoint<T, R>[]
+}
+
+export const stab: RefedEntrypointHandler<{}> = () => () => {
+  return void 0 as any
+}
+
+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
+}
+
+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>
+  )

package/src/index.ts

@@ -0,0 +1,5 @@
+
+export * from './helper.js'
+export type * from './types.js'
+export * from './entrypoint.js'
+export * from './errors.js'

package/src/types.ts

@@ -0,0 +1,41 @@
+import type { ClientRouteModel, ClientRouteOptions } from '@owlmeans/client-route'
+import type { AbstractRequest, AbstractResponse, CommonEntrypoint, CommonEntrypointOptions, EntrypointHandler, EntrypointOutcome } from '@owlmeans/entrypoint'
+
+export interface ClientEntrypoint<T = {}, R extends ClientRequest = ClientRequest> extends CommonEntrypoint {
+  route: ClientRouteModel
+  call: EntrypointCall<T, R>
+  validate: EntrypointFilter<R>
+  getPath: (partial?: boolean) => string
+  request: (request?: Partial<R>) => R
+}
+
+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]>
+}
+
+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> {
+  (ref: EntrypointRef<T, R>): EntrypointHandler
+}

package/src/utils/entrypoint.ts

@@ -0,0 +1,66 @@
+import Ajv from 'ajv'
+import type { ErrorObject } from 'ajv'
+import type { EntrypointFilter, ClientEntrypointOptions } from '../types.js'
+import { ClientValidationError } from '../errors.js'
+import type { AbstractRequest } from '@owlmeans/entrypoint'
+import type { EntrypointRef, RefedEntrypointHandler } from '../types.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 as any)
+
+/**
+ * @throws {SyntaxError} if data shape doesn't match validation
+ * @throws {ClientValidationError} if request is not valid
+ */
+export const validate: <T, R extends AbstractRequest = AbstractRequest>(ref: EntrypointRef<T, R>) => EntrypointFilter =
+  (ref) => async (req) => {
+    const ep = ref.ref
+    if (ep == null) {
+      throw new SyntaxError('Try to make API call before without entrypoint')
+    }
+    if (req?.alias == null) {
+      throw new SyntaxError(`Can't validate for unknown entrypoint (request.alias required)`)
+    }
+    if (ep.filter == null) {
+      throw new SyntaxError(`Entrypoint ${req.alias} has no filter to validate against`)
+    }
+    const results = await Promise.all(Object.entries(ep.filter).filter(([key]) => !['headers', 'response'].includes(key))
+      .map(async ([key, filter]) => {
+        if (req[key as keyof typeof req] == null) {
+          throw new SyntaxError(`Request has no required section ${key}`)
+        }
+
+        const validateFn = ajv.compile(filter)
+        validateFn(req[key as keyof typeof req])
+        if (validateFn.errors == null) {
+          return true
+        } else {
+          return validateFn.errors
+        }
+      }))
+    if (results.some((result) => result !== true)) {
+      const errors = results.find(result => result !== true && result != null)! as ErrorObject[]
+
+      throw new ClientValidationError(`${errors[0].instancePath}|${errors[0].message}`)
+    }
+
+    return true
+  }
+
+export const normalizeHelperParams = <T, R extends AbstractRequest = AbstractRequest>(
+  handler?: RefedEntrypointHandler<T, R> | ClientEntrypointOptions | boolean,
+  opts?: ClientEntrypointOptions | boolean
+): [RefedEntrypointHandler<T, R> | undefined, ClientEntrypointOptions | undefined] => {
+  if (typeof handler !== 'function' && handler != null) {
+    opts = handler as ClientEntrypointOptions | boolean
+    handler = undefined
+  }
+
+  opts = typeof opts === 'boolean' ? { validateOnCall: opts } : opts
+
+  return [handler, opts]
+}

package/src/utils/handler.ts

@@ -0,0 +1,136 @@
+import type { ApiClient } from '@owlmeans/api'
+import { DEFAULT_KEY } from '@owlmeans/client-config'
+import type { ClientConfig, ClientContext } from '@owlmeans/client-context'
+import type { AbstractRequest, EntrypointHandler } from '@owlmeans/entrypoint'
+import { EntrypointOutcome, provideResponse } from '@owlmeans/entrypoint'
+import type { ClientEntrypoint, EntrypointCall, ClientEntrypointOptions, EntrypointRef, ClientRequest } from '../types.js'
+import { validate } from './entrypoint.js'
+import { extractParams } from '@owlmeans/client-route'
+import { PARAM } from '@owlmeans/route'
+import { stringify } from 'qs'
+import { assertContext } from '@owlmeans/context'
+import { makeSecurityHelper } from '@owlmeans/config'
+
+type Config = ClientConfig
+interface Context<C extends Config = Config> extends ClientContext<C> { }
+
+export const apiHandler: <
+  T, R extends AbstractRequest = AbstractRequest
+>(ref: EntrypointRef<T, R>) => EntrypointHandler = (ref) => async (req, res) => {
+  const location = `client-entrypoint:api-handler:${ref.ref?.alias}`
+  const context = assertContext<Config, Context>(ref.ref?.ctx as Context, location)
+
+  if (context.cfg.webService == null) {
+    throw new SyntaxError('No webService provided')
+  }
+
+  const ep = context.entrypoint<ClientEntrypoint>(req.alias)
+  const route = await ep.route.resolve<Config, Context>(context)
+
+  let alias: string | undefined = 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: ApiClient = context.service(alias)
+
+  req.path = ep.getPath()
+
+  return service.handler(req, res as any)
+}
+
+export const apiCall: <
+  T, R extends AbstractRequest = AbstractRequest
+>(ref: EntrypointRef<T, R>, opts?: ClientEntrypointOptions) => EntrypointCall<T, R> =
+  (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: AbstractRequest = {
+      alias: ep.alias,
+      params: req?.params ?? {},
+      body: req?.body,
+      headers: req?.headers ?? {},
+      query: req?.query ?? {},
+      host: req?.host,
+      base: req?.base,
+      path: ep.getPath(),
+    }
+    if (req?.cancel != null) {
+      const cancel = req.cancel
+      req.cancel = () => {
+        cancel()
+        request.canceled = true
+      }
+    }
+    if (opts?.validateOnCall) {
+      try {
+        await validate(ref)(request)
+      } catch (e) {
+        console.error(e)
+        throw e
+      }
+    }
+    if (res != null) {
+      await apiHandler(ref)(request, res)
+      return
+    }
+    const reply = provideResponse<unknown>()
+    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]
+  }) as EntrypointCall<any>
+
+export const urlCall: <
+  T, R extends ClientRequest = ClientRequest
+>(ref: EntrypointRef<T, R>, opts?: ClientEntrypointOptions) => EntrypointCall<T, R> = 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 as keyof typeof req.params]}`)
+  }, 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 as any, EntrypointOutcome.Ok)
+
+  return [path as any, EntrypointOutcome.Ok]
+}

package/src/utils/index.ts

@@ -0,0 +1,3 @@
+
+export * from './entrypoint.js'
+export * from './handler.js'

package/tsconfig.json

@@ -0,0 +1,10 @@
+{
+  "extends": [
+    "@owlmeans/dep-config/tsconfig.base.json"
+  ],
+  "compilerOptions": {
+    "rootDir": "./src/",
+    "outDir": "./build/"
+  },
+  "exclude": ["./dist/**/*", "./build/**/*", "./*.ts"]
+}