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

package/src/kinds/data-sync-run.ts

@@ -0,0 +1,104 @@
+// The job kinds a `data_sync` run becomes.
+//
+// A slice is one call into core's own engine, with the run service and the progress service
+// decorated for its duration. The engine does all the work it always did; what changes is where
+// its cursor commits go (through the lease fence), when it stops (at a batch boundary when the
+// slice budget is spent), and who writes the terminal state (the durable transition, in the
+// same transaction as the job's own).
+
+import type { KindDefinition, SliceContext, SliceOutcome, SqlExecutor } from '@fullstackhouse/open-mercato-durable-work'
+
+import {
+  mirrorRunStatus,
+  outcomeOf,
+  recordSlice,
+  reopenRun,
+  type ProgressServiceLike,
+  type SyncRunServiceLike,
+  type SyncScope,
+} from '../engine/durable-run'
+
+export const IMPORT_KIND = 'data_sync.import'
+export const EXPORT_KIND = 'data_sync.export'
+export const DATA_SYNC_QUEUE = 'durable-work.data-sync'
+
+export type SyncRunInput = {
+  runId: string
+  batchSize: number
+  direction: 'import' | 'export'
+}
+
+/** What a slice needs from the host, resolved per slice from the container. */
+export type SyncEngineLike = {
+  runImport(runId: string, batchSize: number, scope: SyncScope): Promise<void>
+  runExport(runId: string, batchSize: number, scope: SyncScope): Promise<void>
+}
+
+export type DataSyncKindDeps = {
+  /** Resolved per slice, because each slice runs on its own EntityManager. */
+  resolve(): Promise<{
+    engine: (services: { runService: SyncRunServiceLike; progressService: ProgressServiceLike }) => SyncEngineLike
+    runService: SyncRunServiceLike
+    progressService: ProgressServiceLike
+  }>
+}
+
+async function runSlice(ctx: SliceContext<SyncRunInput>, deps: DataSyncKindDeps): Promise<SliceOutcome> {
+  const input = ctx.job.input as SyncRunInput
+  const scope: SyncScope = { tenantId: ctx.scope.tenantId, organizationId: ctx.scope.organizationId }
+  const { engine, runService, progressService } = await deps.resolve()
+
+  const recorder = recordSlice(ctx, runService, progressService)
+  const decorated = engine({ runService: recorder.runService, progressService: recorder.progressService })
+
+  if (input.direction === 'export') await decorated.runExport(input.runId, input.batchSize, scope)
+  else await decorated.runImport(input.runId, input.batchSize, scope)
+
+  const after = await runService.getRun(input.runId, scope)
+  return outcomeOf(recorder, input.runId, after?.status)
+}
+
+/**
+ * Builds both kinds.
+ *
+ * `orphanPolicy: 'redrive'` is deliberate and is the one place the adopter asserts something
+ * about the work rather than the mechanism: a sync run keeps a committed cursor, so re-running
+ * it after a worker died resumes rather than repeats. That is what makes automatic recovery
+ * safe here when the mechanism's default is to park and wait for a human.
+ */
+export function dataSyncKinds(deps: DataSyncKindDeps): KindDefinition<SyncRunInput, never>[] {
+  const shared = {
+    queue: DATA_SYNC_QUEUE,
+    requiredFeatures: ['data_sync.run'],
+    orphanPolicy: 'redrive' as const,
+    // Long enough that a slow adapter page does not look like a dead worker, short enough that
+    // a dead worker is noticed in about a minute.
+    lease: { ttlMs: 60_000, sliceBudgetMs: 300_000, pendingTtlMs: 900_000 },
+
+    async onTransition(job: { id: string; input: unknown; status: string; errorMessage: string | null }, _scope: unknown, tx: SqlExecutor) {
+      const { runId } = job.input as SyncRunInput
+      const status = job.status === 'completed' ? 'completed' : job.status === 'cancelled' ? 'cancelled' : 'failed'
+      return mirrorRunStatus(tx, runId, status, job.errorMessage)
+    },
+
+    async onRedrive(job: { input: unknown }, _scope: unknown, tx: SqlExecutor) {
+      return reopenRun(tx, (job.input as SyncRunInput).runId)
+    },
+  }
+
+  return [
+    { ...shared, kind: IMPORT_KIND, step: (ctx) => runSlice(ctx, deps) } as KindDefinition<SyncRunInput, never>,
+    { ...shared, kind: EXPORT_KIND, step: (ctx) => runSlice(ctx, deps) } as KindDefinition<SyncRunInput, never>,
+  ]
+}
+
+/** The single-runner key: one live run per integration, entity and direction. Two imports of
+ *  the same entity would interleave over one cursor. */
+export function syncLockKey(integrationId: string, entityType: string, direction: string): string {
+  return `data_sync:${integrationId}:${entityType}:${direction}`
+}
+
+/** Makes starting a run twice for the same run id return the first job rather than a second. */
+export function syncIdempotencyKey(runId: string): string {
+  return `data_sync.run:${runId}`
+}

package/src/mirror-version.ts

@@ -0,0 +1,3 @@
+// GENERATED by scripts/gen-mirror.mjs. Do not edit.
+/** The @open-mercato/core version this package's mirror and decorators were built against. */
+export const MIRRORED_CORE_VERSION = "0.7.0"

package/src/mirror.manifest.json

@@ -0,0 +1,65 @@
+{
+  "coreVersion": "0.7.0",
+  "moduleId": "data_sync",
+  "generated": {
+    "acl.ts": "3b30f591eae78964",
+    "api/mappings/[id]/route.ts": "7b3fb917db7bd831",
+    "api/mappings/route.ts": "5551bc5ff61dfebb",
+    "api/options.ts": "bff527b4061b6c2b",
+    "api/runs.ts": "a2024a96d896c814",
+    "api/runs/[id]/cancel.ts": "1c99c66183d994ae",
+    "api/runs/[id]/retry.ts": "cf6ea67efcebdeb9",
+    "api/runs/[id]/route.ts": "2d0e39daef513f92",
+    "api/schedules/[id]/route.ts": "af2b16bd45fd02b5",
+    "api/schedules/route.ts": "2dbf0d2f04cdc100",
+    "api/schedules/serialize.ts": "44664c58abafd26f",
+    "api/validate.ts": "9fd095700abd39cb",
+    "backend/data-sync/page.meta.ts": "0dd9b6b406fa2699",
+    "backend/data-sync/page.tsx": "e68b00a4242abbbb",
+    "backend/data-sync/runs/[id]/page.meta.ts": "a1946eb5885a2109",
+    "backend/data-sync/runs/[id]/page.tsx": "963778ff29f7d96f",
+    "components/IntegrationScheduleTab.tsx": "185732c76a2f953a",
+    "components/RunParameterFields.tsx": "3f49886ef0a55193",
+    "data/entities.ts": "16476c912a6c7d40",
+    "data/validators.ts": "6c238076541373b0",
+    "events.ts": "8eea801045ff9789",
+    "extension-points.ts": "903cae9d931e0fb3",
+    "i18n/de.json": "943e5875db1ab98b",
+    "i18n/en.json": "ae6c5edcba6bb7f7",
+    "i18n/es.json": "de135edcf1917269",
+    "i18n/ko.json": "cb75626e56a0d267",
+    "i18n/pl.json": "6096d5c85f98ba8a",
+    "index.ts": "c15d4c24db598205",
+    "lib/adapter-registry.ts": "9ddb1b6cbfa911d7",
+    "lib/adapter.ts": "3902953e7bdc6021",
+    "lib/batch-stream.ts": "db921759b23aef76",
+    "lib/id-mapping.ts": "08628d924244bfc8",
+    "lib/queue-policy.ts": "7c75ee82eca0ca70",
+    "lib/queue.ts": "0fb590d7695c3837",
+    "lib/run-parameters.ts": "145b0a8697d34c82",
+    "lib/start-cursor.ts": "2620c39153035fb5",
+    "lib/sync-engine.ts": "bf3dbfdb1676190c",
+    "lib/sync-run-service.ts": "f55c4ec8c547cbd9",
+    "lib/sync-schedule-service.ts": "fe2e6bafc37ed319",
+    "lib/syncRunStatus.ts": "c30a457245c9cd11",
+    "migrations/.snapshot-open-mercato.json": "662107af1e52e5d3",
+    "migrations/Migration20260304113737.ts": "e3f0edec96d4a4d8",
+    "migrations/Migration20260810120000.ts": "29a2154fcf03c5ce",
+    "setup.ts": "f33921e5cb6aafa3",
+    "workers/sync-scheduled.ts": "bd1c585595bc7148"
+  },
+  "replaced": {
+    "api/run.ts": "0eda5b6869a0b95d",
+    "di.ts": "d351534bd20b2b29",
+    "lib/start-run.ts": "74081590458b202b",
+    "workers/sync-export.ts": "a23cad4d03dd42da",
+    "workers/sync-import.ts": "21e5356d2d394b6d"
+  },
+  "entityDescriptor": [
+    "entities.ids.generated.ts",
+    "entities/sync_run/index.ts",
+    "entities/sync_cursor/index.ts",
+    "entities/sync_mapping/index.ts",
+    "entities/sync_schedule/index.ts"
+  ]
+}

package/src/modules/data_sync/__integration__/TC-DSD-001.spec.ts

@@ -0,0 +1,80 @@
+// The `data_sync` drop-in, against a running app.
+//
+// The point of these is that nothing in them is durable-work specific: they exercise core's own
+// `data_sync` API and assert core's own behaviour. If this package is doing its job, a host
+// cannot tell the difference — except that a run now leaves a durable job behind it.
+
+import { expect, test } from '@playwright/test'
+import { apiRequest, getAuthToken } from '@open-mercato/core/helpers/integration/api'
+
+type Options = { items: Array<{ integrationId: string; canStartRun?: boolean; isEnabled?: boolean }> }
+type StartedRun = { id: string; progressJobId: string }
+type Job = {
+  id: string
+  kind: string
+  status: string
+  lockKey: string | null
+  idempotencyKey: string | null
+  subject: { type: string; id: string } | null
+  redrivable: boolean
+}
+
+const startRun = async (request: Parameters<typeof apiRequest>[0], token: string, parameters: Record<string, unknown>) =>
+  apiRequest(request, 'POST', '/api/data_sync/run', {
+    token,
+    data: { integrationId: 'example_sync', entityType: 'example.record', direction: 'import', parameters },
+  })
+
+// Serial: these share one lock key, so a run left live by one test is the reason the next
+// would fail. Ordering them is honest — a parallel run of the same integration is exactly what
+// the single-runner guarantee forbids.
+test.describe.serial('data_sync served from the durable package', () => {
+  test('keeps core\'s API surface: the runs list answers as it always did', async ({ request }) => {
+    const token = await getAuthToken(request, 'admin')
+    const response = await apiRequest(request, 'GET', '/api/data_sync/runs', { token })
+    expect(response.status()).toBe(200)
+    expect(await response.json()).toMatchObject({ items: expect.any(Array) })
+  })
+
+  test('keeps core\'s adapter registry: the scripted integration is startable', async ({ request }) => {
+    // `example_sync` registers through core's own adapter registry from an `@app` module. That
+    // it is visible here is the evidence that swapping the package did not break the registry
+    // every other provider shares.
+    const token = await getAuthToken(request, 'admin')
+    const response = await apiRequest(request, 'GET', '/api/data_sync/options', { token })
+    expect(response.status()).toBe(200)
+
+    const body = (await response.json()) as Options
+    const example = body.items.find((item) => item.integrationId === 'example_sync')
+    expect(example, 'example_sync should be registered and enabled').toBeTruthy()
+    expect(example?.canStartRun).toBe(true)
+  })
+
+  test('a started run becomes a durable job with its lock, idempotency key and subject', async ({ request }) => {
+    const token = await getAuthToken(request, 'admin')
+    const started = await startRun(request, token, { batches: 3, itemsPerBatch: 1 })
+    expect(started.status()).toBe(201)
+    // Reported by the route so a failure here says *why* rather than just "no job found".
+    expect(started.headers()['x-durable-work'], started.headers()['x-durable-work-reason'] ?? 'no reason reported').toBe('created')
+    const run = (await started.json()) as StartedRun
+    expect(run.progressJobId, 'a progress job is required: core consults it for the per-batch stop').toBeTruthy()
+
+    const jobs = await apiRequest(request, 'GET', `/api/durable_work/jobs?kind=data_sync.import&pageSize=50`, { token })
+    const body = (await jobs.json()) as { items: Job[] }
+    const job = body.items.find((item) => item.subject?.id === run.id)
+
+    expect(job, 'the run should have produced a durable job').toBeTruthy()
+    expect(job!.lockKey).toBe('data_sync:example_sync:example.record:import')
+    expect(job!.idempotencyKey).toBe(`data_sync.run:${run.id}`)
+    expect(job!.subject).toEqual({ type: 'data_sync.run', id: run.id })
+  })
+
+  test('refuses a second live run for the same integration, entity and direction', async ({ request }) => {
+    // The single-runner guarantee. Two imports of one entity would interleave over a single
+    // cursor, and the rows one of them skipped would never be noticed.
+    const token = await getAuthToken(request, 'admin')
+    await startRun(request, token, { batches: 3 })
+    const second = await startRun(request, token, { batches: 3 })
+    expect(second.status()).toBe(409)
+  })
+})

package/src/modules/data_sync/acl.ts

@@ -0,0 +1,5 @@
+// GENERATED by scripts/gen-mirror.mjs from @open-mercato/core@0.7.0 (acl.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/acl'
+export { default } from '@open-mercato/core/modules/data_sync/acl'
+export { features } from '@open-mercato/core/modules/data_sync/acl'

package/src/modules/data_sync/api/mappings/[id]/route.ts

@@ -0,0 +1,12 @@
+// GENERATED by scripts/gen-mirror.mjs from @open-mercato/core@0.7.0 (api/mappings/[id]/route.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/api/mappings/[id]/route'
+export { GET, PUT, DELETE } from '@open-mercato/core/modules/data_sync/api/mappings/[id]/route'
+import { openApi as coreOpenApi } from '@open-mercato/core/modules/data_sync/api/mappings/[id]/route'
+export const openApi = coreOpenApi
+// Copied from core: the generator reads this by AST and cannot follow a re-export.
+export const metadata = {
+  GET: { requireAuth: true, requireFeatures: ['data_sync.configure'] },
+  PUT: { requireAuth: true, requireFeatures: ['data_sync.configure'] },
+  DELETE: { requireAuth: true, requireFeatures: ['data_sync.configure'] },
+}

package/src/modules/data_sync/api/mappings/route.ts

@@ -0,0 +1,11 @@
+// GENERATED by scripts/gen-mirror.mjs from @open-mercato/core@0.7.0 (api/mappings/route.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/api/mappings/route'
+export { GET, POST } from '@open-mercato/core/modules/data_sync/api/mappings/route'
+import { openApi as coreOpenApi } from '@open-mercato/core/modules/data_sync/api/mappings/route'
+export const openApi = coreOpenApi
+// Copied from core: the generator reads this by AST and cannot follow a re-export.
+export const metadata = {
+  GET: { requireAuth: true, requireFeatures: ['data_sync.configure'] },
+  POST: { requireAuth: true, requireFeatures: ['data_sync.configure'] },
+}

package/src/modules/data_sync/api/options.ts

@@ -0,0 +1,10 @@
+// GENERATED by scripts/gen-mirror.mjs from @open-mercato/core@0.7.0 (api/options.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/api/options'
+export { GET } from '@open-mercato/core/modules/data_sync/api/options'
+import { openApi as coreOpenApi } from '@open-mercato/core/modules/data_sync/api/options'
+export const openApi = coreOpenApi
+// Copied from core: the generator reads this by AST and cannot follow a re-export.
+export const metadata = {
+  GET: { requireAuth: true, requireFeatures: ['data_sync.view'] },
+}

package/src/modules/data_sync/api/run.ts

@@ -0,0 +1,103 @@
+// Core's run route, with the durable job created alongside the run.
+//
+// Wrapped rather than copied. Core's route is 180 lines of validation, ACL guards, cursor
+// resolution and parameter normalisation, and duplicating that is precisely the liability
+// ADR 0004 removed for the engine — the same argument applies here.
+//
+// Why the wrapper is needed at all: replacing `lib/start-run.ts` redirects only callers that
+// import *our* deep path. Core's own route imports its own sibling, so a run started through
+// it never reaches our start path. This is where that is fixed.
+//
+// The durable job is created after core's transaction rather than inside it, which is weaker
+// than the transactional start our own path gives. It is not a hole: core also enqueues onto
+// its queue, our adopt-on-delivery worker is registered under core's worker id, and both paths
+// carry the same idempotency key — so a crash between the two ends with the delivery adopting
+// the run instead. What the wrapper buys is that the job normally exists immediately, rather
+// than whenever the queue gets to it.
+
+import { getAuthFromRequest } from '@open-mercato/shared/lib/auth/server'
+import { createRequestContainer } from '@open-mercato/shared/lib/di/container'
+import { createLogger } from '@open-mercato/shared/lib/logger'
+import { POST as corePost, openApi as coreOpenApi } from '@open-mercato/core/modules/data_sync/api/run'
+import type { DurableWorkService } from '@fullstackhouse/open-mercato-durable-work'
+
+import { EXPORT_KIND, IMPORT_KIND, syncIdempotencyKey, syncLockKey } from '../../../kinds/data-sync-run'
+
+const logger = createLogger('data_sync').child({ component: 'durable-run-route' })
+
+// Copied from core, because the generator reads it by AST and cannot follow a re-export.
+export const metadata = {
+  POST: { requireAuth: true, requireFeatures: ['data_sync.run'] },
+}
+
+export const openApi = coreOpenApi
+
+type StartedRun = { id: string; progressJobId: string | null }
+type RunRow = { id: string; integrationId: string; entityType: string; direction: string; progressJobId?: string | null }
+
+/**
+ * Says what happened to the durable job, without changing core's response body.
+ *
+ *   created  — the job exists now
+ *   deferred — it does not, and the queue delivery will adopt the run instead
+ *
+ * A header rather than a log line because the difference matters to whoever called: `created`
+ * means the run is already under a lease, `deferred` means it is not yet. Buried in a log,
+ * that distinction is unavailable to exactly the people who need it, including a test.
+ */
+const DURABLE_HEADER = 'x-durable-work'
+
+export async function POST(req: Request) {
+  const response = await corePost(req)
+  if (response.status !== 201) return response
+
+  // Cloned: the caller still gets core's response untouched, whatever happens below.
+  const started = (await response.clone().json()) as StartedRun
+
+  try {
+    const auth = await getAuthFromRequest(req)
+    if (!auth?.tenantId) {
+      response.headers.set(DURABLE_HEADER, 'deferred')
+      return response
+    }
+
+    const container = await createRequestContainer()
+    const durable = container.resolve('durableWorkService') as DurableWorkService
+    const runService = container.resolve('dataSyncRunService') as {
+      getRun(id: string, scope: unknown): Promise<RunRow | null>
+    }
+    const scope = { tenantId: auth.tenantId, organizationId: auth.orgId ?? null }
+
+    const run = await runService.getRun(started.id, { ...scope, organizationId: auth.orgId })
+    if (!run) {
+      response.headers.set(DURABLE_HEADER, 'deferred')
+      return response
+    }
+
+    await durable.startAndEnqueue(
+      {
+        kind: run.direction === 'export' ? EXPORT_KIND : IMPORT_KIND,
+        input: { runId: run.id, batchSize: 100, direction: run.direction === 'export' ? 'export' : 'import' },
+        lockKey: syncLockKey(run.integrationId, run.entityType, run.direction),
+        idempotencyKey: syncIdempotencyKey(run.id),
+        subject: { type: 'data_sync.run', id: run.id },
+        progressJobId: run.progressJobId ?? started.progressJobId ?? null,
+        createdBy: auth.sub ?? null,
+      },
+      scope,
+    )
+    response.headers.set(DURABLE_HEADER, 'created')
+  } catch (error) {
+    // Never fails the request. The run exists and core has already enqueued it, so the
+    // adopt-on-delivery worker will make it durable; turning that into a 500 would refuse a
+    // run that is going to happen anyway.
+    logger.warn('Could not create the durable job for a started run; the queue delivery will adopt it', {
+      runId: started.id,
+      err: error,
+    })
+    response.headers.set(DURABLE_HEADER, 'deferred')
+    response.headers.set(`${DURABLE_HEADER}-reason`, error instanceof Error ? error.message.slice(0, 200) : 'unknown')
+  }
+
+  return response
+}

package/src/modules/data_sync/api/runs/[id]/cancel.ts

@@ -0,0 +1,10 @@
+// GENERATED by scripts/gen-mirror.mjs from @open-mercato/core@0.7.0 (api/runs/[id]/cancel.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/api/runs/[id]/cancel'
+export { POST } from '@open-mercato/core/modules/data_sync/api/runs/[id]/cancel'
+import { openApi as coreOpenApi } from '@open-mercato/core/modules/data_sync/api/runs/[id]/cancel'
+export const openApi = coreOpenApi
+// Copied from core: the generator reads this by AST and cannot follow a re-export.
+export const metadata = {
+  POST: { requireAuth: true, requireFeatures: ['data_sync.run'] },
+}

package/src/modules/data_sync/api/runs/[id]/retry.ts

@@ -0,0 +1,10 @@
+// GENERATED by scripts/gen-mirror.mjs from @open-mercato/core@0.7.0 (api/runs/[id]/retry.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/api/runs/[id]/retry'
+export { POST } from '@open-mercato/core/modules/data_sync/api/runs/[id]/retry'
+import { openApi as coreOpenApi } from '@open-mercato/core/modules/data_sync/api/runs/[id]/retry'
+export const openApi = coreOpenApi
+// Copied from core: the generator reads this by AST and cannot follow a re-export.
+export const metadata = {
+  POST: { requireAuth: true, requireFeatures: ['data_sync.run'] },
+}

package/src/modules/data_sync/api/runs/[id]/route.ts

@@ -0,0 +1,10 @@
+// GENERATED by scripts/gen-mirror.mjs from @open-mercato/core@0.7.0 (api/runs/[id]/route.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/api/runs/[id]/route'
+export { GET } from '@open-mercato/core/modules/data_sync/api/runs/[id]/route'
+import { openApi as coreOpenApi } from '@open-mercato/core/modules/data_sync/api/runs/[id]/route'
+export const openApi = coreOpenApi
+// Copied from core: the generator reads this by AST and cannot follow a re-export.
+export const metadata = {
+  GET: { requireAuth: true, requireFeatures: ['data_sync.view'] },
+}

package/src/modules/data_sync/api/runs.ts

@@ -0,0 +1,10 @@
+// GENERATED by scripts/gen-mirror.mjs from @open-mercato/core@0.7.0 (api/runs.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/api/runs'
+export { GET } from '@open-mercato/core/modules/data_sync/api/runs'
+import { openApi as coreOpenApi } from '@open-mercato/core/modules/data_sync/api/runs'
+export const openApi = coreOpenApi
+// Copied from core: the generator reads this by AST and cannot follow a re-export.
+export const metadata = {
+  GET: { requireAuth: true, requireFeatures: ['data_sync.view'] },
+}

package/src/modules/data_sync/api/schedules/[id]/route.ts

@@ -0,0 +1,12 @@
+// GENERATED by scripts/gen-mirror.mjs from @open-mercato/core@0.7.0 (api/schedules/[id]/route.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/api/schedules/[id]/route'
+export { GET, PUT, DELETE } from '@open-mercato/core/modules/data_sync/api/schedules/[id]/route'
+import { openApi as coreOpenApi } from '@open-mercato/core/modules/data_sync/api/schedules/[id]/route'
+export const openApi = coreOpenApi
+// Copied from core: the generator reads this by AST and cannot follow a re-export.
+export const metadata = {
+  GET: { requireAuth: true, requireFeatures: ['data_sync.configure'] },
+  PUT: { requireAuth: true, requireFeatures: ['data_sync.configure'] },
+  DELETE: { requireAuth: true, requireFeatures: ['data_sync.configure'] },
+}

package/src/modules/data_sync/api/schedules/route.ts

@@ -0,0 +1,11 @@
+// GENERATED by scripts/gen-mirror.mjs from @open-mercato/core@0.7.0 (api/schedules/route.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/api/schedules/route'
+export { GET, POST } from '@open-mercato/core/modules/data_sync/api/schedules/route'
+import { openApi as coreOpenApi } from '@open-mercato/core/modules/data_sync/api/schedules/route'
+export const openApi = coreOpenApi
+// Copied from core: the generator reads this by AST and cannot follow a re-export.
+export const metadata = {
+  GET: { requireAuth: true, requireFeatures: ['data_sync.configure'] },
+  POST: { requireAuth: true, requireFeatures: ['data_sync.configure'] },
+}

package/src/modules/data_sync/api/schedules/serialize.ts

@@ -0,0 +1,4 @@
+// GENERATED by scripts/gen-mirror.mjs from @open-mercato/core@0.7.0 (api/schedules/serialize.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/api/schedules/serialize'
+export { serializeSchedule } from '@open-mercato/core/modules/data_sync/api/schedules/serialize'

package/src/modules/data_sync/api/validate.ts

@@ -0,0 +1,10 @@
+// GENERATED by scripts/gen-mirror.mjs from @open-mercato/core@0.7.0 (api/validate.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/api/validate'
+export { POST } from '@open-mercato/core/modules/data_sync/api/validate'
+import { openApi as coreOpenApi } from '@open-mercato/core/modules/data_sync/api/validate'
+export const openApi = coreOpenApi
+// Copied from core: the generator reads this by AST and cannot follow a re-export.
+export const metadata = {
+  POST: { requireAuth: true, requireFeatures: ['data_sync.configure'] },
+}

package/src/modules/data_sync/backend/data-sync/page.meta.ts

@@ -0,0 +1,4 @@
+// GENERATED by scripts/gen-mirror.mjs from @open-mercato/core@0.7.0 (backend/data-sync/page.meta.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/backend/data-sync/page.meta'
+export { metadata } from '@open-mercato/core/modules/data_sync/backend/data-sync/page.meta'

package/src/modules/data_sync/backend/data-sync/page.tsx

@@ -0,0 +1,5 @@
+'use client'
+// GENERATED by scripts/gen-mirror.mjs from @open-mercato/core@0.7.0 (backend/data-sync/page.tsx). 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/backend/data-sync/page'
+export { default } from '@open-mercato/core/modules/data_sync/backend/data-sync/page'

package/src/modules/data_sync/backend/data-sync/runs/[id]/page.meta.ts

@@ -0,0 +1,4 @@
+// GENERATED by scripts/gen-mirror.mjs from @open-mercato/core@0.7.0 (backend/data-sync/runs/[id]/page.meta.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/backend/data-sync/runs/[id]/page.meta'
+export { metadata } from '@open-mercato/core/modules/data_sync/backend/data-sync/runs/[id]/page.meta'

package/src/modules/data_sync/backend/data-sync/runs/[id]/page.tsx

@@ -0,0 +1,5 @@
+'use client'
+// GENERATED by scripts/gen-mirror.mjs from @open-mercato/core@0.7.0 (backend/data-sync/runs/[id]/page.tsx). 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/backend/data-sync/runs/[id]/page'
+export { default } from '@open-mercato/core/modules/data_sync/backend/data-sync/runs/[id]/page'

package/src/modules/data_sync/components/IntegrationScheduleTab.tsx

@@ -0,0 +1,6 @@
+'use client'
+// GENERATED by scripts/gen-mirror.mjs from @open-mercato/core@0.7.0 (components/IntegrationScheduleTab.tsx). 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/components/IntegrationScheduleTab'
+export { default } from '@open-mercato/core/modules/data_sync/components/IntegrationScheduleTab'
+export { IntegrationScheduleTab } from '@open-mercato/core/modules/data_sync/components/IntegrationScheduleTab'

package/src/modules/data_sync/components/RunParameterFields.tsx

@@ -0,0 +1,5 @@
+'use client'
+// GENERATED by scripts/gen-mirror.mjs from @open-mercato/core@0.7.0 (components/RunParameterFields.tsx). 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/components/RunParameterFields'
+export { RunParameterFields, buildDefaultRunParameterValues, buildRetryFailureMessage, buildRunFailureMessage, buildRunParametersPayload, hasRequiredRunParameterWithoutDefault, resolveRunParameterText } from '@open-mercato/core/modules/data_sync/components/RunParameterFields'

package/src/modules/data_sync/data/entities.ts

@@ -0,0 +1,4 @@
+// GENERATED by scripts/gen-mirror.mjs from @open-mercato/core@0.7.0 (data/entities.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/data/entities'
+export { SyncCursor, SyncMapping, SyncRun, SyncSchedule } from '@open-mercato/core/modules/data_sync/data/entities'

package/src/modules/data_sync/data/validators.ts

@@ -0,0 +1,4 @@
+// GENERATED by scripts/gen-mirror.mjs from @open-mercato/core@0.7.0 (data/validators.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/data/validators'
+export { createSyncScheduleSchema, listSyncRunsQuerySchema, listSyncSchedulesQuerySchema, retrySyncSchema, runSyncSchema, updateSyncScheduleSchema, validateConnectionSchema } from '@open-mercato/core/modules/data_sync/data/validators'

package/src/modules/data_sync/di.ts

@@ -0,0 +1,57 @@
+// Core's DI, plus the two job kinds a run becomes.
+//
+// Core's registrations are reused as they are — the engine, the run service, the mapping and
+// schedule services are all core's, unchanged. The decoration that makes a run durable happens
+// per slice, inside the kind, not here (see docs/adr/0004): a container-level decoration would
+// apply to every caller of the engine, including ones not running under a lease.
+
+import type { AppContainer } from '@open-mercato/shared/lib/di/container'
+import type { EntityManager } from '@mikro-orm/postgresql'
+import { register as registerCore } from '@open-mercato/core/modules/data_sync/di'
+import { createSyncEngine } from '@open-mercato/core/modules/data_sync/lib/sync-engine'
+import { registry } from '@fullstackhouse/open-mercato-durable-work'
+
+import { dataSyncKinds } from '../../kinds/data-sync-run'
+
+/**
+ * Built once, at module scope, not once per container.
+ *
+ * `register` runs on every container build — which in a web process means every request — and
+ * the registry refuses two different handlers under one kind id, because silently accepting
+ * the second would make "which code is running this job?" depend on request ordering. Kinds
+ * created per call would be a different handler every time, so the second request would throw.
+ *
+ * Each slice resolves its own container instead, which it needs anyway: slices run in the
+ * worker process, outside any request, and each needs its own EntityManager rather than one
+ * captured from whichever request happened to build the registry first.
+ */
+const KINDS = dataSyncKinds({
+  resolve: async () => {
+    const { createRequestContainer } = await import('@open-mercato/shared/lib/di/container')
+    const container = await createRequestContainer()
+    const em = container.resolve<EntityManager>('em')
+    return {
+      runService: container.resolve('dataSyncRunService'),
+      progressService: container.resolve('progressService'),
+      engine: ({ runService, progressService }) =>
+        createSyncEngine({
+          em,
+          syncRunService: runService as never,
+          integrationCredentialsService: container.resolve('integrationCredentialsService'),
+          integrationLogService: container.resolve('integrationLogService'),
+          integrationStateService: container.resolve('integrationStateService'),
+          progressService: progressService as never,
+        }),
+    }
+  },
+})
+
+export function register(container: AppContainer) {
+  registerCore(container)
+  // Idempotent: the same handler objects every time, so re-registering is a no-op. The web
+  // process needs them to re-drive and cancel, the worker to run slices, and the reconciler to
+  // know whether a job has a handler at all.
+  for (const kind of KINDS) registry.register(kind)
+}
+
+export default register

package/src/modules/data_sync/events.ts

@@ -0,0 +1,5 @@
+// GENERATED by scripts/gen-mirror.mjs from @open-mercato/core@0.7.0 (events.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/events'
+export { default } from '@open-mercato/core/modules/data_sync/events'
+export { emitDataSyncEvent, eventsConfig } from '@open-mercato/core/modules/data_sync/events'

package/src/modules/data_sync/extension-points.ts

@@ -0,0 +1,5 @@
+// GENERATED by scripts/gen-mirror.mjs from @open-mercato/core@0.7.0 (extension-points.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/extension-points'
+export { default } from '@open-mercato/core/modules/data_sync/extension-points'
+export { extensionPoints } from '@open-mercato/core/modules/data_sync/extension-points'