@pg-atlas/data-sdk 0.4.0

package/dist/generated/schemas.gen.js

@@ -0,0 +1,1338 @@
+// This file is auto-generated by @hey-api/openapi-ts
+export const VisibilitySchema = {
+    type: 'string',
+    enum: [
+        'public',
+        'private'
+    ],
+    title: 'Visibility',
+    description: 'Whether a Repo is publicly accessible (affects data collection scope).'
+};
+export const ValidationErrorSchema = {
+    properties: {
+        loc: {
+            items: {
+                anyOf: [
+                    {
+                        type: 'string'
+                    },
+                    {
+                        type: 'integer'
+                    }
+                ]
+            },
+            type: 'array',
+            title: 'Location'
+        },
+        msg: {
+            type: 'string',
+            title: 'Message'
+        },
+        type: {
+            type: 'string',
+            title: 'Error Type'
+        },
+        input: {
+            title: 'Input'
+        },
+        ctx: {
+            type: 'object',
+            title: 'Context'
+        }
+    },
+    type: 'object',
+    required: [
+        'loc',
+        'msg',
+        'type'
+    ],
+    title: 'ValidationError'
+};
+export const SubmissionStatusSchema = {
+    type: 'string',
+    enum: [
+        'pending',
+        'processed',
+        'failed'
+    ],
+    title: 'SubmissionStatus',
+    description: 'Processing state of an SbomSubmission record.'
+};
+export const ScfSubmissionSchema = {
+    properties: {
+        round: {
+            type: 'string',
+            title: 'Round'
+        },
+        title: {
+            type: 'string',
+            title: 'Title'
+        }
+    },
+    type: 'object',
+    required: [
+        'round',
+        'title'
+    ],
+    title: 'ScfSubmission',
+    description: 'A single SCF funding round submission.'
+};
+export const SbomSubmissionResponseSchema = {
+    properties: {
+        id: {
+            type: 'integer',
+            title: 'Id'
+        },
+        repository_claim: {
+            type: 'string',
+            title: 'Repository Claim'
+        },
+        actor_claim: {
+            type: 'string',
+            title: 'Actor Claim'
+        },
+        sbom_content_hash: {
+            type: 'string',
+            title: 'Sbom Content Hash'
+        },
+        artifact_path: {
+            type: 'string',
+            title: 'Artifact Path'
+        },
+        status: {
+            $ref: '#/components/schemas/SubmissionStatus'
+        },
+        error_detail: {
+            anyOf: [
+                {
+                    type: 'string'
+                },
+                {
+                    type: 'null'
+                }
+            ],
+            title: 'Error Detail'
+        },
+        submitted_at: {
+            type: 'string',
+            format: 'date-time',
+            title: 'Submitted At'
+        },
+        processed_at: {
+            anyOf: [
+                {
+                    type: 'string',
+                    format: 'date-time'
+                },
+                {
+                    type: 'null'
+                }
+            ],
+            title: 'Processed At'
+        }
+    },
+    type: 'object',
+    required: [
+        'id',
+        'repository_claim',
+        'actor_claim',
+        'sbom_content_hash',
+        'artifact_path',
+        'status',
+        'error_detail',
+        'submitted_at',
+        'processed_at'
+    ],
+    title: 'SbomSubmissionResponse',
+    description: 'Full SBOM submission record.\n\nSerialised from the ``SbomSubmission`` ORM model.  The ``sbom_content_hash``\nfield is the SHA-256 hex digest of the raw submitted payload.'
+};
+export const SbomSubmissionListResponseSchema = {
+    properties: {
+        items: {
+            items: {
+                $ref: '#/components/schemas/SbomSubmissionResponse'
+            },
+            type: 'array',
+            title: 'Items'
+        },
+        total: {
+            type: 'integer',
+            title: 'Total'
+        },
+        limit: {
+            type: 'integer',
+            title: 'Limit'
+        },
+        offset: {
+            type: 'integer',
+            title: 'Offset'
+        }
+    },
+    type: 'object',
+    required: [
+        'items',
+        'total',
+        'limit',
+        'offset'
+    ],
+    title: 'SbomSubmissionListResponse',
+    description: 'Paginated list of SBOM submission records.\n\nReturned by the list endpoint with ``total`` reflecting the count after\nany ``repository`` filter has been applied.'
+};
+export const SbomSubmissionDetailResponseSchema = {
+    properties: {
+        id: {
+            type: 'integer',
+            title: 'Id'
+        },
+        repository_claim: {
+            type: 'string',
+            title: 'Repository Claim'
+        },
+        actor_claim: {
+            type: 'string',
+            title: 'Actor Claim'
+        },
+        sbom_content_hash: {
+            type: 'string',
+            title: 'Sbom Content Hash'
+        },
+        artifact_path: {
+            type: 'string',
+            title: 'Artifact Path'
+        },
+        status: {
+            $ref: '#/components/schemas/SubmissionStatus'
+        },
+        error_detail: {
+            anyOf: [
+                {
+                    type: 'string'
+                },
+                {
+                    type: 'null'
+                }
+            ],
+            title: 'Error Detail'
+        },
+        submitted_at: {
+            type: 'string',
+            format: 'date-time',
+            title: 'Submitted At'
+        },
+        processed_at: {
+            anyOf: [
+                {
+                    type: 'string',
+                    format: 'date-time'
+                },
+                {
+                    type: 'null'
+                }
+            ],
+            title: 'Processed At'
+        },
+        raw_artifact: {
+            anyOf: [
+                {
+                    type: 'string'
+                },
+                {
+                    type: 'null'
+                }
+            ],
+            title: 'Raw Artifact'
+        }
+    },
+    type: 'object',
+    required: [
+        'id',
+        'repository_claim',
+        'actor_claim',
+        'sbom_content_hash',
+        'artifact_path',
+        'status',
+        'error_detail',
+        'submitted_at',
+        'processed_at'
+    ],
+    title: 'SbomSubmissionDetailResponse',
+    description: 'Extended SBOM submission record with the raw artifact content.\n\nReturned by the detail endpoint.  ``raw_artifact`` contains the full JSON\ntext of the stored SBOM, or ``None`` if the artifact file is missing from\nthe store.'
+};
+export const SbomAcceptedResponseSchema = {
+    properties: {
+        message: {
+            type: 'string',
+            title: 'Message'
+        },
+        repository: {
+            type: 'string',
+            title: 'Repository'
+        },
+        package_count: {
+            type: 'integer',
+            title: 'Package Count'
+        }
+    },
+    type: 'object',
+    required: [
+        'message',
+        'repository',
+        'package_count'
+    ],
+    title: 'SbomAcceptedResponse',
+    description: 'Response body returned on successful SBOM submission (202 Accepted).'
+};
+export const RepoVertexTypeSchema = {
+    type: 'string',
+    enum: [
+        'repo',
+        'external-repo'
+    ],
+    title: 'RepoVertexType',
+    description: 'Discriminator values for the RepoVertex joined-table-inheritance hierarchy.'
+};
+export const RepoSummarySchema = {
+    properties: {
+        canonical_id: {
+            type: 'string',
+            title: 'Canonical Id'
+        },
+        display_name: {
+            type: 'string',
+            title: 'Display Name'
+        },
+        visibility: {
+            $ref: '#/components/schemas/Visibility'
+        },
+        latest_version: {
+            type: 'string',
+            title: 'Latest Version'
+        },
+        latest_commit_date: {
+            anyOf: [
+                {
+                    type: 'string',
+                    format: 'date-time'
+                },
+                {
+                    type: 'null'
+                }
+            ],
+            title: 'Latest Commit Date'
+        },
+        repo_url: {
+            anyOf: [
+                {
+                    type: 'string'
+                },
+                {
+                    type: 'null'
+                }
+            ],
+            title: 'Repo Url'
+        },
+        project_id: {
+            anyOf: [
+                {
+                    type: 'integer'
+                },
+                {
+                    type: 'null'
+                }
+            ],
+            title: 'Project Id'
+        },
+        pony_factor: {
+            anyOf: [
+                {
+                    type: 'integer'
+                },
+                {
+                    type: 'null'
+                }
+            ],
+            title: 'Pony Factor'
+        },
+        criticality_score: {
+            anyOf: [
+                {
+                    type: 'integer'
+                },
+                {
+                    type: 'null'
+                }
+            ],
+            title: 'Criticality Score'
+        },
+        adoption_downloads: {
+            anyOf: [
+                {
+                    type: 'integer'
+                },
+                {
+                    type: 'null'
+                }
+            ],
+            title: 'Adoption Downloads'
+        },
+        adoption_stars: {
+            anyOf: [
+                {
+                    type: 'integer'
+                },
+                {
+                    type: 'null'
+                }
+            ],
+            title: 'Adoption Stars'
+        },
+        adoption_forks: {
+            anyOf: [
+                {
+                    type: 'integer'
+                },
+                {
+                    type: 'null'
+                }
+            ],
+            title: 'Adoption Forks'
+        },
+        updated_at: {
+            type: 'string',
+            format: 'date-time',
+            title: 'Updated At'
+        }
+    },
+    type: 'object',
+    required: [
+        'canonical_id',
+        'display_name',
+        'visibility',
+        'latest_version',
+        'latest_commit_date',
+        'repo_url',
+        'project_id',
+        'pony_factor',
+        'criticality_score',
+        'adoption_downloads',
+        'adoption_stars',
+        'adoption_forks',
+        'updated_at'
+    ],
+    title: 'RepoSummary',
+    description: 'Compact repo representation used in list endpoints and as an embedded\nreference in project detail responses.'
+};
+export const RepoDetailResponseSchema = {
+    properties: {
+        canonical_id: {
+            type: 'string',
+            title: 'Canonical Id'
+        },
+        display_name: {
+            type: 'string',
+            title: 'Display Name'
+        },
+        visibility: {
+            $ref: '#/components/schemas/Visibility'
+        },
+        latest_version: {
+            type: 'string',
+            title: 'Latest Version'
+        },
+        latest_commit_date: {
+            anyOf: [
+                {
+                    type: 'string',
+                    format: 'date-time'
+                },
+                {
+                    type: 'null'
+                }
+            ],
+            title: 'Latest Commit Date'
+        },
+        repo_url: {
+            anyOf: [
+                {
+                    type: 'string'
+                },
+                {
+                    type: 'null'
+                }
+            ],
+            title: 'Repo Url'
+        },
+        project_id: {
+            anyOf: [
+                {
+                    type: 'integer'
+                },
+                {
+                    type: 'null'
+                }
+            ],
+            title: 'Project Id'
+        },
+        pony_factor: {
+            anyOf: [
+                {
+                    type: 'integer'
+                },
+                {
+                    type: 'null'
+                }
+            ],
+            title: 'Pony Factor'
+        },
+        criticality_score: {
+            anyOf: [
+                {
+                    type: 'integer'
+                },
+                {
+                    type: 'null'
+                }
+            ],
+            title: 'Criticality Score'
+        },
+        adoption_downloads: {
+            anyOf: [
+                {
+                    type: 'integer'
+                },
+                {
+                    type: 'null'
+                }
+            ],
+            title: 'Adoption Downloads'
+        },
+        adoption_stars: {
+            anyOf: [
+                {
+                    type: 'integer'
+                },
+                {
+                    type: 'null'
+                }
+            ],
+            title: 'Adoption Stars'
+        },
+        adoption_forks: {
+            anyOf: [
+                {
+                    type: 'integer'
+                },
+                {
+                    type: 'null'
+                }
+            ],
+            title: 'Adoption Forks'
+        },
+        updated_at: {
+            type: 'string',
+            format: 'date-time',
+            title: 'Updated At'
+        },
+        releases: {
+            anyOf: [
+                {
+                    items: {
+                        additionalProperties: true,
+                        type: 'object'
+                    },
+                    type: 'array'
+                },
+                {
+                    type: 'null'
+                }
+            ],
+            title: 'Releases'
+        },
+        parent_project: {
+            anyOf: [
+                {
+                    $ref: '#/components/schemas/ProjectSummary'
+                },
+                {
+                    type: 'null'
+                }
+            ]
+        },
+        contributors: {
+            items: {
+                $ref: '#/components/schemas/ContributorSummary'
+            },
+            type: 'array',
+            title: 'Contributors'
+        },
+        outgoing_dep_counts: {
+            $ref: '#/components/schemas/DepCounts'
+        },
+        incoming_dep_counts: {
+            $ref: '#/components/schemas/DepCounts'
+        }
+    },
+    type: 'object',
+    required: [
+        'canonical_id',
+        'display_name',
+        'visibility',
+        'latest_version',
+        'latest_commit_date',
+        'repo_url',
+        'project_id',
+        'pony_factor',
+        'criticality_score',
+        'adoption_downloads',
+        'adoption_stars',
+        'adoption_forks',
+        'updated_at',
+        'releases',
+        'parent_project',
+        'contributors',
+        'outgoing_dep_counts',
+        'incoming_dep_counts'
+    ],
+    title: 'RepoDetailResponse',
+    description: 'Full repo detail with parent project, contributors, releases, and\ndependency counts.'
+};
+export const DepCountsSchema = {
+    properties: {
+        repos: {
+            type: 'integer',
+            title: 'Repos'
+        },
+        external_repos: {
+            type: 'integer',
+            title: 'External Repos'
+        }
+    },
+    type: 'object',
+    required: [
+        'repos',
+        'external_repos'
+    ],
+    title: 'DepCounts',
+    description: 'Counts of dependency edges grouped by target vertex type.\n\nProvided as part of the repo detail response so the frontend can show\n"depends on N repos + M external" without fetching the full edge list.'
+};
+export const ContributorSummarySchema = {
+    properties: {
+        id: {
+            type: 'integer',
+            title: 'Id'
+        },
+        name: {
+            type: 'string',
+            title: 'Name'
+        },
+        email_hash: {
+            type: 'string',
+            title: 'Email Hash'
+        }
+    },
+    type: 'object',
+    required: [
+        'id',
+        'name',
+        'email_hash'
+    ],
+    title: 'ContributorSummary',
+    description: 'Compact contributor reference embedded in repo detail responses.'
+};
+export const ActivityStatusSchema = {
+    type: 'string',
+    enum: [
+        'live',
+        'in-dev',
+        'discontinued',
+        'non-responsive'
+    ],
+    title: 'ActivityStatus',
+    description: 'Lifecycle status of a Project.\n\nUpdated by the SCF Impact Survey (yearly) and higher-frequency signals;\nsee the Activity Status Update Logic in the architecture docs.'
+};
+export const ProjectTypeSchema = {
+    type: 'string',
+    enum: [
+        'public-good',
+        'scf-project'
+    ],
+    title: 'ProjectType',
+    description: 'Classification of a Project within the PG Atlas universe.'
+};
+export const ProjectSummarySchema = {
+    properties: {
+        canonical_id: {
+            type: 'string',
+            title: 'Canonical Id'
+        },
+        display_name: {
+            type: 'string',
+            title: 'Display Name'
+        },
+        project_type: {
+            $ref: '#/components/schemas/ProjectType'
+        },
+        activity_status: {
+            $ref: '#/components/schemas/ActivityStatus'
+        },
+        category: {
+            anyOf: [
+                {
+                    type: 'string'
+                },
+                {
+                    type: 'null'
+                }
+            ],
+            title: 'Category'
+        },
+        git_owner_url: {
+            anyOf: [
+                {
+                    type: 'string'
+                },
+                {
+                    type: 'null'
+                }
+            ],
+            title: 'Git Owner Url'
+        },
+        pony_factor: {
+            anyOf: [
+                {
+                    type: 'integer'
+                },
+                {
+                    type: 'null'
+                }
+            ],
+            title: 'Pony Factor'
+        },
+        criticality_score: {
+            anyOf: [
+                {
+                    type: 'integer'
+                },
+                {
+                    type: 'null'
+                }
+            ],
+            title: 'Criticality Score'
+        },
+        adoption_score: {
+            anyOf: [
+                {
+                    type: 'number'
+                },
+                {
+                    type: 'null'
+                }
+            ],
+            title: 'Adoption Score'
+        },
+        updated_at: {
+            type: 'string',
+            format: 'date-time',
+            title: 'Updated At'
+        }
+    },
+    type: 'object',
+    required: [
+        'canonical_id',
+        'display_name',
+        'project_type',
+        'activity_status',
+        'category',
+        'git_owner_url',
+        'pony_factor',
+        'criticality_score',
+        'adoption_score',
+        'updated_at'
+    ],
+    title: 'ProjectSummary',
+    description: 'Compact project representation used in list endpoints and as an embedded\nreference in repo detail responses.'
+};
+export const RepoDependencySchema = {
+    properties: {
+        canonical_id: {
+            type: 'string',
+            title: 'Canonical Id'
+        },
+        display_name: {
+            type: 'string',
+            title: 'Display Name'
+        },
+        vertex_type: {
+            $ref: '#/components/schemas/RepoVertexType'
+        },
+        version_range: {
+            anyOf: [
+                {
+                    type: 'string'
+                },
+                {
+                    type: 'null'
+                }
+            ],
+            title: 'Version Range'
+        },
+        confidence: {
+            $ref: '#/components/schemas/EdgeConfidence'
+        }
+    },
+    type: 'object',
+    required: [
+        'canonical_id',
+        'display_name',
+        'vertex_type',
+        'version_range',
+        'confidence'
+    ],
+    title: 'RepoDependency',
+    description: 'A single dependency or reverse-dependency edge from a repo.\n\n``vertex_type`` tells the frontend whether the target is an in-ecosystem\n``Repo`` or an ``ExternalRepo``.'
+};
+export const EdgeConfidenceSchema = {
+    type: 'string',
+    enum: [
+        'verified-sbom',
+        'inferred-shadow'
+    ],
+    title: 'EdgeConfidence',
+    description: 'How firmly an edge was established.'
+};
+export const ProjectMetadataSchema = {
+    properties: {
+        scf_submissions: {
+            items: {
+                $ref: '#/components/schemas/ScfSubmission'
+            },
+            type: 'array',
+            title: 'Scf Submissions',
+            default: []
+        },
+        description: {
+            anyOf: [
+                {
+                    type: 'string'
+                },
+                {
+                    type: 'null'
+                }
+            ],
+            title: 'Description'
+        },
+        technical_architecture: {
+            anyOf: [
+                {
+                    type: 'string'
+                },
+                {
+                    type: 'null'
+                }
+            ],
+            title: 'Technical Architecture'
+        },
+        scf_tranche_completion: {
+            anyOf: [
+                {
+                    type: 'string'
+                },
+                {
+                    type: 'null'
+                }
+            ],
+            title: 'Scf Tranche Completion'
+        },
+        website: {
+            anyOf: [
+                {
+                    type: 'string'
+                },
+                {
+                    type: 'null'
+                }
+            ],
+            title: 'Website'
+        },
+        x_profile: {
+            anyOf: [
+                {
+                    type: 'string'
+                },
+                {
+                    type: 'null'
+                }
+            ],
+            title: 'X Profile'
+        },
+        total_awarded_usd: {
+            anyOf: [
+                {
+                    type: 'integer'
+                },
+                {
+                    type: 'number'
+                },
+                {
+                    type: 'null'
+                }
+            ],
+            title: 'Total Awarded Usd'
+        },
+        total_paid_usd: {
+            anyOf: [
+                {
+                    type: 'integer'
+                },
+                {
+                    type: 'number'
+                },
+                {
+                    type: 'null'
+                }
+            ],
+            title: 'Total Paid Usd'
+        },
+        awarded_submissions_count: {
+            anyOf: [
+                {
+                    type: 'integer'
+                },
+                {
+                    type: 'null'
+                }
+            ],
+            title: 'Awarded Submissions Count'
+        },
+        open_source: {
+            anyOf: [
+                {
+                    type: 'boolean'
+                },
+                {
+                    type: 'null'
+                }
+            ],
+            title: 'Open Source'
+        },
+        socials: {
+            anyOf: [
+                {
+                    items: {
+                        additionalProperties: true,
+                        type: 'object'
+                    },
+                    type: 'array'
+                },
+                {
+                    type: 'null'
+                }
+            ],
+            title: 'Socials'
+        },
+        analytics: {
+            anyOf: [
+                {},
+                {
+                    type: 'null'
+                }
+            ],
+            title: 'Analytics'
+        },
+        regions_of_operation: {
+            anyOf: [
+                {},
+                {
+                    type: 'null'
+                }
+            ],
+            title: 'Regions Of Operation'
+        }
+    },
+    additionalProperties: true,
+    type: 'object',
+    title: 'ProjectMetadata',
+    description: 'Validates and normalises the ``project_metadata`` JSONB column on ``Project``.\n\nThe single write path (``_build_project_metadata`` in the OpenGrants crawler)\nguarantees consistent key names and types.  ``extra = "allow"`` ensures that\nany future keys added by the crawler pass through without breaking the API.\nFuture keys must still be added in this model for clarity.'
+};
+export const ProjectDetailResponseSchema = {
+    properties: {
+        canonical_id: {
+            type: 'string',
+            title: 'Canonical Id'
+        },
+        display_name: {
+            type: 'string',
+            title: 'Display Name'
+        },
+        project_type: {
+            $ref: '#/components/schemas/ProjectType'
+        },
+        activity_status: {
+            $ref: '#/components/schemas/ActivityStatus'
+        },
+        category: {
+            anyOf: [
+                {
+                    type: 'string'
+                },
+                {
+                    type: 'null'
+                }
+            ],
+            title: 'Category'
+        },
+        git_owner_url: {
+            anyOf: [
+                {
+                    type: 'string'
+                },
+                {
+                    type: 'null'
+                }
+            ],
+            title: 'Git Owner Url'
+        },
+        pony_factor: {
+            anyOf: [
+                {
+                    type: 'integer'
+                },
+                {
+                    type: 'null'
+                }
+            ],
+            title: 'Pony Factor'
+        },
+        criticality_score: {
+            anyOf: [
+                {
+                    type: 'integer'
+                },
+                {
+                    type: 'null'
+                }
+            ],
+            title: 'Criticality Score'
+        },
+        adoption_score: {
+            anyOf: [
+                {
+                    type: 'number'
+                },
+                {
+                    type: 'null'
+                }
+            ],
+            title: 'Adoption Score'
+        },
+        updated_at: {
+            type: 'string',
+            format: 'date-time',
+            title: 'Updated At'
+        },
+        project_id: {
+            type: 'integer',
+            title: 'Project Id'
+        },
+        metadata: {
+            $ref: '#/components/schemas/ProjectMetadata'
+        }
+    },
+    type: 'object',
+    required: [
+        'canonical_id',
+        'display_name',
+        'project_type',
+        'activity_status',
+        'category',
+        'git_owner_url',
+        'pony_factor',
+        'criticality_score',
+        'adoption_score',
+        'updated_at',
+        'project_id',
+        'metadata'
+    ],
+    title: 'ProjectDetailResponse',
+    description: 'Full project detail including validated metadata.\n\n``metadata`` is the normalised form of the ``project_metadata`` JSONB column.'
+};
+export const ProjectDependencySchema = {
+    properties: {
+        project: {
+            $ref: '#/components/schemas/ProjectSummary'
+        },
+        edge_count: {
+            type: 'integer',
+            title: 'Edge Count'
+        }
+    },
+    type: 'object',
+    required: [
+        'project',
+        'edge_count'
+    ],
+    title: 'ProjectDependency',
+    description: 'A collapsed project-level dependency: aggregates repo-level edges\nbetween two projects into a single summary.'
+};
+export const PaginatedResponse_RepoSummary_Schema = {
+    properties: {
+        items: {
+            items: {
+                $ref: '#/components/schemas/RepoSummary'
+            },
+            type: 'array',
+            title: 'Items'
+        },
+        total: {
+            type: 'integer',
+            title: 'Total'
+        },
+        limit: {
+            type: 'integer',
+            title: 'Limit'
+        },
+        offset: {
+            type: 'integer',
+            title: 'Offset'
+        }
+    },
+    type: 'object',
+    required: [
+        'items',
+        'total',
+        'limit',
+        'offset'
+    ],
+    title: 'PaginatedResponse[RepoSummary]'
+};
+export const PaginatedResponse_ProjectSummary_Schema = {
+    properties: {
+        items: {
+            items: {
+                $ref: '#/components/schemas/ProjectSummary'
+            },
+            type: 'array',
+            title: 'Items'
+        },
+        total: {
+            type: 'integer',
+            title: 'Total'
+        },
+        limit: {
+            type: 'integer',
+            title: 'Limit'
+        },
+        offset: {
+            type: 'integer',
+            title: 'Offset'
+        }
+    },
+    type: 'object',
+    required: [
+        'items',
+        'total',
+        'limit',
+        'offset'
+    ],
+    title: 'PaginatedResponse[ProjectSummary]'
+};
+export const MetadataResponseSchema = {
+    properties: {
+        total_projects: {
+            type: 'integer',
+            title: 'Total Projects'
+        },
+        active_projects: {
+            type: 'integer',
+            title: 'Active Projects'
+        },
+        total_repos: {
+            type: 'integer',
+            title: 'Total Repos'
+        },
+        total_external_repos: {
+            type: 'integer',
+            title: 'Total External Repos'
+        },
+        total_dependency_edges: {
+            type: 'integer',
+            title: 'Total Dependency Edges'
+        },
+        total_contributor_edges: {
+            type: 'integer',
+            title: 'Total Contributor Edges'
+        },
+        last_updated: {
+            anyOf: [
+                {
+                    type: 'string',
+                    format: 'date-time'
+                },
+                {
+                    type: 'null'
+                }
+            ],
+            title: 'Last Updated'
+        }
+    },
+    type: 'object',
+    required: [
+        'total_projects',
+        'active_projects',
+        'total_repos',
+        'total_external_repos',
+        'total_dependency_edges',
+        'total_contributor_edges',
+        'last_updated'
+    ],
+    title: 'MetadataResponse',
+    description: 'Ecosystem-wide summary statistics returned by ``GET /metadata``.'
+};
+export const HealthResponseSchema = {
+    properties: {
+        status: {
+            type: 'string',
+            title: 'Status'
+        },
+        version: {
+            type: 'string',
+            title: 'Version'
+        }
+    },
+    type: 'object',
+    required: [
+        'status',
+        'version'
+    ],
+    title: 'HealthResponse',
+    description: 'Response body for GET /health.'
+};
+export const HTTPValidationErrorSchema = {
+    properties: {
+        detail: {
+            items: {
+                $ref: '#/components/schemas/ValidationError'
+            },
+            type: 'array',
+            title: 'Detail'
+        }
+    },
+    type: 'object',
+    title: 'HTTPValidationError'
+};
+export const ContributorDetailResponseSchema = {
+    properties: {
+        id: {
+            type: 'integer',
+            title: 'Id'
+        },
+        name: {
+            type: 'string',
+            title: 'Name'
+        },
+        email_hash: {
+            type: 'string',
+            title: 'Email Hash'
+        },
+        total_repos: {
+            type: 'integer',
+            title: 'Total Repos'
+        },
+        total_commits: {
+            type: 'integer',
+            title: 'Total Commits'
+        },
+        first_contribution: {
+            anyOf: [
+                {
+                    type: 'string',
+                    format: 'date-time'
+                },
+                {
+                    type: 'null'
+                }
+            ],
+            title: 'First Contribution'
+        },
+        last_contribution: {
+            anyOf: [
+                {
+                    type: 'string',
+                    format: 'date-time'
+                },
+                {
+                    type: 'null'
+                }
+            ],
+            title: 'Last Contribution'
+        },
+        repos: {
+            items: {
+                $ref: '#/components/schemas/ContributionEntry'
+            },
+            type: 'array',
+            title: 'Repos'
+        }
+    },
+    type: 'object',
+    required: [
+        'id',
+        'name',
+        'email_hash',
+        'total_repos',
+        'total_commits',
+        'first_contribution',
+        'last_contribution',
+        'repos'
+    ],
+    title: 'ContributorDetailResponse',
+    description: 'Full contributor detail with aggregated statistics and per-repo activity.'
+};
+export const ContributionEntrySchema = {
+    properties: {
+        repo_canonical_id: {
+            type: 'string',
+            title: 'Repo Canonical Id'
+        },
+        repo_display_name: {
+            type: 'string',
+            title: 'Repo Display Name'
+        },
+        project_canonical_id: {
+            anyOf: [
+                {
+                    type: 'string'
+                },
+                {
+                    type: 'null'
+                }
+            ],
+            title: 'Project Canonical Id'
+        },
+        number_of_commits: {
+            type: 'integer',
+            title: 'Number Of Commits'
+        },
+        first_commit_date: {
+            type: 'string',
+            format: 'date-time',
+            title: 'First Commit Date'
+        },
+        last_commit_date: {
+            type: 'string',
+            format: 'date-time',
+            title: 'Last Commit Date'
+        }
+    },
+    type: 'object',
+    required: [
+        'repo_canonical_id',
+        'repo_display_name',
+        'project_canonical_id',
+        'number_of_commits',
+        'first_commit_date',
+        'last_commit_date'
+    ],
+    title: 'ContributionEntry',
+    description: 'A single repo that a contributor has committed to.'
+};