@open-mercato/core 0.4.7-develop-0a657b411f → 0.4.7-develop-e249d3e7d0

package/dist/modules/shipping_carriers/widgets/injection-table.js

@@ -0,0 +1,24 @@
+const injectionTable = {
+  "data-table:sales.shipments:columns": [
+    {
+      widgetId: "shipping_carriers.injection.tracking-column",
+      priority: 40
+    },
+    {
+      widgetId: "shipping_carriers.injection.tracking-status-badge",
+      priority: 45
+    }
+  ],
+  "data-table:sales.orders:row-actions": [
+    {
+      widgetId: "shipping_carriers.injection.create-shipment-button",
+      priority: 30
+    }
+  ]
+};
+var injection_table_default = injectionTable;
+export {
+  injection_table_default as default,
+  injectionTable
+};
+//# sourceMappingURL=injection-table.js.map

package/dist/modules/shipping_carriers/widgets/injection-table.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/modules/shipping_carriers/widgets/injection-table.ts"],
+  "sourcesContent": ["import type { ModuleInjectionTable } from '@open-mercato/shared/modules/widgets/injection'\n\nexport const injectionTable: ModuleInjectionTable = {\n  'data-table:sales.shipments:columns': [\n    {\n      widgetId: 'shipping_carriers.injection.tracking-column',\n      priority: 40,\n    },\n    {\n      widgetId: 'shipping_carriers.injection.tracking-status-badge',\n      priority: 45,\n    },\n  ],\n  'data-table:sales.orders:row-actions': [\n    {\n      widgetId: 'shipping_carriers.injection.create-shipment-button',\n      priority: 30,\n    },\n  ],\n}\n\nexport default injectionTable\n"],
+  "mappings": "AAEO,MAAM,iBAAuC;AAAA,EAClD,sCAAsC;AAAA,IACpC;AAAA,MACE,UAAU;AAAA,MACV,UAAU;AAAA,IACZ;AAAA,IACA;AAAA,MACE,UAAU;AAAA,MACV,UAAU;AAAA,IACZ;AAAA,EACF;AAAA,EACA,uCAAuC;AAAA,IACrC;AAAA,MACE,UAAU;AAAA,MACV,UAAU;AAAA,IACZ;AAAA,EACF;AACF;AAEA,IAAO,0BAAQ;",
+  "names": []
+}

package/dist/modules/shipping_carriers/workers/status-poller.js

@@ -0,0 +1,21 @@
+const metadata = {
+  queue: "shipping-carriers-status-poller",
+  id: "shipping-carriers:status-poller",
+  concurrency: 2
+};
+async function handle(job, ctx) {
+  const service = ctx.resolve("shippingCarrierService");
+  for (const shipmentId of job.payload.shipmentIds) {
+    await service.getTracking({
+      providerKey: job.payload.providerKey,
+      shipmentId,
+      organizationId: job.payload.scope.organizationId,
+      tenantId: job.payload.scope.tenantId
+    });
+  }
+}
+export {
+  handle as default,
+  metadata
+};
+//# sourceMappingURL=status-poller.js.map

package/dist/modules/shipping_carriers/workers/status-poller.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/modules/shipping_carriers/workers/status-poller.ts"],
+  "sourcesContent": ["import type { JobContext, QueuedJob, WorkerMeta } from '@open-mercato/queue'\nimport type { ShippingCarrierService } from '../lib/shipping-service'\n\ntype PollerJobPayload = {\n  providerKey: string\n  shipmentIds: string[]\n  scope: {\n    organizationId: string\n    tenantId: string\n  }\n}\n\ntype HandlerContext = JobContext & {\n  resolve: <T = unknown>(name: string) => T\n}\n\nexport const metadata: WorkerMeta = {\n  queue: 'shipping-carriers-status-poller',\n  id: 'shipping-carriers:status-poller',\n  concurrency: 2,\n}\n\nexport default async function handle(job: QueuedJob<PollerJobPayload>, ctx: HandlerContext): Promise<void> {\n  const service = ctx.resolve<ShippingCarrierService>('shippingCarrierService')\n  for (const shipmentId of job.payload.shipmentIds) {\n    await service.getTracking({\n      providerKey: job.payload.providerKey,\n      shipmentId,\n      organizationId: job.payload.scope.organizationId,\n      tenantId: job.payload.scope.tenantId,\n    })\n  }\n}\n"],
+  "mappings": "AAgBO,MAAM,WAAuB;AAAA,EAClC,OAAO;AAAA,EACP,IAAI;AAAA,EACJ,aAAa;AACf;AAEA,eAAO,OAA8B,KAAkC,KAAoC;AACzG,QAAM,UAAU,IAAI,QAAgC,wBAAwB;AAC5E,aAAW,cAAc,IAAI,QAAQ,aAAa;AAChD,UAAM,QAAQ,YAAY;AAAA,MACxB,aAAa,IAAI,QAAQ;AAAA,MACzB;AAAA,MACA,gBAAgB,IAAI,QAAQ,MAAM;AAAA,MAClC,UAAU,IAAI,QAAQ,MAAM;AAAA,IAC9B,CAAC;AAAA,EACH;AACF;",
+  "names": []
+}

package/dist/modules/shipping_carriers/workers/webhook-processor.js

@@ -0,0 +1,54 @@
+import { findOneWithDecryption } from "@open-mercato/shared/lib/encryption/find";
+import { CarrierShipment } from "../data/entities.js";
+import { emitShippingEvent } from "../events.js";
+import { getShippingAdapter } from "../lib/adapter-registry.js";
+import { getTerminalShippingEvent, syncShipmentStatus, TERMINAL_SHIPPING_STATUSES } from "../lib/status-sync.js";
+const metadata = {
+  queue: "shipping-carriers-webhook",
+  id: "shipping-carriers:webhook-processor",
+  concurrency: 5
+};
+async function handle(job, ctx) {
+  const em = ctx.resolve("em");
+  const adapter = getShippingAdapter(job.payload.providerKey);
+  if (!adapter) return;
+  const shipment = job.payload.shipmentId && job.payload.scope ? await findOneWithDecryption(
+    em,
+    CarrierShipment,
+    {
+      id: job.payload.shipmentId,
+      organizationId: job.payload.scope.organizationId,
+      tenantId: job.payload.scope.tenantId,
+      deletedAt: null
+    },
+    void 0,
+    job.payload.scope
+  ) : null;
+  if (!shipment) return;
+  const carrierStatus = typeof job.payload.event.data.status === "string" ? job.payload.event.data.status : job.payload.event.eventType;
+  const unifiedStatus = adapter.mapStatus(carrierStatus);
+  shipment.carrierStatus = carrierStatus;
+  shipment.lastWebhookAt = /* @__PURE__ */ new Date();
+  const transitionApplied = syncShipmentStatus(shipment, unifiedStatus);
+  if (!transitionApplied) return;
+  await em.flush();
+  const eventPayload = {
+    shipmentId: shipment.id,
+    providerKey: job.payload.providerKey,
+    previousStatus: carrierStatus,
+    newStatus: unifiedStatus,
+    organizationId: shipment.organizationId,
+    tenantId: shipment.tenantId
+  };
+  await emitShippingEvent("shipping_carriers.shipment.status_changed", eventPayload);
+  if (TERMINAL_SHIPPING_STATUSES.has(unifiedStatus)) {
+    const terminalEvent = getTerminalShippingEvent(unifiedStatus);
+    if (!terminalEvent) return;
+    await emitShippingEvent(terminalEvent, eventPayload);
+  }
+}
+export {
+  handle as default,
+  metadata
+};
+//# sourceMappingURL=webhook-processor.js.map

package/dist/modules/shipping_carriers/workers/webhook-processor.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/modules/shipping_carriers/workers/webhook-processor.ts"],
+  "sourcesContent": ["import type { EntityManager } from '@mikro-orm/postgresql'\nimport type { JobContext, QueuedJob, WorkerMeta } from '@open-mercato/queue'\nimport { findOneWithDecryption } from '@open-mercato/shared/lib/encryption/find'\nimport { CarrierShipment } from '../data/entities'\nimport { emitShippingEvent } from '../events'\nimport { getShippingAdapter } from '../lib/adapter-registry'\nimport { getTerminalShippingEvent, syncShipmentStatus, TERMINAL_SHIPPING_STATUSES } from '../lib/status-sync'\n\ntype WebhookJobPayload = {\n  providerKey: string\n  event: {\n    eventType: string\n    data: Record<string, unknown>\n  }\n  shipmentId?: string | null\n  scope?: {\n    organizationId: string\n    tenantId: string\n  } | null\n}\n\ntype HandlerContext = JobContext & {\n  resolve: <T = unknown>(name: string) => T\n}\n\nexport const metadata: WorkerMeta = {\n  queue: 'shipping-carriers-webhook',\n  id: 'shipping-carriers:webhook-processor',\n  concurrency: 5,\n}\n\nexport default async function handle(job: QueuedJob<WebhookJobPayload>, ctx: HandlerContext): Promise<void> {\n  const em = ctx.resolve<EntityManager>('em')\n  const adapter = getShippingAdapter(job.payload.providerKey)\n  if (!adapter) return\n\n  const shipment = job.payload.shipmentId && job.payload.scope\n    ? await findOneWithDecryption(\n      em,\n      CarrierShipment,\n      {\n        id: job.payload.shipmentId,\n        organizationId: job.payload.scope.organizationId,\n        tenantId: job.payload.scope.tenantId,\n        deletedAt: null,\n      },\n      undefined,\n      job.payload.scope,\n    )\n    : null\n  if (!shipment) return\n\n  const carrierStatus = typeof job.payload.event.data.status === 'string'\n    ? job.payload.event.data.status\n    : job.payload.event.eventType\n  const unifiedStatus = adapter.mapStatus(carrierStatus)\n  shipment.carrierStatus = carrierStatus\n  shipment.lastWebhookAt = new Date()\n\n  const transitionApplied = syncShipmentStatus(shipment, unifiedStatus)\n  if (!transitionApplied) return\n\n  await em.flush()\n\n  const eventPayload = {\n    shipmentId: shipment.id,\n    providerKey: job.payload.providerKey,\n    previousStatus: carrierStatus,\n    newStatus: unifiedStatus,\n    organizationId: shipment.organizationId,\n    tenantId: shipment.tenantId,\n  }\n  await emitShippingEvent('shipping_carriers.shipment.status_changed', eventPayload)\n  if (TERMINAL_SHIPPING_STATUSES.has(unifiedStatus)) {\n    const terminalEvent = getTerminalShippingEvent(unifiedStatus)\n    if (!terminalEvent) return\n    await emitShippingEvent(terminalEvent, eventPayload)\n  }\n}\n"],
+  "mappings": "AAEA,SAAS,6BAA6B;AACtC,SAAS,uBAAuB;AAChC,SAAS,yBAAyB;AAClC,SAAS,0BAA0B;AACnC,SAAS,0BAA0B,oBAAoB,kCAAkC;AAmBlF,MAAM,WAAuB;AAAA,EAClC,OAAO;AAAA,EACP,IAAI;AAAA,EACJ,aAAa;AACf;AAEA,eAAO,OAA8B,KAAmC,KAAoC;AAC1G,QAAM,KAAK,IAAI,QAAuB,IAAI;AAC1C,QAAM,UAAU,mBAAmB,IAAI,QAAQ,WAAW;AAC1D,MAAI,CAAC,QAAS;AAEd,QAAM,WAAW,IAAI,QAAQ,cAAc,IAAI,QAAQ,QACnD,MAAM;AAAA,IACN;AAAA,IACA;AAAA,IACA;AAAA,MACE,IAAI,IAAI,QAAQ;AAAA,MAChB,gBAAgB,IAAI,QAAQ,MAAM;AAAA,MAClC,UAAU,IAAI,QAAQ,MAAM;AAAA,MAC5B,WAAW;AAAA,IACb;AAAA,IACA;AAAA,IACA,IAAI,QAAQ;AAAA,EACd,IACE;AACJ,MAAI,CAAC,SAAU;AAEf,QAAM,gBAAgB,OAAO,IAAI,QAAQ,MAAM,KAAK,WAAW,WAC3D,IAAI,QAAQ,MAAM,KAAK,SACvB,IAAI,QAAQ,MAAM;AACtB,QAAM,gBAAgB,QAAQ,UAAU,aAAa;AACrD,WAAS,gBAAgB;AACzB,WAAS,gBAAgB,oBAAI,KAAK;AAElC,QAAM,oBAAoB,mBAAmB,UAAU,aAAa;AACpE,MAAI,CAAC,kBAAmB;AAExB,QAAM,GAAG,MAAM;AAEf,QAAM,eAAe;AAAA,IACnB,YAAY,SAAS;AAAA,IACrB,aAAa,IAAI,QAAQ;AAAA,IACzB,gBAAgB;AAAA,IAChB,WAAW;AAAA,IACX,gBAAgB,SAAS;AAAA,IACzB,UAAU,SAAS;AAAA,EACrB;AACA,QAAM,kBAAkB,6CAA6C,YAAY;AACjF,MAAI,2BAA2B,IAAI,aAAa,GAAG;AACjD,UAAM,gBAAgB,yBAAyB,aAAa;AAC5D,QAAI,CAAC,cAAe;AACpB,UAAM,kBAAkB,eAAe,YAAY;AAAA,EACrD;AACF;",
+  "names": []
+}

package/dist/modules/translations/api/get/locales.js

@@ -4,6 +4,7 @@ import { resolveTranslationsRouteContext } from "@open-mercato/core/modules/tran
 import { CrudHttpError } from "@open-mercato/shared/lib/crud/errors";
 import { locales as defaultLocales } from "@open-mercato/shared/lib/i18n/config";
 const metadata = {
+  path: "/translations/locales",
   GET: { requireAuth: true, requireFeatures: ["translations.view"] }
 };
 async function GET(req) {

package/dist/modules/translations/api/get/locales.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../../src/modules/translations/api/get/locales.ts"],
-  "sourcesContent": ["import { NextResponse } from 'next/server'\nimport { z } from 'zod'\nimport { resolveTranslationsRouteContext } from '@open-mercato/core/modules/translations/api/context'\nimport { CrudHttpError } from '@open-mercato/shared/lib/crud/errors'\nimport { locales as defaultLocales } from '@open-mercato/shared/lib/i18n/config'\nimport type { ModuleConfigService } from '@open-mercato/core/modules/configs/lib/module-config-service'\nimport type { OpenApiMethodDoc, OpenApiRouteDoc } from '@open-mercato/shared/lib/openapi'\n\nexport const metadata = {\n  GET: { requireAuth: true, requireFeatures: ['translations.view'] },\n}\n\nasync function GET(req: Request) {\n  try {\n    const context = await resolveTranslationsRouteContext(req)\n\n    const configService = context.container.resolve('moduleConfigService') as ModuleConfigService\n    const locales = await configService.getValue<string[]>('translations', 'supported_locales', {\n      defaultValue: [...defaultLocales],\n    })\n\n    return NextResponse.json({ locales: Array.isArray(locales) ? locales : [...defaultLocales] })\n  } catch (err) {\n    if (err instanceof CrudHttpError) {\n      return NextResponse.json(err.body, { status: err.status })\n    }\n    console.error('[translations/locales.GET] Unexpected error', err)\n    return NextResponse.json({ error: 'Internal server error' }, { status: 500 })\n  }\n}\n\nconst responseSchema = z.object({\n  locales: z.array(z.string()),\n})\n\nconst getDoc: OpenApiMethodDoc = {\n  summary: 'List supported translation locales',\n  tags: ['Translations'],\n  responses: [\n    { status: 200, description: 'Supported locales list', schema: responseSchema },\n  ],\n}\n\nexport const openApi: OpenApiRouteDoc = {\n  tag: 'Translations',\n  summary: 'List supported translation locales',\n  methods: {\n    GET: getDoc,\n  },\n}\n\nexport default GET\n"],
-  "mappings": "AAAA,SAAS,oBAAoB;AAC7B,SAAS,SAAS;AAClB,SAAS,uCAAuC;AAChD,SAAS,qBAAqB;AAC9B,SAAS,WAAW,sBAAsB;AAInC,MAAM,WAAW;AAAA,EACtB,KAAK,EAAE,aAAa,MAAM,iBAAiB,CAAC,mBAAmB,EAAE;AACnE;AAEA,eAAe,IAAI,KAAc;AAC/B,MAAI;AACF,UAAM,UAAU,MAAM,gCAAgC,GAAG;AAEzD,UAAM,gBAAgB,QAAQ,UAAU,QAAQ,qBAAqB;AACrE,UAAM,UAAU,MAAM,cAAc,SAAmB,gBAAgB,qBAAqB;AAAA,MAC1F,cAAc,CAAC,GAAG,cAAc;AAAA,IAClC,CAAC;AAED,WAAO,aAAa,KAAK,EAAE,SAAS,MAAM,QAAQ,OAAO,IAAI,UAAU,CAAC,GAAG,cAAc,EAAE,CAAC;AAAA,EAC9F,SAAS,KAAK;AACZ,QAAI,eAAe,eAAe;AAChC,aAAO,aAAa,KAAK,IAAI,MAAM,EAAE,QAAQ,IAAI,OAAO,CAAC;AAAA,IAC3D;AACA,YAAQ,MAAM,+CAA+C,GAAG;AAChE,WAAO,aAAa,KAAK,EAAE,OAAO,wBAAwB,GAAG,EAAE,QAAQ,IAAI,CAAC;AAAA,EAC9E;AACF;AAEA,MAAM,iBAAiB,EAAE,OAAO;AAAA,EAC9B,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC;AAC7B,CAAC;AAED,MAAM,SAA2B;AAAA,EAC/B,SAAS;AAAA,EACT,MAAM,CAAC,cAAc;AAAA,EACrB,WAAW;AAAA,IACT,EAAE,QAAQ,KAAK,aAAa,0BAA0B,QAAQ,eAAe;AAAA,EAC/E;AACF;AAEO,MAAM,UAA2B;AAAA,EACtC,KAAK;AAAA,EACL,SAAS;AAAA,EACT,SAAS;AAAA,IACP,KAAK;AAAA,EACP;AACF;AAEA,IAAO,kBAAQ;",
+  "sourcesContent": ["import { NextResponse } from 'next/server'\nimport { z } from 'zod'\nimport { resolveTranslationsRouteContext } from '@open-mercato/core/modules/translations/api/context'\nimport { CrudHttpError } from '@open-mercato/shared/lib/crud/errors'\nimport { locales as defaultLocales } from '@open-mercato/shared/lib/i18n/config'\nimport type { ModuleConfigService } from '@open-mercato/core/modules/configs/lib/module-config-service'\nimport type { OpenApiMethodDoc, OpenApiRouteDoc } from '@open-mercato/shared/lib/openapi'\n\nexport const metadata = {\n  path: '/translations/locales',\n  GET: { requireAuth: true, requireFeatures: ['translations.view'] },\n}\n\nasync function GET(req: Request) {\n  try {\n    const context = await resolveTranslationsRouteContext(req)\n\n    const configService = context.container.resolve('moduleConfigService') as ModuleConfigService\n    const locales = await configService.getValue<string[]>('translations', 'supported_locales', {\n      defaultValue: [...defaultLocales],\n    })\n\n    return NextResponse.json({ locales: Array.isArray(locales) ? locales : [...defaultLocales] })\n  } catch (err) {\n    if (err instanceof CrudHttpError) {\n      return NextResponse.json(err.body, { status: err.status })\n    }\n    console.error('[translations/locales.GET] Unexpected error', err)\n    return NextResponse.json({ error: 'Internal server error' }, { status: 500 })\n  }\n}\n\nconst responseSchema = z.object({\n  locales: z.array(z.string()),\n})\n\nconst getDoc: OpenApiMethodDoc = {\n  summary: 'List supported translation locales',\n  tags: ['Translations'],\n  responses: [\n    { status: 200, description: 'Supported locales list', schema: responseSchema },\n  ],\n}\n\nexport const openApi: OpenApiRouteDoc = {\n  tag: 'Translations',\n  summary: 'List supported translation locales',\n  methods: {\n    GET: getDoc,\n  },\n}\n\nexport default GET\n"],
+  "mappings": "AAAA,SAAS,oBAAoB;AAC7B,SAAS,SAAS;AAClB,SAAS,uCAAuC;AAChD,SAAS,qBAAqB;AAC9B,SAAS,WAAW,sBAAsB;AAInC,MAAM,WAAW;AAAA,EACtB,MAAM;AAAA,EACN,KAAK,EAAE,aAAa,MAAM,iBAAiB,CAAC,mBAAmB,EAAE;AACnE;AAEA,eAAe,IAAI,KAAc;AAC/B,MAAI;AACF,UAAM,UAAU,MAAM,gCAAgC,GAAG;AAEzD,UAAM,gBAAgB,QAAQ,UAAU,QAAQ,qBAAqB;AACrE,UAAM,UAAU,MAAM,cAAc,SAAmB,gBAAgB,qBAAqB;AAAA,MAC1F,cAAc,CAAC,GAAG,cAAc;AAAA,IAClC,CAAC;AAED,WAAO,aAAa,KAAK,EAAE,SAAS,MAAM,QAAQ,OAAO,IAAI,UAAU,CAAC,GAAG,cAAc,EAAE,CAAC;AAAA,EAC9F,SAAS,KAAK;AACZ,QAAI,eAAe,eAAe;AAChC,aAAO,aAAa,KAAK,IAAI,MAAM,EAAE,QAAQ,IAAI,OAAO,CAAC;AAAA,IAC3D;AACA,YAAQ,MAAM,+CAA+C,GAAG;AAChE,WAAO,aAAa,KAAK,EAAE,OAAO,wBAAwB,GAAG,EAAE,QAAQ,IAAI,CAAC;AAAA,EAC9E;AACF;AAEA,MAAM,iBAAiB,EAAE,OAAO;AAAA,EAC9B,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC;AAC7B,CAAC;AAED,MAAM,SAA2B;AAAA,EAC/B,SAAS;AAAA,EACT,MAAM,CAAC,cAAc;AAAA,EACrB,WAAW;AAAA,IACT,EAAE,QAAQ,KAAK,aAAa,0BAA0B,QAAQ,eAAe;AAAA,EAC/E;AACF;AAEO,MAAM,UAA2B;AAAA,EACtC,KAAK;AAAA,EACL,SAAS;AAAA,EACT,SAAS;AAAA,IACP,KAAK;AAAA,EACP;AACF;AAEA,IAAO,kBAAQ;",
   "names": []
 }

package/dist/modules/translations/api/put/locales.js

@@ -9,6 +9,7 @@ const bodySchema = z.object({
   ).min(1).max(50)
 });
 const metadata = {
+  path: "/translations/locales",
   PUT: { requireAuth: true, requireFeatures: ["translations.manage_locales"] }
 };
 async function PUT(req) {

package/dist/modules/translations/api/put/locales.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../../src/modules/translations/api/put/locales.ts"],
-  "sourcesContent": ["import { NextResponse } from 'next/server'\nimport { z } from 'zod'\nimport { resolveTranslationsRouteContext } from '@open-mercato/core/modules/translations/api/context'\nimport { CrudHttpError } from '@open-mercato/shared/lib/crud/errors'\nimport { isValidIso639 } from '@open-mercato/shared/lib/i18n/iso639'\nimport type { ModuleConfigService } from '@open-mercato/core/modules/configs/lib/module-config-service'\nimport type { OpenApiMethodDoc, OpenApiRouteDoc } from '@open-mercato/shared/lib/openapi'\n\nconst bodySchema = z.object({\n  locales: z.array(\n    z.string().min(2).max(10).refine(isValidIso639, { message: 'Invalid ISO 639-1 language code' }),\n  ).min(1).max(50),\n})\n\nexport const metadata = {\n  PUT: { requireAuth: true, requireFeatures: ['translations.manage_locales'] },\n}\n\nasync function PUT(req: Request) {\n  try {\n    const context = await resolveTranslationsRouteContext(req)\n    const body = bodySchema.parse(await req.json())\n    const uniqueLocales = [...new Set(body.locales.map((l) => l.toLowerCase().trim()))]\n\n    const configService = context.container.resolve('moduleConfigService') as ModuleConfigService\n    await configService.setValue('translations', 'supported_locales', uniqueLocales)\n\n    return NextResponse.json({ locales: uniqueLocales })\n  } catch (err) {\n    if (err instanceof CrudHttpError) {\n      return NextResponse.json(err.body, { status: err.status })\n    }\n    if (err instanceof z.ZodError) {\n      return NextResponse.json({ error: 'Invalid request', details: err.issues }, { status: 400 })\n    }\n    console.error('[translations/locales.PUT] Unexpected error', err)\n    return NextResponse.json({ error: 'Internal server error' }, { status: 500 })\n  }\n}\n\nconst responseSchema = z.object({\n  locales: z.array(z.string()),\n})\n\nconst putDoc: OpenApiMethodDoc = {\n  summary: 'Update supported translation locales',\n  tags: ['Translations'],\n  requestBody: {\n    schema: bodySchema,\n  },\n  responses: [\n    { status: 200, description: 'Updated locales list', schema: responseSchema },\n  ],\n  errors: [\n    { status: 400, description: 'Invalid request body' },\n  ],\n}\n\nexport const openApi: OpenApiRouteDoc = {\n  tag: 'Translations',\n  summary: 'Update supported translation locales',\n  methods: {\n    PUT: putDoc,\n  },\n}\n\nexport default PUT\n"],
-  "mappings": "AAAA,SAAS,oBAAoB;AAC7B,SAAS,SAAS;AAClB,SAAS,uCAAuC;AAChD,SAAS,qBAAqB;AAC9B,SAAS,qBAAqB;AAI9B,MAAM,aAAa,EAAE,OAAO;AAAA,EAC1B,SAAS,EAAE;AAAA,IACT,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,IAAI,EAAE,EAAE,OAAO,eAAe,EAAE,SAAS,kCAAkC,CAAC;AAAA,EAChG,EAAE,IAAI,CAAC,EAAE,IAAI,EAAE;AACjB,CAAC;AAEM,MAAM,WAAW;AAAA,EACtB,KAAK,EAAE,aAAa,MAAM,iBAAiB,CAAC,6BAA6B,EAAE;AAC7E;AAEA,eAAe,IAAI,KAAc;AAC/B,MAAI;AACF,UAAM,UAAU,MAAM,gCAAgC,GAAG;AACzD,UAAM,OAAO,WAAW,MAAM,MAAM,IAAI,KAAK,CAAC;AAC9C,UAAM,gBAAgB,CAAC,GAAG,IAAI,IAAI,KAAK,QAAQ,IAAI,CAAC,MAAM,EAAE,YAAY,EAAE,KAAK,CAAC,CAAC,CAAC;AAElF,UAAM,gBAAgB,QAAQ,UAAU,QAAQ,qBAAqB;AACrE,UAAM,cAAc,SAAS,gBAAgB,qBAAqB,aAAa;AAE/E,WAAO,aAAa,KAAK,EAAE,SAAS,cAAc,CAAC;AAAA,EACrD,SAAS,KAAK;AACZ,QAAI,eAAe,eAAe;AAChC,aAAO,aAAa,KAAK,IAAI,MAAM,EAAE,QAAQ,IAAI,OAAO,CAAC;AAAA,IAC3D;AACA,QAAI,eAAe,EAAE,UAAU;AAC7B,aAAO,aAAa,KAAK,EAAE,OAAO,mBAAmB,SAAS,IAAI,OAAO,GAAG,EAAE,QAAQ,IAAI,CAAC;AAAA,IAC7F;AACA,YAAQ,MAAM,+CAA+C,GAAG;AAChE,WAAO,aAAa,KAAK,EAAE,OAAO,wBAAwB,GAAG,EAAE,QAAQ,IAAI,CAAC;AAAA,EAC9E;AACF;AAEA,MAAM,iBAAiB,EAAE,OAAO;AAAA,EAC9B,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC;AAC7B,CAAC;AAED,MAAM,SAA2B;AAAA,EAC/B,SAAS;AAAA,EACT,MAAM,CAAC,cAAc;AAAA,EACrB,aAAa;AAAA,IACX,QAAQ;AAAA,EACV;AAAA,EACA,WAAW;AAAA,IACT,EAAE,QAAQ,KAAK,aAAa,wBAAwB,QAAQ,eAAe;AAAA,EAC7E;AAAA,EACA,QAAQ;AAAA,IACN,EAAE,QAAQ,KAAK,aAAa,uBAAuB;AAAA,EACrD;AACF;AAEO,MAAM,UAA2B;AAAA,EACtC,KAAK;AAAA,EACL,SAAS;AAAA,EACT,SAAS;AAAA,IACP,KAAK;AAAA,EACP;AACF;AAEA,IAAO,kBAAQ;",
+  "sourcesContent": ["import { NextResponse } from 'next/server'\nimport { z } from 'zod'\nimport { resolveTranslationsRouteContext } from '@open-mercato/core/modules/translations/api/context'\nimport { CrudHttpError } from '@open-mercato/shared/lib/crud/errors'\nimport { isValidIso639 } from '@open-mercato/shared/lib/i18n/iso639'\nimport type { ModuleConfigService } from '@open-mercato/core/modules/configs/lib/module-config-service'\nimport type { OpenApiMethodDoc, OpenApiRouteDoc } from '@open-mercato/shared/lib/openapi'\n\nconst bodySchema = z.object({\n  locales: z.array(\n    z.string().min(2).max(10).refine(isValidIso639, { message: 'Invalid ISO 639-1 language code' }),\n  ).min(1).max(50),\n})\n\nexport const metadata = {\n  path: '/translations/locales',\n  PUT: { requireAuth: true, requireFeatures: ['translations.manage_locales'] },\n}\n\nasync function PUT(req: Request) {\n  try {\n    const context = await resolveTranslationsRouteContext(req)\n    const body = bodySchema.parse(await req.json())\n    const uniqueLocales = [...new Set(body.locales.map((l) => l.toLowerCase().trim()))]\n\n    const configService = context.container.resolve('moduleConfigService') as ModuleConfigService\n    await configService.setValue('translations', 'supported_locales', uniqueLocales)\n\n    return NextResponse.json({ locales: uniqueLocales })\n  } catch (err) {\n    if (err instanceof CrudHttpError) {\n      return NextResponse.json(err.body, { status: err.status })\n    }\n    if (err instanceof z.ZodError) {\n      return NextResponse.json({ error: 'Invalid request', details: err.issues }, { status: 400 })\n    }\n    console.error('[translations/locales.PUT] Unexpected error', err)\n    return NextResponse.json({ error: 'Internal server error' }, { status: 500 })\n  }\n}\n\nconst responseSchema = z.object({\n  locales: z.array(z.string()),\n})\n\nconst putDoc: OpenApiMethodDoc = {\n  summary: 'Update supported translation locales',\n  tags: ['Translations'],\n  requestBody: {\n    schema: bodySchema,\n  },\n  responses: [\n    { status: 200, description: 'Updated locales list', schema: responseSchema },\n  ],\n  errors: [\n    { status: 400, description: 'Invalid request body' },\n  ],\n}\n\nexport const openApi: OpenApiRouteDoc = {\n  tag: 'Translations',\n  summary: 'Update supported translation locales',\n  methods: {\n    PUT: putDoc,\n  },\n}\n\nexport default PUT\n"],
+  "mappings": "AAAA,SAAS,oBAAoB;AAC7B,SAAS,SAAS;AAClB,SAAS,uCAAuC;AAChD,SAAS,qBAAqB;AAC9B,SAAS,qBAAqB;AAI9B,MAAM,aAAa,EAAE,OAAO;AAAA,EAC1B,SAAS,EAAE;AAAA,IACT,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,IAAI,EAAE,EAAE,OAAO,eAAe,EAAE,SAAS,kCAAkC,CAAC;AAAA,EAChG,EAAE,IAAI,CAAC,EAAE,IAAI,EAAE;AACjB,CAAC;AAEM,MAAM,WAAW;AAAA,EACtB,MAAM;AAAA,EACN,KAAK,EAAE,aAAa,MAAM,iBAAiB,CAAC,6BAA6B,EAAE;AAC7E;AAEA,eAAe,IAAI,KAAc;AAC/B,MAAI;AACF,UAAM,UAAU,MAAM,gCAAgC,GAAG;AACzD,UAAM,OAAO,WAAW,MAAM,MAAM,IAAI,KAAK,CAAC;AAC9C,UAAM,gBAAgB,CAAC,GAAG,IAAI,IAAI,KAAK,QAAQ,IAAI,CAAC,MAAM,EAAE,YAAY,EAAE,KAAK,CAAC,CAAC,CAAC;AAElF,UAAM,gBAAgB,QAAQ,UAAU,QAAQ,qBAAqB;AACrE,UAAM,cAAc,SAAS,gBAAgB,qBAAqB,aAAa;AAE/E,WAAO,aAAa,KAAK,EAAE,SAAS,cAAc,CAAC;AAAA,EACrD,SAAS,KAAK;AACZ,QAAI,eAAe,eAAe;AAChC,aAAO,aAAa,KAAK,IAAI,MAAM,EAAE,QAAQ,IAAI,OAAO,CAAC;AAAA,IAC3D;AACA,QAAI,eAAe,EAAE,UAAU;AAC7B,aAAO,aAAa,KAAK,EAAE,OAAO,mBAAmB,SAAS,IAAI,OAAO,GAAG,EAAE,QAAQ,IAAI,CAAC;AAAA,IAC7F;AACA,YAAQ,MAAM,+CAA+C,GAAG;AAChE,WAAO,aAAa,KAAK,EAAE,OAAO,wBAAwB,GAAG,EAAE,QAAQ,IAAI,CAAC;AAAA,EAC9E;AACF;AAEA,MAAM,iBAAiB,EAAE,OAAO;AAAA,EAC9B,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC;AAC7B,CAAC;AAED,MAAM,SAA2B;AAAA,EAC/B,SAAS;AAAA,EACT,MAAM,CAAC,cAAc;AAAA,EACrB,aAAa;AAAA,IACX,QAAQ;AAAA,EACV;AAAA,EACA,WAAW;AAAA,IACT,EAAE,QAAQ,KAAK,aAAa,wBAAwB,QAAQ,eAAe;AAAA,EAC7E;AAAA,EACA,QAAQ;AAAA,IACN,EAAE,QAAQ,KAAK,aAAa,uBAAuB;AAAA,EACrD;AACF;AAEO,MAAM,UAA2B;AAAA,EACtC,KAAK;AAAA,EACL,SAAS;AAAA,EACT,SAAS;AAAA,IACP,KAAK;AAAA,EACP;AACF;AAEA,IAAO,kBAAQ;",
   "names": []
 }

package/generated/entities/carrier_shipment/index.ts

@@ -0,0 +1,17 @@
+export const id = 'id'
+export const order_id = 'order_id'
+export const provider_key = 'provider_key'
+export const carrier_shipment_id = 'carrier_shipment_id'
+export const tracking_number = 'tracking_number'
+export const unified_status = 'unified_status'
+export const carrier_status = 'carrier_status'
+export const label_url = 'label_url'
+export const label_data = 'label_data'
+export const tracking_events = 'tracking_events'
+export const organization_id = 'organization_id'
+export const tenant_id = 'tenant_id'
+export const last_webhook_at = 'last_webhook_at'
+export const last_polled_at = 'last_polled_at'
+export const created_at = 'created_at'
+export const updated_at = 'updated_at'
+export const deleted_at = 'deleted_at'

package/generated/entities/gateway_transaction/index.ts

@@ -0,0 +1,22 @@
+export const id = 'id'
+export const payment_id = 'payment_id'
+export const provider_key = 'provider_key'
+export const provider_session_id = 'provider_session_id'
+export const gateway_payment_id = 'gateway_payment_id'
+export const gateway_refund_id = 'gateway_refund_id'
+export const unified_status = 'unified_status'
+export const gateway_status = 'gateway_status'
+export const redirect_url = 'redirect_url'
+export const client_secret = 'client_secret'
+export const amount = 'amount'
+export const currency_code = 'currency_code'
+export const gateway_metadata = 'gateway_metadata'
+export const webhook_log = 'webhook_log'
+export const last_webhook_at = 'last_webhook_at'
+export const last_polled_at = 'last_polled_at'
+export const expires_at = 'expires_at'
+export const organization_id = 'organization_id'
+export const tenant_id = 'tenant_id'
+export const created_at = 'created_at'
+export const updated_at = 'updated_at'
+export const deleted_at = 'deleted_at'

package/generated/entities/webhook_processed_event/index.ts

@@ -0,0 +1,7 @@
+export const id = 'id'
+export const provider_key = 'provider_key'
+export const idempotency_key = 'idempotency_key'
+export const event_type = 'event_type'
+export const organization_id = 'organization_id'
+export const tenant_id = 'tenant_id'
+export const processed_at = 'processed_at'

package/generated/entities.ids.generated.ts

@@ -28,7 +28,9 @@ export const M = {
   "data_sync": "data_sync",
   "messages": "messages",
   "translations": "translations",
-  "inbox_ops": "inbox_ops"
+  "inbox_ops": "inbox_ops",
+  "payment_gateways": "payment_gateways",
+  "shipping_carriers": "shipping_carriers"
 } as const
 export const E = {
   "dashboards": {
@@ -228,6 +230,13 @@ export const E = {
     "inbox_proposal": "inbox_ops:inbox_proposal",
     "inbox_proposal_action": "inbox_ops:inbox_proposal_action",
     "inbox_discrepancy": "inbox_ops:inbox_discrepancy"
+  },
+  "payment_gateways": {
+    "gateway_transaction": "payment_gateways:gateway_transaction",
+    "webhook_processed_event": "payment_gateways:webhook_processed_event"
+  },
+  "shipping_carriers": {
+    "carrier_shipment": "shipping_carriers:carrier_shipment"
   }
 } as const
 export type KnownModuleId = keyof typeof M

package/generated/entity-fields-registry.ts

@@ -6,6 +6,7 @@ import * as api_key from './entities/api_key/index'
 import * as attachment from './entities/attachment/index'
 import * as attachment_partition from './entities/attachment_partition/index'
 import * as business_rule from './entities/business_rule/index'
+import * as carrier_shipment from './entities/carrier_shipment/index'
 import * as catalog_offer from './entities/catalog_offer/index'
 import * as catalog_option_schema_template from './entities/catalog_option_schema_template/index'
 import * as catalog_price_kind from './entities/catalog_price_kind/index'
@@ -54,6 +55,7 @@ import * as entity_translation from './entities/entity_translation/index'
 import * as exchange_rate from './entities/exchange_rate/index'
 import * as feature_toggle from './entities/feature_toggle/index'
 import * as feature_toggle_override from './entities/feature_toggle_override/index'
+import * as gateway_transaction from './entities/gateway_transaction/index'
 import * as inbox_discrepancy from './entities/inbox_discrepancy/index'
 import * as inbox_email from './entities/inbox_email/index'
 import * as inbox_proposal from './entities/inbox_proposal/index'
@@ -138,6 +140,7 @@ import * as user_acl from './entities/user_acl/index'
 import * as user_role from './entities/user_role/index'
 import * as user_sidebar_preference from './entities/user_sidebar_preference/index'
 import * as user_task from './entities/user_task/index'
+import * as webhook_processed_event from './entities/webhook_processed_event/index'
 import * as workflow_definition from './entities/workflow_definition/index'
 import * as workflow_event from './entities/workflow_event/index'
 import * as workflow_event_trigger from './entities/workflow_event_trigger/index'
@@ -150,6 +153,7 @@ export const entityFieldsRegistry: Record<string, Record<string, string>> = {
   attachment,
   attachment_partition,
   business_rule,
+  carrier_shipment,
   catalog_offer,
   catalog_option_schema_template,
   catalog_price_kind,
@@ -198,6 +202,7 @@ export const entityFieldsRegistry: Record<string, Record<string, string>> = {
   exchange_rate,
   feature_toggle,
   feature_toggle_override,
+  gateway_transaction,
   inbox_discrepancy,
   inbox_email,
   inbox_proposal,
@@ -282,6 +287,7 @@ export const entityFieldsRegistry: Record<string, Record<string, string>> = {
   user_role,
   user_sidebar_preference,
   user_task,
+  webhook_processed_event,
   workflow_definition,
   workflow_event,
   workflow_event_trigger,

package/jest.config.cjs

@@ -9,6 +9,7 @@ module.exports = {
     '^#generated/(.*)$': '<rootDir>/generated/$1',
     '^@open-mercato/core/generated/(.*)$': '<rootDir>/generated/$1',
     '^@open-mercato/core/(.*)$': '<rootDir>/src/$1',
+    '^@open-mercato/shared/(.*)$': '<rootDir>/../shared/src/$1',
     '^@/\\.mercato/generated/inbox-actions\\.generated$': '<rootDir>/jest.mocks/inbox-actions.generated.js',
     '^react-markdown$': '<rootDir>/jest.mocks/react-markdown.js',
     '^remark-gfm$': '<rootDir>/jest.mocks/remark-gfm.js',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@open-mercato/core",
-  "version": "0.4.7-develop-0a657b411f",
+  "version": "0.4.7-develop-e249d3e7d0",
   "type": "module",
   "main": "./dist/index.js",
   "scripts": {
@@ -207,7 +207,6 @@
     }
   },
   "dependencies": {
-    "@open-mercato/shared": "0.4.7-develop-0a657b411f",
     "@types/html-to-text": "^9.0.4",
     "@types/semver": "^7.5.8",
     "@xyflow/react": "^12.6.0",
@@ -217,7 +216,11 @@
     "html-to-text": "^9.0.5",
     "semver": "^7.6.3"
   },
+  "peerDependencies": {
+    "@open-mercato/shared": "0.4.7-develop-e249d3e7d0"
+  },
   "devDependencies": {
+    "@open-mercato/shared": "0.4.7-develop-e249d3e7d0",
     "@testing-library/dom": "^10.4.1",
     "@testing-library/jest-dom": "^6.9.1",
     "@testing-library/react": "^16.3.1",

package/src/modules/auth/i18n/de.json

@@ -155,6 +155,7 @@
   "auth.users.widgets.mode.inherit": "Von Rollen übernehmen",
   "auth.users.widgets.mode.override": "Für diesen Benutzer überschreiben",
   "auth.usersRoles": "Benutzer und Rollen",
+  "backend.nav.externalSystems": "Externe Systeme",
   "backend.nav.settings": "Einstellungen",
   "backend.nav.settingsAdmin": "Administration",
   "profile.page.description": "Verwalte deine Kontoeinstellungen",

package/src/modules/auth/i18n/en.json

@@ -155,6 +155,7 @@
   "auth.users.widgets.mode.inherit": "Inherit from roles",
   "auth.users.widgets.mode.override": "Override for this user",
   "auth.usersRoles": "Users & Roles",
+  "backend.nav.externalSystems": "External systems",
   "backend.nav.settings": "Settings",
   "backend.nav.settingsAdmin": "Administration",
   "profile.page.description": "Manage your account settings",

package/src/modules/auth/i18n/es.json

@@ -155,6 +155,7 @@
   "auth.users.widgets.mode.inherit": "Heredar de las funciones",
   "auth.users.widgets.mode.override": "Sobrescribir para este usuario",
   "auth.usersRoles": "Usuarios y roles",
+  "backend.nav.externalSystems": "Sistemas externos",
   "backend.nav.settings": "Configuración",
   "backend.nav.settingsAdmin": "Administración",
   "profile.page.description": "Administra la configuración de tu cuenta",

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

@@ -155,6 +155,7 @@
   "auth.users.widgets.mode.inherit": "Dziedzicz z ról",
   "auth.users.widgets.mode.override": "Zastąp dla tego użytkownika",
   "auth.usersRoles": "Użytkownicy i role",
+  "backend.nav.externalSystems": "Systemy zewnetrzne",
   "backend.nav.settings": "Ustawienia",
   "backend.nav.settingsAdmin": "Administracja",
   "profile.page.description": "Zarządzaj ustawieniami konta",

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

@@ -44,12 +44,25 @@ export async function POST(req: Request, ctx: { params?: Promise<{ id?: string }
     return NextResponse.json({ error: 'Only pending or running runs can be cancelled' }, { status: 409 })
   }
 
+  const progressCtx = {
+    tenantId: auth.tenantId,
+    organizationId: auth.orgId,
+    userId: auth.sub,
+  }
+
   if (run.progressJobId) {
-    await progressService.cancelJob(run.progressJobId, {
-      tenantId: auth.tenantId,
-      organizationId: auth.orgId,
-      userId: auth.sub,
-    })
+    try {
+      await progressService.cancelJob(run.progressJobId, progressCtx)
+    } catch (error) {
+      const job = await progressService.getJob(run.progressJobId, progressCtx)
+      const cancelRequested = job && job.status === 'running'
+        ? await progressService.isCancellationRequested(run.progressJobId)
+        : false
+
+      if (job?.status !== 'cancelled' && !cancelRequested) {
+        throw error
+      }
+    }
   }
 
   await syncRunService.markStatus(run.id, 'cancelled', scope)

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

@@ -12,8 +12,8 @@ export const metadata = {
   requireFeatures: ['data_sync.view'],
   pageTitle: 'Data Sync',
   pageTitleKey: 'data_sync.nav.title',
-  pageGroup: 'Settings',
-  pageGroupKey: 'settings.sections.general',
+  pageGroup: 'External systems',
+  pageGroupKey: 'backend.nav.externalSystems',
   pageOrder: 51,
   icon: syncIcon,
   pageContext: 'settings' as const,

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

@@ -1,7 +1,7 @@
 "use client"
 import * as React from 'react'
 import Link from 'next/link'
-import { useParams, useRouter } from 'next/navigation'
+import { usePathname, useRouter } from 'next/navigation'
 import { Page, PageBody } from '@open-mercato/ui/backend/Page'
 import { Card, CardHeader, CardTitle, CardContent } from '@open-mercato/ui/primitives/card'
 import { Badge } from '@open-mercato/ui/primitives/badge'
@@ -62,10 +62,28 @@ const LOG_LEVEL_STYLES: Record<string, string> = {
   error: 'bg-red-100 text-red-800',
 }
 
-export default function SyncRunDetailPage() {
-  const params = useParams<{ id: string }>()
+type SyncRunDetailPageProps = {
+  params?: {
+    id?: string | string[]
+  }
+}
+
+function resolveRouteId(value: string | string[] | undefined): string | undefined {
+  if (Array.isArray(value)) return value[0]
+  return value
+}
+
+function resolvePathnameId(pathname: string): string | undefined {
+  const parts = pathname.split('/').filter(Boolean)
+  const runId = parts.at(-1)
+  if (!runId || runId === 'runs' || runId === 'data-sync') return undefined
+  return decodeURIComponent(runId)
+}
+
+export default function SyncRunDetailPage({ params }: SyncRunDetailPageProps) {
+  const pathname = usePathname()
   const router = useRouter()
-  const runId = params.id
+  const runId = resolveRouteId(params?.id) ?? resolvePathnameId(pathname)
   const t = useT()
 
   const [run, setRun] = React.useState<SyncRunDetail | null>(null)
@@ -74,9 +92,23 @@ export default function SyncRunDetailPage() {
   const [logs, setLogs] = React.useState<LogEntry[]>([])
   const [isLoadingLogs, setIsLoadingLogs] = React.useState(false)
 
+  const resolveCurrentRunId = React.useCallback(() => {
+    return runId ?? (
+      typeof window !== 'undefined'
+        ? resolvePathnameId(window.location.pathname)
+        : undefined
+    )
+  }, [runId])
+
   const loadRun = React.useCallback(async () => {
+    const currentRunId = resolveCurrentRunId()
+    if (!currentRunId) {
+      setError(t('data_sync.runs.detail.loadError'))
+      setIsLoading(false)
+      return
+    }
     const call = await apiCall<SyncRunDetail>(
-      `/api/data_sync/runs/${encodeURIComponent(runId)}`,
+      `/api/data_sync/runs/${encodeURIComponent(currentRunId)}`,
       undefined,
       { fallback: null },
     )
@@ -87,11 +119,13 @@ export default function SyncRunDetailPage() {
     }
     setRun(call.result)
     setIsLoading(false)
-  }, [runId, t])
+  }, [resolveCurrentRunId, t])
 
   const loadLogs = React.useCallback(async () => {
+    const currentRunId = resolveCurrentRunId()
+    if (!currentRunId) return
     setIsLoadingLogs(true)
-    const params = new URLSearchParams({ runId, pageSize: '50' })
+    const params = new URLSearchParams({ runId: currentRunId, pageSize: '50' })
     const call = await apiCall<{ items: LogEntry[] }>(
       `/api/integrations/logs?${params.toString()}`,
       undefined,
@@ -101,7 +135,7 @@ export default function SyncRunDetailPage() {
       setLogs(call.result.items)
     }
     setIsLoadingLogs(false)
-  }, [runId])
+  }, [resolveCurrentRunId])
 
   React.useEffect(() => {
     void loadRun()
@@ -115,7 +149,9 @@ export default function SyncRunDetailPage() {
   }, [run?.status, loadRun])
 
   const handleCancel = React.useCallback(async () => {
-    const call = await apiCall(`/api/data_sync/runs/${encodeURIComponent(runId)}/cancel`, {
+    const currentRunId = resolveCurrentRunId()
+    if (!currentRunId) return
+    const call = await apiCall(`/api/data_sync/runs/${encodeURIComponent(currentRunId)}/cancel`, {
       method: 'POST',
     }, { fallback: null })
     if (call.ok) {
@@ -124,10 +160,12 @@ export default function SyncRunDetailPage() {
     } else {
       flash(t('data_sync.runs.detail.cancelError'), 'error')
     }
-  }, [runId, t, loadRun])
+  }, [resolveCurrentRunId, t, loadRun])
 
   const handleRetry = React.useCallback(async () => {
-    const call = await apiCall<{ id: string }>(`/api/data_sync/runs/${encodeURIComponent(runId)}/retry`, {
+    const currentRunId = resolveCurrentRunId()
+    if (!currentRunId) return
+    const call = await apiCall<{ id: string }>(`/api/data_sync/runs/${encodeURIComponent(currentRunId)}/retry`, {
       method: 'POST',
       headers: { 'Content-Type': 'application/json' },
       body: JSON.stringify({ fromBeginning: false }),
@@ -138,7 +176,7 @@ export default function SyncRunDetailPage() {
     } else {
       flash(t('data_sync.runs.detail.retryError'), 'error')
     }
-  }, [router, runId, t])
+  }, [resolveCurrentRunId, router, t])
 
   if (isLoading) return <Page><PageBody><LoadingMessage label={t('data_sync.runs.detail.title')} /></PageBody></Page>
   if (error || !run) return <Page><PageBody><ErrorMessage label={error ?? t('data_sync.runs.detail.loadError')} /></PageBody></Page>

package/src/modules/directory/api/get/tenants/lookup.ts

@@ -6,6 +6,7 @@ import { Tenant } from '@open-mercato/core/modules/directory/data/entities'
 import type { OpenApiMethodDoc, OpenApiRouteDoc } from '@open-mercato/shared/lib/openapi'
 
 export const metadata = {
+  path: '/directory/tenants/lookup',
   GET: {
     requireAuth: false,
   },

package/src/modules/integrations/AGENTS.md

@@ -119,6 +119,37 @@ Integration provider modules can leverage the full **Unified Module Extension Sy
 | **Notifications** | Emit in-app notifications on integration events | `notifications.ts`, `subscribers/` |
 | **DOM Event Bridge** | Push real-time events to browser (SSE) | Set `clientBroadcast: true` in event definitions |
 
+### Integration Detail Page Widget Spot
+
+Provider modules can opt into a provider-scoped integration detail extension surface directly from `integration.ts`:
+
+```typescript
+import { buildIntegrationDetailWidgetSpotId } from '@open-mercato/shared/modules/integrations/types'
+
+export const integration = {
+  id: 'gateway_example',
+  detailPage: {
+    widgetSpotId: buildIntegrationDetailWidgetSpotId('gateway_example'),
+  },
+} satisfies IntegrationDefinition
+```
+
+- Register React widgets for that spot in `widgets/injection-table.ts`
+- Use `placement.kind: 'tab'` to create additional detail tabs
+- Use `placement.kind: 'group'` for card-style panels and `placement.kind: 'stack'` for inline sections
+- Integration detail page writes run through `useGuardedMutation` with that same spot, so widget `onBeforeSave` / `onAfterSave` handlers apply to built-in credentials/state/version/health actions too
+- Backward compatibility: legacy `integrations.detail:tabs` still works as the fallback when `detailPage.widgetSpotId` is omitted
+
+### Marketplace API UMES Hooks
+
+The integrations marketplace read routes now support a safe subset of UMES:
+
+- `GET /api/integrations` and `GET /api/integrations/:id` support response enrichers targeting `integrations.integration`
+- `GET /api/integrations/logs` supports response enrichers targeting `integrations.log`
+- These read routes also execute API interceptors for their route IDs (`integrations`, `integrations/detail`, `integrations/logs`)
+- Safety rule: integrations read routes preserve built-in response keys and only accept additive fields from enrichers/interceptor-after hooks
+- Write routes (`credentials`, `state`, `version`) already support mutation guards and events; they are not yet wired into the generic API interceptor/enricher pipeline
+
 ### Key UMES Imports for Providers
 
 ```typescript