GitHub Authentication

[{"_1":2,"_3":-5,"_4":-5},"loaderData",{"_5":6,"_7":8,"_9":10},"actionData","errors","root",{"_222":223,"_224":225},"routes/_app.x.$handle.$name",{"_100":99,"_32":49,"_108":90,"_27":109,"_13":14,"_110":-5,"_11":111,"_112":113,"_114":115,"_116":117,"_118":119,"_21":-5,"_120":-5,"_121":-5,"_122":25,"_123":124,"_125":25,"_126":-5,"_127":-5,"_128":129},"routes/_app.x.$handle.$name.branch.$branch.version.$version.diff",{"_11":12,"_13":14,"_15":16,"_17":-5,"_18":-5},"project",{"_47":48,"_32":49,"_36":50,"_51":-5,"_52":25,"_53":54,"_55":54,"_56":-5,"_57":-5,"_18":58,"_59":60,"_61":62,"_63":62,"_64":-5,"_65":66,"_67":68,"_69":-5,"_70":-5,"_71":-5,"_72":-5,"_73":74,"_75":74,"_76":77,"_78":77,"_79":77,"_80":74,"_81":74,"_82":83,"_84":85,"_86":87,"_88":25},"version",5,"changes",[19,20],"aiChatInfo","userId",{"_21":41,"_23":-7,"_24":25,"_26":25,"_27":42,"_29":42},{"_21":22,"_23":-7,"_24":25,"_26":25,"_27":28,"_29":28},"file",{"_30":31,"_32":28,"_33":34,"_35":-5,"_36":37,"_38":14,"_39":40,"_24":25},"previous","deleted",false,"deletedHere","path","frontend","latestPath","fileId","90b9c8f1-c38a-4131-8404-ddca091f8c60","name","fileType","directory","content","createdAt",["D",1748378263766],"branchVersion","branchId","a9e677be-3b39-11f0-a3ac-9e149126039e",{"_30":43,"_32":44,"_33":21,"_35":45,"_36":46,"_38":14,"_39":40,"_24":25},"frontend/index.html","70f4f68c-3b3a-11f0-80d6-9e149126039e","index.html","\n\n\n \n \n GitHub Authentication\n \n \n\n\n

\n \n

\n GitHub Authentication\n

\n Secure authentication service for your applications\n

\n\n

\n \n Redirect URI (where to send users after auth)\n \n \n

\n\n \n

\n\n

\n \n

\n\n

This service provides secure GitHub OAuth authentication.

After authentication, you'll be redirected back to your application with a secure token.

\n\n \n

API Usage

Initiate Sign In:

\n \n GET /auth/signin?redirect_uri=YOUR_APP_URL\n \n

Validate Token:

\n \n GET /auth/validate?token=JWT_TOKEN\n \n

Required Environment Variables:

GITHUB_CLIENT_ID
GITHUB_CLIENT_SECRET
JWT_SECRET

\n\n \n\n",["D",1748378263766],"id","a9e6453c-3b39-11f0-a3ac-9e149126039e","GHauth",["D",1748377929808],"deletedAt","legacyEnvVars","privacy","public","httpPrivacy","description","imageUrl","21f2e37e-8066-4730-9dc7-d27cf8d3c9f3","pinnedFileId","5a6eaba6-3b3a-11f0-bec7-9e149126039e","pinPreview",true,"pinMigrated","screenshotVersion","likeCount",1,"orgId","0630d977-f678-453e-926c-52043293f59f","tursoName","tursoHostname","tursoMeasuredAt","pinned","userPerm","r","valPerm","blobPerm","rw","emailPerm","sqlitePerm","projectPerm","telemetryPerm","user",{"_100":99,"_107":103},"org",{"_100":99,"_101":-5,"_102":103,"_18":58,"_104":105,"_106":25},"branch",{"_13":89,"_32":90,"_47":40,"_91":48,"_92":-5,"_93":-5,"_94":-5,"_95":-5,"_96":-5,"_97":49,"_98":99},"isOwned",15,"main","projectId","forkedBranchId","forkedBranchVersion","forkedProjectPrivacy","forkedProjectId","forkedProjectOrgId","projectName","userHandle","c15r","handle","displayName","avatar","https://img.clerk.com/eyJ0eXBlIjoicHJveHkiLCJzcmMiOiJodHRwczovL2ltYWdlcy5jbGVyay5kZXYvb2F1dGhfZ2l0aHViL2ltZ18yb2RJNlc1czZ1NlpZRmoxdGJ2eFVNNVhmeTYifQ","tier","pro","canRestrictVals","profileImageUrl","branchName","","adoptOrgId",{"_47":48,"_32":49,"_36":218,"_51":-5,"_52":25,"_53":54,"_55":54,"_56":-5,"_57":-5,"_18":58,"_59":60,"_61":62,"_63":62,"_64":-5,"_65":66,"_67":68,"_69":-5,"_70":-5,"_71":-5,"_72":-5,"_73":74,"_75":74,"_76":77,"_78":77,"_79":77,"_80":74,"_81":74,"_82":219,"_84":220,"_86":221,"_88":25},"tree",[177,179,181,183,184],"files",[177,178,179,180,181,182,183,184],"counts",{"_167":141,"_168":66,"_169":141,"_170":171,"_172":173},"contents",[130,131,132,133,134],"upstreamProject","upstreamBranch","emptyEnvVars","flags",[],"hasHttpFiles","grants","orgs","customDomains",{},{"_47":161,"_32":162,"_30":163,"_138":-5,"_39":40,"_38":164,"_139":62,"_36":165,"_13":141,"_33":34,"_35":-5,"_24":25,"_143":-5,"_27":166},{"_47":158,"_32":28,"_30":31,"_138":-5,"_39":40,"_38":14,"_139":62,"_36":159,"_13":141,"_33":34,"_35":-5,"_24":25,"_143":-5,"_27":160},{"_47":152,"_32":153,"_30":154,"_138":-5,"_39":40,"_38":155,"_139":62,"_36":156,"_13":141,"_33":34,"_35":-5,"_24":25,"_143":-5,"_27":157},{"_47":145,"_32":146,"_30":147,"_138":-5,"_39":40,"_38":148,"_139":25,"_36":149,"_13":141,"_33":21,"_35":150,"_24":25,"_143":-5,"_27":151},{"_47":135,"_32":136,"_30":137,"_138":-5,"_39":40,"_38":66,"_139":25,"_36":140,"_13":141,"_33":142,"_35":109,"_24":25,"_143":-5,"_27":144},"a9e8154c-3b39-11f0-a3ac-9e149126039e","main.tsx","a9e81650-3b39-11f0-a3ac-9e149126039e","parentId","latest",["D",1748377929817],0,"script","label",[136],"47d0ee6e-3b3a-11f0-9a11-9e149126039e","README.md","47d0ef0e-3b3a-11f0-9a11-9e149126039e",2,["D",1748378194744],"# GitHub OAuth Authentication Service\n\nA Val Town service for handling GitHub OAuth authentication with redirect support for external applications.\n\n## Features\n\n- GitHub OAuth sign-in flow\n- JWT token generation for authenticated users\n- Redirect support for external applications\n- Secure token validation\n- User profile retrieval\n\n## Setup\n\n1. Create a GitHub OAuth App:\n - Go to GitHub Settings > Developer settings > OAuth Apps\n - Create a new OAuth App\n - Set Authorization callback URL to: `https://[your-val-url]/auth/callback`\n\n2. Set environment variables in Val Town:\n - `GITHUB_CLIENT_ID`: Your GitHub OAuth app client ID\n - `GITHUB_CLIENT_SECRET`: Your GitHub OAuth app client secret\n - `JWT_SECRET`: A secure random string for signing JWT tokens\n\n## Usage\n\n### Sign In Flow\n\n1. Redirect users to: `https://[your-val-url]/auth/signin?redirect_uri=[your-app-url]`\n2. Users will be redirected to GitHub for authentication\n3. After successful auth, users are redirected back to your app with a token: `[your-app-url]?token=[jwt-token]`\n\n### Token Validation\n\nMake a GET request to: `https://[your-val-url]/auth/validate?token=[jwt-token]`\n\nReturns user profile if token is valid.\n\n## API Endpoints\n\n- `GET /auth/signin` - Initiate GitHub OAuth flow\n- `GET /auth/callback` - Handle GitHub OAuth callback\n- `GET /auth/validate` - Validate JWT token and return user info\n- `GET /` - Auth page UI\n\n## File Structure\n\n- `/backend/index.ts` - Main Hono server with OAuth routes\n- `/frontend/index.html` - Auth page UI\n- `/shared/types.ts` - Shared TypeScript types",[146],"4df6514e-3b3a-11f0-b246-9e149126039e","shared","39885a88-d8a3-4095-87bd-5bd287e5cbc3",3,["D",1748378205053],[153],"70f53b88-3b3a-11f0-80d6-9e149126039e",["D",1748378263766],[28],"5a6ed45a-3b3a-11f0-bec7-9e149126039e","backend","bf332b80-887e-4688-9890-891be88c7019",4,["D",1748378225973],[162],"pulls","branches","forks","envVars",{"_174":155,"_176":141},"connections",{"_174":141,"_175":141},"count","unfilledCount","emptyCount",{"_47":161,"_32":162,"_30":163,"_138":-5,"_39":40,"_38":164,"_139":62,"_36":215,"_13":141,"_33":34,"_35":-5,"_24":25,"_143":-5,"_186":216,"_27":217},{"_47":209,"_32":210,"_30":60,"_138":163,"_39":40,"_38":164,"_139":25,"_36":211,"_13":141,"_33":142,"_35":212,"_24":25,"_143":-5,"_186":213,"_27":214},{"_47":158,"_32":28,"_30":31,"_138":-5,"_39":40,"_38":14,"_139":62,"_36":206,"_13":141,"_33":34,"_35":-5,"_24":25,"_143":-5,"_186":207,"_27":208},{"_47":202,"_32":44,"_30":43,"_138":31,"_39":40,"_38":14,"_139":62,"_36":203,"_13":141,"_33":21,"_35":45,"_24":25,"_143":-5,"_186":204,"_27":205},{"_47":152,"_32":153,"_30":154,"_138":-5,"_39":40,"_38":155,"_139":62,"_36":199,"_13":141,"_33":34,"_35":-5,"_24":25,"_143":-5,"_186":200,"_27":201},{"_47":192,"_32":193,"_30":194,"_138":154,"_39":40,"_38":155,"_139":62,"_36":195,"_13":141,"_33":142,"_35":196,"_24":25,"_143":-5,"_186":197,"_27":198},{"_47":145,"_32":146,"_30":147,"_138":-5,"_39":40,"_38":148,"_139":25,"_36":189,"_13":141,"_33":21,"_35":150,"_24":25,"_143":-5,"_186":190,"_27":191},{"_47":135,"_32":136,"_30":137,"_138":-5,"_39":40,"_38":66,"_139":25,"_36":185,"_13":141,"_33":142,"_35":109,"_24":25,"_143":-5,"_186":187,"_27":188},["D",1748377929817],"children",[],[136],["D",1748378194744],[],[146],"4df5f6f4-3b3a-11f0-b246-9e149126039e","types.ts","4df5f7b2-3b3a-11f0-b246-9e149126039e",["D",1748378205053],"// Shared types for GitHub OAuth authentication\n\nexport interface GitHubUser {\n id: number;\n login: string;\n name: string | null;\n email: string | null;\n avatar_url: string;\n html_url: string;\n}\n\nexport interface AuthToken {\n user: GitHubUser;\n iat: number;\n exp: number;\n}\n\nexport interface GitHubTokenResponse {\n access_token: string;\n token_type: string;\n scope: string;\n}\n\nexport interface AuthError {\n error: string;\n error_description?: string;\n}",[],[153,193],["D",1748378205053],[182],[153],"70f4f5b0-3b3a-11f0-80d6-9e149126039e",["D",1748378263766],[],[28,44],["D",1748378263766],[180],[28],"5a6eaae8-3b3a-11f0-bec7-9e149126039e","index.ts",["D",1748378225973],"import { Hono } from \"https://esm.sh/hono@3.11.7\";\nimport { readFile } from \"https://esm.town/v/std/utils@85-main/index.ts\";\nimport { sign, verify } from \"https://esm.sh/jsonwebtoken@9.0.2\";\nimport type { GitHubUser, GitHubTokenResponse, AuthToken, AuthError } from \"../shared/types.ts\";\n\nconst app = new Hono();\n\n// Unwrap Hono errors to see original error details\napp.onError((err, c) => {\n throw err;\n});\n\n// Environment variables\nconst GITHUB_CLIENT_ID = Deno.env.get('GITHUB_CLIENT_ID');\nconst GITHUB_CLIENT_SECRET = Deno.env.get('GITHUB_CLIENT_SECRET');\nconst JWT_SECRET = Deno.env.get('JWT_SECRET');\n\nif (!GITHUB_CLIENT_ID || !GITHUB_CLIENT_SECRET || !JWT_SECRET) {\n throw new Error('Missing required environment variables: GITHUB_CLIENT_ID, GITHUB_CLIENT_SECRET, JWT_SECRET');\n}\n\n// Serve the auth page\napp.get(\"/\", async (c) => {\n const html = await readFile(\"/frontend/index.html\", import.meta.url);\n return c.html(html);\n});\n\n// Initiate GitHub OAuth flow\napp.get(\"/auth/signin\", (c) => {\n const redirectUri = c.req.query('redirect_uri');\n \n if (!redirectUri) {\n return c.json({ error: 'redirect_uri parameter is required' }, 400);\n }\n\n // Store redirect URI in state parameter (base64 encoded for URL safety)\n const state = btoa(redirectUri);\n \n const githubAuthUrl = new URL('https://github.com/login/oauth/authorize');\n githubAuthUrl.searchParams.set('client_id', GITHUB_CLIENT_ID);\n githubAuthUrl.searchParams.set('redirect_uri', `${c.req.url.split('/auth/signin')[0]}/auth/callback`);\n githubAuthUrl.searchParams.set('scope', 'user:email');\n githubAuthUrl.searchParams.set('state', state);\n\n return new Response(null, {\n status: 302,\n headers: { Location: githubAuthUrl.toString() }\n });\n});\n\n// Handle GitHub OAuth callback\napp.get(\"/auth/callback\", async (c) => {\n const code = c.req.query('code');\n const state = c.req.query('state');\n const error = c.req.query('error');\n\n if (error) {\n const errorDescription = c.req.query('error_description') || 'GitHub OAuth error';\n return c.json({ error, error_description: errorDescription }, 400);\n }\n\n if (!code || !state) {\n return c.json({ error: 'Missing code or state parameter' }, 400);\n }\n\n try {\n // Decode redirect URI from state\n const redirectUri = atob(state);\n\n // Exchange code for access token\n const tokenResponse = await fetch('https://github.com/login/oauth/access_token', {\n method: 'POST',\n headers: {\n 'Accept': 'application/json',\n 'Content-Type': 'application/json',\n },\n body: JSON.stringify({\n client_id: GITHUB_CLIENT_ID,\n client_secret: GITHUB_CLIENT_SECRET,\n code,\n }),\n });\n\n const tokenData: GitHubTokenResponse = await tokenResponse.json();\n\n if (!tokenData.access_token) {\n return c.json({ error: 'Failed to obtain access token' }, 400);\n }\n\n // Get user information from GitHub\n const userResponse = await fetch('https://api.github.com/user', {\n headers: {\n 'Authorization': `Bearer ${tokenData.access_token}`,\n 'Accept': 'application/vnd.github.v3+json',\n },\n });\n\n const userData: GitHubUser = await userResponse.json();\n\n // Create JWT token\n const jwtPayload: Omit = {\n user: userData,\n };\n\n const token = sign(jwtPayload, JWT_SECRET, { expiresIn: '7d' });\n\n // Redirect back to the original app with the token\n const finalRedirectUrl = new URL(redirectUri);\n finalRedirectUrl.searchParams.set('token', token);\n\n return new Response(null, {\n status: 302,\n headers: { Location: finalRedirectUrl.toString() }\n });\n\n } catch (error) {\n console.error('OAuth callback error:', error);\n return c.json({ error: 'Authentication failed' }, 500);\n }\n});\n\n// Validate JWT token and return user info\napp.get(\"/auth/validate\", (c) => {\n const token = c.req.query('token');\n\n if (!token) {\n return c.json({ error: 'Token parameter is required' }, 400);\n }\n\n try {\n const decoded = verify(token, JWT_SECRET) as AuthToken;\n return c.json({\n valid: true,\n user: decoded.user,\n expires_at: decoded.exp,\n });\n } catch (error) {\n return c.json({ \n valid: false, \n error: 'Invalid or expired token' \n }, 401);\n }\n});\n\n// Health check endpoint\napp.get(\"/health\", (c) => {\n return c.json({ status: 'ok', timestamp: new Date().toISOString() });\n});\n\n// Export the Hono app\nexport default app.fetch;",[],[162,210],["D",1748378225973],[178],[162],["D",1748377929808],{"_100":99,"_107":103},{"_100":99,"_101":-5,"_102":103,"_18":58,"_104":105,"_106":25},{"_13":89,"_32":90,"_47":40,"_91":48,"_92":-5,"_93":-5,"_94":-5,"_95":-5,"_96":-5,"_97":49,"_98":99},"ctx",{"_82":-5,"_127":255,"_256":257,"_258":259,"_260":25,"_261":25,"_262":25,"_263":62,"_264":-5,"_265":-7,"_266":-7,"_267":141,"_268":25,"_269":25,"_270":-5,"_271":25,"_272":25,"_273":25,"_274":-5},"ENV",{"_226":227,"_228":229,"_230":90,"_231":232,"_233":234,"_235":236,"_237":238,"_239":240,"_241":242,"_243":244,"_245":246,"_247":248,"_249":250,"_251":252,"_253":254},"REACT_APP_SENTRY_DSN","https://586020d86f05489db63a554690acf1e9@o1398359.ingest.sentry.io/6724499","RENDER_GIT_COMMIT","fdb67791413f4386b4dbf18f354029a617f6160f","RENDER_GIT_BRANCH","POSTHOG_API_TOKEN","phc_nmoyuAkStEZuUp69rYlg1DZgrIt19Gx0Y4Hwf8tGgJP","POSTHOG_API_HOST","https://wart.val.town","WEB_API_TEMPLATE","https://{val}.web.val.run","APP_URL","https://www.val.town","MODULE_URL","https://esm.town","VANITY_WEB_API_TEMPLATE","https://{label}.val.run/","DENOLS_URL","https://lsp.val.town","NODE_ENV","production","CLOUDFLARE_TURNSTILE_SITE_KEY","0x4AAAAAACtaIZJH7s9rBMZ6","GOOGLE_CLIENT_ID","875989696899-jtsqkhlbdv5jrlsk8631p7ipjg3c6o62.apps.googleusercontent.com","STRIPE_PUBLISHABLE_KEY","pk_live_51N2zvWEpZTTLipIkVEwXrUG9AT0yeOOEYxszarZT1jpsZV58Ly6wlg3SltZpHN26CUalOBmUSY7adQRQiSkCZz2500qSXNkf8Y","API_URL","https://api.val.town",[],"preferencesKeybindings","default","preferencesTheme","light","preferencesFixers","preferencesCopilot","preferencesSelectionAi","preferencesCloseBrackets","preferencesChatPanelState","preferencesDprint","preferencesDenofmt","notificationCount","flagDenols","isBusinessOrgMember","businessOrgHandle","isBusinessOrgAdmin","isHigherTownieTier","navCollapsed","currentOrgId"]

Diff · v5