@tozielinski/next-upstash-nonce 1.3.0 → 1.3.1

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## [1.3.1](https://github.com/tozielinski/next-upstash-nonce/compare/v1.3.0...v1.3.1) (2025-11-22)
+
+
+### Bug Fixes
+
+* enable type generation ([6df83aa](https://github.com/tozielinski/next-upstash-nonce/commit/6df83aa769f367481231b21f7cac0d3c0297af40))
+
 ## [1.3.0](https://github.com/tozielinski/next-upstash-nonce/compare/v1.2.3...v1.3.0) (2025-11-22)
 
 

package/README.md

@@ -52,9 +52,28 @@ export async function POST(req: Request) {
 
     const valid = await nonceManager.verifyAndDelete(nonce);
 
+    // valid will be true if nonce was found and deleted
+    // false if nonce was not found or expired
+    
     return NextResponse.json({nonce: nonce, valid: valid});
 }
 ```
+or more simple
+```typescript
+'use server'
+mport {NextResponse} from "next/server";
+import {nonceManager} from "@/[wherever you store your nonceManager instance]";
+
+export async function POST(req: Request) {
+    const result = await nonceManager.verifyAndDeleteNonceFromRequest(req);
+
+    // result will be {nonce: string, valid: true} or
+    // {valid false, reason: string, response: NextResponse}
+    // if nonce was not found or expired
+    
+    return NextResponse.json({nonce: result.nonce, valid: result.valid});
+}
+```
 ### Use it in your client side
 ```typescript
 'use client'

package/dist/index.d.ts

@@ -0,0 +1,53 @@
+import { Redis } from "@upstash/redis";
+export type NonceOptions = {
+    length?: number;
+    ttlSeconds?: number;
+    prefix?: string;
+};
+export type NonceCheckResult = {
+    valid: true;
+    nonce: string;
+} | {
+    valid: false;
+    reason: "missing-header" | "invalid-or-expired";
+    response: Response;
+};
+export declare class NonceManager {
+    private redis;
+    private length;
+    private ttlSeconds;
+    private prefix;
+    constructor(redis: Redis, opts?: NonceOptions);
+    /**
+     * generates a new, secure nonce,
+     * inserts it into Redis with a TTL,
+     * and returns the nonce string.
+     */
+    create(): Promise<string>;
+    /**
+     * verifies a nonce and deletes it from Redis,
+     * returning true if the nonce exists and has not expired.
+     */
+    verify(nonce: string): Promise<boolean>;
+    /**
+     * verifies a nonce and deletes it from Redis,
+     * returning true if the nonce exists and has not expired.
+     */
+    verifyAndDelete(nonce: string): Promise<boolean>;
+    /**
+     * verifies a nonce from the Header of a request
+     * returns a NonceCheckResult if the nonce exists and has not expired.
+     */
+    verifyNonceFromRequest(req: Request): Promise<NonceCheckResult>;
+    /**
+     * verifies a nonce from the Header of a request and deletes it from Redis
+     * returns a NonceCheckResult if the nonce exists and has not expired.
+     */
+    verifyAndDeleteNonceFromRequest(req: Request): Promise<NonceCheckResult>;
+    /**
+     * Optional: delete a nonce from Redis manually
+     */
+    delete(nonce: string): Promise<void>;
+}
+export default NonceManager;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAGvC,MAAM,MAAM,YAAY,GAAG;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAK;IAC7B,KAAK,EAAE,IAAI,CAAC;IACZ,KAAK,EAAE,MAAM,CAAA;CAChB,GAAG;IACA,KAAK,EAAE,KAAK,CAAC;IACb,MAAM,EAAE,gBAAgB,GAAG,oBAAoB,CAAC;IAChD,QAAQ,EAAE,QAAQ,CAAA;CACrB,CAAC;AAEF,qBAAa,YAAY;IACrB,OAAO,CAAC,KAAK,CAAQ;IACrB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,MAAM,CAAS;gBAGX,KAAK,EAAE,KAAK,EAAE,IAAI,GAAE,YAAiB;IAQjD;;;;OAIG;IACG,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC;IAS/B;;;OAGG;IACG,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAa7C;;;OAGG;IACG,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAetD;;;OAGG;IACG,sBAAsB,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAoCrE;;;OAGG;IACG,+BAA+B,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAoC9E;;OAEG;IACG,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAI7C;AAGD,eAAe,YAAY,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tozielinski/next-upstash-nonce",
-  "version": "1.3.0",
+  "version": "1.3.1",
   "description": "Create, store, verify and delete nonces in Redis by Upstash for Next.js",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",