@remogram/provider-gitea-api 0.1.0-beta.1 → 0.1.0-beta.3

package/index.js

@@ -7,22 +7,36 @@ import {
   gitRevParse,
   gitCurrentBranch,
   gitAheadBehind,
+  refsInventory,
+  crInventory,
+  mergeBlockersFromFacts,
   ERROR_CODES,
   forgeError,
   forgeIngestCapabilityFacts,
+  checkPaginationCapabilityFacts,
+  DEFAULT_CHECK_STATUS_PAGE_SIZE,
+  MAX_CHECK_STATUS_PAGES,
+  paginateCheckStatusPages,
+  paginateOffsetListPages,
+  fetchWithIngestPageBackoff,
+  fetchPageWithIngestBackoff,
+  withPerPageParam,
+  apiProviderCommands,
 } from '@remogram/core';
 const PUBLIC_GITEA_HOST = 'gitea.com';
 const PUBLIC_GITEA_API = 'https://gitea.com/api/v1';
 const AUTH_CAPABILITIES = [
   'repo_status',
   'ref_compare',
+  'ref_inventory',
+  'cr_inventory',
   'pr_status',
   'pr_checks',
   'merge_plan',
   'sync_plan',
 ];
 
-const STRUCTURED_COMMANDS = AUTH_CAPABILITIES.map((name) => ({ name, implemented: true }));
+const STRUCTURED_COMMANDS = apiProviderCommands();
 
 export function giteaToken() {
   return process.env.GITEA_TOKEN || null;
@@ -118,23 +132,21 @@ export async function giteaFetch(config, parsed, path, options = {}) {
   });
 }
 
-const MAX_CHECK_PAGES = 50;
+const MAX_CHECK_PAGES = MAX_CHECK_STATUS_PAGES;
 const GITEA_PAGE_SIZE = 100;
 
 export async function giteaFetchPaginated(config, parsed, path) {
-  const all = [];
-  for (let page = 1; page <= MAX_CHECK_PAGES; page += 1) {
-    const separator = path.includes('?') ? '&' : '?';
-    const body = await giteaFetch(
-      config,
-      parsed,
-      `${path}${separator}limit=${GITEA_PAGE_SIZE}&page=${page}`,
-    );
-    const items = Array.isArray(body) ? body : [];
-    all.push(...items);
-    if (items.length < GITEA_PAGE_SIZE) break;
-  }
-  return all;
+  return paginateCheckStatusPages({
+    fetchPage: async ({ page, limit }) => {
+      const separator = path.includes('?') ? '&' : '?';
+      const body = await giteaFetch(
+        config,
+        parsed,
+        `${path}${separator}limit=${limit}&page=${page}`,
+      );
+      return Array.isArray(body) ? body : [];
+    },
+  });
 }
 
 export function normalizeGiteaStatusState(state) {
@@ -149,6 +161,36 @@ export function normalizeGiteaStatusState(state) {
   return 'unknown';
 }
 
+function giteaStatusRecordOrder(a, b) {
+  const aUpdated = Date.parse(a.updated_at ?? '') || 0;
+  const bUpdated = Date.parse(b.updated_at ?? '') || 0;
+  if (aUpdated !== bUpdated) return aUpdated - bUpdated;
+  const aId = Number(a.id) || 0;
+  const bId = Number(b.id) || 0;
+  return aId - bId;
+}
+
+export function dedupeGiteaStatusRecords(records) {
+  const latestByContext = new Map();
+  for (const record of records) {
+    const context = record?.context;
+    if (context == null || context === '') continue;
+    const existing = latestByContext.get(context);
+    if (!existing || giteaStatusRecordOrder(record, existing) > 0) {
+      latestByContext.set(context, record);
+    }
+  }
+  return Array.from(latestByContext.values());
+}
+
+export function mapGiteaCommitStatuses(records) {
+  return dedupeGiteaStatusRecords(records).map((s) => ({
+    context: sanitizeField(s.context),
+    state: normalizeGiteaStatusState(s.status ?? s.state),
+    description: sanitizeField(s.description),
+  }));
+}
+
 export function normalizeGiteaPrState(state) {
   const normalized = String(state ?? '').toLowerCase();
   if (normalized === 'open') return 'open';
@@ -172,15 +214,21 @@ export async function repoStatus(ctx) {
 }
 
 export function providerCapabilities() {
+  const check_sources = ['commit_statuses'];
   return {
     commands: STRUCTURED_COMMANDS,
     auth_envs: ['GITEA_TOKEN'],
-    check_sources: ['commit_statuses'],
+    check_sources,
     mergeability_confidence: 'direct',
     host_binding: 'verified_remote_host',
     pagination: 'supported',
     write_support: false,
     ...forgeIngestCapabilityFacts(),
+    ...checkPaginationCapabilityFacts({
+      strategy: 'offset_limit',
+      pageSizeParam: 'limit',
+      sourceCount: check_sources.length,
+    }),
   };
 }
 
@@ -213,6 +261,48 @@ export async function getPull(ctx, { number }) {
   return giteaFetch(ctx.config, ctx.parsed, repoApiPath(ctx.config, 'pulls', number));
 }
 
+export async function listOpenPullsWithMeta(ctx, opts = {}) {
+  requireToken();
+  const listLimit =
+    opts.limit != null && Number.isInteger(Number(opts.limit)) && Number(opts.limit) > 0
+      ? Number(opts.limit)
+      : null;
+  const pageSize =
+    listLimit != null ? Math.min(listLimit, GITEA_PAGE_SIZE) : GITEA_PAGE_SIZE;
+  const path = `${repoApiPath(ctx.config, 'pulls')}?state=open`;
+  const pageSep = path.includes('?') ? '&' : '?';
+  const { items: all, list_truncated: listTruncated } = await paginateOffsetListPages({
+    pageSize,
+    listLimit,
+    ...(listLimit != null && pageSize < listLimit ? { maxPagesTruncatesWithLimit: true } : {}),
+    fetchPage: async ({ page, limit }) => {
+      const body = await giteaFetch(
+        ctx.config,
+        ctx.parsed,
+        `${path}${pageSep}limit=${limit}&page=${page}`,
+      );
+      return Array.isArray(body) ? body : [];
+    },
+  });
+  let numbers = all
+    .map((pr) => pr.number)
+    .filter((number) => Number.isInteger(number))
+    .sort((a, b) => a - b);
+  if (listLimit != null && numbers.length > listLimit) {
+    numbers = numbers.slice(0, listLimit);
+  }
+  return { numbers, list_truncated: listTruncated };
+}
+
+export async function listOpenPulls(ctx, opts = {}) {
+  const meta = await listOpenPullsWithMeta(ctx, opts);
+  return meta.numbers;
+}
+
+export async function crInventorySlice(ctx, opts = {}) {
+  return crInventory(ctx, { listOpenPulls, listOpenPullsWithMeta, prView, prChecks }, opts);
+}
+
 function mergeability(pr) {
   if (pr.mergeable === true) return 'clean';
   if (pr.mergeable === false) return 'conflicted';
@@ -254,18 +344,19 @@ export async function prChecks(ctx, opts) {
       forgeError: forgeError(ERROR_CODES.MISSING_REF, 'Could not determine head SHA for checks'),
     });
   }
-  const statusRecords = await giteaFetchPaginated(
+  const { items: statusRecords, truncated: checks_truncated } = await giteaFetchPaginated(
     ctx.config,
     ctx.parsed,
     repoApiPath(ctx.config, 'commits', sha, 'statuses'),
   );
-  const mapped = statusRecords.map((s) => ({
-    context: sanitizeField(s.context),
-    state: normalizeGiteaStatusState(s.state),
-    description: sanitizeField(s.description),
-  }));
+  const mapped = mapGiteaCommitStatuses(statusRecords);
   const conclusion = summarizeChecks(mapped);
-  return { head_sha: sha, check_conclusion: conclusion, statuses: mapped };
+  return {
+    head_sha: sha,
+    check_conclusion: conclusion,
+    checks_truncated,
+    statuses: mapped,
+  };
 }
 
 export function summarizeChecks(statuses) {
@@ -279,12 +370,7 @@ export function summarizeChecks(statuses) {
 export async function mergePlan(ctx, opts) {
   const view = await prView(ctx, opts);
   const checks = await prChecks(ctx, { number: view.pr_number });
-  const blockers = [];
-  if (view.mergeability === 'conflicted') blockers.push('merge_conflict');
-  if (view.state !== 'open') blockers.push('pr_not_open');
-  if (checks.check_conclusion === 'failure') blockers.push('checks_failed');
-  if (checks.check_conclusion === 'missing') blockers.push('checks_missing');
-  if (checks.check_conclusion === 'pending') blockers.push('checks_pending');
+  const blockers = mergeBlockersFromFacts(view, checks);
   return {
     pr_number: view.pr_number,
     mergeability: view.mergeability,
@@ -325,6 +411,9 @@ export const provider = {
   providerCapabilities,
   repoStatus,
   refsCompare,
+  refsInventory,
+  listOpenPulls,
+  crInventory: crInventorySlice,
   prView,
   prChecks,
   mergePlan,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@remogram/provider-gitea-api",
-  "version": "0.1.0-beta.1",
+  "version": "0.1.0-beta.3",
   "description": "Gitea REST API forge provider for remogram",
   "type": "module",
   "license": "MIT",
@@ -22,6 +22,6 @@
     "node": ">=20"
   },
   "dependencies": {
-    "@remogram/core": "0.1.0-beta.1"
+    "@remogram/core": "0.1.0-beta.3"
   }
 }