feat(web): parseGithubUrl — map any GitHub account/repo URL to its Gitgram profile

Every GitHub account and repo is a first-class Gitgram profile (hosting the project's
posts, demos, photos, reels, snippets). parseGithubUrl resolves both forms:
  https://github.com/caelum0x           -> /caelum0x            (user account)
  https://github.com/caelum0x/settlekit -> /caelum0x/settlekit  (repo account)
Handles www, trailing slash, .git, deep paths, ssh, and owner / owner-repo / @handle
shorthand; rejects reserved route segments. 5/5 tests pass.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This commit is contained in:
caelum0x 2026-06-29 02:16:32 +03:00
parent 91c8525546
commit 7aa69d0864
2 changed files with 100 additions and 0 deletions

View File

@ -0,0 +1,38 @@
import { describe, it, expect } from 'vitest'
import { parseGithubUrl } from '../utils/repositoryRouting'
describe('GitHub URL -> Gitgram account transformation', () => {
it('maps a GitHub user URL to a Gitgram user account', () => {
const ref = parseGithubUrl('https://github.com/caelum0x')
expect(ref).toEqual({ type: 'user', owner: 'caelum0x', gitgramPath: '/caelum0x' })
})
it('maps a GitHub repo URL to a Gitgram repo account', () => {
const ref = parseGithubUrl('https://github.com/caelum0x/settlekit')
expect(ref).toEqual({
type: 'repo',
owner: 'caelum0x',
name: 'settlekit',
gitgramPath: '/caelum0x/settlekit',
})
})
it('handles www, trailing slash, .git, and deep paths', () => {
expect(parseGithubUrl('https://www.github.com/caelum0x/')?.gitgramPath).toBe('/caelum0x')
expect(parseGithubUrl('https://github.com/caelum0x/settlekit.git')?.gitgramPath).toBe('/caelum0x/settlekit')
expect(parseGithubUrl('https://github.com/caelum0x/settlekit/tree/main')?.gitgramPath).toBe('/caelum0x/settlekit')
expect(parseGithubUrl('git@github.com:caelum0x/settlekit.git')?.gitgramPath).toBe('/caelum0x/settlekit')
})
it('handles shorthand (owner, owner/repo, @handle)', () => {
expect(parseGithubUrl('caelum0x')).toEqual({ type: 'user', owner: 'caelum0x', gitgramPath: '/caelum0x' })
expect(parseGithubUrl('@caelum0x')?.owner).toBe('caelum0x')
expect(parseGithubUrl('caelum0x/settlekit')?.gitgramPath).toBe('/caelum0x/settlekit')
})
it('rejects reserved route segments and junk', () => {
expect(parseGithubUrl('https://github.com/settings')).toBeNull()
expect(parseGithubUrl('explore')).toBeNull()
expect(parseGithubUrl('')).toBeNull()
})
})

View File

@ -58,6 +58,68 @@ export const parseRepositoryInput = (input: string): ParsedRepositoryRef | null
export const buildRepoPath = (owner: string, name: string) =>
`/${encodeURIComponent(owner)}/${encodeURIComponent(name)}`
export const buildOwnerPath = (owner: string) => `/${encodeURIComponent(owner.trim())}`
export type GithubRefType = 'user' | 'repo'
export interface GithubRef {
/** 'user' when the URL points at a GitHub account, 'repo' when it points at a repository. */
type: GithubRefType
owner: string
/** Repository name — only present when type === 'repo'. */
name?: string
/** The canonical Gitgram path this GitHub URL maps to (each account/repo is a Gitgram profile). */
gitgramPath: string
}
/**
* Transform a GitHub URL (or owner / owner/repo shorthand) into the Gitgram account it maps to.
* Every GitHub account and repository is a first-class Gitgram profile that can host the project's
* posts, demos, photos, reels, and snippets:
* https://github.com/caelum0x -> { type:'user', owner:'caelum0x', gitgramPath:'/caelum0x' }
* https://github.com/caelum0x/settlekit -> { type:'repo', owner:'caelum0x', name:'settlekit', gitgramPath:'/caelum0x/settlekit' }
*/
export const parseGithubUrl = (input: string): GithubRef | null => {
const trimmed = input.trim()
if (!trimmed) {
return null
}
// Repository form (URL, ssh, or owner/repo shorthand) — reuse the existing parser.
const repo = parseRepositoryInput(trimmed)
if (repo) {
return {
type: 'repo',
owner: repo.owner,
name: repo.name,
gitgramPath: buildRepoPath(repo.owner, repo.name),
}
}
// Owner-only GitHub URL, e.g. https://github.com/caelum0x
const directUrlCandidate = /^[a-z]+:\/\//i.test(trimmed) ? trimmed : `https://${trimmed}`
try {
const url = new URL(directUrlCandidate)
if (url.hostname === 'github.com' || url.hostname === 'www.github.com') {
const segments = url.pathname.split('/').filter(Boolean)
const owner = segments[0]
if (segments.length === 1 && owner && !isReservedRepoAliasSegment(owner)) {
return { type: 'user', owner, gitgramPath: buildOwnerPath(owner) }
}
}
} catch {
// Fall through to bare-username shorthand.
}
// Bare username / @handle shorthand, e.g. "caelum0x" or "@caelum0x"
const bare = trimmed.match(/^@?([A-Za-z0-9](?:[A-Za-z0-9-]{0,38})?)$/)
if (bare && !isReservedRepoAliasSegment(bare[1])) {
return { type: 'user', owner: bare[1], gitgramPath: buildOwnerPath(bare[1]) }
}
return null
}
export const buildLegacyRepoPath = (owner: string, name: string) =>
`/repo/${encodeURIComponent(owner)}/${encodeURIComponent(name)}`