@request-shield/server 0.0.0-stage → 0.2.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 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,57 @@
1
- # Temporary Holding Version
1
+ # @request-shield/server
2
2
 
3
- This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
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, 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
+ ### Cloudflare Workers / Bun / Deno (Fetch API)
31
+
32
+ ```ts
33
+ const shield = createShieldServer({ allowedOrigins: [...], verifyAttestation: turnstileVerifier({ secret }) });
34
+
35
+ export default {
36
+ async fetch(request: Request) {
37
+ if (new URL(request.url).pathname === '/shield/register') return shield.register(request);
38
+ const v = await shield.verify(request);
39
+ if (!v.ok) return v.response; // 401 with X-Shield-Error: replay | signature | skew | …
40
+ const body = v.body; // exact request bytes (the stream has been read)
41
+ // ...your handler
42
+ },
43
+ };
44
+ ```
45
+
46
+ **CORS:** `app.use(expressCors({ allowedOrigins }))`, or wrap a Fetch handler: `withCors(handler, { allowedOrigins })`.
47
+ The `X-Shield-*` headers are allowed and `X-Shield-Error` is exposed for you.
48
+
49
+ **More than one instance:** share sessions and nonces through Redis:
50
+ ```ts
51
+ import { RedisShieldStore, nodeRedis, ioredis } from '@request-shield/server/redis';
52
+ createShieldServer({ store: new RedisShieldStore(nodeRedis(redisClient)), ... }); // or ioredis(client)
53
+ ```
54
+ The client side is [`@request-shield/angular`](https://www.npmjs.com/package/@request-shield/angular),
55
+ [`@request-shield/react`](https://www.npmjs.com/package/@request-shield/react) or
56
+ [`@request-shield/core`](https://www.npmjs.com/package/@request-shield/core).
57
+ [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
@@ -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,31 @@
1
+ /**
2
+ * Express / Node `http` adapter.
3
+ *
4
+ * import express from 'express';
5
+ * import { createShieldServer } from '@request-shield/server';
6
+ * import { expressShield } from '@request-shield/server/express';
7
+ *
8
+ * const shield = expressShield(createShieldServer({ allowedOrigins: [...], verifyAttestation }));
9
+ * app.post('/shield/register', shield.register);
10
+ * app.use('/api', shield.protect); // mount BEFORE express.json(); it parses JSON for you
11
+ *
12
+ * Inside protected routes: req.body (parsed JSON, or text), req.rawBody (exact bytes), req.shieldSession.
13
+ */
14
+ import type { ShieldServer } from './index.js';
15
+ import { type CorsOptions } from './cors.js';
16
+ type Req = any;
17
+ type Res = any;
18
+ type Next = (err?: unknown) => void;
19
+ export declare function expressShield(shield: ShieldServer, options?: {
20
+ maxBodyBytes?: number;
21
+ }): {
22
+ register: (req: Req, res: Res, next: Next) => Promise<void>;
23
+ protect: (req: Req, res: Res, next: Next) => Promise<any>;
24
+ };
25
+ /**
26
+ * CORS for Express with the shield headers already allowed/exposed.
27
+ * app.use(expressCors({ allowedOrigins: ['https://app.example.com'] }));
28
+ */
29
+ export declare function expressCors(options: CorsOptions): (req: Req, res: Res, next: Next) => any;
30
+ export {};
31
+ //# sourceMappingURL=express.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"express.d.ts","sourceRoot":"","sources":["../src/express.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,KAAK,EAAiB,YAAY,EAAE,MAAM,YAAY,CAAC;AAC9D,OAAO,EAAe,KAAK,WAAW,EAAE,MAAM,WAAW,CAAC;AAG1D,KAAK,GAAG,GAAG,GAAG,CAAC;AACf,KAAK,GAAG,GAAG,GAAG,CAAC;AACf,KAAK,IAAI,GAAG,CAAC,GAAG,CAAC,EAAE,OAAO,KAAK,IAAI,CAAC;AAgDpC,wBAAgB,aAAa,CAAC,MAAM,EAAE,YAAY,EAAE,OAAO,GAAE;IAAE,YAAY,CAAC,EAAE,MAAM,CAAA;CAAO;oBAG5D,GAAG,OAAO,GAAG,QAAQ,IAAI;mBAQ1B,GAAG,OAAO,GAAG,QAAQ,IAAI;EA4BtD;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,WAAW,IACtC,KAAK,GAAG,EAAE,KAAK,GAAG,EAAE,MAAM,IAAI,SAYvC"}
@@ -0,0 +1,109 @@
1
+ import { corsHeaders } from './cors.js';
2
+ async function readBody(req, limit) {
3
+ if (req.rawBody instanceof Uint8Array)
4
+ return req.rawBody;
5
+ if (req.body instanceof Uint8Array)
6
+ return req.body; // express.raw()
7
+ if (req._body || req.readableEnded) {
8
+ throw new Error('request-shield: the request body was already consumed by another parser. Mount shield.protect before express.json(), ' +
9
+ 'or use express.json({ verify: (req, _res, buf) => { req.rawBody = buf } }).');
10
+ }
11
+ const chunks = [];
12
+ let size = 0;
13
+ for await (const chunk of req) {
14
+ size += chunk.length;
15
+ if (size > limit)
16
+ break;
17
+ chunks.push(chunk);
18
+ }
19
+ const out = new Uint8Array(size);
20
+ let offset = 0;
21
+ for (const c of chunks) {
22
+ out.set(c, offset);
23
+ offset += c.length;
24
+ }
25
+ return out;
26
+ }
27
+ function toShieldRequest(req, body) {
28
+ const headers = new Headers();
29
+ for (const [k, v] of Object.entries(req.headers)) {
30
+ if (v !== undefined)
31
+ headers.set(k, Array.isArray(v) ? v.join(', ') : v);
32
+ }
33
+ // originalUrl keeps the full path even when the middleware is mounted under a prefix.
34
+ const path = req.originalUrl ?? req.url;
35
+ return {
36
+ method: req.method,
37
+ url: `http://${req.headers.host ?? 'localhost'}${path}`,
38
+ headers,
39
+ arrayBuffer: async () => body.slice().buffer,
40
+ };
41
+ }
42
+ async function send(res, response) {
43
+ res.statusCode = response.status;
44
+ response.headers.forEach((v, k) => res.setHeader(k, v));
45
+ res.end(new Uint8Array(await response.arrayBuffer()));
46
+ }
47
+ export function expressShield(shield, options = {}) {
48
+ const limit = (options.maxBodyBytes ?? 10 * 1024 * 1024) + 1;
49
+ const register = async (req, res, next) => {
50
+ try {
51
+ await send(res, await shield.register(toShieldRequest(req, await readBody(req, 64 * 1024))));
52
+ }
53
+ catch (e) {
54
+ next(e);
55
+ }
56
+ };
57
+ const protect = async (req, res, next) => {
58
+ if (req.method === 'OPTIONS')
59
+ return next();
60
+ try {
61
+ const result = await shield.verify(toShieldRequest(req, await readBody(req, limit)));
62
+ if (!result.ok)
63
+ return send(res, result.response);
64
+ const B = globalThis.Buffer;
65
+ req.rawBody = B ? B.from(result.body) : result.body;
66
+ req.shieldSession = result.session;
67
+ req._body = true; // tell body-parser the body is already handled
68
+ const text = new TextDecoder().decode(result.body);
69
+ if (result.body.length && /json/i.test(req.headers['content-type'] ?? '')) {
70
+ try {
71
+ req.body = JSON.parse(text);
72
+ }
73
+ catch {
74
+ res.statusCode = 400;
75
+ return res.end('invalid JSON');
76
+ }
77
+ }
78
+ else {
79
+ req.body = result.body.length ? text : undefined;
80
+ }
81
+ next();
82
+ }
83
+ catch (e) {
84
+ next(e);
85
+ }
86
+ };
87
+ return { register, protect };
88
+ }
89
+ /**
90
+ * CORS for Express with the shield headers already allowed/exposed.
91
+ * app.use(expressCors({ allowedOrigins: ['https://app.example.com'] }));
92
+ */
93
+ export function expressCors(options) {
94
+ return (req, res, next) => {
95
+ const { preflight, headers } = corsHeaders(req.method, req.headers.origin, req.headers['access-control-request-method'], options);
96
+ for (const [k, v] of Object.entries(headers)) {
97
+ if (k === 'Vary')
98
+ res.setHeader('Vary', [res.getHeader('Vary'), v].filter(Boolean).join(', '));
99
+ else
100
+ res.setHeader(k, v);
101
+ }
102
+ if (preflight) {
103
+ res.statusCode = 204;
104
+ return res.end();
105
+ }
106
+ next();
107
+ };
108
+ }
109
+ //# 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,113 @@
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
+ body: Uint8Array;
73
+ } | {
74
+ ok: false;
75
+ code: ShieldErrorCode;
76
+ reason: string;
77
+ response: Response;
78
+ };
79
+ export declare class MemoryShieldStore implements ShieldStore {
80
+ private sessions;
81
+ private nonces;
82
+ private lastSweep;
83
+ saveSession(session: StoredSession): Promise<void>;
84
+ getSession(id: string): Promise<StoredSession | null>;
85
+ useNonce(sessionId: string, nonce: string, ttlMs: number): Promise<boolean>;
86
+ private sweep;
87
+ }
88
+ export declare class ShieldServer {
89
+ private readonly cfg;
90
+ private readonly keyCache;
91
+ constructor(config: ShieldServerConfig);
92
+ private reject;
93
+ /** Handle POST {publicKey, attestation, platform}; returns {sessionId, expiresAt, serverTime}. */
94
+ register(request: ShieldRequest): Promise<Response>;
95
+ /**
96
+ * Verify a signed request. On success you get the session and the exact body bytes
97
+ * (the request body stream has been read, so use `body` instead of reading it again).
98
+ */
99
+ verify(request: ShieldRequest): Promise<VerifyResult>;
100
+ }
101
+ export declare function createShieldServer(config: ShieldServerConfig): ShieldServer;
102
+ /**
103
+ * Cloudflare Turnstile check for registration.
104
+ * createShieldServer({ verifyAttestation: turnstileVerifier({ secret: env.TURNSTILE_SECRET }) })
105
+ */
106
+ export declare function turnstileVerifier(options: {
107
+ secret: string;
108
+ hostnames?: string[];
109
+ action?: string;
110
+ fetch?: typeof fetch;
111
+ }): NonNullable<ShieldServerConfig['verifyAttestation']>;
112
+ export { corsHeaders, withCors, type CorsOptions, type CorsResult } from './cors.js';
113
+ //# 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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"}
package/dist/index.js ADDED
@@ -0,0 +1,267 @@
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 { canonicalString, 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 const SHIELD_REQUEST_HEADERS = Object.values(SHIELD_HEADERS);
9
+ export class MemoryShieldStore {
10
+ sessions = new Map();
11
+ nonces = new Map();
12
+ lastSweep = 0;
13
+ async saveSession(session) {
14
+ this.sessions.set(session.id, session);
15
+ }
16
+ async getSession(id) {
17
+ return this.sessions.get(id) ?? null;
18
+ }
19
+ async useNonce(sessionId, nonce, ttlMs) {
20
+ const now = Date.now();
21
+ this.sweep(now);
22
+ const key = `${sessionId}|${nonce}`;
23
+ const exp = this.nonces.get(key);
24
+ if (exp !== undefined && exp > now)
25
+ return false;
26
+ this.nonces.set(key, now + ttlMs);
27
+ return true;
28
+ }
29
+ sweep(now) {
30
+ if (now - this.lastSweep < 60_000)
31
+ return;
32
+ this.lastSweep = now;
33
+ for (const [k, exp] of this.nonces)
34
+ if (exp <= now)
35
+ this.nonces.delete(k);
36
+ for (const [id, s] of this.sessions)
37
+ if (s.expiresAt <= now)
38
+ this.sessions.delete(id);
39
+ }
40
+ }
41
+ const enc = new TextEncoder();
42
+ function b64urlEncode(bytes) {
43
+ let bin = '';
44
+ for (const b of bytes)
45
+ bin += String.fromCharCode(b);
46
+ return btoa(bin).replace(/\+/g, '-').replace(/\//g, '_').replace(/=+$/, '');
47
+ }
48
+ function b64urlDecode(s) {
49
+ if (!/^[A-Za-z0-9_-]*$/.test(s))
50
+ return null;
51
+ try {
52
+ const bin = atob(s.replace(/-/g, '+').replace(/_/g, '/') + '='.repeat((4 - (s.length % 4)) % 4));
53
+ const out = new Uint8Array(bin.length);
54
+ for (let i = 0; i < bin.length; i++)
55
+ out[i] = bin.charCodeAt(i);
56
+ return out;
57
+ }
58
+ catch {
59
+ return null;
60
+ }
61
+ }
62
+ async function sha256(data) {
63
+ return new Uint8Array(await crypto.subtle.digest('SHA-256', data));
64
+ }
65
+ /** Same as the Go verifier: first 8 bytes of SHA-256(User-Agent), hex. */
66
+ async function hashUserAgent(ua) {
67
+ const h = await sha256(enc.encode(ua));
68
+ return Array.from(h.slice(0, 8), (b) => b.toString(16).padStart(2, '0')).join('');
69
+ }
70
+ function json(status, body, headers = {}) {
71
+ return new Response(JSON.stringify(body), {
72
+ status,
73
+ headers: { 'Content-Type': 'application/json', 'Cache-Control': 'no-store', ...headers },
74
+ });
75
+ }
76
+ const STATUS = {
77
+ missing: 401,
78
+ session: 401,
79
+ skew: 401,
80
+ signature: 401,
81
+ replay: 401,
82
+ body: 413,
83
+ origin: 403,
84
+ attestation: 403,
85
+ bad_request: 400,
86
+ };
87
+ export class ShieldServer {
88
+ cfg;
89
+ keyCache = new Map();
90
+ constructor(config) {
91
+ if (!config.verifyAttestation && !config.allowNoAttestation) {
92
+ throw new Error('request-shield: verifyAttestation is required (set allowNoAttestation only for local development)');
93
+ }
94
+ this.cfg = {
95
+ allowedOrigins: config.allowedOrigins ?? [],
96
+ allowedPlatforms: config.allowedPlatforms ?? ['web'],
97
+ verifyAttestation: config.verifyAttestation,
98
+ allowNoAttestation: config.allowNoAttestation ?? false,
99
+ sessionTtlMs: config.sessionTtlMs ?? 12 * 60 * 60 * 1000,
100
+ maxClockSkewMs: config.maxClockSkewMs ?? 60_000,
101
+ maxBodyBytes: config.maxBodyBytes ?? 10 * 1024 * 1024,
102
+ store: config.store ?? new MemoryShieldStore(),
103
+ bindUserAgent: config.bindUserAgent ?? true,
104
+ canonicalPath: config.canonicalPath ??
105
+ ((r) => {
106
+ const u = new URL(r.url);
107
+ return u.pathname + u.search;
108
+ }),
109
+ onReject: config.onReject,
110
+ now: config.now ?? Date.now,
111
+ };
112
+ }
113
+ reject(request, code, reason) {
114
+ this.cfg.onReject?.(code, request, reason);
115
+ return {
116
+ ok: false,
117
+ code,
118
+ reason,
119
+ response: json(STATUS[code], { error: `shield_${code}` }, { [SHIELD_ERROR_HEADER]: code }),
120
+ };
121
+ }
122
+ /** Handle POST {publicKey, attestation, platform}; returns {sessionId, expiresAt, serverTime}. */
123
+ async register(request) {
124
+ if (request.method.toUpperCase() !== 'POST') {
125
+ return new Response('method not allowed', { status: 405, headers: { Allow: 'POST' } });
126
+ }
127
+ const raw = await request.arrayBuffer();
128
+ if (raw.byteLength > 16 * 1024)
129
+ return this.reject(request, 'bad_request', 'body too large').response;
130
+ let body;
131
+ try {
132
+ body = JSON.parse(new TextDecoder().decode(raw));
133
+ }
134
+ catch {
135
+ return this.reject(request, 'bad_request', 'invalid JSON').response;
136
+ }
137
+ body.platform ||= 'web';
138
+ if (!this.cfg.allowedPlatforms.includes(body.platform)) {
139
+ return this.reject(request, 'bad_request', `platform "${body.platform}" not allowed`).response;
140
+ }
141
+ if (body.platform === 'web' && this.cfg.allowedOrigins.length > 0) {
142
+ const origin = request.headers.get('origin') ?? '';
143
+ if (!this.cfg.allowedOrigins.includes(origin)) {
144
+ return this.reject(request, 'origin', `origin "${origin}" not allowed`).response;
145
+ }
146
+ }
147
+ const pk = body.publicKey;
148
+ const x = pk && b64urlDecode(pk.x ?? '');
149
+ const y = pk && b64urlDecode(pk.y ?? '');
150
+ if (!pk || pk.kty !== 'EC' || pk.crv !== 'P-256' || x?.length !== 32 || y?.length !== 32) {
151
+ return this.reject(request, 'bad_request', 'publicKey must be an EC P-256 JWK').response;
152
+ }
153
+ const publicKey = { kty: 'EC', crv: 'P-256', x: pk.x, y: pk.y };
154
+ let key;
155
+ try {
156
+ key = await importKey(publicKey); // also rejects points that are not on the curve
157
+ }
158
+ catch {
159
+ return this.reject(request, 'bad_request', 'invalid public key').response;
160
+ }
161
+ if (this.cfg.verifyAttestation) {
162
+ try {
163
+ await this.cfg.verifyAttestation(body, request);
164
+ }
165
+ catch (e) {
166
+ return this.reject(request, 'attestation', e instanceof Error ? e.message : String(e)).response;
167
+ }
168
+ }
169
+ const now = this.cfg.now();
170
+ const session = {
171
+ id: b64urlEncode(crypto.getRandomValues(new Uint8Array(32))),
172
+ publicKey,
173
+ platform: body.platform,
174
+ expiresAt: now + this.cfg.sessionTtlMs,
175
+ };
176
+ if (this.cfg.bindUserAgent)
177
+ session.userAgentHash = await hashUserAgent(request.headers.get('user-agent') ?? '');
178
+ await this.cfg.store.saveSession(session, this.cfg.sessionTtlMs);
179
+ this.keyCache.set(session.id, key);
180
+ return json(200, { sessionId: session.id, expiresAt: session.expiresAt, serverTime: now });
181
+ }
182
+ /**
183
+ * Verify a signed request. On success you get the session and the exact body bytes
184
+ * (the request body stream has been read, so use `body` instead of reading it again).
185
+ */
186
+ async verify(request) {
187
+ if (request.method.toUpperCase() === 'OPTIONS') {
188
+ return this.reject(request, 'missing', 'preflight requests carry no signature');
189
+ }
190
+ const h = (n) => request.headers.get(n);
191
+ const sessionId = h(SHIELD_HEADERS.session);
192
+ const tsRaw = h(SHIELD_HEADERS.timestamp);
193
+ const nonce = h(SHIELD_HEADERS.nonce);
194
+ const sigRaw = h(SHIELD_HEADERS.signature);
195
+ if (!sessionId || !tsRaw || !nonce || !sigRaw || nonce.length > 64 || !/^\d{1,16}$/.test(tsRaw)) {
196
+ return this.reject(request, 'missing', 'request is not signed');
197
+ }
198
+ const now = this.cfg.now();
199
+ const skew = now - Number(tsRaw);
200
+ if (Math.abs(skew) > this.cfg.maxClockSkewMs) {
201
+ return this.reject(request, 'skew', `timestamp is ${Math.round(skew / 1000)}s off`);
202
+ }
203
+ const session = await this.cfg.store.getSession(sessionId);
204
+ if (!session || session.expiresAt <= now) {
205
+ return this.reject(request, 'session', 'unknown or expired session');
206
+ }
207
+ if (session.userAgentHash && session.userAgentHash !== (await hashUserAgent(h('user-agent') ?? ''))) {
208
+ return this.reject(request, 'session', 'User-Agent differs from the one that registered');
209
+ }
210
+ const body = new Uint8Array(await request.arrayBuffer());
211
+ if (body.byteLength > this.cfg.maxBodyBytes)
212
+ return this.reject(request, 'body', 'body too large');
213
+ const sig = b64urlDecode(sigRaw);
214
+ if (!sig || sig.length !== 64)
215
+ return this.reject(request, 'signature', 'malformed signature');
216
+ let key = this.keyCache.get(session.id);
217
+ if (!key) {
218
+ key = await importKey(session.publicKey);
219
+ this.keyCache.set(session.id, key);
220
+ }
221
+ const canonical = canonicalString(request.method, this.cfg.canonicalPath(request), tsRaw, nonce, b64urlEncode(await sha256(body)));
222
+ const valid = await crypto.subtle.verify({ name: 'ECDSA', hash: 'SHA-256' }, key, sig, enc.encode(canonical));
223
+ if (!valid)
224
+ return this.reject(request, 'signature', 'signature does not match this request');
225
+ // Only burn the nonce once the signature checks out, so junk can't fill the store.
226
+ if (!(await this.cfg.store.useNonce(session.id, nonce, 2 * this.cfg.maxClockSkewMs))) {
227
+ return this.reject(request, 'replay', 'this exact request was already used');
228
+ }
229
+ return { ok: true, session, body };
230
+ }
231
+ }
232
+ function importKey(jwk) {
233
+ return crypto.subtle.importKey('jwk', { ...jwk, ext: true }, { name: 'ECDSA', namedCurve: 'P-256' }, false, [
234
+ 'verify',
235
+ ]);
236
+ }
237
+ export function createShieldServer(config) {
238
+ return new ShieldServer(config);
239
+ }
240
+ /**
241
+ * Cloudflare Turnstile check for registration.
242
+ * createShieldServer({ verifyAttestation: turnstileVerifier({ secret: env.TURNSTILE_SECRET }) })
243
+ */
244
+ export function turnstileVerifier(options) {
245
+ const f = options.fetch ?? globalThis.fetch.bind(globalThis);
246
+ return async (body) => {
247
+ if (body.platform !== 'web')
248
+ throw new Error(`turnstile cannot attest platform "${body.platform}"`);
249
+ if (!body.attestation)
250
+ throw new Error('missing turnstile token');
251
+ const res = await f('https://challenges.cloudflare.com/turnstile/v0/siteverify', {
252
+ method: 'POST',
253
+ headers: { 'Content-Type': 'application/x-www-form-urlencoded' },
254
+ body: new URLSearchParams({ secret: options.secret, response: body.attestation }).toString(),
255
+ });
256
+ const out = (await res.json());
257
+ if (!out.success)
258
+ throw new Error(`turnstile rejected token: ${out['error-codes']?.join(', ')}`);
259
+ if (options.hostnames?.length && !options.hostnames.includes(out.hostname ?? '')) {
260
+ throw new Error(`turnstile hostname "${out.hostname}" not allowed`);
261
+ }
262
+ if (options.action && out.action !== options.action)
263
+ throw new Error(`turnstile action "${out.action}" mismatch`);
264
+ };
265
+ }
266
+ export { corsHeaders, withCors } from './cors.js';
267
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,30 @@
1
+ /**
2
+ * Redis-backed ShieldStore, so every server instance shares sessions and used nonces.
3
+ *
4
+ * // node-redis (`redis` package, v4+)
5
+ * import { createClient } from 'redis';
6
+ * const redis = await createClient({ url }).connect();
7
+ * createShieldServer({ store: new RedisShieldStore(nodeRedis(redis)), ... });
8
+ *
9
+ * // ioredis
10
+ * import Redis from 'ioredis';
11
+ * createShieldServer({ store: new RedisShieldStore(ioredis(new Redis(url))), ... });
12
+ */
13
+ import type { ShieldStore, StoredSession } from './index.js';
14
+ /** The two Redis operations the store needs. Use nodeRedis() / ioredis(), or implement for another client. */
15
+ export interface RedisCommands {
16
+ get(key: string): Promise<string | null>;
17
+ /** SET key value PX ttlMs [NX]; resolve true if the value was written. */
18
+ set(key: string, value: string, ttlMs: number, onlyIfAbsent: boolean): Promise<boolean>;
19
+ }
20
+ export declare function nodeRedis(client: any): RedisCommands;
21
+ export declare function ioredis(client: any): RedisCommands;
22
+ export declare class RedisShieldStore implements ShieldStore {
23
+ private readonly redis;
24
+ private readonly prefix;
25
+ constructor(redis: RedisCommands, prefix?: string);
26
+ saveSession(session: StoredSession, ttlMs: number): Promise<void>;
27
+ getSession(id: string): Promise<StoredSession | null>;
28
+ useNonce(sessionId: string, nonce: string, ttlMs: number): Promise<boolean>;
29
+ }
30
+ //# sourceMappingURL=redis.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"redis.d.ts","sourceRoot":"","sources":["../src/redis.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE7D,8GAA8G;AAC9G,MAAM,WAAW,aAAa;IAC5B,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACzC,0EAA0E;IAC1E,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACzF;AAGD,wBAAgB,SAAS,CAAC,MAAM,EAAE,GAAG,GAAG,aAAa,CAMpD;AAED,wBAAgB,OAAO,CAAC,MAAM,EAAE,GAAG,GAAG,aAAa,CAMlD;AAGD,qBAAa,gBAAiB,YAAW,WAAW;IAEhD,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,MAAM;gBADN,KAAK,EAAE,aAAa,EACpB,MAAM,SAAY;IAG/B,WAAW,CAAC,OAAO,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIjE,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IAK3D,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CAG5E"}
package/dist/redis.js ADDED
@@ -0,0 +1,33 @@
1
+ /* eslint-disable @typescript-eslint/no-explicit-any */
2
+ export function nodeRedis(client) {
3
+ return {
4
+ get: (key) => client.get(key),
5
+ set: async (key, value, ttlMs, nx) => (await client.set(key, value, nx ? { PX: ttlMs, NX: true } : { PX: ttlMs })) === 'OK',
6
+ };
7
+ }
8
+ export function ioredis(client) {
9
+ return {
10
+ get: (key) => client.get(key),
11
+ set: async (key, value, ttlMs, nx) => (await (nx ? client.set(key, value, 'PX', ttlMs, 'NX') : client.set(key, value, 'PX', ttlMs))) === 'OK',
12
+ };
13
+ }
14
+ /* eslint-enable @typescript-eslint/no-explicit-any */
15
+ export class RedisShieldStore {
16
+ redis;
17
+ prefix;
18
+ constructor(redis, prefix = 'shield:') {
19
+ this.redis = redis;
20
+ this.prefix = prefix;
21
+ }
22
+ async saveSession(session, ttlMs) {
23
+ await this.redis.set(`${this.prefix}s:${session.id}`, JSON.stringify(session), Math.max(1, Math.ceil(ttlMs)), false);
24
+ }
25
+ async getSession(id) {
26
+ const raw = await this.redis.get(`${this.prefix}s:${id}`);
27
+ return raw ? JSON.parse(raw) : null;
28
+ }
29
+ useNonce(sessionId, nonce, ttlMs) {
30
+ return this.redis.set(`${this.prefix}n:${sessionId}:${nonce}`, '1', Math.max(1, Math.ceil(ttlMs)), true);
31
+ }
32
+ }
33
+ //# sourceMappingURL=redis.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"redis.js","sourceRoot":"","sources":["../src/redis.ts"],"names":[],"mappings":"AAqBA,uDAAuD;AACvD,MAAM,UAAU,SAAS,CAAC,MAAW;IACnC,OAAO;QACL,GAAG,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC;QAC7B,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,CACnC,CAAC,MAAM,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,IAAI;KACxF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,OAAO,CAAC,MAAW;IACjC,OAAO;QACL,GAAG,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC;QAC7B,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,CACnC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,KAAK,IAAI;KAC1G,CAAC;AACJ,CAAC;AACD,sDAAsD;AAEtD,MAAM,OAAO,gBAAgB;IAER;IACA;IAFnB,YACmB,KAAoB,EACpB,SAAS,SAAS;QADlB,UAAK,GAAL,KAAK,CAAe;QACpB,WAAM,GAAN,MAAM,CAAY;IAClC,CAAC;IAEJ,KAAK,CAAC,WAAW,CAAC,OAAsB,EAAE,KAAa;QACrD,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,MAAM,KAAK,OAAO,CAAC,EAAE,EAAE,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;IACvH,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,EAAU;QACzB,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,MAAM,KAAK,EAAE,EAAE,CAAC,CAAC;QAC1D,OAAO,GAAG,CAAC,CAAC,CAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAmB,CAAC,CAAC,CAAC,IAAI,CAAC;IACzD,CAAC;IAED,QAAQ,CAAC,SAAiB,EAAE,KAAa,EAAE,KAAa;QACtD,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,MAAM,KAAK,SAAS,IAAI,KAAK,EAAE,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;IAC3G,CAAC;CACF"}
package/package.json CHANGED
@@ -1,6 +1,61 @@
1
1
  {
2
2
  "name": "@request-shield/server",
3
- "version": "0.0.0-stage",
4
- "stub": true,
5
- "description": "Temporary package placeholder for staged publishing"
6
- }
3
+ "version": "0.2.0",
4
+ "description": "Verify request-shield signatures on Node, Express, Bun, Deno and Cloudflare Workers. Rejects replayed, tampered and unsigned requests.",
5
+ "keywords": [
6
+ "express",
7
+ "middleware",
8
+ "cloudflare-workers",
9
+ "bun",
10
+ "deno",
11
+ "api-security",
12
+ "request-signing",
13
+ "anti-replay"
14
+ ],
15
+ "author": "karammm",
16
+ "license": "MIT",
17
+ "homepage": "https://github.com/karammm/request-shield#readme",
18
+ "repository": {
19
+ "type": "git",
20
+ "url": "git+https://github.com/karammm/request-shield.git",
21
+ "directory": "packages/server"
22
+ },
23
+ "bugs": {
24
+ "url": "https://github.com/karammm/request-shield/issues"
25
+ },
26
+ "type": "module",
27
+ "main": "./dist/index.js",
28
+ "types": "./dist/index.d.ts",
29
+ "exports": {
30
+ ".": {
31
+ "types": "./dist/index.d.ts",
32
+ "import": "./dist/index.js"
33
+ },
34
+ "./express": {
35
+ "types": "./dist/express.d.ts",
36
+ "import": "./dist/express.js"
37
+ },
38
+ "./redis": {
39
+ "types": "./dist/redis.d.ts",
40
+ "import": "./dist/redis.js"
41
+ }
42
+ },
43
+ "files": [
44
+ "dist",
45
+ "README.md",
46
+ "LICENSE"
47
+ ],
48
+ "sideEffects": false,
49
+ "engines": {
50
+ "node": ">=20"
51
+ },
52
+ "scripts": {
53
+ "build": "tsc -p tsconfig.json"
54
+ },
55
+ "dependencies": {
56
+ "@request-shield/core": "^0.2.0"
57
+ },
58
+ "publishConfig": {
59
+ "access": "public"
60
+ }
61
+ }