@mohasinac/next 1.0.0 → 1.1.0

package/dist/index.cjs

@@ -35,12 +35,21 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var index_exports = {};
 __export(index_exports, {
   createApiErrorHandler: () => createApiErrorHandler,
-  createRouteHandler: () => createRouteHandler
+  createApiHandlerFactory: () => createApiHandlerFactory,
+  createRouteHandler: () => createRouteHandler,
+  getBooleanParam: () => getBooleanParam,
+  getNumberParam: () => getNumberParam,
+  getOptionalSessionCookie: () => getOptionalSessionCookie,
+  getRequiredSessionCookie: () => getRequiredSessionCookie,
+  getSearchParams: () => getSearchParams,
+  getStringParam: () => getStringParam,
+  invalidateCache: () => invalidateCache,
+  withCache: () => withCache
 });
 module.exports = __toCommonJS(index_exports);
 
 // src/api/errorHandler.ts
-var import_server = require("next/server");
+var import_server = require("next/server.js");
 function createApiErrorHandler(options) {
   const {
     isAppError,
@@ -86,7 +95,7 @@ function createApiErrorHandler(options) {
 }
 
 // src/api/routeHandler.ts
-var import_server2 = require("next/server");
+var import_server2 = require("next/server.js");
 var import_contracts = require("@mohasinac/contracts");
 function readSessionCookie(request) {
   var _a;
@@ -171,15 +180,222 @@ function createRouteHandler(options) {
       const status = typeof (err == null ? void 0 : err.status) === "number" ? err.status : 500;
       const message = err instanceof Error ? err.message : "Internal server error";
       console.error(`[createRouteHandler] ${request.method} failed`, err);
-      return import_server2.NextResponse.json(
-        { success: false, error: message },
-        { status }
-      );
+      return import_server2.NextResponse.json({ success: false, error: message }, { status });
+    }
+  };
+}
+
+// src/api/apiHandler.ts
+function createApiHandlerFactory(deps) {
+  return function createApiHandler(options) {
+    return async (request, context) => {
+      const startMs = performance.now();
+      try {
+        let rateLimitHeaders;
+        if (options.rateLimit) {
+          const rateLimitResult = await deps.applyRateLimit(
+            request,
+            options.rateLimit
+          );
+          rateLimitHeaders = {
+            "RateLimit-Limit": String(rateLimitResult.limit),
+            "RateLimit-Remaining": String(rateLimitResult.remaining),
+            "RateLimit-Reset": String(rateLimitResult.reset)
+          };
+          if (!rateLimitResult.success) {
+            return new Response(
+              JSON.stringify({
+                success: false,
+                error: deps.getRateLimitExceededMessage()
+              }),
+              {
+                status: 429,
+                headers: __spreadValues({
+                  "Content-Type": "application/json"
+                }, rateLimitHeaders)
+              }
+            );
+          }
+        }
+        let user;
+        if (options.roles && options.roles.length > 0) {
+          user = await deps.requireRoleFromRequest(request, options.roles);
+        } else if (options.auth) {
+          user = await deps.requireAuthFromRequest(request);
+        }
+        let validatedBody;
+        if (options.schema) {
+          if (typeof options.schema.safeParse === "function") {
+            const body = await request.json();
+            const result = options.schema.safeParse(body);
+            if (!result.success) {
+              return deps.errorResponse(
+                "Validation failed",
+                400,
+                result.error.issues
+              );
+            }
+            validatedBody = result.data;
+          } else {
+            try {
+              validatedBody = await request.json();
+            } catch (e) {
+              validatedBody = void 0;
+            }
+          }
+        }
+        const resolvedParams = (context == null ? void 0 : context.params) ? await context.params : void 0;
+        const response = await options.handler({
+          request,
+          user,
+          body: validatedBody,
+          params: resolvedParams
+        });
+        response.headers.set("Access-Control-Max-Age", "86400");
+        if (rateLimitHeaders) {
+          for (const [key, value] of Object.entries(rateLimitHeaders)) {
+            response.headers.set(key, value);
+          }
+        }
+        deps.logTiming({
+          method: request.method,
+          path: new URL(request.url).pathname,
+          status: response.status,
+          durationMs: Math.round(performance.now() - startMs)
+        });
+        return response;
+      } catch (error) {
+        deps.logTiming({
+          method: request.method,
+          path: new URL(request.url).pathname,
+          durationMs: Math.round(performance.now() - startMs),
+          error: error instanceof Error ? error.message : String(error)
+        });
+        return deps.handleApiError(error);
+      }
+    };
+  };
+}
+
+// src/request-helpers.ts
+var import_errors = require("@mohasinac/errors");
+function readCookieFromHeader(request, name) {
+  var _a;
+  const cookieHeader = (_a = request.headers.get("cookie")) != null ? _a : "";
+  const match = cookieHeader.match(
+    new RegExp(`(?:^|;\\s*)${name}=([^;]+)`)
+  );
+  return match ? decodeURIComponent(match[1]) : void 0;
+}
+function getSearchParams(request) {
+  return new URL(request.url).searchParams;
+}
+function getOptionalSessionCookie(request) {
+  var _a;
+  const cookieValue = (_a = request.cookies) == null ? void 0 : _a.get("__session");
+  if (typeof cookieValue === "string") return cookieValue;
+  if (cookieValue && typeof cookieValue === "object") return cookieValue.value;
+  return readCookieFromHeader(request, "__session");
+}
+function getRequiredSessionCookie(request) {
+  const cookie = getOptionalSessionCookie(request);
+  if (!cookie) throw new import_errors.AuthenticationError("Unauthorized");
+  return cookie;
+}
+function getBooleanParam(searchParams, key) {
+  const value = searchParams.get(key);
+  if (value === null) return void 0;
+  return value === "true";
+}
+function getStringParam(searchParams, key) {
+  const value = searchParams.get(key);
+  if (!value) return void 0;
+  return value;
+}
+function getNumberParam(searchParams, key, fallback, options) {
+  const rawValue = searchParams.get(key);
+  const parsed = rawValue ? Number.parseInt(rawValue, 10) : fallback;
+  const safeValue = Number.isNaN(parsed) ? fallback : parsed;
+  if (typeof (options == null ? void 0 : options.min) === "number" && safeValue < options.min)
+    return options.min;
+  if (typeof (options == null ? void 0 : options.max) === "number" && safeValue > options.max)
+    return options.max;
+  return safeValue;
+}
+
+// src/cache-middleware.ts
+var import_server3 = require("next/server.js");
+var import_core = require("@mohasinac/core");
+var DEFAULT_TTL = 5 * 60 * 1e3;
+var cache = import_core.CacheManager.getInstance(500);
+function buildCacheKey(request, config) {
+  if (config.keyGenerator) return config.keyGenerator(request);
+  const url = new URL(request.url);
+  if (config.includeQuery !== false && url.search)
+    return `${url.pathname}${url.search}`;
+  return url.pathname;
+}
+function isCacheable(request, config) {
+  var _a;
+  if (config.bypassCache) return false;
+  const methods = (_a = config.methods) != null ? _a : ["GET"];
+  return methods.includes(request.method);
+}
+function withCache(handler, config = {}) {
+  return async (request, ...args) => {
+    var _a;
+    if (!isCacheable(request, config)) {
+      return handler(request, ...args);
+    }
+    const key = buildCacheKey(request, config);
+    const cached = cache.get(key);
+    if (cached) {
+      return new import_server3.NextResponse(cached.body, {
+        status: cached.status,
+        headers: cached.headers
+      });
     }
+    const response = await handler(request, ...args);
+    const body = await response.text();
+    const headers = {};
+    response.headers.forEach((value, key2) => {
+      headers[key2] = value;
+    });
+    cache.set(
+      key,
+      { body, status: response.status, headers },
+      { ttl: (_a = config.ttl) != null ? _a : DEFAULT_TTL }
+    );
+    return new import_server3.NextResponse(body, { status: response.status, headers });
   };
 }
+function invalidateCache(pattern) {
+  if (!pattern) {
+    cache.clear();
+    return;
+  }
+  const keys = cache.keys();
+  if (typeof pattern === "string") {
+    for (const key of keys) {
+      if (key.startsWith(pattern)) cache.delete(key);
+    }
+  } else {
+    for (const key of keys) {
+      if (pattern.test(key)) cache.delete(key);
+    }
+  }
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   createApiErrorHandler,
-  createRouteHandler
+  createApiHandlerFactory,
+  createRouteHandler,
+  getBooleanParam,
+  getNumberParam,
+  getOptionalSessionCookie,
+  getRequiredSessionCookie,
+  getSearchParams,
+  getStringParam,
+  invalidateCache,
+  withCache
 });

package/dist/index.d.cts

@@ -1,4 +1,4 @@
-import { NextResponse } from 'next/server';
+import { NextResponse, NextRequest } from 'next/server.js';
 
 /**
  * IAuthVerifier — Injectable auth interface for createApiHandler.
@@ -172,4 +172,111 @@ declare function createRouteHandler<TInput = unknown, TParams = Record<string, s
     params: Promise<TParams>;
 }) => Promise<NextResponse>;
 
-export { type ApiErrorHandlerOptions, type AuthVerifiedUser, type IApiErrorLogger, type IAuthVerifier, type RouteUser, createApiErrorHandler, createRouteHandler };
+interface SafeParseSchema<TInput> {
+    safeParse: (input: unknown) => {
+        success: true;
+        data: TInput;
+    } | {
+        success: false;
+        error: {
+            issues?: unknown[];
+        };
+    };
+}
+interface ApiRateLimitResult {
+    success: boolean;
+    limit: number;
+    remaining: number;
+    reset: number;
+}
+interface ApiHandlerOptions<TInput, TParams extends Record<string, string>, TRole, TRateLimitConfig, TUser> {
+    auth?: boolean;
+    roles?: TRole[];
+    rateLimit?: TRateLimitConfig;
+    schema?: SafeParseSchema<TInput>;
+    handler: (ctx: {
+        request: Request;
+        user?: TUser;
+        body?: TInput;
+        params?: TParams;
+    }) => Promise<Response>;
+}
+interface ApiHandlerFactoryDeps<TRole, TRateLimitConfig, TUser> {
+    applyRateLimit: (request: Request, config: TRateLimitConfig) => Promise<ApiRateLimitResult>;
+    requireAuthFromRequest: (request: Request) => Promise<TUser>;
+    requireRoleFromRequest: (request: Request, roles: TRole[]) => Promise<TUser>;
+    errorResponse: (message: string, status: number, issues?: unknown) => Response;
+    handleApiError: (error: unknown) => Response;
+    getRateLimitExceededMessage: () => string;
+    logTiming: (entry: {
+        method: string;
+        path: string;
+        status?: number;
+        durationMs: number;
+        error?: string;
+    }) => void;
+}
+declare function createApiHandlerFactory<TRole, TRateLimitConfig, TUser>(deps: ApiHandlerFactoryDeps<TRole, TRateLimitConfig, TUser>): <TInput = unknown, TParams extends Record<string, string> = Record<string, string>>(options: ApiHandlerOptions<TInput, TParams, TRole, TRateLimitConfig, TUser>) => (request: Request, context: {
+    params: Promise<TParams>;
+}) => Promise<Response>;
+
+/**
+ * API Request Helpers
+ *
+ * Generic utilities for API route request parsing and session extraction.
+ * Uses structural request types (not NextRequest) to avoid cross-package
+ * type identity issues when multiple Next.js installs exist in a monorepo.
+ */
+interface CookieStoreLike {
+    get(name: string): {
+        value?: string;
+    } | string | undefined;
+}
+type CookieCapableRequest = Request & {
+    cookies?: CookieStoreLike;
+};
+declare function getSearchParams(request: Request): URLSearchParams;
+declare function getOptionalSessionCookie(request: CookieCapableRequest): string | undefined;
+declare function getRequiredSessionCookie(request: CookieCapableRequest): string;
+declare function getBooleanParam(searchParams: URLSearchParams, key: string): boolean | undefined;
+declare function getStringParam(searchParams: URLSearchParams, key: string): string | undefined;
+declare function getNumberParam(searchParams: URLSearchParams, key: string, fallback: number, options?: {
+    min?: number;
+    max?: number;
+}): number;
+
+/**
+ * API Response Cache Middleware
+ *
+ * Wraps a Next.js API handler with in-memory response caching via CacheManager.
+ *
+ * @example
+ * ```ts
+ * export const GET = withCache(
+ *   async (request) => { ... return NextResponse.json(data); },
+ *   { ttl: 5 * 60 * 1000 }
+ * );
+ * ```
+ */
+
+interface CacheConfig {
+    /** Time to live in milliseconds. Default: 5 minutes. */
+    ttl?: number;
+    /** Include query string in cache key. Default: true. */
+    includeQuery?: boolean;
+    /** Custom cache key generator. */
+    keyGenerator?: (request: NextRequest) => string;
+    /** Bypass caching entirely. Default: false. */
+    bypassCache?: boolean;
+    /** Only cache for these HTTP methods. Default: ['GET']. */
+    methods?: string[];
+}
+type Handler = (request: NextRequest, ...args: unknown[]) => Promise<NextResponse>;
+declare function withCache(handler: Handler, config?: CacheConfig): Handler;
+/**
+ * Invalidate cache entries by key prefix or regex pattern.
+ * Pass no argument to clear the entire cache.
+ */
+declare function invalidateCache(pattern?: string | RegExp): void;
+
+export { type ApiErrorHandlerOptions, type ApiHandlerFactoryDeps, type ApiHandlerOptions, type ApiRateLimitResult, type AuthVerifiedUser, type CacheConfig, type IApiErrorLogger, type IAuthVerifier, type RouteUser, createApiErrorHandler, createApiHandlerFactory, createRouteHandler, getBooleanParam, getNumberParam, getOptionalSessionCookie, getRequiredSessionCookie, getSearchParams, getStringParam, invalidateCache, withCache };

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { NextResponse } from 'next/server';
+import { NextResponse, NextRequest } from 'next/server.js';
 
 /**
  * IAuthVerifier — Injectable auth interface for createApiHandler.
@@ -172,4 +172,111 @@ declare function createRouteHandler<TInput = unknown, TParams = Record<string, s
     params: Promise<TParams>;
 }) => Promise<NextResponse>;
 
-export { type ApiErrorHandlerOptions, type AuthVerifiedUser, type IApiErrorLogger, type IAuthVerifier, type RouteUser, createApiErrorHandler, createRouteHandler };
+interface SafeParseSchema<TInput> {
+    safeParse: (input: unknown) => {
+        success: true;
+        data: TInput;
+    } | {
+        success: false;
+        error: {
+            issues?: unknown[];
+        };
+    };
+}
+interface ApiRateLimitResult {
+    success: boolean;
+    limit: number;
+    remaining: number;
+    reset: number;
+}
+interface ApiHandlerOptions<TInput, TParams extends Record<string, string>, TRole, TRateLimitConfig, TUser> {
+    auth?: boolean;
+    roles?: TRole[];
+    rateLimit?: TRateLimitConfig;
+    schema?: SafeParseSchema<TInput>;
+    handler: (ctx: {
+        request: Request;
+        user?: TUser;
+        body?: TInput;
+        params?: TParams;
+    }) => Promise<Response>;
+}
+interface ApiHandlerFactoryDeps<TRole, TRateLimitConfig, TUser> {
+    applyRateLimit: (request: Request, config: TRateLimitConfig) => Promise<ApiRateLimitResult>;
+    requireAuthFromRequest: (request: Request) => Promise<TUser>;
+    requireRoleFromRequest: (request: Request, roles: TRole[]) => Promise<TUser>;
+    errorResponse: (message: string, status: number, issues?: unknown) => Response;
+    handleApiError: (error: unknown) => Response;
+    getRateLimitExceededMessage: () => string;
+    logTiming: (entry: {
+        method: string;
+        path: string;
+        status?: number;
+        durationMs: number;
+        error?: string;
+    }) => void;
+}
+declare function createApiHandlerFactory<TRole, TRateLimitConfig, TUser>(deps: ApiHandlerFactoryDeps<TRole, TRateLimitConfig, TUser>): <TInput = unknown, TParams extends Record<string, string> = Record<string, string>>(options: ApiHandlerOptions<TInput, TParams, TRole, TRateLimitConfig, TUser>) => (request: Request, context: {
+    params: Promise<TParams>;
+}) => Promise<Response>;
+
+/**
+ * API Request Helpers
+ *
+ * Generic utilities for API route request parsing and session extraction.
+ * Uses structural request types (not NextRequest) to avoid cross-package
+ * type identity issues when multiple Next.js installs exist in a monorepo.
+ */
+interface CookieStoreLike {
+    get(name: string): {
+        value?: string;
+    } | string | undefined;
+}
+type CookieCapableRequest = Request & {
+    cookies?: CookieStoreLike;
+};
+declare function getSearchParams(request: Request): URLSearchParams;
+declare function getOptionalSessionCookie(request: CookieCapableRequest): string | undefined;
+declare function getRequiredSessionCookie(request: CookieCapableRequest): string;
+declare function getBooleanParam(searchParams: URLSearchParams, key: string): boolean | undefined;
+declare function getStringParam(searchParams: URLSearchParams, key: string): string | undefined;
+declare function getNumberParam(searchParams: URLSearchParams, key: string, fallback: number, options?: {
+    min?: number;
+    max?: number;
+}): number;
+
+/**
+ * API Response Cache Middleware
+ *
+ * Wraps a Next.js API handler with in-memory response caching via CacheManager.
+ *
+ * @example
+ * ```ts
+ * export const GET = withCache(
+ *   async (request) => { ... return NextResponse.json(data); },
+ *   { ttl: 5 * 60 * 1000 }
+ * );
+ * ```
+ */
+
+interface CacheConfig {
+    /** Time to live in milliseconds. Default: 5 minutes. */
+    ttl?: number;
+    /** Include query string in cache key. Default: true. */
+    includeQuery?: boolean;
+    /** Custom cache key generator. */
+    keyGenerator?: (request: NextRequest) => string;
+    /** Bypass caching entirely. Default: false. */
+    bypassCache?: boolean;
+    /** Only cache for these HTTP methods. Default: ['GET']. */
+    methods?: string[];
+}
+type Handler = (request: NextRequest, ...args: unknown[]) => Promise<NextResponse>;
+declare function withCache(handler: Handler, config?: CacheConfig): Handler;
+/**
+ * Invalidate cache entries by key prefix or regex pattern.
+ * Pass no argument to clear the entire cache.
+ */
+declare function invalidateCache(pattern?: string | RegExp): void;
+
+export { type ApiErrorHandlerOptions, type ApiHandlerFactoryDeps, type ApiHandlerOptions, type ApiRateLimitResult, type AuthVerifiedUser, type CacheConfig, type IApiErrorLogger, type IAuthVerifier, type RouteUser, createApiErrorHandler, createApiHandlerFactory, createRouteHandler, getBooleanParam, getNumberParam, getOptionalSessionCookie, getRequiredSessionCookie, getSearchParams, getStringParam, invalidateCache, withCache };

package/dist/index.js

@@ -16,7 +16,7 @@ var __spreadValues = (a, b) => {
 };
 
 // src/api/errorHandler.ts
-import { NextResponse } from "next/server";
+import { NextResponse } from "next/server.js";
 function createApiErrorHandler(options) {
   const {
     isAppError,
@@ -62,7 +62,7 @@ function createApiErrorHandler(options) {
 }
 
 // src/api/routeHandler.ts
-import { NextResponse as NextResponse2 } from "next/server";
+import { NextResponse as NextResponse2 } from "next/server.js";
 import { getProviders } from "@mohasinac/contracts";
 function readSessionCookie(request) {
   var _a;
@@ -147,14 +147,221 @@ function createRouteHandler(options) {
       const status = typeof (err == null ? void 0 : err.status) === "number" ? err.status : 500;
       const message = err instanceof Error ? err.message : "Internal server error";
       console.error(`[createRouteHandler] ${request.method} failed`, err);
-      return NextResponse2.json(
-        { success: false, error: message },
-        { status }
-      );
+      return NextResponse2.json({ success: false, error: message }, { status });
+    }
+  };
+}
+
+// src/api/apiHandler.ts
+function createApiHandlerFactory(deps) {
+  return function createApiHandler(options) {
+    return async (request, context) => {
+      const startMs = performance.now();
+      try {
+        let rateLimitHeaders;
+        if (options.rateLimit) {
+          const rateLimitResult = await deps.applyRateLimit(
+            request,
+            options.rateLimit
+          );
+          rateLimitHeaders = {
+            "RateLimit-Limit": String(rateLimitResult.limit),
+            "RateLimit-Remaining": String(rateLimitResult.remaining),
+            "RateLimit-Reset": String(rateLimitResult.reset)
+          };
+          if (!rateLimitResult.success) {
+            return new Response(
+              JSON.stringify({
+                success: false,
+                error: deps.getRateLimitExceededMessage()
+              }),
+              {
+                status: 429,
+                headers: __spreadValues({
+                  "Content-Type": "application/json"
+                }, rateLimitHeaders)
+              }
+            );
+          }
+        }
+        let user;
+        if (options.roles && options.roles.length > 0) {
+          user = await deps.requireRoleFromRequest(request, options.roles);
+        } else if (options.auth) {
+          user = await deps.requireAuthFromRequest(request);
+        }
+        let validatedBody;
+        if (options.schema) {
+          if (typeof options.schema.safeParse === "function") {
+            const body = await request.json();
+            const result = options.schema.safeParse(body);
+            if (!result.success) {
+              return deps.errorResponse(
+                "Validation failed",
+                400,
+                result.error.issues
+              );
+            }
+            validatedBody = result.data;
+          } else {
+            try {
+              validatedBody = await request.json();
+            } catch (e) {
+              validatedBody = void 0;
+            }
+          }
+        }
+        const resolvedParams = (context == null ? void 0 : context.params) ? await context.params : void 0;
+        const response = await options.handler({
+          request,
+          user,
+          body: validatedBody,
+          params: resolvedParams
+        });
+        response.headers.set("Access-Control-Max-Age", "86400");
+        if (rateLimitHeaders) {
+          for (const [key, value] of Object.entries(rateLimitHeaders)) {
+            response.headers.set(key, value);
+          }
+        }
+        deps.logTiming({
+          method: request.method,
+          path: new URL(request.url).pathname,
+          status: response.status,
+          durationMs: Math.round(performance.now() - startMs)
+        });
+        return response;
+      } catch (error) {
+        deps.logTiming({
+          method: request.method,
+          path: new URL(request.url).pathname,
+          durationMs: Math.round(performance.now() - startMs),
+          error: error instanceof Error ? error.message : String(error)
+        });
+        return deps.handleApiError(error);
+      }
+    };
+  };
+}
+
+// src/request-helpers.ts
+import { AuthenticationError } from "@mohasinac/errors";
+function readCookieFromHeader(request, name) {
+  var _a;
+  const cookieHeader = (_a = request.headers.get("cookie")) != null ? _a : "";
+  const match = cookieHeader.match(
+    new RegExp(`(?:^|;\\s*)${name}=([^;]+)`)
+  );
+  return match ? decodeURIComponent(match[1]) : void 0;
+}
+function getSearchParams(request) {
+  return new URL(request.url).searchParams;
+}
+function getOptionalSessionCookie(request) {
+  var _a;
+  const cookieValue = (_a = request.cookies) == null ? void 0 : _a.get("__session");
+  if (typeof cookieValue === "string") return cookieValue;
+  if (cookieValue && typeof cookieValue === "object") return cookieValue.value;
+  return readCookieFromHeader(request, "__session");
+}
+function getRequiredSessionCookie(request) {
+  const cookie = getOptionalSessionCookie(request);
+  if (!cookie) throw new AuthenticationError("Unauthorized");
+  return cookie;
+}
+function getBooleanParam(searchParams, key) {
+  const value = searchParams.get(key);
+  if (value === null) return void 0;
+  return value === "true";
+}
+function getStringParam(searchParams, key) {
+  const value = searchParams.get(key);
+  if (!value) return void 0;
+  return value;
+}
+function getNumberParam(searchParams, key, fallback, options) {
+  const rawValue = searchParams.get(key);
+  const parsed = rawValue ? Number.parseInt(rawValue, 10) : fallback;
+  const safeValue = Number.isNaN(parsed) ? fallback : parsed;
+  if (typeof (options == null ? void 0 : options.min) === "number" && safeValue < options.min)
+    return options.min;
+  if (typeof (options == null ? void 0 : options.max) === "number" && safeValue > options.max)
+    return options.max;
+  return safeValue;
+}
+
+// src/cache-middleware.ts
+import { NextResponse as NextResponse3 } from "next/server.js";
+import { CacheManager } from "@mohasinac/core";
+var DEFAULT_TTL = 5 * 60 * 1e3;
+var cache = CacheManager.getInstance(500);
+function buildCacheKey(request, config) {
+  if (config.keyGenerator) return config.keyGenerator(request);
+  const url = new URL(request.url);
+  if (config.includeQuery !== false && url.search)
+    return `${url.pathname}${url.search}`;
+  return url.pathname;
+}
+function isCacheable(request, config) {
+  var _a;
+  if (config.bypassCache) return false;
+  const methods = (_a = config.methods) != null ? _a : ["GET"];
+  return methods.includes(request.method);
+}
+function withCache(handler, config = {}) {
+  return async (request, ...args) => {
+    var _a;
+    if (!isCacheable(request, config)) {
+      return handler(request, ...args);
+    }
+    const key = buildCacheKey(request, config);
+    const cached = cache.get(key);
+    if (cached) {
+      return new NextResponse3(cached.body, {
+        status: cached.status,
+        headers: cached.headers
+      });
     }
+    const response = await handler(request, ...args);
+    const body = await response.text();
+    const headers = {};
+    response.headers.forEach((value, key2) => {
+      headers[key2] = value;
+    });
+    cache.set(
+      key,
+      { body, status: response.status, headers },
+      { ttl: (_a = config.ttl) != null ? _a : DEFAULT_TTL }
+    );
+    return new NextResponse3(body, { status: response.status, headers });
   };
 }
+function invalidateCache(pattern) {
+  if (!pattern) {
+    cache.clear();
+    return;
+  }
+  const keys = cache.keys();
+  if (typeof pattern === "string") {
+    for (const key of keys) {
+      if (key.startsWith(pattern)) cache.delete(key);
+    }
+  } else {
+    for (const key of keys) {
+      if (pattern.test(key)) cache.delete(key);
+    }
+  }
+}
 export {
   createApiErrorHandler,
-  createRouteHandler
+  createApiHandlerFactory,
+  createRouteHandler,
+  getBooleanParam,
+  getNumberParam,
+  getOptionalSessionCookie,
+  getRequiredSessionCookie,
+  getSearchParams,
+  getStringParam,
+  invalidateCache,
+  withCache
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mohasinac/next",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "publishConfig": {
     "access": "public"
   },
@@ -29,7 +29,9 @@
     "zod": ">=3"
   },
   "dependencies": {
-    "@mohasinac/contracts": "^1.0.0"
+    "@mohasinac/contracts": "^1.1.0",
+    "@mohasinac/core": "^1.1.0",
+    "@mohasinac/errors": "^1.1.0"
   },
   "devDependencies": {
     "tsup": "^8.5.0",