@request-shield/server 0.0.0-stage → 0.3.0
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 +95 -2
- package/dist/cors.d.ts +25 -0
- package/dist/cors.d.ts.map +1 -0
- package/dist/cors.js +46 -0
- package/dist/cors.js.map +1 -0
- package/dist/express.d.ts +33 -0
- package/dist/express.d.ts.map +1 -0
- package/dist/express.js +81 -0
- package/dist/express.js.map +1 -0
- package/dist/fastify.d.ts +31 -0
- package/dist/fastify.d.ts.map +1 -0
- package/dist/fastify.js +58 -0
- package/dist/fastify.js.map +1 -0
- package/dist/hono.d.ts +31 -0
- package/dist/hono.d.ts.map +1 -0
- package/dist/hono.js +35 -0
- package/dist/hono.js.map +1 -0
- package/dist/index.d.ts +118 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +274 -0
- package/dist/index.js.map +1 -0
- package/dist/nestjs.d.ts +28 -0
- package/dist/nestjs.d.ts.map +1 -0
- package/dist/nestjs.js +70 -0
- package/dist/nestjs.js.map +1 -0
- package/dist/node.d.ts +22 -0
- package/dist/node.d.ts.map +1 -0
- package/dist/node.js +76 -0
- package/dist/node.js.map +1 -0
- package/dist/redis.d.ts +30 -0
- package/dist/redis.d.ts.map +1 -0
- package/dist/redis.js +33 -0
- package/dist/redis.js.map +1 -0
- package/package.json +84 -4
package/LICENSE
ADDED
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2026 karammm
|
|
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
CHANGED
|
@@ -1,3 +1,96 @@
|
|
|
1
|
-
#
|
|
1
|
+
# @request-shield/server
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
Server-side verifier for [request-shield](https://github.com/karammm/request-shield). Rejects API requests that are
|
|
4
|
+
replayed, edited, sent late or not signed by your real app. It's built on Web standards (WebCrypto and the Fetch API),
|
|
5
|
+
so it runs on **Node 20+, Express, Fastify, Hono, NestJS, Bun, Deno and Cloudflare Workers**.
|
|
6
|
+
|
|
7
|
+
**[Live demo](https://karammm.github.io/request-shield/)**
|
|
8
|
+
|
|
9
|
+
```bash
|
|
10
|
+
npm install @request-shield/server
|
|
11
|
+
```
|
|
12
|
+
|
|
13
|
+
### Express
|
|
14
|
+
|
|
15
|
+
```ts
|
|
16
|
+
import express from 'express';
|
|
17
|
+
import { createShieldServer, turnstileVerifier } from '@request-shield/server';
|
|
18
|
+
import { expressShield } from '@request-shield/server/express';
|
|
19
|
+
|
|
20
|
+
const shield = expressShield(createShieldServer({
|
|
21
|
+
allowedOrigins: ['https://app.example.com'],
|
|
22
|
+
verifyAttestation: turnstileVerifier({ secret: process.env.TURNSTILE_SECRET! }),
|
|
23
|
+
}));
|
|
24
|
+
|
|
25
|
+
app.post('/shield/register', shield.register);
|
|
26
|
+
app.use('/api', shield.protect); // mount before express.json(); it parses JSON for you
|
|
27
|
+
app.post('/api/orders', (req, res) => { req.body; req.rawBody; req.shieldSession; });
|
|
28
|
+
```
|
|
29
|
+
|
|
30
|
+
### Fastify
|
|
31
|
+
|
|
32
|
+
```ts
|
|
33
|
+
import { fastifyShield } from '@request-shield/server/fastify';
|
|
34
|
+
const shield = fastifyShield(createShieldServer({ ... }));
|
|
35
|
+
app.post('/shield/register', shield.register);
|
|
36
|
+
app.register(async (api) => {
|
|
37
|
+
await api.register(shield.protect); // every route in this scope is protected
|
|
38
|
+
api.post('/orders', async (req) => req.body); // also req.files, req.rawBody, req.shieldSession
|
|
39
|
+
}, { prefix: '/api' });
|
|
40
|
+
```
|
|
41
|
+
|
|
42
|
+
### Hono
|
|
43
|
+
|
|
44
|
+
```ts
|
|
45
|
+
import { honoShield, honoCors } from '@request-shield/server/hono';
|
|
46
|
+
const shield = honoShield(createShieldServer({ ... }));
|
|
47
|
+
app.use('*', honoCors({ allowedOrigins }));
|
|
48
|
+
app.post('/shield/register', shield.register);
|
|
49
|
+
app.use('/api/*', shield.protect);
|
|
50
|
+
app.post('/api/orders', async (c) => c.json(await c.req.json())); // c.get('shieldSession')
|
|
51
|
+
```
|
|
52
|
+
|
|
53
|
+
### NestJS
|
|
54
|
+
|
|
55
|
+
```ts
|
|
56
|
+
import { ShieldGuard } from '@request-shield/server/nestjs';
|
|
57
|
+
import { expressShield } from '@request-shield/server/express';
|
|
58
|
+
const app = await NestFactory.create(AppModule, { rawBody: true }); // rawBody is required
|
|
59
|
+
const server = createShieldServer({ ... });
|
|
60
|
+
app.use('/shield/register', expressShield(server).register);
|
|
61
|
+
app.useGlobalGuards(new ShieldGuard(server, { exclude: (req) => req.url === '/health' }));
|
|
62
|
+
```
|
|
63
|
+
|
|
64
|
+
### File uploads
|
|
65
|
+
|
|
66
|
+
Clients sign `FormData` automatically. Uploaded files arrive as web `File` objects in `req.files` (Express, Fastify,
|
|
67
|
+
NestJS), through `c.req.parseBody()` (Hono), or `await result.formData()` (Fetch API). Default limit 10 MB (`maxBodyBytes`).
|
|
68
|
+
|
|
69
|
+
### Cloudflare Workers / Bun / Deno (Fetch API)
|
|
70
|
+
|
|
71
|
+
```ts
|
|
72
|
+
const shield = createShieldServer({ allowedOrigins: [...], verifyAttestation: turnstileVerifier({ secret }) });
|
|
73
|
+
|
|
74
|
+
export default {
|
|
75
|
+
async fetch(request: Request) {
|
|
76
|
+
if (new URL(request.url).pathname === '/shield/register') return shield.register(request);
|
|
77
|
+
const v = await shield.verify(request);
|
|
78
|
+
if (!v.ok) return v.response; // 401 with X-Shield-Error: replay | signature | skew | …
|
|
79
|
+
const body = v.body; // exact request bytes (the stream has been read)
|
|
80
|
+
// ...your handler
|
|
81
|
+
},
|
|
82
|
+
};
|
|
83
|
+
```
|
|
84
|
+
|
|
85
|
+
**CORS:** `app.use(expressCors({ allowedOrigins }))`, or wrap a Fetch handler: `withCors(handler, { allowedOrigins })`.
|
|
86
|
+
The `X-Shield-*` headers are allowed and `X-Shield-Error` is exposed for you.
|
|
87
|
+
|
|
88
|
+
**More than one instance:** share sessions and nonces through Redis:
|
|
89
|
+
```ts
|
|
90
|
+
import { RedisShieldStore, nodeRedis, ioredis } from '@request-shield/server/redis';
|
|
91
|
+
createShieldServer({ store: new RedisShieldStore(nodeRedis(redisClient)), ... }); // or ioredis(client)
|
|
92
|
+
```
|
|
93
|
+
The client side is [`@request-shield/angular`](https://www.npmjs.com/package/@request-shield/angular),
|
|
94
|
+
[`@request-shield/react`](https://www.npmjs.com/package/@request-shield/react) or
|
|
95
|
+
[`@request-shield/core`](https://www.npmjs.com/package/@request-shield/core).
|
|
96
|
+
[Full documentation](https://github.com/karammm/request-shield#readme).
|
package/dist/cors.d.ts
ADDED
|
@@ -0,0 +1,25 @@
|
|
|
1
|
+
/** The shield headers are always allowed on requests, and X-Shield-Error is always exposed on responses. */
|
|
2
|
+
export interface CorsOptions {
|
|
3
|
+
allowedOrigins: string[];
|
|
4
|
+
/** Extra request headers. Default: Content-Type, Authorization. */
|
|
5
|
+
allowHeaders?: string[];
|
|
6
|
+
/** Default: GET, POST, PUT, PATCH, DELETE, OPTIONS. */
|
|
7
|
+
allowMethods?: string[];
|
|
8
|
+
exposeHeaders?: string[];
|
|
9
|
+
allowCredentials?: boolean;
|
|
10
|
+
/** Preflight cache in seconds. Default 600. */
|
|
11
|
+
maxAge?: number;
|
|
12
|
+
}
|
|
13
|
+
export interface CorsResult {
|
|
14
|
+
/** True for a preflight (OPTIONS + Access-Control-Request-Method): answer 204 with `headers` and stop. */
|
|
15
|
+
preflight: boolean;
|
|
16
|
+
headers: Record<string, string>;
|
|
17
|
+
}
|
|
18
|
+
/** Framework-neutral: compute the CORS headers for a request. */
|
|
19
|
+
export declare function corsHeaders(method: string, origin: string | null | undefined, requestMethodHeader: string | null | undefined, options: CorsOptions): CorsResult;
|
|
20
|
+
/**
|
|
21
|
+
* Wrap a Fetch-API handler (Cloudflare Workers, Bun, Deno) with CORS.
|
|
22
|
+
* export default { fetch: withCors(handler, { allowedOrigins: ['https://app.example.com'] }) }
|
|
23
|
+
*/
|
|
24
|
+
export declare function withCors<A extends unknown[]>(handler: (request: Request, ...rest: A) => Response | Promise<Response>, options: CorsOptions): (request: Request, ...rest: A) => Promise<Response>;
|
|
25
|
+
//# sourceMappingURL=cors.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"cors.d.ts","sourceRoot":"","sources":["../src/cors.ts"],"names":[],"mappings":"AAEA,4GAA4G;AAC5G,MAAM,WAAW,WAAW;IAC1B,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,mEAAmE;IACnE,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,uDAAuD;IACvD,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,+CAA+C;IAC/C,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,UAAU;IACzB,0GAA0G;IAC1G,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACjC;AAED,iEAAiE;AACjE,wBAAgB,WAAW,CACzB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EACjC,mBAAmB,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAC9C,OAAO,EAAE,WAAW,GACnB,UAAU,CAmBZ;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,CAAC,SAAS,OAAO,EAAE,EAC1C,OAAO,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,IAAI,EAAE,CAAC,KAAK,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,EACvE,OAAO,EAAE,WAAW,GACnB,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC,QAAQ,CAAC,CAkBrD"}
|
package/dist/cors.js
ADDED
|
@@ -0,0 +1,46 @@
|
|
|
1
|
+
import { SHIELD_ERROR_HEADER, SHIELD_HEADERS } from '@request-shield/core';
|
|
2
|
+
/** Framework-neutral: compute the CORS headers for a request. */
|
|
3
|
+
export function corsHeaders(method, origin, requestMethodHeader, options) {
|
|
4
|
+
const headers = {};
|
|
5
|
+
const allowed = !!origin && options.allowedOrigins.includes(origin);
|
|
6
|
+
if (origin)
|
|
7
|
+
headers['Vary'] = 'Origin';
|
|
8
|
+
if (allowed) {
|
|
9
|
+
headers['Access-Control-Allow-Origin'] = origin;
|
|
10
|
+
headers['Access-Control-Expose-Headers'] = [SHIELD_ERROR_HEADER, ...(options.exposeHeaders ?? [])].join(', ');
|
|
11
|
+
if (options.allowCredentials)
|
|
12
|
+
headers['Access-Control-Allow-Credentials'] = 'true';
|
|
13
|
+
}
|
|
14
|
+
const preflight = method.toUpperCase() === 'OPTIONS' && !!requestMethodHeader;
|
|
15
|
+
if (preflight && allowed) {
|
|
16
|
+
headers['Access-Control-Allow-Methods'] = (options.allowMethods ?? ['GET', 'POST', 'PUT', 'PATCH', 'DELETE', 'OPTIONS']).join(', ');
|
|
17
|
+
headers['Access-Control-Allow-Headers'] = [
|
|
18
|
+
...(options.allowHeaders ?? ['Content-Type', 'Authorization']),
|
|
19
|
+
...Object.values(SHIELD_HEADERS),
|
|
20
|
+
].join(', ');
|
|
21
|
+
headers['Access-Control-Max-Age'] = String(options.maxAge ?? 600);
|
|
22
|
+
}
|
|
23
|
+
return { preflight, headers };
|
|
24
|
+
}
|
|
25
|
+
/**
|
|
26
|
+
* Wrap a Fetch-API handler (Cloudflare Workers, Bun, Deno) with CORS.
|
|
27
|
+
* export default { fetch: withCors(handler, { allowedOrigins: ['https://app.example.com'] }) }
|
|
28
|
+
*/
|
|
29
|
+
export function withCors(handler, options) {
|
|
30
|
+
return async (request, ...rest) => {
|
|
31
|
+
const { preflight, headers } = corsHeaders(request.method, request.headers.get('origin'), request.headers.get('access-control-request-method'), options);
|
|
32
|
+
if (preflight)
|
|
33
|
+
return new Response(null, { status: 204, headers });
|
|
34
|
+
const res = await handler(request, ...rest);
|
|
35
|
+
// Responses from fetch() have immutable headers; copy into a new Response.
|
|
36
|
+
const out = new Response(res.body, res);
|
|
37
|
+
for (const [k, v] of Object.entries(headers)) {
|
|
38
|
+
if (k === 'Vary')
|
|
39
|
+
out.headers.append(k, v);
|
|
40
|
+
else
|
|
41
|
+
out.headers.set(k, v);
|
|
42
|
+
}
|
|
43
|
+
return out;
|
|
44
|
+
};
|
|
45
|
+
}
|
|
46
|
+
//# sourceMappingURL=cors.js.map
|
package/dist/cors.js.map
ADDED
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"cors.js","sourceRoot":"","sources":["../src/cors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAqB3E,iEAAiE;AACjE,MAAM,UAAU,WAAW,CACzB,MAAc,EACd,MAAiC,EACjC,mBAA8C,EAC9C,OAAoB;IAEpB,MAAM,OAAO,GAA2B,EAAE,CAAC;IAC3C,MAAM,OAAO,GAAG,CAAC,CAAC,MAAM,IAAI,OAAO,CAAC,cAAc,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IACpE,IAAI,MAAM;QAAE,OAAO,CAAC,MAAM,CAAC,GAAG,QAAQ,CAAC;IACvC,IAAI,OAAO,EAAE,CAAC;QACZ,OAAO,CAAC,6BAA6B,CAAC,GAAG,MAAO,CAAC;QACjD,OAAO,CAAC,+BAA+B,CAAC,GAAG,CAAC,mBAAmB,EAAE,GAAG,CAAC,OAAO,CAAC,aAAa,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC9G,IAAI,OAAO,CAAC,gBAAgB;YAAE,OAAO,CAAC,kCAAkC,CAAC,GAAG,MAAM,CAAC;IACrF,CAAC;IACD,MAAM,SAAS,GAAG,MAAM,CAAC,WAAW,EAAE,KAAK,SAAS,IAAI,CAAC,CAAC,mBAAmB,CAAC;IAC9E,IAAI,SAAS,IAAI,OAAO,EAAE,CAAC;QACzB,OAAO,CAAC,8BAA8B,CAAC,GAAG,CAAC,OAAO,CAAC,YAAY,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACpI,OAAO,CAAC,8BAA8B,CAAC,GAAG;YACxC,GAAG,CAAC,OAAO,CAAC,YAAY,IAAI,CAAC,cAAc,EAAE,eAAe,CAAC,CAAC;YAC9D,GAAG,MAAM,CAAC,MAAM,CAAC,cAAc,CAAC;SACjC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACb,OAAO,CAAC,wBAAwB,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,IAAI,GAAG,CAAC,CAAC;IACpE,CAAC;IACD,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC;AAChC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,QAAQ,CACtB,OAAuE,EACvE,OAAoB;IAEpB,OAAO,KAAK,EAAE,OAAO,EAAE,GAAG,IAAI,EAAE,EAAE;QAChC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,GAAG,WAAW,CACxC,OAAO,CAAC,MAAM,EACd,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,EAC7B,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,+BAA+B,CAAC,EACpD,OAAO,CACR,CAAC;QACF,IAAI,SAAS;YAAE,OAAO,IAAI,QAAQ,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC,CAAC;QACnE,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC;QAC5C,2EAA2E;QAC3E,MAAM,GAAG,GAAG,IAAI,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;QACxC,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;YAC7C,IAAI,CAAC,KAAK,MAAM;gBAAE,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;;gBACtC,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QAC7B,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC,CAAC;AACJ,CAAC"}
|
|
@@ -0,0 +1,33 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Express / Node `http` adapter.
|
|
3
|
+
*
|
|
4
|
+
* import express from 'express';
|
|
5
|
+
* import { createShieldServer } from '@request-shield/server';
|
|
6
|
+
* import { expressShield, expressCors } from '@request-shield/server/express';
|
|
7
|
+
*
|
|
8
|
+
* const shield = expressShield(createShieldServer({ allowedOrigins: [...], verifyAttestation }));
|
|
9
|
+
* app.use(expressCors({ allowedOrigins: [...] }));
|
|
10
|
+
* app.post('/shield/register', shield.register);
|
|
11
|
+
* app.use('/api', shield.protect); // mount BEFORE express.json(); it parses the body for you
|
|
12
|
+
*
|
|
13
|
+
* Inside protected routes: req.body (parsed JSON, form fields, or text), req.files (uploads, as web File objects),
|
|
14
|
+
* req.rawBody (exact bytes), req.shieldSession.
|
|
15
|
+
*/
|
|
16
|
+
import type { ShieldServer } from './index.js';
|
|
17
|
+
import { type CorsOptions } from './cors.js';
|
|
18
|
+
type Req = any;
|
|
19
|
+
type Res = any;
|
|
20
|
+
type Next = (err?: unknown) => void;
|
|
21
|
+
export declare function expressShield(shield: ShieldServer, options?: {
|
|
22
|
+
maxBodyBytes?: number;
|
|
23
|
+
}): {
|
|
24
|
+
register: (req: Req, res: Res, next: Next) => Promise<void>;
|
|
25
|
+
protect: (req: Req, res: Res, next: Next) => Promise<any>;
|
|
26
|
+
};
|
|
27
|
+
/**
|
|
28
|
+
* CORS for Express with the shield headers already allowed/exposed.
|
|
29
|
+
* app.use(expressCors({ allowedOrigins: ['https://app.example.com'] }));
|
|
30
|
+
*/
|
|
31
|
+
export declare function expressCors(options: CorsOptions): (req: Req, res: Res, next: Next) => any;
|
|
32
|
+
export {};
|
|
33
|
+
//# sourceMappingURL=express.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"express.d.ts","sourceRoot":"","sources":["../src/express.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,EAAe,KAAK,WAAW,EAAE,MAAM,WAAW,CAAC;AAI1D,KAAK,GAAG,GAAG,GAAG,CAAC;AACf,KAAK,GAAG,GAAG,GAAG,CAAC;AACf,KAAK,IAAI,GAAG,CAAC,GAAG,CAAC,EAAE,OAAO,KAAK,IAAI,CAAC;AAuBpC,wBAAgB,aAAa,CAAC,MAAM,EAAE,YAAY,EAAE,OAAO,GAAE;IAAE,YAAY,CAAC,EAAE,MAAM,CAAA;CAAO;oBAG5D,GAAG,OAAO,GAAG,QAAQ,IAAI;mBAS1B,GAAG,OAAO,GAAG,QAAQ,IAAI;EAyBtD;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,WAAW,IACtC,KAAK,GAAG,EAAE,KAAK,GAAG,EAAE,MAAM,IAAI,SAYvC"}
|
package/dist/express.js
ADDED
|
@@ -0,0 +1,81 @@
|
|
|
1
|
+
import { corsHeaders } from './cors.js';
|
|
2
|
+
import { decodeBody, readStream, toNodeBuffer, toShieldRequest } from './node.js';
|
|
3
|
+
async function readBody(req, limit) {
|
|
4
|
+
if (req.rawBody instanceof Uint8Array)
|
|
5
|
+
return req.rawBody; // NestJS rawBody, or express.json({ verify })
|
|
6
|
+
if (req.body instanceof Uint8Array)
|
|
7
|
+
return req.body; // express.raw()
|
|
8
|
+
if (req._body || req.readableEnded) {
|
|
9
|
+
throw new Error('request-shield: the request body was already consumed by another parser. Mount shield.protect before express.json(), ' +
|
|
10
|
+
'or use express.json({ verify: (req, _res, buf) => { req.rawBody = buf } }).');
|
|
11
|
+
}
|
|
12
|
+
return readStream(req, limit);
|
|
13
|
+
}
|
|
14
|
+
/** originalUrl keeps the full path even when the middleware is mounted under a prefix. */
|
|
15
|
+
const pathOf = (req) => req.originalUrl ?? req.url;
|
|
16
|
+
async function send(res, response) {
|
|
17
|
+
res.statusCode = response.status;
|
|
18
|
+
response.headers.forEach((v, k) => res.setHeader(k, v));
|
|
19
|
+
res.end(new Uint8Array(await response.arrayBuffer()));
|
|
20
|
+
}
|
|
21
|
+
export function expressShield(shield, options = {}) {
|
|
22
|
+
const limit = options.maxBodyBytes ?? 10 * 1024 * 1024;
|
|
23
|
+
const register = async (req, res, next) => {
|
|
24
|
+
try {
|
|
25
|
+
const body = await readBody(req, 64 * 1024);
|
|
26
|
+
await send(res, await shield.register(toShieldRequest(req.method, pathOf(req), req.headers, body)));
|
|
27
|
+
}
|
|
28
|
+
catch (e) {
|
|
29
|
+
next(e);
|
|
30
|
+
}
|
|
31
|
+
};
|
|
32
|
+
const protect = async (req, res, next) => {
|
|
33
|
+
if (req.method === 'OPTIONS')
|
|
34
|
+
return next();
|
|
35
|
+
try {
|
|
36
|
+
const bytes = await readBody(req, limit);
|
|
37
|
+
const result = await shield.verify(toShieldRequest(req.method, pathOf(req), req.headers, bytes));
|
|
38
|
+
if (!result.ok)
|
|
39
|
+
return send(res, result.response);
|
|
40
|
+
req.rawBody = toNodeBuffer(result.body);
|
|
41
|
+
req.shieldSession = result.session;
|
|
42
|
+
req._body = true; // tell body-parser the body is already handled
|
|
43
|
+
try {
|
|
44
|
+
const decoded = await decodeBody(result.body, String(req.headers['content-type'] ?? ''), result.formData);
|
|
45
|
+
req.body = decoded.body;
|
|
46
|
+
if (decoded.files)
|
|
47
|
+
req.files = decoded.files;
|
|
48
|
+
}
|
|
49
|
+
catch {
|
|
50
|
+
res.statusCode = 400;
|
|
51
|
+
return res.end('invalid request body');
|
|
52
|
+
}
|
|
53
|
+
next();
|
|
54
|
+
}
|
|
55
|
+
catch (e) {
|
|
56
|
+
next(e);
|
|
57
|
+
}
|
|
58
|
+
};
|
|
59
|
+
return { register, protect };
|
|
60
|
+
}
|
|
61
|
+
/**
|
|
62
|
+
* CORS for Express with the shield headers already allowed/exposed.
|
|
63
|
+
* app.use(expressCors({ allowedOrigins: ['https://app.example.com'] }));
|
|
64
|
+
*/
|
|
65
|
+
export function expressCors(options) {
|
|
66
|
+
return (req, res, next) => {
|
|
67
|
+
const { preflight, headers } = corsHeaders(req.method, req.headers.origin, req.headers['access-control-request-method'], options);
|
|
68
|
+
for (const [k, v] of Object.entries(headers)) {
|
|
69
|
+
if (k === 'Vary')
|
|
70
|
+
res.setHeader('Vary', [res.getHeader('Vary'), v].filter(Boolean).join(', '));
|
|
71
|
+
else
|
|
72
|
+
res.setHeader(k, v);
|
|
73
|
+
}
|
|
74
|
+
if (preflight) {
|
|
75
|
+
res.statusCode = 204;
|
|
76
|
+
return res.end();
|
|
77
|
+
}
|
|
78
|
+
next();
|
|
79
|
+
};
|
|
80
|
+
}
|
|
81
|
+
//# sourceMappingURL=express.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"express.js","sourceRoot":"","sources":["../src/express.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,31 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Fastify adapter.
|
|
3
|
+
*
|
|
4
|
+
* import Fastify from 'fastify';
|
|
5
|
+
* import { fastifyShield } from '@request-shield/server/fastify';
|
|
6
|
+
*
|
|
7
|
+
* const shield = fastifyShield(createShieldServer({ allowedOrigins: [...], verifyAttestation }));
|
|
8
|
+
* app.post('/shield/register', shield.register);
|
|
9
|
+
* app.register(async (api) => {
|
|
10
|
+
* await api.register(shield.protect); // applies to every route in this scope
|
|
11
|
+
* api.post('/orders', async (req) => { req.body; req.files; req.shieldSession; });
|
|
12
|
+
* }, { prefix: '/api' });
|
|
13
|
+
*
|
|
14
|
+
* `protect` replaces the scope's body parsers with a raw-bytes parser (the signature covers exact bytes),
|
|
15
|
+
* then decodes the verified body for you: JSON → object, forms/uploads → fields + req.files, otherwise text.
|
|
16
|
+
*/
|
|
17
|
+
import type { ShieldServer } from './index.js';
|
|
18
|
+
import { type CorsOptions } from './cors.js';
|
|
19
|
+
type Instance = any;
|
|
20
|
+
type Request = any;
|
|
21
|
+
type Reply = any;
|
|
22
|
+
export declare function fastifyShield(shield: ShieldServer, options?: {
|
|
23
|
+
maxBodyBytes?: number;
|
|
24
|
+
}): {
|
|
25
|
+
register: (request: Request, reply: Reply) => Promise<any>;
|
|
26
|
+
protect: (scope: Instance) => Promise<void>;
|
|
27
|
+
};
|
|
28
|
+
/** CORS hook with the shield headers allowed and X-Shield-Error exposed: `app.addHook('onRequest', fastifyCors({...}))`. */
|
|
29
|
+
export declare function fastifyCors(options: CorsOptions): (request: Request, reply: Reply) => Promise<any>;
|
|
30
|
+
export {};
|
|
31
|
+
//# sourceMappingURL=fastify.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"fastify.d.ts","sourceRoot":"","sources":["../src/fastify.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,EAAe,KAAK,WAAW,EAAE,MAAM,WAAW,CAAC;AAI1D,KAAK,QAAQ,GAAG,GAAG,CAAC;AACpB,KAAK,OAAO,GAAG,GAAG,CAAC;AACnB,KAAK,KAAK,GAAG,GAAG,CAAC;AAgBjB,wBAAgB,aAAa,CAAC,MAAM,EAAE,YAAY,EAAE,OAAO,GAAE;IAAE,YAAY,CAAC,EAAE,MAAM,CAAA;CAAO;wBAGxD,OAAO,SAAS,KAAK;qBAGxB,QAAQ;EA2BvC;AAED,4HAA4H;AAC5H,wBAAgB,WAAW,CAAC,OAAO,EAAE,WAAW,IAChC,SAAS,OAAO,EAAE,OAAO,KAAK,kBAU7C"}
|
package/dist/fastify.js
ADDED
|
@@ -0,0 +1,58 @@
|
|
|
1
|
+
import { corsHeaders } from './cors.js';
|
|
2
|
+
import { decodeBody, toNodeBuffer, toShieldRequest } from './node.js';
|
|
3
|
+
async function send(reply, response) {
|
|
4
|
+
const headers = {};
|
|
5
|
+
response.headers.forEach((v, k) => (headers[k] = v));
|
|
6
|
+
return reply.code(response.status).headers(headers).send(toNodeBuffer(new Uint8Array(await response.arrayBuffer())));
|
|
7
|
+
}
|
|
8
|
+
function bodyBytes(body) {
|
|
9
|
+
if (body instanceof Uint8Array)
|
|
10
|
+
return body;
|
|
11
|
+
if (body === undefined || body === null)
|
|
12
|
+
return new Uint8Array();
|
|
13
|
+
if (typeof body === 'string')
|
|
14
|
+
return new TextEncoder().encode(body);
|
|
15
|
+
// Parsed by Fastify's default JSON parser (register route outside the protected scope).
|
|
16
|
+
return new TextEncoder().encode(JSON.stringify(body));
|
|
17
|
+
}
|
|
18
|
+
export function fastifyShield(shield, options = {}) {
|
|
19
|
+
const bodyLimit = options.maxBodyBytes ?? 10 * 1024 * 1024;
|
|
20
|
+
const register = async (request, reply) => send(reply, await shield.register(toShieldRequest(request.method, request.raw.url, request.headers, bodyBytes(request.body))));
|
|
21
|
+
async function protect(scope) {
|
|
22
|
+
scope.removeAllContentTypeParsers();
|
|
23
|
+
scope.addContentTypeParser('*', { parseAs: 'buffer', bodyLimit }, (_req, body, done) => done(null, body));
|
|
24
|
+
scope.addHook('preHandler', async (request, reply) => {
|
|
25
|
+
if (request.method === 'OPTIONS')
|
|
26
|
+
return;
|
|
27
|
+
const bytes = bodyBytes(request.body);
|
|
28
|
+
const result = await shield.verify(toShieldRequest(request.method, request.raw.url, request.headers, bytes));
|
|
29
|
+
if (!result.ok)
|
|
30
|
+
return send(reply, result.response);
|
|
31
|
+
request.rawBody = toNodeBuffer(result.body);
|
|
32
|
+
request.shieldSession = result.session;
|
|
33
|
+
try {
|
|
34
|
+
const decoded = await decodeBody(result.body, String(request.headers['content-type'] ?? ''), result.formData);
|
|
35
|
+
request.body = decoded.body;
|
|
36
|
+
if (decoded.files)
|
|
37
|
+
request.files = decoded.files;
|
|
38
|
+
}
|
|
39
|
+
catch {
|
|
40
|
+
return reply.code(400).send({ error: 'invalid request body' });
|
|
41
|
+
}
|
|
42
|
+
});
|
|
43
|
+
}
|
|
44
|
+
// Like fastify-plugin: apply the hook and parser to the scope that registers this plugin.
|
|
45
|
+
protect[Symbol.for('skip-override')] = true;
|
|
46
|
+
protect[Symbol.for('fastify.display-name')] = 'request-shield';
|
|
47
|
+
return { register, protect };
|
|
48
|
+
}
|
|
49
|
+
/** CORS hook with the shield headers allowed and X-Shield-Error exposed: `app.addHook('onRequest', fastifyCors({...}))`. */
|
|
50
|
+
export function fastifyCors(options) {
|
|
51
|
+
return async (request, reply) => {
|
|
52
|
+
const { preflight, headers } = corsHeaders(request.method, request.headers.origin, request.headers['access-control-request-method'], options);
|
|
53
|
+
reply.headers(headers);
|
|
54
|
+
if (preflight)
|
|
55
|
+
return reply.code(204).send();
|
|
56
|
+
};
|
|
57
|
+
}
|
|
58
|
+
//# sourceMappingURL=fastify.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"fastify.js","sourceRoot":"","sources":["../src/fastify.ts"],"names":[],"mappings":"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"}
|
package/dist/hono.d.ts
ADDED
|
@@ -0,0 +1,31 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Hono adapter (Cloudflare Workers, Bun, Deno, Node).
|
|
3
|
+
*
|
|
4
|
+
* import { Hono } from 'hono';
|
|
5
|
+
* import { honoShield, honoCors } from '@request-shield/server/hono';
|
|
6
|
+
*
|
|
7
|
+
* const shield = honoShield(createShieldServer({ allowedOrigins: [...], verifyAttestation }));
|
|
8
|
+
* app.use('*', honoCors({ allowedOrigins: [...] }));
|
|
9
|
+
* app.post('/shield/register', shield.register);
|
|
10
|
+
* app.use('/api/*', shield.protect);
|
|
11
|
+
* app.post('/api/orders', async (c) => {
|
|
12
|
+
* const order = await c.req.json(); // body reading still works (Hono caches it)
|
|
13
|
+
* const session = c.get('shieldSession');
|
|
14
|
+
* });
|
|
15
|
+
*/
|
|
16
|
+
import type { ShieldServer, StoredSession } from './index.js';
|
|
17
|
+
import { type CorsOptions } from './cors.js';
|
|
18
|
+
type Ctx = any;
|
|
19
|
+
type Next = () => Promise<void>;
|
|
20
|
+
/** Declare on your app for typed access: `new Hono<{ Variables: ShieldVariables }>()`. */
|
|
21
|
+
export type ShieldVariables = {
|
|
22
|
+
shieldSession: StoredSession;
|
|
23
|
+
};
|
|
24
|
+
export declare function honoShield(shield: ShieldServer): {
|
|
25
|
+
register: (c: Ctx) => Promise<Response>;
|
|
26
|
+
protect: (c: Ctx, next: Next) => Promise<void | Response>;
|
|
27
|
+
};
|
|
28
|
+
/** CORS middleware with the shield headers allowed and X-Shield-Error exposed. */
|
|
29
|
+
export declare function honoCors(options: CorsOptions): (c: Ctx, next: Next) => Promise<Response | undefined>;
|
|
30
|
+
export {};
|
|
31
|
+
//# sourceMappingURL=hono.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"hono.d.ts","sourceRoot":"","sources":["../src/hono.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,KAAK,EAAiB,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC7E,OAAO,EAAe,KAAK,WAAW,EAAE,MAAM,WAAW,CAAC;AAI1D,KAAK,GAAG,GAAG,GAAG,CAAC;AACf,KAAK,IAAI,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;AAEhC,0FAA0F;AAC1F,MAAM,MAAM,eAAe,GAAG;IAAE,aAAa,EAAE,aAAa,CAAA;CAAE,CAAC;AAY/D,wBAAgB,UAAU,CAAC,MAAM,EAAE,YAAY;kBACxB,GAAG;iBAEE,GAAG,QAAQ,IAAI;EAS1C;AAED,kFAAkF;AAClF,wBAAgB,QAAQ,CAAC,OAAO,EAAE,WAAW,IAC7B,GAAG,GAAG,EAAE,MAAM,IAAI,mCAWjC"}
|
package/dist/hono.js
ADDED
|
@@ -0,0 +1,35 @@
|
|
|
1
|
+
import { corsHeaders } from './cors.js';
|
|
2
|
+
function fromContext(c) {
|
|
3
|
+
return {
|
|
4
|
+
method: c.req.method,
|
|
5
|
+
url: c.req.url,
|
|
6
|
+
headers: c.req.raw.headers,
|
|
7
|
+
// Read through HonoRequest so the body stays available to c.req.json() / parseBody() later.
|
|
8
|
+
arrayBuffer: () => c.req.arrayBuffer(),
|
|
9
|
+
};
|
|
10
|
+
}
|
|
11
|
+
export function honoShield(shield) {
|
|
12
|
+
const register = (c) => shield.register(fromContext(c));
|
|
13
|
+
const protect = async (c, next) => {
|
|
14
|
+
if (c.req.method === 'OPTIONS')
|
|
15
|
+
return next();
|
|
16
|
+
const result = await shield.verify(fromContext(c));
|
|
17
|
+
if (!result.ok)
|
|
18
|
+
return result.response;
|
|
19
|
+
c.set('shieldSession', result.session);
|
|
20
|
+
await next();
|
|
21
|
+
};
|
|
22
|
+
return { register, protect };
|
|
23
|
+
}
|
|
24
|
+
/** CORS middleware with the shield headers allowed and X-Shield-Error exposed. */
|
|
25
|
+
export function honoCors(options) {
|
|
26
|
+
return async (c, next) => {
|
|
27
|
+
const { preflight, headers } = corsHeaders(c.req.method, c.req.header('origin'), c.req.header('access-control-request-method'), options);
|
|
28
|
+
if (preflight)
|
|
29
|
+
return new Response(null, { status: 204, headers });
|
|
30
|
+
await next();
|
|
31
|
+
for (const [k, v] of Object.entries(headers))
|
|
32
|
+
c.header(k, v, k === 'Vary' ? { append: true } : undefined);
|
|
33
|
+
};
|
|
34
|
+
}
|
|
35
|
+
//# sourceMappingURL=hono.js.map
|
package/dist/hono.js.map
ADDED
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"hono.js","sourceRoot":"","sources":["../src/hono.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAE,WAAW,EAAoB,MAAM,WAAW,CAAC;AAU1D,SAAS,WAAW,CAAC,CAAM;IACzB,OAAO;QACL,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,MAAM;QACpB,GAAG,EAAE,CAAC,CAAC,GAAG,CAAC,GAAG;QACd,OAAO,EAAE,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,OAAO;QAC1B,4FAA4F;QAC5F,WAAW,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,WAAW,EAAE;KACvC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,MAAoB;IAC7C,MAAM,QAAQ,GAAG,CAAC,CAAM,EAAE,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC;IAE7D,MAAM,OAAO,GAAG,KAAK,EAAE,CAAM,EAAE,IAAU,EAAE,EAAE;QAC3C,IAAI,CAAC,CAAC,GAAG,CAAC,MAAM,KAAK,SAAS;YAAE,OAAO,IAAI,EAAE,CAAC;QAC9C,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC;QACnD,IAAI,CAAC,MAAM,CAAC,EAAE;YAAE,OAAO,MAAM,CAAC,QAAQ,CAAC;QACvC,CAAC,CAAC,GAAG,CAAC,eAAe,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;QACvC,MAAM,IAAI,EAAE,CAAC;IACf,CAAC,CAAC;IAEF,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC;AAC/B,CAAC;AAED,kFAAkF;AAClF,MAAM,UAAU,QAAQ,CAAC,OAAoB;IAC3C,OAAO,KAAK,EAAE,CAAM,EAAE,IAAU,EAAE,EAAE;QAClC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,GAAG,WAAW,CACxC,CAAC,CAAC,GAAG,CAAC,MAAM,EACZ,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,EACtB,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,+BAA+B,CAAC,EAC7C,OAAO,CACR,CAAC;QACF,IAAI,SAAS;YAAE,OAAO,IAAI,QAAQ,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC,CAAC;QACnE,MAAM,IAAI,EAAE,CAAC;QACb,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC;YAAE,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,KAAK,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IAC5G,CAAC,CAAC;AACJ,CAAC"}
|
package/dist/index.d.ts
ADDED
|
@@ -0,0 +1,118 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Server-side verifier for @request-shield clients, built on Web standards (WebCrypto + Fetch API types),
|
|
3
|
+
* so it runs on Node 20+, Bun, Deno and Cloudflare Workers. Mirrors the Go verifier in server/go.
|
|
4
|
+
*/
|
|
5
|
+
import { SHIELD_ERROR_HEADER, SHIELD_HEADERS } from '@request-shield/core';
|
|
6
|
+
export { SHIELD_ERROR_HEADER, SHIELD_HEADERS };
|
|
7
|
+
/** Request headers your CORS config must allow. */
|
|
8
|
+
export declare const SHIELD_REQUEST_HEADERS: ("X-Shield-Session" | "X-Shield-Timestamp" | "X-Shield-Nonce" | "X-Shield-Signature")[];
|
|
9
|
+
export type ShieldErrorCode = 'missing' | 'session' | 'skew' | 'signature' | 'replay' | 'body' | 'origin' | 'attestation' | 'bad_request';
|
|
10
|
+
/** Anything shaped like a Fetch `Request`. A real `Request` works as-is. */
|
|
11
|
+
export interface ShieldRequest {
|
|
12
|
+
method: string;
|
|
13
|
+
url: string;
|
|
14
|
+
headers: {
|
|
15
|
+
get(name: string): string | null;
|
|
16
|
+
};
|
|
17
|
+
arrayBuffer(): Promise<ArrayBuffer>;
|
|
18
|
+
}
|
|
19
|
+
export interface PublicKeyJwk {
|
|
20
|
+
kty: string;
|
|
21
|
+
crv: string;
|
|
22
|
+
x: string;
|
|
23
|
+
y: string;
|
|
24
|
+
}
|
|
25
|
+
export interface RegisterRequest {
|
|
26
|
+
publicKey: PublicKeyJwk;
|
|
27
|
+
attestation?: string;
|
|
28
|
+
platform: string;
|
|
29
|
+
}
|
|
30
|
+
export interface StoredSession {
|
|
31
|
+
id: string;
|
|
32
|
+
publicKey: PublicKeyJwk;
|
|
33
|
+
platform: string;
|
|
34
|
+
userAgentHash?: string;
|
|
35
|
+
/** unix ms */
|
|
36
|
+
expiresAt: number;
|
|
37
|
+
}
|
|
38
|
+
/**
|
|
39
|
+
* Sessions + used nonces. The default MemoryShieldStore is per-process; with several
|
|
40
|
+
* instances implement this on Redis (SET key 1 NX PX <ttl> for nonces).
|
|
41
|
+
*/
|
|
42
|
+
export interface ShieldStore {
|
|
43
|
+
saveSession(session: StoredSession, ttlMs: number): Promise<void>;
|
|
44
|
+
getSession(id: string): Promise<StoredSession | null>;
|
|
45
|
+
/** Record the nonce; resolve true if it had not been used before. */
|
|
46
|
+
useNonce(sessionId: string, nonce: string, ttlMs: number): Promise<boolean>;
|
|
47
|
+
}
|
|
48
|
+
export interface ShieldServerConfig {
|
|
49
|
+
/** Origins allowed to register with platform "web". Requests without a matching Origin (cURL) are rejected. */
|
|
50
|
+
allowedOrigins?: string[];
|
|
51
|
+
/** Default ["web"]. Origin is only checked for "web"; other platforms must pass verifyAttestation. */
|
|
52
|
+
allowedPlatforms?: string[];
|
|
53
|
+
/** Throw (or reject) to refuse a registration. Required unless allowNoAttestation is set. */
|
|
54
|
+
verifyAttestation?: (body: RegisterRequest, request: ShieldRequest) => void | Promise<void>;
|
|
55
|
+
/** Local development only: registration without a bot check. */
|
|
56
|
+
allowNoAttestation?: boolean;
|
|
57
|
+
sessionTtlMs?: number;
|
|
58
|
+
maxClockSkewMs?: number;
|
|
59
|
+
maxBodyBytes?: number;
|
|
60
|
+
store?: ShieldStore;
|
|
61
|
+
/** Bind each session to the User-Agent it registered with. Default true. */
|
|
62
|
+
bindUserAgent?: boolean;
|
|
63
|
+
/** The path+query the client signed. Default: pathname + search of request.url. */
|
|
64
|
+
canonicalPath?: (request: ShieldRequest) => string;
|
|
65
|
+
onReject?: (code: ShieldErrorCode, request: ShieldRequest, reason: string) => void;
|
|
66
|
+
/** Clock (unix ms), for tests. */
|
|
67
|
+
now?: () => number;
|
|
68
|
+
}
|
|
69
|
+
export type VerifyResult = {
|
|
70
|
+
ok: true;
|
|
71
|
+
session: StoredSession;
|
|
72
|
+
/** The exact request body bytes (the stream has been read). */
|
|
73
|
+
body: Uint8Array;
|
|
74
|
+
/** Parse a multipart/form-data or urlencoded body (file uploads). */
|
|
75
|
+
formData(): Promise<FormData>;
|
|
76
|
+
} | {
|
|
77
|
+
ok: false;
|
|
78
|
+
code: ShieldErrorCode;
|
|
79
|
+
reason: string;
|
|
80
|
+
response: Response;
|
|
81
|
+
};
|
|
82
|
+
export declare class MemoryShieldStore implements ShieldStore {
|
|
83
|
+
private sessions;
|
|
84
|
+
private nonces;
|
|
85
|
+
private lastSweep;
|
|
86
|
+
saveSession(session: StoredSession): Promise<void>;
|
|
87
|
+
getSession(id: string): Promise<StoredSession | null>;
|
|
88
|
+
useNonce(sessionId: string, nonce: string, ttlMs: number): Promise<boolean>;
|
|
89
|
+
private sweep;
|
|
90
|
+
}
|
|
91
|
+
export declare class ShieldServer {
|
|
92
|
+
private readonly cfg;
|
|
93
|
+
private readonly keyCache;
|
|
94
|
+
constructor(config: ShieldServerConfig);
|
|
95
|
+
private reject;
|
|
96
|
+
/** Handle POST {publicKey, attestation, platform}; returns {sessionId, expiresAt, serverTime}. */
|
|
97
|
+
register(request: ShieldRequest): Promise<Response>;
|
|
98
|
+
/**
|
|
99
|
+
* Verify a signed request. On success you get the session and the exact body bytes
|
|
100
|
+
* (the request body stream has been read, so use `body` instead of reading it again).
|
|
101
|
+
*/
|
|
102
|
+
verify(request: ShieldRequest): Promise<VerifyResult>;
|
|
103
|
+
}
|
|
104
|
+
/** Parse multipart/form-data or application/x-www-form-urlencoded bytes into FormData (uses the platform parser). */
|
|
105
|
+
export declare function parseFormData(body: Uint8Array, contentType: string): Promise<FormData>;
|
|
106
|
+
export declare function createShieldServer(config: ShieldServerConfig): ShieldServer;
|
|
107
|
+
/**
|
|
108
|
+
* Cloudflare Turnstile check for registration.
|
|
109
|
+
* createShieldServer({ verifyAttestation: turnstileVerifier({ secret: env.TURNSTILE_SECRET }) })
|
|
110
|
+
*/
|
|
111
|
+
export declare function turnstileVerifier(options: {
|
|
112
|
+
secret: string;
|
|
113
|
+
hostnames?: string[];
|
|
114
|
+
action?: string;
|
|
115
|
+
fetch?: typeof fetch;
|
|
116
|
+
}): NonNullable<ShieldServerConfig['verifyAttestation']>;
|
|
117
|
+
export { corsHeaders, withCors, type CorsOptions, type CorsResult } from './cors.js';
|
|
118
|
+
//# sourceMappingURL=index.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
|