@boon4681/giri 0.0.1
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/LICENSE +21 -0
- package/README.md +231 -0
- package/dist/adapters/hono.d.ts +7 -0
- package/dist/adapters/hono.js +301 -0
- package/dist/adapters/hono.js.map +1 -0
- package/dist/cli.d.ts +1 -0
- package/dist/cli.js +2070 -0
- package/dist/cli.js.map +1 -0
- package/dist/index.d.ts +164 -0
- package/dist/index.js +1762 -0
- package/dist/index.js.map +1 -0
- package/dist/types-BrUMxh5u.d.ts +233 -0
- package/dist/typescript-plugin.d.ts +7 -0
- package/dist/typescript-plugin.js +120 -0
- package/dist/typescript-plugin.js.map +1 -0
- package/dist/validators/valibot.d.ts +21 -0
- package/dist/validators/valibot.js +81 -0
- package/dist/validators/valibot.js.map +1 -0
- package/dist/validators/zod.d.ts +26 -0
- package/dist/validators/zod.js +70 -0
- package/dist/validators/zod.js.map +1 -0
- package/package.json +93 -0
package/LICENSE
ADDED
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2026 boon4681,Passwich Thongruang
|
|
4
|
+
|
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
+
in the Software without restriction, including without limitation the rights
|
|
8
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
+
furnished to do so, subject to the following conditions:
|
|
11
|
+
|
|
12
|
+
The above copyright notice and this permission notice shall be included in all
|
|
13
|
+
copies or substantial portions of the Software.
|
|
14
|
+
|
|
15
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
+
SOFTWARE.
|
package/README.md
ADDED
|
@@ -0,0 +1,231 @@
|
|
|
1
|
+
# Giri
|
|
2
|
+
|
|
3
|
+
A stupid attempt from a stupid man who lack of foresight trying to make a backend framework.
|
|
4
|
+
|
|
5
|
+
<img width="128" src="https://raw.githubusercontent.com/boon4681/giri/refs/heads/main/.image/logo.png" />
|
|
6
|
+
|
|
7
|
+
## F*CK NPM PUBLISH i have to change this package name from `guri` to `giri` to `@boon4681/giri` because of the name collision and there is no contact about request a package name that hit npm stupid filter.
|
|
8
|
+
|
|
9
|
+
## Why does giri exist?
|
|
10
|
+
Because I can, and I am too lazy to write an OpenAPI spec. Write handlers, return values. Giri infers the OpenAPI spec from the handlers, and generates types for params and `openapi.json` from them. Runs on Hono.
|
|
11
|
+
|
|
12
|
+
> Status: early and experimental. Hono is the only adapter today; the API will change.
|
|
13
|
+
|
|
14
|
+
## Install
|
|
15
|
+
|
|
16
|
+
```sh
|
|
17
|
+
yarn add giri hono @hono/node-server zod
|
|
18
|
+
```
|
|
19
|
+
|
|
20
|
+
`hono`, `@hono/node-server`, `zod`, `valibot`, and `typescript` are optional peers — install
|
|
21
|
+
only what you use.
|
|
22
|
+
|
|
23
|
+
## Quick start
|
|
24
|
+
|
|
25
|
+
```sh
|
|
26
|
+
npx giri init # scaffold giri.config.ts + src/routes + tsconfig + .gitignore
|
|
27
|
+
npx giri sync # generate .giri/ (manifest, param types, openapi.json)
|
|
28
|
+
npx giri serve # sync, then run the dev server (watches src/ and re-syncs)
|
|
29
|
+
```
|
|
30
|
+
|
|
31
|
+
Then hit it:
|
|
32
|
+
|
|
33
|
+
```sh
|
|
34
|
+
curl http://localhost:3000/
|
|
35
|
+
```
|
|
36
|
+
|
|
37
|
+
## Config
|
|
38
|
+
|
|
39
|
+
`giri.config.ts` is declarative — it is loaded at build time, so keep it cheap and free of
|
|
40
|
+
side effects (no DB drivers here; see [Lifecycle](#lifecycle)).
|
|
41
|
+
|
|
42
|
+
```ts
|
|
43
|
+
import { defineConfig } from "@boon4681/giri";
|
|
44
|
+
import { hono } from "@boon4681/giri/adapters/hono";
|
|
45
|
+
|
|
46
|
+
export default defineConfig({
|
|
47
|
+
adapter: hono(), // required: the backend bridge
|
|
48
|
+
server: { port: 3000, hostname: "127.0.0.1" },
|
|
49
|
+
outDir: ".giri", // where generated output lives
|
|
50
|
+
alias: { "$db": "./src/db.ts" }, // import aliases, also written into tsconfig
|
|
51
|
+
});
|
|
52
|
+
```
|
|
53
|
+
|
|
54
|
+
## Routes
|
|
55
|
+
|
|
56
|
+
Every URL segment is a **folder**; every HTTP verb is its own file inside it.
|
|
57
|
+
|
|
58
|
+
```
|
|
59
|
+
src/routes/
|
|
60
|
+
+get.ts -> GET /
|
|
61
|
+
+shared.ts -> folder config for everything below
|
|
62
|
+
users/
|
|
63
|
+
+get.ts -> GET /users
|
|
64
|
+
+post.ts -> POST /users
|
|
65
|
+
[id]/
|
|
66
|
+
+get.ts -> GET /users/:id
|
|
67
|
+
posts/
|
|
68
|
+
[postId]/
|
|
69
|
+
+get.ts -> GET /users/:id/posts/:postId
|
|
70
|
+
db.ts -> no '+' prefix = plain helper, ignored by the router
|
|
71
|
+
```
|
|
72
|
+
|
|
73
|
+
- `[id]` folder becomes the param `:id`; params nest down the path.
|
|
74
|
+
- Files without a `+` prefix are not routes — colocate helpers freely.
|
|
75
|
+
|
|
76
|
+
A verb file has one shape: the `handle` named export is the handler. Everything else is an
|
|
77
|
+
optional named export, so the trivial case is one line and complexity is additive.
|
|
78
|
+
|
|
79
|
+
```ts
|
|
80
|
+
// src/routes/users/[id]/+get.ts
|
|
81
|
+
import type { Handle } from "./$types"; // generated per folder; binds c.params to this path
|
|
82
|
+
import { findUser } from "../../../db";
|
|
83
|
+
|
|
84
|
+
export const handle: Handle = (c) => {
|
|
85
|
+
const user = findUser(c.params.id); // c.params.id is typed as string
|
|
86
|
+
if (!user) return c.json({ message: "user not found" }, 404);
|
|
87
|
+
return c.json(user);
|
|
88
|
+
};
|
|
89
|
+
// inferred responses: 200 -> User, 404 -> { message: string }
|
|
90
|
+
```
|
|
91
|
+
|
|
92
|
+
## The context `c`
|
|
93
|
+
|
|
94
|
+
Giri owns `c`, so the return type is the schema on every backend:
|
|
95
|
+
|
|
96
|
+
- `c.json(data, status?)` / `c.text(text, status?)` — return value carries the status in its type.
|
|
97
|
+
- `c.params` — typed from the folder path.
|
|
98
|
+
- `c.req.valid("body" | "query")` — parsed, typed input (see below).
|
|
99
|
+
- `c.req.header(name)`, `c.req.url`, etc.
|
|
100
|
+
- `c.get(key)` / `c.set(key, value)` — per-request vars from middleware.
|
|
101
|
+
- `c.app` — app-wide services from `src/main.ts` `init()` (see [Lifecycle](#lifecycle)).
|
|
102
|
+
|
|
103
|
+
## Inputs
|
|
104
|
+
|
|
105
|
+
Outputs are inferred; inputs are declared with a **wrapped** schema so giri gets both runtime
|
|
106
|
+
validation and a JSON Schema for the doc. Wrappers live in `@boon4681/giri/validators/zod` and
|
|
107
|
+
`@boon4681/giri/validators/valibot`.
|
|
108
|
+
|
|
109
|
+
```ts
|
|
110
|
+
// src/routes/users/+post.ts
|
|
111
|
+
import { z } from "zod";
|
|
112
|
+
import { zod } from "@boon4681/giri/validators/zod";
|
|
113
|
+
import type { POST } from "./$types";
|
|
114
|
+
|
|
115
|
+
export const body = zod.body({
|
|
116
|
+
json: z.object({ name: z.string().min(1) }),
|
|
117
|
+
});
|
|
118
|
+
export const query = zod.query(z.object({ page: z.coerce.number().default(1) }));
|
|
119
|
+
|
|
120
|
+
export const handle: POST = (c) => {
|
|
121
|
+
const { name } = c.req.valid("body"); // typed + validated
|
|
122
|
+
return c.json({ name }, 201);
|
|
123
|
+
};
|
|
124
|
+
```
|
|
125
|
+
|
|
126
|
+
`zod.body` can map multiple content types (`json`, `form`) dispatched on `Content-Type` at
|
|
127
|
+
runtime. An unwrapped schema is rejected at build time.
|
|
128
|
+
|
|
129
|
+
## Middleware
|
|
130
|
+
|
|
131
|
+
Middleware use giri's `(c, next)` shape and live in two places:
|
|
132
|
+
|
|
133
|
+
- **Broad:** `export const middleware` in a folder's `+shared.ts` — applies to the whole subtree.
|
|
134
|
+
- **Precise:** `export const middleware` in a verb file — applies to that one verb.
|
|
135
|
+
|
|
136
|
+
Use `stack(...)` instead of a plain array so injected vars keep their types and propagate to
|
|
137
|
+
downstream handlers. Run order: inherited `+shared.ts` (root to leaf), then the verb's
|
|
138
|
+
`middleware`, then the handler.
|
|
139
|
+
|
|
140
|
+
```ts
|
|
141
|
+
// src/routes/+shared.ts
|
|
142
|
+
import { stack } from "@boon4681/giri";
|
|
143
|
+
import type { Middleware } from "./$types";
|
|
144
|
+
|
|
145
|
+
const requestId: Middleware<{ requestId: string }> = async (c, next) => {
|
|
146
|
+
c.set("requestId", c.req.header("x-request-id") ?? "example-request");
|
|
147
|
+
await next();
|
|
148
|
+
};
|
|
149
|
+
|
|
150
|
+
export const middleware = stack(requestId);
|
|
151
|
+
// every handler below now sees c.get("requestId"): string
|
|
152
|
+
```
|
|
153
|
+
|
|
154
|
+
Tag a middleware with `defineMiddleware` to feed OpenAPI security automatically — a route that
|
|
155
|
+
uses it shows the scheme, a public route does not.
|
|
156
|
+
|
|
157
|
+
```ts
|
|
158
|
+
// src/auth.ts
|
|
159
|
+
import { defineMiddleware } from "@boon4681/giri";
|
|
160
|
+
|
|
161
|
+
export const auth = defineMiddleware<{ userId: string }>(
|
|
162
|
+
{
|
|
163
|
+
openapi: {
|
|
164
|
+
security: [{ bearerAuth: [] }],
|
|
165
|
+
securitySchemes: { bearerAuth: { type: "http", scheme: "bearer" } },
|
|
166
|
+
},
|
|
167
|
+
},
|
|
168
|
+
async (c, next) => {
|
|
169
|
+
// verify a token, then c.set("userId", ...)
|
|
170
|
+
await next();
|
|
171
|
+
},
|
|
172
|
+
);
|
|
173
|
+
```
|
|
174
|
+
|
|
175
|
+
Hide a route or subtree from `openapi.json` with `export const openapi = false` (in a verb file
|
|
176
|
+
or a `+shared.ts`). Hidden routes still serve normally.
|
|
177
|
+
|
|
178
|
+
## Lifecycle
|
|
179
|
+
|
|
180
|
+
`src/main.ts` is the optional home for imperative startup — opening pools, validating env,
|
|
181
|
+
graceful shutdown. Giri owns the serve and calls these hooks; the adapter still binds the port.
|
|
182
|
+
|
|
183
|
+
```ts
|
|
184
|
+
// src/main.ts
|
|
185
|
+
import type { Services } from "@boon4681/giri";
|
|
186
|
+
|
|
187
|
+
export const init = () => {
|
|
188
|
+
// leave init unannotated — its return type is the source of truth for c.app
|
|
189
|
+
return { db: connectDb(process.env.DATABASE_URL) };
|
|
190
|
+
};
|
|
191
|
+
|
|
192
|
+
export const teardown = (services: Services) => {
|
|
193
|
+
return services.db.close(); // runs on SIGINT / SIGTERM
|
|
194
|
+
};
|
|
195
|
+
```
|
|
196
|
+
|
|
197
|
+
Flow: load `main.ts` -> `await init()` -> hold services -> adapter serves -> `teardown` on
|
|
198
|
+
exit. `init` runs once and is not re-run on watch rebuilds. The returned object reaches every
|
|
199
|
+
handler as a typed `c.app`, inferred from `init`'s return — no declaration needed.
|
|
200
|
+
|
|
201
|
+
## CLI
|
|
202
|
+
|
|
203
|
+
| Command | What it does |
|
|
204
|
+
| ------------ | ---------------------------------------------------------------------------------- |
|
|
205
|
+
| `giri init` | Scaffold `giri.config.ts`, a starter route, tsconfig paths, and `.gitignore`. |
|
|
206
|
+
| `giri sync` | Scan `src/routes` and regenerate `.giri/` (manifest, param types, `openapi.json`). |
|
|
207
|
+
| `giri serve` | `sync`, run `init()`, then serve via the adapter. Watches `src/` and re-syncs. |
|
|
208
|
+
| `giri build` | Planned — currently a no-op. |
|
|
209
|
+
|
|
210
|
+
`giri serve` flags: `--port <n>`, `--host <addr>`, `--no-watch`.
|
|
211
|
+
|
|
212
|
+
## Generated output (`.giri/`)
|
|
213
|
+
|
|
214
|
+
Everything derived lives in `.giri/` at the project root: param `.d.ts` per route, the route
|
|
215
|
+
manifest, and the assembled `openapi.json`. It is gitignored and rebuilt on demand — never edit
|
|
216
|
+
it, only import from it.
|
|
217
|
+
|
|
218
|
+
## Example
|
|
219
|
+
|
|
220
|
+
See [`example/`](example) for a runnable Hono app:
|
|
221
|
+
|
|
222
|
+
```sh
|
|
223
|
+
cd example
|
|
224
|
+
yarn install
|
|
225
|
+
yarn sync
|
|
226
|
+
yarn dev
|
|
227
|
+
```
|
|
228
|
+
|
|
229
|
+
## License
|
|
230
|
+
|
|
231
|
+
MIT
|
|
@@ -0,0 +1,301 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
var __defProp = Object.defineProperty;
|
|
3
|
+
var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
|
|
4
|
+
var __getOwnPropNames = Object.getOwnPropertyNames;
|
|
5
|
+
var __hasOwnProp = Object.prototype.hasOwnProperty;
|
|
6
|
+
var __export = (target, all) => {
|
|
7
|
+
for (var name in all)
|
|
8
|
+
__defProp(target, name, { get: all[name], enumerable: true });
|
|
9
|
+
};
|
|
10
|
+
var __copyProps = (to, from, except, desc) => {
|
|
11
|
+
if (from && typeof from === "object" || typeof from === "function") {
|
|
12
|
+
for (let key of __getOwnPropNames(from))
|
|
13
|
+
if (!__hasOwnProp.call(to, key) && key !== except)
|
|
14
|
+
__defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
|
|
15
|
+
}
|
|
16
|
+
return to;
|
|
17
|
+
};
|
|
18
|
+
var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
|
|
19
|
+
|
|
20
|
+
// src/adapters/hono.ts
|
|
21
|
+
var hono_exports = {};
|
|
22
|
+
__export(hono_exports, {
|
|
23
|
+
hono: () => hono
|
|
24
|
+
});
|
|
25
|
+
module.exports = __toCommonJS(hono_exports);
|
|
26
|
+
var import_node_server = require("@hono/node-server");
|
|
27
|
+
var import_hono = require("hono");
|
|
28
|
+
|
|
29
|
+
// src/types.ts
|
|
30
|
+
var typedResponseBrand = /* @__PURE__ */ Symbol.for("giri.typed-response");
|
|
31
|
+
var inputSchemaBrand = /* @__PURE__ */ Symbol.for("giri.input-schema");
|
|
32
|
+
|
|
33
|
+
// src/context.ts
|
|
34
|
+
var BODYLESS_STATUS = /* @__PURE__ */ new Set([101, 103, 204, 205, 304]);
|
|
35
|
+
function createTypedResponse(data, status, format, headers) {
|
|
36
|
+
return {
|
|
37
|
+
[typedResponseBrand]: { data, status, format },
|
|
38
|
+
data,
|
|
39
|
+
status,
|
|
40
|
+
format,
|
|
41
|
+
headers
|
|
42
|
+
};
|
|
43
|
+
}
|
|
44
|
+
function isTypedResponse(value) {
|
|
45
|
+
return Boolean(value && typeof value === "object" && typedResponseBrand in value);
|
|
46
|
+
}
|
|
47
|
+
function createContext(options) {
|
|
48
|
+
const url = new URL(options.request.url);
|
|
49
|
+
const store = /* @__PURE__ */ new Map();
|
|
50
|
+
const validated = options.validated ?? {};
|
|
51
|
+
return {
|
|
52
|
+
params: options.params ?? {},
|
|
53
|
+
app: options.app ?? {},
|
|
54
|
+
req: {
|
|
55
|
+
raw: options.request,
|
|
56
|
+
url,
|
|
57
|
+
method: options.request.method,
|
|
58
|
+
header: (name) => options.request.headers.get(name),
|
|
59
|
+
json: () => options.request.json(),
|
|
60
|
+
text: () => options.request.text(),
|
|
61
|
+
arrayBuffer: () => options.request.arrayBuffer(),
|
|
62
|
+
formData: () => options.request.formData(),
|
|
63
|
+
valid: (key) => {
|
|
64
|
+
if (!(key in validated)) {
|
|
65
|
+
throw new Error(`No validated ${String(key)} data is available for this route.`);
|
|
66
|
+
}
|
|
67
|
+
return validated[key];
|
|
68
|
+
}
|
|
69
|
+
},
|
|
70
|
+
set: (key, value) => {
|
|
71
|
+
store.set(key, value);
|
|
72
|
+
},
|
|
73
|
+
get: (key) => store.get(key),
|
|
74
|
+
json: (data, status = 200, headers) => createTypedResponse(data, status, "json", headers),
|
|
75
|
+
text: (text, status = 200, headers) => createTypedResponse(text, status, "text", headers)
|
|
76
|
+
};
|
|
77
|
+
}
|
|
78
|
+
function typedResponseToResponse(response) {
|
|
79
|
+
const headers = new Headers(response.headers);
|
|
80
|
+
if (response.format === "json" && !headers.has("content-type")) {
|
|
81
|
+
headers.set("content-type", "application/json; charset=utf-8");
|
|
82
|
+
}
|
|
83
|
+
if (response.format === "text" && !headers.has("content-type")) {
|
|
84
|
+
headers.set("content-type", "text/plain; charset=utf-8");
|
|
85
|
+
}
|
|
86
|
+
const body = BODYLESS_STATUS.has(response.status) ? null : response.format === "json" ? JSON.stringify(response.data) : String(response.data);
|
|
87
|
+
return new Response(body, {
|
|
88
|
+
status: response.status,
|
|
89
|
+
headers
|
|
90
|
+
});
|
|
91
|
+
}
|
|
92
|
+
function toResponse(response) {
|
|
93
|
+
return isTypedResponse(response) ? typedResponseToResponse(response) : response;
|
|
94
|
+
}
|
|
95
|
+
async function composeMiddleware(middleware, handle, context) {
|
|
96
|
+
let index = -1;
|
|
97
|
+
let result;
|
|
98
|
+
const dispatch = async (i) => {
|
|
99
|
+
if (i <= index) {
|
|
100
|
+
throw new Error("next() called multiple times in giri middleware.");
|
|
101
|
+
}
|
|
102
|
+
index = i;
|
|
103
|
+
if (i === middleware.length) {
|
|
104
|
+
result = await handle(context);
|
|
105
|
+
return result;
|
|
106
|
+
}
|
|
107
|
+
const returned = await middleware[i](context, () => dispatch(i + 1));
|
|
108
|
+
if (returned !== void 0) {
|
|
109
|
+
result = returned;
|
|
110
|
+
return returned;
|
|
111
|
+
}
|
|
112
|
+
return result;
|
|
113
|
+
};
|
|
114
|
+
await dispatch(0);
|
|
115
|
+
if (result === void 0) {
|
|
116
|
+
throw new Error("Route completed without returning a response.");
|
|
117
|
+
}
|
|
118
|
+
return result;
|
|
119
|
+
}
|
|
120
|
+
|
|
121
|
+
// src/validation.ts
|
|
122
|
+
function isGiriInputSchema(value) {
|
|
123
|
+
return Boolean(
|
|
124
|
+
value && typeof value === "object" && value[inputSchemaBrand] === true
|
|
125
|
+
);
|
|
126
|
+
}
|
|
127
|
+
var MIME_TO_CONTENT_TYPE = {
|
|
128
|
+
"application/json": "json",
|
|
129
|
+
"multipart/form-data": "form",
|
|
130
|
+
"application/x-www-form-urlencoded": "urlencoded",
|
|
131
|
+
"text/plain": "text"
|
|
132
|
+
};
|
|
133
|
+
function contentTypeFromHeader(header) {
|
|
134
|
+
if (!header) {
|
|
135
|
+
return void 0;
|
|
136
|
+
}
|
|
137
|
+
const mime = header.split(";", 1)[0].trim().toLowerCase();
|
|
138
|
+
return MIME_TO_CONTENT_TYPE[mime];
|
|
139
|
+
}
|
|
140
|
+
function formDataObject(form) {
|
|
141
|
+
const result = {};
|
|
142
|
+
form.forEach((value, key) => {
|
|
143
|
+
const current = result[key];
|
|
144
|
+
if (current === void 0) {
|
|
145
|
+
result[key] = value;
|
|
146
|
+
} else if (Array.isArray(current)) {
|
|
147
|
+
current.push(value);
|
|
148
|
+
} else {
|
|
149
|
+
result[key] = [current, value];
|
|
150
|
+
}
|
|
151
|
+
});
|
|
152
|
+
return result;
|
|
153
|
+
}
|
|
154
|
+
async function readRawBody(request, contentType) {
|
|
155
|
+
const cloned = request.clone();
|
|
156
|
+
if (contentType === "json") {
|
|
157
|
+
return cloned.json();
|
|
158
|
+
}
|
|
159
|
+
if (contentType === "text") {
|
|
160
|
+
return cloned.text();
|
|
161
|
+
}
|
|
162
|
+
return formDataObject(await cloned.formData());
|
|
163
|
+
}
|
|
164
|
+
function queryObject(url) {
|
|
165
|
+
const result = {};
|
|
166
|
+
for (const [key, value] of url.searchParams) {
|
|
167
|
+
const current = result[key];
|
|
168
|
+
if (current === void 0) {
|
|
169
|
+
result[key] = value;
|
|
170
|
+
} else if (Array.isArray(current)) {
|
|
171
|
+
current.push(value);
|
|
172
|
+
} else {
|
|
173
|
+
result[key] = [current, value];
|
|
174
|
+
}
|
|
175
|
+
}
|
|
176
|
+
return result;
|
|
177
|
+
}
|
|
178
|
+
async function runValidation(schema, value, label) {
|
|
179
|
+
if (!isGiriInputSchema(schema)) {
|
|
180
|
+
throw new Error(
|
|
181
|
+
`giri: ${label} schema must be wrapped with a validator, e.g. \`export const ${label} = zod(...)\` from @boon4681/giri/validators/zod.`
|
|
182
|
+
);
|
|
183
|
+
}
|
|
184
|
+
return schema.validate(value);
|
|
185
|
+
}
|
|
186
|
+
async function prepareRequestInput(request, input) {
|
|
187
|
+
const validated = {};
|
|
188
|
+
if (input?.query) {
|
|
189
|
+
const query = queryObject(new URL(request.url));
|
|
190
|
+
const result = await runValidation(input.query, query, "query");
|
|
191
|
+
if (!result.ok) {
|
|
192
|
+
return {
|
|
193
|
+
ok: false,
|
|
194
|
+
response: createTypedResponse(
|
|
195
|
+
{ message: "Invalid query parameters.", issues: result.issues },
|
|
196
|
+
400,
|
|
197
|
+
"json"
|
|
198
|
+
)
|
|
199
|
+
};
|
|
200
|
+
}
|
|
201
|
+
validated.query = result.value;
|
|
202
|
+
}
|
|
203
|
+
if (input?.body) {
|
|
204
|
+
const contents = input.body.contents;
|
|
205
|
+
const declared = Object.keys(contents);
|
|
206
|
+
const requested = contentTypeFromHeader(request.headers.get("content-type"));
|
|
207
|
+
const chosen = requested && contents[requested] ? requested : contents.json ? "json" : void 0;
|
|
208
|
+
if (!chosen) {
|
|
209
|
+
return {
|
|
210
|
+
ok: false,
|
|
211
|
+
response: createTypedResponse(
|
|
212
|
+
{ message: "Unsupported media type.", issues: { accepted: declared } },
|
|
213
|
+
415,
|
|
214
|
+
"json"
|
|
215
|
+
)
|
|
216
|
+
};
|
|
217
|
+
}
|
|
218
|
+
let rawBody;
|
|
219
|
+
try {
|
|
220
|
+
rawBody = await readRawBody(request, chosen);
|
|
221
|
+
} catch (error) {
|
|
222
|
+
return {
|
|
223
|
+
ok: false,
|
|
224
|
+
response: createTypedResponse(
|
|
225
|
+
{ message: "Invalid request body.", issues: error },
|
|
226
|
+
400,
|
|
227
|
+
"json"
|
|
228
|
+
)
|
|
229
|
+
};
|
|
230
|
+
}
|
|
231
|
+
const result = await runValidation(contents[chosen], rawBody, "body");
|
|
232
|
+
if (!result.ok) {
|
|
233
|
+
return {
|
|
234
|
+
ok: false,
|
|
235
|
+
response: createTypedResponse(
|
|
236
|
+
{ message: "Invalid request body.", issues: result.issues },
|
|
237
|
+
400,
|
|
238
|
+
"json"
|
|
239
|
+
)
|
|
240
|
+
};
|
|
241
|
+
}
|
|
242
|
+
validated.body = declared.length > 1 ? { type: chosen, data: result.value } : result.value;
|
|
243
|
+
}
|
|
244
|
+
return { ok: true, validated };
|
|
245
|
+
}
|
|
246
|
+
|
|
247
|
+
// src/adapters/hono.ts
|
|
248
|
+
async function routeHandler(honoContext, route) {
|
|
249
|
+
const prepared = await prepareRequestInput(honoContext.req.raw, route.input);
|
|
250
|
+
if (!prepared.ok) {
|
|
251
|
+
return toResponse(prepared.response);
|
|
252
|
+
}
|
|
253
|
+
const context = createContext({
|
|
254
|
+
request: honoContext.req.raw,
|
|
255
|
+
params: honoContext.req.param(),
|
|
256
|
+
validated: prepared.validated,
|
|
257
|
+
app: route.services
|
|
258
|
+
});
|
|
259
|
+
const result = await composeMiddleware(route.middleware, route.handle, context);
|
|
260
|
+
return toResponse(result);
|
|
261
|
+
}
|
|
262
|
+
function registerHonoRoute(app, route) {
|
|
263
|
+
const handler = (c) => routeHandler(c, route);
|
|
264
|
+
const method = route.method.toLowerCase();
|
|
265
|
+
const appMethods = app;
|
|
266
|
+
if (method in app && typeof appMethods[method] === "function") {
|
|
267
|
+
appMethods[method](route.path, handler);
|
|
268
|
+
return;
|
|
269
|
+
}
|
|
270
|
+
throw new Error(`Hono adapter does not support ${route.method}.`);
|
|
271
|
+
}
|
|
272
|
+
function hono() {
|
|
273
|
+
return {
|
|
274
|
+
name: "hono",
|
|
275
|
+
createApp: () => new import_hono.Hono({ strict: false }),
|
|
276
|
+
register: registerHonoRoute,
|
|
277
|
+
fetch: async (app, req) => app.fetch(req),
|
|
278
|
+
serve: (handler, options, onListen) => {
|
|
279
|
+
const server = (0, import_node_server.serve)(
|
|
280
|
+
{
|
|
281
|
+
fetch: handler,
|
|
282
|
+
port: options.port,
|
|
283
|
+
hostname: options.hostname
|
|
284
|
+
},
|
|
285
|
+
onListen ? (info) => onListen({ address: info.address, port: info.port }) : void 0
|
|
286
|
+
);
|
|
287
|
+
return {
|
|
288
|
+
close: () => {
|
|
289
|
+
return new Promise((resolve, reject) => {
|
|
290
|
+
server.close((error) => error ? reject(error) : resolve());
|
|
291
|
+
});
|
|
292
|
+
}
|
|
293
|
+
};
|
|
294
|
+
}
|
|
295
|
+
};
|
|
296
|
+
}
|
|
297
|
+
// Annotate the CommonJS export names for ESM import in node:
|
|
298
|
+
0 && (module.exports = {
|
|
299
|
+
hono
|
|
300
|
+
});
|
|
301
|
+
//# sourceMappingURL=hono.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"sources":["../../src/adapters/hono.ts","../../src/types.ts","../../src/context.ts","../../src/validation.ts"],"sourcesContent":["import { serve as serveNode } from '@hono/node-server';\nimport { Hono } from 'hono';\nimport type { Context as HonoContext } from 'hono';\nimport { composeMiddleware, createContext, toResponse } from '../context';\nimport type { GiriAdapter, GiriRouteRegistration } from '../types';\nimport { prepareRequestInput } from '../validation';\n\nexport type HonoGiriApp = Hono;\n\nasync function routeHandler(honoContext: HonoContext, route: GiriRouteRegistration): Promise<Response> {\n const prepared = await prepareRequestInput(honoContext.req.raw, route.input);\n if (!prepared.ok) {\n return toResponse(prepared.response);\n }\n\n const context = createContext({\n request: honoContext.req.raw,\n params: honoContext.req.param() as Record<string, string>,\n validated: prepared.validated,\n app: route.services,\n });\n const result = await composeMiddleware(route.middleware, route.handle, context);\n return toResponse(result);\n}\n\nfunction registerHonoRoute(app: Hono, route: GiriRouteRegistration): void {\n type HonoHandler = (c: HonoContext) => Promise<Response>;\n\n const handler: HonoHandler = (c) => routeHandler(c, route);\n const method = route.method.toLowerCase();\n const appMethods = app as never as Record<string, (path: string, handler: HonoHandler) => void>;\n\n if (method in app && typeof appMethods[method] === 'function') {\n appMethods[method](route.path, handler);\n return;\n }\n\n throw new Error(`Hono adapter does not support ${route.method}.`);\n}\n\nexport function hono(): GiriAdapter<HonoGiriApp> {\n return {\n name: 'hono',\n createApp: () => new Hono({ strict: false }),\n register: registerHonoRoute,\n fetch: async (app, req) => app.fetch(req),\n serve: (handler, options, onListen) => {\n const server = serveNode(\n {\n fetch: handler,\n port: options.port,\n hostname: options.hostname,\n },\n onListen ? (info) => onListen({ address: info.address, port: info.port }) : undefined,\n );\n\n return {\n close: () => {\n return new Promise<void>((resolve, reject) => {\n server.close((error) => (error ? reject(error) : resolve()));\n })\n }\n };\n },\n };\n}\n","export type HttpMethod = 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE' | 'OPTIONS' | 'HEAD';\n\nexport type StatusCode = number;\n\nexport type ResponseFormat = 'json' | 'text';\n\nexport const typedResponseBrand: unique symbol = Symbol.for('giri.typed-response') as never;\n\nexport interface TypedResponse<\n T,\n S extends StatusCode = StatusCode,\n F extends ResponseFormat = ResponseFormat,\n> {\n readonly [typedResponseBrand]: {\n data: T;\n status: S;\n format: F;\n };\n readonly data: T;\n readonly status: S;\n readonly format: F;\n readonly headers?: HeadersInit;\n}\n\nexport type HandlerResponse = Response | TypedResponse<unknown, StatusCode, ResponseFormat>;\n\nexport interface ValidatedInput {\n /**\n * The validated request body. For a single declared content-type it's that schema's\n * output; for several it's a discriminated union `{ type; data }` (see `ValidBody`).\n */\n body?: unknown;\n query?: unknown;\n}\n\nexport interface GiriRequest<Input extends ValidatedInput = ValidatedInput> {\n raw: Request;\n url: URL;\n method: string;\n header(name: string): string | null;\n json<T = unknown>(): Promise<T>;\n text(): Promise<string>;\n arrayBuffer(): Promise<ArrayBuffer>;\n formData(): Promise<FormData>;\n valid<K extends keyof Input & ('body' | 'query')>(key: K): Input[K];\n}\n\ndeclare global {\n /**\n * Global registration surface for app-wide types. `giri sync` augments\n * `Giri.Register[\"app\"]` from `src/main.ts` `init()` return type so `c.app` is\n * typed without per-route generics (the registration pattern).\n */\n namespace Giri {\n interface Register {}\n }\n}\n\n/**\n * The app-wide services container, the type of `c.app`. `giri sync` infers it from\n * `src/main.ts`'s `init()` return type (via the global `Giri.Register` augmentation);\n * until then it falls back to an open record. Leave `init` unannotated (its return is\n * the source of truth) and annotate `teardown`'s parameter with this:\n *\n * ```ts\n * export const init = () => ({ db }); // inferred\n * export const teardown = (services: Services) => services.db.close();\n * ```\n */\nexport type Services = Giri.Register extends { app: infer A }\n ? A\n : Record<string, unknown>;\n\nexport interface Context<\n Params extends Record<string, string> = Record<string, string>,\n Input extends ValidatedInput = ValidatedInput,\n Vars extends Record<string, unknown> = {},\n> {\n params: Params;\n /** App-wide services from `src/main.ts`'s `init()`, seeded into every request. */\n app: Services;\n req: GiriRequest<Input>;\n // Context vars (`c.set`/`c.get`). Keys declared by middleware (`Vars`) are typed;\n // any other key stays open (`unknown`) so untracked keys still work.\n set<K extends keyof Vars & string>(key: K, value: Vars[K]): void;\n set<K extends string>(key: K, value: unknown): void;\n get<K extends keyof Vars & string>(key: K): Vars[K];\n get<V = unknown>(key: string): V;\n json<T, S extends StatusCode = 200>(\n data: T,\n status?: S,\n headers?: HeadersInit,\n ): TypedResponse<T, S, 'json'>;\n text<S extends StatusCode = 200>(\n text: string,\n status?: S,\n headers?: HeadersInit,\n ): TypedResponse<string, S, 'text'>;\n}\n\nexport type Handle<\n Params extends Record<string, string> = Record<string, string>,\n Input extends ValidatedInput = ValidatedInput,\n Vars extends Record<string, unknown> = {},\n> = (c: Context<Params, Input, Vars>) => HandlerResponse | Promise<HandlerResponse>;\n\nexport type Next = () => Promise<HandlerResponse | void>;\n\n/** An OpenAPI security requirement, e.g. `{ bearerAuth: [] }`. */\nexport type SecurityRequirement = Record<string, string[]>;\n\nexport interface MiddlewareOpenApi {\n /** Security requirements this middleware enforces */\n security?: SecurityRequirement[];\n /** Optional scheme definitions, merged into `components.securitySchemes` so the doc is self-contained. */\n securitySchemes?: Record<string, unknown>;\n [key: string]: unknown;\n}\n\nexport interface MiddlewareOptions {\n openapi?: MiddlewareOpenApi;\n}\n\nexport interface Middleware<\n Params extends Record<string, string> = Record<string, string>,\n Input extends ValidatedInput = ValidatedInput,\n Vars extends Record<string, unknown> = {},\n> {\n (c: Context<Params, Input, Vars>, next: Next): HandlerResponse | void | Promise<HandlerResponse | void>;\n openapi?: MiddlewareOpenApi;\n}\n\n/** The context vars a middleware injects (its `Vars` type parameter). */\nexport type VarsOf<M> = M extends Middleware<Record<string, string>, ValidatedInput, infer V>\n ? V\n : {};\n\n/** Intersect the injected vars of a tuple of middleware (built with `stack(...)`). */\nexport type MergeStack<T> = T extends readonly [infer Head, ...infer Rest]\n ? VarsOf<Head> & MergeStack<Rest>\n : {};\n\n/**\n * Merge the vars from a middleware stack export. A plain `Middleware[]` (not a `stack(...)` tuple)\n */\nexport type InferStackVars<T> = T extends readonly [unknown, ...unknown[]] ? MergeStack<T> : {};\n\n/**\n * The vars injected by a module own `middleware` export (a `stack(...)`). Used by the\n * generated per-method handle so a verb file's own `export const middleware` types\n * `c.get`/`c.set`, on top of the folder's `+shared.ts` chain.\n */\nexport type MiddlewareVarsOf<M> = M extends { middleware: infer Stack }\n ? InferStackVars<Stack>\n : {};\n\n/** A JSON Schema object (JSON Schema 2020-12 / OpenAPI 3.1 dialect). */\nexport type JsonSchema = Record<string, unknown>;\n\nexport const inputSchemaBrand: unique symbol = Symbol.for('giri.input-schema') as never;\n\nexport type InputValidationResult<Output = unknown> =\n | { ok: true; value: Output }\n | { ok: false; issues: unknown };\n\n/**\n * A input schema every wrapper form (`body`/`query`) export takes. A vendor\n * adapter (`@boon4681/giri/validators/zod`, `@boon4681/giri/validators/valibot`, …) returns one; build a\n * custom one with `defineInputSchema`. giri core depends only on this interface, never\n * on a validator library. `validate` is the runtime check; `toJsonSchema` feeds OpenAPI.\n */\nexport interface GiriInputSchema<Output = unknown> {\n readonly [inputSchemaBrand]: true;\n validate(value: unknown): InputValidationResult<Output> | Promise<InputValidationResult<Output>>;\n toJsonSchema(): JsonSchema;\n}\n\n/** Extract the validated output type of a giri input schema: `Infer<typeof body>`. */\nexport type Infer<T> = T extends GiriInputSchema<infer Output> ? Output : never;\n\nexport type BodyContentType = 'json' | 'form' | 'urlencoded' | 'text';\n\nexport const bodySchemaBrand: unique symbol = Symbol.for('giri.body-schema') as never;\n\n/**\n * A request body declared as a set of accepted content-types wrapped form `body`\n * takes (`zod.body({ json, form })`). One key means that encoding only; several mean the\n * endpoint accepts any of them, dispatched at runtime on the request `Content-Type`.\n * Each entry is a plain `GiriInputSchema`, so `validate`/`toJsonSchema` work per content-type.\n */\nexport interface GiriBodySchema<\n Outputs extends Partial<Record<BodyContentType, unknown>> = Partial<Record<BodyContentType, unknown>>,\n> {\n readonly [bodySchemaBrand]: true;\n readonly contents: { [K in keyof Outputs & BodyContentType]: GiriInputSchema<Outputs[K]> };\n}\n\n/** True when `T` is a union of more than one member. */\ntype IsUnion<T, U = T> = T extends unknown ? ([U] extends [T] ? false : true) : never;\n\n/**\n * The validated body a handler receives. A single declared content-type yields that\n * schema's output directly; several yield a discriminated union keyed by content-type.\n */\nexport type ValidBody<B> = B extends GiriBodySchema<infer Outputs>\n ? IsUnion<keyof Outputs> extends true\n ? { [K in keyof Outputs]: { type: K; data: Outputs[K] } }[keyof Outputs]\n : Outputs[keyof Outputs]\n : never;\n\n/** The validated query a handler receives. */\nexport type ValidQuery<Q> = Q extends GiriInputSchema<infer Output> ? Output : never;\n\n/** Drop keys whose value resolved to `never` (an input the route didn't declare). */\ntype PruneNever<T> = { [K in keyof T as [T[K]] extends [never] ? never : K]: T[K] };\n\n/**\n * Derive a route's `ValidatedInput` from a module's `body`/`query` exports. The generated\n * per-method `$types` handle (`POST`, `GET`, …) uses this so handlers infer `c.req.valid`\n * with no manual generic.\n */\nexport type RouteInputOf<M> = PruneNever<{\n body: M extends { body: infer B } ? ValidBody<B> : never;\n query: M extends { query: infer Q } ? ValidQuery<Q> : never;\n}>;\n\nexport interface RouteInput {\n body?: GiriBodySchema;\n query?: GiriInputSchema;\n}\n\nexport interface RouteOpenApi {\n /** Omit this route from the generated `openapi.json` (it still serves normally). */\n hidden?: boolean;\n // Room to grow: summary, description, tags, deprecated, operationId, …\n}\n\nexport type RouteOpenApiConfig = RouteOpenApi | boolean;\n\nexport interface GiriRouteRegistration {\n method: HttpMethod;\n path: string;\n handle: Handle;\n middleware: Middleware[];\n input?: RouteInput;\n /** App-wide services to seed onto `c.app` (same instance for every route). */\n services?: Services;\n}\n\nexport type GiriFetchHandler = (req: Request) => Response | Promise<Response>;\n\nexport interface GiriServeOptions {\n port: number;\n hostname?: string;\n}\n\nexport interface GiriServerInfo {\n address: string;\n port: number;\n}\n\nexport interface GiriServer {\n close(): void | Promise<void>;\n}\n\nexport interface GiriAdapter<App> {\n name?: string;\n createApp(): App;\n register(app: App, route: GiriRouteRegistration): void;\n fetch(app: App, req: Request): Promise<Response>;\n /**\n * Bind the configured backend's runtime to a port and start serving.\n * giri core stays runtime-agnostic: it hands the adapter a request handler\n * (so hot-reload keeps working) and the adapter owns the actual server.\n */\n serve(\n handler: GiriFetchHandler,\n options: GiriServeOptions,\n onListen?: (info: GiriServerInfo) => void,\n ): GiriServer;\n}\n\nexport interface GiriConfig<App = unknown> {\n adapter: GiriAdapter<App>;\n alias?: Record<string, string | string[]>;\n outDir?: string;\n server?: {\n port?: number;\n hostname?: string;\n };\n errorSchema?: unknown;\n}\n\nexport interface GiriPaths {\n cwd: string;\n routesDir: string;\n outDir: string;\n}\n","import {\n type Services,\n type Context,\n type HandlerResponse,\n type Middleware,\n type MiddlewareOptions,\n type ResponseFormat,\n type StatusCode,\n type TypedResponse,\n type ValidatedInput,\n typedResponseBrand,\n} from './types';\n\nconst BODYLESS_STATUS = new Set([101, 103, 204, 205, 304]);\n\nexport interface CreateContextOptions<\n Params extends Record<string, string> = Record<string, string>,\n Input extends ValidatedInput = ValidatedInput,\n> {\n request: Request;\n params?: Params;\n validated?: Input;\n app?: Services;\n}\n\nexport function createTypedResponse<\n T,\n S extends StatusCode,\n F extends ResponseFormat,\n>(data: T, status: S, format: F, headers?: HeadersInit): TypedResponse<T, S, F> {\n return {\n [typedResponseBrand]: { data, status, format },\n data,\n status,\n format,\n headers,\n };\n}\n\nexport function isTypedResponse(value: unknown): value is TypedResponse<unknown> {\n return Boolean(value && typeof value === 'object' && typedResponseBrand in value);\n}\n\nexport function createContext<\n Params extends Record<string, string> = Record<string, string>,\n Input extends ValidatedInput = ValidatedInput,\n>(options: CreateContextOptions<Params, Input>): Context<Params, Input> {\n const url = new URL(options.request.url);\n const store = new Map<string, unknown>();\n const validated = options.validated ?? ({} as Input);\n\n return {\n params: options.params ?? ({} as Params),\n app: options.app ?? ({} as Services),\n req: {\n raw: options.request,\n url,\n method: options.request.method,\n header: (name) => options.request.headers.get(name),\n json: <T = unknown>() => options.request.json() as Promise<T>,\n text: () => options.request.text(),\n arrayBuffer: () => options.request.arrayBuffer(),\n formData: () => options.request.formData(),\n valid: (key) => {\n if (!(key in validated)) {\n throw new Error(`No validated ${String(key)} data is available for this route.`);\n }\n return validated[key];\n },\n },\n set: (key: string, value: unknown) => {\n store.set(key, value);\n },\n get: (key: string) => store.get(key) as never,\n json: (data, status = 200 as never, headers) =>\n createTypedResponse(data, status, 'json', headers),\n text: (text, status = 200 as never, headers) =>\n createTypedResponse(text, status, 'text', headers),\n };\n}\n\nexport function typedResponseToResponse(response: TypedResponse<unknown>): Response {\n const headers = new Headers(response.headers);\n\n if (response.format === 'json' && !headers.has('content-type')) {\n headers.set('content-type', 'application/json; charset=utf-8');\n }\n\n if (response.format === 'text' && !headers.has('content-type')) {\n headers.set('content-type', 'text/plain; charset=utf-8');\n }\n\n const body = BODYLESS_STATUS.has(response.status)\n ? null\n : response.format === 'json'\n ? JSON.stringify(response.data)\n : String(response.data);\n\n return new Response(body, {\n status: response.status,\n headers,\n });\n}\n\nexport function toResponse(response: HandlerResponse): Response {\n return isTypedResponse(response) ? typedResponseToResponse(response) : response;\n}\n\nexport async function composeMiddleware(\n middleware: Middleware[],\n handle: (c: Context) => HandlerResponse | Promise<HandlerResponse>,\n context: Context,\n): Promise<HandlerResponse> {\n let index = -1;\n let result: HandlerResponse | undefined;\n\n const dispatch = async (i: number): Promise<HandlerResponse | void> => {\n if (i <= index) {\n throw new Error('next() called multiple times in giri middleware.');\n }\n index = i;\n\n if (i === middleware.length) {\n result = await handle(context);\n return result;\n }\n\n const returned = await middleware[i](context, () => dispatch(i + 1));\n if (returned !== undefined) {\n result = returned;\n return returned;\n }\n return result;\n };\n\n await dispatch(0);\n\n if (result === undefined) {\n throw new Error('Route completed without returning a response.');\n }\n\n return result;\n}\n\ntype AnyMiddleware<Vars extends Record<string, unknown>> = Middleware<\n Record<string, string>,\n ValidatedInput,\n Vars\n>;\n\nexport function defineMiddleware<Vars extends Record<string, unknown> = {}>(\n middleware: AnyMiddleware<Vars>,\n): AnyMiddleware<Vars>;\nexport function defineMiddleware<Vars extends Record<string, unknown> = {}>(\n options: MiddlewareOptions,\n middleware: AnyMiddleware<Vars>,\n): AnyMiddleware<Vars>;\nexport function defineMiddleware(\n optionsOrMiddleware: MiddlewareOptions | Middleware,\n maybeMiddleware?: Middleware,\n): Middleware {\n if (typeof optionsOrMiddleware === 'function') {\n return optionsOrMiddleware;\n }\n\n if (!maybeMiddleware) {\n throw new Error('defineMiddleware(options, middleware) requires a middleware function.');\n }\n\n maybeMiddleware.openapi = optionsOrMiddleware.openapi;\n return maybeMiddleware;\n}\n\n/**\n * Group middleware into an ordered stack, preserving each element's type as a tuple so\n * the injected context vars (`defineMiddleware<Vars>` / `Middleware<…, Vars>`) propagate\n * to downstream handlers. Use it for `+shared.ts` and verb `middleware` exports:\n * `export const middleware = stack(auth, requireAdmin)`.\n */\n// `Vars` is contravariant (it sits in the `c` parameter), so the constraint must leave it\n// open (`any`) otherwise a middleware that injects vars isn't assignable to the element type.\nexport function stack<T extends Middleware<Record<string, string>, ValidatedInput, any>[]>(...middleware: T): T {\n return middleware;\n}\n","import {\n type BodyContentType,\n type GiriBodySchema,\n type GiriInputSchema,\n type InputValidationResult,\n type RouteInput,\n type TypedResponse,\n type ValidatedInput,\n bodySchemaBrand,\n inputSchemaBrand,\n} from './types';\nimport { createTypedResponse } from './context';\n\ninterface PreparedInput {\n ok: true;\n validated: ValidatedInput;\n}\n\ninterface FailedInput {\n ok: false;\n response: TypedResponse<{ message: string; issues: unknown }, 400 | 415, 'json'>;\n}\n\nexport type PreparedRequestInput = PreparedInput | FailedInput;\n\n/**\n * Build a giri input schema from a `validate` + `toJsonSchema` pair. Vendor adapters use\n * this; you can call it directly to make a custom validator. The brand is a global symbol,\n * so a hand-rolled `{ [Symbol.for(\"giri.input-schema\")]: true, validate, toJsonSchema }` works too.\n */\nexport function defineInputSchema<Output>(\n schema: Omit<GiriInputSchema<Output>, typeof inputSchemaBrand>,\n): GiriInputSchema<Output> {\n return { [inputSchemaBrand]: true, ...schema };\n}\n\nexport function isGiriInputSchema(value: unknown): value is GiriInputSchema {\n return Boolean(\n value &&\n typeof value === 'object' &&\n (value as Record<symbol, unknown>)[inputSchemaBrand] === true,\n );\n}\n\n/**\n * Build a giri body schema from per-content-type input schemas. Validator adapters use this `zod.body({ json, form })`\n */\nexport function defineBodySchema<Outputs extends Partial<Record<BodyContentType, unknown>>>(\n contents: GiriBodySchema<Outputs>['contents'],\n): GiriBodySchema<Outputs> {\n return { [bodySchemaBrand]: true, contents };\n}\n\nexport function isGiriBodySchema(value: unknown): value is GiriBodySchema {\n return Boolean(\n value &&\n typeof value === 'object' &&\n (value as Record<symbol, unknown>)[bodySchemaBrand] === true,\n );\n}\n\nconst MIME_TO_CONTENT_TYPE: Record<string, BodyContentType> = {\n 'application/json': 'json',\n 'multipart/form-data': 'form',\n 'application/x-www-form-urlencoded': 'urlencoded',\n 'text/plain': 'text',\n};\n\nfunction contentTypeFromHeader(header: string | null): BodyContentType | undefined {\n if (!header) {\n return undefined;\n }\n const mime = header.split(';', 1)[0].trim().toLowerCase();\n return MIME_TO_CONTENT_TYPE[mime];\n}\n\n/** Flatten a `FormData` into a plain object, collapsing repeated fields into arrays. */\nfunction formDataObject(form: FormData): Record<string, unknown> {\n const result: Record<string, unknown> = {};\n form.forEach((value, key) => {\n const current = result[key];\n if (current === undefined) {\n result[key] = value;\n } else if (Array.isArray(current)) {\n current.push(value);\n } else {\n result[key] = [current, value];\n }\n });\n return result;\n}\n\nasync function readRawBody(request: Request, contentType: BodyContentType): Promise<unknown> {\n const cloned = request.clone();\n if (contentType === 'json') {\n return cloned.json();\n }\n if (contentType === 'text') {\n return cloned.text();\n }\n return formDataObject(await cloned.formData());\n}\n\nfunction queryObject(url: URL): Record<string, string | string[]> {\n const result: Record<string, string | string[]> = {};\n for (const [key, value] of url.searchParams) {\n const current = result[key];\n if (current === undefined) {\n result[key] = value;\n } else if (Array.isArray(current)) {\n current.push(value);\n } else {\n result[key] = [current, value];\n }\n }\n return result;\n}\n\nasync function runValidation(\n schema: GiriInputSchema,\n value: unknown,\n label: string,\n): Promise<InputValidationResult> {\n if (!isGiriInputSchema(schema)) {\n throw new Error(\n `giri: ${label} schema must be wrapped with a validator, e.g. \\`export const ${label} = zod(...)\\` from @boon4681/giri/validators/zod.`,\n );\n }\n return schema.validate(value);\n}\n\nexport async function prepareRequestInput(request: Request, input?: RouteInput): Promise<PreparedRequestInput> {\n const validated: ValidatedInput = {};\n\n if (input?.query) {\n const query = queryObject(new URL(request.url));\n const result = await runValidation(input.query, query, 'query');\n if (!result.ok) {\n return {\n ok: false,\n response: createTypedResponse(\n { message: 'Invalid query parameters.', issues: result.issues },\n 400,\n 'json',\n ),\n };\n }\n validated.query = result.value;\n }\n\n if (input?.body) {\n const contents = input.body.contents as Record<BodyContentType, GiriInputSchema>;\n const declared = Object.keys(contents) as BodyContentType[];\n const requested = contentTypeFromHeader(request.headers.get('content-type'));\n // Pick the schema matching the request's content-type; fall back to JSON when the\n // header is missing/unrecognized but JSON is on offer (so header-less posts still work).\n const chosen: BodyContentType | undefined =\n requested && contents[requested] ? requested : contents.json ? 'json' : undefined;\n\n if (!chosen) {\n return {\n ok: false,\n response: createTypedResponse(\n { message: 'Unsupported media type.', issues: { accepted: declared } },\n 415,\n 'json',\n ),\n };\n }\n\n let rawBody: unknown;\n try {\n rawBody = await readRawBody(request, chosen);\n } catch (error) {\n return {\n ok: false,\n response: createTypedResponse(\n { message: 'Invalid request body.', issues: error },\n 400,\n 'json',\n ),\n };\n }\n\n const result = await runValidation(contents[chosen], rawBody, 'body');\n if (!result.ok) {\n return {\n ok: false,\n response: createTypedResponse(\n { message: 'Invalid request body.', issues: result.issues },\n 400,\n 'json',\n ),\n };\n }\n\n validated.body = declared.length > 1 ? { type: chosen, data: result.value } : result.value;\n }\n\n return { ok: true, validated };\n}\n"],"mappings":"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","names":["serveNode"]}
|
package/dist/cli.d.ts
ADDED
|
@@ -0,0 +1 @@
|
|
|
1
|
+
#!/usr/bin/env node
|