@owlmeans/server-app 0.1.18-rc.1 → 0.1.18-rc.11

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (8) hide show
  1. package/agent-meta/manifest.json +2 -2
  2. package/agent-meta/skills/server-app/SKILL.md +16 -12
  3. package/build/exports.d.ts +2 -1
  4. package/build/exports.d.ts.map +1 -1
  5. package/build/exports.js +1 -1
  6. package/build/exports.js.map +1 -1
  7. package/package.json +16 -16
  8. package/src/exports.ts +2 -1
package/agent-meta/manifest.json CHANGED
@@ -1,8 +1,8 @@
1
1
  {
2
2
  "schemaVersion": 2,
3
3
  "package": "@owlmeans/server-app",
4
- "version": "0.1.18-rc.0",
5
- "generatedAt": "2026-08-16T22:20:50.509Z",
4
+ "version": "0.1.18-rc.11",
5
+ "generatedAt": "2026-08-24T21:14:00.129Z",
6
6
  "canonicalRepo": "https://github.com/owlmeans/common",
7
7
  "entries": [
8
8
  {
package/agent-meta/skills/server-app/SKILL.md CHANGED
@@ -8,19 +8,19 @@ user-invocable: false
8
8
  # @owlmeans/server-app
9
9
 
10
10
  **Layer:** Server
11
- **Install:** `"@owlmeans/server-app": "^0.1.18-rc.0"` in `dependencies`
11
+ **Install:** `"@owlmeans/server-app": "^0.1.18-rc.11"` in `dependencies`
12
12
 
13
13
  ## Key Exports
14
14
 
15
15
  | Export | Description |
16
16
  |--------|-------------|
17
- | `main<E, C, T>(context, modules)` | Entry point — boots Express, registers all entrypoints as routes |
17
+ | `main<E, C, T>(context, entrypoints)` | Entry point — registers all entrypoints, configures/inits the context, then boots the Fastify API server (`@owlmeans/server-api`) |
18
18
  | `handleRequest(fn)` | Wrap an async function as a server handler `(req, context) => result` |
19
19
  | `handleBody<T>(fn)` | Wrap an async function with validated body — `(payload, context, req) => result` |
20
20
  | `elevate(modules, alias, handler)` | Attach a handler to an entrypoint declaration |
21
21
  | `celevate(modules, alias, handler)` | Conditional elevate — only if entrypoint exists |
22
22
  | `sservice(options, cfg)` | Register a server-side service entry in the config |
23
- | `modules` | Built-in system entrypoints — spread into `appModules` |
23
+ | `modules` | Built-in system entrypoints — spread into `appEntrypoints` |
24
24
  | `Context`, `Config`, `ClientEntrypoint` re-exports | Common types |
25
25
 
26
26
  ## Usage
@@ -31,10 +31,10 @@ user-invocable: false
31
31
  import { main } from '@owlmeans/server-app'
32
32
  import config from './config.js'
33
33
  import { makeContext } from './context.js'
34
- import { appModules } from './modules.js'
34
+ import { appEntrypoints } from './entrypoints.js'
35
35
 
36
36
  const context = makeContext(config)
37
- main<{}, Config, Context>(context, appModules)
37
+ main<{}, Config, Context>(context, appEntrypoints)
38
38
  ```
39
39
 
40
40
  ### Handlers
@@ -59,20 +59,24 @@ export const create = handleBody<CreateProject>(async (payload, context, req) =>
59
59
  })
60
60
  ```
61
61
 
62
- ### Module elevation
62
+ ### Entrypoint elevation
63
63
  ```typescript
64
- import { elevate, modules } from '@owlmeans/server-app'
65
- import { managerModules } from 'my-common'
64
+ // entrypoints.ts
65
+ import { elevate, modules as systemEntrypoints } from '@owlmeans/server-app'
66
+ import { managerEntrypoints } from 'my-common'
66
67
  import { create, list } from './app/project/index.js'
67
68
 
68
- elevate(managerModules, manager.back.project.create, create)
69
- elevate(managerModules, manager.back.project.list, list)
69
+ elevate(managerEntrypoints, manager.back.project.create, create)
70
+ elevate(managerEntrypoints, manager.back.project.list, list)
70
71
 
71
- export const appModules = [...modules, ...paymentModules, ...managerModules]
72
+ export const appEntrypoints = [...systemEntrypoints, ...paymentEntrypoints, ...managerEntrypoints]
72
73
  ```
73
74
 
75
+ A backend alias that carries only a `guard()`/`gate()` for its children still needs a **bare**
76
+ `elevate(entrypoints, alias)` — that is what makes the declaration a live server route group.
77
+
74
78
  ## Depends On
75
79
 
76
80
  - `@owlmeans/server-context`, `@owlmeans/server-entrypoint`, `@owlmeans/server-route`, `@owlmeans/server-api`
77
81
  - `@owlmeans/entrypoint`, `@owlmeans/route`, `@owlmeans/auth`, `@owlmeans/error`
78
- - `express` / `fastify` (server runtime)
82
+ - `fastify` (server runtime — the HTTP server is created by `@owlmeans/server-api`; there is no Express here)
package/build/exports.d.ts CHANGED
@@ -12,7 +12,8 @@ export { elevate as celevate } from '@owlmeans/client-entrypoint';
12
12
  export type { ServerEntrypoint as Module, RefedEntrypointHandler } from '@owlmeans/server-entrypoint';
13
13
  export type { ClientEntrypoint } from '@owlmeans/client-entrypoint';
14
14
  export { route as broute } from '@owlmeans/server-route';
15
- export { handleRequest, handleBody, handleParams } from '@owlmeans/server-api';
15
+ export { handleRequest, handleBody, handleParams, holdApiPort } from '@owlmeans/server-api';
16
+ export type { ApiPortHold, ApiPortHoldOptions } from '@owlmeans/server-api';
16
17
  export { route } from '@owlmeans/route';
17
18
  export { DEFAULT_ALIAS as DAUTH_GUARD } from '@owlmeans/server-auth';
18
19
  export { klusterize } from '@owlmeans/kluster';
package/build/exports.d.ts.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"exports.d.ts","sourceRoot":"","sources":["../src/exports.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAA;AACjD,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAA;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAA;AACvD,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAA;AACnE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAA;AACtF,YAAY,EAAE,eAAe,IAAI,OAAO,EAAE,gBAAgB,IAAI,QAAQ,EAAE,MAAM,sBAAsB,CAAA;AACpG,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AACnE,YAAY,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAA;AACpD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AACvE,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,6BAA6B,CAAA;AACxE,OAAO,EAAE,OAAO,IAAI,QAAQ,EAAE,MAAM,6BAA6B,CAAA;AACjE,YAAY,EAAE,gBAAgB,IAAI,MAAM,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAA;AACrG,YAAY,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAA;AACnE,OAAO,EAAE,KAAK,IAAI,MAAM,EAAE,MAAM,wBAAwB,CAAA;AACxD,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AAC9E,OAAO,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAA;AACvC,OAAO,EAAE,aAAa,IAAI,WAAW,EAAE,MAAM,uBAAuB,CAAA;AACpE,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAC9C,YAAY,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAA;AACpD,OAAO,EAAE,aAAa,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAA"}
1
+ {"version":3,"file":"exports.d.ts","sourceRoot":"","sources":["../src/exports.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAA;AACjD,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAA;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAA;AACvD,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAA;AACnE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAA;AACtF,YAAY,EAAE,eAAe,IAAI,OAAO,EAAE,gBAAgB,IAAI,QAAQ,EAAE,MAAM,sBAAsB,CAAA;AACpG,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AACnE,YAAY,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAA;AACpD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AACvE,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,6BAA6B,CAAA;AACxE,OAAO,EAAE,OAAO,IAAI,QAAQ,EAAE,MAAM,6BAA6B,CAAA;AACjE,YAAY,EAAE,gBAAgB,IAAI,MAAM,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAA;AACrG,YAAY,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAA;AACnE,OAAO,EAAE,KAAK,IAAI,MAAM,EAAE,MAAM,wBAAwB,CAAA;AACxD,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAA;AAC3F,YAAY,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAA;AAC3E,OAAO,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAA;AACvC,OAAO,EAAE,aAAa,IAAI,WAAW,EAAE,MAAM,uBAAuB,CAAA;AACpE,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAC9C,YAAY,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAA;AACpD,OAAO,EAAE,aAAa,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAA"}
package/build/exports.js CHANGED
@@ -8,7 +8,7 @@ export { AppType, BASE, Layer, assertContext } from '@owlmeans/context';
8
8
  export { elevate, entrypoint, guard } from '@owlmeans/server-entrypoint';
9
9
  export { elevate as celevate } from '@owlmeans/client-entrypoint';
10
10
  export { route as broute } from '@owlmeans/server-route';
11
- export { handleRequest, handleBody, handleParams } from '@owlmeans/server-api';
11
+ export { handleRequest, handleBody, handleParams, holdApiPort } from '@owlmeans/server-api';
12
12
  export { route } from '@owlmeans/route';
13
13
  export { DEFAULT_ALIAS as DAUTH_GUARD } from '@owlmeans/server-auth';
14
14
  export { klusterize } from '@owlmeans/kluster';
package/build/exports.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"exports.js","sourceRoot":"","sources":["../src/exports.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAA;AACjD,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAA;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAA;AACvD,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAA;AACnE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAA;AAEtF,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAEnE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AACvE,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,6BAA6B,CAAA;AACxE,OAAO,EAAE,OAAO,IAAI,QAAQ,EAAE,MAAM,6BAA6B,CAAA;AAGjE,OAAO,EAAE,KAAK,IAAI,MAAM,EAAE,MAAM,wBAAwB,CAAA;AACxD,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AAC9E,OAAO,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAA;AACvC,OAAO,EAAE,aAAa,IAAI,WAAW,EAAE,MAAM,uBAAuB,CAAA;AACpE,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAE9C,OAAO,EAAE,aAAa,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAA"}
1
+ {"version":3,"file":"exports.js","sourceRoot":"","sources":["../src/exports.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAA;AACjD,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAA;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAA;AACvD,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAA;AACnE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAA;AAEtF,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAEnE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AACvE,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,6BAA6B,CAAA;AACxE,OAAO,EAAE,OAAO,IAAI,QAAQ,EAAE,MAAM,6BAA6B,CAAA;AAGjE,OAAO,EAAE,KAAK,IAAI,MAAM,EAAE,MAAM,wBAAwB,CAAA;AACxD,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAA;AAE3F,OAAO,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAA;AACvC,OAAO,EAAE,aAAa,IAAI,WAAW,EAAE,MAAM,uBAAuB,CAAA;AACpE,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAE9C,OAAO,EAAE,aAAa,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAA"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@owlmeans/server-app",
3
- "version": "0.1.18-rc.1",
3
+ "version": "0.1.18-rc.11",
4
4
  "license": "MIT",
5
5
  "type": "module",
6
6
  "scripts": {
@@ -21,21 +21,21 @@
21
21
  }
22
22
  },
23
23
  "dependencies": {
24
- "@owlmeans/api": "^0.1.18-rc.1",
25
- "@owlmeans/client-config": "^0.1.18-rc.1",
26
- "@owlmeans/client-entrypoint": "^0.1.18-rc.1",
27
- "@owlmeans/config": "^0.1.18-rc.1",
28
- "@owlmeans/context": "^0.1.18-rc.1",
29
- "@owlmeans/kluster": "^0.1.18-rc.1",
30
- "@owlmeans/entrypoint": "^0.1.18-rc.1",
31
- "@owlmeans/route": "^0.1.18-rc.1",
32
- "@owlmeans/server-api": "^0.1.18-rc.1",
33
- "@owlmeans/server-auth": "^0.1.18-rc.1",
34
- "@owlmeans/server-context": "^0.1.18-rc.1",
35
- "@owlmeans/server-entrypoint": "^0.1.18-rc.1",
36
- "@owlmeans/server-route": "^0.1.18-rc.1",
37
- "@owlmeans/server-socket": "^0.1.18-rc.1",
38
- "@owlmeans/static-resource": "^0.1.18-rc.1"
24
+ "@owlmeans/api": "^0.1.18-rc.7",
25
+ "@owlmeans/client-config": "^0.1.18-rc.7",
26
+ "@owlmeans/client-entrypoint": "^0.1.18-rc.7",
27
+ "@owlmeans/config": "^0.1.18-rc.7",
28
+ "@owlmeans/context": "^0.1.18-rc.6",
29
+ "@owlmeans/kluster": "^0.1.18-rc.7",
30
+ "@owlmeans/entrypoint": "^0.1.18-rc.7",
31
+ "@owlmeans/route": "^0.1.18-rc.6",
32
+ "@owlmeans/server-api": "^0.1.18-rc.11",
33
+ "@owlmeans/server-auth": "^0.1.18-rc.11",
34
+ "@owlmeans/server-context": "^0.1.18-rc.7",
35
+ "@owlmeans/server-entrypoint": "^0.1.18-rc.7",
36
+ "@owlmeans/server-route": "^0.1.18-rc.6",
37
+ "@owlmeans/server-socket": "^0.1.18-rc.11",
38
+ "@owlmeans/static-resource": "^0.1.18-rc.7"
39
39
  },
40
40
  "devDependencies": {
41
41
  "@owlmeans/dep-config": "workspace:*",
package/src/exports.ts CHANGED
@@ -13,7 +13,8 @@ export { elevate as celevate } from '@owlmeans/client-entrypoint'
13
13
  export type { ServerEntrypoint as Module, RefedEntrypointHandler } from '@owlmeans/server-entrypoint'
14
14
  export type { ClientEntrypoint } from '@owlmeans/client-entrypoint'
15
15
  export { route as broute } from '@owlmeans/server-route'
16
- export { handleRequest, handleBody, handleParams } from '@owlmeans/server-api'
16
+ export { handleRequest, handleBody, handleParams, holdApiPort } from '@owlmeans/server-api'
17
+ export type { ApiPortHold, ApiPortHoldOptions } from '@owlmeans/server-api'
17
18
  export { route } from '@owlmeans/route'
18
19
  export { DEFAULT_ALIAS as DAUTH_GUARD } from '@owlmeans/server-auth'
19
20
  export { klusterize } from '@owlmeans/kluster'