@open-mercato/core 0.4.6-develop-be2da141e3 → 0.4.6-develop-1f4478d60c

package/dist/modules/integrations/acl.js

@@ -0,0 +1,8 @@
+const features = [
+  { id: "integrations.view", title: "View integrations and external ID mappings", module: "integrations" },
+  { id: "integrations.manage", title: "Manage integration configurations", module: "integrations" }
+];
+export {
+  features
+};
+//# sourceMappingURL=acl.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/modules/integrations/acl.ts"],
+  "sourcesContent": ["export const features = [\n  { id: 'integrations.view', title: 'View integrations and external ID mappings', module: 'integrations' },\n  { id: 'integrations.manage', title: 'Manage integration configurations', module: 'integrations' },\n]\n"],
+  "mappings": "AAAO,MAAM,WAAW;AAAA,EACtB,EAAE,IAAI,qBAAqB,OAAO,8CAA8C,QAAQ,eAAe;AAAA,EACvG,EAAE,IAAI,uBAAuB,OAAO,qCAAqC,QAAQ,eAAe;AAClG;",
+  "names": []
+}

package/dist/modules/integrations/data/enrichers.js

@@ -0,0 +1,72 @@
+import { getIntegration } from "@open-mercato/shared/modules/integrations/types";
+import { SyncExternalIdMapping } from "./entities.js";
+function buildIntegrationData(mappings) {
+  const data = {};
+  for (const mapping of mappings) {
+    const definition = getIntegration(mapping.integrationId);
+    data[mapping.integrationId] = {
+      externalId: mapping.externalId,
+      externalUrl: definition?.buildExternalUrl?.(mapping.externalId),
+      lastSyncedAt: mapping.lastSyncedAt?.toISOString(),
+      syncStatus: mapping.syncStatus
+    };
+  }
+  return data;
+}
+const externalIdMappingEnricher = {
+  id: "integrations.external-id-mapping",
+  targetEntity: "*",
+  features: ["integrations.view"],
+  priority: 10,
+  timeout: 500,
+  critical: false,
+  fallback: {},
+  async enrichOne(record, context) {
+    const em = context.em.fork();
+    const targetEntity = context.targetEntity;
+    if (!targetEntity) return { ...record, _integrations: {} };
+    const mappings = await em.find(SyncExternalIdMapping, {
+      internalEntityType: targetEntity,
+      internalEntityId: record.id,
+      organizationId: context.organizationId,
+      deletedAt: null
+    });
+    if (mappings.length === 0) return { ...record, _integrations: {} };
+    return {
+      ...record,
+      _integrations: buildIntegrationData(mappings)
+    };
+  },
+  async enrichMany(records, context) {
+    const em = context.em.fork();
+    const targetEntity = context.targetEntity;
+    if (!targetEntity || records.length === 0) return records.map((r) => ({ ...r, _integrations: {} }));
+    const recordIds = records.map((r) => r.id);
+    const allMappings = await em.find(SyncExternalIdMapping, {
+      internalEntityType: targetEntity,
+      internalEntityId: { $in: recordIds },
+      organizationId: context.organizationId,
+      deletedAt: null
+    });
+    if (allMappings.length === 0) return records.map((r) => ({ ...r, _integrations: {} }));
+    const mappingsByRecord = /* @__PURE__ */ new Map();
+    for (const mapping of allMappings) {
+      const list = mappingsByRecord.get(mapping.internalEntityId) ?? [];
+      list.push(mapping);
+      mappingsByRecord.set(mapping.internalEntityId, list);
+    }
+    return records.map((record) => {
+      const mappings = mappingsByRecord.get(record.id);
+      if (!mappings || mappings.length === 0) return { ...record, _integrations: {} };
+      return {
+        ...record,
+        _integrations: buildIntegrationData(mappings)
+      };
+    });
+  }
+};
+const enrichers = [externalIdMappingEnricher];
+export {
+  enrichers
+};
+//# sourceMappingURL=enrichers.js.map

package/dist/modules/integrations/data/enrichers.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/modules/integrations/data/enrichers.ts"],
+  "sourcesContent": ["/**\n * External ID Mapping Enricher\n *\n * Enriches any entity's API response with external integration ID mappings.\n * Adds `_integrations` namespace containing all external IDs for the record.\n *\n * Uses batch queries via `enrichMany` to prevent N+1.\n */\n\nimport type { ResponseEnricher, EnricherContext } from '@open-mercato/shared/lib/crud/response-enricher'\nimport type { ExternalIdEnrichment } from '@open-mercato/shared/modules/integrations/types'\nimport { getIntegration } from '@open-mercato/shared/modules/integrations/types'\nimport { SyncExternalIdMapping } from './entities'\n\ntype EntityRecord = Record<string, unknown> & { id: string }\n\nfunction buildIntegrationData(\n  mappings: SyncExternalIdMapping[],\n): ExternalIdEnrichment['_integrations'] {\n  const data: ExternalIdEnrichment['_integrations'] = {}\n\n  for (const mapping of mappings) {\n    const definition = getIntegration(mapping.integrationId)\n    data[mapping.integrationId] = {\n      externalId: mapping.externalId,\n      externalUrl: definition?.buildExternalUrl?.(mapping.externalId),\n      lastSyncedAt: mapping.lastSyncedAt?.toISOString(),\n      syncStatus: mapping.syncStatus,\n    }\n  }\n\n  return data\n}\n\nconst externalIdMappingEnricher: ResponseEnricher<EntityRecord, ExternalIdEnrichment> = {\n  id: 'integrations.external-id-mapping',\n  targetEntity: '*',\n  features: ['integrations.view'],\n  priority: 10,\n  timeout: 500,\n  critical: false,\n  fallback: {},\n\n  async enrichOne(record, context: EnricherContext & { targetEntity?: string }) {\n    const em = (context.em as any).fork()\n    const targetEntity = (context as any).targetEntity as string | undefined\n    if (!targetEntity) return { ...record, _integrations: {} }\n\n    const mappings: SyncExternalIdMapping[] = await em.find(SyncExternalIdMapping, {\n      internalEntityType: targetEntity,\n      internalEntityId: record.id,\n      organizationId: context.organizationId,\n      deletedAt: null,\n    })\n\n    if (mappings.length === 0) return { ...record, _integrations: {} }\n\n    return {\n      ...record,\n      _integrations: buildIntegrationData(mappings),\n    }\n  },\n\n  async enrichMany(records, context: EnricherContext & { targetEntity?: string }) {\n    const em = (context.em as any).fork()\n    const targetEntity = (context as any).targetEntity as string | undefined\n    if (!targetEntity || records.length === 0) return records.map((r) => ({ ...r, _integrations: {} }))\n\n    const recordIds = records.map((r) => r.id)\n    const allMappings: SyncExternalIdMapping[] = await em.find(SyncExternalIdMapping, {\n      internalEntityType: targetEntity,\n      internalEntityId: { $in: recordIds },\n      organizationId: context.organizationId,\n      deletedAt: null,\n    })\n\n    if (allMappings.length === 0) return records.map((r) => ({ ...r, _integrations: {} }))\n\n    const mappingsByRecord = new Map<string, SyncExternalIdMapping[]>()\n    for (const mapping of allMappings) {\n      const list = mappingsByRecord.get(mapping.internalEntityId) ?? []\n      list.push(mapping)\n      mappingsByRecord.set(mapping.internalEntityId, list)\n    }\n\n    return records.map((record) => {\n      const mappings = mappingsByRecord.get(record.id)\n      if (!mappings || mappings.length === 0) return { ...record, _integrations: {} }\n\n      return {\n        ...record,\n        _integrations: buildIntegrationData(mappings),\n      }\n    })\n  },\n}\n\nexport const enrichers: ResponseEnricher[] = [externalIdMappingEnricher]\n"],
+  "mappings": "AAWA,SAAS,sBAAsB;AAC/B,SAAS,6BAA6B;AAItC,SAAS,qBACP,UACuC;AACvC,QAAM,OAA8C,CAAC;AAErD,aAAW,WAAW,UAAU;AAC9B,UAAM,aAAa,eAAe,QAAQ,aAAa;AACvD,SAAK,QAAQ,aAAa,IAAI;AAAA,MAC5B,YAAY,QAAQ;AAAA,MACpB,aAAa,YAAY,mBAAmB,QAAQ,UAAU;AAAA,MAC9D,cAAc,QAAQ,cAAc,YAAY;AAAA,MAChD,YAAY,QAAQ;AAAA,IACtB;AAAA,EACF;AAEA,SAAO;AACT;AAEA,MAAM,4BAAkF;AAAA,EACtF,IAAI;AAAA,EACJ,cAAc;AAAA,EACd,UAAU,CAAC,mBAAmB;AAAA,EAC9B,UAAU;AAAA,EACV,SAAS;AAAA,EACT,UAAU;AAAA,EACV,UAAU,CAAC;AAAA,EAEX,MAAM,UAAU,QAAQ,SAAsD;AAC5E,UAAM,KAAM,QAAQ,GAAW,KAAK;AACpC,UAAM,eAAgB,QAAgB;AACtC,QAAI,CAAC,aAAc,QAAO,EAAE,GAAG,QAAQ,eAAe,CAAC,EAAE;AAEzD,UAAM,WAAoC,MAAM,GAAG,KAAK,uBAAuB;AAAA,MAC7E,oBAAoB;AAAA,MACpB,kBAAkB,OAAO;AAAA,MACzB,gBAAgB,QAAQ;AAAA,MACxB,WAAW;AAAA,IACb,CAAC;AAED,QAAI,SAAS,WAAW,EAAG,QAAO,EAAE,GAAG,QAAQ,eAAe,CAAC,EAAE;AAEjE,WAAO;AAAA,MACL,GAAG;AAAA,MACH,eAAe,qBAAqB,QAAQ;AAAA,IAC9C;AAAA,EACF;AAAA,EAEA,MAAM,WAAW,SAAS,SAAsD;AAC9E,UAAM,KAAM,QAAQ,GAAW,KAAK;AACpC,UAAM,eAAgB,QAAgB;AACtC,QAAI,CAAC,gBAAgB,QAAQ,WAAW,EAAG,QAAO,QAAQ,IAAI,CAAC,OAAO,EAAE,GAAG,GAAG,eAAe,CAAC,EAAE,EAAE;AAElG,UAAM,YAAY,QAAQ,IAAI,CAAC,MAAM,EAAE,EAAE;AACzC,UAAM,cAAuC,MAAM,GAAG,KAAK,uBAAuB;AAAA,MAChF,oBAAoB;AAAA,MACpB,kBAAkB,EAAE,KAAK,UAAU;AAAA,MACnC,gBAAgB,QAAQ;AAAA,MACxB,WAAW;AAAA,IACb,CAAC;AAED,QAAI,YAAY,WAAW,EAAG,QAAO,QAAQ,IAAI,CAAC,OAAO,EAAE,GAAG,GAAG,eAAe,CAAC,EAAE,EAAE;AAErF,UAAM,mBAAmB,oBAAI,IAAqC;AAClE,eAAW,WAAW,aAAa;AACjC,YAAM,OAAO,iBAAiB,IAAI,QAAQ,gBAAgB,KAAK,CAAC;AAChE,WAAK,KAAK,OAAO;AACjB,uBAAiB,IAAI,QAAQ,kBAAkB,IAAI;AAAA,IACrD;AAEA,WAAO,QAAQ,IAAI,CAAC,WAAW;AAC7B,YAAM,WAAW,iBAAiB,IAAI,OAAO,EAAE;AAC/C,UAAI,CAAC,YAAY,SAAS,WAAW,EAAG,QAAO,EAAE,GAAG,QAAQ,eAAe,CAAC,EAAE;AAE9E,aAAO;AAAA,QACL,GAAG;AAAA,QACH,eAAe,qBAAqB,QAAQ;AAAA,MAC9C;AAAA,IACF,CAAC;AAAA,EACH;AACF;AAEO,MAAM,YAAgC,CAAC,yBAAyB;",
+  "names": []
+}

package/dist/modules/integrations/data/entities.js

@@ -0,0 +1,63 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __decorateClass = (decorators, target, key, kind) => {
+  var result = kind > 1 ? void 0 : kind ? __getOwnPropDesc(target, key) : target;
+  for (var i = decorators.length - 1, decorator; i >= 0; i--)
+    if (decorator = decorators[i])
+      result = (kind ? decorator(target, key, result) : decorator(result)) || result;
+  if (kind && result) __defProp(target, key, result);
+  return result;
+};
+import { Entity, PrimaryKey, Property, Index } from "@mikro-orm/core";
+let SyncExternalIdMapping = class {
+  constructor() {
+    this.syncStatus = "not_synced";
+    this.createdAt = /* @__PURE__ */ new Date();
+    this.updatedAt = /* @__PURE__ */ new Date();
+  }
+};
+__decorateClass([
+  PrimaryKey({ type: "uuid", defaultRaw: "gen_random_uuid()" })
+], SyncExternalIdMapping.prototype, "id", 2);
+__decorateClass([
+  Property({ name: "integration_id", type: "text" })
+], SyncExternalIdMapping.prototype, "integrationId", 2);
+__decorateClass([
+  Property({ name: "internal_entity_type", type: "text" })
+], SyncExternalIdMapping.prototype, "internalEntityType", 2);
+__decorateClass([
+  Property({ name: "internal_entity_id", type: "uuid" })
+], SyncExternalIdMapping.prototype, "internalEntityId", 2);
+__decorateClass([
+  Property({ name: "external_id", type: "text" })
+], SyncExternalIdMapping.prototype, "externalId", 2);
+__decorateClass([
+  Property({ name: "sync_status", type: "text", default: "not_synced" })
+], SyncExternalIdMapping.prototype, "syncStatus", 2);
+__decorateClass([
+  Property({ name: "last_synced_at", type: Date, nullable: true })
+], SyncExternalIdMapping.prototype, "lastSyncedAt", 2);
+__decorateClass([
+  Property({ name: "organization_id", type: "uuid" })
+], SyncExternalIdMapping.prototype, "organizationId", 2);
+__decorateClass([
+  Property({ name: "tenant_id", type: "uuid" })
+], SyncExternalIdMapping.prototype, "tenantId", 2);
+__decorateClass([
+  Property({ name: "created_at", type: Date, onCreate: () => /* @__PURE__ */ new Date() })
+], SyncExternalIdMapping.prototype, "createdAt", 2);
+__decorateClass([
+  Property({ name: "updated_at", type: Date, onUpdate: () => /* @__PURE__ */ new Date() })
+], SyncExternalIdMapping.prototype, "updatedAt", 2);
+__decorateClass([
+  Property({ name: "deleted_at", type: Date, nullable: true })
+], SyncExternalIdMapping.prototype, "deletedAt", 2);
+SyncExternalIdMapping = __decorateClass([
+  Entity({ tableName: "sync_external_id_mappings" }),
+  Index({ properties: ["internalEntityType", "internalEntityId", "organizationId"] }),
+  Index({ properties: ["integrationId", "externalId", "organizationId"] })
+], SyncExternalIdMapping);
+export {
+  SyncExternalIdMapping
+};
+//# sourceMappingURL=entities.js.map

package/dist/modules/integrations/data/entities.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/modules/integrations/data/entities.ts"],
+  "sourcesContent": ["import { Entity, PrimaryKey, Property, Index } from '@mikro-orm/core'\n\n/**\n * Stores mappings between internal entity IDs and external system IDs.\n * Used by integration modules to track synced records across platforms.\n */\n@Entity({ tableName: 'sync_external_id_mappings' })\n@Index({ properties: ['internalEntityType', 'internalEntityId', 'organizationId'] })\n@Index({ properties: ['integrationId', 'externalId', 'organizationId'] })\nexport class SyncExternalIdMapping {\n  @PrimaryKey({ type: 'uuid', defaultRaw: 'gen_random_uuid()' })\n  id!: string\n\n  @Property({ name: 'integration_id', type: 'text' })\n  integrationId!: string\n\n  @Property({ name: 'internal_entity_type', type: 'text' })\n  internalEntityType!: string\n\n  @Property({ name: 'internal_entity_id', type: 'uuid' })\n  internalEntityId!: string\n\n  @Property({ name: 'external_id', type: 'text' })\n  externalId!: string\n\n  @Property({ name: 'sync_status', type: 'text', default: 'not_synced' })\n  syncStatus: 'synced' | 'pending' | 'error' | 'not_synced' = 'not_synced'\n\n  @Property({ name: 'last_synced_at', type: Date, nullable: true })\n  lastSyncedAt?: Date | null\n\n  @Property({ name: 'organization_id', type: 'uuid' })\n  organizationId!: string\n\n  @Property({ name: 'tenant_id', type: 'uuid' })\n  tenantId!: string\n\n  @Property({ name: 'created_at', type: Date, onCreate: () => new Date() })\n  createdAt: Date = new Date()\n\n  @Property({ name: 'updated_at', type: Date, onUpdate: () => new Date() })\n  updatedAt: Date = new Date()\n\n  @Property({ name: 'deleted_at', type: Date, nullable: true })\n  deletedAt?: Date | null\n}\n"],
+  "mappings": ";;;;;;;;;;AAAA,SAAS,QAAQ,YAAY,UAAU,aAAa;AAS7C,IAAM,wBAAN,MAA4B;AAAA,EAA5B;AAiBL,sBAA4D;AAY5D,qBAAkB,oBAAI,KAAK;AAG3B,qBAAkB,oBAAI,KAAK;AAAA;AAI7B;AAlCE;AAAA,EADC,WAAW,EAAE,MAAM,QAAQ,YAAY,oBAAoB,CAAC;AAAA,GADlD,sBAEX;AAGA;AAAA,EADC,SAAS,EAAE,MAAM,kBAAkB,MAAM,OAAO,CAAC;AAAA,GAJvC,sBAKX;AAGA;AAAA,EADC,SAAS,EAAE,MAAM,wBAAwB,MAAM,OAAO,CAAC;AAAA,GAP7C,sBAQX;AAGA;AAAA,EADC,SAAS,EAAE,MAAM,sBAAsB,MAAM,OAAO,CAAC;AAAA,GAV3C,sBAWX;AAGA;AAAA,EADC,SAAS,EAAE,MAAM,eAAe,MAAM,OAAO,CAAC;AAAA,GAbpC,sBAcX;AAGA;AAAA,EADC,SAAS,EAAE,MAAM,eAAe,MAAM,QAAQ,SAAS,aAAa,CAAC;AAAA,GAhB3D,sBAiBX;AAGA;AAAA,EADC,SAAS,EAAE,MAAM,kBAAkB,MAAM,MAAM,UAAU,KAAK,CAAC;AAAA,GAnBrD,sBAoBX;AAGA;AAAA,EADC,SAAS,EAAE,MAAM,mBAAmB,MAAM,OAAO,CAAC;AAAA,GAtBxC,sBAuBX;AAGA;AAAA,EADC,SAAS,EAAE,MAAM,aAAa,MAAM,OAAO,CAAC;AAAA,GAzBlC,sBA0BX;AAGA;AAAA,EADC,SAAS,EAAE,MAAM,cAAc,MAAM,MAAM,UAAU,MAAM,oBAAI,KAAK,EAAE,CAAC;AAAA,GA5B7D,sBA6BX;AAGA;AAAA,EADC,SAAS,EAAE,MAAM,cAAc,MAAM,MAAM,UAAU,MAAM,oBAAI,KAAK,EAAE,CAAC;AAAA,GA/B7D,sBAgCX;AAGA;AAAA,EADC,SAAS,EAAE,MAAM,cAAc,MAAM,MAAM,UAAU,KAAK,CAAC;AAAA,GAlCjD,sBAmCX;AAnCW,wBAAN;AAAA,EAHN,OAAO,EAAE,WAAW,4BAA4B,CAAC;AAAA,EACjD,MAAM,EAAE,YAAY,CAAC,sBAAsB,oBAAoB,gBAAgB,EAAE,CAAC;AAAA,EAClF,MAAM,EAAE,YAAY,CAAC,iBAAiB,cAAc,gBAAgB,EAAE,CAAC;AAAA,GAC3D;",
+  "names": []
+}

package/dist/modules/integrations/index.js

@@ -0,0 +1,9 @@
+const metadata = {
+  id: "integrations",
+  title: "Integrations",
+  description: "Core integration framework \u2014 external ID mapping, status badges, and integration registry."
+};
+export {
+  metadata
+};
+//# sourceMappingURL=index.js.map

package/dist/modules/integrations/index.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/modules/integrations/index.ts"],
+  "sourcesContent": ["export const metadata = {\n  id: 'integrations',\n  title: 'Integrations',\n  description: 'Core integration framework \u2014 external ID mapping, status badges, and integration registry.',\n}\n"],
+  "mappings": "AAAO,MAAM,WAAW;AAAA,EACtB,IAAI;AAAA,EACJ,OAAO;AAAA,EACP,aAAa;AACf;",
+  "names": []
+}

package/dist/modules/integrations/setup.js

@@ -0,0 +1,13 @@
+const setup = {
+  defaultRoleFeatures: {
+    superadmin: ["integrations.view", "integrations.manage"],
+    admin: ["integrations.view", "integrations.manage"],
+    employee: ["integrations.view"]
+  }
+};
+var setup_default = setup;
+export {
+  setup_default as default,
+  setup
+};
+//# sourceMappingURL=setup.js.map

package/dist/modules/integrations/setup.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/modules/integrations/setup.ts"],
+  "sourcesContent": ["import type { ModuleSetupConfig } from '@open-mercato/shared/modules/setup'\n\nexport const setup: ModuleSetupConfig = {\n  defaultRoleFeatures: {\n    superadmin: ['integrations.view', 'integrations.manage'],\n    admin: ['integrations.view', 'integrations.manage'],\n    employee: ['integrations.view'],\n  },\n}\n\nexport default setup\n"],
+  "mappings": "AAEO,MAAM,QAA2B;AAAA,EACtC,qBAAqB;AAAA,IACnB,YAAY,CAAC,qBAAqB,qBAAqB;AAAA,IACvD,OAAO,CAAC,qBAAqB,qBAAqB;AAAA,IAClD,UAAU,CAAC,mBAAmB;AAAA,EAChC;AACF;AAEA,IAAO,gBAAQ;",
+  "names": []
+}

package/dist/modules/integrations/widgets/injection/external-ids/widget.client.js

@@ -0,0 +1,69 @@
+"use client";
+import { jsx, jsxs } from "react/jsx-runtime";
+import { getIntegrationTitle } from "@open-mercato/shared/modules/integrations/types";
+import { useT } from "@open-mercato/shared/lib/i18n/context";
+import { cn } from "@open-mercato/shared/lib/utils";
+const SYNC_STATUS_STYLES = {
+  synced: { dot: "bg-green-500", label: "integrations.syncStatus.synced" },
+  pending: { dot: "bg-yellow-500", label: "integrations.syncStatus.pending" },
+  error: { dot: "bg-red-500", label: "integrations.syncStatus.error" },
+  not_synced: { dot: "bg-gray-400", label: "integrations.syncStatus.notSynced" }
+};
+function SyncStatusBadge({ status, lastSynced }) {
+  const t = useT();
+  const config = SYNC_STATUS_STYLES[status];
+  const label = t(config.label, status);
+  return /* @__PURE__ */ jsxs("span", { className: "inline-flex items-center gap-1 text-xs text-muted-foreground", children: [
+    /* @__PURE__ */ jsx("span", { className: cn("inline-block size-1.5 rounded-full", config.dot), "aria-hidden": "true" }),
+    /* @__PURE__ */ jsx("span", { children: label }),
+    lastSynced && /* @__PURE__ */ jsx("span", { title: lastSynced, children: new Date(lastSynced).toLocaleDateString() })
+  ] });
+}
+function ExternalLinkIcon() {
+  return /* @__PURE__ */ jsxs("svg", { className: "size-3.5", viewBox: "0 0 16 16", fill: "none", stroke: "currentColor", strokeWidth: "1.5", children: [
+    /* @__PURE__ */ jsx("path", { d: "M6.5 3.5H3a1 1 0 0 0-1 1V13a1 1 0 0 0 1 1h8.5a1 1 0 0 0 1-1V9.5" }),
+    /* @__PURE__ */ jsx("path", { d: "M9.5 2h4.5v4.5M14 2 7.5 8.5" })
+  ] });
+}
+function ExternalIdsWidget({ data }) {
+  const t = useT();
+  const integrations = data?._integrations;
+  if (!integrations || Object.keys(integrations).length === 0) return null;
+  return /* @__PURE__ */ jsxs("div", { className: "rounded-lg border bg-card p-4", children: [
+    /* @__PURE__ */ jsx("h3", { className: "mb-3 text-sm font-medium", children: t("integrations.externalIds.title", "External IDs") }),
+    /* @__PURE__ */ jsx("div", { className: "space-y-2", children: Object.entries(integrations).map(([integrationId, mapping]) => /* @__PURE__ */ jsxs(
+      "div",
+      {
+        className: "flex items-center justify-between gap-2 rounded-md bg-muted/50 px-3 py-2",
+        children: [
+          /* @__PURE__ */ jsxs("div", { className: "flex items-center gap-2 min-w-0", children: [
+            /* @__PURE__ */ jsx("span", { className: "text-sm font-medium truncate", children: getIntegrationTitle(integrationId) }),
+            /* @__PURE__ */ jsx("code", { className: "rounded bg-muted px-1.5 py-0.5 text-xs font-mono text-muted-foreground", children: mapping.externalId }),
+            mapping.externalUrl && /* @__PURE__ */ jsx(
+              "a",
+              {
+                href: mapping.externalUrl,
+                target: "_blank",
+                rel: "noopener noreferrer",
+                className: "text-muted-foreground hover:text-foreground transition-colors",
+                "aria-label": t("integrations.externalIds.openExternal", "Open in external system"),
+                children: /* @__PURE__ */ jsx(ExternalLinkIcon, {})
+              }
+            )
+          ] }),
+          /* @__PURE__ */ jsx(SyncStatusBadge, { status: mapping.syncStatus, lastSynced: mapping.lastSyncedAt })
+        ]
+      },
+      integrationId
+    )) })
+  ] });
+}
+ExternalIdsWidget.metadata = {
+  id: "integrations.injection.external-ids",
+  title: "External IDs",
+  features: ["integrations.view"]
+};
+export {
+  ExternalIdsWidget as default
+};
+//# sourceMappingURL=widget.client.js.map

package/dist/modules/integrations/widgets/injection/external-ids/widget.client.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../../src/modules/integrations/widgets/injection/external-ids/widget.client.tsx"],
+  "sourcesContent": ["\"use client\"\n\nimport * as React from 'react'\nimport type { InjectionWidgetComponentProps } from '@open-mercato/shared/modules/widgets/injection'\nimport type { ExternalIdMapping } from '@open-mercato/shared/modules/integrations/types'\nimport { getIntegrationTitle } from '@open-mercato/shared/modules/integrations/types'\nimport { useT } from '@open-mercato/shared/lib/i18n/context'\nimport { cn } from '@open-mercato/shared/lib/utils'\n\ntype IntegrationsData = Record<string, ExternalIdMapping>\n\nconst SYNC_STATUS_STYLES: Record<ExternalIdMapping['syncStatus'], { dot: string; label: string }> = {\n  synced: { dot: 'bg-green-500', label: 'integrations.syncStatus.synced' },\n  pending: { dot: 'bg-yellow-500', label: 'integrations.syncStatus.pending' },\n  error: { dot: 'bg-red-500', label: 'integrations.syncStatus.error' },\n  not_synced: { dot: 'bg-gray-400', label: 'integrations.syncStatus.notSynced' },\n}\n\nfunction SyncStatusBadge({ status, lastSynced }: { status: ExternalIdMapping['syncStatus']; lastSynced?: string }) {\n  const t = useT()\n  const config = SYNC_STATUS_STYLES[status]\n  const label = t(config.label, status)\n\n  return (\n    <span className=\"inline-flex items-center gap-1 text-xs text-muted-foreground\">\n      <span className={cn('inline-block size-1.5 rounded-full', config.dot)} aria-hidden=\"true\" />\n      <span>{label}</span>\n      {lastSynced && (\n        <span title={lastSynced}>\n          {new Date(lastSynced).toLocaleDateString()}\n        </span>\n      )}\n    </span>\n  )\n}\n\nfunction ExternalLinkIcon() {\n  return (\n    <svg className=\"size-3.5\" viewBox=\"0 0 16 16\" fill=\"none\" stroke=\"currentColor\" strokeWidth=\"1.5\">\n      <path d=\"M6.5 3.5H3a1 1 0 0 0-1 1V13a1 1 0 0 0 1 1h8.5a1 1 0 0 0 1-1V9.5\" />\n      <path d=\"M9.5 2h4.5v4.5M14 2 7.5 8.5\" />\n    </svg>\n  )\n}\n\nexport default function ExternalIdsWidget({ data }: InjectionWidgetComponentProps) {\n  const t = useT()\n  const integrations = (data as Record<string, unknown>)?._integrations as IntegrationsData | undefined\n\n  if (!integrations || Object.keys(integrations).length === 0) return null\n\n  return (\n    <div className=\"rounded-lg border bg-card p-4\">\n      <h3 className=\"mb-3 text-sm font-medium\">\n        {t('integrations.externalIds.title', 'External IDs')}\n      </h3>\n      <div className=\"space-y-2\">\n        {Object.entries(integrations).map(([integrationId, mapping]) => (\n          <div\n            key={integrationId}\n            className=\"flex items-center justify-between gap-2 rounded-md bg-muted/50 px-3 py-2\"\n          >\n            <div className=\"flex items-center gap-2 min-w-0\">\n              <span className=\"text-sm font-medium truncate\">\n                {getIntegrationTitle(integrationId)}\n              </span>\n              <code className=\"rounded bg-muted px-1.5 py-0.5 text-xs font-mono text-muted-foreground\">\n                {mapping.externalId}\n              </code>\n              {mapping.externalUrl && (\n                <a\n                  href={mapping.externalUrl}\n                  target=\"_blank\"\n                  rel=\"noopener noreferrer\"\n                  className=\"text-muted-foreground hover:text-foreground transition-colors\"\n                  aria-label={t('integrations.externalIds.openExternal', 'Open in external system')}\n                >\n                  <ExternalLinkIcon />\n                </a>\n              )}\n            </div>\n            <SyncStatusBadge status={mapping.syncStatus} lastSynced={mapping.lastSyncedAt} />\n          </div>\n        ))}\n      </div>\n    </div>\n  )\n}\n\nExternalIdsWidget.metadata = {\n  id: 'integrations.injection.external-ids',\n  title: 'External IDs',\n  features: ['integrations.view'],\n}\n"],
+  "mappings": ";AAwBI,SACE,KADF;AAnBJ,SAAS,2BAA2B;AACpC,SAAS,YAAY;AACrB,SAAS,UAAU;AAInB,MAAM,qBAA8F;AAAA,EAClG,QAAQ,EAAE,KAAK,gBAAgB,OAAO,iCAAiC;AAAA,EACvE,SAAS,EAAE,KAAK,iBAAiB,OAAO,kCAAkC;AAAA,EAC1E,OAAO,EAAE,KAAK,cAAc,OAAO,gCAAgC;AAAA,EACnE,YAAY,EAAE,KAAK,eAAe,OAAO,oCAAoC;AAC/E;AAEA,SAAS,gBAAgB,EAAE,QAAQ,WAAW,GAAqE;AACjH,QAAM,IAAI,KAAK;AACf,QAAM,SAAS,mBAAmB,MAAM;AACxC,QAAM,QAAQ,EAAE,OAAO,OAAO,MAAM;AAEpC,SACE,qBAAC,UAAK,WAAU,gEACd;AAAA,wBAAC,UAAK,WAAW,GAAG,sCAAsC,OAAO,GAAG,GAAG,eAAY,QAAO;AAAA,IAC1F,oBAAC,UAAM,iBAAM;AAAA,IACZ,cACC,oBAAC,UAAK,OAAO,YACV,cAAI,KAAK,UAAU,EAAE,mBAAmB,GAC3C;AAAA,KAEJ;AAEJ;AAEA,SAAS,mBAAmB;AAC1B,SACE,qBAAC,SAAI,WAAU,YAAW,SAAQ,aAAY,MAAK,QAAO,QAAO,gBAAe,aAAY,OAC1F;AAAA,wBAAC,UAAK,GAAE,mEAAkE;AAAA,IAC1E,oBAAC,UAAK,GAAE,+BAA8B;AAAA,KACxC;AAEJ;AAEe,SAAR,kBAAmC,EAAE,KAAK,GAAkC;AACjF,QAAM,IAAI,KAAK;AACf,QAAM,eAAgB,MAAkC;AAExD,MAAI,CAAC,gBAAgB,OAAO,KAAK,YAAY,EAAE,WAAW,EAAG,QAAO;AAEpE,SACE,qBAAC,SAAI,WAAU,iCACb;AAAA,wBAAC,QAAG,WAAU,4BACX,YAAE,kCAAkC,cAAc,GACrD;AAAA,IACA,oBAAC,SAAI,WAAU,aACZ,iBAAO,QAAQ,YAAY,EAAE,IAAI,CAAC,CAAC,eAAe,OAAO,MACxD;AAAA,MAAC;AAAA;AAAA,QAEC,WAAU;AAAA,QAEV;AAAA,+BAAC,SAAI,WAAU,mCACb;AAAA,gCAAC,UAAK,WAAU,gCACb,8BAAoB,aAAa,GACpC;AAAA,YACA,oBAAC,UAAK,WAAU,0EACb,kBAAQ,YACX;AAAA,YACC,QAAQ,eACP;AAAA,cAAC;AAAA;AAAA,gBACC,MAAM,QAAQ;AAAA,gBACd,QAAO;AAAA,gBACP,KAAI;AAAA,gBACJ,WAAU;AAAA,gBACV,cAAY,EAAE,yCAAyC,yBAAyB;AAAA,gBAEhF,8BAAC,oBAAiB;AAAA;AAAA,YACpB;AAAA,aAEJ;AAAA,UACA,oBAAC,mBAAgB,QAAQ,QAAQ,YAAY,YAAY,QAAQ,cAAc;AAAA;AAAA;AAAA,MAtB1E;AAAA,IAuBP,CACD,GACH;AAAA,KACF;AAEJ;AAEA,kBAAkB,WAAW;AAAA,EAC3B,IAAI;AAAA,EACJ,OAAO;AAAA,EACP,UAAU,CAAC,mBAAmB;AAChC;",
+  "names": []
+}

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

@@ -0,0 +1,13 @@
+const injectionTable = {
+  // External IDs widget appears in detail page sidebars for all entities
+  "detail:*:sidebar": {
+    widgetId: "integrations.injection.external-ids",
+    priority: -10
+  }
+};
+var injection_table_default = injectionTable;
+export {
+  injection_table_default as default,
+  injectionTable
+};
+//# sourceMappingURL=injection-table.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/modules/integrations/widgets/injection-table.ts"],
+  "sourcesContent": ["import type { ModuleInjectionTable } from '@open-mercato/shared/modules/widgets/injection'\n\n/**\n * Integrations module injection table.\n *\n * The external-ids widget auto-appears on entity detail pages via wildcard spot matching.\n * Status badge widgets are registered by individual integration modules (e.g. sync_medusa).\n */\nexport const injectionTable: ModuleInjectionTable = {\n  // External IDs widget appears in detail page sidebars for all entities\n  'detail:*:sidebar': {\n    widgetId: 'integrations.injection.external-ids',\n    priority: -10,\n  },\n}\n\nexport default injectionTable\n"],
+  "mappings": "AAQO,MAAM,iBAAuC;AAAA;AAAA,EAElD,oBAAoB;AAAA,IAClB,UAAU;AAAA,IACV,UAAU;AAAA,EACZ;AACF;AAEA,IAAO,0BAAQ;",
+  "names": []
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@open-mercato/core",
-  "version": "0.4.6-develop-be2da141e3",
+  "version": "0.4.6-develop-1f4478d60c",
   "type": "module",
   "main": "./dist/index.js",
   "scripts": {
@@ -207,7 +207,7 @@
     }
   },
   "dependencies": {
-    "@open-mercato/shared": "0.4.6-develop-be2da141e3",
+    "@open-mercato/shared": "0.4.6-develop-1f4478d60c",
     "@types/html-to-text": "^9.0.4",
     "@types/semver": "^7.5.8",
     "@xyflow/react": "^12.6.0",

package/src/modules/integrations/acl.ts

@@ -0,0 +1,4 @@
+export const features = [
+  { id: 'integrations.view', title: 'View integrations and external ID mappings', module: 'integrations' },
+  { id: 'integrations.manage', title: 'Manage integration configurations', module: 'integrations' },
+]

package/src/modules/integrations/data/enrichers.ts

@@ -0,0 +1,98 @@
+/**
+ * External ID Mapping Enricher
+ *
+ * Enriches any entity's API response with external integration ID mappings.
+ * Adds `_integrations` namespace containing all external IDs for the record.
+ *
+ * Uses batch queries via `enrichMany` to prevent N+1.
+ */
+
+import type { ResponseEnricher, EnricherContext } from '@open-mercato/shared/lib/crud/response-enricher'
+import type { ExternalIdEnrichment } from '@open-mercato/shared/modules/integrations/types'
+import { getIntegration } from '@open-mercato/shared/modules/integrations/types'
+import { SyncExternalIdMapping } from './entities'
+
+type EntityRecord = Record<string, unknown> & { id: string }
+
+function buildIntegrationData(
+  mappings: SyncExternalIdMapping[],
+): ExternalIdEnrichment['_integrations'] {
+  const data: ExternalIdEnrichment['_integrations'] = {}
+
+  for (const mapping of mappings) {
+    const definition = getIntegration(mapping.integrationId)
+    data[mapping.integrationId] = {
+      externalId: mapping.externalId,
+      externalUrl: definition?.buildExternalUrl?.(mapping.externalId),
+      lastSyncedAt: mapping.lastSyncedAt?.toISOString(),
+      syncStatus: mapping.syncStatus,
+    }
+  }
+
+  return data
+}
+
+const externalIdMappingEnricher: ResponseEnricher<EntityRecord, ExternalIdEnrichment> = {
+  id: 'integrations.external-id-mapping',
+  targetEntity: '*',
+  features: ['integrations.view'],
+  priority: 10,
+  timeout: 500,
+  critical: false,
+  fallback: {},
+
+  async enrichOne(record, context: EnricherContext & { targetEntity?: string }) {
+    const em = (context.em as any).fork()
+    const targetEntity = (context as any).targetEntity as string | undefined
+    if (!targetEntity) return { ...record, _integrations: {} }
+
+    const mappings: SyncExternalIdMapping[] = await em.find(SyncExternalIdMapping, {
+      internalEntityType: targetEntity,
+      internalEntityId: record.id,
+      organizationId: context.organizationId,
+      deletedAt: null,
+    })
+
+    if (mappings.length === 0) return { ...record, _integrations: {} }
+
+    return {
+      ...record,
+      _integrations: buildIntegrationData(mappings),
+    }
+  },
+
+  async enrichMany(records, context: EnricherContext & { targetEntity?: string }) {
+    const em = (context.em as any).fork()
+    const targetEntity = (context as any).targetEntity as string | undefined
+    if (!targetEntity || records.length === 0) return records.map((r) => ({ ...r, _integrations: {} }))
+
+    const recordIds = records.map((r) => r.id)
+    const allMappings: SyncExternalIdMapping[] = await em.find(SyncExternalIdMapping, {
+      internalEntityType: targetEntity,
+      internalEntityId: { $in: recordIds },
+      organizationId: context.organizationId,
+      deletedAt: null,
+    })
+
+    if (allMappings.length === 0) return records.map((r) => ({ ...r, _integrations: {} }))
+
+    const mappingsByRecord = new Map<string, SyncExternalIdMapping[]>()
+    for (const mapping of allMappings) {
+      const list = mappingsByRecord.get(mapping.internalEntityId) ?? []
+      list.push(mapping)
+      mappingsByRecord.set(mapping.internalEntityId, list)
+    }
+
+    return records.map((record) => {
+      const mappings = mappingsByRecord.get(record.id)
+      if (!mappings || mappings.length === 0) return { ...record, _integrations: {} }
+
+      return {
+        ...record,
+        _integrations: buildIntegrationData(mappings),
+      }
+    })
+  },
+}
+
+export const enrichers: ResponseEnricher[] = [externalIdMappingEnricher]

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

@@ -0,0 +1,46 @@
+import { Entity, PrimaryKey, Property, Index } from '@mikro-orm/core'
+
+/**
+ * Stores mappings between internal entity IDs and external system IDs.
+ * Used by integration modules to track synced records across platforms.
+ */
+@Entity({ tableName: 'sync_external_id_mappings' })
+@Index({ properties: ['internalEntityType', 'internalEntityId', 'organizationId'] })
+@Index({ properties: ['integrationId', 'externalId', 'organizationId'] })
+export class SyncExternalIdMapping {
+  @PrimaryKey({ type: 'uuid', defaultRaw: 'gen_random_uuid()' })
+  id!: string
+
+  @Property({ name: 'integration_id', type: 'text' })
+  integrationId!: string
+
+  @Property({ name: 'internal_entity_type', type: 'text' })
+  internalEntityType!: string
+
+  @Property({ name: 'internal_entity_id', type: 'uuid' })
+  internalEntityId!: string
+
+  @Property({ name: 'external_id', type: 'text' })
+  externalId!: string
+
+  @Property({ name: 'sync_status', type: 'text', default: 'not_synced' })
+  syncStatus: 'synced' | 'pending' | 'error' | 'not_synced' = 'not_synced'
+
+  @Property({ name: 'last_synced_at', type: Date, nullable: true })
+  lastSyncedAt?: Date | null
+
+  @Property({ name: 'organization_id', type: 'uuid' })
+  organizationId!: string
+
+  @Property({ name: 'tenant_id', type: 'uuid' })
+  tenantId!: string
+
+  @Property({ name: 'created_at', type: Date, onCreate: () => new Date() })
+  createdAt: Date = new Date()
+
+  @Property({ name: 'updated_at', type: Date, onUpdate: () => new Date() })
+  updatedAt: Date = new Date()
+
+  @Property({ name: 'deleted_at', type: Date, nullable: true })
+  deletedAt?: Date | null
+}

package/src/modules/integrations/index.ts

@@ -0,0 +1,5 @@
+export const metadata = {
+  id: 'integrations',
+  title: 'Integrations',
+  description: 'Core integration framework — external ID mapping, status badges, and integration registry.',
+}

package/src/modules/integrations/setup.ts

@@ -0,0 +1,11 @@
+import type { ModuleSetupConfig } from '@open-mercato/shared/modules/setup'
+
+export const setup: ModuleSetupConfig = {
+  defaultRoleFeatures: {
+    superadmin: ['integrations.view', 'integrations.manage'],
+    admin: ['integrations.view', 'integrations.manage'],
+    employee: ['integrations.view'],
+  },
+}
+
+export default setup

package/src/modules/integrations/widgets/injection/external-ids/widget.client.tsx

@@ -0,0 +1,94 @@
+"use client"
+
+import * as React from 'react'
+import type { InjectionWidgetComponentProps } from '@open-mercato/shared/modules/widgets/injection'
+import type { ExternalIdMapping } from '@open-mercato/shared/modules/integrations/types'
+import { getIntegrationTitle } from '@open-mercato/shared/modules/integrations/types'
+import { useT } from '@open-mercato/shared/lib/i18n/context'
+import { cn } from '@open-mercato/shared/lib/utils'
+
+type IntegrationsData = Record<string, ExternalIdMapping>
+
+const SYNC_STATUS_STYLES: Record<ExternalIdMapping['syncStatus'], { dot: string; label: string }> = {
+  synced: { dot: 'bg-green-500', label: 'integrations.syncStatus.synced' },
+  pending: { dot: 'bg-yellow-500', label: 'integrations.syncStatus.pending' },
+  error: { dot: 'bg-red-500', label: 'integrations.syncStatus.error' },
+  not_synced: { dot: 'bg-gray-400', label: 'integrations.syncStatus.notSynced' },
+}
+
+function SyncStatusBadge({ status, lastSynced }: { status: ExternalIdMapping['syncStatus']; lastSynced?: string }) {
+  const t = useT()
+  const config = SYNC_STATUS_STYLES[status]
+  const label = t(config.label, status)
+
+  return (
+    <span className="inline-flex items-center gap-1 text-xs text-muted-foreground">
+      <span className={cn('inline-block size-1.5 rounded-full', config.dot)} aria-hidden="true" />
+      <span>{label}</span>
+      {lastSynced && (
+        <span title={lastSynced}>
+          {new Date(lastSynced).toLocaleDateString()}
+        </span>
+      )}
+    </span>
+  )
+}
+
+function ExternalLinkIcon() {
+  return (
+    <svg className="size-3.5" viewBox="0 0 16 16" fill="none" stroke="currentColor" strokeWidth="1.5">
+      <path d="M6.5 3.5H3a1 1 0 0 0-1 1V13a1 1 0 0 0 1 1h8.5a1 1 0 0 0 1-1V9.5" />
+      <path d="M9.5 2h4.5v4.5M14 2 7.5 8.5" />
+    </svg>
+  )
+}
+
+export default function ExternalIdsWidget({ data }: InjectionWidgetComponentProps) {
+  const t = useT()
+  const integrations = (data as Record<string, unknown>)?._integrations as IntegrationsData | undefined
+
+  if (!integrations || Object.keys(integrations).length === 0) return null
+
+  return (
+    <div className="rounded-lg border bg-card p-4">
+      <h3 className="mb-3 text-sm font-medium">
+        {t('integrations.externalIds.title', 'External IDs')}
+      </h3>
+      <div className="space-y-2">
+        {Object.entries(integrations).map(([integrationId, mapping]) => (
+          <div
+            key={integrationId}
+            className="flex items-center justify-between gap-2 rounded-md bg-muted/50 px-3 py-2"
+          >
+            <div className="flex items-center gap-2 min-w-0">
+              <span className="text-sm font-medium truncate">
+                {getIntegrationTitle(integrationId)}
+              </span>
+              <code className="rounded bg-muted px-1.5 py-0.5 text-xs font-mono text-muted-foreground">
+                {mapping.externalId}
+              </code>
+              {mapping.externalUrl && (
+                <a
+                  href={mapping.externalUrl}
+                  target="_blank"
+                  rel="noopener noreferrer"
+                  className="text-muted-foreground hover:text-foreground transition-colors"
+                  aria-label={t('integrations.externalIds.openExternal', 'Open in external system')}
+                >
+                  <ExternalLinkIcon />
+                </a>
+              )}
+            </div>
+            <SyncStatusBadge status={mapping.syncStatus} lastSynced={mapping.lastSyncedAt} />
+          </div>
+        ))}
+      </div>
+    </div>
+  )
+}
+
+ExternalIdsWidget.metadata = {
+  id: 'integrations.injection.external-ids',
+  title: 'External IDs',
+  features: ['integrations.view'],
+}

package/src/modules/integrations/widgets/injection-table.ts

@@ -0,0 +1,17 @@
+import type { ModuleInjectionTable } from '@open-mercato/shared/modules/widgets/injection'
+
+/**
+ * Integrations module injection table.
+ *
+ * The external-ids widget auto-appears on entity detail pages via wildcard spot matching.
+ * Status badge widgets are registered by individual integration modules (e.g. sync_medusa).
+ */
+export const injectionTable: ModuleInjectionTable = {
+  // External IDs widget appears in detail page sidebars for all entities
+  'detail:*:sidebar': {
+    widgetId: 'integrations.injection.external-ids',
+    priority: -10,
+  },
+}
+
+export default injectionTable