@pg-atlas/data-sdk 0.4.1 → 0.6.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -56,7 +56,7 @@ export const SubmissionStatusSchema = {
56
56
  'failed'
57
57
  ],
58
58
  title: 'SubmissionStatus',
59
- description: 'Processing state of an SbomSubmission record.'
59
+ description: 'Processing state of an artifact-linked audit record.'
60
60
  };
61
61
  export const ScfSubmissionSchema = {
62
62
  properties: {
@@ -537,8 +537,25 @@ export const RepoDetailResponseSchema = {
537
537
  anyOf: [
538
538
  {
539
539
  items: {
540
- additionalProperties: true,
541
- type: 'object'
540
+ properties: {
541
+ purl: {
542
+ type: 'string'
543
+ },
544
+ version: {
545
+ type: 'string'
546
+ },
547
+ release_date: {
548
+ type: 'string',
549
+ default: ''
550
+ }
551
+ },
552
+ type: 'object',
553
+ required: [
554
+ 'purl',
555
+ 'version'
556
+ ],
557
+ title: 'Release',
558
+ description: 'One normalized release record keyed by package PURL + version.'
542
559
  },
543
560
  type: 'array'
544
561
  },
@@ -570,6 +587,14 @@ export const RepoDetailResponseSchema = {
570
587
  },
571
588
  incoming_dep_counts: {
572
589
  $ref: '#/components/schemas/DepCounts'
590
+ },
591
+ active_contributors_30d: {
592
+ type: 'integer',
593
+ title: 'Active Contributors 30D'
594
+ },
595
+ active_contributors_90d: {
596
+ type: 'integer',
597
+ title: 'Active Contributors 90D'
573
598
  }
574
599
  },
575
600
  type: 'object',
@@ -591,10 +616,12 @@ export const RepoDetailResponseSchema = {
591
616
  'parent_project',
592
617
  'contributors',
593
618
  'outgoing_dep_counts',
594
- 'incoming_dep_counts'
619
+ 'incoming_dep_counts',
620
+ 'active_contributors_30d',
621
+ 'active_contributors_90d'
595
622
  ],
596
623
  title: 'RepoDetailResponse',
597
- description: 'Full repo detail with parent project, contributors, releases, and\ndependency counts.'
624
+ description: 'Full repo detail with parent project, contributors, releases, dependency counts,\nand active contributor stats.'
598
625
  };
599
626
  export const DepCountsSchema = {
600
627
  properties: {
@@ -800,6 +827,47 @@ export const EdgeConfidenceSchema = {
800
827
  title: 'EdgeConfidence',
801
828
  description: 'How firmly an edge was established.'
802
829
  };
830
+ export const RepoContributorSummarySchema = {
831
+ properties: {
832
+ id: {
833
+ type: 'integer',
834
+ title: 'Id'
835
+ },
836
+ name: {
837
+ type: 'string',
838
+ title: 'Name'
839
+ },
840
+ email_hash: {
841
+ type: 'string',
842
+ title: 'Email Hash'
843
+ },
844
+ number_of_commits: {
845
+ type: 'integer',
846
+ title: 'Number Of Commits'
847
+ },
848
+ first_commit_date: {
849
+ type: 'string',
850
+ format: 'date-time',
851
+ title: 'First Commit Date'
852
+ },
853
+ last_commit_date: {
854
+ type: 'string',
855
+ format: 'date-time',
856
+ title: 'Last Commit Date'
857
+ }
858
+ },
859
+ type: 'object',
860
+ required: [
861
+ 'id',
862
+ 'name',
863
+ 'email_hash',
864
+ 'number_of_commits',
865
+ 'first_commit_date',
866
+ 'last_commit_date'
867
+ ],
868
+ title: 'RepoContributorSummary',
869
+ description: 'Contributor summary with commit counts for one repo.'
870
+ };
803
871
  export const ProjectMetadataSchema = {
804
872
  properties: {
805
873
  scf_submissions: {
@@ -1034,6 +1102,14 @@ export const ProjectDetailResponseSchema = {
1034
1102
  type: 'integer',
1035
1103
  title: 'Project Id'
1036
1104
  },
1105
+ active_contributors_30d: {
1106
+ type: 'integer',
1107
+ title: 'Active Contributors 30D'
1108
+ },
1109
+ active_contributors_90d: {
1110
+ type: 'integer',
1111
+ title: 'Active Contributors 90D'
1112
+ },
1037
1113
  metadata: {
1038
1114
  $ref: '#/components/schemas/ProjectMetadata'
1039
1115
  }
@@ -1051,10 +1127,12 @@ export const ProjectDetailResponseSchema = {
1051
1127
  'adoption_score',
1052
1128
  'updated_at',
1053
1129
  'project_id',
1130
+ 'active_contributors_30d',
1131
+ 'active_contributors_90d',
1054
1132
  'metadata'
1055
1133
  ],
1056
1134
  title: 'ProjectDetailResponse',
1057
- description: 'Full project detail including validated metadata.\n\n``metadata`` is the normalised form of the ``project_metadata`` JSONB column.'
1135
+ description: 'Full project detail including contributor stats and metadata.\n\n``metadata`` is the normalised form of the ``project_metadata`` JSONB column.'
1058
1136
  };
1059
1137
  export const ProjectDependencySchema = {
1060
1138
  properties: {
@@ -1074,6 +1152,35 @@ export const ProjectDependencySchema = {
1074
1152
  title: 'ProjectDependency',
1075
1153
  description: 'A collapsed project-level dependency: aggregates repo-level edges\nbetween two projects into a single summary.'
1076
1154
  };
1155
+ export const ProjectContributorSummarySchema = {
1156
+ properties: {
1157
+ id: {
1158
+ type: 'integer',
1159
+ title: 'Id'
1160
+ },
1161
+ name: {
1162
+ type: 'string',
1163
+ title: 'Name'
1164
+ },
1165
+ email_hash: {
1166
+ type: 'string',
1167
+ title: 'Email Hash'
1168
+ },
1169
+ total_commits_in_project: {
1170
+ type: 'integer',
1171
+ title: 'Total Commits In Project'
1172
+ }
1173
+ },
1174
+ type: 'object',
1175
+ required: [
1176
+ 'id',
1177
+ 'name',
1178
+ 'email_hash',
1179
+ 'total_commits_in_project'
1180
+ ],
1181
+ title: 'ProjectContributorSummary',
1182
+ description: 'Contributor summary aggregated across all repos in a project.'
1183
+ };
1077
1184
  export const PaginatedResponse_RepoSummary_Schema = {
1078
1185
  properties: {
1079
1186
  items: {
@@ -1105,6 +1212,37 @@ export const PaginatedResponse_RepoSummary_Schema = {
1105
1212
  ],
1106
1213
  title: 'PaginatedResponse[RepoSummary]'
1107
1214
  };
1215
+ export const PaginatedResponse_RepoContributorSummary_Schema = {
1216
+ properties: {
1217
+ items: {
1218
+ items: {
1219
+ $ref: '#/components/schemas/RepoContributorSummary'
1220
+ },
1221
+ type: 'array',
1222
+ title: 'Items'
1223
+ },
1224
+ total: {
1225
+ type: 'integer',
1226
+ title: 'Total'
1227
+ },
1228
+ limit: {
1229
+ type: 'integer',
1230
+ title: 'Limit'
1231
+ },
1232
+ offset: {
1233
+ type: 'integer',
1234
+ title: 'Offset'
1235
+ }
1236
+ },
1237
+ type: 'object',
1238
+ required: [
1239
+ 'items',
1240
+ 'total',
1241
+ 'limit',
1242
+ 'offset'
1243
+ ],
1244
+ title: 'PaginatedResponse[RepoContributorSummary]'
1245
+ };
1108
1246
  export const PaginatedResponse_ProjectSummary_Schema = {
1109
1247
  properties: {
1110
1248
  items: {
@@ -1136,6 +1274,180 @@ export const PaginatedResponse_ProjectSummary_Schema = {
1136
1274
  ],
1137
1275
  title: 'PaginatedResponse[ProjectSummary]'
1138
1276
  };
1277
+ export const PaginatedResponse_ProjectContributorSummary_Schema = {
1278
+ properties: {
1279
+ items: {
1280
+ items: {
1281
+ $ref: '#/components/schemas/ProjectContributorSummary'
1282
+ },
1283
+ type: 'array',
1284
+ title: 'Items'
1285
+ },
1286
+ total: {
1287
+ type: 'integer',
1288
+ title: 'Total'
1289
+ },
1290
+ limit: {
1291
+ type: 'integer',
1292
+ title: 'Limit'
1293
+ },
1294
+ offset: {
1295
+ type: 'integer',
1296
+ title: 'Offset'
1297
+ }
1298
+ },
1299
+ type: 'object',
1300
+ required: [
1301
+ 'items',
1302
+ 'total',
1303
+ 'limit',
1304
+ 'offset'
1305
+ ],
1306
+ title: 'PaginatedResponse[ProjectContributorSummary]'
1307
+ };
1308
+ export const PaginatedResponse_GitLogArtifactSummary_Schema = {
1309
+ properties: {
1310
+ items: {
1311
+ items: {
1312
+ $ref: '#/components/schemas/GitLogArtifactSummary'
1313
+ },
1314
+ type: 'array',
1315
+ title: 'Items'
1316
+ },
1317
+ total: {
1318
+ type: 'integer',
1319
+ title: 'Total'
1320
+ },
1321
+ limit: {
1322
+ type: 'integer',
1323
+ title: 'Limit'
1324
+ },
1325
+ offset: {
1326
+ type: 'integer',
1327
+ title: 'Offset'
1328
+ }
1329
+ },
1330
+ type: 'object',
1331
+ required: [
1332
+ 'items',
1333
+ 'total',
1334
+ 'limit',
1335
+ 'offset'
1336
+ ],
1337
+ title: 'PaginatedResponse[GitLogArtifactSummary]'
1338
+ };
1339
+ export const GitLogArtifactSummarySchema = {
1340
+ properties: {
1341
+ id: {
1342
+ type: 'integer',
1343
+ title: 'Id'
1344
+ },
1345
+ repo_id: {
1346
+ type: 'integer',
1347
+ title: 'Repo Id'
1348
+ },
1349
+ repo_canonical_id: {
1350
+ type: 'string',
1351
+ title: 'Repo Canonical Id'
1352
+ },
1353
+ repo_display_name: {
1354
+ type: 'string',
1355
+ title: 'Repo Display Name'
1356
+ },
1357
+ artifact_path: {
1358
+ anyOf: [
1359
+ {
1360
+ type: 'string'
1361
+ },
1362
+ {
1363
+ type: 'null'
1364
+ }
1365
+ ],
1366
+ title: 'Artifact Path'
1367
+ },
1368
+ status: {
1369
+ $ref: '#/components/schemas/SubmissionStatus'
1370
+ },
1371
+ error_detail: {
1372
+ anyOf: [
1373
+ {
1374
+ type: 'string'
1375
+ },
1376
+ {
1377
+ type: 'null'
1378
+ }
1379
+ ],
1380
+ title: 'Error Detail'
1381
+ },
1382
+ since_months: {
1383
+ type: 'integer',
1384
+ title: 'Since Months'
1385
+ },
1386
+ submitted_at: {
1387
+ type: 'string',
1388
+ format: 'date-time',
1389
+ title: 'Submitted At'
1390
+ },
1391
+ processed_at: {
1392
+ anyOf: [
1393
+ {
1394
+ type: 'string',
1395
+ format: 'date-time'
1396
+ },
1397
+ {
1398
+ type: 'null'
1399
+ }
1400
+ ],
1401
+ title: 'Processed At'
1402
+ }
1403
+ },
1404
+ type: 'object',
1405
+ required: [
1406
+ 'id',
1407
+ 'repo_id',
1408
+ 'repo_canonical_id',
1409
+ 'repo_display_name',
1410
+ 'artifact_path',
1411
+ 'status',
1412
+ 'error_detail',
1413
+ 'since_months',
1414
+ 'submitted_at',
1415
+ 'processed_at'
1416
+ ],
1417
+ title: 'GitLogArtifactSummary',
1418
+ description: 'Compact gitlog artifact audit record for list endpoints.'
1419
+ };
1420
+ export const PaginatedResponse_ContributorSummary_Schema = {
1421
+ properties: {
1422
+ items: {
1423
+ items: {
1424
+ $ref: '#/components/schemas/ContributorSummary'
1425
+ },
1426
+ type: 'array',
1427
+ title: 'Items'
1428
+ },
1429
+ total: {
1430
+ type: 'integer',
1431
+ title: 'Total'
1432
+ },
1433
+ limit: {
1434
+ type: 'integer',
1435
+ title: 'Limit'
1436
+ },
1437
+ offset: {
1438
+ type: 'integer',
1439
+ title: 'Offset'
1440
+ }
1441
+ },
1442
+ type: 'object',
1443
+ required: [
1444
+ 'items',
1445
+ 'total',
1446
+ 'limit',
1447
+ 'offset'
1448
+ ],
1449
+ title: 'PaginatedResponse[ContributorSummary]'
1450
+ };
1139
1451
  export const MetadataResponseSchema = {
1140
1452
  properties: {
1141
1453
  total_projects: {
@@ -1150,6 +1462,10 @@ export const MetadataResponseSchema = {
1150
1462
  type: 'integer',
1151
1463
  title: 'Total Repos'
1152
1464
  },
1465
+ active_repos_90d: {
1466
+ type: 'integer',
1467
+ title: 'Active Repos 90D'
1468
+ },
1153
1469
  total_external_repos: {
1154
1470
  type: 'integer',
1155
1471
  title: 'Total External Repos'
@@ -1162,6 +1478,14 @@ export const MetadataResponseSchema = {
1162
1478
  type: 'integer',
1163
1479
  title: 'Total Contributor Edges'
1164
1480
  },
1481
+ active_contributors_30d: {
1482
+ type: 'integer',
1483
+ title: 'Active Contributors 30D'
1484
+ },
1485
+ active_contributors_90d: {
1486
+ type: 'integer',
1487
+ title: 'Active Contributors 90D'
1488
+ },
1165
1489
  last_updated: {
1166
1490
  anyOf: [
1167
1491
  {
@@ -1180,9 +1504,12 @@ export const MetadataResponseSchema = {
1180
1504
  'total_projects',
1181
1505
  'active_projects',
1182
1506
  'total_repos',
1507
+ 'active_repos_90d',
1183
1508
  'total_external_repos',
1184
1509
  'total_dependency_edges',
1185
1510
  'total_contributor_edges',
1511
+ 'active_contributors_30d',
1512
+ 'active_contributors_90d',
1186
1513
  'last_updated'
1187
1514
  ],
1188
1515
  title: 'MetadataResponse',
@@ -1192,21 +1519,68 @@ export const HealthResponseSchema = {
1192
1519
  properties: {
1193
1520
  status: {
1194
1521
  type: 'string',
1522
+ enum: [
1523
+ 'live',
1524
+ 'ready'
1525
+ ],
1195
1526
  title: 'Status'
1196
1527
  },
1197
1528
  version: {
1198
1529
  type: 'string',
1199
1530
  title: 'Version'
1531
+ },
1532
+ components: {
1533
+ $ref: '#/components/schemas/HealthComponents'
1200
1534
  }
1201
1535
  },
1202
1536
  type: 'object',
1203
1537
  required: [
1204
1538
  'status',
1205
- 'version'
1539
+ 'version',
1540
+ 'components'
1206
1541
  ],
1207
1542
  title: 'HealthResponse',
1208
1543
  description: 'Response body for GET /health.'
1209
1544
  };
1545
+ export const HealthComponentsSchema = {
1546
+ properties: {
1547
+ artifact_store: {
1548
+ type: 'string',
1549
+ enum: [
1550
+ 'local',
1551
+ 'IPFS'
1552
+ ],
1553
+ title: 'Artifact Store'
1554
+ },
1555
+ database: {
1556
+ type: 'string',
1557
+ enum: [
1558
+ 'ready',
1559
+ 'not-configured'
1560
+ ],
1561
+ title: 'Database'
1562
+ },
1563
+ schema_version: {
1564
+ anyOf: [
1565
+ {
1566
+ type: 'string'
1567
+ },
1568
+ {
1569
+ type: 'null'
1570
+ }
1571
+ ],
1572
+ title: 'Schema Version'
1573
+ }
1574
+ },
1575
+ type: 'object',
1576
+ required: [
1577
+ 'artifact_store',
1578
+ 'database',
1579
+ 'schema_version'
1580
+ ],
1581
+ title: 'HealthComponents',
1582
+ description: 'Component-level readiness details for GET /health.'
1583
+ };
1210
1584
  export const HTTPValidationErrorSchema = {
1211
1585
  properties: {
1212
1586
  detail: {
@@ -1220,6 +1594,98 @@ export const HTTPValidationErrorSchema = {
1220
1594
  type: 'object',
1221
1595
  title: 'HTTPValidationError'
1222
1596
  };
1597
+ export const GitLogArtifactDetailResponseSchema = {
1598
+ properties: {
1599
+ id: {
1600
+ type: 'integer',
1601
+ title: 'Id'
1602
+ },
1603
+ repo_id: {
1604
+ type: 'integer',
1605
+ title: 'Repo Id'
1606
+ },
1607
+ repo_canonical_id: {
1608
+ type: 'string',
1609
+ title: 'Repo Canonical Id'
1610
+ },
1611
+ repo_display_name: {
1612
+ type: 'string',
1613
+ title: 'Repo Display Name'
1614
+ },
1615
+ artifact_path: {
1616
+ anyOf: [
1617
+ {
1618
+ type: 'string'
1619
+ },
1620
+ {
1621
+ type: 'null'
1622
+ }
1623
+ ],
1624
+ title: 'Artifact Path'
1625
+ },
1626
+ status: {
1627
+ $ref: '#/components/schemas/SubmissionStatus'
1628
+ },
1629
+ error_detail: {
1630
+ anyOf: [
1631
+ {
1632
+ type: 'string'
1633
+ },
1634
+ {
1635
+ type: 'null'
1636
+ }
1637
+ ],
1638
+ title: 'Error Detail'
1639
+ },
1640
+ since_months: {
1641
+ type: 'integer',
1642
+ title: 'Since Months'
1643
+ },
1644
+ submitted_at: {
1645
+ type: 'string',
1646
+ format: 'date-time',
1647
+ title: 'Submitted At'
1648
+ },
1649
+ processed_at: {
1650
+ anyOf: [
1651
+ {
1652
+ type: 'string',
1653
+ format: 'date-time'
1654
+ },
1655
+ {
1656
+ type: 'null'
1657
+ }
1658
+ ],
1659
+ title: 'Processed At'
1660
+ },
1661
+ raw_artifact: {
1662
+ anyOf: [
1663
+ {
1664
+ type: 'string'
1665
+ },
1666
+ {
1667
+ type: 'null'
1668
+ }
1669
+ ],
1670
+ title: 'Raw Artifact'
1671
+ }
1672
+ },
1673
+ type: 'object',
1674
+ required: [
1675
+ 'id',
1676
+ 'repo_id',
1677
+ 'repo_canonical_id',
1678
+ 'repo_display_name',
1679
+ 'artifact_path',
1680
+ 'status',
1681
+ 'error_detail',
1682
+ 'since_months',
1683
+ 'submitted_at',
1684
+ 'processed_at'
1685
+ ],
1686
+ title: 'GitLogArtifactDetailResponse',
1687
+ description: 'Full gitlog artifact audit record including raw artifact content.'
1688
+ };
1223
1689
  export const ContributorDetailResponseSchema = {
1224
1690
  properties: {
1225
1691
  id: {