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>
214 lines
5.6 KiB
TypeScript
214 lines
5.6 KiB
TypeScript
export interface ParsedRepositoryRef {
|
|
owner: string
|
|
name: string
|
|
fullName: string
|
|
}
|
|
|
|
const normalizeRepositoryName = (value: string) =>
|
|
value.replace(/\.git$/i, '').trim()
|
|
|
|
const buildRepositoryRef = (owner: string, name: string): ParsedRepositoryRef | null => {
|
|
const normalizedOwner = owner.trim()
|
|
const normalizedName = normalizeRepositoryName(name)
|
|
|
|
if (!normalizedOwner || !normalizedName) {
|
|
return null
|
|
}
|
|
|
|
return {
|
|
owner: normalizedOwner,
|
|
name: normalizedName,
|
|
fullName: `${normalizedOwner}/${normalizedName}`,
|
|
}
|
|
}
|
|
|
|
export const parseRepositoryInput = (input: string): ParsedRepositoryRef | null => {
|
|
const trimmed = input.trim()
|
|
if (!trimmed) {
|
|
return null
|
|
}
|
|
|
|
const sshMatch = trimmed.match(/^git@github\.com:([^/\s]+)\/([^/\s]+?)(?:\.git)?$/i)
|
|
if (sshMatch) {
|
|
return buildRepositoryRef(sshMatch[1], sshMatch[2])
|
|
}
|
|
|
|
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 [owner, name] = url.pathname.split('/').filter(Boolean)
|
|
if (owner && name) {
|
|
return buildRepositoryRef(owner, name)
|
|
}
|
|
}
|
|
} catch {
|
|
// Fall through to owner/repo shorthand parsing.
|
|
}
|
|
|
|
const shorthandMatch = trimmed.match(/^([^/\s]+)\/([^/\s?#]+)$/)
|
|
if (shorthandMatch) {
|
|
return buildRepositoryRef(shorthandMatch[1], shorthandMatch[2])
|
|
}
|
|
|
|
return 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)}`
|
|
|
|
export const buildRepoTextPath = (owner: string, name: string) =>
|
|
`${buildRepoPath(owner, name)}/text`
|
|
|
|
export const buildLegacyRepoTextPath = (owner: string, name: string) =>
|
|
`${buildLegacyRepoPath(owner, name)}/text`
|
|
|
|
export const buildRepoTextRawPath = (owner: string, name: string) =>
|
|
`${buildRepoTextPath(owner, name)}/raw`
|
|
|
|
export const buildLegacyRepoTextRawPath = (owner: string, name: string) =>
|
|
`${buildLegacyRepoTextPath(owner, name)}/raw`
|
|
|
|
export const RESERVED_REPO_ALIAS_SEGMENTS = new Set([
|
|
'about',
|
|
'account',
|
|
'activity',
|
|
'admin',
|
|
'ads',
|
|
'analytics',
|
|
'api',
|
|
'api-test',
|
|
'auth',
|
|
'backup',
|
|
'blog',
|
|
'camera',
|
|
'chat',
|
|
'claim',
|
|
'collaborate',
|
|
'collection',
|
|
'collections',
|
|
'compose',
|
|
'create',
|
|
'create-change-story',
|
|
'creator-studio',
|
|
'developers',
|
|
'discover',
|
|
'drafts',
|
|
'edit',
|
|
'error',
|
|
'explore',
|
|
'feed',
|
|
'feedback',
|
|
'follow-requests',
|
|
'followers',
|
|
'following',
|
|
'forgot-password',
|
|
'github',
|
|
'hashtag',
|
|
'help',
|
|
'insights',
|
|
'likes',
|
|
'live',
|
|
'location',
|
|
'login',
|
|
'map',
|
|
'messages',
|
|
'moments',
|
|
'notifications',
|
|
'onboarding',
|
|
'partnerships',
|
|
'post',
|
|
'pricing',
|
|
'privacy-policy',
|
|
'profile',
|
|
'project',
|
|
'projects',
|
|
'reel',
|
|
'reels',
|
|
'register',
|
|
'repo',
|
|
'reset-password',
|
|
'saved',
|
|
'scheduled',
|
|
'search',
|
|
'settings',
|
|
'store',
|
|
'stories',
|
|
'story',
|
|
'subscription',
|
|
'suggested',
|
|
'tag',
|
|
'terms',
|
|
'trending',
|
|
'user',
|
|
])
|
|
|
|
export const isReservedRepoAliasSegment = (segment: string) =>
|
|
RESERVED_REPO_ALIAS_SEGMENTS.has(segment.toLowerCase())
|