@veloxts/auth 0.4.0 → 0.4.2

package/dist/utils/cookie-support.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Cookie Plugin Support Utilities
+ *
+ * Shared type guards and utilities for @fastify/cookie plugin detection.
+ * Used by both session and CSRF modules.
+ *
+ * @module auth/utils/cookie-support
+ */
+import type { FastifyReply, FastifyRequest } from 'fastify';
+/**
+ * Cookie serialization options (mirrors @fastify/cookie types)
+ */
+export interface CookieSerializeOptions {
+    domain?: string;
+    path?: string;
+    sameSite?: 'strict' | 'lax' | 'none' | boolean;
+    secure?: boolean;
+    httpOnly?: boolean;
+    maxAge?: number;
+    expires?: Date;
+}
+/**
+ * Fastify reply with cookie methods from @fastify/cookie plugin
+ */
+export interface FastifyReplyWithCookies extends FastifyReply {
+    cookie(name: string, value: string, options?: CookieSerializeOptions): FastifyReply;
+    clearCookie(name: string, options?: CookieSerializeOptions): FastifyReply;
+}
+/**
+ * Fastify request with cookies from @fastify/cookie plugin
+ */
+export interface FastifyRequestWithCookies extends FastifyRequest {
+    cookies: Record<string, string | undefined>;
+}
+/**
+ * Check if request has cookie support from @fastify/cookie plugin
+ */
+export declare function hasCookieSupport(request: FastifyRequest): request is FastifyRequestWithCookies;
+/**
+ * Check if reply has cookie methods from @fastify/cookie plugin
+ */
+export declare function hasReplyCookieSupport(reply: FastifyReply): reply is FastifyReplyWithCookies;
+/**
+ * Options for cookie context validation
+ */
+export interface CookieContextValidationOptions {
+    /**
+     * Name of the middleware requiring cookies (for error message)
+     * @default 'This middleware'
+     */
+    middlewareName?: string;
+}
+/**
+ * Get request and reply with validated cookie support
+ * @throws Error with helpful message if @fastify/cookie plugin is not registered
+ */
+export declare function getValidatedCookieContext(request: FastifyRequest, reply: FastifyReply, options?: CookieContextValidationOptions): {
+    request: FastifyRequestWithCookies;
+    reply: FastifyReplyWithCookies;
+};
+//# sourceMappingURL=cookie-support.d.ts.map

package/dist/utils/cookie-support.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cookie-support.d.ts","sourceRoot":"","sources":["../../src/utils/cookie-support.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAM5D;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,QAAQ,GAAG,KAAK,GAAG,MAAM,GAAG,OAAO,CAAC;IAC/C,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,IAAI,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,uBAAwB,SAAQ,YAAY;IAC3D,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,sBAAsB,GAAG,YAAY,CAAC;IACpF,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,sBAAsB,GAAG,YAAY,CAAC;CAC3E;AAED;;GAEG;AACH,MAAM,WAAW,yBAA0B,SAAQ,cAAc;IAC/D,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;CAC7C;AAMD;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,IAAI,yBAAyB,CAE9F;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,YAAY,GAAG,KAAK,IAAI,uBAAuB,CAE3F;AAMD;;GAEG;AACH,MAAM,WAAW,8BAA8B;IAC7C;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,cAAc,EACvB,KAAK,EAAE,YAAY,EACnB,OAAO,GAAE,8BAAmC,GAC3C;IAAE,OAAO,EAAE,yBAAyB,CAAC;IAAC,KAAK,EAAE,uBAAuB,CAAA;CAAE,CAYxE"}

package/dist/utils/cookie-support.js

@@ -0,0 +1,38 @@
+/**
+ * Cookie Plugin Support Utilities
+ *
+ * Shared type guards and utilities for @fastify/cookie plugin detection.
+ * Used by both session and CSRF modules.
+ *
+ * @module auth/utils/cookie-support
+ */
+// ============================================================================
+// Type Guards
+// ============================================================================
+/**
+ * Check if request has cookie support from @fastify/cookie plugin
+ */
+export function hasCookieSupport(request) {
+    return 'cookies' in request && request.cookies !== null && typeof request.cookies === 'object';
+}
+/**
+ * Check if reply has cookie methods from @fastify/cookie plugin
+ */
+export function hasReplyCookieSupport(reply) {
+    return 'cookie' in reply && typeof reply.cookie === 'function';
+}
+/**
+ * Get request and reply with validated cookie support
+ * @throws Error with helpful message if @fastify/cookie plugin is not registered
+ */
+export function getValidatedCookieContext(request, reply, options = {}) {
+    const middlewareName = options.middlewareName ?? 'This middleware';
+    if (!hasCookieSupport(request) || !hasReplyCookieSupport(reply)) {
+        throw new Error(`${middlewareName} requires @fastify/cookie plugin. ` +
+            'Please register it before using this middleware:\n\n' +
+            "  import cookie from '@fastify/cookie';\n" +
+            '  await app.register(cookie);\n');
+    }
+    return { request, reply };
+}
+//# sourceMappingURL=cookie-support.js.map

package/dist/utils/cookie-support.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cookie-support.js","sourceRoot":"","sources":["../../src/utils/cookie-support.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAoCH,+EAA+E;AAC/E,cAAc;AACd,+EAA+E;AAE/E;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAAuB;IACtD,OAAO,SAAS,IAAI,OAAO,IAAI,OAAO,CAAC,OAAO,KAAK,IAAI,IAAI,OAAO,OAAO,CAAC,OAAO,KAAK,QAAQ,CAAC;AACjG,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,qBAAqB,CAAC,KAAmB;IACvD,OAAO,QAAQ,IAAI,KAAK,IAAI,OAAO,KAAK,CAAC,MAAM,KAAK,UAAU,CAAC;AACjE,CAAC;AAiBD;;;GAGG;AACH,MAAM,UAAU,yBAAyB,CACvC,OAAuB,EACvB,KAAmB,EACnB,UAA0C,EAAE;IAE5C,MAAM,cAAc,GAAG,OAAO,CAAC,cAAc,IAAI,iBAAiB,CAAC;IAEnE,IAAI,CAAC,gBAAgB,CAAC,OAAO,CAAC,IAAI,CAAC,qBAAqB,CAAC,KAAK,CAAC,EAAE,CAAC;QAChE,MAAM,IAAI,KAAK,CACb,GAAG,cAAc,oCAAoC;YACnD,sDAAsD;YACtD,2CAA2C;YAC3C,iCAAiC,CACpC,CAAC;IACJ,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;AAC5B,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@veloxts/auth",
-  "version": "0.4.0",
+  "version": "0.4.2",
   "description": "Authentication and authorization system for VeloxTS framework",
   "type": "module",
   "main": "dist/index.js",
@@ -42,8 +42,8 @@
   "dependencies": {
     "@fastify/cookie": "11.0.2",
     "fastify": "5.6.2",
-    "@veloxts/core": "0.4.0",
-    "@veloxts/router": "0.4.0"
+    "@veloxts/core": "0.4.2",
+    "@veloxts/router": "0.4.2"
   },
   "peerDependencies": {
     "argon2": ">=0.30.0",
@@ -67,8 +67,8 @@
     "fastify-plugin": "5.1.0",
     "typescript": "5.9.3",
     "vitest": "4.0.15",
-    "@veloxts/testing": "0.1.0",
-    "@veloxts/validation": "0.4.0"
+    "@veloxts/testing": "0.1.2",
+    "@veloxts/validation": "0.4.2"
   },
   "keywords": [
     "velox",