@leejpsd/nextjs-cache-handler 0.4.1 → 1.0.0

package/dist/ops/index.d.cts

@@ -1,4 +1,4 @@
-import { e as MetricEventType } from '../types-C1vJ_sED.cjs';
+import { e as MetricEventType } from '../types-YbDAllyp.cjs';
 
 /**
  * Process-local metric counters with an optional emit hook.

package/dist/ops/index.d.ts

@@ -1,4 +1,4 @@
-import { e as MetricEventType } from '../types-C1vJ_sED.js';
+import { e as MetricEventType } from '../types-YbDAllyp.js';
 
 /**
  * Process-local metric counters with an optional emit hook.

package/dist/otel/index.d.cts

@@ -1,4 +1,4 @@
-import { M as MetricEmitter } from '../types-C1vJ_sED.cjs';
+import { M as MetricEmitter } from '../types-YbDAllyp.cjs';
 
 /**
  * Built-in OpenTelemetry metric emitter.

package/dist/otel/index.d.ts

@@ -1,4 +1,4 @@
-import { M as MetricEmitter } from '../types-C1vJ_sED.js';
+import { M as MetricEmitter } from '../types-YbDAllyp.js';
 
 /**
  * Built-in OpenTelemetry metric emitter.

package/dist/seed/index.d.cts

@@ -1,4 +1,4 @@
-import { b as RedisClientFactory, a as RedisClientConfig, L as Logger } from '../types-C1vJ_sED.cjs';
+import { b as RedisClientFactory, a as RedisClientConfig, L as Logger } from '../types-YbDAllyp.cjs';
 
 /**
  * Build-output cache seeding.

package/dist/seed/index.d.ts

@@ -1,4 +1,4 @@
-import { b as RedisClientFactory, a as RedisClientConfig, L as Logger } from '../types-C1vJ_sED.js';
+import { b as RedisClientFactory, a as RedisClientConfig, L as Logger } from '../types-YbDAllyp.js';
 
 /**
  * Build-output cache seeding.

package/dist/shared/client/adapter-ioredis.d.cts

@@ -1,5 +1,5 @@
 import { Cluster, Redis } from 'ioredis';
-import { R as RedisClientLike, a as RedisClientConfig } from '../../types-C1vJ_sED.cjs';
+import { R as RedisClientLike, a as RedisClientConfig } from '../../types-YbDAllyp.cjs';
 
 /**
  * Adapter for `ioredis` (and `ioredis.Cluster`).

package/dist/shared/client/adapter-ioredis.d.ts

@@ -1,5 +1,5 @@
 import { Cluster, Redis } from 'ioredis';
-import { R as RedisClientLike, a as RedisClientConfig } from '../../types-C1vJ_sED.js';
+import { R as RedisClientLike, a as RedisClientConfig } from '../../types-YbDAllyp.js';
 
 /**
  * Adapter for `ioredis` (and `ioredis.Cluster`).

package/dist/shared/client/adapter-redis.d.cts

@@ -1,5 +1,5 @@
 import { RedisClientType } from 'redis';
-import { R as RedisClientLike, a as RedisClientConfig } from '../../types-C1vJ_sED.cjs';
+import { R as RedisClientLike, a as RedisClientConfig } from '../../types-YbDAllyp.cjs';
 
 /**
  * Adapter for `redis@5` (the official `node-redis` client).

package/dist/shared/client/adapter-redis.d.ts

@@ -1,5 +1,5 @@
 import { RedisClientType } from 'redis';
-import { R as RedisClientLike, a as RedisClientConfig } from '../../types-C1vJ_sED.js';
+import { R as RedisClientLike, a as RedisClientConfig } from '../../types-YbDAllyp.js';
 
 /**
  * Adapter for `redis@5` (the official `node-redis` client).

package/dist/{types-C1vJ_sED.d.cts → types-YbDAllyp.d.cts}

@@ -105,7 +105,7 @@ type FallbackStrategy = "auto" | "always" | "never";
  * Optional — when not provided, only the process-local counters in
  * `src/shared/metrics.ts` are updated.
  */
-type MetricEventType = "cache.hit" | "cache.miss" | "cache.get.deduped" | "cache.stale" | "cache.stale.refresh.leader" | "cache.stale.refresh.follower" | "cache.set" | "cache.set.failed" | "tag.invalidate.soft" | "tag.invalidate.hard" | "tag.expiration.read" | "redis.connect.failed" | "redis.timeout" | "fallback.activated" | "build_phase.skip";
+type MetricEventType = "cache.hit" | "cache.miss" | "cache.get.deduped" | "cache.stale" | "cache.stale.refresh.leader" | "cache.stale.refresh.follower" | "cache.set" | "cache.set.failed" | "cache.set.skipped" | "tag.invalidate.soft" | "tag.invalidate.hard" | "tag.expiration.read" | "redis.connect.failed" | "redis.timeout" | "fallback.activated" | "build_phase.skip";
 interface MetricEvent {
     type: MetricEventType;
     /** Operation latency in milliseconds, when measurable. */
@@ -188,6 +188,12 @@ interface CacheHandlerOptions {
      *
      * Default: `true`. Set to `false` to revert to "expire on revalidate" behavior.
      */
+    /**
+     * Governs TIME-based staleness only (serve-stale within revalidate..expire).
+     * Since 0.4.2 tag invalidation ignores this option: soft (profile-based)
+     * invalidations always serve-while-revalidating and hard ones always miss —
+     * that split is the upstream contract, not a handler feature.
+     */
     staleWhileRevalidate?: boolean;
     /**
      * Push-based cross-instance tag propagation (plural handler only).

package/dist/{types-C1vJ_sED.d.ts → types-YbDAllyp.d.ts}

@@ -105,7 +105,7 @@ type FallbackStrategy = "auto" | "always" | "never";
  * Optional — when not provided, only the process-local counters in
  * `src/shared/metrics.ts` are updated.
  */
-type MetricEventType = "cache.hit" | "cache.miss" | "cache.get.deduped" | "cache.stale" | "cache.stale.refresh.leader" | "cache.stale.refresh.follower" | "cache.set" | "cache.set.failed" | "tag.invalidate.soft" | "tag.invalidate.hard" | "tag.expiration.read" | "redis.connect.failed" | "redis.timeout" | "fallback.activated" | "build_phase.skip";
+type MetricEventType = "cache.hit" | "cache.miss" | "cache.get.deduped" | "cache.stale" | "cache.stale.refresh.leader" | "cache.stale.refresh.follower" | "cache.set" | "cache.set.failed" | "cache.set.skipped" | "tag.invalidate.soft" | "tag.invalidate.hard" | "tag.expiration.read" | "redis.connect.failed" | "redis.timeout" | "fallback.activated" | "build_phase.skip";
 interface MetricEvent {
     type: MetricEventType;
     /** Operation latency in milliseconds, when measurable. */
@@ -188,6 +188,12 @@ interface CacheHandlerOptions {
      *
      * Default: `true`. Set to `false` to revert to "expire on revalidate" behavior.
      */
+    /**
+     * Governs TIME-based staleness only (serve-stale within revalidate..expire).
+     * Since 0.4.2 tag invalidation ignores this option: soft (profile-based)
+     * invalidations always serve-while-revalidating and hard ones always miss —
+     * that split is the upstream contract, not a handler feature.
+     */
     staleWhileRevalidate?: boolean;
     /**
      * Push-based cross-instance tag propagation (plural handler only).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@leejpsd/nextjs-cache-handler",
-  "version": "0.4.1",
+  "version": "1.0.0",
   "description": "Redis cache handler for Next.js 15/16 — the only one shipping both cacheHandler (ISR) and cacheHandlers ('use cache') with built-in compression, Redis Sentinel, and OpenTelemetry. Production-validated on multi-instance AWS: reconnect backoff, cross-instance tag invalidation, zero-downtime Redis failover.",
   "keywords": [
     "next",
@@ -178,13 +178,14 @@
     "prepublishOnly": "npm run verify && npm run publint && npm run attw",
     "test:cluster": "vitest run --config vitest.cluster.config.ts",
     "test:cluster:up": "scripts/cluster-test-env.sh up",
-    "test:cluster:down": "scripts/cluster-test-env.sh down"
+    "test:cluster:down": "scripts/cluster-test-env.sh down",
+    "og": "node tools/generate-og.mjs"
   },
   "peerDependencies": {
-    "next": ">=15.0.0 <17",
-    "redis": ">=5.0.0",
+    "@opentelemetry/api": ">=1.0.0",
     "ioredis": ">=5.0.0",
-    "@opentelemetry/api": ">=1.0.0"
+    "next": ">=15.0.0 <17",
+    "redis": ">=5.0.0"
   },
   "peerDependenciesMeta": {
     "redis": {
@@ -208,6 +209,7 @@
     "eslint": "^9.18.0",
     "ioredis": "^5.4.0",
     "next": "^16.1.5",
+    "playwright": "^1.60.0",
     "prettier": "^3.4.0",
     "publint": "^0.3.0",
     "redis": "^5.0.0",