@porulle/plugin-channel-connector 0.28.0 → 0.29.0

package/dist/index.d.ts

@@ -4,6 +4,8 @@ export type { MockChannelConnectorOptions } from "./mock-connector.js";
 export { ChannelConnectorService, CATALOG_OUTBOUND_SUPPRESSION_WINDOW_MS, CATALOG_PUSH_BATCH_SIZES, CATALOG_PUSH_MAX_ATTEMPTS, canCatalogPushTransition, canExportTransition, catalogPushConcurrencyKey, catalogPushRetryDelayMs, isCatalogPushBreakerOpen, } from "./service.js";
 export { isValidCatalogMappingFieldPath, matchFieldPath, mergeCatalogFieldMapping, normalizeCatalogFieldMapping, compareCatalogFieldMappingSpecificity, providerCatalogFieldMappingDefaults, selectCatalogFieldMapping, validateCatalogMappingRow, } from "./catalog-field-mapping.js";
 export type { CatalogFieldMapping, CatalogFieldMappingInput, CatalogFieldMappingRow, CatalogFieldTarget, } from "./catalog-field-mapping.js";
+/** ~320 Neon HTTP subrequests per product against a 10,000 per-invocation cap → hard ceiling near 31; 20 leaves margin for heavier products. */
+export declare const CHANNEL_IMPORT_MAX_ITEMS_PER_INVOCATION = 20;
 export { signState, verifyState } from "./oauth-state.js";
 export type { BackfillCatalogOptions, BackfillCatalogReport, BuildCatalogPushItemsOptions, BuildCatalogPushItemsResult, CatalogPushAssemblyField, CatalogPushAssemblyImage, CatalogPushAssemblyItem, CatalogPushPreviewBefore, CatalogPushPreviewBeforeStatus, CatalogPushPreviewDiff, CatalogPushPreviewItem, CatalogPushPreviewResult, CatalogPushPreviewUnavailable, PushCatalogToStoreResult, CatalogPushJobResult, CatalogFieldConflict, CatalogFieldSkip, CatalogPushFieldSkip, CatalogPushSkipReason, CatalogConflictState, CatalogWriteSettings, ChannelComplianceData, ChannelConnectorPluginOptions, ChannelStockLine, ExportState, PublicConnectedStore, ReconcileReport, } from "./service.js";
 export type { OAuthStatePayload, OAuthStateResult } from "./oauth-state.js";

package/dist/index.js

@@ -10,6 +10,8 @@ import { oauthStateEventId, signState, verifyState } from "./oauth-state.js";
 export { mockChannelConnector } from "./mock-connector.js";
 export { ChannelConnectorService, CATALOG_OUTBOUND_SUPPRESSION_WINDOW_MS, CATALOG_PUSH_BATCH_SIZES, CATALOG_PUSH_MAX_ATTEMPTS, canCatalogPushTransition, canExportTransition, catalogPushConcurrencyKey, catalogPushRetryDelayMs, isCatalogPushBreakerOpen, } from "./service.js";
 export { isValidCatalogMappingFieldPath, matchFieldPath, mergeCatalogFieldMapping, normalizeCatalogFieldMapping, compareCatalogFieldMappingSpecificity, providerCatalogFieldMappingDefaults, selectCatalogFieldMapping, validateCatalogMappingRow, } from "./catalog-field-mapping.js";
+/** ~320 Neon HTTP subrequests per product against a 10,000 per-invocation cap → hard ceiling near 31; 20 leaves margin for heavier products. */
+export const CHANNEL_IMPORT_MAX_ITEMS_PER_INVOCATION = 20;
 export { signState, verifyState } from "./oauth-state.js";
 function unwrap(result) {
     if (result.ok)
@@ -88,13 +90,26 @@ export function channelConnectorPlugin(options = {}) {
             concurrency: { key: (input) => String(input.storeId), supersedes: true },
             handler: async ({ input, ctx }) => {
                 const service = new ChannelConnectorService(ctx.db, ctx.services, options);
-                const result = await service.importCatalog(String(input.orgId), String(input.storeId), createSystemActor(String(input.orgId)));
+                const orgId = String(input.orgId);
+                const storeId = String(input.storeId);
+                const result = await service.importCatalog(orgId, storeId, createSystemActor(orgId), {
+                    maxItems: CHANNEL_IMPORT_MAX_ITEMS_PER_INVOCATION,
+                });
                 if (!result.ok)
                     throw new Error(result.error);
+                if (!result.value.exhausted) {
+                    const jobs = ctx.services.jobs;
+                    await jobs.enqueue("channel/import-catalog", { orgId, storeId }, {
+                        organizationId: orgId,
+                        concurrencyKey: storeId,
+                        supersedes: true,
+                    });
+                }
                 return {
                     output: {
                         imported: result.value.imported,
                         cursor: result.value.cursor,
+                        exhausted: result.value.exhausted,
                         ...(result.value.warnings ? { warnings: result.value.warnings } : {}),
                     },
                 };

package/dist/service.d.ts

@@ -216,7 +216,17 @@ export declare class ChannelConnectorService {
     getStore(orgId: string, id: string): Promise<PluginResult<PublicConnectedStore>>;
     listStores(orgId: string): Promise<PluginResult<PublicConnectedStore[]>>;
     validateLineStock(orgId: string, lines: ChannelStockLine[], timeoutMs?: number): Promise<void>;
-    importCatalog(orgId: string, storeId: string, actor: Actor): Promise<PluginResult<{
+    importCatalog(orgId: string, storeId: string, actor: Actor, options: {
+        maxItems: number;
+    }): Promise<PluginResult<{
+        imported: number;
+        cursor: string | null;
+        exhausted: boolean;
+        skipped?: CatalogFieldSkip[];
+        conflicts?: CatalogFieldConflict[];
+        warnings?: string[];
+    }>>;
+    importCatalog(orgId: string, storeId: string, actor: Actor, options?: undefined): Promise<PluginResult<{
         imported: number;
         cursor: string | null;
         skipped?: CatalogFieldSkip[];

package/dist/service.js

@@ -48,6 +48,26 @@ export function isCatalogPushBreakerOpen(breakerState) {
 function catalogPushBatchSize(provider) {
     return CATALOG_PUSH_BATCH_SIZES[provider] ?? DEFAULT_CATALOG_PUSH_BATCH_SIZE;
 }
+function parseImportResumePosition(raw) {
+    if (!raw)
+        return { pageCursor: null, offset: 0 };
+    try {
+        const parsed = JSON.parse(raw);
+        if (typeof parsed === "object" && parsed !== null && "offset" in parsed) {
+            return {
+                pageCursor: parsed.pageCursor ?? null,
+                offset: typeof parsed.offset === "number" && parsed.offset >= 0 ? parsed.offset : 0,
+            };
+        }
+    }
+    catch {
+        // Legacy bare page cursor.
+    }
+    return { pageCursor: raw, offset: 0 };
+}
+function encodeImportResumePosition(position) {
+    return JSON.stringify(position);
+}
 const exportTransitions = {
     pending: ["exported", "abandoned"],
     exported: ["confirmed", "failed", "abandoned"],
@@ -1538,7 +1558,7 @@ export class ChannelConnectorService {
             }
         }));
     }
-    async importCatalog(orgId, storeId, actor) {
+    async importCatalog(orgId, storeId, actor, options) {
         const store = await this.getStoreRecord(orgId, storeId);
         if (!store || store.status !== "connected") {
             return PluginErr("Connected store not found.", "NOT_FOUND");
@@ -1546,28 +1566,97 @@ export class ChannelConnectorService {
         const connector = this.connectors.get(store.provider);
         if (!connector)
             return PluginErr(`No connector registered for provider "${store.provider}".`);
-        const items = [];
-        let cursor = store.catalogCursor ?? undefined;
-        do {
-            const page = await connector.importCatalog(store, cursor);
+        const maxItems = options?.maxItems;
+        const bounded = maxItems !== undefined;
+        if (!bounded) {
+            const resume = parseImportResumePosition(store.catalogCursor);
+            const items = [];
+            let pageCursor = resume.pageCursor ?? undefined;
+            do {
+                const page = await connector.importCatalog(store, pageCursor);
+                if (!page.ok)
+                    return PluginErr(page.error.message);
+                items.push(...page.value.items);
+                pageCursor = page.value.nextCursor ?? undefined;
+            } while (pageCursor);
+            const result = await this.convergeCatalogItems(orgId, storeId, items, actor);
+            if (!result.ok)
+                return result;
+            await this.db
+                .update(connectedStores)
+                .set({ catalogCursor: null, lastSyncAt: new Date(), updatedAt: new Date() })
+                .where(and(eq(connectedStores.organizationId, orgId), eq(connectedStores.id, storeId)));
+            return Ok({
+                imported: result.value.imported,
+                cursor: null,
+                ...(result.value.skipped.length > 0 ? { skipped: uniqueSkipped(result.value.skipped) } : {}),
+                ...(result.value.conflicts.length > 0 ? { conflicts: result.value.conflicts } : {}),
+                ...(result.value.warnings.length > 0 ? { warnings: result.value.warnings } : {}),
+            });
+        }
+        let { pageCursor, offset } = parseImportResumePosition(store.catalogCursor);
+        let remaining = maxItems;
+        let exhausted = false;
+        let totalImported = 0;
+        const skipped = [];
+        const conflicts = [];
+        const warnings = [];
+        while (remaining > 0) {
+            const page = await connector.importCatalog(store, pageCursor ?? undefined);
             if (!page.ok)
                 return PluginErr(page.error.message);
-            items.push(...page.value.items);
-            cursor = page.value.nextCursor ?? undefined;
-        } while (cursor);
-        const result = await this.convergeCatalogItems(orgId, storeId, items, actor);
-        if (!result.ok)
-            return result;
+            const pageItems = page.value.items;
+            const slice = pageItems.slice(offset);
+            const batchSize = Math.min(remaining, slice.length);
+            if (batchSize === 0) {
+                if (page.value.nextCursor) {
+                    pageCursor = page.value.nextCursor;
+                    offset = 0;
+                    continue;
+                }
+                exhausted = true;
+                break;
+            }
+            const batch = slice.slice(0, batchSize);
+            const result = await this.convergeCatalogItems(orgId, storeId, batch, actor);
+            if (!result.ok)
+                return result;
+            totalImported += result.value.imported;
+            remaining -= result.value.consumed;
+            skipped.push(...result.value.skipped);
+            conflicts.push(...result.value.conflicts);
+            warnings.push(...result.value.warnings);
+            offset += result.value.consumed;
+            if (offset >= pageItems.length) {
+                if (page.value.nextCursor) {
+                    pageCursor = page.value.nextCursor;
+                    offset = 0;
+                }
+                else {
+                    exhausted = true;
+                }
+            }
+            if (remaining === 0)
+                break;
+            if (exhausted)
+                break;
+        }
+        const catalogCursor = exhausted ? null : encodeImportResumePosition({ pageCursor, offset });
         await this.db
             .update(connectedStores)
-            .set({ catalogCursor: null, lastSyncAt: new Date(), updatedAt: new Date() })
+            .set({
+            catalogCursor,
+            ...(exhausted ? { lastSyncAt: new Date() } : {}),
+            updatedAt: new Date(),
+        })
             .where(and(eq(connectedStores.organizationId, orgId), eq(connectedStores.id, storeId)));
         return Ok({
-            imported: result.value.imported,
-            cursor: null,
-            ...(result.value.skipped.length > 0 ? { skipped: uniqueSkipped(result.value.skipped) } : {}),
-            ...(result.value.conflicts.length > 0 ? { conflicts: result.value.conflicts } : {}),
-            ...(result.value.warnings.length > 0 ? { warnings: result.value.warnings } : {}),
+            imported: totalImported,
+            cursor: catalogCursor,
+            exhausted,
+            ...(skipped.length > 0 ? { skipped: uniqueSkipped(skipped) } : {}),
+            ...(conflicts.length > 0 ? { conflicts } : {}),
+            ...(warnings.length > 0 ? { warnings } : {}),
         });
     }
     async promoteLegacyAttributes(orgId, storeId, actor, dryRun) {
@@ -1728,12 +1817,14 @@ export class ChannelConnectorService {
             attributesCreated: 0,
             mediaImported: 0,
             variantsGivenOptionValues: 0,
+            consumed: 0,
             skipped: [],
             conflicts: [],
             warnings: [],
         };
         const assets = await this.db.select().from(mediaAssets).where(eq(mediaAssets.organizationId, orgId));
         for (const item of items) {
+            stats.consumed += 1;
             const [entityMapping] = await this.db.select().from(channelEntityMap).where(and(eq(channelEntityMap.organizationId, orgId), eq(channelEntityMap.storeId, storeId), eq(channelEntityMap.kind, "entity"), eq(channelEntityMap.externalId, item.externalId)));
             if (!entityMapping) {
                 stats.imported += 1;
@@ -1857,10 +1948,12 @@ export class ChannelConnectorService {
         let attributesCreated = 0;
         let mediaImported = 0;
         let variantsGivenOptionValues = 0;
+        let consumed = 0;
         const skipped = [];
         const conflicts = [];
         const warnings = [];
         for (const item of items) {
+            consumed += 1;
             const remoteHash = hash(item);
             const existing = await this.db
                 .select()
@@ -2057,6 +2150,7 @@ export class ChannelConnectorService {
             attributesCreated,
             mediaImported,
             variantsGivenOptionValues,
+            consumed,
             skipped,
             conflicts,
             warnings,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@porulle/plugin-channel-connector",
-  "version": "0.28.0",
+  "version": "0.29.0",
   "license": "MIT",
   "type": "module",
   "exports": {
@@ -19,15 +19,15 @@
   "dependencies": {
     "@hono/zod-openapi": "^1.2.2",
     "hono": "^4.12.5",
-    "@porulle/core": "0.28.0"
+    "@porulle/core": "0.29.0"
   },
   "devDependencies": {
     "@types/node": "^24.5.2",
     "eslint": "^9.39.1",
     "typescript": "5.9.2",
     "vitest": "^3.2.4",
-    "@porulle/typescript-config": "0.1.0",
-    "@porulle/eslint-config": "0.1.0"
+    "@porulle/eslint-config": "0.1.0",
+    "@porulle/typescript-config": "0.1.0"
   },
   "publishConfig": {
     "access": "public"

package/src/index.ts

@@ -73,6 +73,9 @@ export type {
   CatalogFieldMappingRow,
   CatalogFieldTarget,
 } from "./catalog-field-mapping.js";
+/** ~320 Neon HTTP subrequests per product against a 10,000 per-invocation cap → hard ceiling near 31; 20 leaves margin for heavier products. */
+export const CHANNEL_IMPORT_MAX_ITEMS_PER_INVOCATION = 20;
+
 export { signState, verifyState } from "./oauth-state.js";
 export type {
   BackfillCatalogOptions,
@@ -193,12 +196,25 @@ export function channelConnectorPlugin(options: ChannelConnectorPluginOptions =
       concurrency: { key: (input: Record<string, unknown>) => String(input.storeId), supersedes: true },
       handler: async ({ input, ctx }: { input: Record<string, unknown>; ctx: import("@porulle/core").TaskContext }) => {
         const service = new ChannelConnectorService(ctx.db, ctx.services, options);
-        const result = await service.importCatalog(String(input.orgId), String(input.storeId), createSystemActor(String(input.orgId)));
+        const orgId = String(input.orgId);
+        const storeId = String(input.storeId);
+        const result = await service.importCatalog(orgId, storeId, createSystemActor(orgId), {
+          maxItems: CHANNEL_IMPORT_MAX_ITEMS_PER_INVOCATION,
+        });
         if (!result.ok) throw new Error(result.error);
+        if (!result.value.exhausted) {
+          const jobs = ctx.services.jobs as JobsAdapter;
+          await jobs.enqueue("channel/import-catalog", { orgId, storeId }, {
+            organizationId: orgId,
+            concurrencyKey: storeId,
+            supersedes: true,
+          });
+        }
         return {
           output: {
             imported: result.value.imported,
             cursor: result.value.cursor,
+            exhausted: result.value.exhausted,
             ...(result.value.warnings ? { warnings: result.value.warnings } : {}),
           },
         };

package/src/service.ts

@@ -241,11 +241,34 @@ interface CatalogConvergenceStats {
   attributesCreated: number;
   mediaImported: number;
   variantsGivenOptionValues: number;
+  consumed: number;
   skipped: CatalogFieldSkip[];
   conflicts: CatalogFieldConflict[];
   warnings: string[];
 }
 
+type ImportResumePosition = { pageCursor: string | null; offset: number };
+
+function parseImportResumePosition(raw: string | null | undefined): ImportResumePosition {
+  if (!raw) return { pageCursor: null, offset: 0 };
+  try {
+    const parsed = JSON.parse(raw) as Partial<ImportResumePosition>;
+    if (typeof parsed === "object" && parsed !== null && "offset" in parsed) {
+      return {
+        pageCursor: parsed.pageCursor ?? null,
+        offset: typeof parsed.offset === "number" && parsed.offset >= 0 ? parsed.offset : 0,
+      };
+    }
+  } catch {
+    // Legacy bare page cursor.
+  }
+  return { pageCursor: raw, offset: 0 };
+}
+
+function encodeImportResumePosition(position: ImportResumePosition): string {
+  return JSON.stringify(position);
+}
+
 export interface BackfillCatalogOptions {
   dryRun?: boolean;
   resume?: boolean;
@@ -2175,7 +2198,40 @@ export class ChannelConnectorService {
     orgId: string,
     storeId: string,
     actor: Actor,
-  ): Promise<PluginResult<{ imported: number; cursor: string | null; skipped?: CatalogFieldSkip[]; conflicts?: CatalogFieldConflict[]; warnings?: string[] }>> {
+    options: { maxItems: number },
+  ): Promise<PluginResult<{
+    imported: number;
+    cursor: string | null;
+    exhausted: boolean;
+    skipped?: CatalogFieldSkip[];
+    conflicts?: CatalogFieldConflict[];
+    warnings?: string[];
+  }>>;
+  async importCatalog(
+    orgId: string,
+    storeId: string,
+    actor: Actor,
+    options?: undefined,
+  ): Promise<PluginResult<{
+    imported: number;
+    cursor: string | null;
+    skipped?: CatalogFieldSkip[];
+    conflicts?: CatalogFieldConflict[];
+    warnings?: string[];
+  }>>;
+  async importCatalog(
+    orgId: string,
+    storeId: string,
+    actor: Actor,
+    options?: { maxItems?: number },
+  ): Promise<PluginResult<{
+    imported: number;
+    cursor: string | null;
+    exhausted?: boolean;
+    skipped?: CatalogFieldSkip[];
+    conflicts?: CatalogFieldConflict[];
+    warnings?: string[];
+  }>> {
     const store = await this.getStoreRecord(orgId, storeId);
     if (!store || store.status !== "connected") {
       return PluginErr("Connected store not found.", "NOT_FOUND");
@@ -2183,28 +2239,103 @@ export class ChannelConnectorService {
     const connector = this.connectors.get(store.provider);
     if (!connector) return PluginErr(`No connector registered for provider "${store.provider}".`);
 
-    const items: ChannelCatalogItem[] = [];
-    let cursor: string | undefined = store.catalogCursor ?? undefined;
-    do {
-      const page = await connector.importCatalog(store as ChannelStore, cursor);
+    const maxItems = options?.maxItems;
+    const bounded = maxItems !== undefined;
+
+    if (!bounded) {
+      const resume = parseImportResumePosition(store.catalogCursor);
+      const items: ChannelCatalogItem[] = [];
+      let pageCursor: string | undefined = resume.pageCursor ?? undefined;
+      do {
+        const page = await connector.importCatalog(store as ChannelStore, pageCursor);
+        if (!page.ok) return PluginErr(page.error.message);
+        items.push(...page.value.items);
+        pageCursor = page.value.nextCursor ?? undefined;
+      } while (pageCursor);
+
+      const result = await this.convergeCatalogItems(orgId, storeId, items, actor);
+      if (!result.ok) return result;
+
+      await this.db
+        .update(connectedStores)
+        .set({ catalogCursor: null, lastSyncAt: new Date(), updatedAt: new Date() })
+        .where(and(eq(connectedStores.organizationId, orgId), eq(connectedStores.id, storeId)));
+      return Ok({
+        imported: result.value.imported,
+        cursor: null,
+        ...(result.value.skipped.length > 0 ? { skipped: uniqueSkipped(result.value.skipped) } : {}),
+        ...(result.value.conflicts.length > 0 ? { conflicts: result.value.conflicts } : {}),
+        ...(result.value.warnings.length > 0 ? { warnings: result.value.warnings } : {}),
+      });
+    }
+
+    let { pageCursor, offset } = parseImportResumePosition(store.catalogCursor);
+    let remaining = maxItems;
+    let exhausted = false;
+    let totalImported = 0;
+    const skipped: CatalogFieldSkip[] = [];
+    const conflicts: CatalogFieldConflict[] = [];
+    const warnings: string[] = [];
+
+    while (remaining > 0) {
+      const page = await connector.importCatalog(store as ChannelStore, pageCursor ?? undefined);
       if (!page.ok) return PluginErr(page.error.message);
-      items.push(...page.value.items);
-      cursor = page.value.nextCursor ?? undefined;
-    } while (cursor);
 
-    const result = await this.convergeCatalogItems(orgId, storeId, items, actor);
-    if (!result.ok) return result;
+      const pageItems = page.value.items;
+      const slice = pageItems.slice(offset);
+      const batchSize = Math.min(remaining, slice.length);
 
+      if (batchSize === 0) {
+        if (page.value.nextCursor) {
+          pageCursor = page.value.nextCursor;
+          offset = 0;
+          continue;
+        }
+        exhausted = true;
+        break;
+      }
+
+      const batch = slice.slice(0, batchSize);
+      const result = await this.convergeCatalogItems(orgId, storeId, batch, actor);
+      if (!result.ok) return result;
+
+      totalImported += result.value.imported;
+      remaining -= result.value.consumed;
+      skipped.push(...result.value.skipped);
+      conflicts.push(...result.value.conflicts);
+      warnings.push(...result.value.warnings);
+      offset += result.value.consumed;
+
+      if (offset >= pageItems.length) {
+        if (page.value.nextCursor) {
+          pageCursor = page.value.nextCursor;
+          offset = 0;
+        } else {
+          exhausted = true;
+        }
+      }
+
+      if (remaining === 0) break;
+      if (exhausted) break;
+    }
+
+    const catalogCursor = exhausted ? null : encodeImportResumePosition({ pageCursor, offset });
     await this.db
       .update(connectedStores)
-      .set({ catalogCursor: null, lastSyncAt: new Date(), updatedAt: new Date() })
+      .set({
+        catalogCursor,
+        ...(exhausted ? { lastSyncAt: new Date() } : {}),
+        updatedAt: new Date(),
+      })
       .where(and(eq(connectedStores.organizationId, orgId), eq(connectedStores.id, storeId)));
+
     return Ok({
-      imported: result.value.imported,
-      cursor: null,
-      ...(result.value.skipped.length > 0 ? { skipped: uniqueSkipped(result.value.skipped) } : {}),
-      ...(result.value.conflicts.length > 0 ? { conflicts: result.value.conflicts } : {}),
-      ...(result.value.warnings.length > 0 ? { warnings: result.value.warnings } : {}),
+      imported: totalImported,
+      cursor: catalogCursor,
+      exhausted,
+      ...(skipped.length > 0 ? { skipped: uniqueSkipped(skipped) } : {}),
+      ...(conflicts.length > 0 ? { conflicts } : {}),
+      ...(warnings.length > 0 ? { warnings } : {}),
     });
   }
 
@@ -2388,12 +2519,14 @@ export class ChannelConnectorService {
       attributesCreated: 0,
       mediaImported: 0,
       variantsGivenOptionValues: 0,
+      consumed: 0,
       skipped: [],
       conflicts: [],
       warnings: [],
     };
     const assets = await this.db.select().from(mediaAssets).where(eq(mediaAssets.organizationId, orgId));
     for (const item of items) {
+      stats.consumed += 1;
       const [entityMapping] = await this.db.select().from(channelEntityMap).where(and(
         eq(channelEntityMap.organizationId, orgId),
         eq(channelEntityMap.storeId, storeId),
@@ -2533,10 +2666,12 @@ export class ChannelConnectorService {
     let attributesCreated = 0;
     let mediaImported = 0;
     let variantsGivenOptionValues = 0;
+    let consumed = 0;
     const skipped: CatalogFieldSkip[] = [];
     const conflicts: CatalogFieldConflict[] = [];
     const warnings: string[] = [];
     for (const item of items) {
+      consumed += 1;
       const remoteHash = hash(item);
       const existing = await this.db
         .select()
@@ -2769,6 +2904,7 @@ export class ChannelConnectorService {
       attributesCreated,
       mediaImported,
       variantsGivenOptionValues,
+      consumed,
       skipped,
       conflicts,
       warnings,