@qyh213/easyauth-client 1.0.0-beta.1

package/dist/next.d.ts

@@ -0,0 +1,106 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { NextRequest, NextResponse } from 'next/server';
+import { e as EasyAuthConfig } from './client-RPDHpVsj.js';
+export { A as ApiKey, a as AuthToken, C as CreateApiKeyRequest, b as CreateApiKeyResponse, c as CreateScopeRequest, d as CreateUserRequest, E as EasyAuthClient, f as EasyAuthError, I as IntrospectRequest, g as IntrospectResponse, L as LocalStorageTokenStorage, h as LoginCredentials, M as MemoryTokenStorage, O as OnboardRequest, i as OnboardResponse, R as RegisterWebhookRequest, S as Scope, j as ScopeError, k as Service, T as TokenStorage, U as User, l as UserListResponse, V as ValidationResult, W as Webhook } from './client-RPDHpVsj.js';
+
+interface MiddlewareOptions {
+    /** Base URL of Easy Auth service */
+    baseUrl: string;
+    /** Service API Key */
+    apiKey: string;
+    /** Paths that require authentication */
+    protectedPaths?: string[];
+    /** Paths that require specific scopes: path -> scopes[] */
+    scopedPaths?: Record<string, string[]>;
+    /** Paths that are public (no auth required) */
+    publicPaths?: string[];
+    /** Login page path */
+    loginPath?: string;
+    /** Forbidden page path (insufficient scopes) */
+    forbiddenPath?: string;
+}
+interface MiddlewareContext {
+    valid: boolean;
+    userId?: string;
+    email?: string;
+    scopes?: string[];
+    error?: string;
+}
+/**
+ * Create a Next.js middleware with scope-based protection
+ *
+ * @example
+ * // middleware.ts
+ * import { createEasyAuthMiddleware } from "@easyauth/client/next";
+ *
+ * export const middleware = createEasyAuthMiddleware({
+ *   baseUrl: process.env.EASY_AUTH_URL!,
+ *   apiKey: process.env.EASY_AUTH_API_KEY!,
+ *   protectedPaths: ["/dashboard", "/api/protected"],
+ *   scopedPaths: {
+ *     "/api/users": ["users:read"],
+ *     "/api/users/create": ["users:write"],
+ *     "/api/billing": ["billing:read"],
+ *     "/api/admin": ["admin"],
+ *   },
+ *   publicPaths: ["/", "/login", "/register"],
+ * });
+ */
+declare function createEasyAuthMiddleware(options: MiddlewareOptions): (request: NextRequest) => Promise<NextResponse<unknown>>;
+/**
+ * Higher-order component to protect a page with required scopes
+ *
+ * @example
+ * // pages/admin.tsx
+ * import { withScope } from "@easyauth/client/next";
+ *
+ * function AdminPage() {
+ *   return <div>Admin Only</div>;
+ * }
+ *
+ * export default withScope(AdminPage, ["admin"], {
+ *   baseUrl: process.env.NEXT_PUBLIC_EASY_AUTH_URL!,
+ *   apiKey: process.env.NEXT_PUBLIC_EASY_AUTH_API_KEY!,
+ * });
+ */
+declare function withScope<P extends object>(Component: React.ComponentType<P>, _requiredScopes: string[], _config: EasyAuthConfig): (props: P) => react_jsx_runtime.JSX.Element;
+/**
+ * Server-side helper to validate scopes in API routes
+ *
+ * @example
+ * // app/api/users/route.ts
+ * import { validateScopes } from "@easyauth/client/next";
+ *
+ * export async function GET(request: Request) {
+ *   const result = await validateScopes(request, {
+ *     baseUrl: process.env.EASY_AUTH_URL!,
+ *     apiKey: process.env.EASY_AUTH_API_KEY!,
+ *     requiredScopes: ["users:read"],
+ *   });
+ *
+ *   if (!result.valid) {
+ *     return new Response(JSON.stringify({ error: result.error }), {
+ *       status: result.status || 401,
+ *     });
+ *   }
+ *
+ *   // Proceed with the request
+ *   return Response.json({ users: [] });
+ * }
+ */
+declare function validateScopes(request: Request, options: {
+    baseUrl: string;
+    apiKey: string;
+    requiredScopes: string[];
+}): Promise<{
+    valid: true;
+    userId: string;
+    email: string;
+    scopes: string[];
+} | {
+    valid: false;
+    error: string;
+    status: number;
+}>;
+
+export { EasyAuthConfig, type MiddlewareContext, type MiddlewareOptions, createEasyAuthMiddleware, validateScopes, withScope };