@tidecloak/nextjs 0.13.11 → 0.13.13

package/dist/types/server/tokenExchange.d.ts

@@ -0,0 +1,128 @@
+import { NextRequest, NextResponse } from 'next/server';
+/**
+ * Token exchange configuration for hybrid mode
+ */
+export interface TokenExchangeConfig {
+    /** TideCloak server URL (e.g., "https://auth.example.com") */
+    authServerUrl: string;
+    /** TideCloak realm name */
+    realm: string;
+    /** Client ID registered in TideCloak */
+    clientId: string;
+    /** Client secret (for confidential clients) */
+    clientSecret?: string;
+}
+/**
+ * Token response from TideCloak
+ */
+export interface TokenResponse {
+    access_token: string;
+    refresh_token?: string;
+    id_token?: string;
+    expires_in: number;
+    refresh_expires_in?: number;
+    token_type: string;
+    scope?: string;
+}
+/**
+ * Authorization code data sent from the client
+ */
+export interface AuthCodeData {
+    code: string;
+    code_verifier: string;
+    redirect_uri: string;
+}
+/**
+ * Exchange an authorization code for tokens.
+ * Use this in your Next.js API route to complete the hybrid mode flow.
+ *
+ * @example
+ * ```ts
+ * // app/api/auth/callback/route.ts
+ * import { exchangeCodeForTokens } from '@tidecloak/nextjs/server';
+ *
+ * export async function POST(req: NextRequest) {
+ *   const body = await req.json();
+ *   const authData = JSON.parse(body.accessToken);
+ *
+ *   const result = await exchangeCodeForTokens({
+ *     authServerUrl: process.env.TIDECLOAK_URL!,
+ *     realm: process.env.TIDECLOAK_REALM!,
+ *     clientId: process.env.TIDECLOAK_CLIENT_ID!,
+ *   }, authData);
+ *
+ *   if (!result.success) {
+ *     return NextResponse.json({ error: result.error }, { status: 401 });
+ *   }
+ *
+ *   // Store tokens server-side and create session
+ *   return NextResponse.json({ success: true });
+ * }
+ * ```
+ */
+export declare function exchangeCodeForTokens(config: TokenExchangeConfig, authData: AuthCodeData): Promise<{
+    success: true;
+    tokens: TokenResponse;
+} | {
+    success: false;
+    error: string;
+}>;
+/**
+ * Refresh an access token using a refresh token.
+ * Use this to get a new access token when the current one expires.
+ *
+ * @example
+ * ```ts
+ * const result = await refreshAccessToken({
+ *   authServerUrl: process.env.TIDECLOAK_URL!,
+ *   realm: process.env.TIDECLOAK_REALM!,
+ *   clientId: process.env.TIDECLOAK_CLIENT_ID!,
+ * }, session.tokens.refresh_token);
+ *
+ * if (result.success) {
+ *   // Update stored tokens
+ *   session.tokens = result.tokens;
+ * }
+ * ```
+ */
+export declare function refreshAccessToken(config: TokenExchangeConfig, refreshToken: string): Promise<{
+    success: true;
+    tokens: TokenResponse;
+} | {
+    success: false;
+    error: string;
+}>;
+/**
+ * Parse the auth data from the client request body.
+ * The client sends the authorization code data as a JSON string in accessToken field.
+ */
+export declare function parseAuthCodeData(requestBody: {
+    accessToken?: string;
+}): AuthCodeData | null;
+/**
+ * Create a session cookie response helper.
+ *
+ * @example
+ * ```ts
+ * const response = NextResponse.json({ success: true });
+ * setSessionCookie(response, sessionId, { maxAge: 86400 });
+ * return response;
+ * ```
+ */
+export declare function setSessionCookie(response: NextResponse, sessionId: string, options?: {
+    name?: string;
+    maxAge?: number;
+    path?: string;
+    secure?: boolean;
+    sameSite?: 'strict' | 'lax' | 'none';
+    httpOnly?: boolean;
+}): void;
+/**
+ * Get session ID from request cookies
+ */
+export declare function getSessionFromRequest(req: NextRequest, cookieName?: string): string | null;
+/**
+ * Clear session cookie
+ */
+export declare function clearSessionCookie(response: NextResponse, cookieName?: string): void;
+//# sourceMappingURL=tokenExchange.d.ts.map

package/dist/types/server/tokenExchange.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokenExchange.d.ts","sourceRoot":"","sources":["../../../src/server/tokenExchange.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAEvD;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,8DAA8D;IAC9D,aAAa,EAAE,MAAM,CAAA;IACrB,2BAA2B;IAC3B,KAAK,EAAE,MAAM,CAAA;IACb,wCAAwC;IACxC,QAAQ,EAAE,MAAM,CAAA;IAChB,+CAA+C;IAC/C,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,YAAY,EAAE,MAAM,CAAA;IACpB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,UAAU,EAAE,MAAM,CAAA;IAClB,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAC3B,UAAU,EAAE,MAAM,CAAA;IAClB,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAA;IACZ,aAAa,EAAE,MAAM,CAAA;IACrB,YAAY,EAAE,MAAM,CAAA;CACrB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,mBAAmB,EAC3B,QAAQ,EAAE,YAAY,GACrB,OAAO,CAAC;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,aAAa,CAAA;CAAE,GAAG;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAgCvF;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,mBAAmB,EAC3B,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,aAAa,CAAA;CAAE,GAAG;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CA8BvF;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,WAAW,EAAE;IAAE,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,YAAY,GAAG,IAAI,CAgB5F;AAED;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,YAAY,EACtB,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE;IACP,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,QAAQ,CAAC,EAAE,QAAQ,GAAG,KAAK,GAAG,MAAM,CAAA;IACpC,QAAQ,CAAC,EAAE,OAAO,CAAA;CACd,GACL,IAAI,CAiBN;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,GAAG,EAAE,WAAW,EAChB,UAAU,GAAE,MAAkB,GAC7B,MAAM,GAAG,IAAI,CAEf;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,YAAY,EACtB,UAAU,GAAE,MAAkB,GAC7B,IAAI,CAEN"}

package/package.json

@@ -1,17 +1,20 @@
 {
   "name": "@tidecloak/nextjs",
-  "version": "0.13.11",
+  "version": "0.13.13",
   "description": "TideCloak nextjs SDK",
   "exports": {
     ".": {
-      "import": "./dist/esm/index.js",
       "types": "./dist/types/index.d.ts",
-      "require": "./dist/cjs/index.js"
+      "import": "./dist/esm/index.js",
+      "require": "./dist/cjs/index.js",
+      "default": "./dist/esm/index.js"
     },
     "./server": {
-      "import": "./dist/esm/server/index.js",
       "types": "./dist/types/server/index.d.ts",
-      "require": "./dist/cjs/server/index.js"
+      "edge-light": "./dist/esm/server/index.js",
+      "import": "./dist/esm/server/index.js",
+      "require": "./dist/cjs/server/index.js",
+      "default": "./dist/esm/server/index.js"
     }
   },
   "files": [
@@ -48,11 +51,13 @@
     "prepare": "npm run build"
   },
   "dependencies": {
-    "@tidecloak/react": "^0.13.11",
-    "@tidecloak/verify": "^0.13.11"
+    "@tidecloak/react": "^0.13.13",
+    "@tidecloak/verify": "^0.13.13"
   },
   "devDependencies": {
+    "@types/node": "^22.0.0",
     "@types/react": "^19.1.8",
-    "@types/react-dom": "^19.1.6"
+    "@types/react-dom": "^19.1.6",
+    "next": "^15.0.0"
   }
 }