@open-mercato/core 0.6.7 → 0.6.8-develop.6875.1.871a4afc94

package/dist/modules/data_sync/lib/sync-run-service.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../src/modules/data_sync/lib/sync-run-service.ts"],
-  "sourcesContent": ["import type { EntityManager, FilterQuery } from '@mikro-orm/postgresql'\nimport { findAndCountWithDecryption, findOneWithDecryption, findWithDecryption } from '@open-mercato/shared/lib/encryption/find'\nimport { withAtomicFlush } from '@open-mercato/shared/lib/commands/flush'\nimport { escapeLikePattern } from '@open-mercato/shared/lib/db/escapeLikePattern'\nimport { SyncCursor, SyncRun } from '../data/entities'\n\nconst UUID_PATTERN = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i\n\nfunction buildRunSearchFilter(search: string): FilterQuery<SyncRun>[] | null {\n  const trimmed = search.trim()\n  if (!trimmed) return null\n  const pattern = `%${escapeLikePattern(trimmed)}%`\n  const conditions: FilterQuery<SyncRun>[] = [\n    { integrationId: { $ilike: pattern } },\n    { entityType: { $ilike: pattern } },\n    { status: { $ilike: pattern } },\n  ]\n  if (UUID_PATTERN.test(trimmed)) {\n    conditions.push({ id: trimmed })\n  }\n  return conditions\n}\n\ntype SyncScope = {\n  organizationId: string\n  tenantId: string\n}\n\nexport function createSyncRunService(em: EntityManager) {\n  async function resolveCursorRow(run: SyncRun, scope: SyncScope): Promise<SyncCursor | null> {\n    return findOneWithDecryption(\n      em,\n      SyncCursor,\n      {\n        integrationId: run.integrationId,\n        entityType: run.entityType,\n        direction: run.direction,\n        organizationId: scope.organizationId,\n        tenantId: scope.tenantId,\n      },\n      undefined,\n      scope,\n    )\n  }\n\n  function applyCursorMutation(run: SyncRun, cursorRow: SyncCursor | null, cursor: string, scope: SyncScope): void {\n    run.cursor = cursor\n    if (cursorRow) {\n      cursorRow.cursor = cursor\n    } else {\n      em.create(SyncCursor, {\n        integrationId: run.integrationId,\n        entityType: run.entityType,\n        direction: run.direction,\n        cursor,\n        organizationId: scope.organizationId,\n        tenantId: scope.tenantId,\n      })\n    }\n  }\n\n  return {\n    async createRun(input: {\n      integrationId: string\n      entityType: string\n      direction: 'import' | 'export'\n      cursor?: string | null\n      triggeredBy?: string | null\n      progressJobId?: string | null\n      jobId?: string | null\n    }, scope: SyncScope): Promise<SyncRun> {\n      const row = em.create(SyncRun, {\n        integrationId: input.integrationId,\n        entityType: input.entityType,\n        direction: input.direction,\n        status: 'pending',\n        cursor: input.cursor,\n        initialCursor: input.cursor,\n        triggeredBy: input.triggeredBy,\n        progressJobId: input.progressJobId,\n        jobId: input.jobId,\n        organizationId: scope.organizationId,\n        tenantId: scope.tenantId,\n      })\n\n      await em.persist(row).flush()\n      return row\n    },\n\n    async getRun(runId: string, scope: SyncScope): Promise<SyncRun | null> {\n      return findOneWithDecryption(\n        em,\n        SyncRun,\n        {\n          id: runId,\n          organizationId: scope.organizationId,\n          tenantId: scope.tenantId,\n          deletedAt: null,\n        },\n        undefined,\n        scope,\n      )\n    },\n\n    async listRuns(query: {\n      integrationId?: string\n      entityType?: string\n      direction?: 'import' | 'export'\n      status?: string\n      search?: string\n      page: number\n      pageSize: number\n    }, scope: SyncScope): Promise<{ items: SyncRun[]; total: number }> {\n      const where: FilterQuery<SyncRun> = {\n        organizationId: scope.organizationId,\n        tenantId: scope.tenantId,\n        deletedAt: null,\n      }\n\n      if (query.integrationId) where.integrationId = query.integrationId\n      if (query.entityType) where.entityType = query.entityType\n      if (query.direction) where.direction = query.direction\n      if (query.status) where.status = query.status as SyncRun['status']\n      if (query.search) {\n        const searchConditions = buildRunSearchFilter(query.search)\n        if (searchConditions) where.$or = searchConditions\n      }\n\n      const [items, total] = await findAndCountWithDecryption(\n        em,\n        SyncRun,\n        where,\n        {\n          orderBy: { createdAt: 'DESC' },\n          limit: query.pageSize,\n          offset: (query.page - 1) * query.pageSize,\n        },\n        scope,\n      )\n\n      return { items, total }\n    },\n\n    async markStatus(runId: string, status: SyncRun['status'], scope: SyncScope, error?: string): Promise<SyncRun | null> {\n      if (status === 'running') {\n        const updated = await em.nativeUpdate(\n          SyncRun,\n          {\n            id: runId,\n            organizationId: scope.organizationId,\n            tenantId: scope.tenantId,\n            deletedAt: null,\n            status: 'pending',\n          },\n          {\n            status,\n            ...(error !== undefined ? { lastError: error } : {}),\n            updatedAt: new Date(),\n          },\n        )\n        if (updated === 0) return null\n        const row = await this.getRun(runId, scope)\n        if (row && typeof em.refresh === 'function') {\n          await em.refresh(row)\n        }\n        return row\n      }\n\n      const row = await this.getRun(runId, scope)\n      if (!row) return null\n      const isTerminal = row.status === 'completed' || row.status === 'failed' || row.status === 'cancelled'\n      if (isTerminal && row.status !== status) {\n        return row\n      }\n      row.status = status\n      if (error !== undefined) row.lastError = error\n      await em.flush()\n      return row\n    },\n\n    async updateCounts(\n      runId: string,\n      delta: Partial<Pick<SyncRun, 'createdCount' | 'updatedCount' | 'skippedCount' | 'failedCount' | 'batchesCompleted'>>,\n      scope: SyncScope,\n    ): Promise<SyncRun | null> {\n      const row = await this.getRun(runId, scope)\n      if (!row) return null\n\n      row.createdCount += delta.createdCount ?? 0\n      row.updatedCount += delta.updatedCount ?? 0\n      row.skippedCount += delta.skippedCount ?? 0\n      row.failedCount += delta.failedCount ?? 0\n      row.batchesCompleted += delta.batchesCompleted ?? 0\n      await em.flush()\n      return row\n    },\n\n    async updateCursor(runId: string, cursor: string, scope: SyncScope): Promise<void> {\n      const run = await this.getRun(runId, scope)\n      if (!run) return\n      const cursorRow = await resolveCursorRow(run, scope)\n      await withAtomicFlush(em, [\n        () => applyCursorMutation(run, cursorRow, cursor, scope),\n      ], { transaction: true })\n    },\n\n    async commitBatchProgress(\n      runId: string,\n      delta: Partial<Pick<SyncRun, 'createdCount' | 'updatedCount' | 'skippedCount' | 'failedCount' | 'batchesCompleted'>>,\n      cursor: string,\n      scope: SyncScope,\n    ): Promise<SyncRun | null> {\n      const run = await this.getRun(runId, scope)\n      if (!run) return null\n      const cursorRow = await resolveCursorRow(run, scope)\n      await withAtomicFlush(em, [\n        () => {\n          run.createdCount += delta.createdCount ?? 0\n          run.updatedCount += delta.updatedCount ?? 0\n          run.skippedCount += delta.skippedCount ?? 0\n          run.failedCount += delta.failedCount ?? 0\n          run.batchesCompleted += delta.batchesCompleted ?? 0\n          applyCursorMutation(run, cursorRow, cursor, scope)\n        },\n      ], { transaction: true })\n      return run\n    },\n\n    async resolveCursor(integrationId: string, entityType: string, direction: 'import' | 'export', scope: SyncScope): Promise<string | null> {\n      const row = await findOneWithDecryption(\n        em,\n        SyncCursor,\n        {\n        integrationId,\n        entityType,\n        direction,\n        organizationId: scope.organizationId,\n        tenantId: scope.tenantId,\n        },\n        undefined,\n        scope,\n      )\n      return row?.cursor ?? null\n    },\n\n    async findRunningOverlap(integrationId: string, entityType: string, direction: 'import' | 'export', scope: SyncScope): Promise<SyncRun | null> {\n      const [run] = await findWithDecryption(\n        em,\n        SyncRun,\n        {\n          integrationId,\n          entityType,\n          direction,\n          status: { $in: ['pending', 'running'] },\n          organizationId: scope.organizationId,\n          tenantId: scope.tenantId,\n          deletedAt: null,\n        },\n        { limit: 1 },\n        scope,\n      )\n      return run ?? null\n    },\n  }\n}\n\nexport type SyncRunService = ReturnType<typeof createSyncRunService>\n"],
-  "mappings": "AACA,SAAS,4BAA4B,uBAAuB,0BAA0B;AACtF,SAAS,uBAAuB;AAChC,SAAS,yBAAyB;AAClC,SAAS,YAAY,eAAe;AAEpC,MAAM,eAAe;AAErB,SAAS,qBAAqB,QAA+C;AAC3E,QAAM,UAAU,OAAO,KAAK;AAC5B,MAAI,CAAC,QAAS,QAAO;AACrB,QAAM,UAAU,IAAI,kBAAkB,OAAO,CAAC;AAC9C,QAAM,aAAqC;AAAA,IACzC,EAAE,eAAe,EAAE,QAAQ,QAAQ,EAAE;AAAA,IACrC,EAAE,YAAY,EAAE,QAAQ,QAAQ,EAAE;AAAA,IAClC,EAAE,QAAQ,EAAE,QAAQ,QAAQ,EAAE;AAAA,EAChC;AACA,MAAI,aAAa,KAAK,OAAO,GAAG;AAC9B,eAAW,KAAK,EAAE,IAAI,QAAQ,CAAC;AAAA,EACjC;AACA,SAAO;AACT;AAOO,SAAS,qBAAqB,IAAmB;AACtD,iBAAe,iBAAiB,KAAc,OAA8C;AAC1F,WAAO;AAAA,MACL;AAAA,MACA;AAAA,MACA;AAAA,QACE,eAAe,IAAI;AAAA,QACnB,YAAY,IAAI;AAAA,QAChB,WAAW,IAAI;AAAA,QACf,gBAAgB,MAAM;AAAA,QACtB,UAAU,MAAM;AAAA,MAClB;AAAA,MACA;AAAA,MACA;AAAA,IACF;AAAA,EACF;AAEA,WAAS,oBAAoB,KAAc,WAA8B,QAAgB,OAAwB;AAC/G,QAAI,SAAS;AACb,QAAI,WAAW;AACb,gBAAU,SAAS;AAAA,IACrB,OAAO;AACL,SAAG,OAAO,YAAY;AAAA,QACpB,eAAe,IAAI;AAAA,QACnB,YAAY,IAAI;AAAA,QAChB,WAAW,IAAI;AAAA,QACf;AAAA,QACA,gBAAgB,MAAM;AAAA,QACtB,UAAU,MAAM;AAAA,MAClB,CAAC;AAAA,IACH;AAAA,EACF;AAEA,SAAO;AAAA,IACL,MAAM,UAAU,OAQb,OAAoC;AACrC,YAAM,MAAM,GAAG,OAAO,SAAS;AAAA,QAC7B,eAAe,MAAM;AAAA,QACrB,YAAY,MAAM;AAAA,QAClB,WAAW,MAAM;AAAA,QACjB,QAAQ;AAAA,QACR,QAAQ,MAAM;AAAA,QACd,eAAe,MAAM;AAAA,QACrB,aAAa,MAAM;AAAA,QACnB,eAAe,MAAM;AAAA,QACrB,OAAO,MAAM;AAAA,QACb,gBAAgB,MAAM;AAAA,QACtB,UAAU,MAAM;AAAA,MAClB,CAAC;AAED,YAAM,GAAG,QAAQ,GAAG,EAAE,MAAM;AAC5B,aAAO;AAAA,IACT;AAAA,IAEA,MAAM,OAAO,OAAe,OAA2C;AACrE,aAAO;AAAA,QACL;AAAA,QACA;AAAA,QACA;AAAA,UACE,IAAI;AAAA,UACJ,gBAAgB,MAAM;AAAA,UACtB,UAAU,MAAM;AAAA,UAChB,WAAW;AAAA,QACb;AAAA,QACA;AAAA,QACA;AAAA,MACF;AAAA,IACF;AAAA,IAEA,MAAM,SAAS,OAQZ,OAAgE;AACjE,YAAM,QAA8B;AAAA,QAClC,gBAAgB,MAAM;AAAA,QACtB,UAAU,MAAM;AAAA,QAChB,WAAW;AAAA,MACb;AAEA,UAAI,MAAM,cAAe,OAAM,gBAAgB,MAAM;AACrD,UAAI,MAAM,WAAY,OAAM,aAAa,MAAM;AAC/C,UAAI,MAAM,UAAW,OAAM,YAAY,MAAM;AAC7C,UAAI,MAAM,OAAQ,OAAM,SAAS,MAAM;AACvC,UAAI,MAAM,QAAQ;AAChB,cAAM,mBAAmB,qBAAqB,MAAM,MAAM;AAC1D,YAAI,iBAAkB,OAAM,MAAM;AAAA,MACpC;AAEA,YAAM,CAAC,OAAO,KAAK,IAAI,MAAM;AAAA,QAC3B;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,UACE,SAAS,EAAE,WAAW,OAAO;AAAA,UAC7B,OAAO,MAAM;AAAA,UACb,SAAS,MAAM,OAAO,KAAK,MAAM;AAAA,QACnC;AAAA,QACA;AAAA,MACF;AAEA,aAAO,EAAE,OAAO,MAAM;AAAA,IACxB;AAAA,IAEA,MAAM,WAAW,OAAe,QAA2B,OAAkB,OAAyC;AACpH,UAAI,WAAW,WAAW;AACxB,cAAM,UAAU,MAAM,GAAG;AAAA,UACvB;AAAA,UACA;AAAA,YACE,IAAI;AAAA,YACJ,gBAAgB,MAAM;AAAA,YACtB,UAAU,MAAM;AAAA,YAChB,WAAW;AAAA,YACX,QAAQ;AAAA,UACV;AAAA,UACA;AAAA,YACE;AAAA,YACA,GAAI,UAAU,SAAY,EAAE,WAAW,MAAM,IAAI,CAAC;AAAA,YAClD,WAAW,oBAAI,KAAK;AAAA,UACtB;AAAA,QACF;AACA,YAAI,YAAY,EAAG,QAAO;AAC1B,cAAMA,OAAM,MAAM,KAAK,OAAO,OAAO,KAAK;AAC1C,YAAIA,QAAO,OAAO,GAAG,YAAY,YAAY;AAC3C,gBAAM,GAAG,QAAQA,IAAG;AAAA,QACtB;AACA,eAAOA;AAAA,MACT;AAEA,YAAM,MAAM,MAAM,KAAK,OAAO,OAAO,KAAK;AAC1C,UAAI,CAAC,IAAK,QAAO;AACjB,YAAM,aAAa,IAAI,WAAW,eAAe,IAAI,WAAW,YAAY,IAAI,WAAW;AAC3F,UAAI,cAAc,IAAI,WAAW,QAAQ;AACvC,eAAO;AAAA,MACT;AACA,UAAI,SAAS;AACb,UAAI,UAAU,OAAW,KAAI,YAAY;AACzC,YAAM,GAAG,MAAM;AACf,aAAO;AAAA,IACT;AAAA,IAEA,MAAM,aACJ,OACA,OACA,OACyB;AACzB,YAAM,MAAM,MAAM,KAAK,OAAO,OAAO,KAAK;AAC1C,UAAI,CAAC,IAAK,QAAO;AAEjB,UAAI,gBAAgB,MAAM,gBAAgB;AAC1C,UAAI,gBAAgB,MAAM,gBAAgB;AAC1C,UAAI,gBAAgB,MAAM,gBAAgB;AAC1C,UAAI,eAAe,MAAM,eAAe;AACxC,UAAI,oBAAoB,MAAM,oBAAoB;AAClD,YAAM,GAAG,MAAM;AACf,aAAO;AAAA,IACT;AAAA,IAEA,MAAM,aAAa,OAAe,QAAgB,OAAiC;AACjF,YAAM,MAAM,MAAM,KAAK,OAAO,OAAO,KAAK;AAC1C,UAAI,CAAC,IAAK;AACV,YAAM,YAAY,MAAM,iBAAiB,KAAK,KAAK;AACnD,YAAM,gBAAgB,IAAI;AAAA,QACxB,MAAM,oBAAoB,KAAK,WAAW,QAAQ,KAAK;AAAA,MACzD,GAAG,EAAE,aAAa,KAAK,CAAC;AAAA,IAC1B;AAAA,IAEA,MAAM,oBACJ,OACA,OACA,QACA,OACyB;AACzB,YAAM,MAAM,MAAM,KAAK,OAAO,OAAO,KAAK;AAC1C,UAAI,CAAC,IAAK,QAAO;AACjB,YAAM,YAAY,MAAM,iBAAiB,KAAK,KAAK;AACnD,YAAM,gBAAgB,IAAI;AAAA,QACxB,MAAM;AACJ,cAAI,gBAAgB,MAAM,gBAAgB;AAC1C,cAAI,gBAAgB,MAAM,gBAAgB;AAC1C,cAAI,gBAAgB,MAAM,gBAAgB;AAC1C,cAAI,eAAe,MAAM,eAAe;AACxC,cAAI,oBAAoB,MAAM,oBAAoB;AAClD,8BAAoB,KAAK,WAAW,QAAQ,KAAK;AAAA,QACnD;AAAA,MACF,GAAG,EAAE,aAAa,KAAK,CAAC;AACxB,aAAO;AAAA,IACT;AAAA,IAEA,MAAM,cAAc,eAAuB,YAAoB,WAAgC,OAA0C;AACvI,YAAM,MAAM,MAAM;AAAA,QAChB;AAAA,QACA;AAAA,QACA;AAAA,UACA;AAAA,UACA;AAAA,UACA;AAAA,UACA,gBAAgB,MAAM;AAAA,UACtB,UAAU,MAAM;AAAA,QAChB;AAAA,QACA;AAAA,QACA;AAAA,MACF;AACA,aAAO,KAAK,UAAU;AAAA,IACxB;AAAA,IAEA,MAAM,mBAAmB,eAAuB,YAAoB,WAAgC,OAA2C;AAC7I,YAAM,CAAC,GAAG,IAAI,MAAM;AAAA,QAClB;AAAA,QACA;AAAA,QACA;AAAA,UACE;AAAA,UACA;AAAA,UACA;AAAA,UACA,QAAQ,EAAE,KAAK,CAAC,WAAW,SAAS,EAAE;AAAA,UACtC,gBAAgB,MAAM;AAAA,UACtB,UAAU,MAAM;AAAA,UAChB,WAAW;AAAA,QACb;AAAA,QACA,EAAE,OAAO,EAAE;AAAA,QACX;AAAA,MACF;AACA,aAAO,OAAO;AAAA,IAChB;AAAA,EACF;AACF;",
+  "sourcesContent": ["import type { EntityManager, FilterQuery } from '@mikro-orm/postgresql'\nimport { findAndCountWithDecryption, findOneWithDecryption, findWithDecryption } from '@open-mercato/shared/lib/encryption/find'\nimport { withAtomicFlush } from '@open-mercato/shared/lib/commands/flush'\nimport { escapeLikePattern } from '@open-mercato/shared/lib/db/escapeLikePattern'\nimport { SyncCursor, SyncRun } from '../data/entities'\n\nconst UUID_PATTERN = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i\n\nfunction buildRunSearchFilter(search: string): FilterQuery<SyncRun>[] | null {\n  const trimmed = search.trim()\n  if (!trimmed) return null\n  const pattern = `%${escapeLikePattern(trimmed)}%`\n  const conditions: FilterQuery<SyncRun>[] = [\n    { integrationId: { $ilike: pattern } },\n    { entityType: { $ilike: pattern } },\n    { status: { $ilike: pattern } },\n  ]\n  if (UUID_PATTERN.test(trimmed)) {\n    conditions.push({ id: trimmed })\n  }\n  return conditions\n}\n\ntype SyncScope = {\n  organizationId: string\n  tenantId: string\n}\n\n/**\n * Raised when a batch commit loses the ownership compare-and-swap, meaning\n * another delivery of the same job advanced the run while this worker was\n * streaming.\n *\n * BullMQ guarantees at-least-once delivery: a job whose lock is not renewed is\n * redelivered under the SAME job id, whether the previous worker died or is only\n * blocked. No identity token can tell those apart, so ownership is enforced here\n * \u2014 on the write that matters \u2014 instead of at claim time. The loser aborts and\n * leaves the run to the worker that is still making progress.\n */\nexport class SyncRunOwnershipConflictError extends Error {\n  constructor(\n    readonly runId: string,\n    readonly expectedBatchesCompleted: number,\n  ) {\n    super(`[internal] Sync run ${runId} advanced past batch ${expectedBatchesCompleted} under a concurrent worker`)\n    this.name = 'SyncRunOwnershipConflictError'\n  }\n}\n\nexport function createSyncRunService(em: EntityManager) {\n  async function resolveCursorRow(run: SyncRun, scope: SyncScope): Promise<SyncCursor | null> {\n    return findOneWithDecryption(\n      em,\n      SyncCursor,\n      {\n        integrationId: run.integrationId,\n        entityType: run.entityType,\n        direction: run.direction,\n        organizationId: scope.organizationId,\n        tenantId: scope.tenantId,\n      },\n      undefined,\n      scope,\n    )\n  }\n\n  function applyCursorMutation(run: SyncRun, cursorRow: SyncCursor | null, cursor: string, scope: SyncScope): void {\n    run.cursor = cursor\n    if (cursorRow) {\n      cursorRow.cursor = cursor\n    } else {\n      em.create(SyncCursor, {\n        integrationId: run.integrationId,\n        entityType: run.entityType,\n        direction: run.direction,\n        cursor,\n        organizationId: scope.organizationId,\n        tenantId: scope.tenantId,\n      })\n    }\n  }\n\n  return {\n    async createRun(input: {\n      integrationId: string\n      entityType: string\n      direction: 'import' | 'export'\n      cursor?: string | null\n      triggeredBy?: string | null\n      progressJobId?: string | null\n      jobId?: string | null\n    }, scope: SyncScope): Promise<SyncRun> {\n      const row = em.create(SyncRun, {\n        integrationId: input.integrationId,\n        entityType: input.entityType,\n        direction: input.direction,\n        status: 'pending',\n        cursor: input.cursor,\n        initialCursor: input.cursor,\n        triggeredBy: input.triggeredBy,\n        progressJobId: input.progressJobId,\n        jobId: input.jobId,\n        organizationId: scope.organizationId,\n        tenantId: scope.tenantId,\n      })\n\n      await em.persist(row).flush()\n      return row\n    },\n\n    async getRun(runId: string, scope: SyncScope): Promise<SyncRun | null> {\n      return findOneWithDecryption(\n        em,\n        SyncRun,\n        {\n          id: runId,\n          organizationId: scope.organizationId,\n          tenantId: scope.tenantId,\n          deletedAt: null,\n        },\n        undefined,\n        scope,\n      )\n    },\n\n    async listRuns(query: {\n      integrationId?: string\n      entityType?: string\n      direction?: 'import' | 'export'\n      status?: string\n      search?: string\n      page: number\n      pageSize: number\n    }, scope: SyncScope): Promise<{ items: SyncRun[]; total: number }> {\n      const where: FilterQuery<SyncRun> = {\n        organizationId: scope.organizationId,\n        tenantId: scope.tenantId,\n        deletedAt: null,\n      }\n\n      if (query.integrationId) where.integrationId = query.integrationId\n      if (query.entityType) where.entityType = query.entityType\n      if (query.direction) where.direction = query.direction\n      if (query.status) where.status = query.status as SyncRun['status']\n      if (query.search) {\n        const searchConditions = buildRunSearchFilter(query.search)\n        if (searchConditions) where.$or = searchConditions\n      }\n\n      const [items, total] = await findAndCountWithDecryption(\n        em,\n        SyncRun,\n        where,\n        {\n          orderBy: { createdAt: 'DESC' },\n          limit: query.pageSize,\n          offset: (query.page - 1) * query.pageSize,\n        },\n        scope,\n      )\n\n      return { items, total }\n    },\n\n    async markStatus(runId: string, status: SyncRun['status'], scope: SyncScope, error?: string): Promise<SyncRun | null> {\n      if (status === 'running') {\n        const updated = await em.nativeUpdate(\n          SyncRun,\n          {\n            id: runId,\n            organizationId: scope.organizationId,\n            tenantId: scope.tenantId,\n            deletedAt: null,\n            // A BullMQ stalled-job redelivery finds the run in `running` after\n            // the previous worker was hard-killed. Treat that transition as an\n            // idempotent claim while still excluding terminal states so a\n            // cancelled or completed run cannot be revived.\n            status: { $in: ['pending', 'running'] },\n          },\n          {\n            status,\n            ...(error !== undefined ? { lastError: error } : {}),\n            updatedAt: new Date(),\n          },\n        )\n        if (updated === 0) return null\n        const row = await this.getRun(runId, scope)\n        if (row && typeof em.refresh === 'function') {\n          await em.refresh(row)\n        }\n        return row\n      }\n\n      const row = await this.getRun(runId, scope)\n      if (!row) return null\n      const isTerminal = row.status === 'completed' || row.status === 'failed' || row.status === 'cancelled'\n      if (isTerminal && row.status !== status) {\n        return row\n      }\n      row.status = status\n      if (error !== undefined) row.lastError = error\n      await em.flush()\n      return row\n    },\n\n    /**\n     * @deprecated Use {@link commitBatchProgress}, which writes counters and\n     * cursor in one transaction behind the ownership fence. This method updates\n     * counters unfenced, so two deliveries of the same job can lose each other's\n     * increments. Kept for external callers only.\n     */\n    async updateCounts(\n      runId: string,\n      delta: Partial<Pick<SyncRun, 'createdCount' | 'updatedCount' | 'skippedCount' | 'failedCount' | 'batchesCompleted'>>,\n      scope: SyncScope,\n    ): Promise<SyncRun | null> {\n      const row = await this.getRun(runId, scope)\n      if (!row) return null\n\n      row.createdCount += delta.createdCount ?? 0\n      row.updatedCount += delta.updatedCount ?? 0\n      row.skippedCount += delta.skippedCount ?? 0\n      row.failedCount += delta.failedCount ?? 0\n      row.batchesCompleted += delta.batchesCompleted ?? 0\n      await em.flush()\n      return row\n    },\n\n    /**\n     * @deprecated Use {@link commitBatchProgress}. This method advances the\n     * cursor without the ownership fence, so a stale delivery can move the\n     * cursor of a run another worker owns. Kept for external callers only.\n     */\n    async updateCursor(runId: string, cursor: string, scope: SyncScope): Promise<void> {\n      const run = await this.getRun(runId, scope)\n      if (!run) return\n      const cursorRow = await resolveCursorRow(run, scope)\n      await withAtomicFlush(em, [\n        () => applyCursorMutation(run, cursorRow, cursor, scope),\n      ], { transaction: true })\n    },\n\n    /**\n     * Commits one batch's counters and cursor in a single transaction.\n     *\n     * Passing `expectedBatchesCompleted` fences the write: the run must still be\n     * `running` and still sit on that batch count, or another delivery of the\n     * same BullMQ job owns the run and this commit throws\n     * `SyncRunOwnershipConflictError` and rolls back. Omitting it keeps the\n     * legacy unguarded write for callers outside the engine.\n     *\n     * The fence token is `batchesCompleted` rather than `cursor` because it\n     * advances by construction on every commit. A cursor is a free-form adapter\n     * string that an adapter may legitimately repeat between batches \u2014 the\n     * Akeneo products adapter does, between its final page and the\n     * reconciliation batch that follows it \u2014 and a repeated token fences\n     * nothing.\n     *\n     * The guard's `UPDATE` also holds the row lock for the rest of the\n     * transaction, so a competing commit blocks here and then re-reads the\n     * advanced count instead of interleaving with this one. That is what lets\n     * the counters below stay a plain read-modify-write against the snapshot\n     * read above: a commit that wins the fence has proven that nothing else\n     * landed since it read.\n     */\n    async commitBatchProgress(\n      runId: string,\n      delta: Partial<Pick<SyncRun, 'createdCount' | 'updatedCount' | 'skippedCount' | 'failedCount' | 'batchesCompleted'>>,\n      cursor: string,\n      scope: SyncScope,\n      expectedBatchesCompleted?: number,\n    ): Promise<SyncRun | null> {\n      const run = await this.getRun(runId, scope)\n      if (!run) return null\n      const cursorRow = await resolveCursorRow(run, scope)\n      const claimRunOwnership = async () => {\n        if ((delta.batchesCompleted ?? 0) < 1) {\n          throw new Error(`[internal] A fenced commit for sync run ${runId} must advance batchesCompleted`)\n        }\n        const owned = await em.nativeUpdate(\n          SyncRun,\n          {\n            id: runId,\n            organizationId: scope.organizationId,\n            tenantId: scope.tenantId,\n            deletedAt: null,\n            status: 'running',\n            batchesCompleted: expectedBatchesCompleted,\n          },\n          { updatedAt: new Date() },\n        )\n        if (owned === 0) {\n          throw new SyncRunOwnershipConflictError(runId, expectedBatchesCompleted ?? 0)\n        }\n      }\n      await withAtomicFlush(em, [\n        ...(expectedBatchesCompleted === undefined ? [] : [claimRunOwnership]),\n        () => {\n          run.createdCount += delta.createdCount ?? 0\n          run.updatedCount += delta.updatedCount ?? 0\n          run.skippedCount += delta.skippedCount ?? 0\n          run.failedCount += delta.failedCount ?? 0\n          run.batchesCompleted += delta.batchesCompleted ?? 0\n          applyCursorMutation(run, cursorRow, cursor, scope)\n        },\n      ], { transaction: true })\n      return run\n    },\n\n    async resolveCursor(integrationId: string, entityType: string, direction: 'import' | 'export', scope: SyncScope): Promise<string | null> {\n      const row = await findOneWithDecryption(\n        em,\n        SyncCursor,\n        {\n        integrationId,\n        entityType,\n        direction,\n        organizationId: scope.organizationId,\n        tenantId: scope.tenantId,\n        },\n        undefined,\n        scope,\n      )\n      return row?.cursor ?? null\n    },\n\n    async findRunningOverlap(integrationId: string, entityType: string, direction: 'import' | 'export', scope: SyncScope): Promise<SyncRun | null> {\n      const [run] = await findWithDecryption(\n        em,\n        SyncRun,\n        {\n          integrationId,\n          entityType,\n          direction,\n          status: { $in: ['pending', 'running'] },\n          organizationId: scope.organizationId,\n          tenantId: scope.tenantId,\n          deletedAt: null,\n        },\n        { limit: 1 },\n        scope,\n      )\n      return run ?? null\n    },\n  }\n}\n\nexport type SyncRunService = ReturnType<typeof createSyncRunService>\n"],
+  "mappings": "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",
   "names": ["row"]
 }

package/dist/modules/data_sync/workers/sync-export.js

@@ -1,9 +1,16 @@
+import {
+  DATA_SYNC_EXPORT_QUEUE,
+  DATA_SYNC_LOCK_DURATION_MS,
+  DATA_SYNC_MAX_STALLED_COUNT
+} from "../lib/queue-policy.js";
 import { createLogger } from "@open-mercato/shared/lib/logger";
 const logger = createLogger("data_sync").child({ component: "sync-export" });
 const metadata = {
-  queue: "data-sync-export",
+  queue: DATA_SYNC_EXPORT_QUEUE,
   id: "data-sync:export",
-  concurrency: 5
+  concurrency: 5,
+  lockDuration: DATA_SYNC_LOCK_DURATION_MS,
+  maxStalledCount: DATA_SYNC_MAX_STALLED_COUNT
 };
 async function handle(job, ctx) {
   try {

package/dist/modules/data_sync/workers/sync-export.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../src/modules/data_sync/workers/sync-export.ts"],
-  "sourcesContent": ["import type { JobContext, QueuedJob, WorkerMeta } from '@open-mercato/queue'\nimport type { ProgressService } from '../../progress/lib/progressService'\nimport type { SyncEngine } from '../lib/sync-engine'\nimport type { SyncRunService } from '../lib/sync-run-service'\nimport { createLogger } from '@open-mercato/shared/lib/logger'\n\nconst logger = createLogger('data_sync').child({ component: 'sync-export' })\n\ntype SyncJobPayload = {\n  runId: string\n  batchSize: number\n  scope: {\n    organizationId: string\n    tenantId: string\n    userId?: string | null\n  }\n}\n\nexport const metadata: WorkerMeta = {\n  queue: 'data-sync-export',\n  id: 'data-sync:export',\n  concurrency: 5,\n}\n\ntype HandlerContext = JobContext & {\n  resolve: <T = unknown>(name: string) => T\n}\n\nexport default async function handle(job: QueuedJob<SyncJobPayload>, ctx: HandlerContext): Promise<void> {\n  try {\n    const engine = ctx.resolve<SyncEngine>('dataSyncEngine')\n    await engine.runExport(job.payload.runId, job.payload.batchSize, job.payload.scope)\n  } catch (error) {\n    const message = error instanceof Error ? error.message : 'Data sync export worker failed'\n    const errorStack = error instanceof Error ? error.stack : undefined\n\n    try {\n      const syncRunService = ctx.resolve<SyncRunService>('dataSyncRunService')\n      const progressService = ctx.resolve<ProgressService>('progressService')\n      const run = await syncRunService.getRun(job.payload.runId, job.payload.scope)\n\n      if (run && run.status !== 'completed' && run.status !== 'failed' && run.status !== 'cancelled') {\n        await syncRunService.markStatus(run.id, 'failed', job.payload.scope, message)\n        if (run.progressJobId) {\n          await progressService.failJob(\n            run.progressJobId,\n            {\n              errorMessage: message,\n              errorStack,\n            },\n            job.payload.scope,\n          )\n        }\n      }\n    } catch (finalizeError) {\n      logger.error('Failed to finalize crashed export worker job', { err: finalizeError })\n    }\n\n    throw error\n  }\n}\n"],
-  "mappings": "AAIA,SAAS,oBAAoB;AAE7B,MAAM,SAAS,aAAa,WAAW,EAAE,MAAM,EAAE,WAAW,cAAc,CAAC;AAYpE,MAAM,WAAuB;AAAA,EAClC,OAAO;AAAA,EACP,IAAI;AAAA,EACJ,aAAa;AACf;AAMA,eAAO,OAA8B,KAAgC,KAAoC;AACvG,MAAI;AACF,UAAM,SAAS,IAAI,QAAoB,gBAAgB;AACvD,UAAM,OAAO,UAAU,IAAI,QAAQ,OAAO,IAAI,QAAQ,WAAW,IAAI,QAAQ,KAAK;AAAA,EACpF,SAAS,OAAO;AACd,UAAM,UAAU,iBAAiB,QAAQ,MAAM,UAAU;AACzD,UAAM,aAAa,iBAAiB,QAAQ,MAAM,QAAQ;AAE1D,QAAI;AACF,YAAM,iBAAiB,IAAI,QAAwB,oBAAoB;AACvE,YAAM,kBAAkB,IAAI,QAAyB,iBAAiB;AACtE,YAAM,MAAM,MAAM,eAAe,OAAO,IAAI,QAAQ,OAAO,IAAI,QAAQ,KAAK;AAE5E,UAAI,OAAO,IAAI,WAAW,eAAe,IAAI,WAAW,YAAY,IAAI,WAAW,aAAa;AAC9F,cAAM,eAAe,WAAW,IAAI,IAAI,UAAU,IAAI,QAAQ,OAAO,OAAO;AAC5E,YAAI,IAAI,eAAe;AACrB,gBAAM,gBAAgB;AAAA,YACpB,IAAI;AAAA,YACJ;AAAA,cACE,cAAc;AAAA,cACd;AAAA,YACF;AAAA,YACA,IAAI,QAAQ;AAAA,UACd;AAAA,QACF;AAAA,MACF;AAAA,IACF,SAAS,eAAe;AACtB,aAAO,MAAM,gDAAgD,EAAE,KAAK,cAAc,CAAC;AAAA,IACrF;AAEA,UAAM;AAAA,EACR;AACF;",
+  "sourcesContent": ["import type { JobContext, QueuedJob, WorkerMeta } from '@open-mercato/queue'\nimport type { ProgressService } from '../../progress/lib/progressService'\nimport type { SyncEngine } from '../lib/sync-engine'\nimport type { SyncRunService } from '../lib/sync-run-service'\nimport {\n  DATA_SYNC_EXPORT_QUEUE,\n  DATA_SYNC_LOCK_DURATION_MS,\n  DATA_SYNC_MAX_STALLED_COUNT,\n} from '../lib/queue-policy'\nimport { createLogger } from '@open-mercato/shared/lib/logger'\n\nconst logger = createLogger('data_sync').child({ component: 'sync-export' })\n\ntype SyncJobPayload = {\n  runId: string\n  batchSize: number\n  scope: {\n    organizationId: string\n    tenantId: string\n    userId?: string | null\n  }\n}\n\nexport const metadata: WorkerMeta = {\n  queue: DATA_SYNC_EXPORT_QUEUE,\n  id: 'data-sync:export',\n  concurrency: 5,\n  lockDuration: DATA_SYNC_LOCK_DURATION_MS,\n  maxStalledCount: DATA_SYNC_MAX_STALLED_COUNT,\n}\n\ntype HandlerContext = JobContext & {\n  resolve: <T = unknown>(name: string) => T\n}\n\nexport default async function handle(job: QueuedJob<SyncJobPayload>, ctx: HandlerContext): Promise<void> {\n  try {\n    const engine = ctx.resolve<SyncEngine>('dataSyncEngine')\n    await engine.runExport(job.payload.runId, job.payload.batchSize, job.payload.scope)\n  } catch (error) {\n    const message = error instanceof Error ? error.message : 'Data sync export worker failed'\n    const errorStack = error instanceof Error ? error.stack : undefined\n\n    try {\n      const syncRunService = ctx.resolve<SyncRunService>('dataSyncRunService')\n      const progressService = ctx.resolve<ProgressService>('progressService')\n      const run = await syncRunService.getRun(job.payload.runId, job.payload.scope)\n\n      if (run && run.status !== 'completed' && run.status !== 'failed' && run.status !== 'cancelled') {\n        await syncRunService.markStatus(run.id, 'failed', job.payload.scope, message)\n        if (run.progressJobId) {\n          await progressService.failJob(\n            run.progressJobId,\n            {\n              errorMessage: message,\n              errorStack,\n            },\n            job.payload.scope,\n          )\n        }\n      }\n    } catch (finalizeError) {\n      logger.error('Failed to finalize crashed export worker job', { err: finalizeError })\n    }\n\n    throw error\n  }\n}\n"],
+  "mappings": "AAIA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OACK;AACP,SAAS,oBAAoB;AAE7B,MAAM,SAAS,aAAa,WAAW,EAAE,MAAM,EAAE,WAAW,cAAc,CAAC;AAYpE,MAAM,WAAuB;AAAA,EAClC,OAAO;AAAA,EACP,IAAI;AAAA,EACJ,aAAa;AAAA,EACb,cAAc;AAAA,EACd,iBAAiB;AACnB;AAMA,eAAO,OAA8B,KAAgC,KAAoC;AACvG,MAAI;AACF,UAAM,SAAS,IAAI,QAAoB,gBAAgB;AACvD,UAAM,OAAO,UAAU,IAAI,QAAQ,OAAO,IAAI,QAAQ,WAAW,IAAI,QAAQ,KAAK;AAAA,EACpF,SAAS,OAAO;AACd,UAAM,UAAU,iBAAiB,QAAQ,MAAM,UAAU;AACzD,UAAM,aAAa,iBAAiB,QAAQ,MAAM,QAAQ;AAE1D,QAAI;AACF,YAAM,iBAAiB,IAAI,QAAwB,oBAAoB;AACvE,YAAM,kBAAkB,IAAI,QAAyB,iBAAiB;AACtE,YAAM,MAAM,MAAM,eAAe,OAAO,IAAI,QAAQ,OAAO,IAAI,QAAQ,KAAK;AAE5E,UAAI,OAAO,IAAI,WAAW,eAAe,IAAI,WAAW,YAAY,IAAI,WAAW,aAAa;AAC9F,cAAM,eAAe,WAAW,IAAI,IAAI,UAAU,IAAI,QAAQ,OAAO,OAAO;AAC5E,YAAI,IAAI,eAAe;AACrB,gBAAM,gBAAgB;AAAA,YACpB,IAAI;AAAA,YACJ;AAAA,cACE,cAAc;AAAA,cACd;AAAA,YACF;AAAA,YACA,IAAI,QAAQ;AAAA,UACd;AAAA,QACF;AAAA,MACF;AAAA,IACF,SAAS,eAAe;AACtB,aAAO,MAAM,gDAAgD,EAAE,KAAK,cAAc,CAAC;AAAA,IACrF;AAEA,UAAM;AAAA,EACR;AACF;",
   "names": []
 }

package/dist/modules/data_sync/workers/sync-import.js

@@ -1,9 +1,16 @@
+import {
+  DATA_SYNC_IMPORT_QUEUE,
+  DATA_SYNC_LOCK_DURATION_MS,
+  DATA_SYNC_MAX_STALLED_COUNT
+} from "../lib/queue-policy.js";
 import { createLogger } from "@open-mercato/shared/lib/logger";
 const logger = createLogger("data_sync").child({ component: "sync-import" });
 const metadata = {
-  queue: "data-sync-import",
+  queue: DATA_SYNC_IMPORT_QUEUE,
   id: "data-sync:import",
-  concurrency: 5
+  concurrency: 5,
+  lockDuration: DATA_SYNC_LOCK_DURATION_MS,
+  maxStalledCount: DATA_SYNC_MAX_STALLED_COUNT
 };
 async function handle(job, ctx) {
   try {

package/dist/modules/data_sync/workers/sync-import.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../src/modules/data_sync/workers/sync-import.ts"],
-  "sourcesContent": ["import type { JobContext, QueuedJob, WorkerMeta } from '@open-mercato/queue'\nimport type { ProgressService } from '../../progress/lib/progressService'\nimport type { SyncEngine } from '../lib/sync-engine'\nimport type { SyncRunService } from '../lib/sync-run-service'\nimport { createLogger } from '@open-mercato/shared/lib/logger'\n\nconst logger = createLogger('data_sync').child({ component: 'sync-import' })\n\ntype SyncJobPayload = {\n  runId: string\n  batchSize: number\n  scope: {\n    organizationId: string\n    tenantId: string\n    userId?: string | null\n  }\n}\n\nexport const metadata: WorkerMeta = {\n  queue: 'data-sync-import',\n  id: 'data-sync:import',\n  concurrency: 5,\n}\n\ntype HandlerContext = JobContext & {\n  resolve: <T = unknown>(name: string) => T\n}\n\nexport default async function handle(job: QueuedJob<SyncJobPayload>, ctx: HandlerContext): Promise<void> {\n  try {\n    const engine = ctx.resolve<SyncEngine>('dataSyncEngine')\n    await engine.runImport(job.payload.runId, job.payload.batchSize, job.payload.scope)\n  } catch (error) {\n    const message = error instanceof Error ? error.message : 'Data sync import worker failed'\n    const errorStack = error instanceof Error ? error.stack : undefined\n\n    try {\n      const syncRunService = ctx.resolve<SyncRunService>('dataSyncRunService')\n      const progressService = ctx.resolve<ProgressService>('progressService')\n      const run = await syncRunService.getRun(job.payload.runId, job.payload.scope)\n\n      if (run && run.status !== 'completed' && run.status !== 'failed' && run.status !== 'cancelled') {\n        await syncRunService.markStatus(run.id, 'failed', job.payload.scope, message)\n        if (run.progressJobId) {\n          await progressService.failJob(\n            run.progressJobId,\n            {\n              errorMessage: message,\n              errorStack,\n            },\n            job.payload.scope,\n          )\n        }\n      }\n    } catch (finalizeError) {\n      logger.error('Failed to finalize crashed import worker job', { err: finalizeError })\n    }\n\n    throw error\n  }\n}\n"],
-  "mappings": "AAIA,SAAS,oBAAoB;AAE7B,MAAM,SAAS,aAAa,WAAW,EAAE,MAAM,EAAE,WAAW,cAAc,CAAC;AAYpE,MAAM,WAAuB;AAAA,EAClC,OAAO;AAAA,EACP,IAAI;AAAA,EACJ,aAAa;AACf;AAMA,eAAO,OAA8B,KAAgC,KAAoC;AACvG,MAAI;AACF,UAAM,SAAS,IAAI,QAAoB,gBAAgB;AACvD,UAAM,OAAO,UAAU,IAAI,QAAQ,OAAO,IAAI,QAAQ,WAAW,IAAI,QAAQ,KAAK;AAAA,EACpF,SAAS,OAAO;AACd,UAAM,UAAU,iBAAiB,QAAQ,MAAM,UAAU;AACzD,UAAM,aAAa,iBAAiB,QAAQ,MAAM,QAAQ;AAE1D,QAAI;AACF,YAAM,iBAAiB,IAAI,QAAwB,oBAAoB;AACvE,YAAM,kBAAkB,IAAI,QAAyB,iBAAiB;AACtE,YAAM,MAAM,MAAM,eAAe,OAAO,IAAI,QAAQ,OAAO,IAAI,QAAQ,KAAK;AAE5E,UAAI,OAAO,IAAI,WAAW,eAAe,IAAI,WAAW,YAAY,IAAI,WAAW,aAAa;AAC9F,cAAM,eAAe,WAAW,IAAI,IAAI,UAAU,IAAI,QAAQ,OAAO,OAAO;AAC5E,YAAI,IAAI,eAAe;AACrB,gBAAM,gBAAgB;AAAA,YACpB,IAAI;AAAA,YACJ;AAAA,cACE,cAAc;AAAA,cACd;AAAA,YACF;AAAA,YACA,IAAI,QAAQ;AAAA,UACd;AAAA,QACF;AAAA,MACF;AAAA,IACF,SAAS,eAAe;AACtB,aAAO,MAAM,gDAAgD,EAAE,KAAK,cAAc,CAAC;AAAA,IACrF;AAEA,UAAM;AAAA,EACR;AACF;",
+  "sourcesContent": ["import type { JobContext, QueuedJob, WorkerMeta } from '@open-mercato/queue'\nimport type { ProgressService } from '../../progress/lib/progressService'\nimport type { SyncEngine } from '../lib/sync-engine'\nimport type { SyncRunService } from '../lib/sync-run-service'\nimport {\n  DATA_SYNC_IMPORT_QUEUE,\n  DATA_SYNC_LOCK_DURATION_MS,\n  DATA_SYNC_MAX_STALLED_COUNT,\n} from '../lib/queue-policy'\nimport { createLogger } from '@open-mercato/shared/lib/logger'\n\nconst logger = createLogger('data_sync').child({ component: 'sync-import' })\n\ntype SyncJobPayload = {\n  runId: string\n  batchSize: number\n  scope: {\n    organizationId: string\n    tenantId: string\n    userId?: string | null\n  }\n}\n\nexport const metadata: WorkerMeta = {\n  queue: DATA_SYNC_IMPORT_QUEUE,\n  id: 'data-sync:import',\n  concurrency: 5,\n  lockDuration: DATA_SYNC_LOCK_DURATION_MS,\n  maxStalledCount: DATA_SYNC_MAX_STALLED_COUNT,\n}\n\ntype HandlerContext = JobContext & {\n  resolve: <T = unknown>(name: string) => T\n}\n\nexport default async function handle(job: QueuedJob<SyncJobPayload>, ctx: HandlerContext): Promise<void> {\n  try {\n    const engine = ctx.resolve<SyncEngine>('dataSyncEngine')\n    await engine.runImport(job.payload.runId, job.payload.batchSize, job.payload.scope)\n  } catch (error) {\n    const message = error instanceof Error ? error.message : 'Data sync import worker failed'\n    const errorStack = error instanceof Error ? error.stack : undefined\n\n    try {\n      const syncRunService = ctx.resolve<SyncRunService>('dataSyncRunService')\n      const progressService = ctx.resolve<ProgressService>('progressService')\n      const run = await syncRunService.getRun(job.payload.runId, job.payload.scope)\n\n      if (run && run.status !== 'completed' && run.status !== 'failed' && run.status !== 'cancelled') {\n        await syncRunService.markStatus(run.id, 'failed', job.payload.scope, message)\n        if (run.progressJobId) {\n          await progressService.failJob(\n            run.progressJobId,\n            {\n              errorMessage: message,\n              errorStack,\n            },\n            job.payload.scope,\n          )\n        }\n      }\n    } catch (finalizeError) {\n      logger.error('Failed to finalize crashed import worker job', { err: finalizeError })\n    }\n\n    throw error\n  }\n}\n"],
+  "mappings": "AAIA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OACK;AACP,SAAS,oBAAoB;AAE7B,MAAM,SAAS,aAAa,WAAW,EAAE,MAAM,EAAE,WAAW,cAAc,CAAC;AAYpE,MAAM,WAAuB;AAAA,EAClC,OAAO;AAAA,EACP,IAAI;AAAA,EACJ,aAAa;AAAA,EACb,cAAc;AAAA,EACd,iBAAiB;AACnB;AAMA,eAAO,OAA8B,KAAgC,KAAoC;AACvG,MAAI;AACF,UAAM,SAAS,IAAI,QAAoB,gBAAgB;AACvD,UAAM,OAAO,UAAU,IAAI,QAAQ,OAAO,IAAI,QAAQ,WAAW,IAAI,QAAQ,KAAK;AAAA,EACpF,SAAS,OAAO;AACd,UAAM,UAAU,iBAAiB,QAAQ,MAAM,UAAU;AACzD,UAAM,aAAa,iBAAiB,QAAQ,MAAM,QAAQ;AAE1D,QAAI;AACF,YAAM,iBAAiB,IAAI,QAAwB,oBAAoB;AACvE,YAAM,kBAAkB,IAAI,QAAyB,iBAAiB;AACtE,YAAM,MAAM,MAAM,eAAe,OAAO,IAAI,QAAQ,OAAO,IAAI,QAAQ,KAAK;AAE5E,UAAI,OAAO,IAAI,WAAW,eAAe,IAAI,WAAW,YAAY,IAAI,WAAW,aAAa;AAC9F,cAAM,eAAe,WAAW,IAAI,IAAI,UAAU,IAAI,QAAQ,OAAO,OAAO;AAC5E,YAAI,IAAI,eAAe;AACrB,gBAAM,gBAAgB;AAAA,YACpB,IAAI;AAAA,YACJ;AAAA,cACE,cAAc;AAAA,cACd;AAAA,YACF;AAAA,YACA,IAAI,QAAQ;AAAA,UACd;AAAA,QACF;AAAA,MACF;AAAA,IACF,SAAS,eAAe;AACtB,aAAO,MAAM,gDAAgD,EAAE,KAAK,cAAc,CAAC;AAAA,IACrF;AAEA,UAAM;AAAA,EACR;AACF;",
   "names": []
 }

package/dist/modules/design_system/acl.js

@@ -0,0 +1,9 @@
+const features = [
+  { id: "design_system.view", title: "View the design system gallery", module: "design_system" }
+];
+var acl_default = features;
+export {
+  acl_default as default,
+  features
+};
+//# sourceMappingURL=acl.js.map

package/dist/modules/design_system/acl.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/modules/design_system/acl.ts"],
+  "sourcesContent": ["export const features = [\n  { id: 'design_system.view', title: 'View the design system gallery', module: 'design_system' },\n]\n\nexport default features\n"],
+  "mappings": "AAAO,MAAM,WAAW;AAAA,EACtB,EAAE,IAAI,sBAAsB,OAAO,kCAAkC,QAAQ,gBAAgB;AAC/F;AAEA,IAAO,cAAQ;",
+  "names": []
+}

package/dist/modules/design_system/backend/design-system/page.js

@@ -0,0 +1,11 @@
+"use client";
+import { jsx } from "react/jsx-runtime";
+import { Page, PageBody } from "@open-mercato/ui/backend/Page";
+import { GalleryShell } from "../../gallery/components/GalleryShell.js";
+function DesignSystemGalleryPage() {
+  return /* @__PURE__ */ jsx(Page, { children: /* @__PURE__ */ jsx(PageBody, { children: /* @__PURE__ */ jsx(GalleryShell, {}) }) });
+}
+export {
+  DesignSystemGalleryPage as default
+};
+//# sourceMappingURL=page.js.map

package/dist/modules/design_system/backend/design-system/page.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../src/modules/design_system/backend/design-system/page.tsx"],
+  "sourcesContent": ["\"use client\"\n\nimport { Page, PageBody } from '@open-mercato/ui/backend/Page'\nimport { GalleryShell } from '../../gallery/components/GalleryShell'\n\nexport default function DesignSystemGalleryPage() {\n  return (\n    <Page>\n      <PageBody>\n        <GalleryShell />\n      </PageBody>\n    </Page>\n  )\n}\n"],
+  "mappings": ";AASQ;AAPR,SAAS,MAAM,gBAAgB;AAC/B,SAAS,oBAAoB;AAEd,SAAR,0BAA2C;AAChD,SACE,oBAAC,QACC,8BAAC,YACC,8BAAC,gBAAa,GAChB,GACF;AAEJ;",
+  "names": []
+}

package/dist/modules/design_system/backend/design-system/page.meta.js

@@ -0,0 +1,15 @@
+const metadata = {
+  requireAuth: true,
+  requireFeatures: ["design_system.view"],
+  pageTitle: "Design system",
+  pageTitleKey: "design_system.nav.title",
+  pageGroup: "Developer",
+  pageGroupKey: "design_system.nav.group",
+  pageOrder: 900,
+  icon: "shapes",
+  breadcrumb: [{ label: "Design system", labelKey: "design_system.nav.title" }]
+};
+export {
+  metadata
+};
+//# sourceMappingURL=page.meta.js.map

package/dist/modules/design_system/backend/design-system/page.meta.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../src/modules/design_system/backend/design-system/page.meta.ts"],
+  "sourcesContent": ["export const metadata = {\n  requireAuth: true,\n  requireFeatures: ['design_system.view'],\n  pageTitle: 'Design system',\n  pageTitleKey: 'design_system.nav.title',\n  pageGroup: 'Developer',\n  pageGroupKey: 'design_system.nav.group',\n  pageOrder: 900,\n  icon: 'shapes',\n  breadcrumb: [{ label: 'Design system', labelKey: 'design_system.nav.title' }],\n}\n"],
+  "mappings": "AAAO,MAAM,WAAW;AAAA,EACtB,aAAa;AAAA,EACb,iBAAiB,CAAC,oBAAoB;AAAA,EACtC,WAAW;AAAA,EACX,cAAc;AAAA,EACd,WAAW;AAAA,EACX,cAAc;AAAA,EACd,WAAW;AAAA,EACX,MAAM;AAAA,EACN,YAAY,CAAC,EAAE,OAAO,iBAAiB,UAAU,0BAA0B,CAAC;AAC9E;",
+  "names": []
+}

package/dist/modules/design_system/gallery/components/CodeSnippet.js

@@ -0,0 +1,52 @@
+"use client";
+import { jsx, jsxs } from "react/jsx-runtime";
+import * as React from "react";
+import { Copy } from "lucide-react";
+import { useT } from "@open-mercato/shared/lib/i18n/context";
+import { IconButton } from "@open-mercato/ui/primitives/icon-button";
+import { flash } from "@open-mercato/ui/backend/FlashMessages";
+function CodeSnippet({ code }) {
+  const t = useT();
+  const copyLabel = t("design_system.gallery.copy", "Copy code");
+  const onCopy = React.useCallback(async () => {
+    try {
+      if (navigator.clipboard) {
+        await navigator.clipboard.writeText(code);
+      } else {
+        const holder = document.createElement("textarea");
+        holder.value = code;
+        holder.setAttribute("readonly", "");
+        holder.style.position = "fixed";
+        holder.style.opacity = "0";
+        document.body.appendChild(holder);
+        holder.select();
+        const copied = document.execCommand("copy");
+        holder.remove();
+        if (!copied) throw new Error("[internal] execCommand copy failed");
+      }
+      flash(t("design_system.gallery.copied", "Snippet copied to clipboard"), "success");
+    } catch {
+      flash(t("design_system.gallery.copyFailed", "Could not copy the snippet"), "error");
+    }
+  }, [code, t]);
+  return /* @__PURE__ */ jsxs("div", { className: "relative rounded-md border border-border bg-muted/50", children: [
+    /* @__PURE__ */ jsx("pre", { className: "overflow-x-auto p-3 pr-12 text-xs leading-relaxed", children: /* @__PURE__ */ jsx("code", { children: code }) }),
+    /* @__PURE__ */ jsx(
+      IconButton,
+      {
+        type: "button",
+        variant: "ghost",
+        size: "sm",
+        className: "absolute right-1.5 top-1.5",
+        "aria-label": copyLabel,
+        title: copyLabel,
+        onClick: onCopy,
+        children: /* @__PURE__ */ jsx(Copy, {})
+      }
+    )
+  ] });
+}
+export {
+  CodeSnippet
+};
+//# sourceMappingURL=CodeSnippet.js.map

package/dist/modules/design_system/gallery/components/CodeSnippet.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../src/modules/design_system/gallery/components/CodeSnippet.tsx"],
+  "sourcesContent": ["'use client'\n\nimport * as React from 'react'\nimport { Copy } from 'lucide-react'\nimport { useT } from '@open-mercato/shared/lib/i18n/context'\nimport { IconButton } from '@open-mercato/ui/primitives/icon-button'\nimport { flash } from '@open-mercato/ui/backend/FlashMessages'\n\nexport function CodeSnippet({ code }: { code: string }) {\n  const t = useT()\n  const copyLabel = t('design_system.gallery.copy', 'Copy code')\n\n  const onCopy = React.useCallback(async () => {\n    try {\n      if (navigator.clipboard) {\n        await navigator.clipboard.writeText(code)\n      } else {\n        // Non-secure contexts (plain-HTTP self-hosted installs) have no\n        // navigator.clipboard \u2014 fall back to the legacy selection API.\n        const holder = document.createElement('textarea')\n        holder.value = code\n        holder.setAttribute('readonly', '')\n        holder.style.position = 'fixed'\n        holder.style.opacity = '0'\n        document.body.appendChild(holder)\n        holder.select()\n        const copied = document.execCommand('copy')\n        holder.remove()\n        if (!copied) throw new Error('[internal] execCommand copy failed')\n      }\n      flash(t('design_system.gallery.copied', 'Snippet copied to clipboard'), 'success')\n    } catch {\n      flash(t('design_system.gallery.copyFailed', 'Could not copy the snippet'), 'error')\n    }\n  }, [code, t])\n\n  return (\n    <div className=\"relative rounded-md border border-border bg-muted/50\">\n      <pre className=\"overflow-x-auto p-3 pr-12 text-xs leading-relaxed\">\n        <code>{code}</code>\n      </pre>\n      <IconButton\n        type=\"button\"\n        variant=\"ghost\"\n        size=\"sm\"\n        className=\"absolute right-1.5 top-1.5\"\n        aria-label={copyLabel}\n        title={copyLabel}\n        onClick={onCopy}\n      >\n        <Copy />\n      </IconButton>\n    </div>\n  )\n}\n"],
+  "mappings": ";AAqCI,SAEI,KAFJ;AAnCJ,YAAY,WAAW;AACvB,SAAS,YAAY;AACrB,SAAS,YAAY;AACrB,SAAS,kBAAkB;AAC3B,SAAS,aAAa;AAEf,SAAS,YAAY,EAAE,KAAK,GAAqB;AACtD,QAAM,IAAI,KAAK;AACf,QAAM,YAAY,EAAE,8BAA8B,WAAW;AAE7D,QAAM,SAAS,MAAM,YAAY,YAAY;AAC3C,QAAI;AACF,UAAI,UAAU,WAAW;AACvB,cAAM,UAAU,UAAU,UAAU,IAAI;AAAA,MAC1C,OAAO;AAGL,cAAM,SAAS,SAAS,cAAc,UAAU;AAChD,eAAO,QAAQ;AACf,eAAO,aAAa,YAAY,EAAE;AAClC,eAAO,MAAM,WAAW;AACxB,eAAO,MAAM,UAAU;AACvB,iBAAS,KAAK,YAAY,MAAM;AAChC,eAAO,OAAO;AACd,cAAM,SAAS,SAAS,YAAY,MAAM;AAC1C,eAAO,OAAO;AACd,YAAI,CAAC,OAAQ,OAAM,IAAI,MAAM,oCAAoC;AAAA,MACnE;AACA,YAAM,EAAE,gCAAgC,6BAA6B,GAAG,SAAS;AAAA,IACnF,QAAQ;AACN,YAAM,EAAE,oCAAoC,4BAA4B,GAAG,OAAO;AAAA,IACpF;AAAA,EACF,GAAG,CAAC,MAAM,CAAC,CAAC;AAEZ,SACE,qBAAC,SAAI,WAAU,wDACb;AAAA,wBAAC,SAAI,WAAU,qDACb,8BAAC,UAAM,gBAAK,GACd;AAAA,IACA;AAAA,MAAC;AAAA;AAAA,QACC,MAAK;AAAA,QACL,SAAQ;AAAA,QACR,MAAK;AAAA,QACL,WAAU;AAAA,QACV,cAAY;AAAA,QACZ,OAAO;AAAA,QACP,SAAS;AAAA,QAET,8BAAC,QAAK;AAAA;AAAA,IACR;AAAA,KACF;AAEJ;",
+  "names": []
+}

package/dist/modules/design_system/gallery/components/EntryCard.js

@@ -0,0 +1,63 @@
+"use client";
+import { jsx, jsxs } from "react/jsx-runtime";
+import { Check, ExternalLink, X } from "lucide-react";
+import { useT } from "@open-mercato/shared/lib/i18n/context";
+import { LinkButton } from "@open-mercato/ui/primitives/link-button";
+import { DS_DOCS_URL, figmaNodeUrl } from "../registry.js";
+import { VariantPreview } from "./VariantPreview.js";
+import { CodeSnippet } from "./CodeSnippet.js";
+function EntryCard({ entry }) {
+  const t = useT();
+  return /* @__PURE__ */ jsxs(
+    "section",
+    {
+      id: `gallery-entry-${entry.id}`,
+      "aria-labelledby": `gallery-entry-${entry.id}-title`,
+      className: "scroll-mt-4 space-y-4 rounded-lg border border-border bg-card p-4",
+      children: [
+        /* @__PURE__ */ jsxs("div", { className: "flex flex-col gap-2 sm:flex-row sm:items-start sm:justify-between", children: [
+          /* @__PURE__ */ jsxs("div", { className: "min-w-0 space-y-1", children: [
+            /* @__PURE__ */ jsx("h3", { id: `gallery-entry-${entry.id}-title`, className: "text-base font-semibold leading-tight", children: entry.title }),
+            entry.descriptionKey ? /* @__PURE__ */ jsx("p", { className: "text-sm text-muted-foreground", children: t(entry.descriptionKey, entry.title) }) : null,
+            /* @__PURE__ */ jsx("code", { className: "block truncate text-xs text-muted-foreground", children: entry.importPath })
+          ] }),
+          /* @__PURE__ */ jsxs("div", { className: "flex shrink-0 items-center gap-3", children: [
+            entry.figmaNodeId ? /* @__PURE__ */ jsx(LinkButton, { asChild: true, size: "sm", children: /* @__PURE__ */ jsxs("a", { href: figmaNodeUrl(entry.figmaNodeId), target: "_blank", rel: "noreferrer", children: [
+              t("design_system.gallery.openInFigma", "Open in Figma"),
+              /* @__PURE__ */ jsx(ExternalLink, {})
+            ] }) }) : null,
+            entry.docsAnchor ? /* @__PURE__ */ jsx(LinkButton, { asChild: true, size: "sm", variant: "gray", children: /* @__PURE__ */ jsxs("a", { href: `${DS_DOCS_URL}${entry.docsAnchor}`, target: "_blank", rel: "noreferrer", children: [
+              t("design_system.gallery.viewDocs", "View docs"),
+              /* @__PURE__ */ jsx(ExternalLink, {})
+            ] }) }) : null
+          ] })
+        ] }),
+        entry.usage && (entry.usage.do?.length || entry.usage.dont?.length) ? /* @__PURE__ */ jsxs("div", { className: "grid gap-4 rounded-md border border-border bg-muted/30 p-4 sm:grid-cols-2", children: [
+          entry.usage.do?.length ? /* @__PURE__ */ jsxs("div", { className: "space-y-1.5", children: [
+            /* @__PURE__ */ jsx("div", { className: "text-xs font-medium uppercase tracking-wider text-muted-foreground", children: t("design_system.gallery.usageDo", "Do") }),
+            /* @__PURE__ */ jsx("ul", { className: "space-y-1.5", children: entry.usage.do.map((rule) => /* @__PURE__ */ jsxs("li", { className: "flex items-start gap-2 text-sm text-foreground", children: [
+              /* @__PURE__ */ jsx(Check, { "aria-hidden": true, className: "mt-0.5 size-3.5 shrink-0 text-status-success-icon" }),
+              /* @__PURE__ */ jsx("span", { children: rule })
+            ] }, rule)) })
+          ] }) : null,
+          entry.usage.dont?.length ? /* @__PURE__ */ jsxs("div", { className: "space-y-1.5", children: [
+            /* @__PURE__ */ jsx("div", { className: "text-xs font-medium uppercase tracking-wider text-muted-foreground", children: t("design_system.gallery.usageDont", "Don't") }),
+            /* @__PURE__ */ jsx("ul", { className: "space-y-1.5", children: entry.usage.dont.map((rule) => /* @__PURE__ */ jsxs("li", { className: "flex items-start gap-2 text-sm text-foreground", children: [
+              /* @__PURE__ */ jsx(X, { "aria-hidden": true, className: "mt-0.5 size-3.5 shrink-0 text-status-error-icon" }),
+              /* @__PURE__ */ jsx("span", { children: rule })
+            ] }, rule)) })
+          ] }) : null
+        ] }) : null,
+        /* @__PURE__ */ jsx("div", { className: "space-y-4", children: entry.variants.map((variant) => /* @__PURE__ */ jsxs("div", { className: "space-y-2", children: [
+          /* @__PURE__ */ jsx("div", { className: "text-sm font-medium text-foreground", children: variant.title }),
+          /* @__PURE__ */ jsx(VariantPreview, { children: variant.render() }),
+          /* @__PURE__ */ jsx(CodeSnippet, { code: variant.code })
+        ] }, variant.id)) })
+      ]
+    }
+  );
+}
+export {
+  EntryCard
+};
+//# sourceMappingURL=EntryCard.js.map

package/dist/modules/design_system/gallery/components/EntryCard.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../src/modules/design_system/gallery/components/EntryCard.tsx"],
+  "sourcesContent": ["'use client'\n\nimport * as React from 'react'\nimport { Check, ExternalLink, X } from 'lucide-react'\nimport { useT } from '@open-mercato/shared/lib/i18n/context'\nimport { LinkButton } from '@open-mercato/ui/primitives/link-button'\nimport type { GalleryEntry } from '../types'\nimport { DS_DOCS_URL, figmaNodeUrl } from '../registry'\nimport { VariantPreview } from './VariantPreview'\nimport { CodeSnippet } from './CodeSnippet'\n\nexport function EntryCard({ entry }: { entry: GalleryEntry }) {\n  const t = useT()\n\n  return (\n    <section\n      id={`gallery-entry-${entry.id}`}\n      aria-labelledby={`gallery-entry-${entry.id}-title`}\n      className=\"scroll-mt-4 space-y-4 rounded-lg border border-border bg-card p-4\"\n    >\n      <div className=\"flex flex-col gap-2 sm:flex-row sm:items-start sm:justify-between\">\n        <div className=\"min-w-0 space-y-1\">\n          <h3 id={`gallery-entry-${entry.id}-title`} className=\"text-base font-semibold leading-tight\">\n            {entry.title}\n          </h3>\n          {entry.descriptionKey ? (\n            <p className=\"text-sm text-muted-foreground\">{t(entry.descriptionKey, entry.title)}</p>\n          ) : null}\n          <code className=\"block truncate text-xs text-muted-foreground\">{entry.importPath}</code>\n        </div>\n        <div className=\"flex shrink-0 items-center gap-3\">\n          {entry.figmaNodeId ? (\n            <LinkButton asChild size=\"sm\">\n              <a href={figmaNodeUrl(entry.figmaNodeId)} target=\"_blank\" rel=\"noreferrer\">\n                {t('design_system.gallery.openInFigma', 'Open in Figma')}\n                <ExternalLink />\n              </a>\n            </LinkButton>\n          ) : null}\n          {entry.docsAnchor ? (\n            <LinkButton asChild size=\"sm\" variant=\"gray\">\n              <a href={`${DS_DOCS_URL}${entry.docsAnchor}`} target=\"_blank\" rel=\"noreferrer\">\n                {t('design_system.gallery.viewDocs', 'View docs')}\n                <ExternalLink />\n              </a>\n            </LinkButton>\n          ) : null}\n        </div>\n      </div>\n      {entry.usage && (entry.usage.do?.length || entry.usage.dont?.length) ? (\n        <div className=\"grid gap-4 rounded-md border border-border bg-muted/30 p-4 sm:grid-cols-2\">\n          {entry.usage.do?.length ? (\n            <div className=\"space-y-1.5\">\n              <div className=\"text-xs font-medium uppercase tracking-wider text-muted-foreground\">\n                {t('design_system.gallery.usageDo', 'Do')}\n              </div>\n              <ul className=\"space-y-1.5\">\n                {entry.usage.do.map((rule) => (\n                  <li key={rule} className=\"flex items-start gap-2 text-sm text-foreground\">\n                    <Check aria-hidden className=\"mt-0.5 size-3.5 shrink-0 text-status-success-icon\" />\n                    <span>{rule}</span>\n                  </li>\n                ))}\n              </ul>\n            </div>\n          ) : null}\n          {entry.usage.dont?.length ? (\n            <div className=\"space-y-1.5\">\n              <div className=\"text-xs font-medium uppercase tracking-wider text-muted-foreground\">\n                {t('design_system.gallery.usageDont', \"Don't\")}\n              </div>\n              <ul className=\"space-y-1.5\">\n                {entry.usage.dont.map((rule) => (\n                  <li key={rule} className=\"flex items-start gap-2 text-sm text-foreground\">\n                    <X aria-hidden className=\"mt-0.5 size-3.5 shrink-0 text-status-error-icon\" />\n                    <span>{rule}</span>\n                  </li>\n                ))}\n              </ul>\n            </div>\n          ) : null}\n        </div>\n      ) : null}\n      <div className=\"space-y-4\">\n        {entry.variants.map((variant) => (\n          <div key={variant.id} className=\"space-y-2\">\n            <div className=\"text-sm font-medium text-foreground\">{variant.title}</div>\n            <VariantPreview>{variant.render()}</VariantPreview>\n            <CodeSnippet code={variant.code} />\n          </div>\n        ))}\n      </div>\n    </section>\n  )\n}\n"],
+  "mappings": ";AAqBQ,SACE,KADF;AAlBR,SAAS,OAAO,cAAc,SAAS;AACvC,SAAS,YAAY;AACrB,SAAS,kBAAkB;AAE3B,SAAS,aAAa,oBAAoB;AAC1C,SAAS,sBAAsB;AAC/B,SAAS,mBAAmB;AAErB,SAAS,UAAU,EAAE,MAAM,GAA4B;AAC5D,QAAM,IAAI,KAAK;AAEf,SACE;AAAA,IAAC;AAAA;AAAA,MACC,IAAI,iBAAiB,MAAM,EAAE;AAAA,MAC7B,mBAAiB,iBAAiB,MAAM,EAAE;AAAA,MAC1C,WAAU;AAAA,MAEV;AAAA,6BAAC,SAAI,WAAU,qEACb;AAAA,+BAAC,SAAI,WAAU,qBACb;AAAA,gCAAC,QAAG,IAAI,iBAAiB,MAAM,EAAE,UAAU,WAAU,yCAClD,gBAAM,OACT;AAAA,YACC,MAAM,iBACL,oBAAC,OAAE,WAAU,iCAAiC,YAAE,MAAM,gBAAgB,MAAM,KAAK,GAAE,IACjF;AAAA,YACJ,oBAAC,UAAK,WAAU,gDAAgD,gBAAM,YAAW;AAAA,aACnF;AAAA,UACA,qBAAC,SAAI,WAAU,oCACZ;AAAA,kBAAM,cACL,oBAAC,cAAW,SAAO,MAAC,MAAK,MACvB,+BAAC,OAAE,MAAM,aAAa,MAAM,WAAW,GAAG,QAAO,UAAS,KAAI,cAC3D;AAAA,gBAAE,qCAAqC,eAAe;AAAA,cACvD,oBAAC,gBAAa;AAAA,eAChB,GACF,IACE;AAAA,YACH,MAAM,aACL,oBAAC,cAAW,SAAO,MAAC,MAAK,MAAK,SAAQ,QACpC,+BAAC,OAAE,MAAM,GAAG,WAAW,GAAG,MAAM,UAAU,IAAI,QAAO,UAAS,KAAI,cAC/D;AAAA,gBAAE,kCAAkC,WAAW;AAAA,cAChD,oBAAC,gBAAa;AAAA,eAChB,GACF,IACE;AAAA,aACN;AAAA,WACF;AAAA,QACC,MAAM,UAAU,MAAM,MAAM,IAAI,UAAU,MAAM,MAAM,MAAM,UAC3D,qBAAC,SAAI,WAAU,6EACZ;AAAA,gBAAM,MAAM,IAAI,SACf,qBAAC,SAAI,WAAU,eACb;AAAA,gCAAC,SAAI,WAAU,sEACZ,YAAE,iCAAiC,IAAI,GAC1C;AAAA,YACA,oBAAC,QAAG,WAAU,eACX,gBAAM,MAAM,GAAG,IAAI,CAAC,SACnB,qBAAC,QAAc,WAAU,kDACvB;AAAA,kCAAC,SAAM,eAAW,MAAC,WAAU,qDAAoD;AAAA,cACjF,oBAAC,UAAM,gBAAK;AAAA,iBAFL,IAGT,CACD,GACH;AAAA,aACF,IACE;AAAA,UACH,MAAM,MAAM,MAAM,SACjB,qBAAC,SAAI,WAAU,eACb;AAAA,gCAAC,SAAI,WAAU,sEACZ,YAAE,mCAAmC,OAAO,GAC/C;AAAA,YACA,oBAAC,QAAG,WAAU,eACX,gBAAM,MAAM,KAAK,IAAI,CAAC,SACrB,qBAAC,QAAc,WAAU,kDACvB;AAAA,kCAAC,KAAE,eAAW,MAAC,WAAU,mDAAkD;AAAA,cAC3E,oBAAC,UAAM,gBAAK;AAAA,iBAFL,IAGT,CACD,GACH;AAAA,aACF,IACE;AAAA,WACN,IACE;AAAA,QACJ,oBAAC,SAAI,WAAU,aACZ,gBAAM,SAAS,IAAI,CAAC,YACnB,qBAAC,SAAqB,WAAU,aAC9B;AAAA,8BAAC,SAAI,WAAU,uCAAuC,kBAAQ,OAAM;AAAA,UACpE,oBAAC,kBAAgB,kBAAQ,OAAO,GAAE;AAAA,UAClC,oBAAC,eAAY,MAAM,QAAQ,MAAM;AAAA,aAHzB,QAAQ,EAIlB,CACD,GACH;AAAA;AAAA;AAAA,EACF;AAEJ;",
+  "names": []
+}

package/dist/modules/design_system/gallery/components/GalleryShell.js

@@ -0,0 +1,163 @@
+"use client";
+import { jsx, jsxs } from "react/jsx-runtime";
+import * as React from "react";
+import { useSearchParams } from "next/navigation";
+import { useT } from "@open-mercato/shared/lib/i18n/context";
+import { SectionPage } from "@open-mercato/ui/backend/section-page";
+import { SearchInput } from "@open-mercato/ui/primitives/search-input";
+import { Skeleton } from "@open-mercato/ui/primitives/skeleton";
+import { EmptyState } from "@open-mercato/ui/primitives/empty-state";
+import { Button } from "@open-mercato/ui/primitives/button";
+import { ErrorMessage } from "@open-mercato/ui/backend/detail";
+import { GALLERY_BASE_PATH, galleryFamilies } from "../registry.js";
+import { EntryCard } from "./EntryCard.js";
+function familyLabelFallback(id) {
+  return id.charAt(0).toUpperCase() + id.slice(1).replace(/[-_]/g, " ");
+}
+function matchesQuery(entry, query) {
+  const needle = query.trim().toLowerCase();
+  if (!needle) return true;
+  if (entry.id.toLowerCase().includes(needle) || entry.title.toLowerCase().includes(needle)) return true;
+  if (entry.keywords?.some((keyword) => keyword.toLowerCase().includes(needle))) return true;
+  return needle.includes(entry.id.toLowerCase()) || needle.includes(entry.title.toLowerCase());
+}
+function GalleryShell() {
+  const t = useT();
+  const searchParams = useSearchParams();
+  const [loaded, setLoaded] = React.useState({});
+  const [failed, setFailed] = React.useState({});
+  const [search, setSearch] = React.useState("");
+  const pendingRef = React.useRef(/* @__PURE__ */ new Set());
+  const familyParam = searchParams?.get("family") ?? null;
+  const entryParam = searchParams?.get("entry") ?? null;
+  React.useEffect(() => {
+    setSearch("");
+  }, [familyParam]);
+  const activeFamily = galleryFamilies.find((family) => family.id === familyParam) ?? galleryFamilies[0];
+  const activeFamilyId = activeFamily?.id ?? null;
+  const loadFamily = React.useCallback((family) => {
+    if (pendingRef.current.has(family.id)) return;
+    pendingRef.current.add(family.id);
+    setFailed((prev) => prev[family.id] ? { ...prev, [family.id]: false } : prev);
+    family.load().then((mod) => {
+      setLoaded((prev) => prev[family.id] ? prev : { ...prev, [family.id]: mod.entries });
+    }).catch(() => {
+      pendingRef.current.delete(family.id);
+      setFailed((prev) => ({ ...prev, [family.id]: true }));
+    });
+  }, []);
+  const searching = search.trim().length > 0;
+  React.useEffect(() => {
+    if (searching) {
+      for (const family of galleryFamilies) loadFamily(family);
+    } else if (activeFamily) {
+      loadFamily(activeFamily);
+    }
+  }, [searching, activeFamily, loadFamily]);
+  const activeEntries = activeFamilyId ? loaded[activeFamilyId] : void 0;
+  React.useEffect(() => {
+    if (!entryParam || searching || !activeEntries) return;
+    const node = document.getElementById(`gallery-entry-${entryParam}`);
+    node?.scrollIntoView({ block: "start" });
+  }, [entryParam, searching, activeEntries]);
+  const sections = React.useMemo(
+    () => [
+      {
+        id: "families",
+        label: "Families",
+        labelKey: "design_system.gallery.familiesGroup",
+        items: galleryFamilies.map((family) => ({
+          id: family.id,
+          label: familyLabelFallback(family.id),
+          labelKey: family.labelKey,
+          icon: family.icon,
+          href: `${GALLERY_BASE_PATH}?family=${family.id}`
+        }))
+      }
+    ],
+    []
+  );
+  const renderFamilySkeleton = () => /* @__PURE__ */ jsxs("div", { className: "space-y-4", "data-testid": "gallery-family-skeleton", children: [
+    /* @__PURE__ */ jsx(Skeleton, { className: "h-40 w-full" }),
+    /* @__PURE__ */ jsx(Skeleton, { className: "h-40 w-full" })
+  ] });
+  const renderSearchResults = () => {
+    const groups = galleryFamilies.map((family) => ({
+      family,
+      entries: (loaded[family.id] ?? []).filter((entry) => matchesQuery(entry, search))
+    })).filter((group) => group.entries.length > 0);
+    const stillLoading = galleryFamilies.some((family) => !loaded[family.id] && !failed[family.id]);
+    if (groups.length === 0 && stillLoading) return renderFamilySkeleton();
+    if (groups.length === 0) {
+      return /* @__PURE__ */ jsx(
+        EmptyState,
+        {
+          title: t("design_system.gallery.noResults", "No components match your search")
+        }
+      );
+    }
+    return /* @__PURE__ */ jsx("div", { className: "space-y-8", children: groups.map(({ family, entries }) => /* @__PURE__ */ jsxs("div", { className: "space-y-4", children: [
+      /* @__PURE__ */ jsx("h2", { className: "text-sm font-medium uppercase tracking-wider text-muted-foreground", children: t(family.labelKey, familyLabelFallback(family.id)) }),
+      entries.map((entry) => /* @__PURE__ */ jsx(EntryCard, { entry }, entry.id))
+    ] }, family.id)) });
+  };
+  const renderActiveFamily = () => {
+    if (!activeFamily) return null;
+    const entries = loaded[activeFamily.id];
+    if (!entries && failed[activeFamily.id]) {
+      return /* @__PURE__ */ jsx(
+        ErrorMessage,
+        {
+          label: t("design_system.gallery.loadFailed", "Could not load this family"),
+          action: /* @__PURE__ */ jsx(Button, { type: "button", variant: "outline", size: "sm", onClick: () => loadFamily(activeFamily), children: t("design_system.gallery.retry", "Retry") })
+        }
+      );
+    }
+    if (!entries) return renderFamilySkeleton();
+    return /* @__PURE__ */ jsxs("div", { className: "space-y-4", children: [
+      /* @__PURE__ */ jsx("h2", { className: "text-lg font-semibold", children: t(activeFamily.labelKey, familyLabelFallback(activeFamily.id)) }),
+      entries.length > 1 ? /* @__PURE__ */ jsx(
+        "nav",
+        {
+          "aria-label": t("design_system.gallery.familyContents", "Components in this family"),
+          className: "flex flex-wrap items-center gap-1.5 rounded-md border border-border bg-muted/30 p-2",
+          children: entries.map((entry) => /* @__PURE__ */ jsx(
+            "a",
+            {
+              href: `#gallery-entry-${entry.id}`,
+              className: "rounded-md border border-border bg-background px-2 py-1 text-xs text-foreground transition-colors hover:bg-muted focus-visible:outline-none focus-visible:shadow-focus",
+              children: entry.title
+            },
+            entry.id
+          ))
+        }
+      ) : null,
+      entries.map((entry) => /* @__PURE__ */ jsx(EntryCard, { entry }, entry.id))
+    ] });
+  };
+  return /* @__PURE__ */ jsx(
+    SectionPage,
+    {
+      title: "Design system",
+      titleKey: "design_system.nav.title",
+      sections,
+      activePath: activeFamilyId ? `${GALLERY_BASE_PATH}?family=${activeFamilyId}` : GALLERY_BASE_PATH,
+      children: /* @__PURE__ */ jsxs("div", { className: "mx-auto w-full max-w-5xl space-y-6", children: [
+        /* @__PURE__ */ jsx(
+          SearchInput,
+          {
+            value: search,
+            onChange: setSearch,
+            placeholder: t("design_system.gallery.searchPlaceholder", "Search components\u2026"),
+            "aria-label": t("design_system.gallery.searchPlaceholder", "Search components\u2026")
+          }
+        ),
+        searching ? renderSearchResults() : renderActiveFamily()
+      ] })
+    }
+  );
+}
+export {
+  GalleryShell
+};
+//# sourceMappingURL=GalleryShell.js.map

package/dist/modules/design_system/gallery/components/GalleryShell.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../src/modules/design_system/gallery/components/GalleryShell.tsx"],
+  "sourcesContent": ["'use client'\n\nimport * as React from 'react'\nimport { useSearchParams } from 'next/navigation'\nimport { useT } from '@open-mercato/shared/lib/i18n/context'\nimport { SectionPage } from '@open-mercato/ui/backend/section-page'\nimport type { SectionNavGroup } from '@open-mercato/ui/backend/section-page'\nimport { SearchInput } from '@open-mercato/ui/primitives/search-input'\nimport { Skeleton } from '@open-mercato/ui/primitives/skeleton'\nimport { EmptyState } from '@open-mercato/ui/primitives/empty-state'\nimport { Button } from '@open-mercato/ui/primitives/button'\nimport { ErrorMessage } from '@open-mercato/ui/backend/detail'\nimport type { GalleryEntry, GalleryFamily } from '../types'\nimport { GALLERY_BASE_PATH, galleryFamilies } from '../registry'\nimport { EntryCard } from './EntryCard'\n\n/** 'buttons' \u2192 'Buttons' \u2014 untranslated fallback when a family labelKey has no message. */\nfunction familyLabelFallback(id: string): string {\n  return id.charAt(0).toUpperCase() + id.slice(1).replace(/[-_]/g, ' ')\n}\n\nfunction matchesQuery(entry: GalleryEntry, query: string): boolean {\n  const needle = query.trim().toLowerCase()\n  if (!needle) return true\n  if (entry.id.toLowerCase().includes(needle) || entry.title.toLowerCase().includes(needle)) return true\n  if (entry.keywords?.some((keyword) => keyword.toLowerCase().includes(needle))) return true\n  // 'radiobutton' should still find 'radio' \u2014 match when the query CONTAINS the id/title too.\n  return needle.includes(entry.id.toLowerCase()) || needle.includes(entry.title.toLowerCase())\n}\n\ntype LoadedEntries = Record<string, GalleryEntry[]>\n\nexport function GalleryShell() {\n  const t = useT()\n  const searchParams = useSearchParams()\n  const [loaded, setLoaded] = React.useState<LoadedEntries>({})\n  const [failed, setFailed] = React.useState<Record<string, boolean>>({})\n  const [search, setSearch] = React.useState('')\n  const pendingRef = React.useRef(new Set<string>())\n\n  const familyParam = searchParams?.get('family') ?? null\n  const entryParam = searchParams?.get('entry') ?? null\n\n  // Clicking a family in the section nav exits search mode \u2014 otherwise the\n  // query keeps precedence and family navigation appears dead.\n  React.useEffect(() => {\n    setSearch('')\n  }, [familyParam])\n  const activeFamily: GalleryFamily | undefined =\n    galleryFamilies.find((family) => family.id === familyParam) ?? galleryFamilies[0]\n  const activeFamilyId = activeFamily?.id ?? null\n\n  const loadFamily = React.useCallback((family: GalleryFamily) => {\n    if (pendingRef.current.has(family.id)) return\n    pendingRef.current.add(family.id)\n    setFailed((prev) => (prev[family.id] ? { ...prev, [family.id]: false } : prev))\n    family\n      .load()\n      .then((mod) => {\n        setLoaded((prev) => (prev[family.id] ? prev : { ...prev, [family.id]: mod.entries }))\n      })\n      .catch(() => {\n        pendingRef.current.delete(family.id)\n        setFailed((prev) => ({ ...prev, [family.id]: true }))\n      })\n  }, [])\n\n  // Lazy-load the active family; when searching, load every family so results\n  // span the whole gallery.\n  const searching = search.trim().length > 0\n  React.useEffect(() => {\n    if (searching) {\n      for (const family of galleryFamilies) loadFamily(family)\n    } else if (activeFamily) {\n      loadFamily(activeFamily)\n    }\n  }, [searching, activeFamily, loadFamily])\n\n  // Deep link: ?entry=<id> scrolls the entry into view once its family loaded.\n  const activeEntries = activeFamilyId ? loaded[activeFamilyId] : undefined\n  React.useEffect(() => {\n    if (!entryParam || searching || !activeEntries) return\n    const node = document.getElementById(`gallery-entry-${entryParam}`)\n    node?.scrollIntoView({ block: 'start' })\n  }, [entryParam, searching, activeEntries])\n\n  const sections: SectionNavGroup[] = React.useMemo(\n    () => [\n      {\n        id: 'families',\n        label: 'Families',\n        labelKey: 'design_system.gallery.familiesGroup',\n        items: galleryFamilies.map((family) => ({\n          id: family.id,\n          label: familyLabelFallback(family.id),\n          labelKey: family.labelKey,\n          icon: family.icon,\n          href: `${GALLERY_BASE_PATH}?family=${family.id}`,\n        })),\n      },\n    ],\n    [],\n  )\n\n  const renderFamilySkeleton = () => (\n    <div className=\"space-y-4\" data-testid=\"gallery-family-skeleton\">\n      <Skeleton className=\"h-40 w-full\" />\n      <Skeleton className=\"h-40 w-full\" />\n    </div>\n  )\n\n  const renderSearchResults = () => {\n    const groups = galleryFamilies\n      .map((family) => ({\n        family,\n        entries: (loaded[family.id] ?? []).filter((entry) => matchesQuery(entry, search)),\n      }))\n      .filter((group) => group.entries.length > 0)\n    const stillLoading = galleryFamilies.some((family) => !loaded[family.id] && !failed[family.id])\n    if (groups.length === 0 && stillLoading) return renderFamilySkeleton()\n    if (groups.length === 0) {\n      return (\n        <EmptyState\n          title={t('design_system.gallery.noResults', 'No components match your search')}\n        />\n      )\n    }\n    return (\n      <div className=\"space-y-8\">\n        {groups.map(({ family, entries }) => (\n          <div key={family.id} className=\"space-y-4\">\n            <h2 className=\"text-sm font-medium uppercase tracking-wider text-muted-foreground\">\n              {t(family.labelKey, familyLabelFallback(family.id))}\n            </h2>\n            {entries.map((entry) => (\n              <EntryCard key={entry.id} entry={entry} />\n            ))}\n          </div>\n        ))}\n      </div>\n    )\n  }\n\n  const renderActiveFamily = () => {\n    if (!activeFamily) return null\n    const entries = loaded[activeFamily.id]\n    if (!entries && failed[activeFamily.id]) {\n      return (\n        <ErrorMessage\n          label={t('design_system.gallery.loadFailed', 'Could not load this family')}\n          action={\n            <Button type=\"button\" variant=\"outline\" size=\"sm\" onClick={() => loadFamily(activeFamily)}>\n              {t('design_system.gallery.retry', 'Retry')}\n            </Button>\n          }\n        />\n      )\n    }\n    if (!entries) return renderFamilySkeleton()\n    return (\n      <div className=\"space-y-4\">\n        <h2 className=\"text-lg font-semibold\">\n          {t(activeFamily.labelKey, familyLabelFallback(activeFamily.id))}\n        </h2>\n        {entries.length > 1 ? (\n          <nav\n            aria-label={t('design_system.gallery.familyContents', 'Components in this family')}\n            className=\"flex flex-wrap items-center gap-1.5 rounded-md border border-border bg-muted/30 p-2\"\n          >\n            {entries.map((entry) => (\n              <a\n                key={entry.id}\n                href={`#gallery-entry-${entry.id}`}\n                className=\"rounded-md border border-border bg-background px-2 py-1 text-xs text-foreground transition-colors hover:bg-muted focus-visible:outline-none focus-visible:shadow-focus\"\n              >\n                {entry.title}\n              </a>\n            ))}\n          </nav>\n        ) : null}\n        {entries.map((entry) => (\n          <EntryCard key={entry.id} entry={entry} />\n        ))}\n      </div>\n    )\n  }\n\n  return (\n    <SectionPage\n      title=\"Design system\"\n      titleKey=\"design_system.nav.title\"\n      sections={sections}\n      activePath={activeFamilyId ? `${GALLERY_BASE_PATH}?family=${activeFamilyId}` : GALLERY_BASE_PATH}\n    >\n      <div className=\"mx-auto w-full max-w-5xl space-y-6\">\n        <SearchInput\n          value={search}\n          onChange={setSearch}\n          placeholder={t('design_system.gallery.searchPlaceholder', 'Search components\u2026')}\n          aria-label={t('design_system.gallery.searchPlaceholder', 'Search components\u2026')}\n        />\n        {searching ? renderSearchResults() : renderActiveFamily()}\n      </div>\n    </SectionPage>\n  )\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/modules/design_system/gallery/components/VariantPreview.js

@@ -0,0 +1,9 @@
+"use client";
+import { jsx } from "react/jsx-runtime";
+function VariantPreview({ children }) {
+  return /* @__PURE__ */ jsx("div", { className: "flex flex-wrap items-center gap-3 rounded-md border border-border bg-background p-4", children });
+}
+export {
+  VariantPreview
+};
+//# sourceMappingURL=VariantPreview.js.map

package/dist/modules/design_system/gallery/components/VariantPreview.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../src/modules/design_system/gallery/components/VariantPreview.tsx"],
+  "sourcesContent": ["'use client'\n\nimport * as React from 'react'\n\n/**\n * Bordered stage a variant renders inside. Chrome uses semantic tokens only \u2014\n * the stage must never impose colors of its own on the previewed component.\n */\nexport function VariantPreview({ children }: { children: React.ReactNode }) {\n  return (\n    <div className=\"flex flex-wrap items-center gap-3 rounded-md border border-border bg-background p-4\">\n      {children}\n    </div>\n  )\n}\n"],
+  "mappings": ";AAUI;AAFG,SAAS,eAAe,EAAE,SAAS,GAAkC;AAC1E,SACE,oBAAC,SAAI,WAAU,uFACZ,UACH;AAEJ;",
+  "names": []
+}