@xylex-group/athena 2.12.1 → 2.14.0

package/dist/next/server.d.cts

@@ -1,7 +1,83 @@
-import { an as AthenaAuthSessionResponse, bI as AthenaClientSessionLike, cA as AthenaSdkClientWithStorage, cz as AthenaSdkClientWithAuth } from '../client-CMtx5P4D.cjs';
-import { A as AthenaAdapterBaseOptions, b as AthenaServerRequestOptions, a as AthenaAdapterExperimentalOptions } from '../shared-DZSGAmXs.cjs';
-import '../types-BRUHGXo2.cjs';
-import '../types-Bez4HSbI.cjs';
+import { al as AthenaClientSessionLike, aX as AthenaSdkClientWithStorage, aW as AthenaSdkClientWithAuth } from '../client-wU2J9yqb.cjs';
+import { ae as AthenaAuthSessionResponse } from '../types-eAKAh71s.cjs';
+import { i as AthenaAuthSessionBridgeOptions, j as AthenaAuthSessionBridgePathOptions, A as AthenaAdapterBaseOptions, k as AthenaServerRequestOptions, a as AthenaAdapterExperimentalOptions } from '../payload-zXIwKTQf.cjs';
+export { b as ATHENA_AUTH_SESSION_BRIDGE_ROUTE, c as ATHENA_AUTH_SESSION_COOKIE_NAME, d as ATHENA_AUTH_SESSION_COOKIE_NAMES, e as AthenaAuthSessionBridgeClientOptions, f as AthenaAuthSessionBridgePayload, g as AthenaAuthSessionBridgeSource, h as clearAthenaAuthSessionOnAppHost, p as persistAthenaAuthSessionOnAppHost, r as resolveSessionBridgePayload } from '../payload-zXIwKTQf.cjs';
+export { S as SESSION_COOKIE_PATTERNS, h as hasAuthSessionCookie } from '../session-cookie-detection-BqOp9mO6.cjs';
+import '../types-YQUR7wu0.cjs';
+import '../types-6H575ITc.cjs';
+
+/**
+ * Handle bridge `POST` — set an httpOnly session cookie from JSON body.
+ *
+ * Expected body: `{ "token": string, "expiresAt"?: string }`.
+ *
+ * @param request - Incoming request (JSON body)
+ * @param options - Cookie / route configuration
+ * @returns `200` on success, `400` when token is missing
+ */
+declare function handleAthenaAuthSessionBridgePost(request: Request, options?: AthenaAuthSessionBridgeOptions): Promise<Response>;
+/**
+ * Handle bridge `DELETE` — clear bridged session cookie name variants.
+ *
+ * @param request - Incoming request (used for Secure detection)
+ * @param options - Cookie / route configuration
+ * @returns `200` with clear `Set-Cookie` headers
+ */
+declare function handleAthenaAuthSessionBridgeDelete(request: Request, options?: AthenaAuthSessionBridgeOptions): Response;
+/**
+ * Create dedicated App Router handlers for the session bridge.
+ *
+ * Drop into a route file with no additional wiring:
+ *
+ * @example
+ * ```ts
+ * // app/api/athena-auth/session/route.ts
+ * import { createAthenaAuthSessionBridgeHandlers } from '@xylex-group/athena/next/server'
+ *
+ * export const { POST, DELETE } = createAthenaAuthSessionBridgeHandlers()
+ * ```
+ *
+ * @param options - Optional cookie name, path, SameSite, Secure overrides
+ * @returns Object with `POST` and `DELETE` route handlers
+ */
+declare function createAthenaAuthSessionBridgeHandlers(options?: AthenaAuthSessionBridgeOptions): {
+    POST: (request: Request) => Promise<Response>;
+    DELETE: (request: Request) => Response;
+};
+/**
+ * Whether this request should be handled as a session bridge call.
+ *
+ * Returns true when:
+ * - the pathname equals the configured `route`, or
+ * - the final path segment is listed in `matchPaths` (default `session`)
+ *
+ * @param request - Incoming request
+ * @param options - Route + matchPaths configuration
+ */
+declare function isAthenaAuthSessionBridgePath(request: Request, options?: AthenaAuthSessionBridgePathOptions): boolean;
+/**
+ * Create catch-all / `[path]` handlers that only service session-bridge paths.
+ *
+ * Non-matching paths return `404` with `{ error: 'Not found' }` so you can
+ * mount under `/api/auth/[...path]` without implementing a full auth proxy.
+ *
+ * @example
+ * ```ts
+ * // app/api/auth/[...path]/route.ts
+ * import { createAthenaAuthSessionBridgePathHandlers } from '@xylex-group/athena/next/server'
+ *
+ * export const { POST, DELETE } = createAthenaAuthSessionBridgePathHandlers({
+ *   route: '/api/auth/session',
+ * })
+ * ```
+ *
+ * @param options - Bridge options plus `matchPaths`
+ * @returns Object with `POST` and `DELETE` route handlers
+ */
+declare function createAthenaAuthSessionBridgePathHandlers(options?: AthenaAuthSessionBridgePathOptions): {
+    POST: (request: Request) => Promise<Response>;
+    DELETE: (request: Request) => Response;
+};
 
 interface AthenaServerClientOptions extends AthenaAdapterBaseOptions, AthenaServerRequestOptions {
     session?: AthenaClientSessionLike | AthenaAuthSessionResponse | null;
@@ -50,4 +126,4 @@ declare function resolveAthenaServerContext(options: AthenaServerContextOptionsW
 declare function resolveAthenaServerContext(options: AthenaServerContextOptionsWithTypecheckedColumns): Promise<AthenaResolvedServerContext<AthenaSdkClientWithAuth<true>>>;
 declare function resolveAthenaServerContext(options?: AthenaServerContextOptions): Promise<AthenaResolvedServerContext<AthenaSdkClientWithAuth<false>>>;
 
-export { type AthenaResolvedServerContext, type AthenaServerClientOptions, type AthenaServerContextOptions, createAthenaServerClient, resolveAthenaServerContext };
+export { AthenaAuthSessionBridgeOptions, AthenaAuthSessionBridgePathOptions, type AthenaResolvedServerContext, type AthenaServerClientOptions, type AthenaServerContextOptions, createAthenaAuthSessionBridgeHandlers, createAthenaAuthSessionBridgePathHandlers, createAthenaServerClient, handleAthenaAuthSessionBridgeDelete, handleAthenaAuthSessionBridgePost, isAthenaAuthSessionBridgePath, resolveAthenaServerContext };

package/dist/next/server.d.ts

@@ -1,7 +1,83 @@
-import { an as AthenaAuthSessionResponse, bI as AthenaClientSessionLike, cA as AthenaSdkClientWithStorage, cz as AthenaSdkClientWithAuth } from '../client-Dre8H24u.js';
-import { A as AthenaAdapterBaseOptions, b as AthenaServerRequestOptions, a as AthenaAdapterExperimentalOptions } from '../shared-MMnVBBfy.js';
-import '../types-BRUHGXo2.js';
-import '../types-kPaHUqUa.js';
+import { al as AthenaClientSessionLike, aX as AthenaSdkClientWithStorage, aW as AthenaSdkClientWithAuth } from '../client-uthENhaf.js';
+import { ae as AthenaAuthSessionResponse } from '../types-eAKAh71s.js';
+import { i as AthenaAuthSessionBridgeOptions, j as AthenaAuthSessionBridgePathOptions, A as AthenaAdapterBaseOptions, k as AthenaServerRequestOptions, a as AthenaAdapterExperimentalOptions } from '../payload-BbSCmILD.js';
+export { b as ATHENA_AUTH_SESSION_BRIDGE_ROUTE, c as ATHENA_AUTH_SESSION_COOKIE_NAME, d as ATHENA_AUTH_SESSION_COOKIE_NAMES, e as AthenaAuthSessionBridgeClientOptions, f as AthenaAuthSessionBridgePayload, g as AthenaAuthSessionBridgeSource, h as clearAthenaAuthSessionOnAppHost, p as persistAthenaAuthSessionOnAppHost, r as resolveSessionBridgePayload } from '../payload-BbSCmILD.js';
+export { S as SESSION_COOKIE_PATTERNS, h as hasAuthSessionCookie } from '../session-cookie-detection-BqOp9mO6.js';
+import '../types-YQUR7wu0.js';
+import '../types-CD6K05JQ.js';
+
+/**
+ * Handle bridge `POST` — set an httpOnly session cookie from JSON body.
+ *
+ * Expected body: `{ "token": string, "expiresAt"?: string }`.
+ *
+ * @param request - Incoming request (JSON body)
+ * @param options - Cookie / route configuration
+ * @returns `200` on success, `400` when token is missing
+ */
+declare function handleAthenaAuthSessionBridgePost(request: Request, options?: AthenaAuthSessionBridgeOptions): Promise<Response>;
+/**
+ * Handle bridge `DELETE` — clear bridged session cookie name variants.
+ *
+ * @param request - Incoming request (used for Secure detection)
+ * @param options - Cookie / route configuration
+ * @returns `200` with clear `Set-Cookie` headers
+ */
+declare function handleAthenaAuthSessionBridgeDelete(request: Request, options?: AthenaAuthSessionBridgeOptions): Response;
+/**
+ * Create dedicated App Router handlers for the session bridge.
+ *
+ * Drop into a route file with no additional wiring:
+ *
+ * @example
+ * ```ts
+ * // app/api/athena-auth/session/route.ts
+ * import { createAthenaAuthSessionBridgeHandlers } from '@xylex-group/athena/next/server'
+ *
+ * export const { POST, DELETE } = createAthenaAuthSessionBridgeHandlers()
+ * ```
+ *
+ * @param options - Optional cookie name, path, SameSite, Secure overrides
+ * @returns Object with `POST` and `DELETE` route handlers
+ */
+declare function createAthenaAuthSessionBridgeHandlers(options?: AthenaAuthSessionBridgeOptions): {
+    POST: (request: Request) => Promise<Response>;
+    DELETE: (request: Request) => Response;
+};
+/**
+ * Whether this request should be handled as a session bridge call.
+ *
+ * Returns true when:
+ * - the pathname equals the configured `route`, or
+ * - the final path segment is listed in `matchPaths` (default `session`)
+ *
+ * @param request - Incoming request
+ * @param options - Route + matchPaths configuration
+ */
+declare function isAthenaAuthSessionBridgePath(request: Request, options?: AthenaAuthSessionBridgePathOptions): boolean;
+/**
+ * Create catch-all / `[path]` handlers that only service session-bridge paths.
+ *
+ * Non-matching paths return `404` with `{ error: 'Not found' }` so you can
+ * mount under `/api/auth/[...path]` without implementing a full auth proxy.
+ *
+ * @example
+ * ```ts
+ * // app/api/auth/[...path]/route.ts
+ * import { createAthenaAuthSessionBridgePathHandlers } from '@xylex-group/athena/next/server'
+ *
+ * export const { POST, DELETE } = createAthenaAuthSessionBridgePathHandlers({
+ *   route: '/api/auth/session',
+ * })
+ * ```
+ *
+ * @param options - Bridge options plus `matchPaths`
+ * @returns Object with `POST` and `DELETE` route handlers
+ */
+declare function createAthenaAuthSessionBridgePathHandlers(options?: AthenaAuthSessionBridgePathOptions): {
+    POST: (request: Request) => Promise<Response>;
+    DELETE: (request: Request) => Response;
+};
 
 interface AthenaServerClientOptions extends AthenaAdapterBaseOptions, AthenaServerRequestOptions {
     session?: AthenaClientSessionLike | AthenaAuthSessionResponse | null;
@@ -50,4 +126,4 @@ declare function resolveAthenaServerContext(options: AthenaServerContextOptionsW
 declare function resolveAthenaServerContext(options: AthenaServerContextOptionsWithTypecheckedColumns): Promise<AthenaResolvedServerContext<AthenaSdkClientWithAuth<true>>>;
 declare function resolveAthenaServerContext(options?: AthenaServerContextOptions): Promise<AthenaResolvedServerContext<AthenaSdkClientWithAuth<false>>>;
 
-export { type AthenaResolvedServerContext, type AthenaServerClientOptions, type AthenaServerContextOptions, createAthenaServerClient, resolveAthenaServerContext };
+export { AthenaAuthSessionBridgeOptions, AthenaAuthSessionBridgePathOptions, type AthenaResolvedServerContext, type AthenaServerClientOptions, type AthenaServerContextOptions, createAthenaAuthSessionBridgeHandlers, createAthenaAuthSessionBridgePathHandlers, createAthenaServerClient, handleAthenaAuthSessionBridgeDelete, handleAthenaAuthSessionBridgePost, isAthenaAuthSessionBridgePath, resolveAthenaServerContext };