@vunexa/lixa 0.1.6-alpha.8 → 0.1.6-alpha.9

package/dist/express.d.ts

@@ -0,0 +1,103 @@
+import { Lixa } from "./lixa";
+import { type CookieOptions } from "./utils/cookies";
+/**
+ * Duck-typed Express request interface for framework-agnostic typing.
+ * @public
+ */
+export interface ExpressLikeRequest {
+    cookies?: Record<string, string>;
+    sessionInfo?: any;
+    sessionId?: string;
+    [key: string]: any;
+}
+/**
+ * Duck-typed Express response interface for framework-agnostic typing.
+ * @public
+ */
+export interface ExpressLikeResponse {
+    cookie(name: string, value: string, options?: any): any;
+    status(code: number): this;
+    json(body: any): any;
+    redirect?(url: string): any;
+    [key: string]: any;
+}
+/**
+ * Express-compatible NextFunction type.
+ * @public
+ */
+export type ExpressLikeNextFunction = (err?: any) => void;
+/**
+ * Express-compatible RequestHandler type.
+ * @public
+ */
+export type ExpressLikeRequestHandler = (req: ExpressLikeRequest, res: ExpressLikeResponse, next: ExpressLikeNextFunction) => any;
+/**
+ * Options for Express authentication helpers.
+ * @public
+ */
+export interface ExpressAuthHelperOptions {
+    sessionCookieName?: string;
+    sessionCookieOptions?: CookieOptions;
+    stateCookieOptions?: CookieOptions;
+    successRedirectUrl?: string;
+    errorRedirectUrl?: string;
+}
+/**
+ * Sets an RFC 6265bis compliant session cookie on an Express response.
+ *
+ * @param res - Express response object
+ * @param sessionId - Unique session ID
+ * @param options - Optional cookie attribute overrides
+ *
+ * @public
+ */
+export declare function setSessionCookieOnResponse(res: ExpressLikeResponse, sessionId: string, options?: CookieOptions): void;
+/**
+ * Clears the session cookie on an Express response.
+ *
+ * @param res - Express response object
+ * @param options - Optional cookie attribute overrides
+ *
+ * @public
+ */
+export declare function clearSessionCookieOnResponse(res: ExpressLikeResponse, options?: CookieOptions): void;
+/**
+ * Sets an OAuth CSRF state cookie on an Express response.
+ *
+ * @param res - Express response object
+ * @param state - OAuth state parameter
+ * @param options - Optional cookie attribute overrides
+ *
+ * @public
+ */
+export declare function setStateCookieOnResponse(res: ExpressLikeResponse, state: string, options?: CookieOptions): void;
+/**
+ * Clears the OAuth CSRF state cookie on an Express response.
+ *
+ * @param res - Express response object
+ * @param options - Optional cookie attribute overrides
+ *
+ * @public
+ */
+export declare function clearStateCookieOnResponse(res: ExpressLikeResponse, options?: CookieOptions): void;
+/**
+ * Creates an Express authentication middleware that verifies the session cookie and populates req.sessionInfo.
+ *
+ * @param lixa - Lixa instance
+ * @param options - Optional session cookie name and custom unauthorized handler
+ *
+ * @example
+ * ```typescript
+ * const requireAuth = createRequireAuthMiddleware(lixa);
+ * app.get('/protected', requireAuth, (req, res) => {
+ *   res.json({ user: req.sessionInfo });
+ * });
+ * ```
+ *
+ * @public
+ */
+export declare function createRequireAuthMiddleware(lixa: Lixa<any>, options?: {
+    sessionCookieName?: string;
+    unauthorizedHandler?: (req: ExpressLikeRequest, res: ExpressLikeResponse) => void;
+}): ExpressLikeRequestHandler;
+//# sourceMappingURL=express.d.ts.map

package/dist/express.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"express.d.ts","sourceRoot":"","sources":["../src/express.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAC9B,OAAO,EAML,KAAK,aAAa,EACnB,MAAM,iBAAiB,CAAC;AAEzB;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,WAAW,CAAC,EAAE,GAAG,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAED;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAClC,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,GAAG,GAAG,CAAC;IACxD,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,IAAI,CAAC,IAAI,EAAE,GAAG,GAAG,GAAG,CAAC;IACrB,QAAQ,CAAC,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;IAC5B,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAED;;;GAGG;AACH,MAAM,MAAM,uBAAuB,GAAG,CAAC,GAAG,CAAC,EAAE,GAAG,KAAK,IAAI,CAAC;AAE1D;;;GAGG;AACH,MAAM,MAAM,yBAAyB,GAAG,CACtC,GAAG,EAAE,kBAAkB,EACvB,GAAG,EAAE,mBAAmB,EACxB,IAAI,EAAE,uBAAuB,KAC1B,GAAG,CAAC;AAET;;;GAGG;AACH,MAAM,WAAW,wBAAwB;IACvC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,oBAAoB,CAAC,EAAE,aAAa,CAAC;IACrC,kBAAkB,CAAC,EAAE,aAAa,CAAC;IACnC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;;;;;;;GAQG;AACH,wBAAgB,0BAA0B,CACxC,GAAG,EAAE,mBAAmB,EACxB,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,aAAa,GACtB,IAAI,CAGN;AAED;;;;;;;GAOG;AACH,wBAAgB,4BAA4B,CAC1C,GAAG,EAAE,mBAAmB,EACxB,OAAO,CAAC,EAAE,aAAa,GACtB,IAAI,CAGN;AAED;;;;;;;;GAQG;AACH,wBAAgB,wBAAwB,CACtC,GAAG,EAAE,mBAAmB,EACxB,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,aAAa,GACtB,IAAI,CAGN;AAED;;;;;;;GAOG;AACH,wBAAgB,0BAA0B,CACxC,GAAG,EAAE,mBAAmB,EACxB,OAAO,CAAC,EAAE,aAAa,GACtB,IAAI,CAGN;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,2BAA2B,CACzC,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,EACf,OAAO,CAAC,EAAE;IACR,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,mBAAmB,CAAC,EAAE,CAAC,GAAG,EAAE,kBAAkB,EAAE,GAAG,EAAE,mBAAmB,KAAK,IAAI,CAAC;CACnF,GACA,yBAAyB,CAgC3B"}