@questpie/admin 1.1.1 → 2.0.0

package/dist/server/adapters/tanstack.mjs

@@ -0,0 +1,90 @@
+import { requireAdminAuth } from "../auth-helpers.mjs";
+
+//#region src/server/adapters/tanstack.ts
+/**
+* Create a TanStack Router beforeLoad guard for admin authentication.
+*
+* Returns a function that can be used as beforeLoad in route definitions.
+* Throws a redirect Response when authentication fails.
+*
+* @example
+* ```ts
+* import { createFileRoute } from "@tanstack/react-router";
+* import { createTanStackAuthGuard } from "@questpie/admin/server/adapters/tanstack";
+* import { cms } from "~/questpie/server/cms";
+*
+* export const Route = createFileRoute("/admin")({
+*   beforeLoad: createTanStackAuthGuard({
+*     cms,
+*     loginPath: "/admin/login",
+*     requiredRole: "admin",
+*   }),
+*   component: AdminLayout,
+* });
+* ```
+*
+* @example With custom context
+* ```ts
+* export const Route = createFileRoute("/admin")({
+*   beforeLoad: async (ctx) => {
+*     // Run auth guard
+*     await createTanStackAuthGuard({ cms })(ctx);
+*
+*     // Add additional context
+*     return { user: ctx.context.user };
+*   },
+* });
+* ```
+*/
+function createTanStackAuthGuard({ cms, loginPath = "/admin/login", requiredRole = "admin", redirectParam = "redirect" }) {
+	return async function beforeLoad({ context }) {
+		const request = context.request;
+		if (!request) {
+			console.warn("createTanStackAuthGuard: No request in context. Make sure you're using TanStack Start with SSR enabled.");
+			return;
+		}
+		const redirect = await requireAdminAuth({
+			request,
+			cms,
+			loginPath,
+			requiredRole,
+			redirectParam
+		});
+		if (redirect) throw redirect;
+	};
+}
+/**
+* Create a TanStack Router loader that injects the admin session into context.
+*
+* Use this when you need access to the session in your components.
+*
+* @example
+* ```ts
+* import { createTanStackSessionLoader } from "@questpie/admin/server/adapters/tanstack";
+*
+* export const Route = createFileRoute("/admin")({
+*   loader: createTanStackSessionLoader({ cms }),
+*   component: AdminLayout,
+* });
+*
+* function AdminLayout() {
+*   const { session } = Route.useLoaderData();
+*   return <div>Hello {session?.user?.name}</div>;
+* }
+* ```
+*/
+function createTanStackSessionLoader({ cms }) {
+	return async function loader({ context }) {
+		const request = context.request;
+		if (!request || !cms.auth) return { session: null };
+		try {
+			return { session: await cms.auth.api.getSession({ headers: request.headers }) ?? null };
+		} catch {
+			return { session: null };
+		}
+	};
+}
+
+//#endregion
+export { createTanStackAuthGuard, createTanStackSessionLoader };
+//# sourceMappingURL=tanstack.mjs.map

package/dist/server/adapters/tanstack.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"tanstack.mjs","names":[],"sources":["../../../src/server/adapters/tanstack.ts"],"sourcesContent":["/**\n * TanStack Router Adapter\n *\n * Convenience helpers for TanStack Router/Start integration.\n *\n * @example\n * ```ts\n * import { createTanStackAuthGuard } from \"@questpie/admin/server/adapters/tanstack\";\n * import { cms } from \"~/questpie/server/cms\";\n *\n * export const Route = createFileRoute(\"/admin\")({\n *   beforeLoad: createTanStackAuthGuard({ cms, loginPath: \"/admin/login\" }),\n * });\n * ```\n */\n\nimport type { Questpie } from \"questpie\";\nimport { requireAdminAuth } from \"../auth-helpers.js\";\n\n/**\n * Options for TanStack auth guard\n */\nexport interface TanStackAuthGuardOptions {\n  /**\n   * The CMS instance with auth configured\n   */\n  cms: Questpie<any>;\n\n  /**\n   * Path to redirect to when not authenticated\n   * @default \"/admin/login\"\n   */\n  loginPath?: string;\n\n  /**\n   * Required role for access\n   * @default \"admin\"\n   */\n  requiredRole?: string;\n\n  /**\n   * Query parameter name for redirect URL\n   * @default \"redirect\"\n   */\n  redirectParam?: string;\n}\n\n/**\n * Context passed to TanStack Router beforeLoad\n */\nexport interface BeforeLoadContext {\n  context: {\n    request: Request;\n    [key: string]: unknown;\n  };\n  [key: string]: unknown;\n}\n\n/**\n * Create a TanStack Router beforeLoad guard for admin authentication.\n *\n * Returns a function that can be used as beforeLoad in route definitions.\n * Throws a redirect Response when authentication fails.\n *\n * @example\n * ```ts\n * import { createFileRoute } from \"@tanstack/react-router\";\n * import { createTanStackAuthGuard } from \"@questpie/admin/server/adapters/tanstack\";\n * import { cms } from \"~/questpie/server/cms\";\n *\n * export const Route = createFileRoute(\"/admin\")({\n *   beforeLoad: createTanStackAuthGuard({\n *     cms,\n *     loginPath: \"/admin/login\",\n *     requiredRole: \"admin\",\n *   }),\n *   component: AdminLayout,\n * });\n * ```\n *\n * @example With custom context\n * ```ts\n * export const Route = createFileRoute(\"/admin\")({\n *   beforeLoad: async (ctx) => {\n *     // Run auth guard\n *     await createTanStackAuthGuard({ cms })(ctx);\n *\n *     // Add additional context\n *     return { user: ctx.context.user };\n *   },\n * });\n * ```\n */\nexport function createTanStackAuthGuard({\n  cms,\n  loginPath = \"/admin/login\",\n  requiredRole = \"admin\",\n  redirectParam = \"redirect\",\n}: TanStackAuthGuardOptions) {\n  return async function beforeLoad({ context }: BeforeLoadContext) {\n    const request = context.request;\n\n    if (!request) {\n      console.warn(\n        \"createTanStackAuthGuard: No request in context. \" +\n          \"Make sure you're using TanStack Start with SSR enabled.\",\n      );\n      return;\n    }\n\n    const redirect = await requireAdminAuth({\n      request,\n      cms,\n      loginPath,\n      requiredRole,\n      redirectParam,\n    });\n\n    if (redirect) {\n      // TanStack Router expects thrown Response for redirects\n      throw redirect;\n    }\n  };\n}\n\n/**\n * Create a TanStack Router loader that injects the admin session into context.\n *\n * Use this when you need access to the session in your components.\n *\n * @example\n * ```ts\n * import { createTanStackSessionLoader } from \"@questpie/admin/server/adapters/tanstack\";\n *\n * export const Route = createFileRoute(\"/admin\")({\n *   loader: createTanStackSessionLoader({ cms }),\n *   component: AdminLayout,\n * });\n *\n * function AdminLayout() {\n *   const { session } = Route.useLoaderData();\n *   return <div>Hello {session?.user?.name}</div>;\n * }\n * ```\n */\nexport function createTanStackSessionLoader({ cms }: { cms: Questpie<any> }) {\n  return async function loader({ context }: BeforeLoadContext) {\n    const request = context.request;\n\n    if (!request || !cms.auth) {\n      return { session: null };\n    }\n\n    try {\n      const session = await cms.auth.api.getSession({\n        headers: request.headers,\n      });\n\n      return { session: session ?? null };\n    } catch {\n      return { session: null };\n    }\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA6FA,SAAgB,wBAAwB,EACtC,KACA,YAAY,gBACZ,eAAe,SACf,gBAAgB,cACW;AAC3B,QAAO,eAAe,WAAW,EAAE,WAA8B;EAC/D,MAAM,UAAU,QAAQ;AAExB,MAAI,CAAC,SAAS;AACZ,WAAQ,KACN,0GAED;AACD;;EAGF,MAAM,WAAW,MAAM,iBAAiB;GACtC;GACA;GACA;GACA;GACA;GACD,CAAC;AAEF,MAAI,SAEF,OAAM;;;;;;;;;;;;;;;;;;;;;;;AAyBZ,SAAgB,4BAA4B,EAAE,OAA+B;AAC3E,QAAO,eAAe,OAAO,EAAE,WAA8B;EAC3D,MAAM,UAAU,QAAQ;AAExB,MAAI,CAAC,WAAW,CAAC,IAAI,KACnB,QAAO,EAAE,SAAS,MAAM;AAG1B,MAAI;AAKF,UAAO,EAAE,SAJO,MAAM,IAAI,KAAK,IAAI,WAAW,EAC5C,SAAS,QAAQ,SAClB,CAAC,IAE2B,MAAM;UAC7B;AACN,UAAO,EAAE,SAAS,MAAM"}