@fullstackhouse/open-mercato-data-sync-durable 0.1.0

package/src/modules/data_sync/i18n/pl.json

@@ -0,0 +1,135 @@
+{
+  "data_sync.dashboard.actions.view": "Zobacz",
+  "data_sync.dashboard.columns.created": "Utworzone",
+  "data_sync.dashboard.columns.createdAt": "Rozpoczęto",
+  "data_sync.dashboard.columns.direction": "Kierunek",
+  "data_sync.dashboard.columns.entityType": "Typ encji",
+  "data_sync.dashboard.columns.failed": "Nieudane",
+  "data_sync.dashboard.columns.integration": "Integracja",
+  "data_sync.dashboard.columns.status": "Status",
+  "data_sync.dashboard.columns.updated": "Zaktualizowane",
+  "data_sync.dashboard.direction.export": "Eksport",
+  "data_sync.dashboard.direction.import": "Import",
+  "data_sync.dashboard.filters.allDirections": "Wszystkie kierunki",
+  "data_sync.dashboard.filters.allStatuses": "Wszystkie statusy",
+  "data_sync.dashboard.filters.status": "Status",
+  "data_sync.dashboard.loadError": "Nie udało się załadować przebiegów",
+  "data_sync.dashboard.noRuns": "Brak przebiegów synchronizacji",
+  "data_sync.dashboard.schedule.cron": "Cron",
+  "data_sync.dashboard.schedule.cronHelp": "Przykład: `0 * * * *` uruchamia zadanie na początku każdej godziny.",
+  "data_sync.dashboard.schedule.cronValue": "Wyrażenie cron",
+  "data_sync.dashboard.schedule.delete": "Usuń harmonogram",
+  "data_sync.dashboard.schedule.deleteError": "Nie udało się usunąć harmonogramu cyklicznego",
+  "data_sync.dashboard.schedule.deleteSuccess": "Usunięto harmonogram cykliczny",
+  "data_sync.dashboard.schedule.deleting": "Usuwanie...",
+  "data_sync.dashboard.schedule.description": "Zapisz powtarzalny harmonogram dla wybranej integracji, encji i kierunku bez opuszczania tego pulpitu.",
+  "data_sync.dashboard.schedule.enabled": "Harmonogram włączony",
+  "data_sync.dashboard.schedule.enabledHelp": "Wstrzymaj zadanie cykliczne bez usuwania definicji harmonogramu.",
+  "data_sync.dashboard.schedule.error": "Nie udało się zapisać harmonogramu cyklicznego",
+  "data_sync.dashboard.schedule.fullSync": "Uruchamiaj zaplanowane zadania jako pełną synchronizację",
+  "data_sync.dashboard.schedule.fullSyncHelp": "Gdy opcja jest włączona, każdy cykliczny przebieg zaczyna się od początku zamiast od zapisanego kursora.",
+  "data_sync.dashboard.schedule.interval": "Interwał",
+  "data_sync.dashboard.schedule.intervalHelp": "Przykład: `1h`, `6h` lub `24h` dla powtarzalnych interwałów.",
+  "data_sync.dashboard.schedule.intervalValue": "Interwał",
+  "data_sync.dashboard.schedule.invalidValue": "Podaj wartość harmonogramu przed zapisaniem.",
+  "data_sync.dashboard.schedule.lastRun": "Ostatni zaplanowany przebieg: {value}",
+  "data_sync.dashboard.schedule.neverRun": "Zapisano, ale żadne zaplanowane wykonanie jeszcze się nie zakończyło.",
+  "data_sync.dashboard.schedule.none": "Dla tego celu nie zapisano jeszcze harmonogramu cyklicznego.",
+  "data_sync.dashboard.schedule.save": "Zapisz harmonogram cykliczny",
+  "data_sync.dashboard.schedule.saving": "Zapisywanie...",
+  "data_sync.dashboard.schedule.status.disabled": "Harmonogram cykliczny wstrzymany",
+  "data_sync.dashboard.schedule.status.enabled": "Harmonogram cykliczny aktywny",
+  "data_sync.dashboard.schedule.status.none": "Brak harmonogramu cyklicznego",
+  "data_sync.dashboard.schedule.status.shortDisabled": "Wstrzymany",
+  "data_sync.dashboard.schedule.status.shortEnabled": "Zaplanowany",
+  "data_sync.dashboard.schedule.status.shortNone": "Tylko jednorazowo",
+  "data_sync.dashboard.schedule.success": "Zapisano harmonogram cykliczny",
+  "data_sync.dashboard.schedule.timezone": "Strefa czasowa",
+  "data_sync.dashboard.schedule.title": "Harmonogram cykliczny",
+  "data_sync.dashboard.schedule.type": "Typ harmonogramu",
+  "data_sync.dashboard.searchPlaceholder": "Szukaj po integracji, typie encji, statusie lub ID przebiegu",
+  "data_sync.dashboard.start.batchSize": "Rozmiar partii",
+  "data_sync.dashboard.start.description": "Wybierz cel synchronizacji, uruchom przebieg doraźny albo zapisz harmonogram cykliczny dla tej samej encji i kierunku z poziomu tej strony.",
+  "data_sync.dashboard.start.error": "Nie udało się uruchomić przebiegu synchronizacji",
+  "data_sync.dashboard.start.eyebrow": "Uruchom raz lub ustaw cyklicznie",
+  "data_sync.dashboard.start.fullSync": "Uruchom jako pełną synchronizację",
+  "data_sync.dashboard.start.fullSyncHelp": "Zignoruj zapisany kursor i przetwórz w tym przebiegu całe źródło od nowa.",
+  "data_sync.dashboard.start.invalidBatchSize": "Rozmiar partii musi mieścić się w zakresie od 1 do 1000.",
+  "data_sync.dashboard.start.parameters": "Parametry uruchomienia",
+  "data_sync.dashboard.start.parametersHelp": "Opcjonalne wartości akceptowane przez tę integrację dla ręcznego uruchomienia.",
+  "data_sync.dashboard.start.providerManaged": "Ta integracja uruchamia synchronizacje z własnego przepływu konfiguracji. Otwórz ustawienia integracji, aby kontynuować.",
+  "data_sync.dashboard.start.runNowDescription": "Użyj tej opcji dla najbliższej natychmiastowej synchronizacji. Rozmiar partii i tryb pełnej synchronizacji dotyczą wyłącznie tego ręcznego przebiegu.",
+  "data_sync.dashboard.start.runNowFootnote": "Ręczne przebiegi od razu pokazują postęp, a po uruchomieniu przenoszą na stronę szczegółów przebiegu.",
+  "data_sync.dashboard.start.runNowTitle": "Uruchom teraz jednorazowo",
+  "data_sync.dashboard.start.status.credentialsMissing": "Brak poświadczeń",
+  "data_sync.dashboard.start.status.credentialsReady": "Poświadczenia gotowe",
+  "data_sync.dashboard.start.status.disabled": "Integracja wyłączona",
+  "data_sync.dashboard.start.status.enabled": "Integracja włączona",
+  "data_sync.dashboard.start.submit": "Uruchom synchronizację",
+  "data_sync.dashboard.start.success": "Uruchomiono przebieg synchronizacji",
+  "data_sync.dashboard.start.title": "Uruchom lub zaplanuj synchronizację",
+  "data_sync.dashboard.status.cancelled": "Anulowany",
+  "data_sync.dashboard.status.completed": "Zakończony",
+  "data_sync.dashboard.status.failed": "Nieudany",
+  "data_sync.dashboard.status.paused": "Wstrzymany",
+  "data_sync.dashboard.status.pending": "Oczekujący",
+  "data_sync.dashboard.status.running": "W toku",
+  "data_sync.dashboard.title": "Przebiegi synchronizacji",
+  "data_sync.integrationTab.columns.actions": "Akcje",
+  "data_sync.integrationTab.columns.lastRun": "Ostatni przebieg",
+  "data_sync.integrationTab.columns.value": "Wartość",
+  "data_sync.integrationTab.credentialsMissing": "Skonfiguruj poświadczenia przed uruchomieniem synchronizacji.",
+  "data_sync.integrationTab.credentialsMissingNotice": "Wciąż brakuje poświadczeń. Możesz najpierw zapisać harmonogramy, ale ręczne i zaplanowane przebiegi będą kończyć się błędem, dopóki poświadczenia nie zostaną skonfigurowane.",
+  "data_sync.integrationTab.description": "Uruchamiaj jednorazowe synchronizacje albo zapisuj harmonogramy cykliczne dla każdej obsługiwanej encji bezpośrednio ze strony szczegółów integracji.",
+  "data_sync.integrationTab.empty": "Ten dostawca nie udostępnia jeszcze żadnych encji, które można zaplanować do synchronizacji.",
+  "data_sync.integrationTab.fullSyncShort": "Pełna",
+  "data_sync.integrationTab.integrationDisabled": "Włącz integrację przed uruchomieniem synchronizacji.",
+  "data_sync.integrationTab.integrationDisabledNotice": "Integracja jest wyłączona. Możesz teraz zapisać harmonogramy, ale przebiegi pozostaną zablokowane do czasu włączenia integracji.",
+  "data_sync.integrationTab.loadError": "Nie udało się załadować harmonogramów synchronizacji.",
+  "data_sync.integrationTab.notAvailable": "Ta integracja nie jest zarejestrowana jako dostawca synchronizacji danych.",
+  "data_sync.integrationTab.parametersRequired": "Ten przebieg wymaga parametrów. Uruchom go z panelu Data Sync.",
+  "data_sync.integrationTab.providerManaged": "Uruchom tę integrację z jej przepływu konfiguracji dostawcy.",
+  "data_sync.integrationTab.providerManagedNotice": "Ten dostawca wymaga własnego przepływu konfiguracji, zanim będzie można uruchomić synchronizację. Użyj karty dostawcy na tej stronie zamiast ogólnych harmonogramów.",
+  "data_sync.integrationTab.refresh": "Odśwież",
+  "data_sync.integrationTab.runError": "Nie udało się uruchomić synchronizacji.",
+  "data_sync.integrationTab.runNowHelp": "Opcja Uruchom teraz korzysta z pola pełnej synchronizacji z tego samego wiersza i od razu rozpoczyna śledzenie postępu w Synchronizacji danych.",
+  "data_sync.integrationTab.runNowTitle": "Ręczne przebiegi",
+  "data_sync.integrationTab.runStarted": "Uruchomiono przebieg synchronizacji.",
+  "data_sync.integrationTab.start": "Uruchom teraz",
+  "data_sync.integrationTab.starting": "Uruchamianie...",
+  "data_sync.integrationTab.title": "Harmonogramy synchronizacji",
+  "data_sync.nav.title": "Synchronizacja danych",
+  "data_sync.runParameters.errors.max": "Pole {label} może wynosić najwyżej {max}.",
+  "data_sync.runParameters.errors.min": "Pole {label} musi wynosić co najmniej {min}.",
+  "data_sync.runParameters.errors.required": "Pole {label} jest wymagane.",
+  "data_sync.runParameters.errors.select": "Pole {label} musi mieć jedną z wartości: {options}.",
+  "data_sync.runParameters.errors.type": "Pole {label} musi mieć typ {type}.",
+  "data_sync.runs.detail.back": "Powrót do przebiegów",
+  "data_sync.runs.detail.cancel": "Anuluj",
+  "data_sync.runs.detail.cancelError": "Nie udało się anulować przebiegu",
+  "data_sync.runs.detail.cancelSuccess": "Przebieg anulowany",
+  "data_sync.runs.detail.counters.created": "Utworzone",
+  "data_sync.runs.detail.counters.failed": "Nieudane",
+  "data_sync.runs.detail.counters.skipped": "Pominięte",
+  "data_sync.runs.detail.counters.updated": "Zaktualizowane",
+  "data_sync.runs.detail.error": "Błąd",
+  "data_sync.runs.detail.loadError": "Nie udało się załadować przebiegu",
+  "data_sync.runs.detail.logs": "Logi operacji",
+  "data_sync.runs.detail.logs.level": "Poziom",
+  "data_sync.runs.detail.logs.message": "Wiadomość",
+  "data_sync.runs.detail.logs.time": "Czas",
+  "data_sync.runs.detail.noLogs": "Brak wpisów w logach",
+  "data_sync.runs.detail.notFound": "Nie znaleziono przebiegu synchronizacji.",
+  "data_sync.runs.detail.parameters": "Parametry uruchomienia",
+  "data_sync.runs.detail.progress": "Postęp",
+  "data_sync.runs.detail.progress.batches": "{count} partii",
+  "data_sync.runs.detail.progress.eta": "Pozostało {eta}",
+  "data_sync.runs.detail.progress.itemsProcessed": "{count} elementów przetworzonych",
+  "data_sync.runs.detail.progress.itemsProcessedTotal": "{processed} / {total} elementów przetworzonych",
+  "data_sync.runs.detail.progress.percent": "{percent}% ukończono",
+  "data_sync.runs.detail.retry": "Ponów",
+  "data_sync.runs.detail.retryError": "Nie udało się ponowić przebiegu",
+  "data_sync.runs.detail.retryParametersStale": "Zapisane parametry uruchomienia nie są już poprawne dla tej integracji. Uruchom nowe zadanie z pulpitu Data Sync.",
+  "data_sync.runs.detail.retrySuccess": "Przebieg ponowiony",
+  "data_sync.runs.detail.title": "Przebieg synchronizacji"
+}

package/src/modules/data_sync/index.ts

@@ -0,0 +1,4 @@
+// GENERATED by scripts/gen-mirror.mjs from @open-mercato/core@0.7.0 (index.ts). Do not edit.
+// This package mirrors core's data_sync module file-for-file; see docs/adr/0006-drop-in-data-sync.md.
+export * from '@open-mercato/core/modules/data_sync/index'
+export { metadata } from '@open-mercato/core/modules/data_sync/index'

package/src/modules/data_sync/lib/adapter-registry.ts

@@ -0,0 +1,4 @@
+// GENERATED by scripts/gen-mirror.mjs from @open-mercato/core@0.7.0 (lib/adapter-registry.ts). Do not edit.
+// This package mirrors core's data_sync module file-for-file; see docs/adr/0006-drop-in-data-sync.md.
+export * from '@open-mercato/core/modules/data_sync/lib/adapter-registry'
+export { getAllDataSyncAdapters, getDataSyncAdapter, registerDataSyncAdapter, resolveAdapterForIntegration, resolveProviderKey } from '@open-mercato/core/modules/data_sync/lib/adapter-registry'

package/src/modules/data_sync/lib/adapter.ts

@@ -0,0 +1,3 @@
+// GENERATED by scripts/gen-mirror.mjs from @open-mercato/core@0.7.0 (lib/adapter.ts). Do not edit.
+// This package mirrors core's data_sync module file-for-file; see docs/adr/0006-drop-in-data-sync.md.
+export * from '@open-mercato/core/modules/data_sync/lib/adapter'

package/src/modules/data_sync/lib/adopt-on-delivery.ts

@@ -0,0 +1,69 @@
+// What happens when a run arrives on core's queue rather than through the durable start path.
+//
+// `sync_excel`, `sync_akeneo`'s first import, the scheduler, and anything else that imports
+// core's `startDataSyncRun` directly still enqueue a plain queue message. Core's own worker is
+// no longer registered — ours has its id — so without this those runs would simply never start.
+//
+// Rather than running them non-durably, the delivery is *adopted*: a durable job is created for
+// the run it names and the queue message ends there. The run then gets the same lease, the same
+// resumable slices and the same repair loop as one started durably. A caller that never heard
+// of this package gets the guarantees anyway.
+
+import type { JobContext, QueuedJob } from '@open-mercato/queue'
+import type { DurableWorkService } from '@fullstackhouse/open-mercato-durable-work'
+import { createLogger } from '@open-mercato/shared/lib/logger'
+
+import { EXPORT_KIND, IMPORT_KIND, syncIdempotencyKey, syncLockKey } from '../../../kinds/data-sync-run'
+
+const logger = createLogger('data_sync').child({ component: 'adopt-on-delivery' })
+
+type SyncJobPayload = {
+  runId: string
+  batchSize: number
+  scope: { organizationId: string; tenantId: string; userId?: string | null }
+}
+
+type HandlerContext = JobContext & { resolve: <T = unknown>(name: string) => T }
+
+type RunRow = {
+  id: string
+  integrationId: string
+  entityType: string
+  direction: string
+  status: string
+}
+
+export function adoptOnDelivery(direction: 'import' | 'export') {
+  return async function handle(job: QueuedJob<SyncJobPayload>, ctx: HandlerContext): Promise<void> {
+    const { runId, batchSize, scope } = job.payload
+    const durable = ctx.resolve<DurableWorkService>('durableWorkService')
+    const runService = ctx.resolve<{ getRun(id: string, scope: unknown): Promise<RunRow | null> }>('dataSyncRunService')
+
+    const run = await runService.getRun(runId, scope)
+    if (!run) {
+      logger.warn('Ignoring a delivery for a run that no longer exists', { runId })
+      return
+    }
+    if (run.status === 'completed' || run.status === 'failed' || run.status === 'cancelled') {
+      logger.warn('Ignoring a delivery for a run that already finished', { runId, status: run.status })
+      return
+    }
+
+    // Idempotent by the run id, so a redelivery of the same queue message adopts once. The
+    // lock key is the same one the durable start path uses, so a run that is already being
+    // driven refuses this rather than being driven twice.
+    await durable.startAndEnqueue(
+      {
+        kind: direction === 'import' ? IMPORT_KIND : EXPORT_KIND,
+        input: { runId, batchSize: batchSize ?? 100, direction },
+        lockKey: syncLockKey(run.integrationId, run.entityType, run.direction),
+        idempotencyKey: syncIdempotencyKey(runId),
+        subject: { type: 'data_sync.run', id: runId },
+        createdBy: scope.userId ?? null,
+      },
+      { tenantId: scope.tenantId, organizationId: scope.organizationId },
+    )
+
+    logger.info('Adopted a core-path sync run as durable work', { runId, direction })
+  }
+}

package/src/modules/data_sync/lib/batch-stream.ts

@@ -0,0 +1,4 @@
+// GENERATED by scripts/gen-mirror.mjs from @open-mercato/core@0.7.0 (lib/batch-stream.ts). Do not edit.
+// This package mirrors core's data_sync module file-for-file; see docs/adr/0006-drop-in-data-sync.md.
+export * from '@open-mercato/core/modules/data_sync/lib/batch-stream'
+export { forEachBatch } from '@open-mercato/core/modules/data_sync/lib/batch-stream'

package/src/modules/data_sync/lib/id-mapping.ts

@@ -0,0 +1,4 @@
+// GENERATED by scripts/gen-mirror.mjs from @open-mercato/core@0.7.0 (lib/id-mapping.ts). Do not edit.
+// This package mirrors core's data_sync module file-for-file; see docs/adr/0006-drop-in-data-sync.md.
+export * from '@open-mercato/core/modules/data_sync/lib/id-mapping'
+export { createExternalIdMappingService } from '@open-mercato/core/modules/data_sync/lib/id-mapping'

package/src/modules/data_sync/lib/queue-policy.ts

@@ -0,0 +1,4 @@
+// GENERATED by scripts/gen-mirror.mjs from @open-mercato/core@0.7.0 (lib/queue-policy.ts). Do not edit.
+// This package mirrors core's data_sync module file-for-file; see docs/adr/0006-drop-in-data-sync.md.
+export * from '@open-mercato/core/modules/data_sync/lib/queue-policy'
+export { DATA_SYNC_EXPORT_QUEUE, DATA_SYNC_IMPORT_QUEUE, DATA_SYNC_LOCK_DURATION_MS, DATA_SYNC_MAX_STALLED_COUNT, DATA_SYNC_QUEUE_ATTEMPTS, DATA_SYNC_RESUMABLE_QUEUES } from '@open-mercato/core/modules/data_sync/lib/queue-policy'

package/src/modules/data_sync/lib/queue.ts

@@ -0,0 +1,4 @@
+// GENERATED by scripts/gen-mirror.mjs from @open-mercato/core@0.7.0 (lib/queue.ts). Do not edit.
+// This package mirrors core's data_sync module file-for-file; see docs/adr/0006-drop-in-data-sync.md.
+export * from '@open-mercato/core/modules/data_sync/lib/queue'
+export { getSyncQueue } from '@open-mercato/core/modules/data_sync/lib/queue'

package/src/modules/data_sync/lib/run-parameters.ts

@@ -0,0 +1,4 @@
+// GENERATED by scripts/gen-mirror.mjs from @open-mercato/core@0.7.0 (lib/run-parameters.ts). Do not edit.
+// This package mirrors core's data_sync module file-for-file; see docs/adr/0006-drop-in-data-sync.md.
+export * from '@open-mercato/core/modules/data_sync/lib/run-parameters'
+export { getApplicableRunParameters, isReservedRunParameterKey, normalizeRunParameters } from '@open-mercato/core/modules/data_sync/lib/run-parameters'

package/src/modules/data_sync/lib/start-cursor.ts

@@ -0,0 +1,4 @@
+// GENERATED by scripts/gen-mirror.mjs from @open-mercato/core@0.7.0 (lib/start-cursor.ts). Do not edit.
+// This package mirrors core's data_sync module file-for-file; see docs/adr/0006-drop-in-data-sync.md.
+export * from '@open-mercato/core/modules/data_sync/lib/start-cursor'
+export { persistsSharedCursor, resolveAdapterForIntegration, resolveStartCursor } from '@open-mercato/core/modules/data_sync/lib/start-cursor'

package/src/modules/data_sync/lib/start-run.ts

@@ -0,0 +1,106 @@
+// The durable start path.
+//
+// Same signature and same return shape as core's `startDataSyncRun`, so every caller — the run
+// route, `sync_excel`, `sync_akeneo`'s first import — keeps working untouched. What changes is
+// what gets created: a durable job instead of a queue message, in the same transaction as the
+// run row where the transport allows it.
+
+import type { DurableWorkService } from '@fullstackhouse/open-mercato-durable-work'
+
+import { IMPORT_KIND, EXPORT_KIND, syncIdempotencyKey, syncLockKey } from '../../../kinds/data-sync-run'
+
+export type {
+  DataSyncStartScope,
+  StartDataSyncRunInput,
+} from '@open-mercato/core/modules/data_sync/lib/start-run'
+
+type StartScope = { organizationId: string; tenantId: string; userId?: string | null }
+
+type StartInput = {
+  integrationId: string
+  entityType: string
+  direction: 'import' | 'export'
+  cursor?: string | null
+  triggeredBy?: string | null
+  batchSize?: number
+  parameters?: Record<string, unknown> | null
+  createProgressJob?: boolean
+  progressJob?: {
+    jobType?: string
+    name?: string
+    description?: string
+    cancellable?: boolean
+    meta?: Record<string, unknown>
+  }
+}
+
+type ProgressServiceLike = {
+  createJob(input: Record<string, unknown>, ctx: Record<string, unknown>): Promise<{ id: string }>
+}
+
+type SyncRunServiceLike = {
+  createRun(input: Record<string, unknown>, scope: Record<string, unknown>): Promise<{ id: string }>
+}
+
+export async function startDataSyncRun(params: {
+  syncRunService: SyncRunServiceLike
+  progressService: ProgressServiceLike
+  durableWorkService: DurableWorkService
+  scope: StartScope
+  input: StartInput
+}) {
+  const { syncRunService, progressService, durableWorkService, scope, input } = params
+
+  // Always created, never optional as it is in core.
+  //
+  // Core consults the progress row's cancellation flag once per batch, and that check is what
+  // gives a slice its hand-back point. A run without a progress job has no batch boundary to
+  // stop at, so it could only be interrupted between whole runs — which for a multi-day
+  // backfill is the same as not being interruptible. See docs/adr/0004.
+  const progressJob = await progressService.createJob(
+    {
+      jobType: input.progressJob?.jobType ?? `data_sync:${input.direction}`,
+      name: input.progressJob?.name ?? `Data sync ${input.integrationId} — ${input.entityType}`,
+      description: input.progressJob?.description ?? `${input.entityType} ${input.direction}`,
+      cancellable: true,
+      meta: {
+        integrationId: input.integrationId,
+        entityType: input.entityType,
+        direction: input.direction,
+        ...(input.progressJob?.meta ?? {}),
+      },
+    },
+    { tenantId: scope.tenantId, organizationId: scope.organizationId, userId: scope.userId },
+  )
+
+  const run = await syncRunService.createRun(
+    {
+      integrationId: input.integrationId,
+      entityType: input.entityType,
+      direction: input.direction,
+      cursor: input.cursor ?? null,
+      triggeredBy: input.triggeredBy ?? scope.userId ?? null,
+      parameters: input.parameters ?? null,
+      progressJobId: progressJob.id,
+    },
+    { organizationId: scope.organizationId, tenantId: scope.tenantId },
+  )
+
+  await durableWorkService.startAndEnqueue(
+    {
+      kind: input.direction === 'import' ? IMPORT_KIND : EXPORT_KIND,
+      input: { runId: run.id, batchSize: input.batchSize ?? 100, direction: input.direction },
+      // One live run per integration, entity and direction. Two imports of the same entity
+      // would interleave over a single cursor and silently lose rows.
+      lockKey: syncLockKey(input.integrationId, input.entityType, input.direction),
+      // Makes a retried start return the job that already exists instead of a second one.
+      idempotencyKey: syncIdempotencyKey(run.id),
+      subject: { type: 'data_sync.run', id: run.id },
+      progressJobId: progressJob.id,
+      createdBy: scope.userId ?? null,
+    },
+    { tenantId: scope.tenantId, organizationId: scope.organizationId },
+  )
+
+  return { run, progressJob }
+}

package/src/modules/data_sync/lib/sync-engine.ts

@@ -0,0 +1,4 @@
+// GENERATED by scripts/gen-mirror.mjs from @open-mercato/core@0.7.0 (lib/sync-engine.ts). Do not edit.
+// This package mirrors core's data_sync module file-for-file; see docs/adr/0006-drop-in-data-sync.md.
+export * from '@open-mercato/core/modules/data_sync/lib/sync-engine'
+export { createSyncEngine } from '@open-mercato/core/modules/data_sync/lib/sync-engine'

package/src/modules/data_sync/lib/sync-run-service.ts

@@ -0,0 +1,4 @@
+// GENERATED by scripts/gen-mirror.mjs from @open-mercato/core@0.7.0 (lib/sync-run-service.ts). Do not edit.
+// This package mirrors core's data_sync module file-for-file; see docs/adr/0006-drop-in-data-sync.md.
+export * from '@open-mercato/core/modules/data_sync/lib/sync-run-service'
+export { SyncRunOwnershipConflictError, createSyncRunService } from '@open-mercato/core/modules/data_sync/lib/sync-run-service'

package/src/modules/data_sync/lib/sync-schedule-service.ts

@@ -0,0 +1,4 @@
+// GENERATED by scripts/gen-mirror.mjs from @open-mercato/core@0.7.0 (lib/sync-schedule-service.ts). Do not edit.
+// This package mirrors core's data_sync module file-for-file; see docs/adr/0006-drop-in-data-sync.md.
+export * from '@open-mercato/core/modules/data_sync/lib/sync-schedule-service'
+export { createSyncScheduleService } from '@open-mercato/core/modules/data_sync/lib/sync-schedule-service'

package/src/modules/data_sync/lib/syncRunStatus.ts

@@ -0,0 +1,4 @@
+// GENERATED by scripts/gen-mirror.mjs from @open-mercato/core@0.7.0 (lib/syncRunStatus.ts). Do not edit.
+// This package mirrors core's data_sync module file-for-file; see docs/adr/0006-drop-in-data-sync.md.
+export * from '@open-mercato/core/modules/data_sync/lib/syncRunStatus'
+export { getSyncRunStatusVariant, getSyncSummaryVariant, syncRunStatusVariants, syncSummaryVariants } from '@open-mercato/core/modules/data_sync/lib/syncRunStatus'

package/src/modules/data_sync/lib/version-guard.ts

@@ -0,0 +1,27 @@
+// What happens if core's engine stops behaving the way the adopter decorates it.
+//
+// An earlier version of this compared version strings by walking up from `require.resolve` to
+// find core's manifest. That was wrong twice over: bundlers cannot statically resolve a
+// computed `require`, so it broke the app build outright — and a version string is not the
+// thing worth checking. The install-time guard is the peer range (`>=0.7.0 <0.8.0`), which the
+// package manager enforces; the build-time guard is `gen:mirror --check` and the seam probe in
+// `src/compat`, which read core's actual source.
+//
+// What is left for runtime is the case none of those catch: core still installs, still builds,
+// still passes the probes, but a decorated method has stopped doing what the adopter relies on.
+// The signature of that is specific enough to detect, and detecting it matters, because the
+// failure it produces is silent — a run that reports success while its domain row says
+// something else.
+
+/** Thrown when core finalized a run itself instead of letting the adopter record it. */
+export class SeamBrokenError extends Error {
+  readonly durableErrorClass = 'terminal' as const
+  constructor(readonly runId: string, detail: string) {
+    super(
+      `@fullstackhouse/open-mercato-data-sync-durable could not take over run ${runId}: ${detail}. ` +
+        `This package decorates @open-mercato/core's data_sync engine and one of the contracts it relies on has changed. ` +
+        `Install the package line matching the installed core minor, or report the change — see docs/adr/0004.`,
+    )
+    this.name = 'SeamBrokenError'
+  }
+}