@oncely/next 1.0.0

package/dist/pages.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/pages.ts"],"names":["MemoryStorage","hashObject","parseTtl","IdempotencyError","ConflictError","MissingKeyError","MismatchError","oncely"],"mappings":"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","file":"pages.cjs","sourcesContent":["/**\n * @oncely/next/pages - Next.js Pages Router integration for oncely idempotency\n *\n * Provides a wrapper for Next.js Pages Router API routes with idempotency protection.\n *\n * @example\n * ```typescript\n * // pages/api/orders.ts\n * import { pages } from '@oncely/next/pages';\n *\n * export default pages()(async (req, res) => {\n *   const order = await createOrder(req.body);\n *   res.status(201).json(order);\n * });\n * ```\n */\n\nimport type { NextApiRequest, NextApiResponse } from 'next';\nimport {\n  oncely,\n  MemoryStorage,\n  hashObject,\n  parseTtl,\n  IdempotencyError,\n  ConflictError,\n  MissingKeyError,\n  MismatchError,\n  type StorageAdapter,\n  type OncelyOptions,\n  type StoredResponse,\n} from '@oncely/core';\n\n// RFC 7807 Problem Details type URL base\nconst PROBLEM_BASE = 'https://oncely.dev/errors';\n\n/**\n * IETF standard header names\n */\nexport const IDEMPOTENCY_KEY_HEADER = 'Idempotency-Key';\nexport const IDEMPOTENCY_REPLAY_HEADER = 'Idempotency-Replay';\n\n/**\n * Options for the Next.js Pages Router wrapper\n */\nexport interface PagesMiddlewareOptions {\n  /**\n   * Storage adapter for persisting idempotency records.\n   * @default MemoryStorage\n   */\n  storage?: StorageAdapter;\n\n  /**\n   * TTL for idempotency records in milliseconds or duration string.\n   * @default '24h'\n   */\n  ttl?: number | string;\n\n  /**\n   * Whether to require an idempotency key.\n   * If true, returns 400 when key is missing.\n   * @default false\n   */\n  required?: boolean;\n\n  /**\n   * Custom function to extract idempotency key from request.\n   * @default Reads Idempotency-Key header\n   */\n  getKey?: (req: NextApiRequest) => string | undefined | null;\n\n  /**\n   * Custom function to generate hash from request for mismatch detection.\n   * @default Hashes request body as JSON\n   */\n  getHash?: (req: NextApiRequest) => Promise<string | null> | string | null;\n\n  /**\n   * Whether to add idempotency headers to responses.\n   * @default true\n   */\n  includeHeaders?: boolean;\n\n  /**\n   * Debug mode for logging.\n   * @default false\n   */\n  debug?: boolean;\n\n  /**\n   * Callback when a cached response is returned.\n   */\n  onHit?: OncelyOptions['onHit'];\n\n  /**\n   * Callback when a new response is generated.\n   */\n  onMiss?: OncelyOptions['onMiss'];\n\n  /**\n   * Callback when an error occurs.\n   */\n  onError?: OncelyOptions['onError'];\n\n  /**\n   * If true, proceed with the request when storage fails (e.g., Redis down).\n   * When false (default), storage errors return 500.\n   * Use with non-critical idempotency where availability is more important.\n   * @default false\n   */\n  failOpen?: boolean;\n}\n\n/**\n * Stored response data for replay\n */\ninterface CachedResponse {\n  status: number;\n  headers: Record<string, string>;\n  body: unknown;\n}\n\n/**\n * API route handler function signature\n */\ntype ApiHandler = (\n  req: NextApiRequest,\n  res: NextApiResponse\n) => Promise<void | NextApiResponse> | void | NextApiResponse;\n\n// Shared default storage instance\nlet defaultStorage: StorageAdapter | null = null;\n\nfunction getStorage(provided?: StorageAdapter): StorageAdapter {\n  if (provided) return provided;\n  if (!defaultStorage) {\n    defaultStorage = new MemoryStorage();\n  }\n  return defaultStorage;\n}\n\n/**\n * Default hash function that hashes request body\n */\nfunction defaultGetHash(req: NextApiRequest): string | null {\n  if (req.body && typeof req.body === 'object' && Object.keys(req.body).length > 0) {\n    return hashObject(req.body);\n  }\n  return null;\n}\n\n/**\n * Create a Next.js Pages Router API handler wrapper with idempotency protection.\n *\n * @example\n * ```typescript\n * // pages/api/orders.ts\n * import { pages } from '@oncely/next/pages';\n *\n * // Basic usage\n * export default pages()(async (req, res) => {\n *   const order = await createOrder(req.body);\n *   res.status(201).json(order);\n * });\n *\n * // With options\n * export default pages({ required: true, ttl: '1h' })(async (req, res) => {\n *   const result = await processPayment(req.body);\n *   res.json(result);\n * });\n * ```\n */\nexport function pages(options: PagesMiddlewareOptions = {}): (handler: ApiHandler) => ApiHandler {\n  const {\n    storage: providedStorage,\n    ttl = '24h',\n    required = false,\n    getKey = (req) => {\n      const header = req.headers[IDEMPOTENCY_KEY_HEADER.toLowerCase()];\n      return Array.isArray(header) ? header[0] : header;\n    },\n    getHash = defaultGetHash,\n    includeHeaders = true,\n    debug = false,\n    failOpen = false,\n    onHit,\n    onMiss,\n    onError,\n  } = options;\n\n  const storage = getStorage(providedStorage);\n  const ttlMs = parseTtl(ttl);\n\n  const log = (message: string) => {\n    if (debug) {\n      console.log(`[oncely/next/pages] ${message}`);\n    }\n  };\n\n  return (handler: ApiHandler): ApiHandler => {\n    return async (req: NextApiRequest, res: NextApiResponse): Promise<void | NextApiResponse> => {\n      // Get idempotency key\n      const key = getKey(req);\n\n      // Skip if no key and not required\n      if (!key && !required) {\n        return handler(req, res);\n      }\n\n      // Return 400 if key required but not provided\n      if (!key && required) {\n        if (includeHeaders) {\n          res.setHeader('Content-Type', 'application/problem+json');\n        }\n        return res.status(400).json({\n          type: `${PROBLEM_BASE}/key-required`,\n          title: 'Idempotency Key Required',\n          status: 400,\n          detail: `The ${IDEMPOTENCY_KEY_HEADER} header is required for this request.`,\n        });\n      }\n\n      // Compute request hash\n      const hash = await getHash(req);\n\n      try {\n        log(`Acquiring lock for key: ${key}`);\n        let result;\n        try {\n          result = await storage.acquire(key!, hash, ttlMs);\n        } catch (storageErr) {\n          // Storage failed (e.g., Redis down)\n          if (failOpen) {\n            log(`Storage error for key: ${key}, failing open`);\n            onError?.(key!, storageErr as Error);\n            return handler(req, res); // Proceed without idempotency protection\n          }\n          throw storageErr;\n        }\n\n        if (result.status === 'hit') {\n          // Return cached response\n          log(`Cache hit for key: ${key}`);\n          onHit?.(key!, result.response);\n\n          const cached = result.response.data as CachedResponse;\n\n          // Set headers\n          Object.entries(cached.headers).forEach(([headerKey, value]) => {\n            res.setHeader(headerKey, value);\n          });\n\n          if (includeHeaders) {\n            res.setHeader(IDEMPOTENCY_KEY_HEADER, key!);\n            res.setHeader(IDEMPOTENCY_REPLAY_HEADER, 'true');\n          }\n\n          return res.status(cached.status).json(cached.body);\n        }\n\n        if (result.status === 'conflict') {\n          log(`Conflict for key: ${key}`);\n          if (includeHeaders) {\n            res.setHeader(IDEMPOTENCY_KEY_HEADER, key!);\n            res.setHeader('Retry-After', '1');\n          }\n          return res.status(409).json({\n            type: `${PROBLEM_BASE}/conflict`,\n            title: 'Conflict',\n            status: 409,\n            detail: 'A request with this idempotency key is already being processed.',\n          });\n        }\n\n        if (result.status === 'mismatch') {\n          log(`Hash mismatch for key: ${key}`);\n          if (includeHeaders) {\n            res.setHeader(IDEMPOTENCY_KEY_HEADER, key!);\n          }\n          return res.status(422).json({\n            type: `${PROBLEM_BASE}/mismatch`,\n            title: 'Idempotency Key Mismatch',\n            status: 422,\n            detail:\n              'The request body does not match the original request for this idempotency key.',\n            existingHash: result.existingHash,\n            providedHash: result.providedHash,\n          });\n        }\n\n        // status === 'acquired' - execute handler\n        log(`Lock acquired for key: ${key}`);\n        onMiss?.(key!);\n\n        // Intercept response methods to capture the response\n        let capturedStatus = 200;\n        const capturedHeaders: Record<string, string> = {};\n        let capturedBody: unknown;\n\n        const originalStatus = res.status.bind(res);\n        const originalSetHeader = res.setHeader.bind(res);\n        const originalJson = res.json.bind(res);\n        const originalSend = res.send.bind(res);\n\n        res.status = (statusCode: number) => {\n          capturedStatus = statusCode;\n          return originalStatus(statusCode);\n        };\n\n        res.setHeader = (name: string, value: string | number | readonly string[]) => {\n          if (typeof value === 'string') {\n            capturedHeaders[name] = value;\n          } else if (Array.isArray(value)) {\n            capturedHeaders[name] = value.join(', ');\n          } else {\n            capturedHeaders[name] = String(value);\n          }\n          return originalSetHeader(name, value);\n        };\n\n        res.json = (body: unknown) => {\n          capturedBody = body;\n\n          // Save to storage\n          const cached: CachedResponse = {\n            status: capturedStatus,\n            headers: capturedHeaders,\n            body: capturedBody,\n          };\n\n          const storedResponse: StoredResponse = {\n            data: cached,\n            createdAt: Date.now(),\n            hash,\n          };\n\n          storage.save(key!, storedResponse).catch((err) => {\n            log(`Failed to save response for key: ${key}`);\n            onError?.(key!, err as Error);\n          });\n\n          // Add idempotency headers\n          if (includeHeaders) {\n            res.setHeader(IDEMPOTENCY_KEY_HEADER, key!);\n          }\n\n          return originalJson(body);\n        };\n\n        res.send = (body: unknown) => {\n          capturedBody = body;\n\n          // Save to storage\n          const cached: CachedResponse = {\n            status: capturedStatus,\n            headers: capturedHeaders,\n            body: capturedBody,\n          };\n\n          const storedResponse: StoredResponse = {\n            data: cached,\n            createdAt: Date.now(),\n            hash,\n          };\n\n          storage.save(key!, storedResponse).catch((err) => {\n            log(`Failed to save response for key: ${key}`);\n            onError?.(key!, err as Error);\n          });\n\n          // Add idempotency headers\n          if (includeHeaders) {\n            res.setHeader(IDEMPOTENCY_KEY_HEADER, key!);\n          }\n\n          return originalSend(body);\n        };\n\n        try {\n          return await handler(req, res);\n        } catch (err) {\n          // Release lock on error\n          log(`Handler error for key: ${key}, releasing lock`);\n          await storage.release(key!).catch(() => {});\n          throw err;\n        }\n      } catch (err) {\n        // Handle idempotency errors\n        if (err instanceof IdempotencyError) {\n          if (includeHeaders) {\n            res.setHeader(IDEMPOTENCY_KEY_HEADER, key!);\n            if (err instanceof ConflictError) {\n              res.setHeader('Retry-After', String(err.retryAfter ?? 1));\n            }\n          }\n\n          let type = `${PROBLEM_BASE}/error`;\n          if (err instanceof MissingKeyError) type = `${PROBLEM_BASE}/key-required`;\n          else if (err instanceof ConflictError) type = `${PROBLEM_BASE}/conflict`;\n          else if (err instanceof MismatchError) type = `${PROBLEM_BASE}/mismatch`;\n\n          return res.status(err.statusCode).json({\n            type,\n            title: err.name,\n            status: err.statusCode,\n            detail: err.message,\n          });\n        }\n\n        throw err;\n      }\n    };\n  };\n}\n\n/**\n * Create a pre-configured wrapper factory with default options.\n *\n * @example\n * ```typescript\n * // lib/idempotency.ts\n * import { configure } from '@oncely/next/pages';\n * import { redis } from '@oncely/redis';\n *\n * export const idempotent = configure({\n *   storage: redis(),\n *   ttl: '1h',\n * });\n *\n * // pages/api/orders.ts\n * import { idempotent } from '@/lib/idempotency';\n *\n * export default idempotent()(async (req, res) => {\n *   res.status(201).json(await createOrder(req.body));\n * });\n * ```\n */\nexport function configure(\n  defaults: PagesMiddlewareOptions\n): (overrides?: Partial<PagesMiddlewareOptions>) => (handler: ApiHandler) => ApiHandler {\n  return (overrides = {}) => pages({ ...defaults, ...overrides });\n}\n\n// Augment oncely namespace\ndeclare module '@oncely/core' {\n  interface OncelyNamespace {\n    /**\n     * Create Next.js Pages Router wrapper with idempotency.\n     */\n    pages: typeof pages;\n  }\n}\n\n// Register on oncely namespace\n(oncely as Record<string, unknown>).pages = pages;\n\n// Re-export types and utilities\nexport {\n  oncely,\n  MemoryStorage,\n  hashObject,\n  IdempotencyError,\n  MissingKeyError,\n  ConflictError,\n  MismatchError,\n  type StorageAdapter,\n  type OncelyOptions,\n} from '@oncely/core';\n"]}

package/dist/pages.d.cts

@@ -0,0 +1,145 @@
+import { NextApiRequest, NextApiResponse } from 'next';
+import { StorageAdapter, OncelyOptions } from '@oncely/core';
+export { ConflictError, IdempotencyError, MemoryStorage, MismatchError, MissingKeyError, OncelyOptions, StorageAdapter, hashObject, oncely } from '@oncely/core';
+
+/**
+ * @oncely/next/pages - Next.js Pages Router integration for oncely idempotency
+ *
+ * Provides a wrapper for Next.js Pages Router API routes with idempotency protection.
+ *
+ * @example
+ * ```typescript
+ * // pages/api/orders.ts
+ * import { pages } from '@oncely/next/pages';
+ *
+ * export default pages()(async (req, res) => {
+ *   const order = await createOrder(req.body);
+ *   res.status(201).json(order);
+ * });
+ * ```
+ */
+
+/**
+ * IETF standard header names
+ */
+declare const IDEMPOTENCY_KEY_HEADER = "Idempotency-Key";
+declare const IDEMPOTENCY_REPLAY_HEADER = "Idempotency-Replay";
+/**
+ * Options for the Next.js Pages Router wrapper
+ */
+interface PagesMiddlewareOptions {
+    /**
+     * Storage adapter for persisting idempotency records.
+     * @default MemoryStorage
+     */
+    storage?: StorageAdapter;
+    /**
+     * TTL for idempotency records in milliseconds or duration string.
+     * @default '24h'
+     */
+    ttl?: number | string;
+    /**
+     * Whether to require an idempotency key.
+     * If true, returns 400 when key is missing.
+     * @default false
+     */
+    required?: boolean;
+    /**
+     * Custom function to extract idempotency key from request.
+     * @default Reads Idempotency-Key header
+     */
+    getKey?: (req: NextApiRequest) => string | undefined | null;
+    /**
+     * Custom function to generate hash from request for mismatch detection.
+     * @default Hashes request body as JSON
+     */
+    getHash?: (req: NextApiRequest) => Promise<string | null> | string | null;
+    /**
+     * Whether to add idempotency headers to responses.
+     * @default true
+     */
+    includeHeaders?: boolean;
+    /**
+     * Debug mode for logging.
+     * @default false
+     */
+    debug?: boolean;
+    /**
+     * Callback when a cached response is returned.
+     */
+    onHit?: OncelyOptions['onHit'];
+    /**
+     * Callback when a new response is generated.
+     */
+    onMiss?: OncelyOptions['onMiss'];
+    /**
+     * Callback when an error occurs.
+     */
+    onError?: OncelyOptions['onError'];
+    /**
+     * If true, proceed with the request when storage fails (e.g., Redis down).
+     * When false (default), storage errors return 500.
+     * Use with non-critical idempotency where availability is more important.
+     * @default false
+     */
+    failOpen?: boolean;
+}
+/**
+ * API route handler function signature
+ */
+type ApiHandler = (req: NextApiRequest, res: NextApiResponse) => Promise<void | NextApiResponse> | void | NextApiResponse;
+/**
+ * Create a Next.js Pages Router API handler wrapper with idempotency protection.
+ *
+ * @example
+ * ```typescript
+ * // pages/api/orders.ts
+ * import { pages } from '@oncely/next/pages';
+ *
+ * // Basic usage
+ * export default pages()(async (req, res) => {
+ *   const order = await createOrder(req.body);
+ *   res.status(201).json(order);
+ * });
+ *
+ * // With options
+ * export default pages({ required: true, ttl: '1h' })(async (req, res) => {
+ *   const result = await processPayment(req.body);
+ *   res.json(result);
+ * });
+ * ```
+ */
+declare function pages(options?: PagesMiddlewareOptions): (handler: ApiHandler) => ApiHandler;
+/**
+ * Create a pre-configured wrapper factory with default options.
+ *
+ * @example
+ * ```typescript
+ * // lib/idempotency.ts
+ * import { configure } from '@oncely/next/pages';
+ * import { redis } from '@oncely/redis';
+ *
+ * export const idempotent = configure({
+ *   storage: redis(),
+ *   ttl: '1h',
+ * });
+ *
+ * // pages/api/orders.ts
+ * import { idempotent } from '@/lib/idempotency';
+ *
+ * export default idempotent()(async (req, res) => {
+ *   res.status(201).json(await createOrder(req.body));
+ * });
+ * ```
+ */
+declare function configure(defaults: PagesMiddlewareOptions): (overrides?: Partial<PagesMiddlewareOptions>) => (handler: ApiHandler) => ApiHandler;
+declare module '@oncely/core' {
+    interface OncelyNamespace {
+        /**
+         * Create Next.js Pages Router wrapper with idempotency.
+         */
+        pages: typeof pages;
+    }
+}
+
+export { IDEMPOTENCY_KEY_HEADER, IDEMPOTENCY_REPLAY_HEADER, type PagesMiddlewareOptions, configure, pages };

package/dist/pages.d.ts

@@ -0,0 +1,145 @@
+import { NextApiRequest, NextApiResponse } from 'next';
+import { StorageAdapter, OncelyOptions } from '@oncely/core';
+export { ConflictError, IdempotencyError, MemoryStorage, MismatchError, MissingKeyError, OncelyOptions, StorageAdapter, hashObject, oncely } from '@oncely/core';
+
+/**
+ * @oncely/next/pages - Next.js Pages Router integration for oncely idempotency
+ *
+ * Provides a wrapper for Next.js Pages Router API routes with idempotency protection.
+ *
+ * @example
+ * ```typescript
+ * // pages/api/orders.ts
+ * import { pages } from '@oncely/next/pages';
+ *
+ * export default pages()(async (req, res) => {
+ *   const order = await createOrder(req.body);
+ *   res.status(201).json(order);
+ * });
+ * ```
+ */
+
+/**
+ * IETF standard header names
+ */
+declare const IDEMPOTENCY_KEY_HEADER = "Idempotency-Key";
+declare const IDEMPOTENCY_REPLAY_HEADER = "Idempotency-Replay";
+/**
+ * Options for the Next.js Pages Router wrapper
+ */
+interface PagesMiddlewareOptions {
+    /**
+     * Storage adapter for persisting idempotency records.
+     * @default MemoryStorage
+     */
+    storage?: StorageAdapter;
+    /**
+     * TTL for idempotency records in milliseconds or duration string.
+     * @default '24h'
+     */
+    ttl?: number | string;
+    /**
+     * Whether to require an idempotency key.
+     * If true, returns 400 when key is missing.
+     * @default false
+     */
+    required?: boolean;
+    /**
+     * Custom function to extract idempotency key from request.
+     * @default Reads Idempotency-Key header
+     */
+    getKey?: (req: NextApiRequest) => string | undefined | null;
+    /**
+     * Custom function to generate hash from request for mismatch detection.
+     * @default Hashes request body as JSON
+     */
+    getHash?: (req: NextApiRequest) => Promise<string | null> | string | null;
+    /**
+     * Whether to add idempotency headers to responses.
+     * @default true
+     */
+    includeHeaders?: boolean;
+    /**
+     * Debug mode for logging.
+     * @default false
+     */
+    debug?: boolean;
+    /**
+     * Callback when a cached response is returned.
+     */
+    onHit?: OncelyOptions['onHit'];
+    /**
+     * Callback when a new response is generated.
+     */
+    onMiss?: OncelyOptions['onMiss'];
+    /**
+     * Callback when an error occurs.
+     */
+    onError?: OncelyOptions['onError'];
+    /**
+     * If true, proceed with the request when storage fails (e.g., Redis down).
+     * When false (default), storage errors return 500.
+     * Use with non-critical idempotency where availability is more important.
+     * @default false
+     */
+    failOpen?: boolean;
+}
+/**
+ * API route handler function signature
+ */
+type ApiHandler = (req: NextApiRequest, res: NextApiResponse) => Promise<void | NextApiResponse> | void | NextApiResponse;
+/**
+ * Create a Next.js Pages Router API handler wrapper with idempotency protection.
+ *
+ * @example
+ * ```typescript
+ * // pages/api/orders.ts
+ * import { pages } from '@oncely/next/pages';
+ *
+ * // Basic usage
+ * export default pages()(async (req, res) => {
+ *   const order = await createOrder(req.body);
+ *   res.status(201).json(order);
+ * });
+ *
+ * // With options
+ * export default pages({ required: true, ttl: '1h' })(async (req, res) => {
+ *   const result = await processPayment(req.body);
+ *   res.json(result);
+ * });
+ * ```
+ */
+declare function pages(options?: PagesMiddlewareOptions): (handler: ApiHandler) => ApiHandler;
+/**
+ * Create a pre-configured wrapper factory with default options.
+ *
+ * @example
+ * ```typescript
+ * // lib/idempotency.ts
+ * import { configure } from '@oncely/next/pages';
+ * import { redis } from '@oncely/redis';
+ *
+ * export const idempotent = configure({
+ *   storage: redis(),
+ *   ttl: '1h',
+ * });
+ *
+ * // pages/api/orders.ts
+ * import { idempotent } from '@/lib/idempotency';
+ *
+ * export default idempotent()(async (req, res) => {
+ *   res.status(201).json(await createOrder(req.body));
+ * });
+ * ```
+ */
+declare function configure(defaults: PagesMiddlewareOptions): (overrides?: Partial<PagesMiddlewareOptions>) => (handler: ApiHandler) => ApiHandler;
+declare module '@oncely/core' {
+    interface OncelyNamespace {
+        /**
+         * Create Next.js Pages Router wrapper with idempotency.
+         */
+        pages: typeof pages;
+    }
+}
+
+export { IDEMPOTENCY_KEY_HEADER, IDEMPOTENCY_REPLAY_HEADER, type PagesMiddlewareOptions, configure, pages };

package/dist/pages.js

@@ -0,0 +1,221 @@
+import { oncely, parseTtl, IdempotencyError, ConflictError, hashObject, MemoryStorage, MissingKeyError, MismatchError } from '@oncely/core';
+export { ConflictError, IdempotencyError, MemoryStorage, MismatchError, MissingKeyError, hashObject, oncely } from '@oncely/core';
+
+// src/pages.ts
+var PROBLEM_BASE = "https://oncely.dev/errors";
+var IDEMPOTENCY_KEY_HEADER = "Idempotency-Key";
+var IDEMPOTENCY_REPLAY_HEADER = "Idempotency-Replay";
+var defaultStorage = null;
+function getStorage(provided) {
+  if (provided) return provided;
+  if (!defaultStorage) {
+    defaultStorage = new MemoryStorage();
+  }
+  return defaultStorage;
+}
+function defaultGetHash(req) {
+  if (req.body && typeof req.body === "object" && Object.keys(req.body).length > 0) {
+    return hashObject(req.body);
+  }
+  return null;
+}
+function pages(options = {}) {
+  const {
+    storage: providedStorage,
+    ttl = "24h",
+    required = false,
+    getKey = (req) => {
+      const header = req.headers[IDEMPOTENCY_KEY_HEADER.toLowerCase()];
+      return Array.isArray(header) ? header[0] : header;
+    },
+    getHash = defaultGetHash,
+    includeHeaders = true,
+    debug = false,
+    failOpen = false,
+    onHit,
+    onMiss,
+    onError
+  } = options;
+  const storage = getStorage(providedStorage);
+  const ttlMs = parseTtl(ttl);
+  const log = (message) => {
+    if (debug) {
+      console.log(`[oncely/next/pages] ${message}`);
+    }
+  };
+  return (handler) => {
+    return async (req, res) => {
+      const key = getKey(req);
+      if (!key && !required) {
+        return handler(req, res);
+      }
+      if (!key && required) {
+        if (includeHeaders) {
+          res.setHeader("Content-Type", "application/problem+json");
+        }
+        return res.status(400).json({
+          type: `${PROBLEM_BASE}/key-required`,
+          title: "Idempotency Key Required",
+          status: 400,
+          detail: `The ${IDEMPOTENCY_KEY_HEADER} header is required for this request.`
+        });
+      }
+      const hash = await getHash(req);
+      try {
+        log(`Acquiring lock for key: ${key}`);
+        let result;
+        try {
+          result = await storage.acquire(key, hash, ttlMs);
+        } catch (storageErr) {
+          if (failOpen) {
+            log(`Storage error for key: ${key}, failing open`);
+            onError?.(key, storageErr);
+            return handler(req, res);
+          }
+          throw storageErr;
+        }
+        if (result.status === "hit") {
+          log(`Cache hit for key: ${key}`);
+          onHit?.(key, result.response);
+          const cached = result.response.data;
+          Object.entries(cached.headers).forEach(([headerKey, value]) => {
+            res.setHeader(headerKey, value);
+          });
+          if (includeHeaders) {
+            res.setHeader(IDEMPOTENCY_KEY_HEADER, key);
+            res.setHeader(IDEMPOTENCY_REPLAY_HEADER, "true");
+          }
+          return res.status(cached.status).json(cached.body);
+        }
+        if (result.status === "conflict") {
+          log(`Conflict for key: ${key}`);
+          if (includeHeaders) {
+            res.setHeader(IDEMPOTENCY_KEY_HEADER, key);
+            res.setHeader("Retry-After", "1");
+          }
+          return res.status(409).json({
+            type: `${PROBLEM_BASE}/conflict`,
+            title: "Conflict",
+            status: 409,
+            detail: "A request with this idempotency key is already being processed."
+          });
+        }
+        if (result.status === "mismatch") {
+          log(`Hash mismatch for key: ${key}`);
+          if (includeHeaders) {
+            res.setHeader(IDEMPOTENCY_KEY_HEADER, key);
+          }
+          return res.status(422).json({
+            type: `${PROBLEM_BASE}/mismatch`,
+            title: "Idempotency Key Mismatch",
+            status: 422,
+            detail: "The request body does not match the original request for this idempotency key.",
+            existingHash: result.existingHash,
+            providedHash: result.providedHash
+          });
+        }
+        log(`Lock acquired for key: ${key}`);
+        onMiss?.(key);
+        let capturedStatus = 200;
+        const capturedHeaders = {};
+        let capturedBody;
+        const originalStatus = res.status.bind(res);
+        const originalSetHeader = res.setHeader.bind(res);
+        const originalJson = res.json.bind(res);
+        const originalSend = res.send.bind(res);
+        res.status = (statusCode) => {
+          capturedStatus = statusCode;
+          return originalStatus(statusCode);
+        };
+        res.setHeader = (name, value) => {
+          if (typeof value === "string") {
+            capturedHeaders[name] = value;
+          } else if (Array.isArray(value)) {
+            capturedHeaders[name] = value.join(", ");
+          } else {
+            capturedHeaders[name] = String(value);
+          }
+          return originalSetHeader(name, value);
+        };
+        res.json = (body) => {
+          capturedBody = body;
+          const cached = {
+            status: capturedStatus,
+            headers: capturedHeaders,
+            body: capturedBody
+          };
+          const storedResponse = {
+            data: cached,
+            createdAt: Date.now(),
+            hash
+          };
+          storage.save(key, storedResponse).catch((err) => {
+            log(`Failed to save response for key: ${key}`);
+            onError?.(key, err);
+          });
+          if (includeHeaders) {
+            res.setHeader(IDEMPOTENCY_KEY_HEADER, key);
+          }
+          return originalJson(body);
+        };
+        res.send = (body) => {
+          capturedBody = body;
+          const cached = {
+            status: capturedStatus,
+            headers: capturedHeaders,
+            body: capturedBody
+          };
+          const storedResponse = {
+            data: cached,
+            createdAt: Date.now(),
+            hash
+          };
+          storage.save(key, storedResponse).catch((err) => {
+            log(`Failed to save response for key: ${key}`);
+            onError?.(key, err);
+          });
+          if (includeHeaders) {
+            res.setHeader(IDEMPOTENCY_KEY_HEADER, key);
+          }
+          return originalSend(body);
+        };
+        try {
+          return await handler(req, res);
+        } catch (err) {
+          log(`Handler error for key: ${key}, releasing lock`);
+          await storage.release(key).catch(() => {
+          });
+          throw err;
+        }
+      } catch (err) {
+        if (err instanceof IdempotencyError) {
+          if (includeHeaders) {
+            res.setHeader(IDEMPOTENCY_KEY_HEADER, key);
+            if (err instanceof ConflictError) {
+              res.setHeader("Retry-After", String(err.retryAfter ?? 1));
+            }
+          }
+          let type = `${PROBLEM_BASE}/error`;
+          if (err instanceof MissingKeyError) type = `${PROBLEM_BASE}/key-required`;
+          else if (err instanceof ConflictError) type = `${PROBLEM_BASE}/conflict`;
+          else if (err instanceof MismatchError) type = `${PROBLEM_BASE}/mismatch`;
+          return res.status(err.statusCode).json({
+            type,
+            title: err.name,
+            status: err.statusCode,
+            detail: err.message
+          });
+        }
+        throw err;
+      }
+    };
+  };
+}
+function configure(defaults) {
+  return (overrides = {}) => pages({ ...defaults, ...overrides });
+}
+oncely.pages = pages;
+
+export { IDEMPOTENCY_KEY_HEADER, IDEMPOTENCY_REPLAY_HEADER, configure, pages };
+//# sourceMappingURL=pages.js.map
+//# sourceMappingURL=pages.js.map

package/dist/pages.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/pages.ts"],"names":[],"mappings":"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","file":"pages.js","sourcesContent":["/**\n * @oncely/next/pages - Next.js Pages Router integration for oncely idempotency\n *\n * Provides a wrapper for Next.js Pages Router API routes with idempotency protection.\n *\n * @example\n * ```typescript\n * // pages/api/orders.ts\n * import { pages } from '@oncely/next/pages';\n *\n * export default pages()(async (req, res) => {\n *   const order = await createOrder(req.body);\n *   res.status(201).json(order);\n * });\n * ```\n */\n\nimport type { NextApiRequest, NextApiResponse } from 'next';\nimport {\n  oncely,\n  MemoryStorage,\n  hashObject,\n  parseTtl,\n  IdempotencyError,\n  ConflictError,\n  MissingKeyError,\n  MismatchError,\n  type StorageAdapter,\n  type OncelyOptions,\n  type StoredResponse,\n} from '@oncely/core';\n\n// RFC 7807 Problem Details type URL base\nconst PROBLEM_BASE = 'https://oncely.dev/errors';\n\n/**\n * IETF standard header names\n */\nexport const IDEMPOTENCY_KEY_HEADER = 'Idempotency-Key';\nexport const IDEMPOTENCY_REPLAY_HEADER = 'Idempotency-Replay';\n\n/**\n * Options for the Next.js Pages Router wrapper\n */\nexport interface PagesMiddlewareOptions {\n  /**\n   * Storage adapter for persisting idempotency records.\n   * @default MemoryStorage\n   */\n  storage?: StorageAdapter;\n\n  /**\n   * TTL for idempotency records in milliseconds or duration string.\n   * @default '24h'\n   */\n  ttl?: number | string;\n\n  /**\n   * Whether to require an idempotency key.\n   * If true, returns 400 when key is missing.\n   * @default false\n   */\n  required?: boolean;\n\n  /**\n   * Custom function to extract idempotency key from request.\n   * @default Reads Idempotency-Key header\n   */\n  getKey?: (req: NextApiRequest) => string | undefined | null;\n\n  /**\n   * Custom function to generate hash from request for mismatch detection.\n   * @default Hashes request body as JSON\n   */\n  getHash?: (req: NextApiRequest) => Promise<string | null> | string | null;\n\n  /**\n   * Whether to add idempotency headers to responses.\n   * @default true\n   */\n  includeHeaders?: boolean;\n\n  /**\n   * Debug mode for logging.\n   * @default false\n   */\n  debug?: boolean;\n\n  /**\n   * Callback when a cached response is returned.\n   */\n  onHit?: OncelyOptions['onHit'];\n\n  /**\n   * Callback when a new response is generated.\n   */\n  onMiss?: OncelyOptions['onMiss'];\n\n  /**\n   * Callback when an error occurs.\n   */\n  onError?: OncelyOptions['onError'];\n\n  /**\n   * If true, proceed with the request when storage fails (e.g., Redis down).\n   * When false (default), storage errors return 500.\n   * Use with non-critical idempotency where availability is more important.\n   * @default false\n   */\n  failOpen?: boolean;\n}\n\n/**\n * Stored response data for replay\n */\ninterface CachedResponse {\n  status: number;\n  headers: Record<string, string>;\n  body: unknown;\n}\n\n/**\n * API route handler function signature\n */\ntype ApiHandler = (\n  req: NextApiRequest,\n  res: NextApiResponse\n) => Promise<void | NextApiResponse> | void | NextApiResponse;\n\n// Shared default storage instance\nlet defaultStorage: StorageAdapter | null = null;\n\nfunction getStorage(provided?: StorageAdapter): StorageAdapter {\n  if (provided) return provided;\n  if (!defaultStorage) {\n    defaultStorage = new MemoryStorage();\n  }\n  return defaultStorage;\n}\n\n/**\n * Default hash function that hashes request body\n */\nfunction defaultGetHash(req: NextApiRequest): string | null {\n  if (req.body && typeof req.body === 'object' && Object.keys(req.body).length > 0) {\n    return hashObject(req.body);\n  }\n  return null;\n}\n\n/**\n * Create a Next.js Pages Router API handler wrapper with idempotency protection.\n *\n * @example\n * ```typescript\n * // pages/api/orders.ts\n * import { pages } from '@oncely/next/pages';\n *\n * // Basic usage\n * export default pages()(async (req, res) => {\n *   const order = await createOrder(req.body);\n *   res.status(201).json(order);\n * });\n *\n * // With options\n * export default pages({ required: true, ttl: '1h' })(async (req, res) => {\n *   const result = await processPayment(req.body);\n *   res.json(result);\n * });\n * ```\n */\nexport function pages(options: PagesMiddlewareOptions = {}): (handler: ApiHandler) => ApiHandler {\n  const {\n    storage: providedStorage,\n    ttl = '24h',\n    required = false,\n    getKey = (req) => {\n      const header = req.headers[IDEMPOTENCY_KEY_HEADER.toLowerCase()];\n      return Array.isArray(header) ? header[0] : header;\n    },\n    getHash = defaultGetHash,\n    includeHeaders = true,\n    debug = false,\n    failOpen = false,\n    onHit,\n    onMiss,\n    onError,\n  } = options;\n\n  const storage = getStorage(providedStorage);\n  const ttlMs = parseTtl(ttl);\n\n  const log = (message: string) => {\n    if (debug) {\n      console.log(`[oncely/next/pages] ${message}`);\n    }\n  };\n\n  return (handler: ApiHandler): ApiHandler => {\n    return async (req: NextApiRequest, res: NextApiResponse): Promise<void | NextApiResponse> => {\n      // Get idempotency key\n      const key = getKey(req);\n\n      // Skip if no key and not required\n      if (!key && !required) {\n        return handler(req, res);\n      }\n\n      // Return 400 if key required but not provided\n      if (!key && required) {\n        if (includeHeaders) {\n          res.setHeader('Content-Type', 'application/problem+json');\n        }\n        return res.status(400).json({\n          type: `${PROBLEM_BASE}/key-required`,\n          title: 'Idempotency Key Required',\n          status: 400,\n          detail: `The ${IDEMPOTENCY_KEY_HEADER} header is required for this request.`,\n        });\n      }\n\n      // Compute request hash\n      const hash = await getHash(req);\n\n      try {\n        log(`Acquiring lock for key: ${key}`);\n        let result;\n        try {\n          result = await storage.acquire(key!, hash, ttlMs);\n        } catch (storageErr) {\n          // Storage failed (e.g., Redis down)\n          if (failOpen) {\n            log(`Storage error for key: ${key}, failing open`);\n            onError?.(key!, storageErr as Error);\n            return handler(req, res); // Proceed without idempotency protection\n          }\n          throw storageErr;\n        }\n\n        if (result.status === 'hit') {\n          // Return cached response\n          log(`Cache hit for key: ${key}`);\n          onHit?.(key!, result.response);\n\n          const cached = result.response.data as CachedResponse;\n\n          // Set headers\n          Object.entries(cached.headers).forEach(([headerKey, value]) => {\n            res.setHeader(headerKey, value);\n          });\n\n          if (includeHeaders) {\n            res.setHeader(IDEMPOTENCY_KEY_HEADER, key!);\n            res.setHeader(IDEMPOTENCY_REPLAY_HEADER, 'true');\n          }\n\n          return res.status(cached.status).json(cached.body);\n        }\n\n        if (result.status === 'conflict') {\n          log(`Conflict for key: ${key}`);\n          if (includeHeaders) {\n            res.setHeader(IDEMPOTENCY_KEY_HEADER, key!);\n            res.setHeader('Retry-After', '1');\n          }\n          return res.status(409).json({\n            type: `${PROBLEM_BASE}/conflict`,\n            title: 'Conflict',\n            status: 409,\n            detail: 'A request with this idempotency key is already being processed.',\n          });\n        }\n\n        if (result.status === 'mismatch') {\n          log(`Hash mismatch for key: ${key}`);\n          if (includeHeaders) {\n            res.setHeader(IDEMPOTENCY_KEY_HEADER, key!);\n          }\n          return res.status(422).json({\n            type: `${PROBLEM_BASE}/mismatch`,\n            title: 'Idempotency Key Mismatch',\n            status: 422,\n            detail:\n              'The request body does not match the original request for this idempotency key.',\n            existingHash: result.existingHash,\n            providedHash: result.providedHash,\n          });\n        }\n\n        // status === 'acquired' - execute handler\n        log(`Lock acquired for key: ${key}`);\n        onMiss?.(key!);\n\n        // Intercept response methods to capture the response\n        let capturedStatus = 200;\n        const capturedHeaders: Record<string, string> = {};\n        let capturedBody: unknown;\n\n        const originalStatus = res.status.bind(res);\n        const originalSetHeader = res.setHeader.bind(res);\n        const originalJson = res.json.bind(res);\n        const originalSend = res.send.bind(res);\n\n        res.status = (statusCode: number) => {\n          capturedStatus = statusCode;\n          return originalStatus(statusCode);\n        };\n\n        res.setHeader = (name: string, value: string | number | readonly string[]) => {\n          if (typeof value === 'string') {\n            capturedHeaders[name] = value;\n          } else if (Array.isArray(value)) {\n            capturedHeaders[name] = value.join(', ');\n          } else {\n            capturedHeaders[name] = String(value);\n          }\n          return originalSetHeader(name, value);\n        };\n\n        res.json = (body: unknown) => {\n          capturedBody = body;\n\n          // Save to storage\n          const cached: CachedResponse = {\n            status: capturedStatus,\n            headers: capturedHeaders,\n            body: capturedBody,\n          };\n\n          const storedResponse: StoredResponse = {\n            data: cached,\n            createdAt: Date.now(),\n            hash,\n          };\n\n          storage.save(key!, storedResponse).catch((err) => {\n            log(`Failed to save response for key: ${key}`);\n            onError?.(key!, err as Error);\n          });\n\n          // Add idempotency headers\n          if (includeHeaders) {\n            res.setHeader(IDEMPOTENCY_KEY_HEADER, key!);\n          }\n\n          return originalJson(body);\n        };\n\n        res.send = (body: unknown) => {\n          capturedBody = body;\n\n          // Save to storage\n          const cached: CachedResponse = {\n            status: capturedStatus,\n            headers: capturedHeaders,\n            body: capturedBody,\n          };\n\n          const storedResponse: StoredResponse = {\n            data: cached,\n            createdAt: Date.now(),\n            hash,\n          };\n\n          storage.save(key!, storedResponse).catch((err) => {\n            log(`Failed to save response for key: ${key}`);\n            onError?.(key!, err as Error);\n          });\n\n          // Add idempotency headers\n          if (includeHeaders) {\n            res.setHeader(IDEMPOTENCY_KEY_HEADER, key!);\n          }\n\n          return originalSend(body);\n        };\n\n        try {\n          return await handler(req, res);\n        } catch (err) {\n          // Release lock on error\n          log(`Handler error for key: ${key}, releasing lock`);\n          await storage.release(key!).catch(() => {});\n          throw err;\n        }\n      } catch (err) {\n        // Handle idempotency errors\n        if (err instanceof IdempotencyError) {\n          if (includeHeaders) {\n            res.setHeader(IDEMPOTENCY_KEY_HEADER, key!);\n            if (err instanceof ConflictError) {\n              res.setHeader('Retry-After', String(err.retryAfter ?? 1));\n            }\n          }\n\n          let type = `${PROBLEM_BASE}/error`;\n          if (err instanceof MissingKeyError) type = `${PROBLEM_BASE}/key-required`;\n          else if (err instanceof ConflictError) type = `${PROBLEM_BASE}/conflict`;\n          else if (err instanceof MismatchError) type = `${PROBLEM_BASE}/mismatch`;\n\n          return res.status(err.statusCode).json({\n            type,\n            title: err.name,\n            status: err.statusCode,\n            detail: err.message,\n          });\n        }\n\n        throw err;\n      }\n    };\n  };\n}\n\n/**\n * Create a pre-configured wrapper factory with default options.\n *\n * @example\n * ```typescript\n * // lib/idempotency.ts\n * import { configure } from '@oncely/next/pages';\n * import { redis } from '@oncely/redis';\n *\n * export const idempotent = configure({\n *   storage: redis(),\n *   ttl: '1h',\n * });\n *\n * // pages/api/orders.ts\n * import { idempotent } from '@/lib/idempotency';\n *\n * export default idempotent()(async (req, res) => {\n *   res.status(201).json(await createOrder(req.body));\n * });\n * ```\n */\nexport function configure(\n  defaults: PagesMiddlewareOptions\n): (overrides?: Partial<PagesMiddlewareOptions>) => (handler: ApiHandler) => ApiHandler {\n  return (overrides = {}) => pages({ ...defaults, ...overrides });\n}\n\n// Augment oncely namespace\ndeclare module '@oncely/core' {\n  interface OncelyNamespace {\n    /**\n     * Create Next.js Pages Router wrapper with idempotency.\n     */\n    pages: typeof pages;\n  }\n}\n\n// Register on oncely namespace\n(oncely as Record<string, unknown>).pages = pages;\n\n// Re-export types and utilities\nexport {\n  oncely,\n  MemoryStorage,\n  hashObject,\n  IdempotencyError,\n  MissingKeyError,\n  ConflictError,\n  MismatchError,\n  type StorageAdapter,\n  type OncelyOptions,\n} from '@oncely/core';\n"]}

package/package.json

@@ -0,0 +1,63 @@
+{
+  "name": "@oncely/next",
+  "version": "1.0.0",
+  "description": "Next.js integration for oncely idempotency",
+  "author": "stacks0x",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/stacks0x/oncely.git",
+    "directory": "packages/next"
+  },
+  "keywords": [
+    "oncely",
+    "idempotency",
+    "nextjs",
+    "next",
+    "app-router",
+    "pages-router"
+  ],
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    },
+    "./pages": {
+      "types": "./dist/pages.d.ts",
+      "import": "./dist/pages.js",
+      "require": "./dist/pages.cjs"
+    }
+  },
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist"
+  },
+  "peerDependencies": {
+    "@oncely/core": "workspace:*",
+    "next": ">=13.0.0"
+  },
+  "devDependencies": {
+    "@oncely/core": "workspace:*",
+    "next": "^16.1.4",
+    "tsup": "^8.0.1",
+    "typescript": "^5.3.3"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}