@githat/nextjs 0.2.0 → 0.2.2

package/dist/proxy.mjs

@@ -0,0 +1,101 @@
+// src/lib/auth-handler.ts
+import { NextResponse } from "next/server";
+import * as jose from "jose";
+function decodeJwtPayload(token) {
+  try {
+    const parts = token.split(".");
+    if (parts.length !== 3) return null;
+    const payload = JSON.parse(atob(parts[1]));
+    return payload;
+  } catch {
+    return null;
+  }
+}
+async function verifyJwt(token, secretKey) {
+  try {
+    const secret = new TextEncoder().encode(secretKey);
+    const { payload } = await jose.jwtVerify(token, secret, {
+      algorithms: ["HS256"]
+    });
+    return payload;
+  } catch {
+    return null;
+  }
+}
+async function handleAuthRequest(request, options = {}) {
+  const {
+    publicRoutes = ["/"],
+    signInUrl = "/sign-in",
+    tokenCookie = "githat_access",
+    legacyTokenCookie = "githat_access_token",
+    injectHeaders = false,
+    secretKey
+  } = options;
+  const { pathname } = request.nextUrl;
+  const isPublic = publicRoutes.some((route) => {
+    if (route.endsWith("/*")) {
+      const prefix = route.slice(0, -1);
+      return pathname === prefix.slice(0, -1) || pathname.startsWith(prefix);
+    }
+    return pathname === route;
+  });
+  if (isPublic) {
+    return NextResponse.next();
+  }
+  if (pathname.startsWith("/_next") || pathname.startsWith("/api") || pathname.includes(".")) {
+    return NextResponse.next();
+  }
+  let token = request.cookies.get(tokenCookie)?.value;
+  if (!token) {
+    token = request.cookies.get(legacyTokenCookie)?.value;
+  }
+  if (!token) {
+    const signInUrlObj = new URL(signInUrl, request.url);
+    signInUrlObj.searchParams.set("redirect_url", pathname);
+    return NextResponse.redirect(signInUrlObj);
+  }
+  if (!injectHeaders) {
+    return NextResponse.next();
+  }
+  let payload = null;
+  if (secretKey) {
+    payload = await verifyJwt(token, secretKey);
+    if (!payload) {
+      const signInUrlObj = new URL(signInUrl, request.url);
+      signInUrlObj.searchParams.set("redirect_url", pathname);
+      return NextResponse.redirect(signInUrlObj);
+    }
+  } else {
+    payload = decodeJwtPayload(token);
+  }
+  const response = NextResponse.next();
+  if (payload) {
+    if (payload.userId) {
+      response.headers.set("x-githat-user-id", String(payload.userId));
+    }
+    if (payload.email) {
+      response.headers.set("x-githat-email", String(payload.email));
+    }
+    if (payload.orgId) {
+      response.headers.set("x-githat-org-id", String(payload.orgId));
+    }
+    if (payload.orgSlug) {
+      response.headers.set("x-githat-org-slug", String(payload.orgSlug));
+    }
+    if (payload.orgRole) {
+      response.headers.set("x-githat-role", String(payload.orgRole));
+    }
+  }
+  return response;
+}
+
+// src/proxy/index.ts
+function authProxy(options = {}) {
+  return async function proxy(request) {
+    return handleAuthRequest(request, options);
+  };
+}
+export {
+  authProxy
+};
+//# sourceMappingURL=proxy.mjs.map

package/dist/proxy.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/lib/auth-handler.ts","../src/proxy/index.ts"],"sourcesContent":["import { NextResponse } from 'next/server';\nimport type { NextRequest } from 'next/server';\nimport * as jose from 'jose';\n\nexport interface AuthHandlerOptions {\n  /**\n   * Routes that don't require authentication.\n   * Supports exact paths ('/') and path prefixes ('/public/*').\n   */\n  publicRoutes?: string[];\n\n  /**\n   * URL to redirect to when authentication is required but not present.\n   * @default '/sign-in'\n   */\n  signInUrl?: string;\n\n  /**\n   * Cookie name for the access token.\n   * @default 'githat_access'\n   */\n  tokenCookie?: string;\n\n  /**\n   * Legacy localStorage token cookie name (for backward compatibility).\n   * @default 'githat_access_token'\n   */\n  legacyTokenCookie?: string;\n\n  /**\n   * When true, decode the JWT and inject x-githat-* headers into the request.\n   * This allows downstream API routes to access user/org info without re-verifying.\n   *\n   * Injected headers:\n   * - x-githat-user-id: User's unique ID\n   * - x-githat-email: User's email address\n   * - x-githat-org-id: Current org ID (if any)\n   * - x-githat-org-slug: Current org slug (if any)\n   * - x-githat-role: User's role in the org (owner/admin/member)\n   *\n   * @default false\n   */\n  injectHeaders?: boolean;\n\n  /**\n   * Secret key for local JWT verification when injectHeaders is true.\n   * If not provided, headers are populated from the decoded (unverified) token payload.\n   * For production, always provide the secret key for full verification.\n   */\n  secretKey?: string;\n}\n\n/**\n * Decode a JWT without verifying the signature.\n * Used when secretKey is not provided but we still want header injection.\n */\nfunction decodeJwtPayload(token: string): Record<string, unknown> | null {\n  try {\n    const parts = token.split('.');\n    if (parts.length !== 3) return null;\n    const payload = JSON.parse(atob(parts[1]));\n    return payload;\n  } catch {\n    return null;\n  }\n}\n\n/**\n * Verify a JWT and return the payload.\n * Uses jose for proper signature verification.\n */\nasync function verifyJwt(\n  token: string,\n  secretKey: string\n): Promise<Record<string, unknown> | null> {\n  try {\n    const secret = new TextEncoder().encode(secretKey);\n    const { payload } = await jose.jwtVerify(token, secret, {\n      algorithms: ['HS256'],\n    });\n    return payload as Record<string, unknown>;\n  } catch {\n    return null;\n  }\n}\n\n/**\n * Shared auth handling logic for both middleware (Next.js 14/15) and proxy (Next.js 16+).\n * Validates authentication tokens and optionally injects headers with user/org info.\n */\nexport async function handleAuthRequest(\n  request: NextRequest,\n  options: AuthHandlerOptions = {}\n): Promise<NextResponse> {\n  const {\n    publicRoutes = ['/'],\n    signInUrl = '/sign-in',\n    tokenCookie = 'githat_access',\n    legacyTokenCookie = 'githat_access_token',\n    injectHeaders = false,\n    secretKey,\n  } = options;\n\n  const { pathname } = request.nextUrl;\n\n  // Allow public routes (exact match or prefix with /*)\n  const isPublic = publicRoutes.some((route) => {\n    if (route.endsWith('/*')) {\n      const prefix = route.slice(0, -1); // Remove the *\n      return pathname === prefix.slice(0, -1) || pathname.startsWith(prefix);\n    }\n    return pathname === route;\n  });\n\n  if (isPublic) {\n    return NextResponse.next();\n  }\n\n  // IMPORTANT: /api routes are intentionally skipped here.\n  // API route protection must be handled per-route using withAuth() or getAuth()\n  // from @githat/nextjs/server. This is documented in the SDK README and docs.\n  if (\n    pathname.startsWith('/_next') ||\n    pathname.startsWith('/api') ||\n    pathname.includes('.')\n  ) {\n    return NextResponse.next();\n  }\n\n  // Check for token in cookies (try new httpOnly cookie first, then legacy)\n  let token = request.cookies.get(tokenCookie)?.value;\n  if (!token) {\n    token = request.cookies.get(legacyTokenCookie)?.value;\n  }\n\n  // No token — redirect to sign-in\n  if (!token) {\n    const signInUrlObj = new URL(signInUrl, request.url);\n    signInUrlObj.searchParams.set('redirect_url', pathname);\n    return NextResponse.redirect(signInUrlObj);\n  }\n\n  // If not injecting headers, just let the request through\n  if (!injectHeaders) {\n    return NextResponse.next();\n  }\n\n  // Decode or verify the token to inject headers\n  let payload: Record<string, unknown> | null = null;\n\n  if (secretKey) {\n    // Full verification with secret key\n    payload = await verifyJwt(token, secretKey);\n    if (!payload) {\n      // Token verification failed — redirect to sign-in\n      const signInUrlObj = new URL(signInUrl, request.url);\n      signInUrlObj.searchParams.set('redirect_url', pathname);\n      return NextResponse.redirect(signInUrlObj);\n    }\n  } else {\n    // Decode without verification (less secure, but works without secret)\n    payload = decodeJwtPayload(token);\n  }\n\n  // Create a new response with injected headers\n  const response = NextResponse.next();\n\n  if (payload) {\n    // Inject user/org info as headers\n    if (payload.userId) {\n      response.headers.set('x-githat-user-id', String(payload.userId));\n    }\n    if (payload.email) {\n      response.headers.set('x-githat-email', String(payload.email));\n    }\n    if (payload.orgId) {\n      response.headers.set('x-githat-org-id', String(payload.orgId));\n    }\n    if (payload.orgSlug) {\n      response.headers.set('x-githat-org-slug', String(payload.orgSlug));\n    }\n    if (payload.orgRole) {\n      response.headers.set('x-githat-role', String(payload.orgRole));\n    }\n  }\n\n  return response;\n}\n","import type { NextRequest } from 'next/server';\nimport type { NextResponse } from 'next/server';\nimport { handleAuthRequest, AuthHandlerOptions } from '../lib/auth-handler';\n\n/**\n * Options for the authProxy function.\n * @see AuthHandlerOptions for detailed property documentation.\n */\nexport interface AuthProxyOptions extends AuthHandlerOptions {}\n\n/**\n * Creates an auth proxy handler for Next.js 16+.\n *\n * Next.js 16 renamed middleware.ts to proxy.ts and the export from\n * `export default middleware` to `export const proxy`.\n *\n * @example\n * ```typescript\n * // proxy.ts (Next.js 16+)\n * import { authProxy } from '@githat/nextjs/proxy';\n *\n * export const proxy = authProxy({\n *   publicRoutes: ['/', '/about', '/pricing'],\n *   signInUrl: '/sign-in',\n * });\n *\n * export const config = {\n *   matcher: ['/((?!_next/static|_next/image|favicon.ico).*)'],\n * };\n * ```\n *\n * @param options - Configuration options for the auth proxy\n * @returns A proxy function compatible with Next.js 16+ proxy.ts convention\n */\nexport function authProxy(options: AuthProxyOptions = {}) {\n  return async function proxy(request: NextRequest): Promise<NextResponse> {\n    return handleAuthRequest(request, options);\n  };\n}\n\n// Re-export types for convenience\nexport type { AuthProxyOptions as AuthProxyConfig };\nexport type { AuthHandlerOptions };\n"],"mappings":"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","names":[]}

package/dist/server.d.mts

@@ -0,0 +1,164 @@
+/**
+ * @githat/nextjs/server
+ *
+ * Server-side utilities for token verification in Next.js API routes and middleware.
+ * This module runs on the server only — do not import in client components.
+ */
+interface AuthPayload {
+    userId: string;
+    email: string;
+    orgId: string | null;
+    orgSlug: string | null;
+    role: 'owner' | 'admin' | 'member' | null;
+    tier: 'free' | 'basic' | 'pro' | 'enterprise' | null;
+}
+interface VerifyOptions {
+    /**
+     * Secret key for local JWT verification. If provided, tokens are verified
+     * locally without making an API call (~1ms vs ~50-100ms).
+     * Must match the JWT_SECRET used by the GitHat backend.
+     */
+    secretKey?: string;
+    /**
+     * API URL for remote token verification. Defaults to https://api.githat.io
+     */
+    apiUrl?: string;
+}
+interface OrgMetadata {
+    [key: string]: unknown;
+}
+declare const COOKIE_NAMES: {
+    readonly accessToken: "githat_access";
+    readonly refreshToken: "githat_refresh";
+};
+/**
+ * Verify a JWT token and return the decoded auth payload.
+ *
+ * Supports two verification modes:
+ * 1. Local verification (recommended for performance): Pass `secretKey` option
+ * 2. API-based verification: No secret key needed, calls api.githat.io/auth/verify
+ *
+ * @example Local verification (fast, ~1ms)
+ * ```ts
+ * const auth = await verifyToken(token, {
+ *   secretKey: process.env.GITHAT_SECRET_KEY
+ * });
+ * ```
+ *
+ * @example API-based verification (simpler setup)
+ * ```ts
+ * const auth = await verifyToken(token);
+ * ```
+ */
+declare function verifyToken(token: string, options?: VerifyOptions): Promise<AuthPayload>;
+/**
+ * Extract and verify the auth token from a Next.js request.
+ * Checks cookies first (for httpOnly cookie mode), then Authorization header.
+ *
+ * Returns null if no token is found (unauthenticated request).
+ * Throws if a token is found but is invalid/expired.
+ *
+ * @example In a Next.js API route
+ * ```ts
+ * import { getAuth } from '@githat/nextjs/server';
+ *
+ * export async function GET(request: Request) {
+ *   const auth = await getAuth(request, {
+ *     secretKey: process.env.GITHAT_SECRET_KEY
+ *   });
+ *
+ *   if (!auth) {
+ *     return Response.json({ error: 'Unauthorized' }, { status: 401 });
+ *   }
+ *
+ *   return Response.json({ userId: auth.userId });
+ * }
+ * ```
+ */
+declare function getAuth(request: Request, options?: VerifyOptions): Promise<AuthPayload | null>;
+/**
+ * Get organization metadata from the server.
+ *
+ * @example
+ * ```ts
+ * import { getOrgMetadata } from '@githat/nextjs/server';
+ *
+ * const meta = await getOrgMetadata(orgId, {
+ *   token: accessToken,
+ *   apiUrl: 'https://api.githat.io'
+ * });
+ * console.log(meta.stripeAccountId);
+ * ```
+ */
+declare function getOrgMetadata(orgId: string, options: {
+    token: string;
+    apiUrl?: string;
+}): Promise<OrgMetadata>;
+/**
+ * Update organization metadata from the server.
+ *
+ * @example
+ * ```ts
+ * import { updateOrgMetadata } from '@githat/nextjs/server';
+ *
+ * await updateOrgMetadata(orgId, { stripeAccountId: 'acct_xxx' }, {
+ *   token: accessToken,
+ *   apiUrl: 'https://api.githat.io'
+ * });
+ * ```
+ */
+declare function updateOrgMetadata(orgId: string, metadata: OrgMetadata, options: {
+    token: string;
+    apiUrl?: string;
+}): Promise<OrgMetadata>;
+/**
+ * Handler function that receives the request and verified auth payload.
+ */
+type AuthenticatedHandler = (request: Request, auth: AuthPayload) => Promise<Response> | Response;
+/**
+ * Options for the withAuth wrapper.
+ */
+interface WithAuthOptions {
+    /**
+     * Secret key for local JWT verification.
+     * Defaults to process.env.GITHAT_SECRET_KEY if not provided.
+     */
+    secretKey?: string;
+    /**
+     * Custom response to return when authentication fails.
+     * Defaults to JSON { error: 'Unauthorized' } with status 401.
+     */
+    onUnauthorized?: () => Response;
+}
+/**
+ * Wrap an API route handler with authentication.
+ * The handler will only be called if the request has a valid auth token.
+ *
+ * @example
+ * ```ts
+ * // app/api/orders/route.ts
+ * import { withAuth } from '@githat/nextjs/server';
+ *
+ * export const GET = withAuth(async (request, auth) => {
+ *   // auth.userId, auth.orgId, auth.role available
+ *   const orders = await db.orders.findMany({ where: { orgId: auth.orgId } });
+ *   return Response.json({ orders });
+ * }, { secretKey: process.env.GITHAT_SECRET_KEY });
+ * ```
+ *
+ * @example With custom unauthorized response
+ * ```ts
+ * export const GET = withAuth(
+ *   async (request, auth) => {
+ *     return Response.json({ userId: auth.userId });
+ *   },
+ *   {
+ *     secretKey: process.env.GITHAT_SECRET_KEY,
+ *     onUnauthorized: () => Response.redirect('/sign-in'),
+ *   }
+ * );
+ * ```
+ */
+declare function withAuth(handler: AuthenticatedHandler, options?: WithAuthOptions): (request: Request) => Promise<Response>;
+
+export { type AuthPayload, type AuthenticatedHandler, COOKIE_NAMES, type OrgMetadata, type VerifyOptions, type WithAuthOptions, getAuth, getOrgMetadata, updateOrgMetadata, verifyToken, withAuth };

package/dist/server.d.ts

@@ -0,0 +1,164 @@
+/**
+ * @githat/nextjs/server
+ *
+ * Server-side utilities for token verification in Next.js API routes and middleware.
+ * This module runs on the server only — do not import in client components.
+ */
+interface AuthPayload {
+    userId: string;
+    email: string;
+    orgId: string | null;
+    orgSlug: string | null;
+    role: 'owner' | 'admin' | 'member' | null;
+    tier: 'free' | 'basic' | 'pro' | 'enterprise' | null;
+}
+interface VerifyOptions {
+    /**
+     * Secret key for local JWT verification. If provided, tokens are verified
+     * locally without making an API call (~1ms vs ~50-100ms).
+     * Must match the JWT_SECRET used by the GitHat backend.
+     */
+    secretKey?: string;
+    /**
+     * API URL for remote token verification. Defaults to https://api.githat.io
+     */
+    apiUrl?: string;
+}
+interface OrgMetadata {
+    [key: string]: unknown;
+}
+declare const COOKIE_NAMES: {
+    readonly accessToken: "githat_access";
+    readonly refreshToken: "githat_refresh";
+};
+/**
+ * Verify a JWT token and return the decoded auth payload.
+ *
+ * Supports two verification modes:
+ * 1. Local verification (recommended for performance): Pass `secretKey` option
+ * 2. API-based verification: No secret key needed, calls api.githat.io/auth/verify
+ *
+ * @example Local verification (fast, ~1ms)
+ * ```ts
+ * const auth = await verifyToken(token, {
+ *   secretKey: process.env.GITHAT_SECRET_KEY
+ * });
+ * ```
+ *
+ * @example API-based verification (simpler setup)
+ * ```ts
+ * const auth = await verifyToken(token);
+ * ```
+ */
+declare function verifyToken(token: string, options?: VerifyOptions): Promise<AuthPayload>;
+/**
+ * Extract and verify the auth token from a Next.js request.
+ * Checks cookies first (for httpOnly cookie mode), then Authorization header.
+ *
+ * Returns null if no token is found (unauthenticated request).
+ * Throws if a token is found but is invalid/expired.
+ *
+ * @example In a Next.js API route
+ * ```ts
+ * import { getAuth } from '@githat/nextjs/server';
+ *
+ * export async function GET(request: Request) {
+ *   const auth = await getAuth(request, {
+ *     secretKey: process.env.GITHAT_SECRET_KEY
+ *   });
+ *
+ *   if (!auth) {
+ *     return Response.json({ error: 'Unauthorized' }, { status: 401 });
+ *   }
+ *
+ *   return Response.json({ userId: auth.userId });
+ * }
+ * ```
+ */
+declare function getAuth(request: Request, options?: VerifyOptions): Promise<AuthPayload | null>;
+/**
+ * Get organization metadata from the server.
+ *
+ * @example
+ * ```ts
+ * import { getOrgMetadata } from '@githat/nextjs/server';
+ *
+ * const meta = await getOrgMetadata(orgId, {
+ *   token: accessToken,
+ *   apiUrl: 'https://api.githat.io'
+ * });
+ * console.log(meta.stripeAccountId);
+ * ```
+ */
+declare function getOrgMetadata(orgId: string, options: {
+    token: string;
+    apiUrl?: string;
+}): Promise<OrgMetadata>;
+/**
+ * Update organization metadata from the server.
+ *
+ * @example
+ * ```ts
+ * import { updateOrgMetadata } from '@githat/nextjs/server';
+ *
+ * await updateOrgMetadata(orgId, { stripeAccountId: 'acct_xxx' }, {
+ *   token: accessToken,
+ *   apiUrl: 'https://api.githat.io'
+ * });
+ * ```
+ */
+declare function updateOrgMetadata(orgId: string, metadata: OrgMetadata, options: {
+    token: string;
+    apiUrl?: string;
+}): Promise<OrgMetadata>;
+/**
+ * Handler function that receives the request and verified auth payload.
+ */
+type AuthenticatedHandler = (request: Request, auth: AuthPayload) => Promise<Response> | Response;
+/**
+ * Options for the withAuth wrapper.
+ */
+interface WithAuthOptions {
+    /**
+     * Secret key for local JWT verification.
+     * Defaults to process.env.GITHAT_SECRET_KEY if not provided.
+     */
+    secretKey?: string;
+    /**
+     * Custom response to return when authentication fails.
+     * Defaults to JSON { error: 'Unauthorized' } with status 401.
+     */
+    onUnauthorized?: () => Response;
+}
+/**
+ * Wrap an API route handler with authentication.
+ * The handler will only be called if the request has a valid auth token.
+ *
+ * @example
+ * ```ts
+ * // app/api/orders/route.ts
+ * import { withAuth } from '@githat/nextjs/server';
+ *
+ * export const GET = withAuth(async (request, auth) => {
+ *   // auth.userId, auth.orgId, auth.role available
+ *   const orders = await db.orders.findMany({ where: { orgId: auth.orgId } });
+ *   return Response.json({ orders });
+ * }, { secretKey: process.env.GITHAT_SECRET_KEY });
+ * ```
+ *
+ * @example With custom unauthorized response
+ * ```ts
+ * export const GET = withAuth(
+ *   async (request, auth) => {
+ *     return Response.json({ userId: auth.userId });
+ *   },
+ *   {
+ *     secretKey: process.env.GITHAT_SECRET_KEY,
+ *     onUnauthorized: () => Response.redirect('/sign-in'),
+ *   }
+ * );
+ * ```
+ */
+declare function withAuth(handler: AuthenticatedHandler, options?: WithAuthOptions): (request: Request) => Promise<Response>;
+
+export { type AuthPayload, type AuthenticatedHandler, COOKIE_NAMES, type OrgMetadata, type VerifyOptions, type WithAuthOptions, getAuth, getOrgMetadata, updateOrgMetadata, verifyToken, withAuth };

package/dist/server.js

@@ -0,0 +1,203 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/server.ts
+var server_exports = {};
+__export(server_exports, {
+  COOKIE_NAMES: () => COOKIE_NAMES,
+  getAuth: () => getAuth,
+  getOrgMetadata: () => getOrgMetadata,
+  updateOrgMetadata: () => updateOrgMetadata,
+  verifyToken: () => verifyToken,
+  withAuth: () => withAuth
+});
+module.exports = __toCommonJS(server_exports);
+var jose = __toESM(require("jose"));
+
+// src/config.ts
+var DEFAULT_API_URL = "https://api.githat.io";
+
+// src/server.ts
+var COOKIE_NAMES = {
+  accessToken: "githat_access",
+  refreshToken: "githat_refresh"
+};
+async function verifyToken(token, options = {}) {
+  const { secretKey, apiUrl = DEFAULT_API_URL } = options;
+  if (secretKey) {
+    return verifyTokenLocally(token, secretKey);
+  }
+  return verifyTokenViaAPI(token, apiUrl);
+}
+async function verifyTokenLocally(token, secretKey) {
+  try {
+    const secret = new TextEncoder().encode(secretKey);
+    const { payload } = await jose.jwtVerify(token, secret, {
+      algorithms: ["HS256"]
+    });
+    if (payload.type && payload.type !== "user") {
+      throw new Error("Invalid token type");
+    }
+    if (payload.tokenType !== "access") {
+      throw new Error("Invalid token type");
+    }
+    return {
+      userId: payload.userId,
+      email: payload.email,
+      orgId: payload.orgId || null,
+      orgSlug: payload.orgSlug || null,
+      role: payload.orgRole || null,
+      tier: null
+      // Tier requires DB lookup, not available in local verification
+    };
+  } catch (err) {
+    if (err instanceof jose.errors.JWTExpired) {
+      throw new Error("Token expired");
+    }
+    if (err instanceof jose.errors.JWTClaimValidationFailed) {
+      throw new Error("Invalid token claims");
+    }
+    if (err instanceof jose.errors.JWTInvalid) {
+      throw new Error("Invalid token");
+    }
+    if (err instanceof jose.errors.JWSSignatureVerificationFailed) {
+      throw new Error("Invalid token signature");
+    }
+    throw err;
+  }
+}
+async function verifyTokenViaAPI(token, apiUrl) {
+  const response = await fetch(`${apiUrl}/auth/verify`, {
+    method: "GET",
+    headers: {
+      Authorization: `Bearer ${token}`,
+      "Content-Type": "application/json"
+    }
+  });
+  if (!response.ok) {
+    const data2 = await response.json().catch(() => ({}));
+    throw new Error(data2.error || "Token verification failed");
+  }
+  const data = await response.json();
+  return {
+    userId: data.userId,
+    email: data.email,
+    orgId: data.orgId,
+    orgSlug: data.orgSlug,
+    role: data.role,
+    tier: data.tier
+  };
+}
+async function getAuth(request, options = {}) {
+  const cookieHeader = request.headers.get("cookie");
+  let token = null;
+  if (cookieHeader) {
+    const cookies = parseCookies(cookieHeader);
+    token = cookies[COOKIE_NAMES.accessToken] || null;
+  }
+  if (!token) {
+    const authHeader = request.headers.get("authorization");
+    if (authHeader?.startsWith("Bearer ")) {
+      token = authHeader.slice(7);
+    }
+  }
+  if (!token) {
+    return null;
+  }
+  return verifyToken(token, options);
+}
+function parseCookies(cookieHeader) {
+  const cookies = {};
+  const pairs = cookieHeader.split(";");
+  for (const pair of pairs) {
+    const [name, ...rest] = pair.trim().split("=");
+    if (name) {
+      cookies[name] = rest.join("=");
+    }
+  }
+  return cookies;
+}
+async function getOrgMetadata(orgId, options) {
+  const { token, apiUrl = DEFAULT_API_URL } = options;
+  const response = await fetch(`${apiUrl}/orgs/${orgId}/metadata`, {
+    method: "GET",
+    headers: {
+      Authorization: `Bearer ${token}`,
+      "Content-Type": "application/json"
+    }
+  });
+  if (!response.ok) {
+    const data2 = await response.json().catch(() => ({}));
+    throw new Error(data2.error || "Failed to get org metadata");
+  }
+  const data = await response.json();
+  return data.metadata || {};
+}
+async function updateOrgMetadata(orgId, metadata, options) {
+  const { token, apiUrl = DEFAULT_API_URL } = options;
+  const response = await fetch(`${apiUrl}/orgs/${orgId}/metadata`, {
+    method: "PATCH",
+    headers: {
+      Authorization: `Bearer ${token}`,
+      "Content-Type": "application/json"
+    },
+    body: JSON.stringify(metadata)
+  });
+  if (!response.ok) {
+    const data2 = await response.json().catch(() => ({}));
+    throw new Error(data2.error || "Failed to update org metadata");
+  }
+  const data = await response.json();
+  return data.metadata || {};
+}
+function withAuth(handler, options = {}) {
+  return async (request) => {
+    const auth = await getAuth(request, { secretKey: options.secretKey });
+    if (!auth) {
+      if (options.onUnauthorized) {
+        return options.onUnauthorized();
+      }
+      return new Response(JSON.stringify({ error: "Unauthorized" }), {
+        status: 401,
+        headers: { "Content-Type": "application/json" }
+      });
+    }
+    return handler(request, auth);
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  COOKIE_NAMES,
+  getAuth,
+  getOrgMetadata,
+  updateOrgMetadata,
+  verifyToken,
+  withAuth
+});
+//# sourceMappingURL=server.js.map