docs(examples): Additional comments

examples/nextjs-13-pages-wrap/pages/api/arcjet-edge.ts

@@ -12,12 +12,14 @@ const aj = arcjet({
   // See: https://nextjs.org/docs/pages/building-your-application/configuring/environment-variables
   key: process.env.ARCJET_KEY,
   rules: [
+    // Fixed window rate limit. Arcjet also supports sliding window and token
+    // bucket.
     fixedWindow({
-      mode: "LIVE",
+      mode: "LIVE", // will block requests. Use "DRY_RUN" to log only
       // Limiting by ip.src is the default if not specified
       //characteristics: ["ip.src"],
-      window: "1m",
-      max: 1,
+      window: "1m", // 1 min fixed window
+      max: 1, // allow a single request (for demo purposes)
     }),
   ],
 });

examples/nextjs-13-pages-wrap/pages/api/arcjet.ts

@@ -8,12 +8,14 @@ const aj = arcjet({
   // See: https://nextjs.org/docs/pages/building-your-application/configuring/environment-variables
   key: process.env.ARCJET_KEY,
   rules: [
+    // Fixed window rate limit. Arcjet also supports sliding window and token
+    // bucket.
     fixedWindow({
-      mode: "LIVE",
+      mode: "LIVE", // will block requests. Use "DRY_RUN" to log only
       // Limiting by ip.src is the default if not specified
       //characteristics: ["ip.src"],
-      window: "1m",
-      max: 1,
+      window: "1m", // 1 min fixed window
+      max: 1, // allow a single request (for demo purposes)
     }),
   ],
 });

examples/nextjs-14-app-dir-rl/app/api/arcjet/route.ts

@@ -7,11 +7,14 @@ const aj = arcjet({
   // See: https://nextjs.org/docs/app/building-your-application/configuring/environment-variables
   key: process.env.ARCJET_KEY!,
   rules: [
+    // Fixed window rate limit. Arcjet also supports sliding window and token
+    // bucket.
     fixedWindow({
-      mode: "LIVE",
-      characteristics: ["ip.src"],
-      window: "1h",
-      max: 1,
+      mode: "LIVE", // will block requests. Use "DRY_RUN" to log only
+      // Limiting by ip.src is the default if not specified
+      //characteristics: ["ip.src"],
+      window: "1m", // 1 min fixed window
+      max: 1, // allow a single request (for demo purposes)
     }),
   ],
 });

examples/nextjs-14-app-dir-rl/app/api/custom_timeout/route.ts

@@ -17,8 +17,8 @@ const aj = arcjet({
   key: process.env.ARCJET_KEY!,
   rules: [
     validateEmail({
-      mode: "LIVE",
-      block: ["NO_MX_RECORDS"],
+      mode: "LIVE", // will block requests. Use "DRY_RUN" to log only
+      block: ["NO_MX_RECORDS"], // block email addresses with no MX records
     }),
   ],
   client,

examples/nextjs-14-app-dir-validate-email/app/api/arcjet/route.ts

@@ -8,8 +8,8 @@ const aj = arcjet({
   key: process.env.ARCJET_KEY,
   rules: [
     validateEmail({
-      mode: "LIVE",
-      block: ["NO_MX_RECORDS"],
+      mode: "LIVE", // will block requests. Use "DRY_RUN" to log only
+      block: ["NO_MX_RECORDS"], // block email addresses with no MX records
     }),
   ],
 });

examples/nextjs-14-pages-wrap/.env.local.example

@@ -0,0 +1 @@
+ARCJET_KEY=

examples/nextjs-14-pages-wrap/README.md

@@ -25,11 +25,7 @@ Route](https://nextjs.org/docs/pages/building-your-application/routing/api-route
    npm ci
    ```
 
-3. Add your Arcjet key to `.env.local`
-
-   ```env
-   ARCJET_KEY=
-   ```
+3. Rename `.env.local.example` to `.env.local` and add your Arcjet key.
 
 4. Start the dev server.
 

examples/nextjs-14-pages-wrap/environment.d.ts

@@ -0,0 +1,5 @@
+declare namespace NodeJS {
+    export interface ProcessEnv {
+        readonly ARCJET_KEY: string;
+    }
+}

examples/nextjs-14-pages-wrap/package.json

@@ -10,7 +10,7 @@
   },
   "dependencies": {
     "@arcjet/next": "file:../../arcjet-next",
-    "next": "14.0.4",
+    "next": "14.1.0",
     "react": "^18",
     "react-dom": "^18"
   },
@@ -25,4 +25,4 @@
     "tailwindcss": "^3.4.1",
     "typescript": "^5"
   }
-}
+}

examples/nextjs-14-pages-wrap/pages/api/arcjet-edge.ts

@@ -12,12 +12,14 @@ const aj = arcjet({
   // See: https://nextjs.org/docs/pages/building-your-application/configuring/environment-variables
   key: process.env.ARCJET_KEY!,
   rules: [
+    // Fixed window rate limit. Arcjet also supports sliding window and token
+    // bucket.
     fixedWindow({
-      mode: "LIVE",
+      mode: "LIVE", // will block requests. Use "DRY_RUN" to log only
       // Limiting by ip.src is the default if not specified
       //characteristics: ["ip.src"],
-      window: "1m",
-      max: 1,
+      window: "1m", // 1 min fixed window
+      max: 1, // allow a single request (for demo purposes)
     }),
   ],
 });

examples/nextjs-14-pages-wrap/pages/api/arcjet.ts

@@ -8,12 +8,14 @@ const aj = arcjet({
   // See: https://nextjs.org/docs/pages/building-your-application/configuring/environment-variables
   key: process.env.ARCJET_KEY!,
   rules: [
+    // Fixed window rate limit. Arcjet also supports sliding window and token
+    // bucket.
     fixedWindow({
-      mode: "LIVE",
+      mode: "LIVE", // will block requests. Use "DRY_RUN" to log only
       // Limiting by ip.src is the default if not specified
       //characteristics: ["ip.src"],
-      window: "1m",
-      max: 1,
+      window: "1m", // 1 min fixed window
+      max: 1, // allow a single request (for demo purposes)
     }),
   ],
 });