azirid-react 0.11.0 → 0.11.2

package/dist/server.d.cts

@@ -1,102 +0,0 @@
-/**
- * Server-side utilities for Next.js (App Router).
- *
- * Use this entry point in Server Components, Server Actions, and Route Handlers
- * to read the authenticated user's session token from the httpOnly `__session` cookie.
- *
- * @example
- * ```ts
- * // lib/access-server.ts
- * import { cookies } from "next/headers";
- * import { createServerAccess } from "azirid-react/server";
- * export const { getSessionToken } = createServerAccess({ cookies });
- * ```
- *
- * ```ts
- * // app/actions/profile.ts
- * "use server";
- * import { getSessionToken } from "@/lib/access-server";
- *
- * export async function getProfile() {
- *   const token = await getSessionToken();
- *   if (!token) throw new Error("Not authenticated");
- *
- *   const res = await fetch("https://api.myapp.com/v1/users/auth/me", {
- *     headers: { Authorization: `Bearer ${token}` },
- *   });
- *   return res.json();
- * }
- * ```
- *
- * @packageDocumentation
- */
-/** Minimal cookie store interface (subset of Next.js ReadonlyRequestCookies) */
-interface CookieStore {
-    get(name: string): {
-        value: string;
-    } | undefined;
-}
-/** The `cookies` function from `next/headers` */
-type CookiesFn = () => CookieStore | Promise<CookieStore>;
-interface ServerAccessOptions {
-    /**
-     * The `cookies` function imported from `next/headers`.
-     * Required — pass it explicitly to avoid bundler issues with dynamic imports.
-     *
-     * @example
-     * ```ts
-     * import { cookies } from "next/headers";
-     * createServerAccess({ cookies });
-     * ```
-     */
-    cookies: CookiesFn;
-    /**
-     * Name of the httpOnly cookie that carries the access token.
-     * Must match the cookie set by the Azirid API.
-     * @default "__session"
-     */
-    cookieName?: string;
-}
-interface ServerAccess {
-    /**
-     * Read the raw JWT access token from the session cookie.
-     * Returns `null` when no cookie is present or when called
-     * outside a Next.js server context.
-     */
-    getSessionToken: () => Promise<string | null>;
-    /** Alias for {@link getSessionToken}. */
-    getAccessToken: () => Promise<string | null>;
-}
-/**
- * Create server-side helpers bound to the session cookie.
- *
- * Call once at module scope, then use the returned functions
- * in any Server Component, Server Action, or Route Handler.
- */
-declare function createServerAccess(options: ServerAccessOptions): ServerAccess;
-interface SessionSyncOptions {
-    /** Cookie name (default: "__session") */
-    cookieName?: string;
-    /** Set Secure flag on cookie (default: false) */
-    secure?: boolean;
-    /** Cookie max age in seconds (default: 3600 = 1h) */
-    maxAge?: number;
-}
-/**
- * Create a route handler that syncs the access token to a local httpOnly cookie.
- *
- * Use this in a Next.js App Router route to bridge cross-origin sessions:
- *
- * @example
- * ```ts
- * // app/api/auth/session/route.ts
- * import { createSessionSyncHandler } from "azirid-react/server";
- * export const { POST, DELETE } = createSessionSyncHandler();
- * ```
- */
-declare function createSessionSyncHandler(options?: SessionSyncOptions): {
-    POST(req: Request): Promise<Response>;
-    DELETE(): Promise<Response>;
-};
-
-export { type ServerAccess, type ServerAccessOptions, type SessionSyncOptions, createServerAccess, createSessionSyncHandler };

package/dist/server.d.ts

@@ -1,102 +0,0 @@
-/**
- * Server-side utilities for Next.js (App Router).
- *
- * Use this entry point in Server Components, Server Actions, and Route Handlers
- * to read the authenticated user's session token from the httpOnly `__session` cookie.
- *
- * @example
- * ```ts
- * // lib/access-server.ts
- * import { cookies } from "next/headers";
- * import { createServerAccess } from "azirid-react/server";
- * export const { getSessionToken } = createServerAccess({ cookies });
- * ```
- *
- * ```ts
- * // app/actions/profile.ts
- * "use server";
- * import { getSessionToken } from "@/lib/access-server";
- *
- * export async function getProfile() {
- *   const token = await getSessionToken();
- *   if (!token) throw new Error("Not authenticated");
- *
- *   const res = await fetch("https://api.myapp.com/v1/users/auth/me", {
- *     headers: { Authorization: `Bearer ${token}` },
- *   });
- *   return res.json();
- * }
- * ```
- *
- * @packageDocumentation
- */
-/** Minimal cookie store interface (subset of Next.js ReadonlyRequestCookies) */
-interface CookieStore {
-    get(name: string): {
-        value: string;
-    } | undefined;
-}
-/** The `cookies` function from `next/headers` */
-type CookiesFn = () => CookieStore | Promise<CookieStore>;
-interface ServerAccessOptions {
-    /**
-     * The `cookies` function imported from `next/headers`.
-     * Required — pass it explicitly to avoid bundler issues with dynamic imports.
-     *
-     * @example
-     * ```ts
-     * import { cookies } from "next/headers";
-     * createServerAccess({ cookies });
-     * ```
-     */
-    cookies: CookiesFn;
-    /**
-     * Name of the httpOnly cookie that carries the access token.
-     * Must match the cookie set by the Azirid API.
-     * @default "__session"
-     */
-    cookieName?: string;
-}
-interface ServerAccess {
-    /**
-     * Read the raw JWT access token from the session cookie.
-     * Returns `null` when no cookie is present or when called
-     * outside a Next.js server context.
-     */
-    getSessionToken: () => Promise<string | null>;
-    /** Alias for {@link getSessionToken}. */
-    getAccessToken: () => Promise<string | null>;
-}
-/**
- * Create server-side helpers bound to the session cookie.
- *
- * Call once at module scope, then use the returned functions
- * in any Server Component, Server Action, or Route Handler.
- */
-declare function createServerAccess(options: ServerAccessOptions): ServerAccess;
-interface SessionSyncOptions {
-    /** Cookie name (default: "__session") */
-    cookieName?: string;
-    /** Set Secure flag on cookie (default: false) */
-    secure?: boolean;
-    /** Cookie max age in seconds (default: 3600 = 1h) */
-    maxAge?: number;
-}
-/**
- * Create a route handler that syncs the access token to a local httpOnly cookie.
- *
- * Use this in a Next.js App Router route to bridge cross-origin sessions:
- *
- * @example
- * ```ts
- * // app/api/auth/session/route.ts
- * import { createSessionSyncHandler } from "azirid-react/server";
- * export const { POST, DELETE } = createSessionSyncHandler();
- * ```
- */
-declare function createSessionSyncHandler(options?: SessionSyncOptions): {
-    POST(req: Request): Promise<Response>;
-    DELETE(): Promise<Response>;
-};
-
-export { type ServerAccess, type ServerAccessOptions, type SessionSyncOptions, createServerAccess, createSessionSyncHandler };