@owlmeans/entrypoint 0.1.3

package/README.md

@@ -0,0 +1,95 @@
+# @owlmeans/entrypoint
+
+Entrypoint system — the URL unit abstraction shared between server and client in OwlMeans apps.
+
+## Overview
+
+- An **entrypoint** is a URL unit: an alias + path + optional guards/gates/filters
+- On the server, entrypoints become API routes with attached handlers
+- On the client, entrypoints provide URL generation and navigation
+- All AJV validation schemas are defined at entrypoint level, keeping data contracts consistent fullstack
+- Most commonly used via re-exports in `@owlmeans/server-app` or `@owlmeans/client-entrypoint`
+
+## Installation
+
+```bash
+bun add @owlmeans/entrypoint
+```
+
+## Usage
+
+Define an entrypoint with body validation and a guard:
+
+```typescript
+import { entrypoint, guard, filter, body, params } from '@owlmeans/server-app'
+import { route } from '@owlmeans/route'
+
+const createStoryModule = entrypoint(
+  route('story-create', '/stories', { method: 'POST', parent: 'api' }),
+  filter(body({
+    type: 'object',
+    properties: { story: { type: 'string' }, projectId: { type: 'string' } },
+    required: ['story', 'projectId']
+  }), guard('authenticated'))
+)
+```
+
+Use `AbstractRequest` type in a handler:
+
+```typescript
+import type { AbstractRequest } from '@owlmeans/entrypoint'
+
+export const create = handleBody(async (body, context, request) => {
+  const req = request as AbstractRequest<{ id: string }>
+  const projectId = req.params.id
+})
+```
+
+## API
+
+### `entrypoint(route, opts?): CommonEntrypoint`
+
+Creates an entrypoint. `opts` is typically produced by `filter()`, `guard()`, or `gate()`.
+
+### `guard(guard, opts?): CommonEntrypointOptions`
+
+Adds an authentication guard requirement.
+
+### `gate(gate, params, opts?): CommonEntrypointOptions`
+
+Adds an authorization gate with parameters.
+
+### `filter(filter, opts?): CommonEntrypointOptions`
+
+Attaches validation schemas (AJV format) to the entrypoint.
+
+### `body(schema, filter?) / query(schema, filter?) / params(schema, filter?)`
+
+Build a `Filter` object with the given AJV schema applied to the corresponding request part.
+
+### `parent(entrypoint, parentAlias): CommonEntrypoint`
+
+Sets a parent-child relationship so child entrypoints inherit guards/gates.
+
+### `provideResponse<T>(): AbstractResponse<T>`
+
+Creates a response object for use in non-elevated handlers.
+
+### `EntrypointOutcome`
+
+```typescript
+enum EntrypointOutcome { Ok, Accepted, Created, Finished }
+```
+
+### Types
+
+- `AbstractRequest<T>` — request with `params`, `body`, `query`, `headers`, `auth`
+- `AbstractResponse<T>` — response with `resolve(value, outcome?)` and `reject(error)`
+- `CommonEntrypoint` — entrypoint with `getAlias()`, `getPath()`, `getGuards()`, `handle`
+
+## Related Packages
+
+- [`@owlmeans/route`](../route) — `route()` factory used in `entrypoint(route(...), ...)`
+- [`@owlmeans/server-entrypoint`](../server-entrypoint) — server-side `elevate()` to attach handlers
+- [`@owlmeans/client-entrypoint`](../client-entrypoint) — client-side entrypoint with API call support
+- [`@owlmeans/server-app`](../server-app) — re-exports everything from this package

package/build/consts.d.ts

@@ -0,0 +1,7 @@
+export declare enum EntrypointOutcome {
+    Ok = "ok",
+    Accepted = "accepted",
+    Created = "created",
+    Finished = "finished"
+}
+//# sourceMappingURL=consts.d.ts.map

package/build/consts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"consts.d.ts","sourceRoot":"","sources":["../src/consts.ts"],"names":[],"mappings":"AACA,oBAAY,iBAAiB;IAC3B,EAAE,OAAO;IACT,QAAQ,aAAa;IACrB,OAAO,YAAY;IACnB,QAAQ,aAAa;CACtB"}

package/build/consts.js

@@ -0,0 +1,8 @@
+export var EntrypointOutcome;
+(function (EntrypointOutcome) {
+    EntrypointOutcome["Ok"] = "ok";
+    EntrypointOutcome["Accepted"] = "accepted";
+    EntrypointOutcome["Created"] = "created";
+    EntrypointOutcome["Finished"] = "finished";
+})(EntrypointOutcome || (EntrypointOutcome = {}));
+//# sourceMappingURL=consts.js.map

package/build/consts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"consts.js","sourceRoot":"","sources":["../src/consts.ts"],"names":[],"mappings":"AACA,MAAM,CAAN,IAAY,iBAKX;AALD,WAAY,iBAAiB;IAC3B,8BAAS,CAAA;IACT,0CAAqB,CAAA;IACrB,wCAAmB,CAAA;IACnB,0CAAqB,CAAA;AACvB,CAAC,EALW,iBAAiB,KAAjB,iBAAiB,QAK5B"}

package/build/entrypoint.d.ts

@@ -0,0 +1,5 @@
+import type { CommonEntrypoint } from './types.js';
+import type { CreateEntrypointSignature } from './utils/types.js';
+export declare const entrypoint: CreateEntrypointSignature<CommonEntrypoint>;
+export declare const parent: <T extends CommonEntrypoint | CommonEntrypoint[]>(ep: T, aliasOrParent: string, _parent?: string) => T;
+//# 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,YAAY,CAAA;AAElD,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,kBAAkB,CAAA;AAEjE,eAAO,MAAM,UAAU,EAAE,yBAAyB,CAAC,gBAAgB,CAqFlE,CAAA;AAED,eAAO,MAAM,MAAM,GAAI,CAAC,SAAS,gBAAgB,GAAG,gBAAgB,EAAE,EAAE,IAAI,CAAC,EAAE,eAAe,MAAM,EAAE,UAAU,MAAM,KAAG,CAcxH,CAAA"}

package/build/entrypoint.js

@@ -0,0 +1,80 @@
+import { appendContextual } from '@owlmeans/context';
+export const entrypoint = (route, opts) => {
+    let guards = null;
+    let gates = null;
+    const ep = appendContextual(route.route.alias, {
+        _entrypoint: true,
+        _module: true,
+        sticky: false,
+        route,
+        getAlias: () => ep.route.route.alias,
+        getPath: () => ep.route.route.path,
+        getParentAlias: () => ep.route.route.parent ?? null,
+        hasParent: () => ep.getParentAlias() != null,
+        resolve: async () => {
+            if (ep.ctx == null) {
+                throw new SyntaxError(`Entrypoint has no context yet - ${ep.getAlias()}`);
+            }
+            await ep.route.resolve(ep.ctx);
+            return ep;
+        },
+        getParent: () => {
+            const parentAlias = ep.getParentAlias();
+            if (parentAlias == null) {
+                throw new SyntaxError(`Entrypoint has no parent - ${ep.getAlias()}`);
+            }
+            if (ep.ctx == null) {
+                throw new SyntaxError(`Entrypoint has no context yet - ${ep.getAlias()}`);
+            }
+            return ep.ctx.entrypoint(parentAlias);
+        },
+        setService: service => {
+            if (ep.route.route.resolved) {
+                throw new SyntaxError(`Cannot update a resolved entrypoint - ${ep.getAlias()}`);
+            }
+            ep.route.route.service = service;
+        },
+        getGuards: () => {
+            if (guards != null) {
+                return guards;
+            }
+            guards = ep.guards ?? [];
+            if (ep.hasParent()) {
+                guards.push(...ep.getParent().getGuards().filter(guard => !guards?.includes(guard)));
+            }
+            return guards;
+        },
+        getGates: () => {
+            if (gates != null) {
+                return gates;
+            }
+            gates = ep.gate != null ? [[
+                    ep.gate, ep.gateParams == null
+                        ? [] : Array.isArray(ep.gateParams)
+                        ? ep.gateParams : [ep.gateParams]
+                ]] : [];
+            if (ep.hasParent()) {
+                gates.push(...ep.getParent().getGates()
+                    .filter(([gate]) => !gates?.some(([g]) => g === gate)));
+            }
+            return gates;
+        },
+        ...opts
+    });
+    return ep;
+};
+export const parent = (ep, aliasOrParent, _parent) => {
+    if (Array.isArray(ep)) {
+        if (_parent == null) {
+            throw SyntaxError('Elevating parent requires parent name to be specified');
+        }
+        ep = ep.find(e => e.route.route.alias === aliasOrParent);
+        if (ep == null) {
+            throw SyntaxError(`Entrypoint not found ${aliasOrParent}`);
+        }
+        return parent(ep, _parent);
+    }
+    ep.route.route.parent = aliasOrParent;
+    return ep;
+};
+//# 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/filter.d.ts

@@ -0,0 +1,8 @@
+import type { JSONSchemaType } from 'ajv';
+import type { Filter } from './types.js';
+export declare const body: <T>(schema: JSONSchemaType<T>, filter?: Filter) => Filter;
+export declare const query: <T>(schema: JSONSchemaType<T>, filter?: Filter) => Filter;
+export declare const params: <T>(schema: JSONSchemaType<T>, filter?: Filter) => Filter;
+export declare const response: <T>(schema: JSONSchemaType<T>, code?: number, filter?: Filter) => Filter;
+export declare const headers: <T>(schema: JSONSchemaType<T>, filter?: Filter) => Filter;
+//# sourceMappingURL=filter.d.ts.map

package/build/filter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filter.d.ts","sourceRoot":"","sources":["../src/filter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,KAAK,CAAA;AACzC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAA;AAExC,eAAO,MAAM,IAAI,GAAI,CAAC,EAAE,QAAQ,cAAc,CAAC,CAAC,CAAC,EAAE,SAAS,MAAM,KAAG,MAEpE,CAAA;AAED,eAAO,MAAM,KAAK,GAAI,CAAC,EAAE,QAAQ,cAAc,CAAC,CAAC,CAAC,EAAE,SAAS,MAAM,KAAG,MAErE,CAAA;AAED,eAAO,MAAM,MAAM,GAAI,CAAC,EAAE,QAAQ,cAAc,CAAC,CAAC,CAAC,EAAE,SAAS,MAAM,KAAG,MAEtE,CAAA;AAED,eAAO,MAAM,QAAQ,GAAI,CAAC,EAAE,QAAQ,cAAc,CAAC,CAAC,CAAC,EAAE,OAAO,MAAM,EAAE,SAAS,MAAM,KAAG,MAMvF,CAAA;AAED,eAAO,MAAM,OAAO,GAAI,CAAC,EAAE,QAAQ,cAAc,CAAC,CAAC,CAAC,EAAE,SAAS,MAAM,KAAG,MAEvE,CAAA"}

package/build/filter.js

@@ -0,0 +1,20 @@
+export const body = (schema, filter) => {
+    return { ...filter, body: schema };
+};
+export const query = (schema, filter) => {
+    return { ...filter, query: schema };
+};
+export const params = (schema, filter) => {
+    return { ...filter, params: schema };
+};
+export const response = (schema, code, filter) => {
+    let _schema = schema;
+    if (filter?.response != null && code != null) {
+        _schema = { ...filter.response, [code]: schema };
+    }
+    return { ...filter, response: _schema };
+};
+export const headers = (schema, filter) => {
+    return { ...filter, headers: schema };
+};
+//# sourceMappingURL=filter.js.map

package/build/filter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"filter.js","sourceRoot":"","sources":["../src/filter.ts"],"names":[],"mappings":"AAGA,MAAM,CAAC,MAAM,IAAI,GAAG,CAAI,MAAyB,EAAE,MAAe,EAAU,EAAE;IAC5E,OAAO,EAAE,GAAG,MAAM,EAAE,IAAI,EAAE,MAAa,EAAE,CAAA;AAC3C,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,KAAK,GAAG,CAAI,MAAyB,EAAE,MAAe,EAAU,EAAE;IAC7E,OAAO,EAAE,GAAG,MAAM,EAAE,KAAK,EAAE,MAAa,EAAE,CAAA;AAC5C,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,MAAM,GAAG,CAAI,MAAyB,EAAE,MAAe,EAAU,EAAE;IAC9E,OAAO,EAAE,GAAG,MAAM,EAAE,MAAM,EAAE,MAAa,EAAE,CAAA;AAC7C,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAI,MAAyB,EAAE,IAAa,EAAE,MAAe,EAAU,EAAE;IAC/F,IAAI,OAAO,GAAQ,MAAM,CAAA;IACzB,IAAI,MAAM,EAAE,QAAQ,IAAI,IAAI,IAAI,IAAI,IAAI,IAAI,EAAE,CAAC;QAC7C,OAAO,GAAG,EAAE,GAAG,MAAM,CAAC,QAAQ,EAAE,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;IAClD,CAAC;IACD,OAAO,EAAE,GAAG,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAA;AACzC,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,OAAO,GAAG,CAAI,MAAyB,EAAE,MAAe,EAAU,EAAE;IAC/E,OAAO,EAAE,GAAG,MAAM,EAAE,OAAO,EAAE,MAAa,EAAE,CAAA;AAC9C,CAAC,CAAA"}

package/build/helper.d.ts

@@ -0,0 +1,7 @@
+import { Filter, CommonEntrypointOptions, AbstractResponse, CommonEntrypoint } from './types.js';
+export declare const filter: (filter: Filter, opts?: CommonEntrypointOptions) => CommonEntrypointOptions;
+export declare const guard: (guard: string, opts?: CommonEntrypointOptions) => CommonEntrypointOptions;
+export declare const gate: (gate: string, params: string | string[], opts?: CommonEntrypointOptions) => CommonEntrypointOptions;
+export declare const provideResponse: <T>(originalResponse?: unknown) => AbstractResponse<T>;
+export declare const clone: <M extends CommonEntrypoint>(entrypoints: M[], from: string, to: string, service: string) => void;
+//# 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":"AACA,OAAO,EAAE,MAAM,EAAE,uBAAuB,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAA;AAGhG,eAAO,MAAM,MAAM,GAAI,QAAQ,MAAM,EAAE,OAAO,uBAAuB,KAAG,uBAAgD,CAAA;AAExH,eAAO,MAAM,KAAK,GAAI,OAAO,MAAM,EAAE,OAAO,uBAAuB,KAAG,uBACC,CAAA;AAEvE,eAAO,MAAM,IAAI,GAAI,MAAM,MAAM,EAAE,QAAQ,MAAM,GAAG,MAAM,EAAE,EAAE,OAAO,uBAAuB,KAAG,uBACtD,CAAA;AAEzC,eAAO,MAAM,eAAe,GAAI,CAAC,EAAE,mBAAmB,OAAO,KAAG,gBAAgB,CAAC,CAAC,CAejF,CAAA;AAED,eAAO,MAAM,KAAK,GAAI,CAAC,SAAS,gBAAgB,EAAE,aAAa,CAAC,EAAE,EAAE,MAAM,MAAM,EAAE,IAAI,MAAM,EAAE,SAAS,MAAM,SAO5G,CAAA"}

package/build/helper.js

@@ -0,0 +1,26 @@
+import { route } from '@owlmeans/route';
+import { entrypoint } from './entrypoint.js';
+export const filter = (filter, opts) => ({ filter, ...opts });
+export const guard = (guard, opts) => ({ ...opts, guards: [...new Set([guard, ...(opts?.guards ?? [])])] });
+export const gate = (gate, params, opts) => ({ ...opts, gate, gateParams: params });
+export const provideResponse = (originalResponse) => {
+    const handler = {
+        responseProvider: originalResponse,
+        resolve: (value, outcome) => {
+            handler.value = value;
+            handler.outcome = outcome;
+        },
+        reject: (error) => {
+            handler.error = error;
+        }
+    };
+    return handler;
+};
+export const clone = (entrypoints, from, to, service) => {
+    const source = entrypoints.find(e => e.alias === from);
+    if (source?.route.route != null) {
+        const _route = { ...source.route.route, service, resolved: false, alias: to };
+        entrypoints.push(entrypoint(route(to, _route.path, _route)));
+    }
+};
+//# sourceMappingURL=helper.js.map

package/build/helper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"helper.js","sourceRoot":"","sources":["../src/helper.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAA;AAEvC,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAE5C,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,MAAc,EAAE,IAA8B,EAA2B,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,CAAC,CAAA;AAExH,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC,KAAa,EAAE,IAA8B,EAA2B,EAAE,CAC9F,CAAC,EAAE,GAAG,IAAI,EAAE,MAAM,EAAE,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,KAAK,EAAE,GAAG,CAAC,IAAI,EAAE,MAAM,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAA;AAEvE,MAAM,CAAC,MAAM,IAAI,GAAG,CAAC,IAAY,EAAE,MAAyB,EAAE,IAA8B,EAA2B,EAAE,CACvH,CAAC,EAAE,GAAG,IAAI,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,CAAC,CAAA;AAEzC,MAAM,CAAC,MAAM,eAAe,GAAG,CAAI,gBAA0B,EAAuB,EAAE;IACpF,MAAM,OAAO,GAAwB;QACnC,gBAAgB,EAAE,gBAAgB;QAElC,OAAO,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE;YAC1B,OAAO,CAAC,KAAK,GAAG,KAAK,CAAA;YACrB,OAAO,CAAC,OAAO,GAAG,OAAO,CAAA;QAC3B,CAAC;QAED,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE;YAChB,OAAO,CAAC,KAAK,GAAG,KAAK,CAAA;QACvB,CAAC;KACF,CAAA;IAED,OAAO,OAAO,CAAA;AAChB,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,KAAK,GAAG,CAA6B,WAAgB,EAAE,IAAY,EAAE,EAAU,EAAE,OAAe,EAAE,EAAE;IAC/G,MAAM,MAAM,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,IAAI,CAAC,CAAA;IAEtD,IAAI,MAAM,EAAE,KAAK,CAAC,KAAK,IAAI,IAAI,EAAE,CAAC;QAChC,MAAM,MAAM,GAAG,EAAE,GAAG,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,EAAE,CAAA;QAC7E,WAAW,CAAC,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,CAAM,CAAC,CAAA;IACnE,CAAC;AACH,CAAC,CAAA"}

package/build/index.d.ts

@@ -0,0 +1,6 @@
+export type * from './types.js';
+export * from './entrypoint.js';
+export * from './filter.js';
+export * from './helper.js';
+export * from './consts.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,mBAAmB,YAAY,CAAA;AAC/B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,aAAa,CAAA;AAC3B,cAAc,aAAa,CAAA;AAC3B,cAAc,aAAa,CAAA"}

package/build/index.js

@@ -0,0 +1,5 @@
+export * from './entrypoint.js';
+export * from './filter.js';
+export * from './helper.js';
+export * from './consts.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":"AAEA,cAAc,iBAAiB,CAAA;AAC/B,cAAc,aAAa,CAAA;AAC3B,cAAc,aAAa,CAAA;AAC3B,cAAc,aAAa,CAAA"}

package/build/types.d.ts

@@ -0,0 +1,81 @@
+import type { CommonRouteModel } from '@owlmeans/route';
+import type { InitializedService, LazyService, BasicEntrypoint } from '@owlmeans/context';
+import type { AnySchemaObject } from 'ajv';
+import type { EntrypointOutcome } from './consts.js';
+import type { Auth } from '@owlmeans/auth';
+export interface CommonEntrypoint extends BasicEntrypoint {
+    route: CommonRouteModel;
+    /**
+     * @property {boolean} - if true — router attaches this entrypoint unconditionally
+     * @default false
+     */
+    sticky: boolean;
+    filter?: Filter;
+    guards?: string[];
+    gate?: string;
+    gateParams?: string | string[];
+    handle?: EntrypointHandler;
+    getAlias: () => string;
+    getPath: () => string;
+    getParentAlias: () => string | null;
+    hasParent: () => boolean;
+    resolve: <M extends CommonEntrypoint>() => Promise<M>;
+    getParent: <M extends CommonEntrypoint>() => M;
+    setService: (service: string) => void;
+    getGuards: () => string[];
+    getGates: () => [string, string[]][];
+}
+export interface CommonEntrypointOptions extends Partial<CommonEntrypoint> {
+}
+export interface EntrypointMatch {
+    <R extends AbstractRequest, P extends AbstractResponse<any>>(req: R, res: P): Promise<boolean>;
+}
+export interface EntrypointHandler {
+    <T, R extends AbstractRequest<any> = AbstractRequest<any>, P extends AbstractResponse<any> = AbstractResponse<any>>(req: R, res: P): T | Promise<T>;
+}
+export interface EntrypointAssert {
+    <R extends AbstractRequest, P extends AbstractResponse<any>>(req: R, res: P, params: string[]): Promise<void>;
+}
+export interface AbstractRequest<T extends {} = {}> {
+    alias: string;
+    auth?: Auth;
+    params: Record<string, string | number | undefined | null> | Partial<T>;
+    body?: Record<string, any> | Partial<T>;
+    headers: Record<string, string[] | string | undefined>;
+    query: Record<string, string | number | undefined | null> | Partial<T>;
+    path: string;
+    original?: any;
+    canceled?: boolean;
+    cancel?: () => void;
+    host?: string;
+    base?: string | boolean;
+    unsecure?: boolean;
+}
+export interface AbstractResponse<T> {
+    responseProvider?: any;
+    value?: T;
+    outcome?: EntrypointOutcome;
+    error?: Error;
+    resolve: (value: T, outcome?: EntrypointOutcome) => void;
+    reject: (error: Error) => void;
+}
+export interface GuardService extends InitializedService {
+    token?: string;
+    authenticated: (req?: Partial<AbstractRequest>) => Promise<string | null>;
+    match: EntrypointMatch;
+    handle: EntrypointHandler;
+}
+export interface GateService extends LazyService {
+    /**
+     * @throws {Error}
+     */
+    assert: EntrypointAssert;
+}
+export interface Filter {
+    query?: AnySchemaObject;
+    params?: AnySchemaObject;
+    body?: AnySchemaObject;
+    response?: AnySchemaObject;
+    headers?: AnySchemaObject;
+}
+//# 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":"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"}

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,3 @@
+import { CommonEntrypoint } from '../types.js';
+export declare const isEntrypoint: (obj: object) => obj is CommonEntrypoint;
+//# 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":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAE9C,eAAO,MAAM,YAAY,GAAI,KAAK,MAAM,KAAG,GAAG,IAAI,gBACR,CAAA"}

package/build/utils/entrypoint.js

@@ -0,0 +1,2 @@
+export const isEntrypoint = (obj) => '_entrypoint' in obj || '_module' in obj;
+//# 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":"AAEA,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,GAAW,EAA2B,EAAE,CACnE,aAAa,IAAI,GAAG,IAAI,SAAS,IAAI,GAAG,CAAA"}

package/build/utils/index.d.ts

@@ -0,0 +1,3 @@
+export * from './types.js';
+export * from './entrypoint.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,YAAY,CAAA;AAC1B,cAAc,iBAAiB,CAAA"}

package/build/utils/index.js

@@ -0,0 +1,3 @@
+export * from './types.js';
+export * from './entrypoint.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,YAAY,CAAA;AAC1B,cAAc,iBAAiB,CAAA"}

package/build/utils/types.d.ts

@@ -0,0 +1,6 @@
+import { CommonRouteModel } from '@owlmeans/route';
+import { CommonEntrypointOptions } from '../types.js';
+export interface CreateEntrypointSignature<M> {
+    (route: CommonRouteModel, opts?: CommonEntrypointOptions): M;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/utils/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAA;AAClD,OAAO,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAA;AAErD,MAAM,WAAW,yBAAyB,CAAC,CAAC;IAC1C,CAAC,KAAK,EAAE,gBAAgB,EAAE,IAAI,CAAC,EAAE,uBAAuB,GAAG,CAAC,CAAC;CAC9D"}

package/build/utils/types.js

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

package/build/utils/types.js.map

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

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "@owlmeans/entrypoint",
+  "version": "0.1.3",
+  "license": "MIT",
+  "type": "module",
+  "scripts": {
+    "build": "tsc -b",
+    "dev": "sleep 186 && 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": {
+      "default": "./build/utils/index.js",
+      "types": "./build/utils/index.js",
+      "import": "./build/utils/index.js",
+      "require": "./build/utils/index.js",
+      "module": "./build/utils/index.js"
+    }
+  },
+  "dependencies": {
+    "@owlmeans/auth": "^0.1.3",
+    "@owlmeans/context": "^0.1.3",
+    "@owlmeans/route": "^0.1.3",
+    "ajv": "^8.17.1"
+  },
+  "devDependencies": {
+    "@owlmeans/dep-config": "workspace:*",
+    "nodemon": "^3.1.11",
+    "npm-check": "^6.0.1",
+    "typescript": "^6.0.2"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/src/consts.ts

@@ -0,0 +1,7 @@
+
+export enum EntrypointOutcome {
+  Ok = 'ok',
+  Accepted = 'accepted',
+  Created = 'created',
+  Finished = 'finished'
+}

package/src/entrypoint.ts

@@ -0,0 +1,106 @@
+import type { CommonEntrypoint } from './types.js'
+import { appendContextual } from '@owlmeans/context'
+import type { CreateEntrypointSignature } from './utils/types.js'
+
+export const entrypoint: CreateEntrypointSignature<CommonEntrypoint> = (route, opts) => {
+  let guards: string[] | null = null
+  let gates: [string, string[]][] | null = null
+  const ep: CommonEntrypoint = appendContextual<CommonEntrypoint>(route.route.alias, {
+    _entrypoint: true,
+    _module: true,
+
+    sticky: false,
+
+    route,
+
+    getAlias: () => ep.route.route.alias,
+    getPath: () => ep.route.route.path,
+    getParentAlias: () => ep.route.route.parent ?? null,
+    hasParent: () => ep.getParentAlias() != null,
+
+    resolve: async <M extends CommonEntrypoint>() => {
+      if (ep.ctx == null) {
+        throw new SyntaxError(`Entrypoint has no context yet - ${ep.getAlias()}`)
+      }
+
+      await ep.route.resolve(ep.ctx)
+
+      return ep as M
+    },
+
+    getParent: () => {
+      const parentAlias = ep.getParentAlias()
+      if (parentAlias == null) {
+        throw new SyntaxError(`Entrypoint has no parent - ${ep.getAlias()}`)
+      }
+      if (ep.ctx == null) {
+        throw new SyntaxError(`Entrypoint has no context yet - ${ep.getAlias()}`)
+      }
+
+      return ep.ctx.entrypoint(parentAlias)
+    },
+
+    setService: service => {
+      if (ep.route.route.resolved) {
+        throw new SyntaxError(`Cannot update a resolved entrypoint - ${ep.getAlias()}`)
+      }
+      ep.route.route.service = service
+    },
+
+    getGuards: () => {
+      if (guards != null) {
+        return guards
+      }
+      guards = ep.guards ?? []
+
+      if (ep.hasParent()) {
+        guards.push(
+          ...ep.getParent().getGuards().filter(guard => !guards?.includes(guard))
+        )
+      }
+
+      return guards
+    },
+
+    getGates: () => {
+      if (gates != null) {
+        return gates
+      }
+
+      gates = ep.gate != null ? [[
+        ep.gate, ep.gateParams == null
+          ? [] : Array.isArray(ep.gateParams)
+            ? ep.gateParams : [ep.gateParams]
+      ]] : []
+
+      if (ep.hasParent()) {
+        gates.push(
+          ...ep.getParent().getGates()
+            .filter(([gate]) => !gates?.some(([g]) => g === gate))
+        )
+      }
+
+      return gates
+    },
+
+    ...opts
+  })
+
+  return ep
+}
+
+export const parent = <T extends CommonEntrypoint | CommonEntrypoint[]>(ep: T, aliasOrParent: string, _parent?: string): T => {
+  if (Array.isArray(ep)) {
+    if (_parent == null) {
+      throw SyntaxError('Elevating parent requires parent name to be specified')
+    }
+    ep = ep.find(e => e.route.route.alias === aliasOrParent) as T
+    if (ep == null) {
+      throw SyntaxError(`Entrypoint not found ${aliasOrParent}`)
+    }
+    return parent(ep, _parent)
+  }
+  ep.route.route.parent = aliasOrParent
+
+  return ep
+}

package/src/filter.ts

@@ -0,0 +1,26 @@
+import type { JSONSchemaType } from 'ajv'
+import type { Filter } from './types.js'
+
+export const body = <T>(schema: JSONSchemaType<T>, filter?: Filter): Filter => {
+  return { ...filter, body: schema as any }
+}
+
+export const query = <T>(schema: JSONSchemaType<T>, filter?: Filter): Filter => {
+  return { ...filter, query: schema as any }
+}
+
+export const params = <T>(schema: JSONSchemaType<T>, filter?: Filter): Filter => {
+  return { ...filter, params: schema as any }
+}
+
+export const response = <T>(schema: JSONSchemaType<T>, code?: number, filter?: Filter): Filter => {
+  let _schema: any = schema
+  if (filter?.response != null && code != null) {
+    _schema = { ...filter.response, [code]: schema }
+  }
+  return { ...filter, response: _schema }
+}
+
+export const headers = <T>(schema: JSONSchemaType<T>, filter?: Filter): Filter => {
+  return { ...filter, headers: schema as any }
+}

package/src/helper.ts

@@ -0,0 +1,37 @@
+import { route } from '@owlmeans/route'
+import { Filter, CommonEntrypointOptions, AbstractResponse, CommonEntrypoint } from './types.js'
+import { entrypoint } from './entrypoint.js'
+
+export const filter = (filter: Filter, opts?: CommonEntrypointOptions): CommonEntrypointOptions => ({ filter, ...opts })
+
+export const guard = (guard: string, opts?: CommonEntrypointOptions): CommonEntrypointOptions =>
+  ({ ...opts, guards: [...new Set([guard, ...(opts?.guards ?? [])])] })
+
+export const gate = (gate: string, params: string | string[], opts?: CommonEntrypointOptions): CommonEntrypointOptions =>
+  ({ ...opts, gate, gateParams: params })
+
+export const provideResponse = <T>(originalResponse?: unknown): AbstractResponse<T> => {
+  const handler: AbstractResponse<T> = {
+    responseProvider: originalResponse,
+
+    resolve: (value, outcome) => {
+      handler.value = value
+      handler.outcome = outcome
+    },
+
+    reject: (error) => {
+      handler.error = error
+    }
+  }
+
+  return handler
+}
+
+export const clone = <M extends CommonEntrypoint>(entrypoints: M[], from: string, to: string, service: string) => {
+  const source = entrypoints.find(e => e.alias === from)
+
+  if (source?.route.route != null) {
+    const _route = { ...source.route.route, service, resolved: false, alias: to }
+    entrypoints.push(entrypoint(route(to, _route.path, _route)) as M)
+  }
+}

package/src/index.ts

@@ -0,0 +1,6 @@
+
+export type * from './types.js'
+export * from './entrypoint.js'
+export * from './filter.js'
+export * from './helper.js'
+export * from './consts.js'

package/src/types.ts

@@ -0,0 +1,94 @@
+import type { CommonRouteModel } from '@owlmeans/route'
+import type { InitializedService, LazyService, BasicEntrypoint } from '@owlmeans/context'
+import type { AnySchemaObject } from 'ajv'
+import type { EntrypointOutcome } from './consts.js'
+import type { Auth } from '@owlmeans/auth'
+
+export interface CommonEntrypoint extends BasicEntrypoint {
+  route: CommonRouteModel
+  /**
+   * @property {boolean} - if true — router attaches this entrypoint unconditionally
+   * @default false
+   */
+  sticky: boolean
+  filter?: Filter
+  guards?: string[]
+  gate?: string
+  gateParams?: string | string[]
+  handle?: EntrypointHandler
+  getAlias: () => string
+  getPath: () => string
+  getParentAlias: () => string | null
+  hasParent: () => boolean
+  resolve: <M extends CommonEntrypoint>() => Promise<M>
+  getParent: <M extends CommonEntrypoint>() => M
+  setService: (service: string) => void
+  getGuards: () => string[]
+  getGates: () => [string, string[]][]
+}
+
+export interface CommonEntrypointOptions extends Partial<CommonEntrypoint> { }
+
+export interface EntrypointMatch {
+  <R extends AbstractRequest, P extends AbstractResponse<any>>(req: R, res: P): Promise<boolean>
+}
+
+export interface EntrypointHandler {
+  <
+    T, R extends AbstractRequest<any> = AbstractRequest<any>,
+    P extends AbstractResponse<any> = AbstractResponse<any>,
+  >(req: R, res: P): T | Promise<T>
+}
+
+export interface EntrypointAssert {
+  <R extends AbstractRequest, P extends AbstractResponse<any>>(req: R, res: P, params: string[]): Promise<void>
+}
+
+export interface AbstractRequest<T extends {} = {}> {
+  alias: string
+  auth?: Auth
+  params: Record<string, string | number | undefined | null> | Partial<T>
+  body?: Record<string, any> | Partial<T>
+  headers: Record<string, string[] | string | undefined>
+  query: Record<string, string | number | undefined | null> | Partial<T>
+  path: string
+  original?: any
+  canceled?: boolean
+  cancel?: () => void
+  host?: string
+  base?: string | boolean
+  unsecure?: boolean
+}
+
+export interface AbstractResponse<T> {
+  responseProvider?: any
+  value?: T,
+  outcome?: EntrypointOutcome
+  error?: Error
+  resolve: (value: T, outcome?: EntrypointOutcome) => void
+  reject: (error: Error) => void
+}
+
+export interface GuardService extends InitializedService {
+  // Client guard
+  token?: string
+  authenticated: (req?: Partial<AbstractRequest>) => Promise<string | null>
+  // Server guard
+  match: EntrypointMatch
+  handle: EntrypointHandler
+}
+
+export interface GateService extends LazyService {
+  /**
+   * @throws {Error}
+   */
+  assert: EntrypointAssert
+}
+
+export interface Filter {
+  query?: AnySchemaObject
+  params?: AnySchemaObject
+  body?: AnySchemaObject
+  response?: AnySchemaObject
+  headers?: AnySchemaObject
+}

package/src/utils/entrypoint.ts

@@ -0,0 +1,4 @@
+import { CommonEntrypoint } from '../types.js'
+
+export const isEntrypoint = (obj: object): obj is CommonEntrypoint =>
+  '_entrypoint' in obj || '_module' in obj

package/src/utils/index.ts

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

package/src/utils/types.ts

@@ -0,0 +1,6 @@
+import { CommonRouteModel } from '@owlmeans/route'
+import { CommonEntrypointOptions } from '../types.js'
+
+export interface CreateEntrypointSignature<M> {
+  (route: CommonRouteModel, opts?: CommonEntrypointOptions): M,
+}

package/tsconfig.json

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