import api from './api' export type TalentVerificationLevel = 'verified' | 'linked' | 'recorded' export interface TalentEvidence { id: string kind: 'repository_claim' | 'github_sync' | 'github_activity' | 'project_record' | 'institutional_pilot' label: string detail: string occurredAt: string sourceUrl: string | null } export interface TalentProject { id: string source: 'repository' | 'project' name: string fullName: string description: string | null url: string | null language: string | null topics: string[] stars: number forks: number role: string verificationLevel: TalentVerificationLevel lastVerifiedAt: string evidence: TalentEvidence[] } export interface TalentCollaborator { id: string username: string | null displayName: string | null avatarUrl: string | null githubUsername: string | null sharedProjects: Array<{ id: string fullName: string url: string theirRole: string yourRole: string }> } export interface TalentGraph { profile: { id: string username: string | null displayName: string | null avatarUrl: string | null bio: string | null githubUsername: string | null githubConnected: boolean memberSince: string } summary: { projectCount: number verifiedProjectCount: number recordedActivityCount: number collaboratorCount: number } projects: TalentProject[] collaborators: TalentCollaborator[] generatedAt: string } export type TalentOpportunityStatus = 'OPEN' | 'MATCHING' | 'PILOT' | 'CLOSED' export interface TalentPilotSummary { id: string participantId: string status: 'PLANNED' | 'ACTIVE' | 'REVIEW' | 'COMPLETED' | 'CANCELLED' updatedAt: string revision: number } export interface TalentPilotStatusTransition { id: string pilotId: string actorId: string previousStatus: TalentPilotSummary['status'] nextStatus: TalentPilotSummary['status'] revision: number createdAt: string } export interface TalentPilot extends TalentPilotSummary { opportunityId: string referralId: string | null deliverableUrl: string | null feedback: string | null publicEvidenceConsent: boolean startedAt: string | null completedAt: string | null viewerRole: 'participant' | 'institution' opportunity: TalentOpportunity referral: Omit | null statusTransitions: TalentPilotStatusTransition[] } export interface UpdateTalentPilotInput { expectedRevision: number status?: TalentPilotSummary['status'] deliverableUrl?: string publicEvidenceConsent?: boolean } export interface TalentOpportunity { id: string organizationName: string title: string problem: string requiredSkills: string[] successMetric: string durationWeeks: number sourceChannel: 'direct' | 'gitgram' | 'zemin360' | 'zen-talent' communityReferralConsent: boolean viewerRole?: 'institution' | 'public' status: TalentOpportunityStatus revision: number pilotSummary?: { total: number active: number completed: number } referralSummary?: { total: number contacted: number accepted: number declined: number } createdAt: string updatedAt: string } export interface TalentReferral { id: string opportunityId: string participantId: string referredById: string status: 'CONTACTED' | 'ACCEPTED' | 'DECLINED' revision: number respondedAt: string | null createdAt: string updatedAt: string viewerRole: 'participant' | 'institution' opportunity: TalentOpportunity } export interface TalentMatch { profile: { id: string username: string displayName: string | null avatarUrl: string | null bio: string | null githubUsername: string | null } score: number matchedSkills: string[] missingSkills: string[] reason: string projects: Array<{ id: string fullName: string url: string matchedSkills: string[] verificationLevel: TalentVerificationLevel }> } export type CoverageStrength = 'verified' | 'evidenced' | 'interest' | 'unmet' export interface SkillCoverage { skill: string strength: CoverageStrength candidateCount: number evidencedCount: number verifiedCount: number } export interface NeedCoverageAnalysis { requiredSkills: string[] coverage: SkillCoverage[] unmetSkills: string[] coverageRatio: number status: 'fully-covered' | 'partially-covered' | 'unmet' candidatePool: number } export interface CreateTalentOpportunityInput { organizationName: string title: string problem: string requiredSkills: string[] successMetric: string durationWeeks: number sourceChannel: 'direct' | 'gitgram' | 'zemin360' | 'zen-talent' communityReferralConsent: boolean } // --------------------------------------------------------------------------- // Recruiter placement / candidate-unlock revenue (Creem) // --------------------------------------------------------------------------- export type TalentPlacementStatus = 'pending' | 'paid' | 'failed' | 'refunded' export type TalentFeeModel = 'unlock' | 'placement' /** A recruiter's placement entitlement (receipt) for a matched candidate. */ export interface TalentPlacement { id: string opportunityId: string candidateId: string recruiterId: string feeCents: number currency: string feeModel: TalentFeeModel status: TalentPlacementStatus provider: string checkoutId: string | null providerOrderId: string | null paidAt: string | null createdAt: string updatedAt: string } /** Result of opening (or replaying) a candidate-unlock charge. */ export interface RequestUnlockResult { placement: TalentPlacement /** Hosted Creem checkout URL, or null when the entitlement is already paid. */ checkoutUrl: string | null alreadyUnlocked: boolean } /** The gated resource revealed only once a paid unlock entitlement exists. */ export interface TalentCandidateContact { contact: { id: string username: string | null displayName: string | null email: string | null githubUsername: string | null } evidence: TalentGraph } export const talentGraphService = { getMine: async (): Promise => { const { data } = await api.get<{ data: TalentGraph }>('/talent-graph/me') return data.data }, getPublic: async (username: string): Promise => { const { data } = await api.get<{ data: TalentGraph }>(`/talent-graph/public/${encodeURIComponent(username)}`) return data.data }, listOpportunities: async (): Promise => { const { data } = await api.get<{ data: TalentOpportunity[] }>('/talent-graph/opportunities') return data.data }, createOpportunity: async (input: CreateTalentOpportunityInput, idempotencyKey: string): Promise => { const { data } = await api.post<{ data: TalentOpportunity }>('/talent-graph/opportunities', input, mutationConfig(idempotencyKey)) return data.data }, getOpportunityMatches: async (id: string): Promise<{ opportunity: TalentOpportunity; matches: TalentMatch[] }> => { const { data } = await api.get<{ data: { opportunity: TalentOpportunity; matches: TalentMatch[] } }>(`/talent-graph/opportunities/${encodeURIComponent(id)}/matches`) return data.data }, getOpportunityCoverage: async (id: string): Promise<{ opportunity: TalentOpportunity; coverage: NeedCoverageAnalysis }> => { const { data } = await api.get<{ data: { opportunity: TalentOpportunity; coverage: NeedCoverageAnalysis } }>(`/talent-graph/opportunities/${encodeURIComponent(id)}/coverage`) return data.data }, startPilot: async (opportunityId: string, participantId: string, milestones: string[], idempotencyKey: string): Promise => { const { data } = await api.post<{ data: TalentPilot }>(`/talent-graph/opportunities/${encodeURIComponent(opportunityId)}/pilots`, { participantId, milestones }, mutationConfig(idempotencyKey)) return data.data }, createReferral: async (opportunityId: string, participantId: string, idempotencyKey: string): Promise => { const { data } = await api.post<{ data: TalentReferral }>(`/talent-graph/opportunities/${encodeURIComponent(opportunityId)}/referrals`, { participantId }, mutationConfig(idempotencyKey)) return data.data }, listMyReferrals: async (): Promise => { const { data } = await api.get<{ data: TalentReferral[] }>('/talent-graph/referrals/mine') return data.data }, updateReferral: async (referralId: string, status: 'ACCEPTED' | 'DECLINED', expectedRevision: number, idempotencyKey: string): Promise => { const { data } = await api.patch<{ data: TalentReferral }>(`/talent-graph/referrals/${encodeURIComponent(referralId)}`, { status, expectedRevision }, mutationConfig(idempotencyKey)) return data.data }, listMyPilots: async (): Promise => { const { data } = await api.get<{ data: TalentPilot[] }>('/talent-graph/pilots/mine') return data.data }, updatePilot: async (pilotId: string, input: UpdateTalentPilotInput, idempotencyKey: string): Promise => { const { data } = await api.patch<{ data: TalentPilot }>(`/talent-graph/pilots/${encodeURIComponent(pilotId)}`, input, mutationConfig(idempotencyKey)) return data.data }, // ── Recruiter placement / candidate-unlock revenue ────────────────────── // The opportunity owner pays a Creem placement fee to reveal a matched // candidate's contact details + full evidence. All three endpoints are // owner-gated on the backend (talentBillingController). /** Lists the recruiter's placement entitlements (receipts) for an opportunity. */ listUnlocks: async (opportunityId: string): Promise => { const { data } = await api.get<{ data: TalentPlacement[] }>(`/talent-graph/opportunities/${encodeURIComponent(opportunityId)}/unlocks`) return data.data }, /** * Opens (or replays) a paid unlock for a matched candidate. Returns a Creem * checkout URL to complete payment, or `alreadyUnlocked` when the entitlement * is already settled. `placementAmountCents` switches the flat access fee to a * success-fee model when an agreed placement amount is known. */ requestUnlock: async ( opportunityId: string, candidateId: string, idempotencyKey: string, placementAmountCents?: number, ): Promise => { const body: { candidateId: string; placementAmountCents?: number } = { candidateId } if (placementAmountCents !== undefined) body.placementAmountCents = placementAmountCents const { data } = await api.post<{ data: RequestUnlockResult }>( `/talent-graph/opportunities/${encodeURIComponent(opportunityId)}/unlocks`, body, mutationConfig(idempotencyKey), ) return data.data }, /** * Reads the gated contact details + full evidence for an unlocked candidate. * The backend returns 402 Payment Required until the entitlement is paid. */ getCandidateContact: async (opportunityId: string, candidateId: string): Promise => { const { data } = await api.get<{ data: TalentCandidateContact }>( `/talent-graph/opportunities/${encodeURIComponent(opportunityId)}/candidates/${encodeURIComponent(candidateId)}/contact`, ) return data.data }, } function mutationConfig(idempotencyKey: string) { return { headers: { 'Idempotency-Key': idempotencyKey } } }