@owlmeans/server-api 0.1.7 → 0.1.9
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.
package/README.md
CHANGED
|
@@ -75,3 +75,20 @@ Extract a multipart-uploaded file from the request.
|
|
|
75
75
|
- [`@owlmeans/server-app`](../server-app) — re-exports all handlers; preferred import point
|
|
76
76
|
- [`@owlmeans/server-module`](../server-module) — `elevate()` attaches handlers to modules
|
|
77
77
|
- [`@owlmeans/server-socket`](../server-socket) — WebSocket `handleConnection` counterpart
|
|
78
|
+
|
|
79
|
+
<!-- owlmeans:agent-guidance:start -->
|
|
80
|
+
## Agent guidance
|
|
81
|
+
|
|
82
|
+
This package ships embedded Claude Code skills and GitHub Copilot instructions under
|
|
83
|
+
`agent-meta/`. After installing your `@owlmeans/*` packages, run the OwlMeans
|
|
84
|
+
agent-skills installer to place them into your project's native locations
|
|
85
|
+
(`.claude/skills/` and `.github/instructions/`):
|
|
86
|
+
|
|
87
|
+
```sh
|
|
88
|
+
npx @owlmeans/agent-skills
|
|
89
|
+
```
|
|
90
|
+
|
|
91
|
+
The embedded files are version-matched to this package release. Do not edit them
|
|
92
|
+
directly — they are regenerated on each publish. To contribute guidance edits,
|
|
93
|
+
open a PR against the source monorepo.
|
|
94
|
+
<!-- owlmeans:agent-guidance:end -->
|
|
@@ -0,0 +1,36 @@
|
|
|
1
|
+
---
|
|
2
|
+
description: "How to use @owlmeans/server-api — Fastify-based API server factory, request/response shapes, server middleware integration."
|
|
3
|
+
applyTo: "**/*.ts, **/*.tsx"
|
|
4
|
+
---
|
|
5
|
+
<!-- AUTO-GENERATED — do not edit. Regenerate via sync-agent-meta. -->
|
|
6
|
+
|
|
7
|
+
# @owlmeans/server-api
|
|
8
|
+
|
|
9
|
+
**Layer:** Server
|
|
10
|
+
**Install:** `"@owlmeans/server-api": "^0.1.9"` in `dependencies`
|
|
11
|
+
|
|
12
|
+
## Key Exports
|
|
13
|
+
|
|
14
|
+
| Export | Description |
|
|
15
|
+
|--------|-------------|
|
|
16
|
+
| `makeServer()` | Factory for the Fastify API server |
|
|
17
|
+
| `Server`, `ServerRequest`, `ServerResponse` types | Runtime shapes |
|
|
18
|
+
| Errors | Typed transport errors |
|
|
19
|
+
| Constants | Default ports, paths |
|
|
20
|
+
| Helpers | Middleware composition |
|
|
21
|
+
|
|
22
|
+
## Subpath Exports
|
|
23
|
+
|
|
24
|
+
- `./utils` — server utility functions
|
|
25
|
+
|
|
26
|
+
## Usage
|
|
27
|
+
|
|
28
|
+
```typescript
|
|
29
|
+
import { makeServer } from '@owlmeans/server-api'
|
|
30
|
+
const server = makeServer({ port: 8080 })
|
|
31
|
+
context.registerService(server)
|
|
32
|
+
```
|
|
33
|
+
|
|
34
|
+
## Depends On
|
|
35
|
+
|
|
36
|
+
- `@owlmeans/context`, `@owlmeans/entrypoint`, `@owlmeans/route`, `fastify`
|
|
@@ -0,0 +1,23 @@
|
|
|
1
|
+
{
|
|
2
|
+
"schemaVersion": 1,
|
|
3
|
+
"package": "@owlmeans/server-api",
|
|
4
|
+
"version": "0.1.9",
|
|
5
|
+
"generatedAt": "2026-06-14T13:34:06.123Z",
|
|
6
|
+
"canonicalRepo": "https://github.com/owlmeans/common",
|
|
7
|
+
"entries": [
|
|
8
|
+
{
|
|
9
|
+
"kind": "skill",
|
|
10
|
+
"name": "server-api",
|
|
11
|
+
"category": "package-specific",
|
|
12
|
+
"file": "skills/server-api/SKILL.md",
|
|
13
|
+
"canonicalPath": ".claude/skills/server-api/SKILL.md"
|
|
14
|
+
},
|
|
15
|
+
{
|
|
16
|
+
"kind": "instruction",
|
|
17
|
+
"name": "server-api",
|
|
18
|
+
"category": "package-specific",
|
|
19
|
+
"file": "instructions/server-api.instructions.md",
|
|
20
|
+
"canonicalPath": ".github/instructions/server-api.instructions.md"
|
|
21
|
+
}
|
|
22
|
+
]
|
|
23
|
+
}
|
|
@@ -0,0 +1,40 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: server-api
|
|
3
|
+
description: How to use @owlmeans/server-api — Fastify-based API server factory, request/response shapes, server middleware integration. Auto-invoked when importing server-api types or extending the server middleware stack.
|
|
4
|
+
user-invocable: false
|
|
5
|
+
---
|
|
6
|
+
<!-- AUTO-GENERATED — do not edit. Regenerate via sync-agent-meta. -->
|
|
7
|
+
|
|
8
|
+
# @owlmeans/server-api
|
|
9
|
+
|
|
10
|
+
**Layer:** Server
|
|
11
|
+
**Install:** `"@owlmeans/server-api": "^0.1.9"` in `dependencies`
|
|
12
|
+
|
|
13
|
+
## Key Exports
|
|
14
|
+
|
|
15
|
+
| Export | Description |
|
|
16
|
+
|--------|-------------|
|
|
17
|
+
| `makeServer()` | Factory for the Fastify-based API server |
|
|
18
|
+
| `Server`, `ServerRequest`, `ServerResponse` types | Runtime shapes |
|
|
19
|
+
| Errors | Typed transport errors |
|
|
20
|
+
| Constants | Default ports, paths |
|
|
21
|
+
| Helpers | Middleware composition |
|
|
22
|
+
|
|
23
|
+
## Subpath Exports
|
|
24
|
+
|
|
25
|
+
- `./utils` — server utility functions
|
|
26
|
+
|
|
27
|
+
## Usage
|
|
28
|
+
|
|
29
|
+
The server is normally constructed transparently by `@owlmeans/server-app#main()`. Use `server-api` directly only when you need to register raw Fastify plugins or customize transport:
|
|
30
|
+
|
|
31
|
+
```typescript
|
|
32
|
+
import { makeServer } from '@owlmeans/server-api'
|
|
33
|
+
const server = makeServer({ port: 8080 })
|
|
34
|
+
context.registerService(server)
|
|
35
|
+
```
|
|
36
|
+
|
|
37
|
+
## Depends On
|
|
38
|
+
|
|
39
|
+
- `@owlmeans/context`, `@owlmeans/entrypoint`, `@owlmeans/route`
|
|
40
|
+
- `fastify` (runtime)
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@owlmeans/server-api",
|
|
3
|
-
"version": "0.1.
|
|
3
|
+
"version": "0.1.9",
|
|
4
4
|
"license": "MIT",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"scripts": {
|
|
@@ -32,15 +32,15 @@
|
|
|
32
32
|
"@fastify/helmet": "^12.0.1",
|
|
33
33
|
"@fastify/middie": "^9.0.2",
|
|
34
34
|
"@fastify/multipart": "^9.0.1",
|
|
35
|
-
"@owlmeans/api": "^0.1.
|
|
36
|
-
"@owlmeans/auth": "^0.1.
|
|
37
|
-
"@owlmeans/auth-common": "^0.1.
|
|
38
|
-
"@owlmeans/context": "^0.1.
|
|
39
|
-
"@owlmeans/error": "^0.1.
|
|
40
|
-
"@owlmeans/entrypoint": "^0.1.
|
|
41
|
-
"@owlmeans/route": "^0.1.
|
|
42
|
-
"@owlmeans/server-context": "^0.1.
|
|
43
|
-
"@owlmeans/server-entrypoint": "^0.1.
|
|
35
|
+
"@owlmeans/api": "^0.1.9",
|
|
36
|
+
"@owlmeans/auth": "^0.1.9",
|
|
37
|
+
"@owlmeans/auth-common": "^0.1.9",
|
|
38
|
+
"@owlmeans/context": "^0.1.9",
|
|
39
|
+
"@owlmeans/error": "^0.1.9",
|
|
40
|
+
"@owlmeans/entrypoint": "^0.1.9",
|
|
41
|
+
"@owlmeans/route": "^0.1.9",
|
|
42
|
+
"@owlmeans/server-context": "^0.1.9",
|
|
43
|
+
"@owlmeans/server-entrypoint": "^0.1.9",
|
|
44
44
|
"ajv-errors": "^3.0.0",
|
|
45
45
|
"fastify": "^5.0.0",
|
|
46
46
|
"fastify-raw-body": "^5.0.0",
|